前言¶
在 DeepSeek Harness (DSH) 工作区开发时，智能体会话之间通常缺乏上下文共享。每次新会话开局，智能体都需要重新了解项目背景；会话结束时，进展记录往往散落在对话历史中，难以追溯。dsh-project-progress 插件解决的是这个痛点，它为工作区提供一个共享的 PROGRESS.md 文档，用于维护项目档案和进展时间线。
这是什么¶
这是一个 DeepSeek Harness (DSH) 插件，用于为 DSH 工作区创建共享项目进展文档。它实现了跨会话的进度感知与发布状态档案管理，由 Jolly-J 维护。
核心功能¶
插件在工作区根目录维护一份 PROGRESS.md，文档分为两个区：
- 项目档案：维护稳定事实，如发布状态、GitHub 仓库地址、安装命令等。
- 进展时间线：只追加的条目，记录轮次、步骤、token 用量等。
通过系统提示词注入实现跨会话进度感知，智能体一开局就能读到项目状态。插件提供三个模型工具：
project_status：读取当前工作区的共享文档。project_update：向时间线追加一条进展。project_facts：整体替换「项目档案」区。
安装与启用¶
执行以下命令安装：
dsh plugin --profile web add https://github.com/Jolly-J/dsh-project-progress.git
安装完成后重启 dsh web 即可。
数据与隐私¶
- 本地读写：所有读写发生在本地工作区，只创建/更新工作区根目录的
PROGRESS.md，可随时手动编辑或删除。 - 无网络调用：不上传任何内容，不读取密钥。
- 会话限制：仅对顶层会话自动追加进展，子代理会话不写入。
- 写入规则：自动条目是结构化的（标题、轮次、token 用量），时间线只追加，旧条目不重写。
- 语言：文案目前是中文。
典型用法¶
- 执行
dsh plugin --profile web add https://github.com/Jolly-J/dsh-project-progress.git进行安装。 - 使用
project_update手动追加进展记录。 - 使用
project_facts更新项目档案信息。 - 在工作区根目录手动编辑
PROGRESS.md。
适用场景与注意¶
该插件适合需要在多会话中保持项目上下文的开发者。由于插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证。
短结尾¶
经过上面的步骤，你可以在 DSH 工作区中拥有一个结构化的项目进展文档。它通过本地文件和工具实现了隐私保护下的跨会话状态管理，是开发流程中的实用辅助。
