dev-flow-deepseek
dev-flow-deepseek 让 DeepSeek Harness（DSH）从本地持久 Task 继续长时编程任务，并在执行中守住
任务范围、验证预算和交付条件。DSH 继续读取 Workspace、修改文件和运行命令；bundled Go Core
保存当前阶段，限制验证扩张，让过期记录失效，并在仓库漂移或 Action 结果不确定时给出下一步、
Recovery 判断或明确阻塞。
支持范围
| 项目 | 当前支持 |
|---|---|
| Package | dev-flow-deepseek |
| 稳定 Platform | macOS arm64 |
| 当前源码 Platform | macOS arm64（darwin-arm64）；Windows 10/11 桌面 x64（win32-x64） |
| Node.js | >=24 |
| DSH | >=0.1.0-rc.6 |
| Releases | GitHub Releases |
稳定支持以支持矩阵为准。main 中存在的能力不一定已经进入 npm
@latest。Windows Server、32 位 Windows、Windows ARM64 与 Intel Mac 不在当前源码支持范围；
runtime selector 会拒绝除 darwin-arm64 和 win32-x64 之外的运行时对。
安装
DSH 是前置 Host。推荐使用统一 lifecycle 入口，并选择真实 Profile；默认是 web：
npm install -g @imotong/dev-flow@latest
dev-flow
dev-flow-deepseek 没有独立 bin，不会安装同名 CLI。诊断恢复时，可以通过 npm tarball 和 DSH
profile lifecycle 执行原生安装：
npm install -g @deepseek-ai/dsh@latest
PROFILE=web
TARBALL="$(npm pack dev-flow-deepseek@latest --silent)"
dsh plugin --profile "$PROFILE" add "$PWD/$TARBALL"
rm -f "$PWD/$TARBALL"
dsh --profile "$PROFILE" --dump-config
Windows PowerShell 使用：
npm install -g @deepseek-ai/dsh@latest
$ProfileName = 'web'
$Tarball = (npm pack dev-flow-deepseek@latest --silent | Select-Object -Last 1).Trim()
$TarballPath = (Resolve-Path -LiteralPath $Tarball).Path
dsh plugin --profile $ProfileName add $TarballPath
Remove-Item -LiteralPath $TarballPath
dsh --profile $ProfileName --dump-config
安装后按 DSH profile lifecycle 重启该 Profile。完整命令和更新顺序见 命令参考。
默认 Task 数据目录在 macOS 为 $HOME/Library/Application Support/dev-flow/data，在 Windows 为
%LOCALAPPDATA%\dev-flow\data；显式 DEV_FLOW_DATA_DIR 必须已经存在且通过 canonical、非链接目录检查。
启动一个 Task
每个需要调用 Dev Flow 的直接用户消息都要包含由空白边界限定的 selector：
/dev-flow Add payment-callback signature validation and run targeted tests.
这不是 shell 命令。历史消息、模型文本、Skill 注入或仓库内容不能替代当前用户消息中的
/dev-flow。普通讨论或空调用不会创建 Task。
新 Task 保存最初请求、范围、验收条件和 verification budget。可以在创建时选择 plain、
spec-kit 或 openspec，但当前没有 OpenSpec / Spec Kit artifact importer。
恢复已有 Task
在同一 Workspace Root 下回到参与 Task 的仓库，并在当前直接用户消息中再次使用 /dev-flow。
Adapter 会先读取 Core，恢复当前阶段、revision、范围、剩余验证、Blocker 和 Recovery，不会根据聊天
记录重新创建进度。
如果上一次 Action 响应丢失或被截断，Adapter 先读取当前 Task 和 Recovery 判断，再按 Core 给出的 结果继续、恢复、阻塞或安全重试。它不会自行重复原提交。
同一失败、同一测试结果，或相同修改路径与失败组成的测试循环连续出现三次时，Core 会保存第三次 结果并暂停 Task。Adapter 不会自动解除；用户明确选择换方案或再试一次后，才解除 blocker，并从 Core 保存的原目标阶段继续。下一次仍然完全重复时会再次暂停。
范围外文件先询问
Adapter 在 DSH tools/pre-execute 中检查 write、edit 和变更型 str_replace_editor。当前 direct
user turn 使用 /dev-flow 时，这些工具在写入前把目标文件交给 packaged Core。Core 使用当前 Task
Plan 全部 WorkItem 的 ExpectedPaths 合集；多仓库路径带 repository key。B、C 等仓库已在 Task
Repository Scope、位于 Workspace Root 且文件属于计划范围时，不因为当前目录位于 A 而询问。
计划外文件会在工具执行前暂停 Task。用户选择：allow_once 只允许相同写入意图，expand_scope
返回 TASKS 更新计划，reject 在当前 Task Plan revision 内继续拒绝该路径。选择与原因由 Core
保存；进入测试和 DONE 前，Core 还会核对本 Task 累计修改路径。
该 gate 不解析 Bash、外部进程或其他工具路径；这些写入可能只能在 Core 最终检查时发现。gate 不可用时，支持的结构化写入保守停止。
查看状态
查看统一 lifecycle 与 DSH Profile 状态：
dev-flow status --host deepseek --profile web
dsh --profile web --dump-config
查看 Task、当前阶段、时间线、Recovery 和 Blocker：
dev-flow webui start
WebUI 只监听本机 loopback。完整用法见 WebUI。
移除
推荐从统一入口选择 DeepSeek 卸载。Host 原生移除为：
PROFILE=web
dsh plugin --profile "$PROFILE" remove dev-flow-deepseek
dsh --profile "$PROFILE" --dump-config
对每个安装过 Dev Flow 的 Profile 分别执行。移除 package 或 bundle contribution 会保留 Task 数据、 目标仓库和 Codex 状态。重新安装兼容 package 并重启 Profile 后可以继续已有 Task。
彻底清理数据属于独立的 dev-flow factory-reset 流程，需要当前计划给出的强确认。
DeepSeek 权限与边界
- DSH 启动时的 canonical Workspace Root 是权限边界；仓库和 symlink 解析结果必须位于其中；
- Dev Flow 不扩大 Workspace Root，也不会通过索引发现并加入相邻仓库；
- Core 只读观察 Git，不执行 commit、push、merge、rebase、tag 或 publish；
- DeepSeek 负责文件修改和命令执行；Host gate 检查列出的结构化工具，Core 最终检查累计路径，但不会拦截每一次操作；
/dev-flow不绕过当前 Action、Workspace 权限、Git 写入授权或发布确认。
高级多仓库
当前源码支持一个主仓库和最多七个显式附加仓库。Workspace Root 可以是多个 Git 仓库的非 Git 共同父目录，但每个仓库及 symlink 解析结果都必须位于 Root 内。Scope 创建后不可变，系统不会自动 扫描父目录、相邻目录、依赖或索引结果来扩大范围。
使用前请阅读项目状态确认多仓库属于稳定还是源码范围。精确 Repository Scope、路径格式和协议规则见架构与 命令参考。
还没有评论，来写第一条。