Workflow & Automation

dsh-workbench

Dely0/dsh-workbench · ★ 46

Dely0

Calendar and hierarchical task workbench: AI-assisted intake clarification, consultation, decomposition, execution with user acceptance, and review, plus reminders and per-task AI session workspaces.

README body is shown in Chinese.

Repository Source

License: MIT
Added: 2026-08-16
Maintenance: active
Install kind: github

Manifest details

Manifest status: Declared
Manifest path: package.json#dsh
Manifest checked: 2026-08-19
Lifecycle scripts: None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add github:Dely0/dsh-workbench

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: zh · Read Chinese README

Table of contents

亮点
安装
快速上手
兼容性
开发
版本历史
路线图
致谢
免责声明
License
English
Highlights
Install
Compatibility
Development
Credits & License

DSH（DeepSeek Harness）个人工作台插件：把 DSH 变成「日历 + 层级任务 + AI 助手」的工作台。自然语言录入任务，AI 澄清 / 拆解 / 执行 / 复盘，数据全部留在本机。

English · 简体中文

日历	快速录入	知识库

亮点

📅 日历（周/月）+ 树状任务列表；「今日」「日历」「任务」三视图，筛选排序可组合、保留父子层级
✨ 自然语言快速录入 → AI 澄清后生成任务；支持贴图与 PDF/DOCX 附件，不收的文件逐条给原因
🧠 每个任务关联多个 AI 会话：澄清 / 咨询 / 拆解 / 执行 / 复盘
🎭 专家人格（角色库）：三级来源（用户库 > 外部目录 > 内置 15 篇）；会话前选定，正文按需加载、不进提示词
✅ 「AI 申请完成 → 用户验收」闭环；进度是显式值，AI 不能靠进度把任务标完成（ADR 0003/0004）
🗓️ 每日计划 + 容量账本：AI 排序提案 → 确认才生效；「今日投入结束」≠ 任务完成（ADR 0007）
🎯 会话前选 Skill / 模型 / 角色，提示词自动注入「加载这些技能」
⏰ 到期提醒：页内横幅 + 系统通知；可选微信通道（需 @xmanrui/dsh-im）
🌐 界面语言：自动 / 中文 / English（设置 → 语言）；顶栏、设置、角色库/专家、快速录入、任务表单、知识库与选择器已支持英文，深层说明文案增量迁移
🔒 数据只在本机 ~/.dsh/workbench，不上传任何服务器

安装

前置：DSH ≥ 0.1.5-rc.1（Web 版）、Node ^22.19.0 或 >=24.0.0、pnpm >=11.7.0 <12。

dsh plugin --profile web add @dely0/dsh-personal-workbench

⚠️ 装完必须重启 dsh web，只刷新浏览器不够：客户端 bundle 由宿主在启动时读进内存，刷新拿到的是旧代码。升级/回退同理。

其它装法：

# GitHub 源码
dsh plugin --profile web add git+https://github.com/Dely0/dsh-personal-workbench.git
# Release tarball
dsh plugin --profile web add file:/path/to/dsh-personal-workbench-<version>.tgz

快速上手

侧栏点「工作台」打开面板；
「快速录入」说一句话 → AI 澄清 → 确认建任务；
任务详情点「AI 执行」→ 在会话里干活 → 完成后回面板验收；
「今日」看待办与容量，需要时点「AI 智能排序」排今天的顺序；「日历」按天回看与排期。

兼容性

项	要求	拿不到时
面板本体（官方槽位 + `layout.selectPanel`）	DSH `0.1.5-rc.1+`	面板整块不启动并打一条可读日志（刻意不降级）
服务端能力：任务/日历/知识库/点子、提醒、日报周报、`workbench_*` 工具	`0.1.0-rc.6+`	—
会话绑定 `sessions.retain()`	`0.1.7-rc.2+`	旧宿主自动回落 `sessions.binding()`
Skill 选择器	宿主 `skills` 注册表	选择器隐藏
微信提醒	可选插件 `@xmanrui/dsh-im`	静默降级为页内提醒 + 系统通知

最低支持版本是 0.1.5-rc.1，这是硬边界。 为什么低于它选择"明确不启动"而不是降级、以及 0.2.0 引入的插件兼容性预检（peer 区间为什么写成并列区间）：见 docs/releases/v1.15.8.md 与 docs/design/2026-09-13-client-architecture-official-only.md。

开发

git clone https://github.com/Dely0/dsh-personal-workbench.git
cd dsh-personal-workbench
pnpm install
pnpm check                 # 类型检查 + 构建
pnpm test                  # 全量回归（跑构建产物）
pnpm build && pnpm dev:install   # 装盘到本机 profile（装完重启 dsh web）

文档	用途
`.dsh/skills/dsh-plugin-change/`	改代码前先读：架构硬约束、本项目的编码规范与回归防线
`.dsh/skills/dsh-release/`	发版前先读：公开发布的硬门禁与命令序列（范围表、变异探针、PII 两面、tag/npm/Release、发布成功判据）
`docs/release-checklist.md`	发版前自检清单（可勾选版）
`scripts/release-preflight.mjs`	发布门禁一键跑：typecheck → 单测 → 全探针（每步 build）→ PII 两面 → 版本/文档；`--phase post` 做 tarball 与 sha1 对账、用户视角安装、Release 复核
`scripts/dev-verify.mjs`	研发版本验收链：构建 → 装盘 → 隔离实例重启 → 浏览器套件 → 证据包
`docs/issues/`	滚动维护的已知问题与待办
`docs/adr/`	已冻结的口径决策（容量、进度、角色、验收链、每日投入）

版本历史

版本	要点
1.17.2	两处「点开就废」的可用性修复：① 模型选择器一个模型都列不出来（issue #19 / PR #20，@SnowNight777）—— DSH 0.2.1-rc.3 上宿主 `directoryFor(sessionId)` 先查 `sessions.scope()`，scope 只在有人 `retain()` 之后才物化，而 `ModelPicker` 自己挑会话却从不 retain ⇒ 先报 `ui-model-selection: session "…" resolved no scope`，补掉后首次建目录再报 `cannot get property "remote.session" without inject`（cordis traceable 服务把服务实例 `ctx` 影射成调用方 ctx）。本版取目录前按契约 retain（引用计数、卸载/切会话释放）、挑会话口径收敛到 `pickDirectorySessionId()`、调用宿主服务改走 `ctx.inject(['remote.session'])` 的子 ctx（可选依赖，不把没装该 provider 的机器整块面板 pending），重试判据只认 `resolved no scope` / `resolved no binding`。② 「AI 执行」弹窗拿不到「开始」（issue #17 / PR #21，@WUWAN01 报告）—— `.wb-modal` 无高度上限、操作栏走普通文档流，1080p/150% 下弹窗高于视口、底部「取消/开始」被推到屏幕外且整页滚动救不回来（`task_sessions` 0 行）；本版加 `max-height:min(88vh,900px)`、`overflow-y:auto`、`overscroll-behavior:contain`，底栏改 `position:sticky` 并补图层底色，附「缺一条规则就红」的 CSS 判据与实机双相位探针 `scripts/repro/repro-issue17-modal-overflow.mjs`。同版合入 i18n 深度翻译二轮（PR #18，@Chewbacca96）。详见 docs/releases/v1.17.2.md
1.17.1	修复 issue #15：点子页「新建 / 重命名文件夹」点了没反应（v1.16.3 客户端拆分的残留）—— 五个「新建文件夹」入口与卡片 hover 的 ✎ 从 1.16.3 起只改 `folderForm` 状态、没有任何组件读它，于是没弹窗、没请求、没报错；本版按拆分前的 DOM 恢复文件夹弹窗（新建/重命名两模式、Enter 提交、Esc/遮罩取消、空标题禁用），并让 `Modal` 优先聚焦 `[data-autofocus]` 主字段（否则焦点落在关闭按钮上，打字没反应）。同版新增 `test/ideasFolderForm.test.mjs`（hook 暴露的状态/动作必须有渲染层读者，防"只写不读"静默丢失回归），并修掉验收链在英文界面下的两处假红（「返回对话」定位改共享表达式、expert 真实模型跳过显式登记）。详见 `docs/releases/v1.17.1.md`
1.17.0	角色库/专家 UI 可用性 + 英文界面（i18n）+ 宿主浮层挂载：修掉专家草稿预览一字一行/横向溢出、设置页「继续修改」后弹窗不关、「查看草稿」被设置弹窗遮挡、界面露出 `**` 与角色来源标签重复；设置新增语言（自动/中文/English），顶栏、设置、角色库/专家、快速录入、任务表单与知识库等顶层界面支持英文，语言保存后重启仍保留；浮层改为优先挂宿主 `[data-shell-overlay]` 层并补 `pointer-events`，修复桌面端设置弹窗与模型列表被面板盖住（issue #14）。英文界面见 issue #12。详见 `docs/releases/v1.17.0.md`
1.16.5	合入外部贡献：工作台样式节点丢失后的自愈（issue #9 / PR #10，@SnowNight777）—— 插件活动期间 `style[data-dsh-personal-workbench-style]` 被删掉后约 600ms 内自动重建，关闭态面板不再"无样式弹出并覆盖界面"；观察者挂在插件实例上（不是模块级），`cleanup()` 先 `disposed = true` 再 `disconnect()`。同版修掉 main 连续 33 次红的 CI：`test/db.test.mjs` 那条"同链计划项"断言的场景从 2026-10-01 起就写错了、且 `finally` 里的清理异常会顶替断言失败（正是它被长期读成"Windows EPERM 假失败"的原因），CI run #84 双绿。详见 `docs/releases/v1.16.5.md`
1.16.4	「排入今日」的父子口径定案：计划项必须是可执行叶子，在父任务上点一次 = 按树序展开它下面所有未完成叶子（各自带自己的投入），父任务自己不是计划项、在「计划」页签作分组行（「已排 N / 共 M 个子任务 · 合计 X 分钟」）；候选池只收叶子、AI 侧口径同步「只排可执行叶子」（含父任务的提案整份被拒）。同版修掉「清除今日计划不刷新」与两处验收链套件假红。口径见 `docs/adr/0010-plan-items-are-executable-leaves.md`，详见 `docs/releases/v1.16.4.md`
1.16.3	客户端入口拆分：`src/client/index.tsx` 5725 → 1972 行、`WorkbenchApp` 4197 → 631 行；117 个 state 按域收进 16 个 hook，五个视图与任务详情区各自成组件（`hooks/` + `views/` + `app/` 装配四段）；ADR-0008 结构硬门（体内 `useState`/`api`/`fetch`/定时器 = 0、单个顶层块 ≤80 行）落成扫描判据。纯结构重构、零行为变化。详见 `docs/releases/v1.16.3.md`
1.16.2	日期面板补「逾期」/「未排期」两个任务页签（无截止、没排期、非进行中的任务终于有归宿，「未排期」= 补集：三页签并集恰好是全部未完成）+ 这两个页签的行内「排入今日」；统计卡「逾期」口径统一到当日 00:00（与页签同一把尺子）。详见 `docs/releases/v1.16.2.md`
1.16.1	AI 会话工作区双模式（已有工作区下拉 + 文件夹弹框）；「今日」与「日历」收敛为同一个日期面板（计划/已完成/报告三页签，树口径＝当日到期 ∪ 当日计划项 ∪ 进行中，逐条标来源）；构建期类型源对齐 DSH `0.2.0-rc.2`。详见 `docs/releases/v1.16.1.md`
1.16.0	任务进度（显式值、AI 不能靠进度完成）+ 专家人格角色库（三级来源 / 15 篇内置）+ 研发版本验收链。⚠️ schema 18 → 19。详见 `docs/releases/v1.16.0.md`
1.15.8	适配 DSH `0.2.0-rc.1` 的插件兼容性预检（peer 改并列区间，下界不动）
1.15.7	快速录入模型选择死锁 + rc.2 系统通知失败被吞（两处 P0）
1.15.6	补齐 `0.1.7-rc.2` 上「当前会话」读取的三处静默 `undefined`
1.15.5	适配 `0.1.7-rc.2`：会话绑定/打开、标题栏让位、侧栏量宽、工作区静默丢件
1.15.3	合入社区三项修复（提醒漏建 / 投递目标缓存 / 复用会话陈旧引用）
1.15.2	模型浮层遮挡、默认工作区被任务污染、容量账本透明化、知识库 Tab 化、知识自动召回
1.15.1	任务资料夹改 `<任务ID>-<标题片段>`、快录附件（图片/PDF/DOCX）、模型选择器、`/workbench` 命令
1.14.57	架构重构：面板可见性唯一权威源、删除 DOM 降级腿、能力门槛「明确不启动」
更早	完整发行说明见 `docs/releases/`

路线图

客户端 WorkbenchApp 拆分（施工图待重写）
任务拖拽排序、数据导入导出
定时自动化、多端同步（各自单独立项）

致谢

@Guojing6 —— v1.15.1 的多项能力源自其 fork Guojing6/dsh-workbench：任务资料夹改用任务 ID、快录附件、模型选择器、/workbench 斜杠命令、请求围栏加固；并定位了两个我们一直带着的真 bug。
@SnowNight777 —— v1.15.3 的三项修复全部来自其报告（issue #4 / #5 / #7 与 PR #6 / #8）；v1.16.5 的工作台样式自愈同样来自其 issue #9（含故障注入最小复现与只读状态采集脚本）与 PR #10（样式节点丢失后的自动恢复 + 生命周期清理 + 7 例回归）。
@Chewbacca96 —— v1.17.0 的 UI localization（issue #12）需求与边界定义。
@SnowNight777 —— v1.17.0 的宿主浮层挂载修复（issue #14）提供了真实测量、elementFromPoint 证据与可直接落地的方案；此前 v1.15.3 / v1.16.5 的贡献见下。
@tujunwenjie、@lhmhz —— issue 诊断报告。
@SnowNight777 —— v1.17.2 的模型选择器修复（issue #19 / PR #20）：报告自带两条根因（retain() 之后 scope 才物化； cordis traceable 服务把服务实例 ctx 影射成调用方 ctx，于是宿主里那句 this.ctx.remote.session 要求调用方 inject），并先划清「不能把可选 provider 写进 inject」的边界；PR 在 DSH 0.2.1-rc.3 桌面端实测通过。此前 v1.15.3 / v1.16.5 / v1.17.0 的贡献见下。
@WUWAN01 —— v1.17.2 的「AI 执行」弹窗视口缺陷（issue #17）：报告含完整 DOM 结构、lib/client.js:155 的 .wb-modal-mask 规则位置、task_sessions 0 行证据与可直接落地的修补建议（高度上限 / 内部滚动 / sticky 底栏），并指出 lib/client/styles.js 运行时并未被加载。
@Chewbacca96 —— v1.17.2 的 i18n 深度翻译二轮（PR #18）：面板入口、草稿横幅、设置、容量规则、任务详情与点子 Tab。
内置角色库含两个 MIT 上游（novotnyllc/dotnet-artisan、K-Dense-AI/scientific-agents）的领域角色，完整署名与「我们改了什么」见 THIRD_PARTY_NOTICES.md。

逐项来源与许可证见 THIRD_PARTY_NOTICES.md。

免责声明

社区项目，与 DeepSeek 官方无关，不提供任何担保。安装即表示你信任该代码会以你的 DSH 用户权限在本机运行；执行类 AI 操作可能修改工作区文件、消耗 API 额度，请先阅读代码并谨慎使用。

License

MIT。部分 DOM 挂载模式与客户端构建包装参考了 dsh-task-board（BSD-3-Clause）与 dsh-genui（MIT），详见 THIRD_PARTY_NOTICES.md。

English

A personal workbench plugin for DeepSeek Harness (DSH) — turn DSH into a calendar + hierarchical task list + AI assistant workbench. All data stays on your machine.

Highlights

📅 Calendar (week/month) + tree task list; Today / Calendar / Tasks views with combinable filters that keep parent-child structure
✨ Natural-language quick capture → AI clarification → task created; images and PDF/DOCX attachments supported
🧠 Multiple AI sessions per task: clarify / consult / breakdown / execute / review
🎭 Personas: three-tier library (user > external dir > 15 built-ins), picked per session, loaded on demand (never inlined into the prompt)
✅ "AI requests completion → you accept" loop; progress is an explicit value the AI cannot use to complete a task
🗓️ Daily plan + capacity ledger: AI proposes an order, only your confirmation applies it; "done for today" ≠ task completed
🎯 Pick Skill / model / persona before each AI session; prompt gets a "load these skills" instruction
⏰ Due reminders (in-panel banner + system notification), optional WeChat channel via @xmanrui/dsh-im
🌐 UI language: auto / 中文 / English (Settings → Language); top-level chrome, settings, personas/experts, quick capture, task forms, knowledge view and pickers are translated, with deeper copy migrated incrementally
🔒 Local-only storage at ~/.dsh/workbench

Install

Requires DSH ≥ 0.1.5-rc.1 (web), Node ^22.19.0 or >=24.0.0, pnpm >=11.7.0 <12.

dsh plugin --profile web add @dely0/dsh-personal-workbench
# or: dsh plugin --profile web add git+https://github.com/Dely0/dsh-personal-workbench.git

⚠️ You must restart dsh web after installing — the client bundle is read into memory at host startup, so a browser refresh keeps serving the old code.

Compatibility

	Requirement	If missing
Panel (official slots + `layout.selectPanel`)	DSH `0.1.5-rc.1+`	Panel refuses to start and logs a readable reason (deliberately not degraded)
Server-side features (tasks, reminders, reports, `workbench_*` tools)	`0.1.0-rc.6+`	—
Session binding via `sessions.retain()`	`0.1.7-rc.2+`	Falls back to `sessions.binding()` on older hosts
WeChat reminders	optional `@xmanrui/dsh-im`	Falls back to in-panel + system notifications

Development

pnpm install && pnpm check && pnpm test

Read .dsh/skills/dsh-plugin-change/ before changing code and .dsh/skills/dsh-release/ before publishing; a tick-box version of the release checklist lives in docs/release-checklist.md, and the automated verification chain in scripts/dev-verify.mjs.

Credits & License

Community project, not affiliated with DeepSeek; provided as-is. v1.17.2 ships fixes and translations from @SnowNight777 (model picker, #19/#20), @WUWAN01 (AI-run modal viewport, #17) and @Chewbacca96 (deeper i18n pass, #18). External contributions and bundled MIT-licensed persona sources are listed in THIRD_PARTY_NOTICES.md. Licensed under MIT.

README

亮点

安装

快速上手

兼容性

开发

版本历史

路线图

致谢

免责声明

License

English

Highlights

Install

Compatibility

Development

Credits & License

Related plugins

rea

Archify DSH 集成

dsh-plugin

answer-me-with-html

dashi-taskboard

dsh-agent-teams