cc-haha/release-notes/v0.5.13.md

v0.5.13

这一版两条主线：同步上游 NanmiCoder/cc-haha v0.4.2（39 commits 的稳定性 / queue / cache 强化），以及 Provider runtime 可靠性（三条 staleness 路径修干净）。同时合并 Solo Council 卡片显示时序修复和 v0.5.12 的两个零散补丁。

新功能

同步上游 v0.4.2（#57）

合并 NanmiCoder/cc-haha v0.4.2 主线，相比上一次同步多出 39 commits。重点能力：

• 流式 provider 稳定性（#766 一组 4 commits）。给整个流加上 cap duration，trickling 的 provider 不会无限挂着；trace 里中断的请求显式记录而非幽灵 pending；non-streaming fallback 在 chat status 显式告知；移除过激的"杀慢流"逻辑。
• Active-turn prompt 队列（#755 一组 4 commits）。streaming 中输入的消息进队列；重连后队列消息不再被 replay 重发；guided queued prompts 立即可见；i18n 补 pendingMessageGuide / Edit / Delete / EditInput 等键。
• Providers 列表拖拽排序（#753）。后端落 providerOrder 字段持久化 + reorderProviders API；前端拖拽用 SortableProviderCard + dnd-kit。
• OpenAI prompt cache 语义（#789）。proxy 链路把 OpenAI 的 cache 标记正确转换为 Anthropic 的 cache_control: { type: 'ephemeral' }，让 OpenAI-compatible provider 也能用上提示缓存优化。
• H5 access 稳定化（#767 / #764）。token、端口、后台会话三者状态收敛，关闭桌面后台会话不再丢 token / 端口冲突 / 状态 desync。
• Auto-dream（#800）。后台 memory consolidation 设置项（默认关）；启用后会在足够多 session 变化后定期合并 auto-memory。配套 confirm 弹窗明确告知"会跑后台 model 调用"。
• Activity 设置增加插件 / 技能用量洞察（plugin and skill usage insights）。
• Compact 后立即恢复 context meter（#743）+ session 增加 compactCount / streamingResponseChars 字段，UI 能展示 compact 次数与流式响应字节量。
• Token usage 显示统一（#757）。desktop 与 CLI 的 token 计数对齐。
• Exit plan approvals 预览（#793）+ Mermaid 标签在生成预览中正确渲染（#803）。
• 桌面零碎修复：Windows 设置面板 toggle 稳定性（#788 / #791）、文件路径展开（#776）、in-app browser 预览菜单（#761）、native window dragging 恢复（#770 / #796）、touch-H5 交互重构（#780）、修 Windows updater 与 installer flow（#801）、隐藏 Windows 子进程 console（#802）、extend local API timeout（#773）、include more sidebar sessions（#759）、route typed local html in browser panel、stabilize live trace updates、allow mapped-drive workspaces in bypass mode。

完整变更见 release-notes/v0.4.2.md。

改进

Provider runtime 可靠性：三条 staleness 路径（#56）

修了三条用户感受得到的"配置改了不生效 / 老 session 报错"路径：

• 改 baseUrl / apiKey / apiFormat 不重启。SavedProvider.revision 自增 + RuntimeOverride.providerRevision 快照比较：每次 updateProvider revision +1；下次 set_runtime_config 携带的 revision ≠ 运行中会话的快照 → short-circuit 失败 → 强制 CLI restart → 子进程拿到新的 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN env。
• 重命名 model 后 resume 旧会话报"model 不存在"。getRuntimeSettings 加 stale-modelId guard：如果 persisted runtimeOverride.modelId 不在 provider 四个槽里（main / haiku / sonnet / opus），自动 fallback 到 provider.models.main，跟既有的 stale-providerId guard 对称。
• short-circuit 比较抽成 pure helper。把四元组 + revision 的等值判定抽成 runtimeOverridesMatch 纯函数，加 10 个单测把行为锁死，未来再加字段忘记同步比较逻辑会立刻 fail。

修复

• Solo Council 面板时序 bug（#55）。agent 通过 tool_use 派遣后、backgroundAgentTasks store 尚未填充前，卡片错误显示"待命"并收起面板。新增第三层 fallback：扫描无对应 tool_result 的 pending Agent tool_use，合成 displayStatus: 'running' 行保持面板可见。优先级链：backgroundAgentTasks (live) > background_task messages > pending Agent tool_use > standby placeholder。
• WorkspaceService outside-workspace 测试隔离。CI 上 rejects until registered access root 测试因 module-level registeredRoots 在跨 test file 间残留而失败：在 describe block 加 beforeEach(clearFilesystemAccessRootsForTests) 防御。
• 桌面端默认暗色主题（#53）。新安装用户默认主题从 white 改为 dark，已有偏好的老用户不受影响。index.html prepaint data-theme 同步改为 dark，消除首帧白闪。
• 插件推荐目录扩展（#54）。image-gen / reverse-engineering 这两个 cc-haha-builtin 插件进入 PLUGIN_CATALOG 推荐网格；installCatalogPlugin 对无 marketplaceSource 的内置条目校验 seed 已注册而非静默失败。

验证

• 桌面端 tsc --noEmit clean（合并产物 + 测试修复后）。
• 桌面端测试 1789/1792 通过（3 个失败全部是 main pre-existing 的 electron/terminal Windows-only 问题，非本版回归）。
• 服务端 providers 测试 95/95；chatStore 131/131；settingsStore + WorkspacePanel 65/65。
• v0.4.2 合并 PR（#57）CI 9/9 全绿（change-policy / desktop / desktop-native / docs / server / adapter / coverage / pr-quality-gate / label-and-summarize）。

升级注意

• provider revision 字段。SavedProvider.revision 是 optional，旧 providers.json 无此字段视为 0，首次 updateProvider 时自动 +1 补上 — 零破坏。
• messageQueue 与 queuedUserMessages 双 queue 共存。HEAD 自有的 messageQueue + 上游的 queuedUserMessages 两个字段都保留 — 它们底层语义略有不同（前者是 streaming 中的 FIFO，后者是 active-turn prompt queue），未来某个版本会收敛但当前不冲突。
• Solo Council fallback。纯显示层修复，不影响 agent 调度逻辑。
• 暗色主题默认。仅影响全新安装；不喜欢可在设置中切回 white / light / system。