前言¶

在 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