安装
| 平台 | 格式 |
|---|---|
| Windows | .msi 安装包 |
| macOS (Apple Silicon) | .dmg 磁盘映像 |
| Linux | .deb / .AppImage |
- Windows 首次安装可能触发 SmartScreen 提示，点击"仍要运行"继续
- macOS 应用未经 Apple 签名/公证，首次打开可能提示"已损坏"或"无法验证开发者"
macOS 安装说明
如果已拖入"应用程序"目录，执行：
xattr -cr /Applications/CLI-Manager.app
open /Applications/CLI-Manager.app也可以在 Finder 中右键应用图标，选择"打开"，或在"系统设置 → 隐私与安全性"中点击"仍要打开"。
变更日志
Codex 项目级供应商切换
- Codex 项目级供应商切换：支持对
cli_tool = "codex"的项目选择app_type = "codex"供应商；项目级覆盖写入 CLI-Manager 自身的provider_overrides，不再误写项目.codex/config.toml。 - 启动时自动注入 Codex profile：为选中的 Codex 供应商生成
$CODEX_HOME/cli-manager-*.config.toml，内部终端启动codex项目时自动追加--profile，并通过 PTY 环境变量注入密钥，避免把 secret 落盘到 profile 或命令行。 - 生成 profile 自动清理：当项目恢复跟随全局、删除项目或更换供应商后，CLI-Manager 会清理未再被任何项目引用的
cli-manager-*.config.toml，但不会删除用户自己维护的 Codex profile。 - 项目树供应商徽标恢复：Claude 与 Codex 的项目级供应商徽标统一走
providerBadges数据流，项目树重新显示对应厂商 SVG，不再退化成纯文字标签。
终端分屏
- 分屏 Pane 全屏/还原：多 Pane 布局下每个 Pane 标签栏新增全屏按钮，点击后当前 Pane 进入与沉浸式全屏一致的放大状态；再次点击缩小按钮可恢复进入前的分屏布局，Pane 位置与比例保持不变。#56
历史用量分析
- 历史统计图表迁移到 Recharts：历史用量分析看板的 Token/费用趋势、Token 构成、项目排行、模型排行、来源对比、小时活跃和热力图统一改为 Recharts 渲染；保留项目筛选、时间范围、手动刷新、点击项目过滤与日期/小时下钻交互。
- 历史统计请求接入 React Query：历史统计项目选项与统计 payload 改由 TanStack React Query 管理缓存、加载、错误和强制刷新；实时终端统计继续保持原有链路，不改变后端 IPC payload。
- 历史统计口径修正：
history_get_stats改为按每条去重 usage 事件的时间戳聚合 Token、费用、模型分布、日期趋势和小时分布；缺少时间戳时才回退到会话更新时间，避免跨天会话的用量全部落到最后修改日。 - 会话计数去重：统计范围、项目、来源、模型、日期和小时桶中的会话/消息数按唯一会话身份去重，避免同一会话多条 usage 事件导致会话数虚高。
- 图表配色与提示统一：历史分析与 ccusage 分析采用更稳定的输入/输出/cache/总量色板，并统一 tooltip、坐标轴和峰值标记，减少不同主题下曲线撞色。
项目文件浏览器
- 文件搜索性能优化：文件树搜索支持按文件名和项目相对路径匹配，跳过
.git、.trellis、node_modules、dist、build、target等重目录，并限制最大结果数，减少大项目搜索卡顿。 - 全项目代码片段搜索：文件浏览器搜索区新增「文件 / 代码」模式切换；代码模式由 Rust 后端在项目根目录内扫描 UTF-8 文本文件，返回文件路径、行号、命中行和上下文片段。
- 搜索请求防抖与过期保护：前端搜索增加 220ms 防抖和请求序号校验，快速输入或慢请求返回时不会用旧结果覆盖新查询。
- 命中行跳转高亮：点击代码片段搜索结果会打开对应文件，自动切到源码视图，滚动到命中行并高亮当前行与匹配片段。
- 搜索文案国际化：新增搜索模式、空状态、加载状态、行号和错误提示的中英文文案。
国际化
- 英文界面补齐：补齐设置页、右侧操作栏、命令模板/历史悬浮框、历史会话详情、Git 变更面板、项目文件浏览器、历史用量分析、实时统计与 ccusage 分析的中英文文案。
- 通知与 Hook 文案国际化：系统内 toast、系统通知以及 Hook 相关通知改为按当前语言输出，避免切换英文后仍显示中文。
- 历史详情变更页修复：历史记录详情的「变更」事件从过程模型源头生成本地化标题和描述，切换英文后“来自消息”等文案会同步变为英文。
- 时间格式修复：界面语言切换到英文时，侧栏底部时间继续使用 24 小时制，避免
15:31变成03:31。 - 项目规则补充：在项目规约中明确新增/修改前端可见文案必须同步兼容
zh-CN与en-US，覆盖 tooltip、菜单、toast、系统通知、统计、历史与 Hook 通知脚本等场景。
规约与工程化
- 文件命令合约补齐：项目文件命令规约新增
file_search_content、搜索目录跳过、结果上限、UTF-8/大文件处理和测试要求，明确全文搜索必须由 Rust 侧负责项目根目录边界与安全限制。 - 历史统计合约补齐：历史统计规约新增 usage 事件时间分桶和唯一会话计数要求，并补充跨天用量测试约束。
- GitNexus 索引信息同步：更新项目说明中的 GitNexus 符号和关系数量，保持代码智能索引信息与当前仓库一致。