个人工作台 Dely0/dsh-personal-workbench

dsh-personal-workbench

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

快速上手

1. 侧栏点「工作台」打开面板；
2. 「快速录入」说一句话 → AI 澄清 → 确认建任务；
3. 任务详情点「AI 执行」→ 在会话里干活 → 完成后回面板验收；
4. 「今日」看待办与容量，需要时点「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 本地化（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。

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 请求完成 → 你确认」闭环；进度是显式值，AI 不能拿它把任务标记为完成
- 🗓️ 每日计划 + 容量账本：AI 提出排序，只有你确认后才生效；「今天到此为止」≠ 任务完成
- 🎯 每次 AI 会话前选技能 / 模型 / 人格；提示词里会带上「加载这些技能」的指令
- ⏰ 到期提醒（面板内横幅 + 系统通知），可选微信通道，走 @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
or: dsh plugin --profile web add git+https://github.com/Dely0/dsh-personal-workbench.git

⚠️ 安装后必须重启 dsh web —— 客户端 bundle 在宿主启动时读入内存，只刷新浏览器仍会跑旧代码。

兼容性

| | 要求 | 缺失时 |
| 面板（官方插槽 + layout.selectPanel） | DSH 0.1.5-rc.1+ | 面板拒绝启动，并记录可读的原因（刻意不做降级） |
| 服务端功能（任务、提醒、报告、workbench_ 工具） | 0.1.0-rc.6+ | — |
| 通过 sessions.retain() 绑定会话 | 0.1.7-rc.2+ | 旧宿主上回退到 sessions.binding() |
| 微信提醒 | 可选 @xmanrui/dsh-im | 回退到面板内 + 系统通知 |

开发

pnpm install && pnpm check && pnpm test

改代码前先读 .dsh/skills/dsh-plugin-change/，发布前先读 .dsh/skills/dsh-release/；勾选版发布清单在 docs/release-checklist.md，自动化验证链在 scripts/dev-verify.mjs。

致谢与许可

社区项目，与 DeepSeek 无隶属关系；按现状提供。v1.17.2 包含来自 @SnowNight777（模型选择器，#19/#20）、 @WUWAN01（AI 运行弹窗视口，#17）和 @Chewbacca96（更深入的 i18n 改造，#18）的修复与翻译。外部贡献和随包分发的 MIT 许可人格来源列在 THIRD_PARTY_NOTICES.md。
基于 MIT 许可。