HRouter Desktop v0.4.2

HRouter Desktop v0.4.2

修复 HRouter Key 快速配置中 Claude Desktop 模型映射不透明、默认推荐旧版本的问题。

• 模型绑定界面分别展示「客户端模型 ID」「上游模型 ID」「菜单显示名」，支持添加、删除和手动修改映射。
• 兼容的 Claude 模型默认使用同名客户端 ID，不再把新版 Haiku 隐藏映射为 Haiku 4.5，或把旧版 Opus 套用为 Opus 5。
• 从当前 Key 实际返回的模型列表按版本号推荐 Sonnet / Opus / Haiku，不再取接口列表中第一个匹配项；不会后台自动升级已保存的选择。
• 客户端 ID 与上游不一致时显示提醒，并提供「使用同名客户端 ID」入口，保留上游模型、显示名和上下文声明。
• 打开编辑和重新导入列表均保留手动映射；主动点击「按已导入列表重新推荐」才会替换编辑器中的映射，保存后生效。
• 默认模型未包含在旧映射中时明确提醒补齐或重新选择，不静默替换；保存前检查空值、客户端 ID 格式和重复 ID。
• 增加推荐排序、编辑与保存、默认模型、配置写入和请求转发回归测试。

注意：同名映射修复的是 HRouter 配置错配，不保证每个模型均提供五档思考强度。思考菜单仍取决于已安装的 Claude Desktop 对模型 ID 的识别及上游能力。已有用户可进入 HRouter 供应商编辑页，检查映射后保存并应用，再重启 Claude Desktop。

安装包目标：Windows x64（EXE）和 macOS Apple Silicon（M 系列，DMG；不支持 Intel Mac）。发布流程检查双平台构建、macOS Developer ID 签名与 Apple 公证，以及自动更新清单和签名后才公开版本。

English:

• Exposes editable Claude Desktop client IDs, upstream IDs and display labels in HRouter Key setup, with route creation/removal and explicit mismatch warnings.
• Preserves compatible Claude IDs by default instead of silently assigning older Haiku or newer Opus identities to a different upstream model.
• Recommends the highest numeric version available to the key, independent of API ordering, without automatically upgrading saved selections.
• Preserves manual mappings, display labels and context flags across editing/import; offers explicit same-ID repair and recommendation reset actions.
• Detects missing default-model routes, rejects blank/invalid/duplicate IDs, and adds frontend/backend regression tests for exact-ID configuration and request handling.
• Matching IDs do not guarantee a particular thinking-effort menu; support still depends on the installed Claude Desktop client and upstream model capabilities.
• Targets Windows x64 and signed/notarized macOS Apple Silicon packages. Publication is gated on CI, platform builds and updater validation.

HRouter Desktop v0.4.1

HRouter Desktop v0.4.1

补齐 Claude Desktop 本地会话读取，修复用量组件 Agent 切换与速度展示，并完善 macOS / Windows 双平台兼容。

• macOS / Windows 浮窗新增 Agent 下拉切换，记住自己的显示选择，不改变工作台或供应商线路。
• macOS 14+ 原生小组件支持右键 → 编辑小组件 → Agent，每个组件独立选择；多个 Agent 快照隔离并在后台同步，macOS 12/13 保留跟随应用模式。
• 生成速度与 Key 吞吐量分开显示；无计时不再以 0 tok/min 替代测速，空闲吞吐明确标注。超过 5 分钟仍可查看今日上次实测速度与时间；直连日志无法提供的耗时不会被推算或伪造。
• 会话管理新增 Claude Desktop 来源，支持 Code、Cowork 和本地 Chat 的查看、搜索与筛选。
• 兼容 Claude、Claude-3p 和命名配置目录；支持新旧 UUID / 短目录结构，以及 Desktop 与 Claude Code 共享的会话日志，避免重复展示。
• Windows 覆盖 Roaming、Local 和两种商店版 MSIX 数据目录；兼容中文、空格、UNC 路径和 CRLF 日志。
• 缺少正文时回退到会话审计日志或初始消息；损坏、过大的元数据和越界路径会被跳过，不递归读取插件、挂载项目或凭据。
• Desktop 会话保持只读，继续或删除请在原客户端完成；普通云端聊天和尚未落地本机的远程正文不在本地读取范围内。
• 保留切换 Codex 供应商时本机的沙箱、插件、Skills 和配置档设置，修正相关集成测试与本地配置保护行为的一致性。
• 增加双平台目录发现、路径格式、只读安全和界面回归测试。

安装包目标：Windows x64（EXE）、macOS Apple Silicon（M 系列，DMG；不支持 Intel Mac）。三平台 CI 和双端构建均已通过；macOS 安装包已完成 Developer ID 签名与 Apple 公证，两端自动更新签名已验证。

English:

• Adds independent Agent switching to the floating monitor on macOS/Windows and per-widget Agent configuration on macOS 14+, with isolated background-synced snapshots.

• Separates generation speed from rolling Key throughput, identifies idle windows, and keeps the day's last real speed measurement with its timestamp. Direct-connection logs without timing remain unavailable.

• Adds read-only Claude Desktop Code, Cowork and local Chat history, with dedicated filtering and shared-transcript deduplication.

• Supports macOS and Windows data directories, including third-party profiles, shortened session layouts, both Windows MSIX package families, Unicode/UNC paths and CRLF logs.

• Falls back to audit logs or initial-message metadata when full transcripts are unavailable. Does not access cloud-only conversations or account credentials.

• Preserves local Codex sandbox, plugin, skill and profile settings when switching providers, and updates the integration regression coverage.

• Targets Windows x64 and signed/notarized macOS Apple Silicon packages. Both platform builds and three-platform CI have passed; updater signatures have been verified.

HRouter Desktop v0.4.0

HRouter Desktop v0.4.0

专注接入，保持干净。这个版本将重构后的 Agent 工作台合入主分支，HRouter 集成回归 API Key 快捷配置。

• 全新顶部导航与 Agent 工作台：统一配置中心、接入方案、线路策略、用量统计、会话、MCP 和 Skills 的操作入口。
• 移除内置 HRouter 平台登录、账户管理、充值、订单、云端密钥管理、公告、平台账单及后台余额轮询。
• 保留无需登录的 HRouter Key 快捷配置：输入已有 Key、发现模型、调整模型映射，再保存到所选 Agent；支持任意兼容供应商，不强制使用 HRouter。
• 本地用量和费用估算、供应商级用量查询、桌面组件继续保留；macOS 小组件不再读取旧平台账户余额摘要。
• 完善多 Agent 配置、接入方案、模型主备线路与配置保护；支持 Pi Agent、DeepSeek Harness、WorkBuddy 等轻量接入。
• 修复 Codex 切换供应商后旧会话无法恢复的问题：在运行时配置中维护受标记的旧 provider 别名，不改写会话历史、不覆盖用户自定义同名配置。
• 旧平台页面会自动回到工作台；升级不要求删除原有供应商、API Key 或本地配置。
• 更新 README 和真实桌面截图；截图中的敏感信息已遮盖。

安装包：Windows x64（EXE）、macOS Apple Silicon（仅 M 系列，DMG；不支持 Intel Mac）。macOS 安装包经 Developer ID 签名与 Apple 公证；自动更新清单包含 Windows x64 与 macOS Apple Silicon 的签名。Windows 的自动更新签名不等同于 Authenticode 签名。

费用统计是本地估算，不是服务商实际账单。代理、配置写入和不同 Agent 的支持范围请参阅仓库文档；付费接口测试需用户明确启用。

English:

• A redesigned, local-first agent workbench with provider profiles, routing, usage, sessions, MCP, and Skills.
• Removes the embedded HRouter account portal, payments, orders, announcements, and cloud billing. Keeps optional, sign-in-free API-key quick setup.
• Preserves local usage, provider-level usage queries, and agent widgets; improves Codex legacy-session resume compatibility without rewriting chat history.
• Ships Windows x64 and Developer ID-signed, notarized macOS Apple Silicon (M-series only) installers, with signed Windows x64 and macOS arm64 updater entries. Intel Macs are not supported.

HRouter Desktop v0.3.1

HRouter Desktop v0.3.1

• 修复“最近切换快照”与 Windows / WSL 配置卡片贴在一起的问题，并统一主备线路、费用与账单页面的卡片间距。
• 修复设置“关于”页在宽窗口中偏到右侧的问题；内容与设置标签左对齐，版本信息保持在可视区域。
• 调整设置页顶部留白、窄窗口标签宽度、图标收缩和长路径换行。
• 保留 v0.3.0 的全部接入工作台功能与兼容性边界。本次为界面布局补丁，不改变配置写入和计费逻辑。

验证：类型检查、19 项相关前端测试和生产构建通过；内置浏览器验证 800 / 1280 / 1920 像素窗口布局。浏览器验收针对渲染布局，原生配置操作仍以桌面端为准。

macOS 安装包在签名、公证完成后追加，请以实际附件为准。

English:

• Fixes spacing between workbench cards and keeps the About page aligned with Settings tabs on wide windows.
• Improves narrow-window sizing, icon stability, and long-path wrapping. No changes to configuration writes or billing behavior.

HRouter Desktop v0.3.0

HRouter Desktop v0.3.0

• 新增免登录接入工作台：统一接入官方预设、自建端点和第三方中转，支持只读预览并导入 CC Switch 供应商；HRouter 快捷接入继续保留。
• 新增 Claude Code / Codex 接入体检：模型目录、普通响应、流式、工具调用及工具结果续接。真实模型请求需主动勾选，最多四次，按供应商规则计费。
• 新增 Lite 模式、提示词保护及仅供应商同步；支持切换前差异预览、配置快照和冲突检测，保留本机自定义配置。
• 新增按模型配置主备线路、多 Key 额度查询；修复托盘手动切换导致自动故障转移关闭的问题。额度仅在用户确认独立后按相同单位汇总。
• 新增 Windows / WSL 独立配置目标：每个环境选择目录和供应商，预览实际文件后部署；部署到本机目录时同步更新当前供应商。
• 改善 Codex 模型发现配置，提供可选的会话兼容和标准 HTTP 传输设置。
• 修正 Codex 部分子会话漏统计、Claude 1 小时缓存写入估价、历史用量清理后重复累计；提供备份后的 OpenCode 用量重建入口。
• 明确区分本地费用估算与 HRouter 服务端实际消费，支持按日期和 Key 核对；新工作台界面提供简体中文、繁体中文、英文和日文。

使用说明与范围：

• 老用户仍进入上次页面，可从侧栏打开“接入工作台”。Lite、配置保护、兼容选项均需主动开启。
• WebDAV / S3 仅供应商同步应在每台设备启用对应设置，并使用支持该模式的版本及独立远端目录；旧客户端不能读取该模式的快照。
• 跨站续聊不能恢复仅存在旧服务器上的上下文，也不保证不同模型的工具能力一致。Windows / WSL 功能要求目标目录已存在且可访问，不会自动启动 WSL。
• 历史重复统计需要主动重建；已删除的原始日志或缺少缓存 TTL 的旧记录无法准确还原。本地费用仍为估算，不是服务端扣费凭证。
• macOS 安装包会在签名、公证完成后追加到本版本；请以页面实际附件为准。

English:

• Adds a login-free, multi-provider workbench with CC Switch import, opt-in connection diagnostics, Lite mode, protected configuration switching, and provider-only sync.
• Adds per-model primary/backup routes, independent environment targets, quota queries, and local/server billing comparison; improves failover, model discovery, and usage accounting.
• Compatibility features have explicit limits. Historical repairs require remaining source logs; local cost estimates are not provider charges. See the workbench guide and issue acceptance checklist in the repository.

HRouter Desktop v0.2.15

HRouter Desktop v0.2.15

• 重新整理 Codex 一键推荐映射：仅推荐 GPT-5.5、GPT-5.6 Luna / Terra / Sol 三个独立档位，以及 GPT-6 Astra，不再混入 GPT-5.4、音频、图片等其他模型。
• 修复 GPT-5.6 三个档位被合并的问题；选择其中一个档位作为默认模型时，其他档位仍会保留。
• 在供应商编辑和 Key 导入中新增“一键推荐映射”按钮，可主动将旧的杂项映射替换为推荐列表，并自动填写清晰的显示名称。
• 仅使用当前 Key 实际返回的可用模型，缺失档位不虚构；保留可用默认模型及其别名，避免重复映射。
• 区分已读取模型总数与当前映射条数，普通刷新继续保留手动修改。

升级后，在 HRouter 的供应商编辑页面点击“一键推荐映射”并保存；Key 导入页面点击后需确认导入。保存 Codex 配置后，请完全退出并重启 Codex，以加载新的模型目录。

HRouter Desktop v0.2.14

HRouter Desktop v0.2.14

• 开放 Codex 模型映射编辑：供应商设置和 Key 一键导入均可新增、删除模型项，修改显示名称与实际模型 ID，支持从完整模型列表选择或手动填写别名。
• 四个模型系列仅作为初始推荐，不再限制用户自定义目录；保存和再次编辑时保留已有映射及模型能力配置。
• 修复重新获取模型覆盖手动映射的问题；获取模型失败时，仍可保存手动填写的有效配置。
• 同步默认模型输入框、config.toml 编辑器和保存目录，拦截空白或重复的实际模型 ID。
• 修复点击模型候选下拉按钮可能意外提交表单的问题。

升级后可在 HRouter 的供应商编辑或 Key 一键导入中调整模型映射。保存 Codex 配置后，请完全退出并重启 Codex，以加载新的模型目录。

HRouter Desktop v0.2.13

HRouter Desktop v0.2.13

• 精简 HRouter 的 Codex 模型选择与映射：默认保留 GPT-5.4、GPT-5.5、GPT-5.6、GPT-6 四个系列，每个系列选择当前 Key 实际可用的一个模型，保留手动指定的默认模型。
• 修复思考强度只剩“关闭／高”的问题，恢复多档等级配置；有对应 Codex 模型能力信息时，优先保留该模型完整的原生档位。
• 为缺少模型能力信息的路由提供兼容配置选项，实际接受的思考等级以对应上游服务为准。

升级后请在 HRouter 中重新保存 Codex 供应商配置，再完全退出并重启 Codex，使模型目录和思考等级生效。

HRouter Desktop v0.2.12

HRouter Desktop v0.2.12

• 修复 HRouter 导入 Codex 后新模型未进入 /model 列表的问题；现在会把密钥返回的全部模型写入模型目录，可直接选择 GPT-6 Astra。

HRouter Desktop v0.2.11

HRouter Desktop v0.2.11

• 新增原生 macOS 桌面小组件，可展示 HRouter 今日用量、剩余余额和更新时间，支持小号与中号布局。
• 修复使用记录分页栏被挤到应用窗口底部之外的问题，列表滚动时分页栏保持可见。
• 完善 macOS 发布签名检查，确保主程序与 WidgetKit 扩展使用相同 Team ID 和 App Group。