前言¶
在 DeepSeek Harness（DSH）里做复杂开发时，常见做法是单会话里反复改 prompt、手工拆任务，或自己记进度。任务一多，谁负责哪块、当前处在「开发还是审计」、并发有没有打满，都不直观。DevFlow（@xiaoxie-ide/dsh-devflow）是维护者 BinXie-lixiangdehua 发布的工作流类插件，把一次 dsh 会话组织成带可见控制面的多智能体编排：角色分工、状态机、调度工具与右侧面板一起落地，状态落在工作区 .devflow 目录。
这是什么¶
DevFlow 是面向 DeepSeek Harness 的多智能体工作流编排插件，当前 README 标注版本为 1.5.1（2026-10-11）。仓库：BinXie-lixiangdehua/dsh-devflow；社区目录页：SkillHub 插件页。许可证为 MIT。
核心功能¶
下面介绍 README 中明确写出的能力，不展开未在资料中出现的用法。
角色与编制¶
- 总指挥（Commander）：规划与派发。
- 固定员工：架构（architect）、后端（backend）、前端（frontend）、代码审计（code-auditor）等固定角色。
- 临时子智能体：按任务创建，用完即走。
状态机与持久化¶
流程阶段为：派发（dispatch）→ 执行（execution）→ 审计（audit）→ 返工（rework）→ 验收（acceptance）。每一步对应持久化的业务实体，目录在工作区 <workspace>/.devflow，并配有只追加的 journal。
调度平面（devflow_* 工具）¶
提供 devflow_* 系列工具（task / scope / assignment / dispatch / transition / roster 等）。并发上限为 5，超出则排队；每次 hand-off 有调度诊断信息。
可视化面板¶
挂载在 dsh 右侧边栏：画布上每条边表示一次派发；编制条显示 fixed / temporary 与实时 concurrency N/5；节点可点开 inspector 查看详情。
环境要求¶
| 项 | 要求 |
|---|---|
| Node | ^22.19.0 或 >=24 |
| pnpm | 任意较新版本 |
| dsh | 已安装且可编辑 profile（如 ~/.dsh/profiles/web）；目标范围 >=0.1.7-rc.1 <0.3.0（不再支持 dsh 0.1.5） |
| OS | Windows 为 README 写明已测平台；预设会在 win32 用 tool-pwsh、其它平台用 tool-bash |
安装与启用¶
官方推荐 一条 PowerShell 命令（资料原文；会先 clone 再执行安装脚本）：
git clone https://github.com/BinXie-lixiangdehua/dsh-devflow.git "$env:USERPROFILE\.dsh\local-plugins\dsh-devflow"; & "$env:USERPROFILE\.dsh\local-plugins\dsh-devflow\install.cmd"
若目录已存在，可在插件目录单独运行 install.cmd（内部调用 install.ps1）。
常用参数示例：
# 仅预览将修改的文件，不写盘
.\install.ps1 -DryRun
# 指定 dsh 目录与 profile，或跳过 preset 步骤
.\install.ps1 -DshHome 'C:\Users\me\.dsh' -Profile 'web'
.\install.ps1 -SkipPreset
# 安装指定 tag/branch
.\install.ps1 -Ref 'v1.5.1'
安装脚本会改动的五件事（README 摘要）：把插件放到 ~/.dsh/local-plugins/dsh-devflow（默认）；在插件目录内 pnpm install（避免 profile 只 link 却缺 @deepseek-ai/* peer）；在 profile 的 package.json 注册 @xiaoxie-ide/dsh-devflow 的 link: 依赖与 dsh.profile.bundles；在 profile 内再 pnpm install；按检测到的 dsh 代际部署 agent preset（0.1.5 与 0.1.7+ 路径不同）。被覆盖文件会备份为带时间戳的 .bak-devflow-*。
经过上面的步骤，重启 dsh，新建或打开会话，在 preset 中选择 DevFlow 即完成启用。
典型用法（来自官方说明）¶
资料未给出「一句话对话示例」，但启用 preset 后的工作方式可归纳为：
- 在 DevFlow preset 下发起需求，由 Commander 规划并派发。
- 通过
devflow_*工具推进 task、scope、assignment、dispatch、transition、roster；并发超过 5 时自动排队。 - 在右侧 DevFlow 面板查看派发边、编制与并发占用，必要时对节点做 inspector 查看。
- 在项目工作区查看
<workspace>/.devflow下的状态与 journal，用于追溯审计与返工环节。
若需从源码改 src/ 再发布，仓库约定顺序为：pnpm typecheck → pnpm build → pnpm check → pnpm test；改完 lib/ 后需 bump preset 里 ?rev= 或重启 dsh 以加载新模块（README 说明）。
卸载（简要）¶
- 删除
~/.dsh/.agent-presets/devflow/。 - 从 profile 的
package.json去掉依赖与 bundle 项，或恢复package.json.bak-devflow-<timestamp>。 - 在 profile 目录再执行
pnpm install，然后删除插件文件夹。
.devflow 在项目工作区内，需自行清理。
适用场景与注意¶
适合谁：已在 DSH 上做多步骤交付、希望固定角色 + 状态机 + 可视化调度，而不是纯聊天式拆任务的开发者。
权限与安全：插件随当前 dsh 进程权限运行；安装前请自行审阅 GitHub 源码 与 MIT 许可证，勿在未检查的情况下在生产环境盲目启用。
生态说明：DSH 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；本文事实以仓库 README 与 package 元数据为准。
结尾¶
DevFlow 把 dsh 会话变成带 Commander、固定员工与临时子智能体的小交付组织，并用 .devflow 持久化状态机、用 devflow_* 工具与右侧面板提供可观测的调度面。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
