Gentle AI v4.0.0：SDD 退役、ODD 成为唯一开发流程，Go 模块路径迁至 /v4

发布概况

Gentle AI v4.0.0 于 2026-10-01 发布，目标提交为 ff77164，上一稳定版为 v3.7.0。发布流水线中 preflight、release、verify 三个作业均成功；在确切标签提交上，CI 与 Windows Full Suite（十个分片）均通过。Windows 流水线曾在同一提交上执行一次 gh run rerun --failed，以清除一个与本次改动范围无关的间歇性锁超时失败。provider contract 保持 1.2.0 不变。

主要变化

ODD 成为唯一开发流程。 SDD 与 OpenSpec 退役，独立的原生评审（RDD）与测试先行开发仍保留。用户已有的安装文件与持久化 SDD 键会被保留，旧版卸载只移除可证明属于自身的资产。测试先行指引默认安装，严格 TDD 不再是单独选项。除 Pi 外的运行时获得统一的编排器提示词；任务分派依据证据预算，而非文件数量。

Go 模块路径迁移。 模块路径改为 github.com/gentleman-programming/gentle-ai/v4，所有 go install 与导入都需使用 /v4。v3.7.0 的更新器硬编码了 v3 路径并安装最新标签，Go 会拒绝 v4 标签；该判断基于对 v3.7.0 源码的阅读，未实际运行验证。Homebrew 用户不受影响。

OpenCode V2。 V2 模型通过 OpenCode API 发现，替代被移除的 opencode models --verbose。未固定 SDK 时拒绝写入插件；全新 V2 配置可在单独同意后由工具置备 SDK 2.0.4，并在隔离的 npm 环境中进行。原生评审仅在检测到 V2 运行时且存在确切托管中继声明时才启用。文档列出的兼容限制包括：V2 评审仅在 macOS 的 OpenCode 2.0.19 上以脚本化环回 provider 验证过，未用真实评审模型、其他 V2 版本或其他操作系统验证。

Pi 改用内置 MCP。 Pi 0.99.0 及以后版本读取 <Pi agent dir>/mcp.json，因此不再置备 pi-mcp-adapter 并从既有安装中移除。同步会把服务器从 mcp-adapter.json 迁移到 mcp.json。工具本身不检查 Pi 版本，低于 0.99.0 的主机会失去 MCP 服务器，直到升级 Pi。

其他。 新增 sync --scope=workspace，只刷新工作区管理文件，默认仍为全局范围。Codex 预设与模型目录推荐 gpt-6.1-{astra,sol,luna}。

破坏性变更

• Go 模块路径变更为 /v4；Windows 和其他 go install 用户需手动安装 v4.0.0。
• 移除 /sdd-* 命令、相关子命令与 --sdd-mode 等参数。
• sync --strict-tdd 会被拒绝并提示重跑。
• RDD 指引仅发送到 Claude Code、Codex 与 OpenCode。
• OpenCode 版本无法检测时，sync 会跳过它并以非零状态退出。

修复

Windows Full Suite 恢复通过；其中一个真实产品缺陷是 review recover 输出的 --cwd 未加引号，路径含空格时会出错，现已加引号。OpenCode 与 Kilo 的托管 agent、设置与卸载逻辑得到修复。WriteFileAtomic 替换文件时不再把 0600 私有配置改成 0644。

升级与安装

Homebrew：brew upgrade gentle-ai 后运行 gentle-ai sync。其他安装方式：go install github.com/gentleman-programming/gentle-ai/v4/cmd/gentle-ai@v4.0.0，随后运行 gentle-ai sync。Windows 通过 Go 路径支持，需要 Go 1.25.10 或更新版本；官方 Windows 二进制归档与 Scoop 发布仍不可用。