v0.2.8 · 启动时检查更新，结果即时显示

v0.2.8 让助手一启动就检查 Claude 和助手的新版本，检查进度和结果即时显示，概览页新增助手更新提示。

改进

• 启动助手时自动检查更新。
  • 结果超过 1 小时才重新查询，反复打开助手不会频繁请求 GitHub；助手运行期间仍每天检查一次。
  • Claude 与助手各按自己的上次检查时间判断，手动检查过的一项不会被立刻重复查询；上次查询失败的一项 10 分钟后即可重试。
  • 仍受“自动检查更新”开关控制，发现新版本只提示，不自动安装。
• 检查结果即时显示。 后台检查完成后界面立即刷新，不再等最多 1 分钟；正在查询的一项显示“正在检查更新…”，它的“检查更新”按钮暂不可用。
• 概览页新增助手更新提示，可直接前往设置页更新。Claude 与助手的更新提示都可点“稍后”暂时收起，下次启动助手再提示；导航上的小红点保留。

修复

• 官方更新覆盖汉化后，概览“中文界面”一行的“汉化”不再重复，现在显示“官方更新覆盖了之前的本地界面汉化”。

下载与升级

• Windows x64：下载 claude-windows-cn.exe 和同名 .sha256，或在助手设置页检查更新。
• macOS Apple Silicon / Intel：下载对应 .app.tar.gz 及 .sha256，解压后运行 Claude 中文助手.app。macOS 继续以预览包提供，使用 ad-hoc 本地签名，没有 Apple Developer ID 签名或公证。

验证范围

• 检查时机（启动与每日门槛、失败重试、时钟回拨）由单元测试覆盖；前端的延后刷新、刷新失败清理和监听清理经过隔离验证，并经过独立审阅。
• 真实网络下的后台检查与 WebView 事件时序未做实机验证；macOS 改动只经过原生 CI 构建与测试。

改动 PR：#11。

发布验证记录

CI 40097087913 的 Windows x64、macOS ARM64、macOS x64 均已通过测试、生产构建与程序自检。附件来自这次 CI；构建提交 5e830ae 与合并提交 5dbb18c 的 Git 源码树完全一致。

下载后三平台附件的 SHA256 和 0.2.8 版本号均已复核；Windows 发布附件再次通过本地 --self-test。

v0.2.7 · 便携版数据随程序保存，减少磁盘占用

v0.2.7 让 Windows 便携版把数据保存在程序目录，同时减少助手的磁盘占用，并在卸载时彻底清除助手数据。

改进

• Windows 便携版数据随程序保存。
  • 设置、缓存和日志保存在程序目录下的 data 文件夹，不再占用系统盘；整个文件夹可以移动到别处继续使用。
  • 从旧版升级后首次启动时，自动接管原 %LOCALAPPDATA%\ClaudeWindowsCN 中属于这份便携版的设置、汉化记录和日志，然后删除旧目录。安装包等缓存不迁移，需要时重新下载。
  • 程序目录无法新建文件时，继续使用原位置。用户安装和系统安装不变。
• 减少磁盘占用。
  • 官方 Claude 安装包只保留目标版本，汉化引擎缓存只保留当前版本。
  • 汉化、恢复和关闭 Claude 成功后删除本次临时目录；失败时只保留最近 2 次的日志。
  • Windows 自更新后删除下载的新版程序，下次启动删除回退备份。
• 启动时清理旧版本遗留的安装包、引擎缓存和临时目录。 清理不会进入数据目录下的链接；存在未完成汉化记录时保留全部引擎日志。

调整

• 卸载助手会一并删除整个助手数据目录（设置、缓存、日志、汉化记录）和助手创建的 Claude Desktop 桌面快捷方式，完成后助手退出。
  • Claude Desktop 本身及其个人数据保留。
  • 卸载不会恢复汉化；需要英文界面，请先在助手中“恢复原样”再卸载。

下载与升级

• Windows x64：下载 claude-windows-cn.exe 和同名 .sha256，或在助手设置页检查更新。
• macOS Apple Silicon / Intel：下载对应 .app.tar.gz 及 .sha256，解压后运行 Claude 中文助手.app。macOS 继续以预览包提供，使用 ad-hoc 本地签名，没有 Apple Developer ID 签名或公证。

验证范围

• Windows：
  • 缓存清理、卸载和便携数据由隔离目录中的子进程测试覆盖，包括目录联接与别名路径、只读回退、复制中断后重试、移动或复制便携文件夹，并经过多轮独立审阅。
  • 卸载在发布构建的隔离沙箱中实际运行过。
  • 维护者用发布构建在本机完成了旧数据接管。
• macOS：缓存清理和卸载的改动只经过原生 CI 构建与测试，未做实机验收；便携数据仅适用于 Windows。

改动 PR：#9、#10。

发布验证记录

CI 40061536612 的 Windows x64、macOS ARM64、macOS x64 均已通过测试、生产构建与程序自检。附件来自这次 CI；构建提交 8640330 与合并提交 ba8e540 的 Git 源码树完全一致。

下载后三平台附件的 SHA256 和 0.2.7 版本号均已复核；Windows 发布附件再次通过本地 --self-test。

v0.2.6 · 布局与导航细节优化

v0.2.6 优化窗口拉宽或最大化时的布局，并修正导航与概览中的几处显示问题。本次只改动界面，安装、汉化、更新等逻辑不变。

改进

• 窗口最大化或拉宽时，内容保持在 720px 宽的居中栏内，顶栏与内容对齐；概览中的 Claude Desktop 卡片最高 300px，不再撑出大片空白。默认窗口尺寸下的布局不变。
• 安装页和启动页隐藏导航页签，不再显示三个无法点击的灰色页签。
• 导航页签增加悬停反馈；待处理小红点不再挤动页签位置，读屏软件也能读出提示文字。

修复

• 未安装 Claude 时，概览“应用更新”一行会显示“尚未检查最新版本 · N 分钟前检查”等自相矛盾的文字和禁用按钮。现在显示“安装 Claude 后可检查更新”，并隐藏无法使用的按钮。
• 修正“汉化已被官方更新覆盖”提示中多余的空格。

下载与升级

• Windows x64：下载 claude-windows-cn.exe 和同名 .sha256，或在助手设置页检查更新。
• macOS Apple Silicon / Intel：下载对应 .app.tar.gz 及 .sha256，解压后运行 Claude 中文助手.app。macOS 继续以预览包提供，使用 ad-hoc 本地签名，没有 Apple Developer ID 签名或公证。

验证范围

• 本地 Windows：前端 lint/build 通过；用模拟后端在 Edge（与 WebView2 同引擎）中逐页截图核对浅色/深色、默认/最大化/最小窗口，以及安装、启动、概览、汉化、设置、执行和确认框等状态。
• 维护者已在本机审核本次构建的界面。
• 未在真实 Claude 环境中重跑安装、汉化恢复或助手自更新流程（本次未改动这些逻辑）；未覆盖 Mac 实机验收。

改动 PR：#8。

发布验证记录

CI 39953981955 的 Windows x64、macOS ARM64、macOS x64 均已通过测试、生产构建与程序自检，Mac 包的本地签名校验也通过。附件来自这次 CI；构建提交 441e962 与合并提交 4579969 的 Git 源码树完全一致。

下载后三平台附件的 SHA256 和 0.2.6 版本号均已复核；Windows 发布附件再次通过本地 --self-test。

v0.2.5 · 适配新版汉化引擎，修复任务栏图标

v0.2.5 修复最新上游引擎导致的汉化失败（#6），统一为本地界面汉化，并修复 Windows 任务栏图标。

修复

• 上游移除 Disable-FridaResidentForDiskInstall 后，旧助手会在脚本适配阶段报错。现在允许已完全移除的旧功能缺席，旧引擎中仍存在的该功能继续禁用；关键接口检查保留。
• 新版 Windows 引擎已移除 PatchMode 参数。现在按脚本实际声明构造调用参数，兼容新旧引擎。
• Windows 主窗口显式设置任务栏大图标，解决任务栏显示通用程序图标的问题。

汉化范围与界面

• 移除“完整汉化”，只保留第三方 API 模式的本地界面汉化。官方账号已支持中文，可直接在 Claude 的语言设置中切换。
• 旧版记录与备份继续用于恢复原样；重试、手动重应用和更新后自动汉化统一使用本地界面汉化。
• 汉化说明与操作按钮集中到同一面板；汉化页和设置页沿用柔和暖色，移除冗余小字。
• README 同步真实适用范围、自动重应用开关的行为及 Issue #6 的处理方式。

下载与升级

• Windows x64：下载 claude-windows-cn.exe 和同名 .sha256，或在助手设置页检查更新。
• macOS Apple Silicon / Intel：下载对应 .app.tar.gz 及 .sha256，解压后运行 Claude 中文助手.app。macOS 继续以预览包提供，使用 ad-hoc 本地签名，没有 Apple Developer ID 签名或公证。
• 遇到 #6 的用户无需清除引擎缓存或删除旧备份，升级助手后重新应用即可。

验证范围

• 本地 Windows：前端 lint/build、Rust fmt/check 通过；Rust 42 项通过、3 项原有真实安装/联网测试忽略；Python 8 项通过，包括真实上游 Mac 脚本的导入与参数检查。
• 真实新旧 Windows 引擎适配检查通过，用户已确认本地界面汉化成功；实际窗口的任务栏图标探针读到正确的 256px 图标。
• 发布附件由三平台原生 CI 生成；详情见下方发布验证记录。
• 未覆盖 Mac 实机安装、汉化恢复、权限及 Cowork 交互验收，也未重跑从已发布版本出发的完整助手自更新流程。

修复 PR：#7。问题反馈：#6。

发布验证记录

CI 39925422426 的 Windows x64、macOS ARM64、macOS x64 均已通过测试、生产构建与程序自检，Mac 包的本地签名校验也通过。附件来自这次 CI；构建提交 bbea620 与合并提交 e7df3e4 的 Git 源码树完全一致。

下载后三平台附件的 SHA256 和 0.2.5 版本号均已复核；Windows 发布附件再次通过本地 --self-test。

v0.2.4 · 修复助手自更新版本显示，重新设计概览

v0.2.4 修复助手自更新后仍显示旧版本、反复提示安装同一版本的问题，并重新设计概览页。

修复

• 助手自更新成功后，设置里仍显示旧版本号，还会继续提示安装同一个版本。原因有两个：替换程序时没有同步安装记录 install.json 里的版本，“有新版本”的缓存也是按旧程序的版本算出来的。现在更新时会同时写入安装记录和卸载项里的版本，并按当前运行的程序版本判断是否有更新。
• 已经遇到这个问题的用户，换到 0.2.4 后，下次启动时安装记录会自动更正。

改进

• 概览重新设计：Claude Desktop 单独成一张卡片，图标在左，「打开 Claude」按钮在右，卡片会填满剩余空间，不再在底部留下大片空白。出现更新提示时卡片会自动收紧。
• 状态卡片每一行加了图标。
• 概览去掉了页面标题和详细信息行。需要诊断信息时，可以在汉化未完成的核查卡片里复制。

下载

• Windows x64：下载 claude-windows-cn.exe 及同名 SHA256，也可以在助手 设置 页检查更新。从 0.2.3 及更早版本自更新到这个版本时，旧程序仍可能短暂显示旧版本号；新版本启动后会自动更正。
• macOS Apple Silicon / Intel：分别下载对应的 .app.tar.gz 预览包及 SHA256。仍然只做了 ad-hoc 本地签名，没有经过 Apple Developer ID 签名或公证。

验证范围

• 本次 CI 的 Windows x64、macOS ARM64、macOS x64 测试、生产构建和程序自检均通过。附件来自这次运行，它的源码树与 v0.2.4 标签完全一致。
• 本地 Windows：前端 lint/build、Rust fmt/check 通过，Rust 测试 39 项通过。1 项 Job Object 测试在本地因为需要管理员权限没能运行，CI 中通过。Windows 附件的 SHA256、版本号（0.2.4）和程序自检均已核对。
• 新增测试覆盖了两点：缓存的更新标记会按当前版本重新判断；用真实的替换脚本跑一遍后，新版本会写入 install.json，而且写入的文件不带 BOM，可以直接读取。
• 概览页用模拟数据在浅色、深色、有/无更新提示、窗口较矮和较窄等情况下检查过。
• 未覆盖：从已发布的 Release 走完一次完整的助手自更新，以及在 Mac 实机上验收。

v0.2.3 · 设置页签与更新后自动重新汉化

v0.2.3 把设置改为页签，通过助手更新 Claude 后会自动重新应用汉化，界面整体优化，并修复快捷方式图标偏小的问题。

新增

• 通过助手更新 Claude 后，自动重新应用之前的汉化模式（设置中可关闭）。关闭时，概览和汉化页会提示"汉化已被官方更新覆盖"，可一键重新应用。Windows 上重新汉化可能请求管理员授权。
• 下载官方安装包时可取消，并清理未完成的临时文件；进度显示下载速度。
• 汉化未完成时显示核查卡片，可直接打开助手数据目录、复制诊断信息。
• 概览改为紧凑的状态卡片，卡片内可展开详细信息（包名、安装位置、备份状态）；更新状态显示上次检查时间。
• 助手有新版本时显示 Release 更新说明摘要；页签显示待处理小红点；后台发现新版本且窗口不在前台时闪烁任务栏。
• 跟随系统的深色模式。

改进

• 设置从弹框改为与「概览」「汉化」并列的页签：分组卡片，开关切换后显示"已保存"，卸载助手单独放在底部。
• 切换汉化模式时，确认框说明会先恢复当前模式再应用新模式，并列出两种模式的覆盖差异。
• Windows 标题栏新增最大化/还原按钮，关闭按钮悬停变红；macOS 改用系统红绿灯按钮。
• 键盘焦点样式、开关动画、复制日志后的"已复制"反馈。

修复

• Claude 桌面快捷方式改用官方满幅应用列表图标，原图标取自留白约 50% 的开始菜单磁贴图，显示偏小。已创建的快捷方式在 设置 → 桌面快捷方式 → 创建或修复 后更新。
• Windows：旧版 .NET 让 PowerShell 默认使用 SSL3/TLS 1.0 时，为助手更新检查补充 TLS 1.2；系统默认协商的环境保持不变。

下载

• Windows x64：下载 claude-windows-cn.exe，附同名 SHA256；也可在助手 设置 页检查更新。
• macOS Apple Silicon / Intel：分别下载对应 .app.tar.gz 预览包及 SHA256。仍采用 ad-hoc 本地签名，未经过 Apple Developer ID 签名或公证。

验证范围

• 本次 CI 的 Windows x64、macOS ARM64、macOS x64 测试、生产构建和程序自检均通过。附件来自该次运行，其源码树与 v0.2.3 标签完全一致。
• 本地 Windows：前端 lint/build、Rust fmt 通过，Rust 测试 37 项通过；Windows 附件 SHA256 校验、版本号与程序自检通过。快捷方式图标已用本机官方 Claude 资源核对各尺寸满幅。
• 界面改动以模拟数据在浅色、深色和最小窗口宽度下检查。
• 未覆盖：真实 Claude 更新过程中的自动重新汉化与取消下载、macOS 原生标题栏与新增后端的 Mac 实机验收。自动化检查不能替代这些验证。

v0.2.2 · 修复签名校验与汉化失败阻断

v0.2.2 修复 macOS 签名校验参数及 Windows 首次汉化权限失败后的永久阻断，对应 #1、#2。

修复

• macOS：为 codesign 的内联 requirement 表达式补上前导 =，保留 Anthropic 签名身份校验。
• Windows：提权与目标权限检查通过、即将执行汉化引擎时才写入未完成记录，避免取消 UAC 或权限准备失败后无法重试。引擎开始执行后的失败仍保留回滚保护。
• Windows：汉化页显示实际记录和备份路径，README 补充 v0.2.1 遗留阻断的核查步骤。

下载与恢复

• Windows x64：下载 claude-windows-cn.exe，附同名 SHA256；也可通过助手检查更新。
• macOS Apple Silicon / Intel：分别下载对应 .app.tar.gz 预览包及 SHA256。仍采用 ad-hoc 本地签名，未经过 Apple Developer ID 签名或公证。
• 旧版已留下的 patch-pending.json 不会自动删除。请按 恢复说明 核查；不要删除整个助手数据目录或原始文件备份。

验证范围

• 本次 CI 的 Windows x64、macOS ARM64、macOS x64 测试、生产构建和程序自检均通过；Mac 双架构新增的原生 codesign 回归测试通过，应用包通过签名检查。
• 本地 Windows Rust 测试 37 项通过、3 项既有独立测试跳过；前端 lint/build、Rust fmt/check 通过。
• Windows 隔离回归验证权限准备失败不留阻断记录、引擎执行失败保留记录、已有记录不被覆盖。
• 真实 Claude 的完整汉化往返、Windows UAC 交互及 macOS Cowork 业务验收仍未完成，自动化检查不能替代这些验证。

v0.2.1 · 修复 Windows 升级残留进程占用

v0.2.1 修复 Windows 官方 Claude Desktop 升级时，主窗口已退出但仍提示应用占用、要求重启的问题。

修复

• 更新、汉化及恢复前，清理目标 Claude 包的 Windows Job 中残留的当前用户、当前会话子进程，包括主进程退出后留下的 git.exe / conhost.exe。
• 逐个验证实时 Job 成员身份、用户和会话，并通过同一进程句柄结束进程，防止 PID 复用误杀。不按 Git 进程名批量关闭，不停止 Appinfo 系统服务。
• 保留已校验的官方下载包和完整错误日志，剩余占用错误不再直接要求重启 Windows。

下载与更新

• Windows x64：下载 claude-windows-cn.exe；附同名 .sha256 摘要。
• v0.2.0 用户可通过助手检查更新；0.1.x 用户请退出旧助手，用新版 EXE 手动替换原安装目录中的同名文件。
• macOS Apple Silicon / Intel 功能未变，继续提供预览包及 SHA256；仍未经过 Apple Developer ID 签名或公证，真实 Claude / Cowork 交互验收范围沿用 v0.2.0。

验证

• Windows 本地 Rust 测试 36 项通过；3 项需单独运行的既有测试保持忽略。cargo check、fmt、前端 lint/build 通过。
• 新回归测试使用真实的隔离 Windows Job：旧关闭逻辑留下孤儿进程，修复后可清理；无关进程、其他包、用户/会话不匹配和非成员 PID 均受保护，并覆盖无 Job 与重复关闭。
• 现场问题在结束旧 Claude Job 残留进程后已由用户确认升级成功。新版自动清理通过隔离回归验证，未重新降级真实 Claude 做升级往返测试。
• 三个平台的 CI 测试、生产构建与程序自检通过；macOS 包通过 ad-hoc 签名校验。

v0.2.0 · 双端支持与仓库更名（macOS 预览）

v0.2.0 继续提供 Windows x64 正式版，并首次提供 macOS Apple Silicon / Intel 预览包。Mac 功能实现与 Windows 对齐，真实 Claude 与 Cowork 的交互验收尚未完成。

下载

平台	文件	状态与要求
Windows x64	claude-windows-cn.exe	正式版；需要 WebView2 Runtime
macOS Apple Silicon	claude-cn-macos-arm64.app.tar.gz	预览版；macOS 13+
macOS Intel	claude-cn-macos-x64.app.tar.gz	预览版；macOS 13+

每个包均附同名 .sha256 摘要。macOS 解压后运行 Claude 中文助手.app；汉化与恢复需要 Python 3.9+，可通过 python.org 或 Homebrew 安装，助手不会自动安装该依赖。

变化

• 新增 macOS 后端：Claude 检测、安装、更新、启动，两种汉化与恢复，助手便携/用户/系统安装、桌面入口、自更新、卸载和每日更新检查。
• 仓库更名为 chrichuang218/claude-desktop-cn，新版仅使用新仓库更新源，不兼容旧更新源；Windows 文件名、应用标识和配置目录保持不变。
• 合并双端共享逻辑、重复测试和旧布局样式，更新提示直接读取助手状态。本轮精简净删 203 行，未增加依赖，保留既有安装、校验和恢复功能。

验证范围

Windows x64、macOS arm64 和 x64 已通过原生 CI 的自动测试、生产构建和程序自检；Mac 包通过本地代码签名及 SHA256 校验。前端精简前后 128 组页面状态的截图与计算样式一致，更新提示及对话框键盘交互检查通过。

macOS 附件为预览版。 尚未完成真实 Claude 安装更新、汉化恢复、权限授权、Cowork、助手自更新和运行中卸载的交互验收。预览包只有 ad-hoc 本地签名，没有 Apple Developer ID 签名与公证，Gatekeeper 可能阻止首次打开或要求系统授权。详细范围见 macOS 验收清单。

从旧版更新

0.1.x 用户请退出旧助手，下载 v0.2.0 的 claude-windows-cn.exe，手动替换助手安装目录中的同名文件。原安装路径和配置保留，无需卸载 Claude Desktop。此后新版助手只接受新仓库的更新附件。

v0.1.2 · 窗口比例与设置弹窗优化

修复

• 不同电脑保持接近的界面比例：以 736×576 为基准，启动时根据实际显示缩放和 Windows 文字大小调整窗口，避免重复计算 DPI。
• 窗口不超出屏幕工作区：计算时包含边框并居中显示，保留用户后续手动调整窗口的自由。
• 概览更紧凑：内容行不再平分多余高度，避免大窗口下留白过多。
• 设置弹窗更易使用：减少留白，固定标题和关闭按钮；空间不足时仅正文滚动。

下载

下载 claude-windows-cn.exe，运行环境为 Windows x64 和 WebView2 Runtime。已安装用户可在助手设置中检查更新。

附件提供 claude-windows-cn.exe.sha256，可用 PowerShell 的 Get-FileHash .\claude-windows-cn.exe -Algorithm SHA256 核对。许可及第三方归属见 LICENSE.txt 和 THIRD_PARTY_NOTICES.md。

验证

已通过缩放尺寸回归、界面多尺寸检查、构建和程序自检。本机 Windows 122% 文字大小下，主界面比例接近基准，包含更新按钮和成功提示的设置内容完整显示；极端放大时窗口仍不超出屏幕工作区。