前言¶
在 DeepSeek Harness（DSH）里做单次对话式编码并不困难，但若要把「功能开发、缺陷修复、安全审计」拆成多角色协作、每轮尝试独立 Session、又能在面板里查看步骤输出与历史记录，往往要自行拼装脚本与状态存储。原版 Antfarm 已经用 YAML 定义团队与工作流，各专家保留独立身份与人格文件；把它搬进 DSH 宿主，需要对接原生 Agent Preset、本地 spawn 以及 Web 侧的控制与展示。
下面介绍社区插件 @winterhuan/dsh-antfarm（仓库 winterhuan/dsh-antfarm），它把原版 Antfarm 团队接到 DSH Web Profile，提供工作流看板、/antfarm 命令与原生运行控制；版本 0.3.3 面向 DSH 0.2.2-rc.1，并保留对历史 0.2.0 运行的只读检视能力。
这是什么¶
@winterhuan/dsh-antfarm 是一个 package-bundle 类型插件，由维护者 winterhuan 发布，许可证为 MIT。一句话定位：在 DSH 中运行原版 Antfarm 的功能开发、缺陷修复与安全审计团队；每位专家保留自己的身份、人格与工作区，每次尝试使用新的 Session；可在工作流看板上配置 Agent、启动任务并检查步骤输出、stories 与原生 transcript。
插件不注册 Antfarm 角色 preset，而是依赖 Web Profile 提供的原生 standard Agent Preset 与本地 spawn provider；安装后会增加五项工作流相关工具、/antfarm 命令、Session 侧栏与工作流看板。
核心功能¶
内置团队与工作流¶
默认展示功能开发（feature-development）团队；同样可选用 bug-fix 与 security-audit 团队。编码类团队按原版 Agent 说明使用 Git 与 GitHub CLI，所选工作流会授权其声明的 PR 相关动作，使用前需准备好仓库、依赖与凭证。
Web 工作流看板与侧栏¶
在左侧打开 Antfarm workflow board，选择带有项目 cwd 的根 Session，再选工作流并描述任务；审阅团队后点击 Start run，无需输入命令或打开右侧栏即可启动。
展开某个 Agent 可编辑名称、模型、超时与人格文件；启动前点击 Validate and save，新任务会使用已保存配置。空模型字段会继承工作流模型或 DSH 默认。Advanced configuration 提供完整 YAML、保存位置以及复制、覆盖移除等控制。
右侧栏也可打开 Antfarm，用于配置团队、启动运行并查看步骤、输出、stories、事件与子 Session。全局看板展示已显式授权的 Session 与运行；列表分页为每页 50 行，可见视图会刷新，隐藏视图停止轮询，刷新失败时保留已加载内容。
命令行与模型工具¶
除面板外，可在带项目 cwd 的根 Session 中使用 /antfarm 子命令。模型侧提供 antfarm_run、antfarm_list、antfarm_status、antfarm_resume、antfarm_cancel 等工具；run/resume 默认等待工作流结束，除非设置 background: true；命令与面板启动会返回 admission receipt。读与控制操作均校验原始根 Session 的归属。
进度、恢复与工作区¶
Worker 须返回显式 STATUS: done、STATUS: retry 或 STATUS: failed；成功回复须包含步骤的 expects 文本。Resume 会重置失败步骤并保留已完成 stories 与已消耗的 story 重试计数，遵循原版 Antfarm 语义；已完成或已取消的运行不可再 resume。
稳定 Agent 工作区位于 $DSH_HOME/antfarm/workspaces/<workflow>/<baseDir>；完成循环的进度会归档到开发者工作区的 archive/<runId>/progress.txt。历史按运行记录的 JSONL 数据保存在配置的 journalRoot 下；旧版运行可作为只读检视记录保留。
工作流发现与配置¶
发现顺序为：<project>/.antfarm/workflows、配置的 workflowDirs、插件自带的 workflows/。自定义工作流使用原版 Antfarm YAML，并通过 workspace.files 引用 IDENTITY.md、SOUL.md、AGENTS.md 等。Native Plugins 设置中可调整 journalRoot、workflowDirs、defaultWorkflowId、maxActiveRuns 等运行时项；结构变更会重启服务。
安装与启用¶
环境要求（来自 README）：Node.js ^22.19 || >=24，pnpm 11.7.0，以及提供原生 standard Agent Preset 与本地 spawn provider 的 DSH 0.2.2-rc.1 Web Profile。
若当前 Profile 已安装无作用域的旧包 dsh-antfarm，需先移除再安装带版本的发布包：
dsh plugin --profile web remove dsh-antfarm
安装固定版本 tag：
dsh plugin --profile web add github:winterhuan/dsh-antfarm#v0.3.3
插件在 DSH 进程权限下运行。安装前应自行查看仓库源码与 MIT 许可证，确认与本地 DSH 版本、Profile 能力匹配。
典型用法¶
从看板启动¶
- 打开左侧 Antfarm workflow board。
- 选中含项目工作目录的根 Session。
- 选择工作流（默认功能开发团队）并填写任务描述。
- 按需展开 Agent 校验模型与人格，Validate and save 后点击 Start run。
从命令启动与巡检¶
短形式 /antfarm <task...> 默认使用 feature-dev 工作流：
/antfarm run --workflow feature-dev implement payment callbacks
/antfarm fix duplicate callbacks
/antfarm audit authentication
/antfarm workflows
/antfarm list
/antfarm status <runId-or-number>
/antfarm stories <runId-or-number>
/antfarm logs [runId-or-number]
/antfarm cancel <runId> [reason...]
/antfarm resume <runId> [guidance...]
失败步骤修正后可用 resume 附带恢复说明；中断的原生尝试需结合 transcript 与恢复指引处理，宿主不接受第二个并发执行器。
适用场景与注意¶
适合已在 DSH Web 环境开发、并希望复用原版 Antfarm 多 Agent YAML 与团队编排的维护者与个人开发者。需要 DSH 0.2.2-rc.1 与对应 Web Profile 能力；编码工作流依赖 Git/GitHub CLI 与仓库侧准备。
注意：插件不迁移或清理历史 journal 中的旧运行执行器；共享 Agent 工作区无 Run 级清理操作。移除正在使用的工作流前，需先取消并排空其所属运行。社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装源以 GitHub 发布 tag 为准。
结尾¶
@winterhuan/dsh-antfarm 把原版 Antfarm 团队、SQLite 进度与 DSH 原生运行控制接到同一套 Web 工作流体验里，适合在 DSH「一切皆插件」生态中做声明式多 Agent 交付。进一步了解可访问目录页 https://www.skillhub.cn/plugins/winterhuan/dsh-antfarm 与仓库 https://github.com/winterhuan/dsh-antfarm。
