前言¶
用 DSH 跑多轮任务时,一个常见问题是「干了很久但没有记录」。agent 每轮窗口都是新的,上一轮的目标、做到了哪一步,如果不落盘就只能散落在对话里,容易丢、也容易重复做。dsh-goal-board 就是针对这个问题的插件:把目标按项目 → 目标 → 条目三层记下来,每轮自动注入给 agent,做完由 agent 核对产出后归档。
插件由 Little-Mostima 维护,在社区目录里归在「记忆」分类,当前的星标数是 0,版本为 0.2.0(仓库 tag 自 v0.2.0 起)。下面介绍它的定位、安装方式和行为要点。
这是什么¶
一句话定位:一家人和 agent 共用的目标清单看板,跨会话保存进度,每轮把当前该做的条目注入 agent 上下文。
它解决的是目标与进度的外置记忆问题。这里的「人」负责拆目标、看状态,「agent」负责认领、推进、核对产出并归档。数据不在插件仓库里,而是落在工作目录的 .dsh\goal-board\data.json,插件启动时读入内存维护,变更即落盘,因此升级或回滚代码不影响清单数据。
核心功能¶
1、三层清单:项目 → 目标 → 条目。目标下挂具体条目,条目是实际被认领和执行的单位。
2、每轮注入:服务端在每一轮对话开始时,把当前清单状态注入给 agent,让它知道该做什么、做到哪了。
3、认领与心跳释放:条目被认领后带心跳,30 分钟没有动静自动释放,卡片回到「排队中」,不需要人工干预。调试时可以用环境变量 DSH_GOAL_BOARD_TTL_MS 改这个时长。
4、自动归档:目标做完后由 agent 核对产出、填写产出指针,然后归档,并从清单中移除。
5、会话活动登记:插件登记最近 2 小时内有活动的会话。如果某个会话在这期间没有对应的卡,每轮注入会点名要求它先开卡,防止「干了很久但没有记录」。
6、墓碑保护:手动删掉的目标会留下墓碑文件 .dsh\goal-board\tombstones.json,之后每轮注入都会提醒 agent 不要重建、也不要接着做这些被删除的目标。
安装与启用¶
安装命令来自官方 README,直接在 DSH 里执行,指向本仓库:
dsh plugin add github:Little-Mostima/dsh-goal-board
装好之后重启桌面端才会生效。清单数据落在 .dsh\goal-board\data.json,同目录下的 data.backup-*.json 是备份;卸载插件不会删除这些数据文件。
如果不想手动敲命令,README 给了一句可以直接发给任意 agent 的指令,安装和更新都用它:
帮我安装或更新 dsh-goal-board 插件:
dsh plugin add github:Little-Mostima/dsh-goal-board(已经装过就再执行一次,会覆盖成最新版),装完重启桌面端,然后告诉我目标清单面板在哪、当前版本号是多少。
更新方式与安装相同,重新执行同一条命令覆盖成最新版,再重启桌面端。版本号可以看 package.json 的 version 字段,或仓库的 tag(v0.2.0 起)。
注意:服务端(index.js)和面板(client.js)都不支持热重载,改动代码后同样需要重启桌面端才能生效。
典型用法¶
1、跑冒烟测试。仓库自带 self-test,它用一个临时的 DSH_HOME 跑假 ctx,共 15 项断言,不会碰真实清单。在仓库根目录执行:
node smoke.test.mjs
2、日常流程。在桌面端的面板里把目标拆成条目,agent 每轮开始时收到注入清单,认领条目推进;完成后由 agent 核对产出并归档。如果某条目被认领后 30 分钟没有心跳,会自动回到「排队中」等待重新认领。
3、处理已删除目标。手动删掉的目标会留下墓碑,后续每轮注入都会提醒 agent 不要重建这些目标,避免被删掉的条目被一遍遍重新捡起来做。
适用场景与注意¶
适合在 DSH 里跑多轮、多任务、需要跨会话追踪目标和进度的场景,尤其是希望目标和产出可追溯、不想只靠聊天记忆的情况。
几点需要注意:
1、插件以当前 dsh 进程的权限运行。安装前应检查源码与许可证,确认没有超出你预期的能力。本插件许可证为 MIT。
2、清单数据存放在本地 .dsh\goal-board\ 目录下,卸载插件不会清除;反过来,升级或回滚代码也不影响已有数据。
3、插件对 @deepseek-ai/dsh-tools 的依赖是可选 peerDependency,package.json 中声明了兼容的 dsh 版本 0.2.1-rc.5(compatible)。
4、星标数为 0,属于较新的社区插件,采用前建议先跑上面的冒烟测试并通读源码。
结尾¶
dsh-goal-board 的价值在于把「目标」和「进度」从对话里搬到一个跨会话、可追溯的三层清单上,每轮自动注入,做完自动归档。它依赖本地数据文件,改动不热重载,安装前需要自行检查源码。
目录页:https://www.skillhub.cn/plugins/Little-Mostima/dsh-goal-board
GitHub:https://github.com/Little-Mostima/dsh-goal-board