README.md

September 1, 2026 · View on GitHub

Dev Flow

Dev Flow

让长时 AI 编程任务从持久状态继续，并在执行中守住任务范围、验证预算和交付条件。

Codex npm DeepSeek npm CI Apache 2.0 License

简体中文 · English · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil)

Dev Flow 是长时 AI 编程任务的本地过程控制与恢复层。它不只在聊天记录之外保存进度，还让 Task 只有在范围、verification budget 和当前记录满足条件时继续流转；当会话中断、仓库漂移或 Action 结果不确定时，Codex 或 DeepSeek 可以读取同一 Task，获得合法下一步、Recovery 判断或明确阻塞。

你是不是遇到过这个问题

一个代码任务已经完成实现，正在跑最后一项定向测试。会话却被压缩，或者 Host 重启了。新会话只 看到部分聊天和当前仓库，不知道哪些步骤已经完成、测试是否仍然有效，于是重新扫描、重复修改， 或者直接跳过剩余工作。

Dev Flow 把这份进度保存为本地 Task。新会话先读取 Task，再从保存的阶段和下一步继续。

它管理的四件事

动作Dev Flow 保存和检查什么
记住最初请求、当前阶段、已有验证、阻塞原因和交付结果
限制Task Plan 文件范围、单次文件授权、自动验证命令数量、重复测试循环、是否允许完整测试和人工交接
判断当前实现变化后哪些旧测试和理解确认已经失效，仓库状态是否仍符合 Task
恢复Action 结果不确定时，应该继续、补记结果、阻塞还是安全重试

Codex 和 DeepSeek 仍然负责读代码、改文件和运行命令。对 Codex apply_patch 和 DeepSeek 的结构化 文件工具，Host 会在写入前把目标路径交给 Core；计划外路径先进入 BLOCKED，由用户选择单次允许、 更新 Task Plan 或拒绝。Core 还会在进入测试和 DONE 前核对本 Task 实际修改的路径。

30 秒理解

直接使用 Agent 时Dev Flow 增加的能力
会话中断后重新猜测进度恢复同一个本地 Task
局部任务逐渐扩大范围计划外结构化写入先询问，交付前再核对实际路径
定向测试不断扩大保存 verification budget
同一检查和失败不断重复第三次精确重复后暂停，并等待用户决定
操作响应丢失后直接重试先读取当前 Task 和 Recovery 状态
测试结果与后续代码变化混在一起保存当前阶段和相应证据

适合什么任务

Dev Flow 适合会跨会话、跨天或在 Host 重启后继续的真实仓库任务，尤其是需要明确范围、定向验证、 返工路径或交付前理解确认的修改。一个主仓库加少量显式附加仓库属于高级用法。

一次性问答、代码解释、状态查询，或无需保留进度的机械性小改动，直接使用 Codex 或 DeepSeek 通常更简单。Dev Flow 也不是通用任务编排器、远程执行平台或安全沙箱。

与其他工具的关系

工具负责什么
Codex / DeepSeek读取仓库、修改代码和运行命令
OpenSpec / Spec Kit帮助组织需求、设计和任务
Dev Flow保存当前 Task 的阶段、范围、验证预算、恢复状态和合法下一步

OpenSpec 和 Spec Kit 是可选的工作方法，不是 Dev Flow 的主定位。当前没有 OpenSpec / Spec Kit artifact importer；更薄的集成仍是未来方向。

一次中断后如何继续

重启前
Task: auth-rate-limit
State: TEST
Revision: 5
Completed: implementation
Remaining: targeted auth test

重启后
Task: auth-rate-limit
State: TEST
Revision: 5
Next: run the remaining targeted auth test

恢复时，Host 读取同一个 Task 的当前阶段、范围、剩余验证和恢复状态。它继续剩余验证，不需要从 聊天记录重新推断。完整故事见中断后继续的两分钟演示。

最短安装路径

当前稳定制品支持 macOS arm64。Host、Node.js 与稳定 package 的准确范围见 Support Matrix。

npm install -g @imotong/dev-flow@latest
dev-flow

安装完成后，在 Git 仓库中使用对应入口。

Codex 可以智能选择 Dev Flow；需要明确进入时使用：

$dev-flow-codex:dev-flow 修复登录失败次数限制，只运行定向测试。

DeepSeek Harness 每个需要调用 Dev Flow 的直接用户消息都使用：

/dev-flow 修复登录失败次数限制，只运行定向测试。

Host 原生命令只用于诊断和恢复。完整安装、状态、恢复与移除方式见 Codex 使用说明、DeepSeek 使用说明和 命令参考。

当前支持与边界

产品已验证环境
dev-flow-codexmacOS arm64、Node.js >=24、Codex >=0.147.0
dev-flow-deepseekmacOS arm64、Node.js >=24、DSH >=0.1.0-rc.6
@imotong/dev-flowmacOS arm64、Node.js >=20

Dev Flow 仍处于早期，外部采用有限。当前边界包括：

  • Core 只读观察 Git，不执行 commit、push、merge、rebase、tag 或 publish；
  • 文件修改和命令执行由用户授权的 Codex 或 DeepSeek 完成；
  • Host 只对已列出的结构化写入工具做写前检查；Core 不拦截全部文件读写，也不是 shell 或文件系统沙箱；
  • Bash、外部进程和专用工具的写入可能只能在 Core 的 Implementation/Delivery 最终检查时发现；
  • WebUI 是本机 loopback 的单用户查看与诊断入口，不是云端项目管理平台；
  • 稳定支持只以 Support Matrix 中的公开制品和真实 Host Journey 为准。

详细文档

想了解什么入口
产品定位、目标用户和非目标Product
中断后继续的真实用户故事Demo
稳定、源码、未验证和当前缺口Project Status
未来优先级Roadmap
Core、Adapter、Store、Recovery 与协议Architecture
完整 CLI、selector 和 MCP 工具Command Reference
本机 WebUIWebUI
支持平台与 HostSupport Matrix
文档和源码各自负责什么Manifest
安全边界Security · Threat Model
参与贡献Contributing

本地开发

仓库开发需要 Go >=1.26、Node.js >=24 和 pnpm >=11 <12：

pnpm install --frozen-lockfile
pnpm run validate

License

Apache License 2.0