Gentle AI v4.1.0：按需原生审查与 SDD 清理扩展至已安装系统

版本变化（发布于 2026-10-12）

Gentle AI v4.1.0 是一个小版本更新，主要调整原生审查的触发与执行方式，并把此前从产品中移除的 SDD 清理扩展到用户已安装的系统。发布说明同时提醒：源码安装应使用 v4.1.1，它与 v4.1.0 代码相同但模块校验和一致；直接通过 GitHub 下载 @v4.1.0 会因校验和不匹配而失败。

原生审查

review assess 仅对高风险变更报告 review_due: true；中风险候选只报告 under_budget 和 review_due: false，因为变更行数属于审查提示的预算，而不是风险。代理可通过 START 与 STATUS preflight 的 --lenses 和 --lenses-reason 指定适合的 4R 审查视角，高风险候选也可以少于四个。所选视角及理由会随授权冻结，恢复的后续流程继承该选择；调用方通过新增的 start_lens_selection 能力判断是否支持。基础 diff 候选被确认后，审查会识别随后的被动增量并不再为其提供审查，但不会隐藏仍处于活动状态的审查。

其他调整

• ODD 编排改为按具名理由委派：理解超出内联证据预算、两个以上独立写入方各有编辑面、或高风险变更需要独立验证者；文件数量与任务规模本身不再决定路径。
• gentle-ai shell install 新增 TUI 和先检查后确认的命令行，为 Linux amd64、Windows 11 x64 和 macOS 提供 Gentle Shell 安装候选。说明明确这些是候选路径而非发布级路径，Windows 的真实安装与终端恢复尚未验证。
• 新增可选安装布局 --claude-orchestrator-modules（需 --scope global 与 claude-code 代理），并提供可选的隔离安装。

破坏性变化

OpenCode 外部社区插件安装被移除；提供方契约由 1.2.0 升至 1.3.0（新增视角选择与可选能力），携带视角选择的审查授权无法被旧版二进制读取，需用 v4.1.0 及以上继续。另有影响脚本的行为变化：中风险候选不再自动触发审查、安装会在自更新前拒绝未选中组件的修饰符、restore 对布尔标志和 -- 终止符的处理更严格。

升级后应运行 gentle-ai sync，以同步编排提示、审查资产与 SDD 清理。Windows 仍通过 Go 安装路径支持（需 Go 1.25.10 或更高），官方 Windows 二进制归档与 Scoop 发布仍不可用。