# 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 把应用拖入「应用程序」。首次打开如果提示"已损坏"或"无法验证开发者"，在终端执行：

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

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

### Windows

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

### Linux

AppImage：

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

deb：

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

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