dsh-goal-board:跨會話的目標清單插件

前言

用 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜