前言¶

在 DeepSeek Harness（DSH）里做智能体或工作流，常见做法是本地目录、零散脚本或自建服务存状态。多人要对齐「这一步输入什么、输出什么、谁负责」，往往还要单独配数据库和登录。CollaborationBoard 插件把协作面直接装进 DSH 的 web 侧栏：内容都在 Git 仓库里，Harness 负责进程与界面，GitHub 负责权限与远程协作，中间不插独立后端。

下面介绍它是什么、能做什么，以及如何安装和上手。

这是什么¶

CollaborationBoard（npm 包名 @local/dsh-board，版本 0.1.0）由 DeepCollaboration 维护，在 SkillHub 目录中归类为工作流。官方简介：A shared board for stations, workflows and projects in DeepSeek Harness. No server, no database — GitHub is the access gate.

插件本身不拥有业务内容：界面由多个 Git 仓库拼装而成，你在界面上做的变更会写回对应仓库的新版本。

DeepCollaboration 组织下的公开仓库里，几类对象分工如下：

核心功能¶

单页界面¶

所有操作集中在一页：顶栏（当前板、标题、人员与工具、Station 搜索）、左侧 Rail（Library、History）、左右 Dock（库/历史与打开的 Station、对话）、中间 Canvas（卡片与连线）。可在 Canvas 上拖动 Station 与 Project、连接 Station、把 Project 交给下一步；Free 布局下位置会保留。

点击 Canvas 或库中的 Station，右侧 Dock 显示名称、版本、输入输出与运行说明。Station 上的对话在 Dock 中实时展示，与后续写入 transcript 的文本一致。

首次启动与只读浏览¶

首次启动时插件会自动拉取公开主 Board：

• 克隆 https://github.com/DeepCollaboration/board-hauptboard 到 $DSH_HOME/board/cache/DeepCollaboration/board-hauptboard
• 在 $DSH_HOME/board/boards.json 登记并打开主 Board
• 主 Board 指向的 stations、workflows、projects 进入同一 cache 目录：$DSH_HOME/board/cache/DeepCollaboration/<repository>

已有其他 Board 的注册表不会被覆盖。无网络时条目仍在，状态为「not fetched」，页面提供重试按钮，其余功能仍可用。

阅读不需要登记姓名。 首次启动后主 Board、其 Station、目录与 Probeprojekt（示例项目）即可打开；可浏览、打开文件、阅读对话。无写权限时顶栏显示 Read only 及原因，库仍可浏览。只有在参与贡献、创建内容或拥有自己的 Board 时才需要自己的名称。

目录与引用¶

目录会在未登录情况下搜索 topic 为 dsh-board-station 的公开 Station；找到的可读并加入 Workflow，写入的只是引用而非复制 Station 本体。

拥有自己的 Board¶

在主 Board 的 Library 顶部切换到 Catalog，找到 Probeprojekt，点击 Import into my Board：

1. 若尚未填写姓名，表单会收集姓名、GitHub 名（可选）与颜色（适用于所有 Board）
2. 在 $DSH_HOME/board/ablagen/<id>/ 创建本地 Board（例如 annas-board）
3. Probeprojekt 以副本形式放入你的 Board（副本仓库在 vorhaben-probeprojekt-kopie/，通过 fork_von 指向原项目；Workflow 与 Station 仍为引用）
4. 新 Board 打开后，可用 Board 栏在主 Board 与自有 Board 间切换，无需整页刷新

自有 Board 起初无 remote，仅在本机；若要发布到组织，需要 GitHub token。

创建 Station（需 token）¶

在 Library 的 Stations 下，当已保存 token 且已知 owner 时会出现 Create station。在 Settings → Board → GitHub 保存 token 后，表单会在 owner 下创建公开仓库 station-<id>（topic dsh-board-station），含 station.json 与 README，并将 owner/repo 写入 board.json。无 token 时界面保持可读，创建尝试会提示上述路径。

安装与启用¶

环境要求：已安装 DeepSeek Harness，Node ≥ 24，以及 Git。

安装命令（写入 web profile 并启用）：

dsh plugin --profile web add github:DeepCollaboration/DeepSeekCollaborationBoard-Plugin

安装后重启 DSH；页面出现在侧栏。该 profile 的配置位于 $DSH_HOME/profiles/web/，README 说明无需手改其中内容。

若启动报 “Failed to load plugins” 且含 @local/dsh-board: failed，常见原因是 dashboard 服务未在 client.js 的 inject 中注册；Board 需要 slots 与 locale。修复方式是在 inject 中补全服务后重启。更多案例见仓库 docs/fehlersuche.md。

典型用法小结¶

1. 执行上述 dsh plugin --profile web add ...，重启 DSH，从侧栏打开 Board。
2. 先以只读方式浏览主 Board、Station、Workflow、目录与 Probeprojekt。
3. 需要写入时：在 Settings → Board → GitHub 配置 token；通过 Catalog 导入 Probeprojekt 得到本地 Board，或在 Stations 下创建新 Station。
4. 在 Canvas 上组织 Workflow 与 Project，在右侧 Dock 查看 Station 详情与对话。

适用场景与注意¶

适合需要在 DSH 内用版本化的 Git 仓库共享工作流步骤、项目进度与对话记录，且希望不自建服务器与数据库的团队或个人。公开内容以 DeepCollaboration 组织下的仓库为起点；写操作依赖 GitHub 身份与 token。

插件在当前 DSH 进程权限下运行，首次 clone 与写 remote 会使用本机 Git 与网络。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证；社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，仅为社区收录。

结尾¶

CollaborationBoard 把 Station、Workflow、Project 与 Board 统一成 DSH web 侧栏里的一块协作面：读公开主 Board 几乎零配置，写与建库则走 GitHub。若你的工作流已经习惯「一切皆 Git」，这个插件是对 DSH「一切皆插件」思路的直接延伸。

• 目录页：https://www.skillhub.cn/plugins/DeepCollaboration/DeepSeekCollaborationBoard-Plugin
• 源码与文档：https://github.com/DeepCollaboration/DeepSeekCollaborationBoard-Plugin