Wave Flow v0.2.7

本次版本修复一个"看门狗静默失效"的运行时缺陷：ACP Worker 长时间无响应时，界面既不会自动中断，也没有出现本该有的停滞提示。

问题

真实运行里一个深度调研节点在 Codex code-mode 脚本转入后台 cell 后，模型请求长时间没有返回。按设计系统不会自动中断静默回合，但应在 5 分钟无实质进展时落一条耐久提示——实际没有。检索全部历史 Run 的 Journal，这条提示从未出现过。

根因在采样链路本身：

• 每次采样先读取 Run 互斥区中的节点事实；一旦该锁被占住，采样链永久挂起，后续检查全部跳过，异常又被吞掉。
• "没有进行中的回合"分支会每秒刷新计时：回合已结束、下一回合迟迟未发起时，计时永远归零。

修复

• 停滞采样只用同步状态判断（暂停、阻塞与控制等待仍豁免），不再依赖 Run 互斥区。
• 回合间隙也计入静默窗口。
• 语义不变：只写一条耐久提示，不 cancel、不中断，唯一出口仍是用户显式停止。

验证

• 新增两条回归测试："互斥区被占死仍能落提示"、"end_turn 后上下文读取被占死仍会提示"；两者在撤销修复时失败、恢复后通过。
• 全量测试 914 pass / 11 skip / 0 fail。

macOS 安装包

• 统一为 v0.2.7，支持 macOS 12+ / Apple Silicon。
• 保留 Applications 拖放安装入口；挂载复核 App/Engine 签名。

推荐终端安装：

curl -fsSL https://oliver-ysq.github.io/wave-flow/install.sh | sh

浏览器下载如遇“已损坏”提示：

xattr -dr com.apple.quarantine "/Applications/Wave Flow.app"

当前为 ad-hoc 签名、未公证。

dmg SHA-256：

1b973f33b817899356681fedd906bd4eebaee471b53ad7acb96abb75b80ff008

Wave Flow v0.2.6

本次版本修正两条内置深度预置在工作范围与报告口径上的边界问题。

深度代码审查（deep-cr v3）

• 摸底返回的文件先按审查范围（target）求交，范围外的文件不再进入审查清单与变更面；交集为空时明确拒绝开工，不把越界清单交给审查员。
• 报告撰写人会拿到"完成审查的维度总数"，stats.dimensions 不再被误填成"未完成复核维度数"。

深度调研（deep-research v2）

• 调研失败或核验失败的研究问题，会以 unresearchedQuestions / unverifiedQuestions 交给撰写人和红队，报告必须在"未解决问题"逐条列出，不再静默消失。
• 标准模式（standard）也会把交叉检查发现的缺口列入未解决问题，只是不做第二轮补证。
• 阶段名"补证"改为"交叉检查与补证"，与实际动作一致。

说明

• 预置版本随源码变化：deep-cr v2 → v3，deep-research v1 → v2；历史执行仍按各自冻结版本只读可查。
• deep-cr v3 已用发布包引擎完成真实 16 节点执行：16/16 完成、确认 10 条、剔除 2 条、维度 6、合并建议 changes_required。
• deep-research v2 的标准模式真实执行在 4 个研究问题时约 19 分钟完成（22 条结论通过核验、9 条剔除、20 条引用）；5 个研究问题时单节点可能超过一小时，系统按设计不会自动中断，需要你显式停止。

macOS 安装包

• 统一为 v0.2.6，支持 macOS 12+ / Apple Silicon。
• 保留 Applications 拖放安装入口；挂载复核 App/Engine 签名。

推荐终端安装：

curl -fsSL https://oliver-ysq.github.io/wave-flow/install.sh | sh

浏览器下载如遇“已损坏”提示：

xattr -dr com.apple.quarantine "/Applications/Wave Flow.app"

当前为 ad-hoc 签名、未公证。

dmg SHA-256：

07eb933ee147b80fdcf9484fd0bd713bf757a8178b549d56f69c6e186372170e

Wave Flow v0.2.5

本次是修复首发体验的小版本，核心能力与 v0.2.4 相同。

修复：首次启动的误报

进入应用时，"本地执行工具"面板会在 CLI 发现完成前显示"还没有可用的本地执行工具 / Wave Flow 需要本机已登录的 Codex、Claude Code 或 DeepSeek Harness 之一"，读起来像一条错误；实际上工具几秒后就会出现（本机实测首次扫描 3–4 秒，环境较慢时可达十几秒）。

现在扫描期间只显示"正在检查本机执行工具 / 首次启动会逐个验证已安装的 CLI"；只有在扫描确实结束且一个工具都没找到时，才显示"没有可用工具"和安装引导。

工程

• 修复整仓并发跑测试时偶发的档案兼容用例失败（等待回合回到 idle，而不是只等消息条数）。
• 其余内容与 v0.2.4 相同：私有控制通道使用 Unix socket（修复长任务在第 14 个 Worker 永久停住）、超过 8KiB 的控制响应不再被截断、深度 CR 全量审查会报告历史遗留问题、宿主不保存成果快照。

macOS 安装包

• 统一为 v0.2.5，支持 macOS 12+ / Apple Silicon。
• 保留 Applications 拖放安装入口；挂载复核 App/Engine 签名。

推荐终端安装：

curl -fsSL https://oliver-ysq.github.io/wave-flow/install.sh | sh

浏览器下载如遇“已损坏”提示：

xattr -dr com.apple.quarantine "/Applications/Wave Flow.app"

当前为 ad-hoc 签名、未公证。

dmg SHA-256：

05e28c712eaf64f43c3a062db77f1ec00b57d92e1e7ce161cf9f4c6096b2cf82

Wave Flow v0.2.4

本次版本修复了长任务在真实执行中可能永久停住的问题，并同步了成果交付口径。

稳定性修复

• 私有控制通道由 FIFO 改为 Unix domain socket。 原先每条会话的阻塞读会长期占用一个 Bun 线程池线程，会话结束也无法释放；累积到线程池大小后，Journal、生命周期日志与节点结果的异步写入全部排队永不完成。表现为 16 节点深度代码审查卡在第 14 个 Worker，既没有超时日志也没有节点失败。改用事件循环驱动的 socket 后，同一靶场 16/16 节点完成。
• 修复单次 write 只能写入 8192 字节导致的截断。 超过 8KiB 的控制响应（例如读取执行胶囊）此前只收到前半段并永久悬挂；现在未写完的部分在 drain 中续写，并发响应按序拼接、不再互相覆盖。
• 收紧收尾时序。 完成确认先落盘再拆通道；MCP sidecar 关闭时先让在途工具调用拿到明确错误再退出，避免调用方等到客户端超时。

内置预置

• 深度代码审查（deep-cr v2）：无基线时按全量审查处理，明确要求报告审查面内的历史遗留问题；有基线时仍是增量审查并剔除历史问题。此前的统一口径会让全量审查得出 0 个问题。复核员的剔除规则只在增量模式启用。

成果交付口径

• 宿主不再保存任何成果快照：不收集 Git tree、不写证据 ref、不创建 commit，结果只保留在受管 worktree 的未提交文件里。
• 执行页移除变更面板、diff 审阅与「采用这些改动」入口，只展示受管 worktree 路径与租约现场；清理 worktree 会一并删除未提交内容，需要显式授权。

macOS 安装包

• 统一为 v0.2.4，支持 macOS 12+ / Apple Silicon。
• 保留 Applications 拖放安装入口；挂载复核 App/Engine 签名。

推荐终端安装：

curl -fsSL https://oliver-ysq.github.io/wave-flow/install.sh | sh

浏览器下载如遇“已损坏”提示：

xattr -dr com.apple.quarantine "/Applications/Wave Flow.app"

当前为 ad-hoc 签名、未公证。

dmg SHA-256：

4c2898fe16757c9520c617738f2f2fdae70ff15984814d99c390970b27931b80

Wave Flow v0.2.3

本次版本新增两条内置深度预置工作流，并更新官网与中英文使用文档。

内置预置工作流

• 新增「深度调研」：计划 Agent 先把主题拆成可并行核验的研究问题并等你确认，随后并行多源调研；每条结论必须带原文摘录与真实来源地址，并由独立核验员重新打开来源逐条复核；再交叉检查互相矛盾与单一来源承重的问题，deep 模式按证据缺口做第二轮定向补证，最后经红队反向审查与修订，产出带引用与置信度分级的报告。
• 新增「深度代码审查」：先摸底变更面、模块结构与仓库内的审查规范，再由正确性、安全、并发与状态、错误处理与资源、接口与数据兼容、意图与测试六个专项审查员并行审查；每个发现都带文件、行区间、触发场景与置信度，并由独立复核员重新打开源码逐条核实、剔除误报，之后跨维度去重排序、给出合并建议并扫描未被覆盖的高风险文件。
• 两条预置全程只读，不修改文件，也不运行构建或测试；单次执行的 Agent 节点数受运行时护栏限制。
• 复核、裁决或红队节点未交付时，报告会如实说明缺少该环节，不会把「没查过」写成「没问题」。

工程与文档

• 内置预置的编排脚本改为独立 TypeScript 文件维护，按文本内嵌进 Engine 单二进制，并由独立类型检查工程覆盖。
• 修复新建预置任务时初始说明写死为「只读代码审查」的问题。
• 官网新增「内置预置工作流」一节，更新首页、下载页与中英文 README。

macOS 安装包

• 统一为 v0.2.3，支持 macOS 12+ / Apple Silicon。
• 保留 Applications 拖放安装入口；挂载复核 App/Engine 签名。

推荐终端安装：

curl -fsSL https://oliver-ysq.github.io/wave-flow/install.sh | sh

浏览器下载如遇“已损坏”提示：

xattr -dr com.apple.quarantine "/Applications/Wave Flow.app"

当前为 ad-hoc 签名、未公证。

dmg SHA-256：

ecbae882d36bde16221d3fa02c87ace1396fbd1d194699e44bc6661d68a2403c

Wave Flow v0.2.2

本次版本强化长任务恢复、Git 工作区证据和 macOS 发布链路，并更新官网与中英文使用文档。

执行与工作区可靠性

• 强化中断恢复、writer 进程交接与共享 worktree 的安全边界。
• 成果保存为不可变 Git tree 证据，不自动创建 commit、合并或 push。
• 大型变更路径采用流式收集，变更列表支持分页，避免截断证据或阻塞详情轮询。
• 增加无响应 I/O、进程启动崩溃窗口与网络外部副作用的故障注入验证。

桌面体验

• 修复多项前端交互、附件读取与执行详情边界。
• 图片附件单张限制 10MB，并复核文件身份和实际大小。
• 更新官网、下载说明及中英文 README。

macOS 安装包

• 统一为 v0.2.2，支持 macOS 12+ / Apple Silicon。
• 修复自定义签名后 dmg 未重打包的问题；挂载复核 App/Engine 签名。
• 保留 Applications 拖放安装入口。

推荐终端安装：

curl -fsSL https://oliver-ysq.github.io/wave-flow/install.sh | sh

浏览器下载如遇“已损坏”提示：

xattr -dr com.apple.quarantine "/Applications/Wave Flow.app"

当前为 ad-hoc 签名、未公证。

dmg SHA-256：

024d40078ad41c34ae2e2bc1883c57e0a6b140e7b986d0699d246944909c0a51

Wave Flow v0.2.0

Wave Flow v0.2.0

本次版本把「技能」和「执行可靠性」串成了一条完整链路：技能库可以在设置页管理并注入主控与每个 Worker；Worker 启动失败有了更清晰的诊断和安全的自动重试；执行中断、停止和成果封存也有更明确的恢复入口。

新增

• 托管技能库：统一维护 ~/.wave-flow/skills，从本机 CLI 技能目录或本地 skill.zip 导入；每个主控/Worker 会话以私有软链投影注入，不改写原生 CLI 目录。
• 技能设置页：查看技能来源、注入能力、requires.bins PATH 诊断和 invalid 技能原因；支持重新读取、重新扫描和冲突提示。
• 技能菜单：导入 skill 合并进主控斜线菜单，Codex 使用 $name，Claude/DSH 使用 /name。
• 启动恢复：agent.session 建立前的启动超时可换新会话自动重试一次；已投递后的失败不再自动重放，改为执行页显式“重新尝试”。
• 成果收尾重试：业务已完成但最终封存失败时，可直接重试成果收尾，不重跑业务 Workflow。

改进

• 执行进度只显示当前运行动作；暂停、完成或取消后不再出现过期的“准备启动”。
• 停止操作统一二次确认，支持 Escape 取消并恢复焦点。
• 执行页直接展示受管工作区绝对路径，支持复制和只读查看完整变更。
• 中断恢复文案明确说明会复用可验证的已完成前缀，其后的节点重新执行。
• 技能库投影摘要参与 Replay 判定：库内容变化后，旧 completed 节点不再自动复用。
• 本地服务断连、空项目折叠、暂停提示、执行耗尽等待等交互补充了明确说明。

修复

• 修复 Worker 启动超时后可能残留写入租约、导致重复 writer 的问题。
• 修复恢复 Execution 时先改动现场、后拒绝恢复的问题。
• 修复空闲主控会话在 pending 状态下 1ms 空转的问题。
• 修复 ZIP 技能导入在复制完成前清理临时目录的问题。
• 修复旧 Journal 中 agent.hint 事件无法读取的兼容性问题；新写入仍使用节点级 log.written。
• 修复 Kimi 历史任务可继续启动新 ACP 会话的问题；Kimi 产品入口继续保持下线。

安装

推荐终端安装（不会触发 Gatekeeper 隔离标记）：

curl -fsSL https://oliver-ysq.github.io/wave-flow/install.sh | sh

手动安装：下载下方 dmg，拖入「应用程序」。当前为 ad-hoc 签名、未公证；浏览器下载的文件如遇「已损坏」提示，执行一次：

xattr -dr com.apple.quarantine "/Applications/Wave Flow.app"

macOS 12+ / Apple Silicon。至少需要一个已登录的本机 CLI：Codex / DeepSeek Harness / Claude Code。

本项目仅供学习与研究，不涉及任何商业化。

Wave Flow v0.1.0

首个公开发布。AI 长任务，按流程执行，凭证据交付。

本项目仅供学习与研究，不涉及任何商业化。

核心卖点

• 低幻觉交付：节点结果须通过结构校验并写入执行记录，一句自信的总结不算数
• 可恢复的长任务：关窗不停止，重启后显式恢复；只复用严格匹配的已完成部分
• 脚本化执行：阶段、并行与完成条件写在 TypeScript 里，不靠模型记住计划
• 人工介入：子代理需要输入时显式停下来等你，答案交回原 Agent 继续判断

安装（推荐：终端一键）

curl -fsSL https://oliver-ysq.github.io/wave-flow/install.sh | sh

命令行下载不触发 Gatekeeper 隔离标记，装完即可打开（macOS 12+ / Apple Silicon）。

备选：手动安装 dmg

1. 下载 dmg，拖入「应用程序」（Intel 构建后续提供）
2. 当前为 ad-hoc 签名、未公证。浏览器下载的文件会被系统隔离，如遇「已损坏」提示，在终端执行一次：

   xattr -dr com.apple.quarantine "/Applications/Wave Flow.app"

前置要求

需要至少一个已登录的本机 CLI：Codex / DeepSeek Harness / Claude Code。

已知边界

本机单用户，不支持云同步与远程控制；模型请求由所选 CLI 发往其服务商；写入类任务不自动 commit 或 push。