前言¶
在 DeepSeek Harness(DSH)里用多个工作区跑智能体时,常见做法是手工开 Session、口头约定验收,任务状态和证据往往散在对话里,重启或并发一多就难追溯、难复验。DSH 社区插件 dsh-ai-company(仓库 DSM-DSM/dsh-ai-company)把「工作区」组织成带层级的「公司」联邦,用 SQLite 持久化工单(Ticket),并为每个 Ticket 配置 Worker 并发;完成与否不凭主观判断,而是靠独立的验收命令与结构化证据。设计思路参考 DeepSeek Super-agent 的并行、可验证执行模型。下面按定位、能力、安装与首单流程说明。
这是什么¶
dsh-ai-company(npm 包名 dsh-ai-company,当前资料中版本 2.0.0)由维护者 DSM-DSM 发布,许可证 MIT。在 SkillHub 目录 中分类为工作流。
一句话定位:把 DSH 工作区变成可持久、可并行、可验收、可恢复的「智能体公司」工单系统,而不是单次对话里的临时任务分配。
核心功能¶
资料中明确提供的能力如下。
组织与持久化工单¶
- 工作区可作为「公司」,并支持多级组织预设。
- 在 SQLite 中原子化创建链路:
Trigger → Decision → Ticket → Assignment → launch effect。 - 每个 Ticket 对应一个 DSH Worker Session,并发由
maxWorkers配置。
执行、证据与验收¶
- 产出结构化
orchestrator_report及检查项。 - 提供独立的
company_verify验收命令与证据覆盖检查。 - 语义说明(README 原文):
accepted表示已 durable 入队,不等于已完成;仅当每一条独立验收命令退出码为 0,且每一项要求的证据均已覆盖时,任务才称为 verified。
恢复与可选资产治理¶
- Effects/Outbox 持久化,支持 retry、stop、restart 恢复。
- 可选 AOCI/CodeGraph 资产治理;默认关闭自动开通。
主要工具(Agent 可调用)¶
| 工具 | 用途 |
|---|---|
company_dispatch |
原子创建并入队持久 Ticket |
company_tickets / company_collect |
查看执行、报告、证据与审计 |
company_verify |
重跑验收命令并校验证据 |
company_retry / company_stop |
恢复或撤回 Ticket |
company_list / company_health |
查看公司与运行时健康 |
company_policy / company_ledger |
查看价值策略与可选账本 |
company_repo_* |
可选代码/数据资产治理 |
Bundle 内含 worker 与组织预设;核心 Ticket 工作流无需单独再装 lean-worker、GitHub、Feishu、AOCI 或 CodeGraph。
环境要求¶
安装前确认:
- DeepSeek Harness
^0.2.1-alpha.2 - Node.js
^22.19.0 || >=24.0.0 - DSH 中已配置至少一个模型 Provider
安装与启用¶
官方 README 给出的步骤是:将仓库克隆到本机绝对路径后,用本地路径注册插件(不要凭仓库名自行拼接 dsh plugin add github:owner/repo)。
# Gitee
git clone https://gitee.com/AiALi7-9-22/dsh-ai-company.git /absolute/path/dsh-ai-company
# Or GitHub
git clone https://github.com/DSM-DSM/dsh-ai-company.git /absolute/path/dsh-ai-company
dsh plugin --profile web add /absolute/path/dsh-ai-company
安装或升级 JavaScript 模块后需重启 DSH。中文完整说明见仓库内 README.zh-CN.md。
典型用法:第一张 Ticket¶
README 建议由 DSH Agent 按顺序调用工具,字段需用绝对路径与明确范围。
- 调用
company_dispatch,传入绝对路径cwd、task、goal、scope.allow、acceptance、evidence。 - 用返回的
ticket_id调用company_collect收集执行与报告。 - 调用
company_verify做验收与证据核对。
执行目录两种模式:
execution_mode=workspace:在公司目录内工作。execution_mode=directory:每个 Ticket 使用空的独立目录。
注意:共享目录不提供写隔离;若需要隔离,应使用 per-ticket 目录模式。
适用场景与限制¶
适合谁
- 需要在 DSH 内做多工作区、多 Worker 并行,且要把「任务—分配—证据—验收」落在持久化工单上的团队或个人。
- 希望用可重复执行的验收命令定义「完成」,而不是只在对话里确认。
安全与权限(README 原文要点)
- 插件不读取 DSH cookie 签名密钥,不调用特权 loopback RPC,不强制
danger-full-access。 scope与policy是授权/审计语义,不是操作系统级沙箱。acceptance中的条目是可执行命令,必须来自可信来源。- 插件以当前 DSH 进程权限运行;安装前宜阅读源码、SECURITY.md、NOTICE 与 LICENSE。
当前版本侧重
- DSH 原生 Ticket 执行;无图形化 Ticket 面板。
- 默认不启用 GitHub/Feishu Sources。
- 尚未提供统一的第三方 quota 适配器。
DSH 生态理念是「一切皆插件」;SkillHub 等为社区目录站点,与 DeepSeek / 幻方无官方从属关系,下文链接仅供查找与核对,非「官方应用商店」上架声明。
结尾¶
经过上面的步骤,dsh-ai-company 的价值可以概括为:在 DSH 里用持久 Ticket、并行 Worker 和独立验收,把多工作区智能体协作从「一次性对话」拉到可审计、可恢复的工作流。