v3.9.0 项目授信前置 + 统一记忆系统 + /model 推理等级同行调节

v3.9.0 发布记录

日期：2026-08-29
上一版本：v3.8.0（release 收尾 commit d0ba74de9，2026-08-27）
提交数：61 commits
范围：项目授信前置提示（进入目录即问、当次生效）；统一记忆系统六阶段合流（PR #6）+ 记忆件四补；计划链路三连修（事实锚点换根重试 / 探测预算硬化 / 移除低阶模型警告）；UX 审计 P0-P1 一批（OAuth 登录落地、首启向导逃生口、错误时刻可行动化、首启弹窗排队）；多代理协同显性化；一键安装脚本。

1. 安全：项目授信前置提示（ea2de2f53）

• 进入目录即在 bootstrap 之前主动询问「是否授信」（项目配置含安全敏感键或存在 .rivet/hooks.json 时才出现，零赌注零打扰）——取代此前只在 stderr 打一行、会话中段才发现 yolo/hooks「神秘失效」的被动通知
• [y] 授信当次会话生效（配置键随本次 loadConfig 合并，无需重启）；[n] 下次再问；[d] 本项目不再提示（持久化于 ~/.rivet/project-trust.json，/trust 授信即恢复）
• 附带：忽略通知只在实际剥到键时打印，且列出真实键名（不再用笼统清单）；/trust status 显示启动提示开关

2. 统一记忆系统（PR #6 六阶段 + 四补）

• 缓存安全的自适应项目记忆（阶段一）→ 重要操作后模型判断写入 LTM → 新会话默认携带记忆 → 会话结束巩固（摘要 + 可复用做法）→ 记忆安全（敏感 scrub + worker 隔离）→ 长期记忆退役/维护（invalidate-don't-delete）
• 记忆件四补（对齐 dsh）：/remember 用户命令、历史会话回填、deep_recall 深召回、STM pressure-turns

3. 计划链路三连修

• 事实锚点换根重试（0f8940214）：引用相对会话目录缺失时探测子目录/父目录/兄弟项目根，命中改报 root-mismatch 并给出实际位置（历史回放 31% 漂移报告属此类虚报）；占位示例锚点（foo.ts/a.py）处处缺失时视为举例散文；枚举粘连 token（README.md/README.zh.md/…）不再提取
• 换根探测 syscall 预算硬化（65ed67a25）：L0 父目录常数定向 → L1 首段精确过滤 → L2 预算内 stat，REROOT_PROBE_BUDGET=128 总预算 + MAX_ROOT_ENUM=512 枚举截断——最坏成本与目录规模/锚点数解耦，预算耗尽 fail-open 降级 missing-file；报告新增 rerootProbes 观测字段
• 移除计划链路的「低阶模型产出」警告（b733f0991）：submit tool result / 批准通知 / /plan-list / 桌面端徽标与 Build 前横幅全部移除；model/modelTier 留痕保持中性元数据
• worker salvage 打捞 findings 的 provenance 标记（salvaged: true）+ evidenceRefs 幻觉引用存在性校验 + digest 警告标签接线（82156c395、a25ccad9d）

4. 认证与供应商链路

• OAuth 登录落地（UX 审计 P0-1）：/login 命令从幽灵指引变为真实注册（默认 codex，浏览器授权 5 分钟窗），CLI 新增 rivet config login；ConnectCommit needsLogin 标记消除「直接开始对话」误导
• keyless 单源豁免：isKeylessProviderEntry 收口——ollama/自定义无 key 端点运行时此前实际不可用，resolveApiKey 不再抛错；桌面欢迎页模型列表同步放行 keyless 供应商
• 预设新增模型回流进存量 provider 快照（glm-5.3/5.3-flash 到达老用户）；预设回填尊重用户删减（removeModel 删除不再被迁移回流）；keyless 判定收紧到 loopback（云端无 key 不再误判）
• 自定义供应商链路三修：anthropic 协议可达 + 探测失败可跳过
• TUI /model 面板对标 Claude Code：模型与推理等级同行调节（</> 步进 + effort 随默认持久化）；子代理模型路由引导三件套（派发 nudge + 设置面板一键推荐 + 无效配置警告）；桌面模型设置优化轮（常显列表 + 预设来源标注 + 配置前预览）

5. UX 审计整改一批（P0–P2）

• P0-2 首启 required 向导三逃生口：无 API Key 不再卡死（Codex OAuth 指引区 / 自定义表单 key 可空 / 中立「稍后配置」钮）
• P1-6 桌面首启弹窗互斥排队：WebView2→存储→Git→connect 四弹窗收口 first-run-queue 状态机，同帧至多一个
• P1-9 TUI 首启向导不再每次新会话强制重弹（纯取消即落哨兵，RIVET_HOME 生效）
• P1-4 错误时刻可行动化：错误分类终态指引 + 上一条用户消息回填输入框；/mcp auth、/mcp logs 子命令修复（此前取错参数位恒不可达）
• P1-5 桌面裸失败文案可行动化：12 个 locale 命名空间补「下一步」，sidecar 三条横幅加「打开日志目录」
• P1-7 新增 docs/guides/troubleshooting.md：10 个高频现场按「现象→先看→怎么修」
• choice-panel 输入子模式（自定义回答/驳回反馈）补光标编辑与粘贴
• 计划审批卡视觉分层重排：容器边框 + 决策区分隔 + 主操作高亮

6. 多代理协同显性化

• L1 曝光：欢迎页第三条协同入口（/team /scout /council）；/help 按意图分组、多代理协同置首组带选型口诀；/council 升 core tier
• L2 情境提示：orchestration-hint 新模块——并列连接词/多阶段动词/@file≥2/长文本枚举四信号 ≥2 命中才提示，每会话至多 2 次，Tab 采纳 / Esc 关闭（RIVET_ORCHESTRATION_HINT=0 可关）
• 协同建议分流：评审类→council、排查类→scout、施工类→team；council 成本如实标注（多席模型 token 开销大）并从首屏三入口撤下
• 修正：派发期间 GlanceBar 不再把星域切到天机（天机是编排阶段内部路由标记）

7. 桌面端（随 v3.9.0 桌面版发布）

• 模型设置优化轮：模型列表常显 + 预设来源标注 + 配置前模型预览（defc472c0）
• 会话字号独立于界面字号——阅读面/导航面分离设置（21abc8b0e）
• 首启弹窗互斥排队（UX 审计 P1-6）：WebView2→存储→Git→connect 四弹窗收口 first-run-queue 状态机，同帧至多一个（b5daccbf0）
• required 首启向导三逃生口（UX 审计 P0-2）：无 API Key 不再卡死——Codex OAuth 指引区 / 自定义表单 key 可空 / 中立「稍后配置」钮（cd5010234）
• OAuth 登录落地桌面侧：connect-flow 的 /login 幽灵指引闭环（UX 审计 P0-1，d2b644d0e）
• 裸失败文案可行动化（UX 审计 P1-5）：12 个 locale 命名空间补「下一步」+ sidecar 三条横幅加「打开日志目录」（d1b8a303f）
• WebView2 过旧从「建议升级」升级为「强制」——安装器最低版本 + 阻断式引导（870adeda5）
• 欢迎页模型列表放行 keyless 供应商（1ea973fb3）
• 子代理模型路由设置补 planning 任务键（对齐 TUI，01313be6c）

8. 安装与发行

• CLI 一键安装脚本 install-tui.sh / install-tui.ps1（macOS/Linux + Windows）
• README 品牌定名 Tianshu Harness（TUI/GUI 双形态共享内核）+ 双形态实拍截图；Node 版本口径钉定 ≥24（engine-strict 硬闸）
• sync-to-public 加 docs 白名单例外通道（用户面向文档可同步，设计草稿仍冻结）

注意事项（升级前必读）

• CLI 升级：npm i -g tianshu-tui@latest（包名 tianshu-tui，命令仍是 rivet），或一键脚本。
• 项目授信：升级后进入含 .rivet-config.json 安全键或 .rivet/hooks.json 的项目会遇到一次授信询问——按 y 一次永久生效；这是 v3.8.0 信任门的配套 UX，fail-closed 语义不变。
• 记忆系统：统一记忆默认生效（新会话携带记忆）；敏感信息 scrub 后可写入，worker 记忆隔离。
• 桌面端：R 桌面批次（模型设置优化轮/会话字号独立/首启弹窗排队/向导逃生口/失败文案可行动化/WebView2 强制升级）随本版发布，macOS 双架构安装包随版上架；Windows x64 安装包已随版上架（NSIS/MSI + 更新签名），Windows 用户会收到本版更新推送。
• macOS 未公证：首次打开如提示「已损坏」请执行 xattr -cr /Applications/Tianshu.app。