前言¶
用 DeepSeek Harness（DSH）做智能體開發時，工作區裏往往要維護一批結構化任務，而不是散落在 markdown 裏的 TODO。Beads 用 bd CLI 和 Dolt 數據庫做依賴感知的問題跟蹤，智能體側常用 bd ready、bd update --claim、bd close 等命令。若只在終端裏操作，和 Web GUI 裏的工作區切換並不直觀。下面介紹社區插件 dsh-beads-panel（維護者 LiuPack，分類：客戶端）：把 Beads 接到 Harness 左側邊欄面板列表，直接讀寫當前工作區已有的 Beads 數據庫，不把狀態複製到別處。
這是什麼¶
dsh-beads-panel 是 DeepSeek Harness 的插件 bundle，在 Web GUI 左側 Beads 面板裏瀏覽、創建、認領（Claim）和關閉（Close） bead。數據來自 Harness 已註冊工作區上的 bd 數據庫；插件與 bd CLI 操作同一份庫，不另建副本。
社區目錄頁：https://www.skillhub.cn/plugins/LiuPack/dsh-beads-panel
源碼與說明：https://github.com/LiuPack/dsh-beads-panel
核心功能¶
README 中列出的面板能力如下（均針對工作區的 Beads 數據庫 bd）：
- 列表篩選：Ready、In progress、Open、All。
- 單條詳情：描述、備註、依賴、元數據、評論等內聯展示。
- 新建 bead：表單字段包括 title、priority、type。
- 操作：對選中項執行 Claim、Close。
- 邊界狀態：未安裝
bd、或工作區尚未bd init時，界面有對應提示而非硬報錯。
插件實現拆成兩半（瀏覽器端不執行 shell，每次請求只能走 Host 允許的固定動作）：
| 部分 | 文件 | 職責 |
|---|---|---|
| Host | index.js |
提供經 owner 認證的 GET/POST /__dsh_beads/api；通過 Host 工作區註冊表解析 workspace id，每個動作調用一次固定的 bd 命令。 |
| Client | client.js |
在 sidebar.panellist 註冊 beads 及對應 main 面板；渲染列表、詳情與表單，數據操作一律經 Host。 |
允許的 API 動作包括：status、issues、issue、create、claim、close。
其他已覈實細節：
- 寫操作會排隊：內嵌 Dolt 只允許單寫者。
- UI 支持英文與簡體中文，樣式僅用 Harness 主題 token，自帶圖標。
- 發佈包版本 1.0.0（見
package.json），運行時要求 Node.js >= 22，許可證 MIT。
安裝與啓用¶
前置：Beads CLI¶
Host 需要在 PATH 上找到 bd（或通過環境變量 BEADS_BIN 指定）。README 給出的 Beads 安裝示例：
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
查找順序（資料原文）：Host 子進程服務優先，其次 /opt/homebrew/bin/bd、/usr/local/bin/bd、~/.local/bin/bd、/usr/bin/bd；可用 BEADS_BIN 覆蓋。
從 npm 安裝 bundle¶
dsh plugin --profile <profile> add dsh-beads-panel
將 <profile> 換成你實際使用的 DSH profile 名。
本地 checkout 安裝（可選）¶
在具備 Full access 的 Harness 會話中，可將倉庫 checkout 作爲本地 bundle 安裝。README 示例爲 clone 後執行：
plugin_manager action=install_bundle target=<absolute path to this checkout>
安裝完成後，在左側邊欄面板列表中選擇 Beads。
卸載：
plugin_manager action=remove_bundle target=dsh-beads-panel
典型用法¶
- 面板會列出 Harness 已註冊的工作區，並記住上次選擇的工作區。
- 在目標工作區目錄執行
bd init，創建該工作區的 Beads 數據庫。 - 在側欄打開 Beads，用篩選器查看 Ready / In progress / Open / All，點選條目看詳情。
- 需要新任務時用 New bead 填寫 title、priority、type；對當前選中項使用 Claim 或 Close，與 CLI 側語義一致，經 Host 調用
bd。
經過上述步驟，智能體在終端用 bd 維護的結構化記憶，與 GUI 裏看到的是同一份數據。
適用場景與注意¶
適合誰：已經在工作區使用 Beads / bd，希望在 DSH Web 側欄裏查看和操作 issue 圖，而不想維護單獨的 TODO 文檔或第二份狀態。
權限與安全：插件以當前 DSH 進程權限運行；Host 側對工作區目錄執行 bd。安裝前建議閱讀 源碼 與 MIT 許可證，確認符合你的環境策略。SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態強調「一切皆插件」，本文介紹的是社區維護的客戶端 bundle，而非官方應用商店條目。
依賴：除 DSH 與 Node 外，必須能可靠調用 bd；未 bd init 的工作區只能看到友好提示，無法當作 Beads 項目使用。
結尾¶
dsh-beads-panel 把 Beads 的讀寫收斂到 Harness 左側面板：篩選、詳情、新建、Claim、Close 都走 Host 統一的 bd 調用，瀏覽器端不碰 shell。若你已在用 bd 做智能體任務記憶，可在安裝 CLI 與 bundle 後，從側欄 Beads 直接與工作區數據庫對齊。
