前言¶
DeepSeek Harness (DSH) 提供了智能體的運行環境，但在處理多智能體協作時，會話記錄往往容易隨會話狀態丟失，且缺乏結構化的任務管理。dsh-chaos 是一個爲 DSH Web 界面添加本地協作空間能力的插件，由 hanxuanliang 維護。
它基於 Raft 的設計理念，通過一個事務性的本地賬本，爲智能體提供穩定的身份、頻道與線程、任務生命週期以及權威的消息投遞機制。
核心功能¶
該插件提供了以下能力：
- 穩定智能體 (Stable Agents): 智能體在 DSH 會話被替換時，依然保持其身份、自定義頭像、章程、工作區配置和頻道成員資格。
- 頻道與線程 (Channels and Threads): 頻道管理協作目的與生命週期，線程繼承父級權限並支持關注機制，用於控制消息投遞。
- 任務生命週期 (Task lifecycle): 將任意消息錨定爲編號任務，支持認領、指派、狀態流轉（Todo → In Progress → In Review → Done）和版本控制。
- 權威交付 (Authoritative delivery): 消息、投遞狀態和水印通過原子事務提交。這意味着瀏覽器刷新、插件重啓或會話替換後，協作記錄依然可恢復。
- 活動收件箱 (Activity inbox): 基於已提交的消息、線程關注和任務狀態生成活躍視圖，而非依賴客戶端猜測。
- 官方 DSH 界面集成: 完全使用 DSH 提供的側邊欄、設置頁面、覆蓋層和佈局插槽，不 fork 客戶端代碼。
安裝與啓用¶
在安裝前，請確保已安裝 0.1.0-rc.7 版本的 DSH CLI。該插件需要 Node.js ^22.19.0 或 >=24.0.0，以及 pnpm 9。
通過 npm 安裝預構建插件：
dsh plugin --profile web add @hanxuanliang/dsh-chaos@0.1.2
若需從 GitHub 安裝源碼版本：
npx @deepseek-ai/dsh@0.1.0-rc.7 plugin --profile web add github:hanxuanliang/dsh-chaos#v0.1.2
插件支持 Linux x64 (glibc)、Windows x64、macOS x64 以及 macOS arm64 平臺。
典型用法¶
- 打開 Settings → Collab Agents，創建一個智能體。你需要填寫名稱、章程、提供商、模型和智能體預設。其工作區由 DSH 管理。
- 從側邊欄打開 Collab，創建一個頻道，描述其用途，並將智能體設爲初始成員。
- 在頻道編輯器中發送消息。如果希望該消息成爲可追蹤的工作任務，請使用 As task 選項。
- 可以通過消息回覆入口在線程中繼續討論，或切換到任務看板認領並推進任務狀態。
適用場景與注意¶
- 版本兼容性: 本插件版本 0.1.2 嚴格針對 DSH
0.1.0-rc.7版本。 - 權限風險: 每個由 Chaos 管理的智能體會話默認開啓 DSH 的
danger-full-access權限預設。這意味着智能體無需審批提示即可運行命令，並且可以對 DSH 進程權限範圍內的文件進行讀取、修改或刪除。請僅在受信任的模型和隔離的賬戶或機器環境中使用此插件。
生態背景¶
DeepSeek Harness 採用“一切皆插件”的架構。dsh-chaos 作爲工作流類插件，通過官方提供的 API 嵌入到 DSH Web 界面中。生態目錄由社區維護，與 DeepSeek 或幻方無官方隸屬關係。
- 插件目錄: https://www.skillhub.cn/plugins/hanxuanliang/dsh-chaos
- 源碼倉庫: https://github.com/hanxuanliang/dsh-chaos
