llm-usage

LLM Usage 是 AI 用量看板，统计各模型的 token、请求和缓存使用。目前处于预发布阶段，已实现总览、趋势、详情、数据源和设置。支持完整标准化明细导入/Merge，以及默认关闭的日/月 token 或单币种估算用量和费用提醒。

下载最新 Release，选择适合 Windows、Linux 或 macOS 的 x64、arm64 软件包。便携包使用 .tar.zst，同时提供 Windows x64 安装器。使用方法见安装说明。

采集读取本机 Agent 记录，可在界面配置定时提取。支持的格式、版本及来源限制见接入矩阵。

0.2.1 版本总览：实际 Windows 桌面界面，使用隔离的合成演示数据。选择图片可查看 2880×2000 原 PNG。文档首页还展示趋势、记录详情、数据源管理及设置，并提供浅色和深色两种主题。

文档

Astro/Starlight 文档站包含用户与开发指南、来源说明和验证依据。文档默认英文，首页按受支持浏览器语言选择并保存明确选择，支持浅色和深色主题。仓库文档和源码注释使用英文，中文对应版本同步维护。

执行计划：当前结果、执行范围与移出条件。
开工准备：已确认范围、真实数据验证流程与检查结论。
详细设计：架构、统计规则、Agent 接入、配置与测试。
调研依据：官方资料、固定源码和原型静态核对。
定时提取与平台/CI：后台任务和跨平台验收要求。
验证记录：M0 起的实际执行记录，随检查完成逐条登记。
应用图标与静态资源：Usage U 设计、预览、重新生成与 Git LFS 约定。
已有 previous-draft 作为参考，未进行运行验收。
共享规则：AGENTS.md。
维护流程与按需资源：Skills。

常用命令

使用 Node.js 22+（当前 CI 使用 24）与 Rust 1.99.0（由 rust-toolchain.toml 选择）。 Astro 文档站要求 Node 22.12+。在仓库根直接执行：

git lfs install --local  # 为当前克隆启用 LFS（首次）
git lfs pull            # 下载图标及其他静态/二进制资源
npm ci                  # 恢复文档工具依赖（首次）
npm --prefix desktop ci # 恢复桌面工具依赖（首次）
npm run assets:check    # 检查资源格式、派生文件与 LFS 属性
npm run lint:md         # Markdown 检查
npm run dev:web         # 仅前端 Vite 热更新服务（http://127.0.0.1:1421，无后端）
npm run dev:desktop     # 开发模式拉起 GUI（debug 构建 + 热重载，不打包）
npm run check           # 前端类型检查（svelte-check）
npm run build:web       # 前端产物构建
npm run test:rust       # Rust 测试
npm run test:ui         # 前端纯逻辑回归
npm run test:browser    # 五页浏览器回归（模拟 IPC；Windows 使用已安装的 Edge）
npm run clippy          # Rust 静态检查（-D warnings）
npm run fmt:check       # Rust 格式检查
npm run build:desktop   # 桌面 release 构建（按平台产出 NSIS/AppImage/.app）
npm run test:headless   # 真实可执行文件与 SQLite，隔离合成来源；先构建
npm run test:desktop    # Windows 原生 WebView2/IPC，要求 CDP 可用；先构建
npm run verify          # 文档、类型、脚本/前端单元测试、Rust 检查与测试、前端构建
npm run dev:docs        # Astro 文档开发服务器
npm run check:docs      # 翻译/内容检查及 Astro 类型
npm run build:docs      # 生产站点和本地链接检查
npm run test:docs       # 文档行为回归
npm run test:docs:browser # 生产站点浏览器检查

也可以执行 pnpm install --frozen-lockfile，通过固定的 pnpm 12.10.1 恢复根目录和 desktop 工作区。同一组命令也支持 pnpm run；更改依赖时同步维护两个 npm 锁文件和共享的 pnpm 锁文件。

test:browser 单独执行，会启动并关闭临时 Vite 服务；截图写入 build/browser-smoke/。非 Windows 环境先在 desktop 中运行 npx playwright install chromium。浏览器检查模拟 IPC，不能替代原生桌面、系统任务和安装验收；当前验证结果与未完成项见最新验收。原生与无界面脚本的输入为隔离合成来源，输出写入根 build/plan-completion/。 test:desktop 默认测 release；调试构建可用 -- --dev --exe <debug 可执行文件>。日常功能验证用 dev:desktop 即可，不必打包。业务命令与锁定版本以 desktop/package.json、desktop/src-tauri/Cargo.toml 及各自锁文件为准。文档检查不代替业务验收；M0 实测结果见验证记录。

Windows 后台提取默认关闭，设置页可启用当前用户的分钟任务，并展示期望与实际状态。 LLMUsage.exe --headless 只按已保存意图及到期规则采集；--scan-once 手动扫描全部启用来源。可用 --data-dir <绝对目录> 独立保存数据库和导出；它不改变来源发现范围。需限定采集范围时，在设置中启用“仅扫描手工目录”；保存的规则同时约束 GUI 和后台任务。

图片（含 SVG）、字体、媒体及二进制文件使用 Git LFS；首次构建前须下载实际资源。重新生成图标：npm run assets:generate。资源预览页： npm run dev:web 后打开 http://127.0.0.1:1421/asset-preview.html。