dsh-workstate

用于在不同 AI Coding Agent 之间交接任务的结构化工作状态协议。

dsh-workstate 是 DeepSeek Harness 的本地优先插件。它保存任务目标、进度、决策、失败、验证结果、变更路径、下一步以及 Git 完整性指纹，而不是导出聊天记录。

安装

要求 Node.js 22.19+ 和 DeepSeek Harness 0.1.0-rc.6。

dsh plugin --profile web add dsh-workstate

在 ~/.dsh/profiles/web/cordis.patch.yml 中保留已有配置并加入：

- insert:
    - id: workstate
      name: dsh-workstate

重启 DSH 后即可使用。

命令

/workstate checkpoint [备注]
/workstate transfer [接收目标]
/workstate list
/workstate inspect [id]
/workstate diff <from> <to>
/workstate validate [id]
/workstate resume [id]
/workstate resume [id] --allow-diverged

设计原则

• Packet 只有 checkpoint 和 transfer 两种；resume 是操作。
• 默认拒绝恢复到已经分叉的工作区；只有用户显式输入 --allow-diverged 才能继续。
• 不保存源码、Diff、终端全文或环境变量，只保存路径和摘要。
• 检测到常见凭据格式时拒绝写入。
• 永不自动 checkout、reset、stash、stage、commit 或 push。

开发

npm install
npm run check

MIT License。