dsh-project-manager

dsh-project-manager

给 DeepSeek Harness 加一块项目看板，并把「项目记忆」做成插件的本职：从卡片打开的会话，自动带上这个项目完整、最新的落盘记忆（STATE + 必读子文档）和卡片资料；说一句「落盘项目」就把进展按规范写回去，换会话、换 CLI、隔几天都能接着做。

English · Releases · 更新日志

安装

dsh plugin add dsh-project-manager

备选（直接从 GitHub 装）：

dsh plugin add github:hoyyang/dsh-project-manager

零配置、开箱即用：装完重启 dsh 即可，不需要账号、API Key 或任何设置项。落盘项目默认读写 ~/.ai（写入一律经插件自带的 ai-memory，需要 python3；Windows 上这块自动关闭，看板照常）。要改数据目录或权限模式见下文「配置」。

需要 dsh web 界面（CLI 的 dsh web 或 DSH Desktop）。侧栏增强（项目区数字、层级、「+」接管、空会话行）依赖 dsh 工作区列表的页面结构；dsh 改版后若对不上，这几项会自动不显示，看板、会话与落盘功能不受影响。

功能

会话自动带上完整、最新的项目记忆

• 从卡片开会话 = 上下文已经在了：卡片关联的落盘项目（STATE + 标 [必读] 的子文档）由插件把全文直接放进会话，系统提示里另有一段实时生成的「卡片档案」（仓库、子任务、说明、链接、文件）。不用先说「回忆」，第一句就能接着干。
• 永远是最新版，且不重复：别的会话或 Codex / Claude Code 等其他 CLI 改了 STATE，下一步自动补上新版（标明替代哪一版、谁写的）；会话压缩后重新补齐；同一版本只放一次，自己写的不回灌，分叉会话继承。
• 看得见 AI 收到了什么：会话信息卡里「查看 AI 收到的原文」逐字显示系统提示和注入的全文，标出版本、是否已在本会话、约多少 token，可一键复制。

说一句「落盘项目」，按规范写回去

• 一句话触发：会话里说「落盘项目 XX」把进展写进 XX 的 STATE，说「回忆 XX」/「继续 XX」先读全再接着做；触发词来自 ~/.ai 里现有的项目名和别名。只认指令写法，讨论「落盘项目这个功能」时不会误触发；规划模式下只提示不拉回。
• 防丢事实：没读全不能写；新稿少了旧稿里的 commit、路径、版本号、单号又没声明删除，直接拒绝；写完回读校验并给出前后大小、删掉了哪些章节。用户要求了而这一轮没做到，回合结束前把模型拉回补做。
• 一个项目一个文件夹：STATE.md 是唯一入口，plans/（批准的计划自动存进来）notes/ evidence/ 里每个文件都要在「📁 文件索引」里有一行；每次落盘都整体重写 STATE、顺手整理文件夹（重复的合并、过时的退役到回收区）。
• 卡片档案进 STATE：插件按看板生成「🗂 卡片档案」块写进 STATE（AI 不写），其他工具读 STATE 也能看到卡片资料。
• 防绕过：write / edit / bash 直接改 ~/.ai 下的记忆文件会被拒绝；写入只经 ai-memory（文件锁 + 乐观并发），和其他 CLI 共用同一个 ~/.ai 也不会互相覆盖。

会话信息卡：这个会话属于哪张卡片、带着什么，一眼看清

• 输入框上方一行：卡片组 / 卡片、落盘项目数、仓库 / 链接 / 子任务 / 说明胶囊，一键直达看板上的这张卡片。有关联是浅蓝，没关联是浅灰。
• 展开看全部：每个落盘项目一行（所属项目、别名、next_action、是否已注入、字数），可以单独「落盘」；下面是卡片资料。
• 落盘的结局如实显示：从信息卡点了落盘之后，这一轮写好了提示「落盘完成」；被你停止、出错、或者 AI 在问你，都会写明，并给「重新落盘 / 忽略」，不会一直转圈。

同名检测：不让同一个项目被建成两份

• 还没输入就提示：卡片没关联落盘项目时，按卡片名找到别名相同的已有项目，提示「可能就是这个」。
• 完全同名不让新建：输入的文件名或别名和已有项目相同，主按钮换成「关联并落盘」，并给出改名建议；名字相近时只提示，确认不是同一个可以照常新建。
• 每个候选看得清：字数、更新时间、已经关联了哪些卡片、落盘时会不会迁移；可以「只关联」，也可以「关联并落盘」。

按卡片组归档，按规范自动迁移

• 每个卡片组有自己的落盘文件夹：~/.ai/projects/<文件夹>/。第一次在这个组落盘时，信息卡请你确认一次（按组名给建议，可改），卡片组设置里也能改。新建、合并的落盘项目都放进这里。
• 规范是一张带版本号的检查清单：每次落盘都整张检查，所以不管 STATE 是按哪个旧版本写的，下次落盘都会被拉到最新规范。位置不对的由插件把整个文件夹迁过来（子文档一起搬、里面的旧路径改指新位置、~/.ai 里的外部引用改指向、卡片关联换成新位置，旧文件夹进回收区）；标题行、文件索引、别名行由落盘的 AI 按清单改好，不合规范不让写。
• 提前告诉你，事后能撤销：信息卡上提前标出「落盘时迁到 xxx」；迁移后显示「已按规范迁移」卡片，可以撤销（搬回原处，之后不再自动迁）或删除旧文件夹。跨组共用的留在第一个关联它的组；旧项目不会被主动批量迁移，只在被落盘时迁。

合并落盘项目

• 几份合成一份：同一张卡片关联的几个落盘项目可以合并（勾选要合的，没选的不动）。AI 读全每一份、先写要点再整体重写成一份 STATE；插件校验来源里的关键事实都还在，再按规范把所有文件放进合并结果文件夹（重复的只留一份，~/.ai 外引用的文件复制进 evidence/）。
• 旧名字变成别名：说「回忆 + 旧名字」照样能找到；卡片关联和 ~/.ai 里指向旧路径的引用一并改好。
• 可撤销、可删除、可嵌套：合并前的文件夹进回收区，可以撤销（只退一步），也可以永久删除；合并结果还能再合并。

看板：卡片组管父项目，卡片管任务

• 按项目看全局：每个卡片组一条泳道，阶段（列）名称、数量、顺序都能改；卡片在阶段内拖动排序（键盘 Alt+↑/↓），拖到别的阶段即推进；卡片组可拖动排序、点头部展开 / 收起。
• 卡片组标题旁的统计：卡片数是蓝底胶囊（0 张变灰），旁边「● N 活跃会话」= 本组卡片关联、没归档的会话数，会话一开一归档就更新；仓库数和阶段数是灰色小字。
• 每个阶段随手加卡：阶段底部常驻「添加卡片」，回车连续添加；也能从落盘项目批量导入（一个 STATE 生成一张卡片并自动关联）。
• 卡片上只放两个小标志：会话标志（有活跃会话为绿色、全部已归档为灰色）和落盘项目数。
• 卡片归档：点归档图标或拖进「已归档卡片」列表；归档的卡片可看只读详情、「恢复活跃」回原阶段。
• agent 也能改看板：card_manage / repo_manage / phase_move / task_manage 四个工具，在项目会话里不传 card 就作用于本会话的卡片。
• 深色主题：跟随 dsh，看板右上角可一键切换。

卡片详情

• 以此卡片新建会话：点了立刻显示「正在新建会话…」并锁住按钮，侧栏同时出现占位行；建好后侧栏那一行就是「卡片名 · 未开始」。会话默认完全权限，标题自动改成卡片名或「卡片组 · 卡片」。
• 本卡片的会话置顶：活跃在前、已归档在后，各自按更新时间排序；可打开、归档（还在运行时先确认「停止并归档」，可撤销）、「恢复活跃」回原位置、解除关联；还没对话的会话可以删除（需要 dsh-manage-sessions）。
• 关联已有会话：搜索会话名或仓库，活跃 / 已归档两列按仓库分组，勾选后一次保存；一个会话只属于一张卡片，分叉出来的会话自动跟着源会话的卡片。
• 关联的落盘项目：默认只显示标题，「展开详情」一次展开全部（项目、更新日期、一行状态、next_action）；下面「回忆」「落盘」两个按钮发到这张卡片最近的会话。
• 相关说明 / 相关链接 / 相关文件：说明不限字数、网址可点、过长折叠；链接有显示文字、类型（全局共用，可在「管理类型」里新增、改名、拖动排序）和完整网址，可批量添加，编辑 / 删除按钮常驻显示，可拖动排序、复制；文件用系统对话框多选或「粘贴路径」一次贴多行（逐行检查存在 / 是文件夹 / 不存在 / 已关联）。
• 阶段与子任务：步骤条点一下就移到该阶段；子任务勾选、删除、回车添加。

仓库

在 GitHub 閱讀完整 README →