开发回路（只读使用本地 harness checkout）

迭代期依赖用 link: 指向本地 deepseek-harness checkout（其 npm 版本目前落后于 checkout），路径硬编码在 packages/devflow/package.json，可按需调整。harness checkout 保持零改动：插件以 link 安装进 ~/.dsh/profiles/web，组合行 dsh-devflow 经 profile 的 node_modules 解析到本仓库；web 服务器的 /plugins 路由直接从本仓库 lib/client.js 读文件（no-cache）。

pnpm install && pnpm build && pnpm test   # 本仓库独立可构建
pnpm sync:profile                         # link 进 profile（首次/组合变化后需重启 dsh web）

日常迭代：改代码 → pnpm build → 浏览器刷新即可（无需重启，无需碰 harness）。

Typert wire 工件为什么是 vendored：生成器的 workspace 发现依赖 harness monorepo 布局（聚合 tsconfig 引用 + /packages/ 目录包含检查），无法在单包仓库内驱动。 @Remote 方法面变化时：临时把 packages/devflow 拷进某个 harness checkout 的 packages/ 下重建，scripts/vendor-typert.sh 会把重新生成的 lib/typert.* 改名（@deepseek-ai/dsh-devflow → dsh-devflow）后提交回本仓库；等 npm 版本追平 checkout 后可改为直接依赖 npm 包。

快速上手（安装与首次使用）

发布状态：dsh-devflow 尚未发布到 npm（发布前置条件见「发布路径」节）。在发布之前，外部用户请走下方「方式 B：从源码安装」。

前置条件

已安装 DeepSeek Harness CLI（npm i -g @deepseek-ai/dsh，rc 系列即可）并能运行 dsh web；插件使用的 sidebar.footer.action 插槽需要较新的 rc 版本
profile 使用的插件安装器是 pnpm（随 dsh 初始化）

方式 A：npm 安装（发布后可用，推荐）

一条命令完成依赖安装与组合接线（dsh.bundle manifest + 包内 cordis.patch.yml 自动生效，@deepseek-ai/* peer 依赖由 pnpm 自动解析，无需手动处理）：

dsh plugin --profile web add dsh-devflow

方式 B：从源码安装（当前可用；需要本地 deepseek-harness checkout）

运行时依赖与构建期类型当前以 link: 指向本地 harness checkout（见「开发回路」节），因此克隆本仓库后需把 packages/devflow/package.json 中的 link 路径改为你的 checkout 路径，再构建并 link 进 profile：

git clone https://github.com/H97y/dsh-devflow.git
cd dsh-devflow

### 配置工作区

`root` 默认取进程工作目录；如需指向特定工作区，在你的 profile patch 层
（`~/.dsh/profiles/web/cordis.patch.yml`）覆盖：

```yaml
- id: devflow
  config:
    root: /path/to/your/workspace   # .devflow/ 状态与小需求工作区所在
    # maxActive: 3                  # 并发流水线上限（默认 3）
    # maxWorktrees: 2               # worktree 并发上限（默认 2）
    # logCap: 40                    # 每条需求日志上限（默认 40）
    # tickIntervalMs: 2000          # 状态机节拍（默认 2000）

验证与首次使用

（首次安装或组合变化后）重启 dsh web，浏览器打开 Web 界面
验证挂载：侧边栏底部、「设置」按钮上方出现「开发流水线」入口（侧边栏折叠时是 56px 轨道圆钮）——没有即未挂载，见下方排查
点击入口打开主区域工作台；在「需求池入口」粘贴一句粗浅需求（如「给列表加个搜索框」）→「投入需求池」
后台自动开始：批量精炼（含规模评估）→ 择优 → 设计 → 计划 → 评审修订 → 实施（devflow 模型工具由会话泵调用）→ 代码评审 → Web 验证 → 合并回 main → 报告；需要你拍板的会停在「等待队列」，页面上作答后自动续跑
全部状态在 /.devflow/，进程重启不丢

安装

说明文档