mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-16 13:03:31 +08:00
82 lines
4.8 KiB
Markdown
82 lines
4.8 KiB
Markdown
# Claude Code Haha v0.4.1
|
||
|
||
这是 `v0.4.0` Electron 迁移后的第一个补丁版本，重点是补齐桌面端可观测性、IM 适配器能力、多语言界面，以及修复迁移后暴露出来的会话稳定性和发布打包细节。
|
||
|
||
相比 `v0.4.0`，本版本新增 session trace monitoring，可在桌面端查看模型请求、工具调用、消息流和关键事件；同时补强 WhatsApp / Telegram 适配器、设置页体验、图片/截图链路和 provider/runtime 边界行为。
|
||
|
||
## Highlights
|
||
|
||
- **Session Trace Monitoring**：新增会话 Trace 记录和查看能力，支持按 session 查看 LLM 请求、工具调用、消息详情、耗时与错误信息；Trace 界面升级为更接近 LangSmith 的双栏树状布局，并把入口收敛到 Settings。
|
||
- **IM 适配器增强**：新增 WhatsApp linked-device 支持，完善配对、媒体处理和桌面设置入口；Telegram 新增命令菜单，常用操作不再依赖手写命令。
|
||
- **桌面多语言补齐**：新增日语、韩语、繁体中文界面，并补齐后续新增设置项、Trace、Adapter 等页面文案。
|
||
- **桌面设置和工作流更顺手**：新增桌面端 Output Style 配置，插件列表支持批量开关，Memory 页面改为 preview-first 并让 Markdown 编辑器填满面板。
|
||
- **截图与预览链路更可靠**：预览截图改为 Electron 原生采集，renderer reload 时会关闭预览窗口，减少旧窗口和截图状态残留。
|
||
|
||
## Fixes
|
||
|
||
- 修复 active turn 进行中切换权限或运行时配置时，server 可能过早重启 session 的问题；现在会延后到当前 turn 完成后处理 (#626)。
|
||
- 修复 prewarm / resume / shutdown 交错时可能触发异常状态或退出路径不完整的问题 (#611)。
|
||
- 修复并发 worktree 配置写入可能互相覆盖的问题 (#572)。
|
||
- 修复 OpenAI-compatible provider 流式响应长时间无输出时缺少 stall timeout 的问题 (#548)。
|
||
- 修复 OpenAI chat completion 测试请求误走 stream 形态的问题 (#638)。
|
||
- 修复桌面端输出风格设置无法正确写入和用于会话启动的问题 (#652)。
|
||
- 修复持久化聊天图片在恢复历史会话后丢失的问题 (#721)。
|
||
- 修复聊天选中文本生成的历史引用卡片样式丢失，以及 plan mode 退出后权限模式恢复异常的问题 (#623)。
|
||
- 修复工具调用失败时错误详情展示不完整的问题 (#625)。
|
||
- 修复 Memory 文件默认进入编辑态、Markdown 编辑器高度不足的问题 (#533)。
|
||
- 修复 scheduled task 通知轮询早于 server ready 状态启动的问题。
|
||
- 修复 diagnostics 把预期状态记录成 error 的噪音，并隔离相关测试状态。
|
||
- 修复 WhatsApp 配对完成后重启 login socket 导致连接丢失的问题。
|
||
- 修复 IM adapter 设置页的安装和配置引导文案过时。
|
||
- 修复 release workflow 在未配置签名 secrets 时把空签名环境变量传给 electron-builder。
|
||
|
||
## Notes
|
||
|
||
- GitHub Release 正文继续以 `release-notes/v0.4.1.md` 作为来源。
|
||
- 本版本包含 Trace capture、provider proxy、WebSocket session lifecycle、IM adapter sidecar 和 Electron 预览截图链路变化；发布前建议至少跑 `bun run verify`，并对桌面 Trace、WhatsApp/Telegram、预览截图和 provider 请求做一次真实 smoke。
|
||
- 桌面端发布版本号来源是 `desktop/package.json`；root `package.json` 仍保留本地开发用的 `999.0.0-local`。
|
||
- 如果本版本仍未完成 Apple / Windows 代码签名，首次安装时系统可能需要手动放行一次（见下方安装说明）。覆盖安装不会删除本地数据（`~/.claude`、`~/.claude/cc-haha` 及自定义便携数据目录）。
|
||
|
||
## 安装
|
||
|
||
到本页面底部的 Assets 里，按系统和 CPU 架构下载对应文件：
|
||
|
||
| 平台 | 文件 |
|
||
|------|------|
|
||
| macOS Apple Silicon（M 系列） | `Claude-Code-Haha-0.4.1-mac-arm64.dmg` |
|
||
| macOS Intel | `Claude-Code-Haha-0.4.1-mac-x64.dmg` |
|
||
| Windows x64 | `Claude-Code-Haha-0.4.1-win-x64.exe` |
|
||
| Linux x64 | `Claude-Code-Haha-0.4.1-linux-x86_64.AppImage` 或 `Claude-Code-Haha-0.4.1-linux-amd64.deb` |
|
||
| Linux ARM64 | `Claude-Code-Haha-0.4.1-linux-arm64.AppImage` 或 `Claude-Code-Haha-0.4.1-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.1-linux-x86_64.AppImage
|
||
./Claude-Code-Haha-0.4.1-linux-x86_64.AppImage
|
||
```
|
||
|
||
deb：
|
||
|
||
```bash
|
||
sudo apt install ./Claude-Code-Haha-0.4.1-linux-amd64.deb
|
||
```
|
||
|
||
ARM64 机器把文件名换成 `...-linux-arm64.AppImage` / `...-linux-arm64.deb`。
|