前言¶
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