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）
🔒 数据只在本机 ~/.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.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）。
@tujunwenjie、@lhmhz —— issue 诊断报告。
内置角色库含两个 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
🔒 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. External contributions and bundled MIT-licensed persona sources are listed in THIRD_PARTY_NOTICES.md. Licensed under MIT.

dsh-personal-workbench

Installer

README