前言¶
用 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 直接与工作区数据库对齐。
