前言¶
DeepSeek Harness（DSH）支持插件化扩展。在使用 DSH 进行开发时，经常需要在不同会话间切换，或使用多个 CLI 工具协作。如何在会话之间保持项目上下文的一致性，以及如何规范地落盘项目记忆，是开发者常见的痛点。
dsh-project-manager 插件为 DSH 提供了一个项目看板，并将「项目记忆」作为落盘数据管理。它会将卡片关联的项目记忆（STATE + 必读文档）自动加载到会话中，并支持按规则持久化、同名检测、合并以及按组归档。
插件信息¶
- 名称：dsh-project-manager
- 维护者：hoyyang
- 类别：记忆
- 许可：MIT
- 核心价值：项目看板 + 落盘记忆。从卡片打开的会话会自动加载完整、最新的项目记忆（STATE + 必读文档）。
安装¶
安装过程零配置，开箱即用。
dsh plugin add dsh-project-manager
数据默认读写 ~/.ai。写入操作由插件自带的 ai-memory 处理，需要 python3 环境（Windows 上此部分会自动关闭，看板功能照常）。
核心功能¶
1. 项目看板与会话自动加载¶
- 看板功能：支持卡片组、泳道（阶段）和拖拽排序。
- 记忆自动加载：当从看板卡片新建会话时，插件会自动将该项目完整的 STATE 和标记为
[必读]的子文档注入到会话上下文中。 - 会话信息卡：会话顶部显示卡片资料、落盘项目详情、next_action 和操作按钮。
2. 规范化落盘与记忆持久化¶
- 持久化规则：支持同名检测、合并、按组归档，且支持可撤销的迁移。
- 防绕过保护：直接写入
~/.ai的文件操作会被拒绝，写入必须通过ai-memory，支持文件锁和乐观并发，确保多 CLI 共用同一记忆文件时不会覆盖。 - 规范检查：落盘时会进行版本化的检查清单校验，不符合规范的写入会被拒绝。
3. Agent 工具¶
插件提供了四个工具，可在项目会话中操作看板（不传 card 参数时作用于当前会话）：
* card_manage
* repo_manage
* phase_move
* task_manage
4. 其他特性¶
- 零配置：安装后直接使用。
- 深色主题：跟随 DSH 的深色主题。
- 文件索引：自动维护文件索引和文件夹组织。
典型用法¶
安装插件¶
dsh plugin add dsh-project-manager
使用 Agent 工具¶
在会话中调用工具来管理项目状态：
phase_move { "status": "verify" }
task_manage { "op": "add", "text": "修复登录 bug" }
调用落盘工具¶
使用 landfill 工具进行记忆读写：
landfill { "op": "recall" }
landfill { "op": "persist", "content": "...", "drop": [...] }
环境依赖与注意事项¶
- 运行环境：需要 DSH 的 Web 界面支持（CLI
dsh web或 DSH Desktop）。 - 依赖要求：
- Python3（用于 ai-memory，Windows 上自动处理）。
- Peer dependencies：
@deepseek-ai/cordis >=4.0.1 <5、@deepseek-ai/dsh-tools >=0.1.5-rc <2、@deepseek-ai/dsh-client-ui-slots >=0.1.5-rc <2、@deepseek-ai/schemastery ^3.18.1。
- Agent 工具限制：Agent 工具仅在项目会话中且未指定
card参数时生效。
总结¶
dsh-project-manager 通过看板与落盘记忆的结合，解决了 DSH 中项目上下文管理和记忆持久化的痛点。它不仅提供了可视化的项目管理界面，还通过严格的规则和并发控制，确保了记忆数据的完整性和一致性。
