Claude Code Haha v0.3.1
这是一个以桌面端配置准确性、工作区引用、终端体验和跨平台稳定性为主的修复版本。
相比 v0.3.0,本次重点不是引入大功能,而是把桌面端在真实项目切换、MCP 作用域、便携配置、Windows 路径和终端面板里的细节打磨稳定。
Highlights
- MCP 作用域更准确:桌面端现在按 CLI 语义区分 local / project / user scope;创建或编辑 local/project MCP 时需要显式选择目标项目,避免写到当前 session worktree 或 server 启动目录。
- MCP 设置页更可信:设置页会从活动项目、最近项目和已有 user-private MCP key 聚合配置;project-scoped 条目不会因为目标项目不同而消失,初次加载时也不会闪一下空列表。
- 工作区文件引用更顺手:普通 dotfile / dotfolder 会在文件树中显示,文件和目录都可以从工作区菜单添加到聊天;常用复制路径改为项目相对路径,绝对路径保留为显式次级操作。
- 便携模式和插件 Skills 更稳定:桌面 CLI wrapper 会携带选定的
CLAUDE_CONFIG_DIR,插件或 Skill 安装后可通过 reload 刷新出来,不需要重启桌面端。 - 终端面板体验更稳:隐藏 docked terminal 或提升为 tab 时不会误杀正在输入的 shell;终端页去掉重复 chrome,保留更多可用空间,并改善未聚焦时的滚动交互。
- Windows drive root 支持更可靠:
C:/D:这类 drive-root 输入会被规范化,避免 session、workspace、文件访问或侧边栏隐藏项目逻辑把 drive root 和子项目混淆。
Fixes
- 修复 interleaved
tool_use ... text ... tool_use历史在 Bedrock 等严格 provider 下可能触发 400 的问题。 - 修复桌面端 sleep / wake 或重连后把已完成 assistant 回复重复追加的问题。
- 修复 Windows WebView2 下聊天内容因 1px 级高度震荡出现上下抖动的问题。
- 修复模型选择器在未登录 OAuth 时仍显示 Claude Official / ChatGPT Official 分组的问题,并修复上弹菜单与触发按钮之间的定位空隙。
- 修复 bypass 权限确认弹窗显示旧项目路径的问题;路径现在跟随当前活跃 tab。
- 修复 IM 适配器在桌面会话被删除后复用 stale session binding 的问题。
- 修复 shared directory picker 在窗口右侧触发时菜单溢出 viewport 的问题。
- 修复 H5 access 测试会被环境变量
CLAUDE_H5_AUTO_PUBLIC_URL污染的问题。 - 回滚
v0.3.0后引入的会话父子树侧边栏展示;响应中途不开放分支切换仍是当前预期行为。
Notes
- GitHub Release 正文继续以
release-notes/v0.3.1.md作为来源。 - 本版本包含 MCP local/project/user 配置路径、便携配置目录、终端 runtime 生命周期和 Windows drive-root 处理变化;发布前建议重点跑一次桌面端 MCP 设置、工作区文件引用、终端 dock/tab 切换和 Windows 路径 smoke。
- 打包发布仍由 tag 触发 GitHub Actions;本地可先用
bun run scripts/release.ts 0.3.1 --dry检查版本和 release note 对齐。
macOS
首次打开如果提示"已损坏"或"无法验证开发者",请执行:
:::bash
xattr -cr /Applications/Claude\ Code\ Haha.app