Claude Code Haha v0.5.1

Claude Code Haha v0.5.1

这是 v0.5.0 之后的体验与稳定性更新，重点补齐 Provider 导入、聊天内容导航、后台任务与重连可靠性，并继续收紧本地运行边界。

新增与改进

• 支持从 cc-switch 一键导入 Claude Code Provider，并从 OpenAI 兼容接口获取模型列表。
• 模型目录改为缓存优先、后台刷新，Provider 不可达时不再阻塞桌面端启动。
• Slash 命令按用途分组；运行位置选择、发送按钮、会话标签和设置侧栏交互进一步简化。
• 回复中的 URL 和文件路径可直接点击；Shell 工具卡会显示输出，完成的对话会显示结束时间与耗时（#1145、#1146、#1149、#1151）。
• 新增 AskUserQuestion 的“再聊一下”入口，并自动识别、记住系统显示语言（#1121）。
• 完善 Telegram 的会话恢复、Provider / 模型切换、Skills 调用、权限确认和图片回传（#1130）。
• Linux Release 新增 x64 / ARM64 RPM 安装包；项目许可证更新为 MIT。

修复

• 修复桌面端重连后重复回放旧 CLI 消息的问题。
• 修复 Windows 无法创建符号链接时后台 Agent 输出为空，以及工具路径显示过长的问题（#1018、#1141）。
• 修复项目级 MCP Server 重启后消失、IM 设置保存空绑定字段的问题（#1126、#1137）。
• 修复图片消息顺序错乱，以及 OpenAI Responses 转换丢失工具返回图片的问题（#1053、#1095）。
• 修复元素选择确认失效、WebView 轻微尺寸抖动、宠物任务面板碰到 macOS 菜单栏等桌面问题（#1140、#1144）。
• 修复长会话处理性能、CLI 部分输出与恢复流程中的多项稳定性问题（#1100）。
• 加强本地文件、预览、H5 访问和远程图片请求的安全边界，同时恢复受影响的正常功能。

安装

请在本页面底部 Assets 中下载对应平台和架构的安装包：

• macOS：Claude-Code-Haha-0.5.1-mac-arm64.dmg / Claude-Code-Haha-0.5.1-mac-x64.dmg
• Windows：Claude-Code-Haha-0.5.1-win-x64.exe / Claude-Code-Haha-0.5.1-win-arm64.exe
• Linux x64：AppImage、deb 或 Claude-Code-Haha-0.5.1-linux-x86_64.rpm
• Linux ARM64：AppImage、deb 或 Claude-Code-Haha-0.5.1-linux-aarch64.rpm

Claude Code Haha v0.5.0

Claude Code Haha v0.5.0

这是 v0.4.11 之后的界面重做版本。桌面端整体视觉按「纸·墨·印」设计稿重构，底层抽出一套组件库替换散落各处的原生控件，品牌标记从位图改为随主题重绘的矢量，并新增跟随系统深色/浅色外观。同时修复了工具拒绝中断整轮、流式传输中断不重试、MCP 父级配置无法删除、用量统计重复计数等一批问题。

版本号从 0.4.11 直接跳到 0.5.0：本轮改动的主体是表现层的整体替换而不是逐点修补，用 patch 号继续累加会低估变更范围。跳号不影响应用内自动更新，electron-updater 按 semver 比较版本，0.5.0 对任何 0.4.x 都是更新版本。

Highlights

• 「纸·墨·印」全量 UI 重设计：6 套主题（纯白、纸墨、经典暖色、青瓷、墨夜、墨夜蓝），采用源色块加单一语义映射层的两层 token 结构；标题改用自托管的 Noto Serif SC 衬线拉丁分片，中文回退系统衬线；圆角、阴影、动效阶梯统一定稿。外壳、零态、活跃会话、composer 全部弹层、技能市场、定时任务、设置全分区、Trace、终端和 ⌘K 均已重做。只换表现层，功能、数据契约与交互逻辑不变；旧的 light 主题设置会自动迁移到 warm-classic。
• 桌面端组件库：新增 components/ui 原语层（24 个组件）与 components/composite 共享部件层，替换此前散落的原生控件——362 个原生 button 只有 22% 复用率，图标按钮存在 15 种圆角、12 种尺寸，41% 没有焦点环，10 个没有可访问名称。组件复用率现为 75%，剩余部分是 role="tab"、menuitem、整行整卡点击目标等不应组件化的元素。四道守门测试分别校验分层依赖、token 可解析、对比度达 AA 和调用方数量。
• 品牌标记矢量重建：应用图标从 120KB 位图重建为矢量几何，可以随主题重新着色——两个 C 取墨色，印章条、光标和星芒取朱色。所有消费点按尺寸减件：星芒在 40px 以上、光标在 24px 以上，C 与印章条始终保留。应用图标本身保持一份固定艺术稿（Dock 与任务栏由系统绘制，不感知应用内主题），应用内的标记则是跟随主题重绘的矢量。
• 跟随系统深色/浅色外观（#1106）：设置 → 通用新增开关。系统只报告 dark/light 而应用有 6 套主题，因此调色板选择器按底色分为「浅色模式使用」和「深色模式使用」两组，各自记住偏好。同时修掉了每次启动先刷白屏的问题——index.html 此前硬编码 data-theme="white"，而读取已存主题的代码要等应用包动态导入完成才运行；现在有一段同步内联脚本在任何样式表解析前解析主题，Electron 也从缓存的外观预置窗口背景色。新装默认跟随系统，已有安装保持原有固定主题直到用户主动开启。
• 侧边栏宽度可调：右边缘 8px 拖拽手柄，宽度在 240–480px 之间，持久化到 localStorage，双击回到 300px，方向键可微调。向左拖过 240px 会停住，越过 180px 才收起为窄栏，回来时越过 200px 才展开——20px 的滞回区间避免手抖时反复开合。设置侧栏从 260px 收到 220px（200px 会让日语「コンピューター操作」截断，实测阈值在 210px）。
• 运行位置收敛为单个 pill：目录、分支、worktree 原本是 composer 下方独立条上的三个按钮，现在合并为工具栏行内的一个 pill，与「+」和模型选择器同行。会话草稿阶段可编辑，发出首条消息后转为只读，位置不变。分支名截断保留尾部（…use-native-on-main 而非 feature/comp…），因为尾部才是区分度所在。
• 技能市场改为滚动加载：翻页从「加载更多」按钮改为提前 400px 触发的滚动观察，加载中显示占位卡片；首屏骨架卡数量按可用空间测算而不是固定 6 张。加载失败有独立的内联提示和重试，不再整块清空目录，也不会自动重试撞进同一个失败。
• 宠物动作表放宽为任意尺寸：导入动画宠物此前要求文件精确为 1536×2288、88 格无缝排布，没有图像模型会输出这个尺寸，所以这条路每次都终止在尺寸校验上；而「AI 生成完整动画」那张卡是硬编码 disabled 的死入口。现在任意尺寸的 8×9 动作表都会在浏览器端自动切格、缩放、镜像生成向左跑，并复用行补齐 11 组动作。已经是 1536×2288 的图集原样通过，不做重采样。新增白底检测：透明像素低于 5% 的图集会被拒绝并说明原因，此前这类图会安静地导入并在桌面上渲染成一个矩形。
• .agents/skills 跨客户端约定（#1093）：识别多个 AI 客户端共用的 .agents/skills 目录约定。

Fixes

• 修复对话框背景可以直接看穿的问题。.glass-panel 把半透明填充和模糊写在同一条规则里，只有两者都生效才呈现毛玻璃；而 backdrop-filter 不生效时 CSS 不会报错，只是跳过声明，留下 0.84 的填充独自承担，导致 16% 的页面内容清晰透出。对话框现在使用按构造不透明的 --color-surface-dialog，完全不依赖模糊。
• 修复拒绝工具权限后整轮对话静默结束的问题（#1051）。桌面端的拒绝以 interrupt: true 回给 CLI，触发 abort，拒绝虽然写进了 transcript 却再没有发起后续请求，模型既不知道被拒绝也没机会回应。现在发送 CLI 自己使用的拒绝文案，模型会被再次询问并给出回复。ExitPlanMode 的语义相反——拒绝计划意味着「继续规划」——因此使用单独的文案。
• 修复流式传输被中断后不重试的问题。Grok 上出现的 The socket connection was closed unexpectedly 是 Bun 在读取被对端 RST 的响应体时抛的裸 Error，三条恢复路径全部漏过：withRetry 只包裹建流不包裹消费，isRetryableStreamError 要求 SSE body 里带 api_error 的 APIError，而桌面端注入了禁用非流式回退的开关。现在按传输层错误码（ECONNRESET/EPIPE 等）沿 cause 链判定并重建流。重试受与看门狗相同的副作用边界约束：一旦有 tool_use 块完成或服务端工具活动开始，断连会如实上报而不是重放。
• 修复 Grok Responses 请求的四处偏差（对照官方 CLI 逐条用实际请求验证）。指定工具的 tool_choice 此前被翻译成 Chat Completions 语法，Responses 端点直接返回 422，导致所有指定工具的请求整体失败；另外补上 prompt_cache_key 与 x-grok-conv-id 的会话级身份复用，避免每轮重复计费整个前缀。
• 修复父目录 .mcp.json 中声明的服务器无法删除的问题（#1107）。读取会从当前目录向上遍历继承所有 .mcp.json，删除却只看当前目录自己的文件，于是这类服务器显示为可删除、点删除后报「发生未知错误」。同时修掉一个凭据泄露：新增服务器时会重建整个配置文件，把 ${VAR} 展开后的值写回磁盘——实测 "Bearer ${MY_MCP_TOKEN}" 被写成了明文密钥，而这个文件通常是要提交的。
• 修复后台 agent 工作时思考块被切成多段的问题（#1108）。后台 agent 的工具活动会以带 parentToolUseId 的普通事件重新发出并落在消息数组末尾，而流式思考块的合并判断看的是数组尾部是不是思考块——尾部变成了子工具调用，于是之后每个分片都另起一个气泡。现在合并时跳过这些冒泡的子消息。
• 修复 TaskUpdate 删除的任务仍留在活动面板的问题（#1101）。deleted 是删除动作而不是状态，CLI 会直接删掉任务文件；活动面板把它当状态解析，落到 pending 兜底并一直挂在面板上。
• 修复用量统计把一条助手回复重复计算的问题。Claude Code 按 content block 逐行写 JSONL，每行都重复完整的 usage 对象，两条统计路径都在累加——本仓库里一条跨 52 行的真实消息带 50.8K token，被统计成 2.65M。同时修掉：成本字段此前是从未赋值的死代码；未知模型不再按 Claude 价格计费（12.7% 的 token 来自第三方 provider）；「最长任务」此前用首尾时间差衡量，跨夜恢复的会话会把整晚算进去，实测出现过 436 小时和 1137 小时的读数，现在按 30 分钟以内的间隔累计有效工作时间；workflow 子 agent 的 transcript 此前从未被索引。
• 修复会话头部占用过高的问题。重设计后的头部把不截断的 22px 标题叠在元信息行上方，长标题会折行把正文推下去；现在标题单行截断、元信息移到标题下方一行，实测从 123.5px 收到 66.75px，完整标题保留在悬停提示里。
• 修复被拖动的宠物无法贴到 macOS 菜单栏的问题。macOS 会把已显示窗口的 frame 交给 constrainFrameRect:toScreen: 改写，任何高于工作区的 y 都被静默拉回顶边——实测只有顶边受约束，左右和下边一直正常。enableLargerThanScreen 是唯一能跳过该方法的开关。同时修复了重启后位置漂移：窗口在渲染进程报告吉祥物区域之前就已创建，恢复时按整窗裁剪会低开一个内边距的高度。
• 修复 Windows 上被拖动的宠物被裁切、无法贴到显示器边缘、重启后不保持位置的问题（#1099、#1104）。
• 修复粘贴的图片渲染成通用文件卡的问题。粘贴文件统一走原生路径后，所有附件都被标为 type: 'file' 且没有预览源，而重开标签页时又能从 transcript 的内联图片块正确显示——实时显示与恢复显示出现分歧。现在按扩展名解析图片附件的显示源，WebSocket 负载仍保持只传路径。
• 修复 Skill frontmatter 被当作 Markdown 渲染的问题。YAML 块的收尾 --- 被解析成 setext 标题标记，整块 frontmatter 渲染成一个巨大的加粗 <h2> 压在文档上方。现在拆出来按结构化行排版。
• 修复插件重载失败仍报告成功的问题。变更已落盘但运行时重载失败的那一半此前完全静默，与正常成功的提示无法区分。
• 修复 loopback 请求在桌面进程令牌存在时全部被拒的问题。此前一旦桌面外壳注入令牌，loopback 地址就不再构成信任依据，而系统浏览器永远拿不到这个令牌——Grok OAuth 成功页、/preview-fs 链接和普通 curl 全部返回 401。现在 loopback 恢复为独立可信，令牌只在 /api/h5-access 控制面强制要求（同一台机器上的其他程序不得把用户会话发布到网络）。同时补上一个更早就存在的 CSRF 漏洞：if (!origin) return true 也接受跨站子资源加载，现在用 Fetch Metadata 区分真实导航与子资源。
• 修复 Windows 上 taskkill 缺失时的处理（#1091），以及 electron:dev 启动器在 Windows 上不可用的问题。
• 修复同名 skill 在多个根目录下解析不一致的问题，以及 .agents 来源标记、doctor 检查和列表安全性的若干偏差。

Features and Improvements

• 会话元信息、附件画廊、图片灯箱、页内查找的控件补齐可访问名称与键盘操作；灯箱支持方向键和首尾循环，单图时不显示箭头。
• 48 个此前硬编码的用户可见字符串补齐 5 个语言的翻译键（en / zh / zh-TW / jp / kr），包括 browser/ 下整块硬编码的中文和多处硬编码英文。TranslationKey 由 en.ts 推导，缺键是编译错误而不是运行时空白。
• 终端配色从硬编码的 20 个十六进制值改为读取按主题定义的 --color-terminal-* token。
• 下拉菜单获得 listbox 语义、方向键导航和焦点返回；21 处手写的外部点击处理统一为 useDismissable，默认使用 pointerdown——mousedown 在触屏上不可靠，这正是 H5 上「点外面菜单不关」的成因。
• 新增仅开发环境可用的组件画廊（/gallery.html），在三套主题下渲染全部原语。单元测试无法判断 token 是否解析成可读的颜色、浮层是否盖在该盖的东西上方、入场动画是否真的播放——画廊本身就发现了三个测试全绿却存在的缺陷。
• 文档站用 React 重建，落地页文案重写。
• 组件库的使用规则、分层依据与审计证据记录在 desktop/src/components/AGENTS.md 和 docs/component-library-plan.md。

Issue 对照

• #1051：拒绝工具权限后把拒绝结果交回模型，而不是中断整轮。
• #1086：支持粘贴文件附件。
• #1091：处理 Windows 上缺失的 taskkill。
• #1093：识别跨客户端的 .agents/skills 目录约定。
• #1099 / #1104：修复 Windows 上宠物被裁切与无法贴边。
• #1101：从活动面板移除已被 TaskUpdate 删除的任务。
• #1106：跟随系统深色/浅色外观，并消除启动白闪。
• #1107：删除父级 .mcp.json 中声明的 MCP 服务器。
• #1108：后台 agent 工作期间保持思考块完整。

Verification

• 本机以 release 模式跑完质量门禁，13 条非 live lane 全部通过：Policy 127 项、Desktop 271 文件 / 3331 项通过 1 项跳过、Server 227 文件 / 2447 项、Adapters 406 项、Provider contract 18 组、Chat contract 全组、Native（sidecar 编译 + Electron 检查 + 目录打包 smoke）、Docs 80 页 / 302 处链接与图片、Persistence upgrade、Quarantine（0 条）、Baseline case catalog。
• Coverage 门禁 5/5 套件通过，Desktop React 行覆盖 90.19%。首次运行时该门禁失败，根因是 nativeAppearance.test.ts 的用例未传隔离 env：check:coverage 在设有 CLAUDE_CONFIG_DIR 的沙箱环境中运行，而该变量的优先级高于 app.getPath('home')，使各用例本应独立的缓存路径塌缩成同一个文件，一个用例因此读到另一个用例写入的值。已修复为显式传入隔离 env，与 windows.test.ts 既有写法一致，并在设与不设该变量的两种环境下各验证一次。这是测试隔离缺陷，不影响产品行为；Release Desktop workflow 不运行该门禁，pr-quality workflow 会运行。
• 未执行项，不计为通过：6 条 baseline case 与 1 条 provider live/proxy smoke 需要真实 provider 凭据，本机未运行；desktop-package-smoke 需要已签名的本机 release 产物，由 CI 的 Verify packaged app structure 与 Verify macOS launch policy 覆盖；本轮 UI 重构未做真机逐屏走查；v0.4.11 -> v0.5.0 的真实自动更新链路需在 Release 发布后验证。
• 上述证据只覆盖本机候选构建与测试，不等同于正式签名、公证或跨平台安装的端到端验证。

Notes

• GitHub Release 正文以 release-notes/v0.5.0.md 作为唯一来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 继续保留本地开发用的 999.0.0-local。发布时必须确保版本号、Git tag v0.5.0 和本文件严格一致。
• 版本号从 0.4.11 跳到 0.5.0 不影响自动更新。electron-updater 使用 semver 比较（semver.gt）而非字符串比较，且更新元数据取自仓库最新 Release，与版本号是否连续无关。0.5.0 不带 prerelease 后缀，仍走稳定通道，元数据文件名不变。
• Release Desktop workflow 会构建 macOS、Windows 和 Linux 的 x64 / ARM64 安装包，并在完整资产和 updater metadata 校验通过后公开 Release。
• 自动更新验证路径是正式 v0.4.11 -> v0.5.0。发布完成后需核对 latest-mac.yml、latest.yml、latest-linux.yml 和 latest-linux-arm64.yml。
• macOS 正式公开发布依赖签名和公证 secrets；Windows 未配置签名时仍可安装和自动更新，但可能显示 SmartScreen 提示。
• 本次是表现层的整体替换，功能与数据契约未变更，已有会话、服务商配置、Skills、Agents、记忆和自定义数据目录不需要迁移。旧的 light 主题设置会自动迁移到 warm-classic。
• 组件画廊（/gallery.html）只在 bun run dev 下可达，不进入生产包——Vite 的构建入口只有 index.html。

安装

在本页面底部 Assets 中按系统和 CPU 架构下载：

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

macOS

双击 DMG，把应用拖入「应用程序」。正式签名和公证产物应直接通过正常 Gatekeeper 流程。

Windows

双击 .exe 安装。建议直接以当前用户运行，不要使用「以管理员身份运行」。覆盖升级前先完全退出应用；如果安装器报告相关进程仍在运行，请根据提示关闭对应进程后重试。未签名构建出现 SmartScreen 时可选择「更多信息」→「仍要运行」。

Linux

AppImage：

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

deb：

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

ARM64 机器请换用对应的 linux-arm64 文件。

Claude Code Haha v0.4.11

Claude Code Haha v0.4.11

这是 v0.4.10 之后的桌面体验与 Agent 工作流版本，重点新增互动桌面宠物、完整的桌面 Agent 管理、逐 Agent 模型与思考强度配置，并更新 Claude 官方模型阵容。同时继续修复任务状态、SubAgent 实时详情、附件恢复、Provider 创建、上下文估算和 Windows 桌面恢复等问题。

相比 v0.4.10，本版本让后台任务和 Agent 配置更容易观察、调整和复用：宠物可以在独立悬浮窗口中反映当前任务状态，Agent 可以按用户或项目范围管理，并为不同职责分别选择模型、effort 和工具。会话恢复后会继续保留附件内容，任务与子代理的运行状态也会更及时地同步到桌面端。

Highlights

• 互动桌面宠物：新增 Electron 原生透明悬浮窗口，内置搭搭、弧弧、补补、回回 4 个角色；宠物会根据工作中、等待处理、失败和空闲状态切换动作，并可展开活跃任务、点击返回对应会话。
• 本地自定义宠物：支持导入透明 PNG / WebP 制作轻动画宠物，也支持导入 1536×2288 的 v2 逐帧动画图集；可调整尺寸、动画开关和任务面板显示，整个导入过程在本地完成，不调用当前聊天模型。
• 完整的桌面 Agent 管理：设置页可以浏览内置、用户、项目、插件和策略等来源的 Agent 及覆盖关系，并创建、编辑或删除用户级与项目级 Agent。
• 逐 Agent 模型与 effort：每个自定义 Agent 可以独立继承或指定 Fable、Opus、Sonnet、Haiku、自定义模型 ID，以及 low 到 max 的思考强度和可用工具；配置已接入 Agent 定义、运行、恢复和团队执行链路 (#1062)。
• Claude 官方模型阵容更新：桌面端与 CLI 新增并识别 Fable 5、Opus 4.8、Sonnet 5 和 Haiku 4.5，补齐显示名称、1M 上下文、推理强度和 Provider 环境映射。实际可用性仍取决于账号权限与 Provider 支持。
• 任务与 SubAgent 更可观察：运行中的 SubAgent 可以立即打开详情并持续看到新记录；Task V2 的完成状态、并发更新和临时轮询失败也会更稳定地反映在桌面端 (#1075, #1077)。

Fixes

• 修复部分 Provider 返回空或全零 usage 时，上下文占用估算消失的问题；现在会保留运行模型锚点并回退到本地 transcript 估算，不把估算值误作费用统计 (#1063)。
• 修复首轮消息携带图片或文件时，服务端回放可能让用户消息重复显示的问题；兼容 Windows 路径、UUID 前缀上传文件和内联图片 (#1069)。
• 修复拒绝工具权限后，正常中断被误报为执行失败的问题；当前轮会正确结束并回到可继续输入的状态 (#1070)。
• 修复任务已经完成但状态没有及时更新、旧请求覆盖新状态，以及临时轮询失败时任务列表闪空的问题 (#1075)。
• 修复运行中的 SubAgent 详情长期停留在“开始中”、必须等结束后才能查看执行过程的问题；运行记录和工具调用现在会持续刷新 (#1077)。
• 修复 Provider 预设接口暂不可用时“添加服务商”按钮失效的问题；常用预设改为随桌面端内置，并保留可编辑的 Custom 入口 (#1078)。
• 加强 Windows 白屏、Renderer 异常退出、代理连接重置、终端和 IM WebSocket 生命周期的恢复与错误隔离；主窗口会尝试有限恢复，并为无法恢复的启动故障保留可见错误信息 (#1064, #1065, #1071)。
• 修复桌面端完全退出或恢复会话后，文件、目录和 PDF 附件只剩路径、丢失原始上下文的问题；外部反馈分享仍会过滤附件记录和内容。
• 修复宠物任务卡在 Windows 上被原生窗口 shape 裁切、关闭按钮被透明命中区遮挡，以及重启后宠物未保持置顶的问题。
• 修复 Agent 文件已经保存后仍被可选热重载阻塞、运行中新增嵌套 Git 仓库时项目 Agent 可能写到外层仓库，以及旧刷新结果覆盖新项目状态的问题。
• 修复本地 HTTP 连接在 Windows 长时间空闲后被复用时，Session、Task、Scheduled 等接口可能同时超时的问题；同时补齐请求取消和任务轮询的资源清理。
• Kimi Code 预设升级为 K3：使用 Coding API、k3 模型、262K 上下文和 API Key 鉴权，并补齐 required thinking、effort 与 max effort 能力。

Features and Improvements

• 桌面宠物支持位置拖动、点击互动、视线跟随、右键关闭和窗口位置恢复；任务面板默认收起，可用数量徽标展开最近的活跃会话。
• 自定义宠物导入增加本地化文件选择框，以及针对格式、尺寸、文件大小、重复 ID、损坏图片和存储失败的明确错误提示。
• Agent 列表展示来源、生效/覆盖状态、模型、思考强度、工具范围和系统提示词；内置、插件与策略来源保持只读。
• Agent 编辑器支持选择项目目录，并从当前运行环境读取真实可用工具，按类别搜索和勾选，同时保留 MCP、自定义工具和 Bash(git:*) 等规则输入。
• Agent 配置保存后会刷新当前会话组件；刷新失败不会回滚已经保存的定义，并提供可重试提示。
• 模型选择器会合并官方目录、当前 Provider 配置和运行时角色模型，保留第三方 Provider 的自定义模型映射。
• 会话状态和任务投影增加取消、乱序和临时失败保护，降低快速切换会话或多请求并发时的状态回退。
• Electron 构建补充 sidecar 启动、Renderer 恢复、宠物 IPC、打包输出空闲和跨平台产物契约检查。

Issue 对照

• #1062：为每个 Agent 单独配置模型、思考强度和工具范围。
• #1063：Provider usage 为空或全零时保留上下文估算。
• #1064 / #1065 / #1071：加强 Windows 白屏、JavaScript error 和异常重启后的恢复与隔离。
• #1069：避免首轮附件消息在服务端回放后重复显示。
• #1070：正确处理中断工具权限后的正常结束流程。
• #1075：稳定任务完成状态、并发读写和桌面轮询。
• #1077：在 SubAgent 运行期间持续展示详情和工具记录。
• #1078：让 Provider 创建入口不再依赖运行时 presets 请求。

Verification

• 当前合并候选已通过 desktop、server、provider-contract、chat-contract、adapters、native、persistence-upgrade 和 coverage 门禁：Desktop 2450 项通过、1 项跳过；Server 2281 项通过；Adapters 406 项通过；Coverage 5/5 groups、0 failed。
• Electron native 验证包含 312 项测试、sidecar 编译 smoke、production build、macOS arm64 目录打包和 current package smoke；该证据只证明本机候选构建与产物结构，不等同于正式签名、公证或跨平台安装 E2E。
• 已有隔离 Windows 11 人工记录覆盖真实 DeepSeek / MiniMax 对话、附件恢复、多模态、SubAgent 实时详情、Task V2、Renderer 恢复、长空闲本地连接、自定义宠物导入和宠物任务面板；部分宠物拖动/多显示器、Agent 热重载后的真实模型与 effort、IM/H5 故障注入仍未完整执行。
• 尚未执行正式 v0.4.10 -> v0.4.11 自动更新、由 v0.4.11 Tag 生成的 Windows/Linux 安装包实机验证，也未运行 live-provider 全组合测试。未执行项不计为通过。
• 已识别两个仍需后续加固的极端连接边界：永不完成的 CONNECTING WebSocket 握手，以及持续少量输出的 sidecar 健康检查响应。因此本版本不宣称彻底消除所有连接泄漏或启动挂起。

Notes

• GitHub Release 正文以 release-notes/v0.4.11.md 作为唯一来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 继续保留本地开发用的 999.0.0-local。发布时必须确保版本号、Git tag v0.4.11 和本文件严格一致。
• Release Desktop workflow 会构建 macOS、Windows 和 Linux 的 x64 / ARM64 安装包，并在完整资产和 updater metadata 校验通过后公开 Release。
• 自动更新验证路径是正式 v0.4.10 -> v0.4.11。发布完成后需核对 latest-mac.yml、latest.yml、latest-linux.yml 和 latest-linux-arm64.yml。
• macOS 正式公开发布依赖签名和公证 secrets；Windows 未配置签名时仍可安装和自动更新，但可能显示 SmartScreen 提示。
• 桌面宠物是 Electron 桌面功能，不在 H5 中运行；单图导入提供本地轻动画，不是 AI 逐帧动画生成。
• Agent 的 effort 是否完整生效取决于所选模型和 Provider；不支持的组合可能被降低或忽略。

安装

在本页面底部 Assets 中按系统和 CPU 架构下载：

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

macOS

双击 DMG，把应用拖入“应用程序”。正式签名和公证产物应直接通过正常 Gatekeeper 流程。

Windows

双击 .exe 安装。建议直接以当前用户运行，不要使用“以管理员身份运行”。覆盖升级前先完全退出应用；如果安装器报告相关进程仍在运行，请根据提示关闭对应进程后重试。未签名构建出现 SmartScreen 时可选择“更多信息”→“仍要运行”。

Linux

AppImage：

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

deb：

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

ARM64 机器请换用对应的 linux-arm64 文件。

Claude Code Haha v0.4.10

Claude Code Haha v0.4.10

这是 v0.4.9 之后的稳定性与恢复版本，重点修复会话重启、后台 Agent、权限拒绝、H5 断连、对话搜索和 Windows 覆盖升级中的边界问题，并补齐启动诊断、代理波动恢复、模型角色配置和无界面 H5 部署能力。

相比 v0.4.9，本版本更可靠地保存“已经完成、已经停止、已经拒绝”的真实状态。应用冷启动、网络波动或手机离开 H5 后，不应再把终态回退为运行中，也不应把未执行的写入显示为文件变更。Windows 安装器会更准确地区分真正占用安装目录的进程，并保护升级前的用户数据。

Highlights

• 会话恢复与撤销更可信：撤销当前轮次改用真实 checkpoint；重启前会先落盘上下文，恢复历史会话时不再误触发预热，长对话重新挂载后保持阅读位置。
• 后台任务终态持久化：后台 Agent 的完成、失败和停止状态会写入会话历史；完全退出再启动后，已完成卡片不会回退成“进行中”，旧版通知格式仍可继续读取。
• H5 断连清理补齐启动竞态：手机在 CLI 启动阶段离开、权限请求随后才出现时，服务端仍会建立清理观察；无人连接的权限等待会在上限后停止，重连和正常长任务不会被误杀。
• Windows 覆盖升级加固：安装器更准确地检查相关进程、处理当前用户安装和旧数据恢复，减少 CLR HRESULT、误报程序仍在运行或必须卸载重装的问题。
• 对话搜索与滚动稳定：虚拟化长对话支持可靠搜索、方向导航和当前匹配定位；快速输入、内容刷新与组件重新挂载不会让旧结果覆盖新结果或把滚动位置拉回底部。
• 代理、启动与诊断更可恢复：系统代理连接重置不会再触发主进程 JavaScript 异常；渲染器入口失败时会显示启动错误；SDK 诊断消息设有保留上限，避免长时间运行后持续占用内存。

Fixes

• 修复异常结束的轮次必须重启后才能撤销、或撤销到错误文件状态的问题；现在使用服务端权威 checkpoint，只回退目标轮次 (#1030)。
• 修复上下文在运行时重启前未完整落盘、恢复会话时额外预热可能污染上下文的问题 (#1033, #1054)。
• 修复长对话重新挂载后滚动位置丢失，以及搜索结果更新时方向键、当前匹配和高亮不同步的问题 (#1045, #1057)。
• 修复后台 Agent 完成通知与前台 Skill 并发时可能影响前台输出，以及冷启动后终态回退为“进行中”的问题 (#1047)。
• 修复中断的历史任务长期保持运行状态的问题；未完成轮次现在收敛为“已停止”，真正完成的轮次仍保持“已完成” (#1034)。
• 修复普通工具被拒绝后当前轮次仍继续执行，以及拒绝的 Write/Edit 虽未落盘却出现在 changed-files 卡片和工作区变更中的问题 (#1051)。
• 修复 H5 已离开但权限请求稍后才出现时，清理观察未能生效的问题；同时保留重连取消清理和正常后台执行语义 (#1019)。
• 修复系统代理节点切换、短暂断网或连接重置时弹出主进程异常、恢复网络后仍需重启的问题 (#1050, #1056)。
• 修复 Windows 当前用户覆盖安装可能出现 CLR HRESULT、误判残留进程、错误阻止安装或损伤旧数据恢复的问题 (#1028, #1029, #1036)。
• 修复渲染入口加载失败时应用只剩后台进程、没有可见错误窗口的问题 (#1032)。
• 修复 Sidecar 长时间保留过多 SDK 诊断事件导致内存持续增长的问题，同时保留实时回复和关键错误信息 (#1049)。
• 修复应用缩放和窗口变化后，原生浏览器预览与 React 容器边界错位的问题 (#1042)。
• 修复关闭最后一个预览标签后标签仍残留、需要额外操作才能退出预览的问题 (#1038)。
• 修复附件参与上下文分析时，不同消息形态可能导致状态计算不一致的问题 (#1022)。

Features and Improvements

• 模型选择器会合并运行时配置中的主模型和 Haiku、Sonnet、Opus 等角色模型，并在重启后保持当前模型 (#1024)。
• 对话内查找新增面向虚拟化消息列表的定位桥接，可在大量历史消息中稳定查找并跳转。
• H5 文档补充无界面服务器构建和部署路径，发布流程会把 Web UI 产物包含进 Sidecar 构建 (#1027)。
• Proxy Trace 写盘与响应完成解耦，慢磁盘或大 Trace 不再阻塞用户看到最终回复 (#1014)。
• WebSocket 与会话服务增加后台任务终态的顺序写入、去重和旧格式兼容，多个观察端不会重复落盘同一通知。
• Windows 发布 smoke 增加安装进程检查、默认模式重装和旧目录数据恢复覆盖。

Issue 对照

• #1014：避免 Trace 写盘阻塞响应完成。
• #1019：限制 H5 无人连接的权限等待，并修复先断连后出现审批的竞态。
• #1022：统一附件参与上下文状态分析的格式。
• #1024：展示配置中的主模型和角色模型。
• #1027：补充无界面 H5 构建与发布产物。
• #1028 / #1029 / #1036：加固 Windows 覆盖升级、进程检查和旧数据恢复。
• #1030：使用权威 checkpoint 撤销目标轮次。
• #1032：在渲染器启动失败时显示可见错误。
• #1033 / #1054：稳定重启、恢复和上下文落盘。
• #1034：让中断的历史任务正确显示为已停止。
• #1038：保持最后一个预览标签可正常关闭。
• #1042：让原生预览跟随应用缩放和窗口边界。
• #1045 / #1057：稳定长对话搜索、结果刷新和滚动恢复。
• #1047：保留前台 Skill 输出并持久恢复后台 Agent 终态。
• #1049：限制 Sidecar 诊断消息内存占用。
• #1050 / #1056：处理系统代理连接重置并支持恢复后重试。
• #1051：拒绝工具后停止当前轮次，不再显示未执行的文件变更。

Verification

• 产品候选提交运行完整本地质量门：9 项通过、0 项失败；发布文件变更再次通过 desktop、native、docs 与 coverage 检查，并通过 49 项 release workflow、updater metadata 和 package-smoke 专项测试。
• macOS 真人业务验证从官方 v0.4.9 对照到本版本候选：原清单完成 46/83 步，其中旧版证据 14/29、新版验证 20/36、完整工作流 10/18，记录的问题均已复测关闭。
• 额外严格复测：拒绝 Write 后文件与 changed-files 均为 0；后台 Agent 完成后冷启动仍保持完成；H5 在提交后 328ms 断连，30 分 28 秒后首次重连时权限流已收敛、会话停止且目标文件不存在。
• Windows 安装、覆盖升级、系统代理和任务管理器资源观测仍需使用本 Release 生成的 Windows 安装包完成实机验证；Linux 无界面远程访问仍需独立 Linux 主机验证。未执行的平台步骤不计为通过。

Notes

• GitHub Release 正文以 release-notes/v0.4.10.md 作为唯一来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 继续保留本地开发用的 999.0.0-local。发布时必须确保版本号、Git tag v0.4.10 和本文件严格一致。
• Release Desktop workflow 会构建 macOS、Windows 和 Linux 的 x64 / ARM64 安装包，并在完整资产和 updater metadata 校验通过后公开 Release。
• 自动更新验证路径是正式 v0.4.9 -> v0.4.10。发布完成后需核对 latest-mac.yml、latest.yml、latest-linux.yml 和 latest-linux-arm64.yml。
• macOS 正式公开发布依赖签名和公证 secrets；Windows 未配置签名时仍可安装和自动更新，但可能显示 SmartScreen 提示。
• Windows 实机测试必须使用由 v0.4.10 Tag 生成的安装包，不能用 Tag 之前的候选构建代替。

安装

在本页面底部 Assets 中按系统和 CPU 架构下载：

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

macOS

双击 DMG，把应用拖入“应用程序”。正式签名和公证产物应直接通过正常 Gatekeeper 流程。

Windows

双击 .exe 安装。建议直接以当前用户运行，不要使用“以管理员身份运行”。覆盖升级前先完全退出应用；如果安装器报告相关进程仍在运行，请根据提示关闭对应进程后重试。未签名构建出现 SmartScreen 时可选择“更多信息”→“仍要运行”。

Linux

AppImage：

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

deb：

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

ARM64 机器请换用对应的 linux-arm64 文件。

Claude Code Haha v0.4.9

Claude Code Haha v0.4.9

这是 v0.4.8 之后的本地数据、搜索与网络兼容性版本，重点新增 SQLite 本地索引、未展开工作区文件搜索、跨平台内置 ripgrep 和本地附件打开操作，同时修复 OpenAI 兼容 Provider 的本地代理鉴权、系统代理动态路由、H5 触屏交互和文件预览连续行评论等问题。

相比 v0.4.8，本版本会把会话、活动统计、定时任务运行记录、Trace 和可搜索内容投影到可重建的本地数据库中，以减少重复扫描大量文件的开销。原始 JSON / JSONL 文件仍是权威数据源；索引损坏或不可用时会回退到文件读取，并可在「设置 → 诊断」中安全重建。

Highlights

• SQLite 本地索引：会话列表、全局搜索、活动统计、定时任务运行记录和 Trace 使用可重建的本地投影加速读取，启动后会持续对齐源文件，并在索引不可用时保留文件回退路径。
• 完整工作区文件搜索：文件面板可以直接搜索尚未展开或加载的目录，不再需要先手动展开目录树；搜索结果支持继续预览和加入聊天上下文。
• 内置跨平台 ripgrep：桌面安装包为 macOS、Windows 和 Linux 的 x64 / ARM64 架构准备对应 ripgrep，不再要求用户另行安装 rg 才能使用相关搜索能力。
• 动态系统代理路由：桌面端 AI 会话、OAuth、Provider 请求和适配器会按目标地址使用当前系统代理规则，兼容直连、HTTP(S) 与 SOCKS 路由，并避免把过期的启动时代理结果固定到整个运行周期。
• 附件与文件评审改进：聊天中的本地附件可以直接使用系统默认应用或“打开方式”菜单打开；文件预览支持按住 Shift 选择连续行并把整段评论带回聊天。
• H5 触屏体验优化：手机端会常驻显示消息操作，放大输入区关键按钮，并优化侧边栏、模型选择器、安全区和软键盘视口下的布局。

Fixes

• 修复升级到 v0.4.8 后，OpenAI 兼容的本地 API / vLLM Provider 可能因桌面代理鉴权环境未正确传递而持续返回 HTTP 401 的问题 (#1025)。
• 修复工作区文件必须先展开目录后才能被搜索到的问题；服务端现在直接搜索真实工作区，并对缺失、越界和过大结果提供明确状态 (#1023)。
• 修复打包版桌面端缺少 ripgrep 时文件与会话搜索不可用的问题，并把二进制、许可证和发布产物校验纳入离线构建流程 (#923)。
• 修复系统代理只在启动时按单一地址解析，导致代理规则变化或不同目标需要不同路由时，模型连接、OAuth 与 Provider 请求失败的问题 (#953)。
• 修复 H5 手机端 fork、复制等消息操作依赖 hover 才能显示，以及输入按钮偏小、侧边栏拥挤和软键盘遮挡内容的问题 (#1020)。
• 修复文件预览只能评论单行的问题；现在可用 Shift 连续选择同一侧的多行，并保留准确的行号、引用与输入框焦点 (#1004)。
• 修复全局搜索快速输入或使用中文输入法时，旧请求可能覆盖新结果、加载状态残留或方向键落到无效结果的问题。
• 修复本地索引建立期间或个别来源损坏时，会话、定时任务、团队、Trace 和活动统计可能短暂缺失的问题；相关读取会等待投影、自动恢复或回退到源文件。
• 修复桌面端重启后，历史会话仍在源目录但列表未能稳定恢复的问题，并补充索引状态、降级原因和重建入口 (#1016)。

Features and Improvements

• 新增 cc-haha/db/index-v1.sqlite 派生数据库，覆盖会话元数据与内容、活动统计、定时任务运行记录、团队会话和 Trace；支持增量追加、文件重写识别、删除同步、迁移和损坏恢复。
• 诊断页新增本地索引状态面板，可查看构建状态、已索引来源、降级来源、数据库 / WAL 大小、最后更新时间和错误代码，并可确认后重建索引。
• 全局搜索改为使用内容索引并支持取消过期请求、中文输入法组合态和每个会话的匹配预览；索引构建或降级时仍保留文件搜索能力。
• 工作区文件搜索使用打包内的 ripgrep，支持跨平台可执行文件准备、离线许可证 staging、sidecar 打包和发布产物 smoke 校验。
• 聊天中的本地附件增加直接打开与“打开方式”下拉菜单，可复用已配置的外部编辑器或系统默认应用；文件被移动或删除时会给出失败提示。
• H5 针对触屏设备增加更稳定的视口高度、底部安全区和软键盘状态处理，避免把桌面触屏设备误判为手机布局。
• 系统代理桥接会按每个目标地址解析 Electron 代理规则，并在桌面服务停止或重启时清理连接；对不可安全重放的模型 POST 请求不会跨代理规则重复发送。
• 本地索引增加一致性、奇偶校验、迁移、恢复和性能验收测试；索引数据库始终被视为可丢弃的派生数据，不取代用户的源会话与设置文件。

Issue 对照

• #923：在桌面安装包中内置跨平台 ripgrep，并补齐离线许可证与产物校验。
• #953：让 AI 会话和 Provider 请求动态遵循系统代理规则。
• #1004：支持在文件预览中用 Shift 选择连续行并添加评论。
• #1016：新增可恢复的本地会话索引、文件回退和诊断重建能力。
• #1020：让 H5 手机端消息操作常驻可用，并改善触屏输入布局。
• #1023：无需预先展开目录即可搜索完整工作区文件。
• #1025：恢复 OpenAI 兼容 Provider 在桌面本地代理链路中的鉴权。

Notes

• GitHub Release 正文继续以 release-notes/v0.4.9.md 作为来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 仍保留本地开发用的 999.0.0-local。发布时需确保 desktop/package.json、Git tag v0.4.9 和 release-notes/v0.4.9.md 三者严格对齐。
• 正式发布时，Release Desktop workflow 会校验 tag 与 desktop/package.json 版本一致，并加载 release-notes/v0.4.9.md。
• 自动更新依赖 GitHub Release 中完整的安装包、blockmap 和标准 updater metadata：latest-mac.yml、latest.yml、latest-linux.yml、latest-linux-arm64.yml。
• macOS 正式公开发布需要签名和公证 secrets；缺失时只能保留 draft/测试产物。Windows 签名不是发布阻塞项，但未签名安装包会触发 SmartScreen 提示。
• 本地索引仅保存可重建的派生数据。重建或删除索引不会删除原始对话、设置、Skills、记忆、定时任务或 Trace 源文件；索引降级时仍可使用文件回退。
• 桌面安装包已内置 ripgrep。CLI 或源码开发环境仍可使用系统 rg，但正式桌面搜索不再依赖用户手动安装。
• 发布前建议至少运行 bun run scripts/release.ts 0.4.9 --dry 和 bun run check:impact；正式 tag 前再运行 bun run verify，并执行一条 v0.4.8 -> v0.4.9 的真实自动更新 smoke，重点确认历史会话恢复、索引重建、完整工作区搜索、系统代理和本地附件打开。

安装

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

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

macOS

双击 DMG 把应用拖入“应用程序”。如果 macOS 签名和公证验证通过，首次打开应直接走正常 Gatekeeper 流程。

如果仍提示“已损坏”或“无法验证开发者”，说明当前产物可能仍是 unsigned fallback 或本地 quarantine 状态未清理，可在终端执行：

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

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

Windows

双击 .exe 安装。SmartScreen 提示时点“更多信息”→“仍要运行”。安装器会在删除旧版本前检查需要恢复的数据；如果检测到仍在运行的旧版应用或无法安全判断的数据目录，会保留旧版本和原数据并提示处理后重试。如果提示安装器权限过高，请直接双击运行，不要使用“以管理员身份运行”。

Linux

AppImage：

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

deb：

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

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

v0.4.8

Claude Code Haha v0.4.8

这是 v0.4.7 之后的桌面工作流、Provider 兼容性和安全加固版本，重点新增 Grok 官方 OAuth、Claude Code Auto 权限模式、内联 Diff 评审、对话导航和推理强度滑杆，同时修复 Windows 升级后数据目录丢失、断线重连后持续“思考”、受限端口启动失败和权限操作被遮挡等问题。

相比 v0.4.7，本版本让代码审阅、长对话定位和模型推理强度调整更直接；Windows 安装器会在升级前识别并保护旧安装目录中的用户数据，诊断与 Doctor 流程也补齐了脱敏、并发写入、损坏日志和安全修复边界。本地服务、H5 访问和远程预览进一步隔离，减少跨来源请求和预览页面获得桌面权限的风险。

Highlights

• Grok 官方登录：新增 xAI Grok 官方 OAuth 登录、token 刷新、动态模型目录和会话运行支持，内置 Grok 4.5 与 Composer 2.5 fallback，可直接在桌面端完成登录、选模和退出。
• Claude Code Auto 模式：权限选择器新增 Auto 模式，启用前会明确提示风险；运行时会审查工具调用和提示词注入，自动执行其认为安全的操作并阻止高风险操作。
• 内联 Diff 评审：工作台新增完整 Diff 审阅界面，支持语法高亮、旧/新行定位、单行或连续行评论，并把评论和代码引用带回聊天输入框。
• 对话与推理控制升级：长对话新增右侧导航目录；模型推理强度改为可拖动、可键盘操作的滑杆，并根据当前 Provider / 模型保留可用档位和会话选择。
• Windows 升级数据保护：NSIS 安装器会在卸载旧版本前识别、校验并恢复安装目录中的历史数据，避免服务商、会话、Skills、记忆或自定义数据目录随升级被移除。
• 桌面安全边界收紧：本地服务请求加入独立访问凭证，H5 / 反向代理流量与桌面可信流量分开判定；远程预览使用隔离 session，并默认拒绝摄像头、麦克风、通知等权限。

Fixes

• 修复 WebSocket 重连后遗留的 thinking 状态可能继续显示“已思考”并消耗 token 的问题 (#1002)。
• 修复 Markdown 预览或其他浮层可能遮挡权限操作按钮的问题，审批入口会保持可见 (#932)。
• 修复 Windows 等平台随机分配到浏览器受限端口后，桌面端或 H5 无法连接本地服务的问题 (#961)。
• 修复 Windows 升级可能删除安装目录内历史配置和会话数据的问题；恢复流程会校验来源、用户身份和复制结果，遇到歧义时停止安装而不是猜测迁移；没有旧目录数据的默认模式重装不会再被恢复保护误拦截 (#959, #973, #1000)。
• 修复 Auto 模式切换需要等待数秒、从跳过权限切换时可能触发额外重启，以及首次确认状态未正确保留的问题 (#978)。
• 修复 Diff 审阅中语法高亮、文件状态、行选择、折叠后选择失效和代码引用卡片丢失等问题，并让高亮效果更接近 Codex (#1004)。
• 修复长对话导航与输入框、消息内容和工作台面板之间的对齐、遮挡及窄窗口布局问题 (#782)。
• 修复推理强度弹层过大、选择未随会话恢复、切换模型后档位不匹配等问题 (#1007)。
• 修复诊断日志在并发写入、分段轮转或出现损坏记录时统计不准确、导出不稳定的问题；诊断包和 Issue 报告会尽力脱敏并限制内容范围。
• 修复 Doctor / runtime recovery 可能越过安全 UI 状态边界的问题；聊天历史、模型配置、Skills、MCP、IM 和 OAuth 等用户数据保持只读保护。
• 修复远程或带代理痕迹的请求可能被误判为本地可信请求，以及远程预览页面可能继承桌面 session 权限的问题。

Features and Improvements

• 新增 Grok 官方 Provider 设置页、浏览器 OAuth 回调与轮询、凭证安全存储、自动刷新、模型能力信息和 Provider 运行环境注入。
• Auto 模式贯通 CLI、桌面端、会话创建、WebSocket 恢复、权限分类器和持久化设置；活跃 turn 期间继续禁止切换权限，避免运行状态与界面选择不一致。
• 对话导航会从用户消息生成可扫描目录，支持快速跳转，并在靠近导航区域时提供更清楚的交互反馈。
• 工作台改为更紧凑的文件 / Diff 审阅布局，支持变更文件筛选、预览标签、文件状态、代码选择和评审评论引用。
• 推理强度滑杆支持鼠标拖动、点击选择、方向键、Home / End 和无障碍状态，并按不同模型暴露 low / medium / high 等实际支持档位。
• 诊断页新增更完整的保留策略、损坏记录提示、事件 ID、脱敏 Issue 报告、导出包和安全 UI 状态修复反馈。
• 合并社区安全加固 PR #1015，并继续补强 adapter、REST、WebSocket、Electron IPC 和 updater 的本地访问隔离测试。
• 发布 workflow 新增 Windows 历史数据恢复脚本自检，以及编译后安装器的全新安装 / 默认模式重装 smoke，确保安装包在发布前覆盖关键升级保护路径。

Issue 对照

• #782：新增长对话导航目录，并优化聊天区与输入框布局。
• #932：让权限操作在预览和浮层场景下保持可见。
• #959 / #973 / #1000：保护并恢复 Windows 旧安装目录中的用户数据。
• #961：避开浏览器会阻止访问的本地服务端口。
• #978：新增 Claude Code Auto 权限模式，并修复切换和确认流程。
• #1002：清理断线重连后遗留的 thinking 状态。
• #1004：新增并完善内联 Diff 评论与工作台审阅流程。
• #1007：新增推理强度滑杆，并恢复每个会话的实际选择。

Notes

• GitHub Release 正文继续以 release-notes/v0.4.8.md 作为来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 仍保留本地开发用的 999.0.0-local。发布时需确保 desktop/package.json、Git tag v0.4.8 和 release-notes/v0.4.8.md 三者严格对齐。
• 正式发布时，Release Desktop workflow 会校验 tag 与 desktop/package.json 版本一致，并加载 release-notes/v0.4.8.md。
• 自动更新依赖 GitHub Release 中完整的安装包、blockmap 和标准 updater metadata：latest-mac.yml、latest.yml、latest-linux.yml、latest-linux-arm64.yml。
• macOS 正式公开发布需要签名和公证 secrets；缺失时只能保留 draft/测试产物。Windows 签名不是发布阻塞项，但未签名安装包会触发 SmartScreen 提示。
• H5 或反向代理访问仍需显式开启并配置 Token / CORS；桌面内置预览不会把本地访问凭证发送给非本地服务来源。
• 发布前建议至少跑 bun run scripts/release.ts 0.4.8 --dry 和 bun run check:impact；正式 tag 前再运行 bun run verify，并执行一条 v0.4.7 -> v0.4.8 的真实自动更新 smoke，重点确认 Windows 用户数据完整保留。

安装

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

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

macOS

双击 DMG 把应用拖入“应用程序”。如果 macOS 签名和公证验证通过，首次打开应直接走正常 Gatekeeper 流程。

如果仍提示“已损坏”或“无法验证开发者”，说明当前产物可能仍是 unsigned fallback 或本地 quarantine 状态未清理，可在终端执行：

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

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

Windows

双击 .exe 安装。SmartScreen 提示时点“更多信息”→“仍要运行”。安装器会在删除旧版本前检查需要恢复的数据；如果检测到仍在运行的旧版应用或无法安全判断的数据目录，会保留旧版本和原数据并提示处理后重试。如果提示安装器权限过高，请直接双击运行，不要使用“以管理员身份运行”。

Linux

AppImage：

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

deb：

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

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

Claude Code Haha v0.4.7

Claude Code Haha v0.4.7

这是 v0.4.6 之后的模型兼容性和桌面稳定性版本，重点新增 GPT-5.6 模型支持和页面内查找，同时修复长任务停滞、并发权限请求、后台任务生命周期、Claude Resume 会话发现、定时任务重复输出和跨平台窗口打开等问题。

相比 v0.4.6，本版本进一步收紧长时间运行会话的恢复链路和权限交互边界；OpenAI 官方登录可发现并选择 GPT-5.6 系列模型，Kimi K2.7 会自动满足其 thinking 要求，技能市场和会话活动面板也完成一轮视觉与交互优化。

Highlights

• GPT-5.6 模型支持：OpenAI 官方登录新增 GPT-5.6、GPT-5.6 Pro 和 GPT-5.6 Codex 模型目录、选择和迁移支持，并补齐模型元数据与会话恢复链路。
• 长任务恢复更可靠：长时间运行的 turn 在流式传输或 WebSocket 中断后能更准确地区分可恢复与已完成状态，避免界面长期停留在运行中或丢失最终 assistant 输出。
• 权限交互更安全：同一会话中的并发权限请求会分别保留和响应；活跃 turn 期间禁止切换权限模式，避免运行时权限状态与界面选择不一致。
• 后台任务生命周期补齐：后台任务支持更明确的停止、完成和活动面板状态同步，减少任务结束后仍显示 running 或无法停止的问题。
• 桌面工作流继续收敛：新增 Ctrl/Cmd+F 页面内查找；Claude Resume 能发现桌面会话；从 Explorer 打开目录时不会再让已有窗口意外隐藏。

Fixes

• 修复长时间运行的模型响应在 watchdog、重试、WebSocket 重连或 assistant commit 边界上可能卡住的问题，补齐可恢复事件和最终消息提交保护。
• 修复多个 permission / AskUserQuestion 请求同时到达时，后一个请求覆盖前一个请求或响应路由错误的问题。
• 修复会话仍在运行时可以切换权限模式的问题；现在 selector 会保持禁用并给出明确提示。
• 修复后台任务停止后状态未及时同步、活动面板缺少终止入口或任务结束后仍残留 running 状态的问题 (#990)。
• 修复桌面 API 定时轮询重叠导致重复请求、过期响应覆盖新状态或会话列表刷新异常的问题 (#993)。
• 修复定时任务完成输出被重复写入会话的问题 (#989)。
• 修复桌面主题设置影响 Claude CLI 输出主题的问题，应用主题与 CLI 配置重新隔离 (#987)。
• 修复 Kimi K2.7 在未显式开启 thinking 时请求失败的问题，该模型现在会自动使用必需的 thinking 配置 (#986)。
• 修复 Claude Resume 无法发现桌面创建的会话，以及 session 文件结束写入未及时 flush 的问题 (#988)。
• 修复从 Explorer 打开目录时复用窗口参数导致已有窗口被隐藏的问题 (#983)。
• 修复更新请求错误继承 provider proxy、安装更新时 quit-and-install 异常，以及 About 页面版本布局不正确的问题。
• 修复 Mermaid label 中斜杠等字符可能破坏节点形状，以及活动摘要过早显示省略号的问题。
• 修复会话活动入口显示无意义计数 badge、token 用量最长任务时长被截断的问题。

Features and Improvements

• OpenAI 官方 provider 新增 GPT-5.6 系列模型目录、能力信息、模型选择分组和旧设置迁移。
• 新增页面内查找弹窗，可使用 Ctrl+F / Cmd+F 打开并在当前页面结果间跳转 (#974)。
• 技能市场重新整理搜索、筛选、卡片、详情、安装状态、安全提示、来源状态和免责声明布局，改善窄窗口与暗色主题下的可读性。
• 会话活动面板优化 SubAgent、后台任务和状态信息的展示，并移除容易误导的活动数量 badge。
• 欢迎语调整为“构建、调试和设计”，更准确地覆盖桌面工作台的使用场景。
• PR 质量门禁改进确定性测试路由、provider/chat contract、覆盖率和隔离环境，减少真实配置或外部网络对 CI 证据的影响。

Issue 对照

• #974：新增 Ctrl/Cmd+F 页面内查找。
• #983：修复从 Explorer 打开目录时已有窗口被隐藏。
• #986：为 Kimi K2.7 自动启用必需的 thinking 配置。
• #987：隔离桌面应用主题与 Claude CLI 输出主题。
• #988：让 Claude Resume 可以发现桌面会话，并确保 session 数据及时落盘。
• #989：修复定时任务输出重复写入。
• #990：补齐后台任务停止和状态同步。
• #993：阻止桌面 API 轮询重叠和过期响应覆盖。
• #997：支持 GPT-5.6、GPT-5.6 Pro 和 GPT-5.6 Codex。

Notes

• GitHub Release 正文继续以 release-notes/v0.4.7.md 作为来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 仍保留本地开发用的 999.0.0-local。发布时需确保 desktop/package.json、Git tag v0.4.7 和 release-notes/v0.4.7.md 三者严格对齐。
• 正式发布时，Release Desktop workflow 会校验 tag 与 desktop/package.json 版本一致，并加载 release-notes/v0.4.7.md。
• 自动更新依赖 GitHub Release 中完整的安装包、blockmap 和标准 updater metadata：latest-mac.yml、latest.yml、latest-linux.yml、latest-linux-arm64.yml。
• macOS 正式公开发布需要签名和公证 secrets；缺失时只能保留 draft/测试产物。Windows 签名不是发布阻塞项，但未签名安装包会触发 SmartScreen 提示。
• 发布前建议至少跑 bun run scripts/release.ts 0.4.7 --dry 和 bun run check:impact；正式 tag 前再运行 bun run verify，并执行一条 v0.4.6 -> v0.4.7 的真实自动更新 smoke。

安装

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

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

macOS

双击 DMG 把应用拖入“应用程序”。如果 macOS 签名和公证验证通过，首次打开应直接走正常 Gatekeeper 流程。

如果仍提示“已损坏”或“无法验证开发者”，说明当前产物可能仍是 unsigned fallback 或本地 quarantine 状态未清理，可在终端执行：

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

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

Windows

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

Linux

AppImage：

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

deb：

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

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

Claude Code Haha v0.4.6

Claude Code Haha v0.4.6

这是 v0.4.5 之后的桌面功能和稳定性版本，重点新增技能市场和会话活动面板，同时补齐 TeamoRouter 供应商、更新流程、便携数据目录、终端、输出风格本地化、浏览器 zoom、高 DPI 预览和 provider stalled stream 诊断等问题。

相比 v0.4.5，本版本让用户可以直接在桌面端发现、预览、安装和管理第三方技能；也把会话中的任务、后台任务、SubAgent 和团队活动集中到右侧活动面板，减少主聊天区噪音并提升多 Agent 工作流可见性。

Highlights

• 技能市场上线：新增桌面端技能市场，聚合 ClawHub 与 SkillHub，支持搜索、筛选、分页、详情、文件预览、安装确认、卸载和已安装状态识别。
• 技能安装更保守：市场安装链路补齐风险标签、扫描摘要、来源状态、免责声明和不可确认风险阻断，避免把上游不完整或高风险结果误展示成安全可装。
• 会话活动面板：新增右侧活动面板，集中展示 tasks、background tasks、SubAgent、team activity 和 sources；SubAgent 运行可进入独立详情页查看。
• Agent 工作流更清楚：SubAgent 活动行加入本地头像和状态，工具调用组默认折叠，并在流式更新中保留用户手动展开/折叠状态。
• 更新与正式发布更稳：公开 release 会先保持 draft，等全平台安装包、blockmap 和 latest*.yml 更新元数据上传并校验完成后再发布，降低自动更新拿到不完整资产的风险。
• Provider 和平台补齐：新增 TeamoRouter provider 预设；provider 流式响应卡住时增加 watchdog 诊断；浏览器 zoom、高 DPI 坐标和 Windows/macOS/Linux 发布资产继续收敛。

Fixes

• 修复检查更新流程中重复检查可能清空待安装更新的问题；如果重启安装没有让桌面端退出，UI 会恢复到可操作状态 (#797)。
• 修复正式 GitHub Release 可能在 updater 资产未完整上传前公开的问题；现在会先创建 draft，完整校验发布资产和标准更新元数据后再取消 draft。
• 修复更换数据存储位置后，窗口状态等 best-effort 写入失败可能导致权限错误持续弹出的问题；写入失败会被捕获并反馈到设置状态 (#949)。
• 修复 Terminal 设置页重复触发 terminal runtime 启动，导致命令行出现两行的问题，并补齐 stale async start 的销毁保护 (#964, #967)。
• 修复 General -> 输出风格中内置选项名称和说明没有按当前语言本地化的问题 (#966)。
• 修复内置浏览器 zoom/scale 在高 DPI 下坐标和交互区域不稳定的问题，缩放控件改为浮在预览区右下角，避免被 native WebContentsView 覆盖 (#952)。
• 修复 provider 流式响应中途停住时缺少明确诊断的问题，新增分阶段 watchdog 和更稳定的桌面 WebSocket 错误码。
• 加固 Telegram adapter 命令处理和桌面导航 guard，减少异常输入或外部跳转带来的风险。
• 修复技能市场搜索、详情预览、fallback 缓存、主题色、loading 状态和卡片风险文案中的若干边界问题。

Features and Improvements

• 新增技能市场 API 和桌面端 Market 页面，支持 ClawHub / SkillHub 聚合、来源健康状态、远程详情、文件内容预览和分页加载。
• 新增技能市场安装服务，安装前会展示风险摘要和确认弹窗，安装后能识别本地已安装状态。
• 技能市场新增第三方技能免责声明、安全徽章、确定性技能头像、多语言文案和暗色主题适配。
• 新增会话活动面板和活动模型，把 Todo/task summary、后台任务、SubAgent 通知、team member 和 sources 统一整理成可扫描的侧边信息。
• 新增 SubAgent run 详情页和相关 API，支持从活动面板打开 SubAgent 输出、状态和 token/duration 信息。
• 新增 TeamoRouter provider 预设，默认模型映射到 claude-opus-4-8、claude-sonnet-5、claude-haiku-4-5，并在 README 赞助商区域加入 TeamoRouter 入口 (#994)。
• 发布 workflow 继续校验 macOS ARM64/x64、Windows x64/ARM64、Linux x64/ARM64 的安装包、blockmap 和 updater metadata。
• Windows 签名仍为非阻塞 warning；未签名 Windows 安装包仍可更新，但用户可能会看到 SmartScreen 提示。
• 非 draft 的公开 macOS release 现在要求签名和公证 secrets；缺失时会阻止发布，避免自动更新和 Gatekeeper 拿到不合格正式产物。

Issue 对照

• #797：修复检查更新和发布资产公开顺序，降低自动更新拿到不完整 release 的风险。
• #949：修复更换数据存储位置后的写入权限错误处理。
• #952：补齐内置浏览器 zoom/scale 的高 DPI 和控件覆盖问题。
• #964 / #967：修复 Terminal 重复启动导致命令行出现两行。
• #966：修复输出风格说明文案未本地化。
• #994：新增 TeamoRouter provider 预设和赞助商入口。

Notes

• GitHub Release 正文继续以 release-notes/v0.4.6.md 作为来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 仍保留本地开发用的 999.0.0-local。发布时需确保 desktop/package.json、Git tag v0.4.6 和 release-notes/v0.4.6.md 三者严格对齐。
• 正式发布时，Release Desktop workflow 会校验 tag 与 desktop/package.json 版本一致，并加载 release-notes/v0.4.6.md。
• 自动更新依赖 GitHub Release 中完整的安装包、blockmap 和标准 updater metadata：latest-mac.yml、latest.yml、latest-linux.yml、latest-linux-arm64.yml。
• macOS 正式公开发布需要签名和公证 secrets；缺失时只能保留 draft/测试产物。Windows 签名不是发布阻塞项，但未签名安装包会触发 SmartScreen 提示。
• 如果下载更新后桌面端没有自动退出重启，可以手动重启应用完成安装。
• 发布前建议至少跑 bun run scripts/release.ts 0.4.6 --dry、bun run verify；如果 GitHub Actions hosted runner 恢复，可先手动触发 draft Release Desktop 验证全平台资产。

安装

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

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

macOS

双击 DMG 把应用拖入「应用程序」。如果 macOS 签名和公证验证通过，首次打开应直接走正常 Gatekeeper 流程。

如果仍提示"已损坏"或"无法验证开发者"，说明当前产物可能仍是 unsigned fallback 或本地 quarantine 状态未清理，可在终端执行：

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

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

Windows

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

Linux

AppImage：

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

deb：

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

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

Claude Code Haha v0.4.5

Claude Code Haha v0.4.5

这是 v0.4.4 之后的稳定性、provider/proxy 兼容性、桌面工作流和 Windows ARM64 补丁版本，重点修复模型连接、权限模式、首轮 provider 生效、历史会话时间、sidecar 内存、浏览器预览缩放、Markdown 安全和 release smoke 中暴露出来的问题。

相比 v0.4.4，本版本让 OpenAI-compatible provider 默认走更明确的直连 proxy 模式，避免系统代理或 sidecar 代理环境影响模型连接；同时补齐 reasoning effort 透传、experimental beta 开关、默认会话权限设置、/model 快捷切换、Skill 命令历史恢复、Windows ARM64 启动和 package-smoke 识别。

Highlights

• Provider/proxy 连接更稳：provider 请求默认使用 direct proxy mode，只有显式选择 System proxy 时才继承系统代理；第三方 API 返回的 model 与请求模型 ID 不一致时，不再把上下文窗口误显示为 200000；reasoning effort 会正确透传到 proxy transform。
• 权限和首轮会话行为更准确：新增默认会话权限模式设置，bypassPermissions 会跳过可跳过的审批而保留显式 deny 和必须交互的工具；干净安装后添加 provider 的第一轮提问会先应用 active provider runtime，再发起 prewarm 和 user message。
• 历史会话和列表性能继续收敛：历史会话排序不再被 metadata-only 写入刷新成“刚刚更新”；会话时间展示统一为更稳定的月日时分格式；非 Git 项目不会因为新会话 git-info 探测拖慢；最近项目和会话列表加载路径继续减少重复扫描。
• 桌面聊天细节更干净：完成后的 turn duration 系统行不再持久化到 transcript；/model 能打开模型选择器；用户输入的 Skill command 会在恢复、WebSocket replay 和搜索中保留；自动 Dream task 卡片不再进入聊天内容噪音。
• 预览、布局和安全补齐：内置浏览器新增 zoom/scale 控制，并把缩放同步到 Electron WebContentsView；工作区面板恢复可向右缩小；Markdown 渲染会阻止 <style> 标签和 inline style 注入全局 UI。
• Windows ARM64 和 release smoke 更可靠：Windows ARM64 桌面启动、sidecar 超时诊断、release workflow 和 package-smoke 识别补齐；桌面 live smoke 会等待恢复后的项目 chip，再开始输入，降低误建默认 home session 的概率。

Fixes

• 修复 v0.4.4 中 provider 连接仍受系统代理或 sidecar 代理环境影响的问题，默认 provider 请求改为 direct proxy mode，并补齐 provider connectivity 和 OpenAI-compatible proxy 的网络设置测试 (#953, #896)。
• 修复推理强度没有作为模型调用入参透传的问题，OpenAI Chat/Responses proxy transform 会传递 reasoning effort (#905)。
• 修复干净安装后添加 provider、不点击测试就首次提问时，第一轮可能没有应用 active provider runtime 而一直思考的问题 (#844)。
• 修复第三方 API 响应里的 model 与请求 modelId 不一致时，session context window 展示异常的问题。
• 修复最高权限跳过模式下仍要求审批运行的问题；现在 bypassPermissions 会跳过 approval ask，同时保留明确拒绝和必须用户交互的工具约束 (#910)。
• 修复 /model slash command 无法打开模型选择器的问题 (#909)。
• 修复用户输入的 Skill command 在 session restore、WebSocket replay 或 session search 中被隐藏的问题 (#926)。
• 修复自动 Dream task 生命周期卡片进入聊天 transcript、任务状态残留 running 的问题 (#887)。
• 修复完成后的 turn duration 消息被持久化为系统 transcript 行的问题。
• 修复 /clear 后 header/sidebar 仍保留旧 message count 的问题。
• 修复模型输出中的 <style> 标签或 inline style 可以影响桌面 Markdown 渲染样式的问题 (#904)。
• 修复读取非 PDF 文件时模型误传 pages 参数导致 Invalid pages parameter 错误循环的问题 (#928)。
• 修复 Claude Code sidecar 在大 transcript 下内存压力过高的问题，减少 trace/message polling 路径重复 hydrate 大 session 文件 (#933)。
• 修复项目路径含中文或非 Git 项目时，git-info 探测可能拖慢新会话或打开外部编辑器的问题 (#908)。
• 修复历史会话查看时 metadata-only 写入导致“最近更新”时间被刷新为刚刚的问题 (#951)。
• 修复查看更新和消息操作时间显示不稳定的问题，现在统一显示更明确的月日时分。
• 修复会话中最近项目列表加载慢的问题，并在会话变化时失效 recent project cache。
• 修复新建会话未执行、关闭后留下无效 untitled session 的问题。
• 修复工作区面板只能向左拖大、不能向右缩小的问题 (#940)。
• 修复 Windows 11 ARM64 上桌面启动错误，并补齐 ARM64 sidecar/native 文件和 unpacked package-smoke 识别 (#954)。

Features and Improvements

• 新增 General settings 里的默认会话权限模式设置，新建桌面 chat session 会使用该默认值，同时保留 per-session 覆盖能力。
• Provider 设置新增 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 兼容开关，可对第三方 API 通道禁用 experimental beta headers，并隔离 stale parent env (#929)。
• 内置浏览器新增 per-session zoom/scale 控制，缩放会同步到 preview bridge、Electron WebContentsView、截图和标注坐标 (#952)。
• Release/package smoke 覆盖 Windows ARM64 产物识别、当前平台 package smoke 和 release workflow 元数据边界，降低发版前平台产物漏检风险。
• Session restore、search 和 WebSocket replay 的 command metadata 处理统一，继续隐藏异常 command breadcrumb，同时保留用户真实输入的 Skill command。
• Trace/session message signature、recent project cache 和桌面 smoke 等跨表面路径补齐 post-release semantic conflict 的回归保护。

Issue 对照

• #844：修复干净安装后首次提问未正确应用 active provider runtime。
• #887：隐藏自动 Dream task 聊天卡片，并修复 Dream task 生命周期收尾。
• #904：阻止 assistant Markdown 注入 <style> 或 inline style。
• #905：透传 reasoning effort 到 provider/proxy 模型调用。
• #908：限制 git-info 探测，降低中文路径或非 Git 项目的卡顿风险。
• #909：修复 /model 无法打开模型选择器。
• #910：修复 bypass permission mode 下仍要求审批。
• #926：恢复用户输入的 Skill command 历史展示。
• #928：非 PDF 文件忽略 pages 参数，避免 Read 工具错误循环。
• #929：新增 experimental beta kill switch。
• #933：降低 sidecar transcript 内存压力。
• #940：修复工作区面板无法向右缩小。
• #951：修复历史会话查看后更新时间被刷新。
• #952：内置浏览器新增 zoom/scale 机制。
• #953 / #896：修复 provider 连接受代理环境影响的问题，默认走 direct proxy mode。
• #954：支持 Windows ARM64 桌面启动和发布产物 smoke。

Notes

• GitHub Release 正文继续以 release-notes/v0.4.5.md 作为来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 仍保留本地开发用的 999.0.0-local。发布时需确保 desktop/package.json、Git tag v0.4.5 和 release-notes/v0.4.5.md 三者严格对齐。
• 本版本覆盖 desktop、server、provider/runtime、agent-loop、native 和 release 多个表面；发布前建议至少跑 bun run scripts/release.ts 0.4.5 --dry 和 bun run verify，并在有真实 provider 配额时跑 bun run quality:gate --mode release --allow-live --provider-model <provider:model[:label]>。
• 建议发布前额外 smoke：OpenAI-compatible provider 直连和 System proxy 模式、reasoning effort、experimental beta 开关、干净安装首次 provider 提问、默认权限模式、bypass permission、/model、Skill command 恢复、Dream task drawer、Read 非 PDF、历史会话时间、最近项目列表、浏览器 zoom、Markdown style 注入、Windows ARM64 启动和 macOS 签名 DMG 首次打开。
• 如果需要先验证全平台签名/公证产物，可以手动触发 Release Desktop workflow 并保持 draft=true；正式发布仍以 v0.4.5 tag 对应提交和 GitHub Actions 产物为准。

安装

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

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

macOS

双击 DMG 把应用拖入「应用程序」。如果 macOS 签名和公证验证通过，首次打开应直接走正常 Gatekeeper 流程。

如果仍提示"已损坏"或"无法验证开发者"，说明当前产物可能仍是 unsigned fallback 或本地 quarantine 状态未清理，可在终端执行：

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

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

Windows

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

Linux

AppImage：

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

deb：

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

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

Claude Code Haha v0.4.4

Claude Code Haha v0.4.4

这是 v0.4.3 之后的稳定性和桌面体验补丁版本，重点修复后台任务、Goal 续跑、预热启动、provider/proxy、Trace、设置隐私、浏览器预览和 Windows 窗口行为中的真实使用问题。

相比 v0.4.3，本版本让后台 Agent 任务在前台回答结束后仍可见，减少任务通知回灌到模型或桌面 transcript 的噪音；同时修复 session 预热竞争、历史会话误预热、CLI-only provider proxy、loopback proxy、MCP secret 展示、Trace 删除和 provider 预设更新等问题。

Highlights

• 后台任务和 Goal 续跑更可靠：后台任务在前台 turn 完成后继续显示，并进入更清晰的 background task drawer；Goal 自动续跑会插入可见分隔标记，避免多个 assistant turn 混在一起；task-notification-only follow-up 不再污染桌面 transcript。
• 启动、预热和会话刷新更稳：修复 prewarm_session 与 user_message 几乎同时到达时 idle timer 杀掉活跃 CLI 的竞争；查看历史会话不会触发预热；Electron sidecar 会等 /health 真正可用后再继续；session list summary 加缓存，降低大历史列表刷新超时概率。
• Provider/proxy 链路更兼容：CLI-only OpenAI-compatible provider 会启动轻量 standalone provider proxy，不再依赖固定 localhost server；loopback provider target 会绕过系统代理和 Bun proxy fetch options；provider connectivity check 覆盖 IPv4/IPv6 loopback；直连 provider trace 会正确记录脱敏 headers。
• 桌面工作流细节补齐：Settings tab、provider 表单保存、空会话 composer draft、active turn 计时、cache token usage、长标题 tooltip、手动刷新按钮、浏览器预览导航和 preview-agent edit bubble 都更稳定。
• 设置和诊断更安全：MCP 设置页会遮蔽敏感 command args、env 和 headers，同时保存时保留原始值；MCP server name 支持 Unicode 字母和数字；Trace 列表新增本地 trace session 删除，并明确不会删除聊天历史。

Fixes

• 修复 session 预热 idle timer 在 CLI 启动盲窗内杀掉活跃用户 turn，导致桌面一直卡在“执行中”的问题 (#865)。
• 修复查看历史 transcript 时误触发 CLI prewarm，只加载历史不再启动新 CLI (#880)。
• 修复首次 onboarding 期间启动前预检 Anthropic/OAuth endpoint，导致未登录或未发起模型请求前就访问外部服务的问题 (#859)。
• 修复停止或中断后可能出现 API Error: Stream ended without receiving any events 的处理路径。
• 修复 scheduled task 超时、scheduled subprocess 权限参数、title generation auth、并行 tool card settlement 的一组问题 (#809, #846, #847, #854, #889)。
• 修复 provider 表单保存中的取消/重复提交竞态、Settings tab 返回后丢失，以及切换项目时空会话 composer draft 丢失 (#810, #811, #871)。
• 修复同一 session 打开新的 native browser preview target 时 WebContentsView 停留在旧文件，以及 preview-agent edit bubble 在低位置选区时超出视口的问题 (#819, #879)。
• 修复 active turn duration 计时丢失、完成后轻量 duration 行显示不稳定，以及 queued follow-up 与完成状态行位置冲突的问题 (#813, #853)。
• 修复 CLI-only OpenAI-compatible desktop provider 依赖固定本地 server proxy 的问题，并修复代理环境下 loopback provider target/connectivity check 被错误走代理的问题 (#845, #896)。
• 修复后台 sync Agent 工具活动没有走统一 parent-tagged 事件、incomplete tool-use stream 缺少 fallback，以及结构化本地 Agent terminal notification 回灌模型的问题 (#870, #884, #886)。
• 修复 EnterPlanMode 暴露模型内部指令、ExitPlanMode rejected tool card 显示空计划卡，以及 Windows frameless 窗口首次显示后拖拽命中区不刷新的问题 (#869, #874)。
• 修复桌面 session 列表手动刷新可能被后台 pending fetch 长时间禁用或显示 spinner 的问题 (#893)。
• 修复粘贴图片 FileReader 延迟回调在发送或切换 session 后重新污染输入框的问题 (#827)。
• 修复 Electron sidecar 只等 TCP accept、不等 HTTP /health ok 就继续启动的问题 (#857)。
• 修复 OpenAI-compatible sampling params 默认透传过多，以及 GLM-5.2 context metadata 缺失的问题 (#860)。
• 修复长 sidebar title 没有完整 tooltip 的问题 (#885)。
• 修复 MCP server name 只能使用 ASCII 名称的问题，现在支持 Unicode 字母和数字，同时继续拒绝空格和分隔符。
• 修复 MCP 设置页可见 UI/input 中泄露敏感 args、env 和 headers 的问题。
• 修复 direct provider trace 从 Request input 传入 headers 时没有持久化脱敏 headers 的问题 (#836)。
• 修复 live session header 没有计入 cache read/write tokens 的问题 (#842)。
• 修复 Goal hook evaluator 抛错时被当作非阻塞 hook error，导致 goal loop 提前停下的问题。
• 修复 Goal hook 的 preventContinuation 和 blockingError 分开返回时被误判为普通停止，导致 goal 中途停止的问题 (#895)。
• 修复 Goal continuation turn 在 session history 和桌面恢复中没有明确视觉分隔的问题 (#901)。
• 修复国内 provider 预设、model context window 和 thinking capability 声明落后的问题。

Features and Improvements

• Trace 列表新增删除入口，支持幂等删除本地 trace JSONL，并清理 trace read cache；确认弹窗会说明聊天历史不会被删除 (#868)。
• 背景任务展示升级为官方风格 background task drawer，前台完成后仍保留任务进度，恢复后的 Agent 不会因为清理旧完成项而消失。
• Goal 自动续跑新增 Goal continuing 本地命令分隔标记，并贯穿 server events、session history 和 desktop history restore。
• Provider settings JSON 导入支持 cc-switch 风格模型配置：从 ANTHROPIC_MODEL 或 Sonnet fallback 推导 main model，把 *_MODEL_NAME 作为显示标签处理。
• Provider 预设更新国内模型和 context window 声明，补齐相关 runtime/env、thinking 和 conversation-service 测试覆盖。
• Session list summary 按 JSONL 文件 mtime/size 缓存，降低大历史目录下 /api/sessions?limit=400 的重复扫描成本 (#894)。

Issue 对照

• #809 / #846：修复 scheduled task timeout 配置和调度启动行为。
• #810：修复 provider 表单保存过程中的取消和重复提交问题。
• #811：修复 Settings tab 返回后丢失当前页签。
• #813 / #853：修复 active turn duration 和完成状态展示。
• #819 / #879：修复 native browser preview 导航和 preview-agent edit bubble 位置。
• #827：修复发送后延迟粘贴图片回到 composer。
• #836：修复 OpenAI proxy/direct provider trace request headers 记录。
• #842：修复 live session cache token usage 展示。
• #845：修复 CLI-only OpenAI-compatible provider proxy。
• #847：修复 scheduled task subprocess 权限参数。
• #854：修复 title generation auth strategy。
• #857：修复 Electron sidecar readiness 判断。
• #859：修复 onboarding 前 Anthropic/OAuth preflight。
• #860：修复 OpenAI-compatible sampling params 和 GLM-5.2 context metadata。
• #865：修复 prewarm idle timer 与 user message 竞争。
• #868：新增 Trace session 删除。
• #869：优化 plan mode 桌面展示，并隐藏空 rejected plan preview。
• #870 / #884 / #886：修复后台 Agent continuation、stream fallback 和任务通知回灌。
• #871：修复空会话 composer draft 在项目切换后丢失。
• #874：修复 Windows frameless 窗口拖拽命中区。
• #880：修复查看历史会话误预热。
• #885：修复长 session title 缺少完整 tooltip。
• #889：修复 unresolved parallel tool card settlement。
• #893：修复 session list 手动刷新按钮卡住。
• #894：缓存 session list summaries，降低刷新超时风险。
• #895：修复 Goal 中途停止。
• #896：修复 loopback provider proxy bypass 和 provider connectivity check。
• #901：Goal continuation turn 增加桌面可见分隔。

Notes

• GitHub Release 正文继续以 release-notes/v0.4.4.md 作为来源。
• 桌面端发布版本号来源是 desktop/package.json；root package.json 仍保留本地开发用的 999.0.0-local。发布时需确保 desktop/package.json、Git tag v0.4.4 和 release-notes/v0.4.4.md 三者严格对齐。
• 本版本覆盖 desktop、server、provider/runtime、agent-loop 和 native 多个表面；发布前建议至少跑 bun run scripts/release.ts 0.4.4 --dry 和 bun run verify，并在有真实 provider 配额时跑 bun run quality:gate --mode release --allow-live --provider-model <provider:model[:label]>。
• 建议发布前额外 smoke：后台 Agent task drawer、Goal 自动续跑、task notification 输出抑制、历史会话打开、空会话切项目、provider connectivity check、loopback provider、Trace 删除、MCP secrets redaction、native browser preview、Windows frameless 拖拽、macOS 签名 DMG 首次打开和自动更新 metadata。
• 如果需要先验证全平台签名/公证产物，可以手动触发 Release Desktop workflow 并保持 draft=true；正式发布仍以 v0.4.4 tag 对应提交和 GitHub Actions 产物为准。

安装

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

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

macOS

双击 DMG 把应用拖入「应用程序」。如果 macOS 签名和公证验证通过，首次打开应直接走正常 Gatekeeper 流程。

如果仍提示"已损坏"或"无法验证开发者"，说明当前产物可能仍是 unsigned fallback 或本地 quarantine 状态未清理，可在终端执行：

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

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

Windows

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

Linux

AppImage：

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

deb：

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

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