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

Claude Code Haha v0.4.2

这是 v0.4.1 之后的稳定性和桌面体验补丁版本，重点修复真实使用中暴露出来的桌面端卡住、H5 远程访问、Windows 安装和窗口行为、Trace 可观测性、provider/runtime 兼容性，以及内置浏览器和生成物预览链路问题。

相比 v0.4.1，本版本新增服务商列表拖拽排序、Auto-dream 设置入口、Activity 插件/Skill 使用统计；同时让慢速第三方 provider、GPT5.5 中转缓存、手机 H5、active turn 排队输入和 Trace 诊断更稳定。

Highlights

• 慢 provider 和桌面长任务更稳定：桌面端不再用过短的超时杀掉健康但首字节很慢的流式请求，非流式 fallback 状态会显示在聊天状态栏，被中止的 API call 也会进入 Trace 而不是一直 pending，重点跟进 #766 和 #773。
• 回答进行中可以排队输入：active turn 运行时支持继续提交、引导、编辑和删除排队消息；CLI 接收后自动回放进 transcript，并避免 guided prompt 或 replay 造成重复用户气泡，修复 #755。
• H5 远程访问稳定性升级：H5 token 和端口可跨重启保持，断连宽限时间可配置，手机锁屏或切后台时不再强杀正在运行的 CLI；触屏 H5 修复输入框缩放、键盘遮挡、长按选择、操作按钮不可见和安全区适配问题，跟进 #764、#767 和 #780。
• Trace 和 Activity 可观测性增强：Trace 现在展示工具调用耗时、session wall/model/tool timing、aborted API calls 和更稳定的 live 更新；Activity 页面新增插件和 Skill 使用排行，并压缩 token summary 展示，覆盖 #799 和 #766 的诊断诉求。
• Windows 桌面体验集中修复：修复 Windows updater/installer 重复安装提示和安装目录选择问题，退出时隐藏 CMD 窗口闪烁，恢复原生窗口拖拽并阻止拖动窗口逐渐变大，同时修复 Settings General 的 toggle 布局和系统通知白屏问题，覆盖 #801、#802、#770、#796、#788 和 #791。
• Provider/runtime 配置更顺手：服务商列表支持拖拽排序并持久化官方/自定义 provider 顺序，新增 Auto-dream 设置入口，OpenAI-compatible proxy 对 prompt cache key、stream usage 和 cached tokens 的处理更符合 GPT5.5/中转 provider 场景，覆盖 #753、#800 和 #789。

Fixes

• 修复 mapped Windows drive 工作区在 bypass mode 下解析成 UNC 后仍被误拦的问题；已证明位于工作区内的映射盘路径可以继续写入，同时敏感路径和工作区外 UNC 写入仍走权限安全检查。
• 修复手动 /compact 或自动压缩后上下文百分比仍停在压缩前数值、甚至显示 Request timed out after 30s 的问题 (#743)。
• 统一桌面端和 CLI 的 token 用量展示，修复首条消息没有流式 token 指示、进行中 token 计数不更新，以及不同页面格式不一致的问题 (#757)。
• 扩大桌面 sidebar 会话列表的拉取窗口，降低 observer/noisy session 把真实会话挤出列表的概率 (#759)。
• 修复内置浏览器预览菜单、文件打开方式、手输本地 HTML 路径和 loopback web dev 访问策略相关问题；127.0.0.1、localhost、::1 可在本机开发场景下绕过 H5 token，LAN/public 访问仍受 H5 规则保护 (#761)。
• 修复 MCP 配置页标题带有“更新”含义、容易误导用户以为正在执行更新的问题 (#763)。
• 修复 H5 token/端口不固定、二维码和手机书签重启后失效、客户端断开 30 秒后强杀后台 CLI 的问题 (#764, #767)。
• 修复慢速第三方 provider 在桌面端被客户端 timeout、stream watchdog 或 fallback 链路提前杀掉后 UI 一直显示 running 的问题；同时补齐 fallback 状态和 abort trace 记录 (#766)。
• 修复 Windows/macOS 生成物点击“在 Explorer/Finder 中显示”时 ~ 路径没有展开的问题 (#776)。
• 修复生成文件 chip 和预览锚点从模型文本猜路径导致指向不存在文件的问题；现在会基于本轮真实 changed files 对齐，单文件 index.html、工作区外生成物和图片 replay 去重都更可靠。
• 修复 ExitPlanMode/计划模式审批在桌面端只显示原始权限请求的问题；现在展示渲染后的 plan preview，并把反馈和权限响应正确转发回 CLI (#793)。
• 修复 OpenAI-compatible provider 经 Responses API 走 GPT5.5/三方中转时 prompt cache 无法命中的问题；请求会剥离旋转 billing attribution 行，使用稳定 prompt_cache_key，并把 cached_tokens 映射回 Anthropic cache usage (#789)。
• 修复 generated Mermaid flowchart label 含 HTML 换行、花括号或 bracketed type text 时 Markdown 预览渲染异常的问题 (#803)。
• 修复 Windows 设置页 checkbox focus/reflow、系统通知开启时白屏，以及离开 session 页面后 stale native preview view 未关闭的问题 (#788, #791)。
• 修复 Windows frameless 窗口拖动时 renderer-side delta fallback 反复 setPosition 导致窗口变大或 bounds 被错误改变的问题 (#770, #796)。
• 修复 Windows updater 使用 stale same-version metadata 时反复提示安装、版本 fallback 伪造显示，以及 NSIS 安装器不能选择安装目录的问题 (#801)。
• 修复 Windows 退出程序时 Electron sidecar、taskkill、CLI 和 scheduled-task subprocess 可能弹出多个 CMD 窗口的问题 (#802)。
• 修复 Trace 中工具调用耗时缺失、live trace polling 对原地 call 变更不敏感、detail section 折叠状态串 session，以及中止请求长时间 pending 的问题 (#799, #766)。
• 修复 release/packaging 本地 macOS 打包脚本通过 bunx 启动 electron-builder 时可能提前退出的问题；现在通过已安装的 Node CLI 启动 electron-builder。

Features and Improvements

• 服务商设置页支持 provider 拖拽排序，官方 provider 和自定义 provider 都进入同一排序模型，并通过 providers.json/providerOrder 持久化 (#753)。
• 设置页新增 Auto-dream 开关，开启前有明确确认，复用 CLI 已有的后台记忆整理能力 (#800)。
• Activity 页面新增历史插件和 Skill 使用聚合，展示 Codex 风格的 activity insights 和排行。
• H5 触屏环境会在首屏前标记 data-touch-h5，仅对手机浏览器启用移动端修复，避免影响桌面壳和桌面浏览器 (#780)。
• 桌面 General settings、Trace、H5、provider、Activity 等新增或变化文案同步补齐多语言。
• release workflow 增加 tag/version/release notes 对齐检查，继续以 release-notes/vX.Y.Z.md 作为 GitHub Release 正文来源。

Issue 对照

• #743：修复 compact 后 context meter 不下降和刷新超时提示残留。
• #753：新增服务商列表排序能力。
• #755：修复回答过程中干预/排队输入的桌面交互。
• #757：统一会话 token 用量单位和进行中 token 展示。
• #759：修复 sidebar 会话列表只显示少量真实会话的情况。
• #761：修复内置浏览器预览和打开菜单相关问题。
• #763：修复 MCP 配置页标题误导。
• #764：修复 H5 断连后过早杀掉后端 CLI，并支持可配置宽限时间。
• #766：修复桌面端慢 provider 卡住、fallback 无状态、Trace pending 的组合问题。
• #767：支持 H5 固定 token 和端口。
• #770 / #796：修复 Windows 拖动窗口导致窗口逐渐变大的问题。
• #773：延长桌面本地 API/agent 请求超时，避免健康长任务被过早中止。
• #776：修复生成物 reveal 到 Explorer/Finder 时 ~ 路径无法打开。
• #780：修复手机 H5 输入、键盘、选择、操作按钮和安全区问题。
• #788 / #791：修复 Settings General toggle 布局异常和系统通知白屏。
• #789：修复 OpenAI Responses API/GPT5.5 中转 prompt cache 不命中。
• #793：优化计划模式最终计划展示和桌面审批预览。
• #799：补齐 Trace 工具调用耗时。
• #800：新增 Auto-dream 设置入口。
• #801：修复 Windows updater/installer 流程和安装目录选择。
• #802：修复 Windows 退出时 CMD 窗口闪烁。
• #803：修复 Markdown 中 generated Mermaid 渲染异常。

Notes

• GitHub Release 正文继续以 release-notes/v0.4.2.md 作为来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 仍保留本地开发用的 999.0.0-local。发布时需确保 desktop/package.json、Git tag v0.4.2 和 release-notes/v0.4.2.md 三者严格对齐。
• 本版本覆盖 desktop、server、provider/runtime、agent-loop、native、docs/release 多个表面；发布前建议至少跑 bun run verify，并在有真实 provider 配额时跑 bun run quality:gate --mode release --allow-live --provider-model <provider:model[:label]>。
• 建议发布前额外做一次真实桌面 smoke：GPT5.5 provider、active-turn 排队输入、H5 手机访问、Trace detail、Windows 安装/退出、Windows mapped drive、内置浏览器 HTML 预览、生成物 reveal。
• 如果本版本仍未完成 Apple / Windows 代码签名，首次安装时系统可能需要手动放行一次（见下方安装说明）。覆盖安装不会删除本地数据（~/.claude、~/.claude/cc-haha 及自定义便携数据目录）。

安装

到本页面底部的 Assets 里，按系统和 CPU 架构下载对应文件：

平台	文件
macOS Apple Silicon（M 系列）	Claude-Code-Haha-0.4.2-mac-arm64.dmg
macOS Intel	Claude-Code-Haha-0.4.2-mac-x64.dmg
Windows x64	Claude-Code-Haha-0.4.2-win-x64.exe
Linux x64	Claude-Code-Haha-0.4.2-linux-x86_64.AppImage 或 Claude-Code-Haha-0.4.2-linux-amd64.deb
Linux ARM64	Claude-Code-Haha-0.4.2-linux-arm64.AppImage 或 Claude-Code-Haha-0.4.2-linux-arm64.deb

macOS

双击 DMG 把应用拖入「应用程序」。首次打开如果提示"已损坏"或"无法验证开发者"，在终端执行：

xattr -cr /Applications/Claude\ Code\ Haha.app

也可以在「系统设置 → 隐私与安全性」里点"仍要打开"。

Windows

双击 .exe 安装。SmartScreen 提示时点「更多信息」→「仍要运行」。

Linux

AppImage：

chmod +x Claude-Code-Haha-0.4.2-linux-x86_64.AppImage
./Claude-Code-Haha-0.4.2-linux-x86_64.AppImage

deb：

sudo apt install ./Claude-Code-Haha-0.4.2-linux-amd64.deb

ARM64 机器把文件名换成 ...-linux-arm64.AppImage / ...-linux-arm64.deb。