用量同步（Dosage Sync）

此库已转移至我的AgentHub项目进行聚合

一个 Windows 托盘常驻工具：自动读取本机 ZCode、Codex、DeepSeek Harness、WorkBuddy、WorkBuddy AI、Reasonix、CodeBuddy、Qoder、Qoder CN、Antigravity、Antigravity IDE、Trae、Trae CN、TRAE SOLO、TRAE SOLO CN、OpenSquilla 与 Grok 的模型用量，按「电脑」为单元同步到自建 WebDAV，并在多台电脑之间汇总展示。

多数据源已接入：支持 ZCode、Codex、DeepSeek Harness（DSH）、WorkBuddy、WorkBuddy AI、Reasonix、CodeBuddy、Qoder、Qoder CN、Antigravity、Antigravity IDE、Trae、Trae CN、TRAE SOLO、TRAE SOLO CN、OpenSquilla、Grok 共 17 个数据源，各源可独立启用、探测、同步和筛选。
顶栏两级分组（2026-09 新增）：同族数据源在顶栏聚合为一个组按钮 + 下拉（WorkBuddy 系 / Trae 系 / Qoder 系 / Antigravity 系四族，其余源为独立按钮），组内只剩 1 个可见源时自动退化为普通按钮；设置页改为吸顶分区 Tab（数据存储 / 数据源 / 工具栏切换项 / 调度 / 外观 / 数据与版本），「工具栏切换项」支持组与子项两级拖拽排序（分组归属内置固定，用户只调顺序与显隐）。旧配置在升级后首次启动自动迁移为「组 + 成员」结构，原有排列不变。
存储后端可扩展：当前优先支持自建飞牛 fnOS 的 WebDAV，后续可增加 Nextcloud / 坚果云 / 群晖 / 自定义。
本机存储（2026-09 新增）：没有 WebDAV 也有数据安全网——设置页「数据存储」可切换「WebDAV 存储 / 本机存储」；本机存储把整库快照（汇总库 + 设置）打包为标准 zip 备份压缩包（默认存到数据缓存目录，可自定义，固定名覆盖式）。未配置 WebDAV 时顶栏「立即备份」与定时同步都会自动重新生成压缩包；支持「从压缩包恢复」整包还原数据与设置（恢复前自动留安全副本，失败自动回滚），详见本机存储备份方案。
聚合灵活：累计 token 可按软件源、设备、模型和供应商隔离查询，支持多模型多类型。
可视化：曲线趋势图 + GitHub 风格蓝色热力点阵图（15 档）+ 时间/设备/模型多维筛选，深色/浅色主题（默认浅色；窗口原生标题栏与边框同步跟随主题，不再跟系统主题走）。
计费（2026-09 新增）：按「模型单价 × token 分解」动态核算费用——价格带时段版本（改价自动生成新版本，历史费用按记录发生时刻的价格重算），支持手动维护、从用量一键生成草稿、LiteLLM/OpenRouter 价格源导入预览；价格表经 WebDAV 多设备共享（LWW）。内置 20 个常用模型的默认价格，开启计费即见全部历史费用。支持三层价格来源优先级：手动规则 > 远程自动拉取（默认 Wei-Shaw 价格源，网址可自定义，哈希短路由省流量）> 内置种子，「计费规则」页可一键拉取/改址/调间隔。侧栏「费用」页展示费用 KPI/趋势/三维度费用榜，「计费规则」页管理价格（默认关闭，在计费规则页开启）。
隐私提示：同步到 WebDAV 的分片为明文 gzip JSONL（含设备名、模型、会话 ID 等用量数据），请确保自建服务器可信；传输建议使用 https。

技术栈

层	技术
桌面框架	Electron 35（Node.js 主进程，Win10/11）
前端	Vue 3 + TypeScript + Vite + Pinia + ECharts
后端	Node.js（`node:sqlite` / 原生 fetch）
本地库	SQLite（Node 22 内置 `node:sqlite`，与各源数据库分离）
打包	electron-builder：NSIS 安装包 + portable 便携版单 exe（便携版不支持开机自启——注册的会是临时解压副本；数据默认统一在用户主目录 `~/.Dosage_sync/`，可在设置页自定义）
更新	安装版支持应用内自动更新（设置页 → 软件更新，`electron-updater` + GitHub Releases）；便携版仅检测提示，需到 GitHub Releases 手动下载替换

目录结构

.
├── logo.png                # 图标源文件（窗口/托盘/exe 图标）
├── preview.html            # UI 设计原型（浏览器直接打开预览，零依赖）
├── index.html              # 前端入口
├── package.json
├── vite.config.ts
├── tsconfig.json
├── src/                    # Vue3 前端
│   ├── main.ts / App.vue
│   ├── styles/             # 设计系统（主题变量）
│   ├── types/              # 统一类型（与 Node 后端模型对齐）
│   ├── api/                # IPC 封装 + 浏览器 mock（可脱离后端预览）
│   ├── stores/             # Pinia 状态
│   ├── composables/        # 格式化工具
│   ├── components/         # 侧栏/顶栏/进度/图表/热力图/抽屉等
│   └── views/              # 总览/明细/日志/设置 四页
├── electron/               # Electron 主进程（Node.js 后端）
│   ├── main.cjs            # 窗口/托盘/单实例/调度入口
│   ├── preload.cjs         # contextBridge 安全桥接
│   └── backend/
│       ├── config.cjs      # 配置与数据目录
│       ├── db.cjs          # 本地汇总库（node:sqlite）
│       ├── adapter.cjs     # 数据源适配器注册表
│       ├── adapter-zcode.cjs # ZCode 适配器（读 ~/.zcode）
│       ├── adapter-codex.cjs # Codex 适配器（读 ~/.codex）
│       ├── adapter-dsh.cjs # DeepSeek Harness 适配器（读 ~/.dsh）
│       ├── adapter-workbuddy-common.cjs # WorkBuddy 系公共工厂（projects/**/*.jsonl 会话转录逐次 message.usage）
│       ├── adapter-workbuddy.cjs # WorkBuddy 适配器（读 ~/.workbuddy）
│       ├── adapter-workbuddy-ai.cjs # WorkBuddy AI 适配器（读 ~/.workbuddy-ai，结构与 WorkBuddy 同构，无 device-id）
│       ├── adapter-reasonix.cjs # Reasonix 适配器（读 stats/YYYY-MM-DD.jsonl 每日账本）
│       ├── adapter-codebuddy.cjs # CodeBuddy 适配器（读 CodeBuddyExtension 会话 history JSON）
│       ├── adapter-qoder-common.cjs # Qoder 系公共工厂（projects/**/*.jsonl 会话转录，官方模型 credits 额度点）
│       ├── adapter-qoder.cjs # Qoder 适配器（读 ~/.qoder）
│       ├── adapter-qoder-cn.cjs # Qoder CN 适配器（读 ~/.qoder-cn）
│       ├── adapter-antigravity-common.cjs # Antigravity 系公共工厂（conversations/*.db 转录，gen_metadata protobuf）
│       ├── adapter-antigravity.cjs # Antigravity 适配器（读 ~/.gemini/antigravity）
│       ├── adapter-antigravity-ide.cjs # Antigravity IDE 适配器（读 ~/.gemini/antigravity-ide）
│       ├── sqlcipher.cjs    # SQLCipher 解密桥（koffi FFI + 内置 sqlcipher.dll，Trae 系专用）
│       ├── adapter-trae-common.cjs # Trae 系公共工厂（SQLCipher 库 chat_turn.context.token_usage 五桶）
│       ├── adapter-trae.cjs # Trae 适配器（读 %APPDATA%/Trae）
│       ├── adapter-trae-cn.cjs # Trae CN 适配器（读 %APPDATA%/Trae CN）
│       ├── adapter-trae-solo-cn.cjs # TRAE SOLO CN 适配器（读 %APPDATA%/TRAE SOLO CN）
│       ├── adapter-trae-solo.cjs # TRAE SOLO 适配器（读 %APPDATA%/TRAE SOLO）
│       ├── adapter-opensquilla.cjs # OpenSquilla 适配器（读 %APPDATA%/@opensquilla state/sessions.db usage_events）
│       ├── adapter-grok.cjs # Grok 适配器（读 ~/.grok/sessions/**/usage.json 会话账本，turn × 模型粒度五桶）
│       ├── webdav.cjs      # WebDAV 客户端（原生 fetch）
│       ├── zip.cjs         # 轻量 zip 读写（纯 zlib，本机存储备份压缩包用）
│       ├── sync.cjs        # 四阶段同步引擎 + 本机备份打包/整包还原
│       ├── billing.cjs     # 价格源导入（LiteLLM/OpenRouter）+ 价格表 WebDAV 同步
│       ├── scheduler.cjs   # 定时调度
│       └── ipc.cjs         # ipcMain handler 注册
├── build/                  # electron-builder 资源（icon.ico / icon.png / tray.png）
└── docs/
    ├── 方案.md             # 设计方案
    └── 操作.md             # 操作手册（构建 / 使用 / 飞牛配置）

数据源

数据源	默认目录	用量来源	默认状态
ZCode	`~/.zcode`	`cli/db/db.sqlite` 的 `model_usage`	启用
Codex	`~/.codex`	`sessions/*/rollout-.jsonl` 的单次 `last_token_usage`	停用
DeepSeek Harness	`~/.dsh`	`tokenledger.sqlite` 的 `session_rollups`	停用
WorkBuddy	`~/.workbuddy`	`projects/*/.jsonl` 会话转录的逐次 `message.usage`	启用
WorkBuddy AI	`~/.workbuddy-ai`	同 WorkBuddy（目录同构；`projects` 下项目目录名带会话时间戳；无 `device-id`，走设备 ID 回退链；`rawUsage.credit` 额度点不入库）	启用
Reasonix	`%APPDATA%/reasonix`（Windows）／`~/.reasonix`	`stats/YYYY-MM-DD.jsonl` 每日账本的逐次请求聚合	启用
CodeBuddy	`%LOCALAPPDATA%/CodeBuddyExtension`	会话 `history/**/index.json` 的逐请求 `requests[].usage`	停用
Qoder	`~/.qoder`	`projects/*/.jsonl` 会话转录的逐请求 `message.usage`（官方模型为 credits 额度点）	停用
Qoder CN	`~/.qoder-cn`	同 Qoder（目录同构）	停用
Antigravity（旧版）	`~/.gemini/antigravity`	`conversations/*.db` 转录的逐次生成 `gen_metadata`（credits 额度点 + 真实输出 token）	停用
Antigravity IDE（新版）	`~/.gemini/antigravity-ide`	同 Antigravity（目录同构）	停用
Trae（国际版）	`%APPDATA%/Trae`	SQLCipher 库 `chat_turn.context` 的 `token_usage` 五桶（turn 累计口径）	停用
Trae CN（国内版）	`%APPDATA%/Trae CN`	同 Trae（解密同密钥）	停用
TRAE SOLO	`%APPDATA%/TRAE SOLO`	同 Trae（解密同密钥）	停用
TRAE SOLO CN	`%APPDATA%/TRAE SOLO CN`	同 Trae（解密同密钥）	停用
OpenSquilla	`%APPDATA%/@opensquilla/desktop-electron/opensquilla`	`state/sessions.db` 的 `usage_events` 五桶（明文 SQLite，逐次 LLM 调用）	停用
Grok	`~/.grok`	`sessions/**/usage.json` 会话账本五桶（turn × 模型粒度，含 fork 多模型分账）	停用

Codex、DSH、CodeBuddy、Qoder 两源、两个 Antigravity 源、四个 Trae 源、OpenSquilla 与 Grok 需要在设置页手动启用（首次启动探测到数据会自动显示并启用）。十七个来源共用本机设备 ID，记录依靠 source 隔离；切换顶部数据源后（同族源在顶栏聚合为组按钮 + 下拉，见上文「顶栏两级分组」），总览、设备、趋势、热力图与明细会同步切换统计范围，各源统计互不影响。WorkBuddy 与 WorkBuddy AI 是同一厂商的两个产品，目录与记录 id 前缀各自独立（:workbuddy: / :workbuddy-ai:），互不合并。Trae / Trae CN / TRAE SOLO / TRAE SOLO CN 的本地会话库为 SQLCipher 整库加密，应用内置密钥与 sqlcipher.dll 解密读取（密钥为 Trae 应用硬编码固定值，四应用通用；目标机器无需安装额外软件），详见 Trae数据源接入方案。OpenSquilla 的用量账本为明文 SQLite，详见 OpenSquilla数据源接入方案。Grok 的用量账本为 Grok CLI 落盘的会话级 JSON usage.json，详见 Grok数据源接入方案。

Token 口径说明（已实测确认）：各 token 源的「输入」均包含缓存命中——ZCode 为源数据原生口径，DSH 由适配器归一化补入，Codex 已用本机 rollout 原始数据实测确认（OpenAI 语义中 cached_input_tokens 是 input_tokens 的子集），WorkBuddy 与 WorkBuddy AI 会话转录实测同口径。因此缓存命中率 = 缓存命中 / 输入在跨源对比时口径一致，命中率恒 ≤ 100%。WorkBuddy / WorkBuddy AI 的推理与缓存写入 token 从其原始回包（providerData.rawUsage）补入，源数据缺失时记 0；转录中的对话内容不会被读取或上传。WorkBuddy AI 的 rawUsage.credit 额度点不写入 credits 列——该列在汇总 SQL 中被直接计入 token 总量（为 Qoder「仅有 credits、token 全 0」设计），WorkBuddy AI 的 token 与 credit 并存，写入会造成同一笔调用双重计量。

Reasonix 口径说明：Reasonix 的每日账本把输入拆成互斥的 cache_miss / cache_hit 两桶，与上述「输入含缓存」口径不同。适配器做一次无损映射后入库——inputTokens = cache_miss + cache_hit（即 prompt）、cacheReadTokens = cache_hit、outputTokens = completion − reasoning、cacheCreationTokens = 0（账本不持久化缓存写入）。映射后计费公式的「净输入 = 输入 − 缓存命中」恰等于 cache_miss、「输出 + 推理」恰等于 completion，v_record_cost 无需任何改动。账本中 turn: true 的轮次行不是真实 provider 调用，已跳过以避免重复计数；缓存写入缺失会让费用轻微低估（写入价通常高于输入价的部分未计）。目录可用 REASONIX_STATE_HOME / REASONIX_HOME 覆盖。

CodeBuddy 口径说明：读取 %LOCALAPPDATA%/CodeBuddyExtension/Data/<用户>/CodeBuddyIDE/<安装>/history/<项目>/<会话>/index.json 中每请求的 usage（输入含缓存写入，与其余源同口径；实测 total = 输入 + 输出）。模型名不在 usage 里，由同会话 messages/*.json 的 extra.requestId → extra.modelId 关联（extra 为 JSON 字符串需二次解析），关联不到记 unknown。推理 / 缓存命中 / 缓存写入细分仅存在于 IDE 滚动日志（按日期滚动易丢失），本地无持久化明细，三项记 0——该源的缓存命中率无意义；credits 余额本地不存在（配置缓存为 DPAPI 密文），不做余额展示。国内版 CodeBuddy CN 产生数据后按同构目录自动识别。目录可用 CODEBUDDY_DATA_HOME 覆盖。

Qoder 口径说明：读取 ~/.qoder{,-cn}/projects/<项目>/<会话>.jsonl 会话转录中 assistant 消息的 message.usage（input_tokens 含缓存命中，与其余源同口径）。官方模型（qmodel 系列）本地不落盘 token 明细（服务端按订阅额度计量），每请求仅有 credits 额度点——该类记录 token 为 0、credits 写入 usage_record.credits 独立字段（schema v4 新增）并计入总量聚合：总览/热力图/趋势/设备的数值 = token + 额度点，费用恒为 0、缓存命中率不适用；自定义 BYOK 模型（qoder-custom-<uuid>/<真名>）有完整五桶 token，模型名按 / 拆分后走全项目统一规范化（deepseek-v4-pro-0813 → deepseek-v4-pro）并按模型名推断供应商、正常计费。幂等键为转录行 uuid，仅最终消息带 usage（thinking 中间消息无 usage），天然去重。两源目录同构，installation_id 为设备标识；备用日志 logs/sessions/**/segments/*.jsonl 同样带 token 但无 credits，为转录子集，不采集。目录可用 QODER_DATA_HOME / QODERCN_DATA_HOME 覆盖。

同步采用分片级增量传输：每个日分片以内容哈希记账，内容未变化时自动跳过上传/下载，同步耗时不随历史数据量线性增长。退役设备可在侧边栏悬停设备项点「×」删除（同时清理 WebDAV 上的该设备数据与本地记录，本机不可删）。

未配置 WebDAV 时走本机存储：顶栏「立即备份」与定时同步自动抽取本机数据并把整库快照（SQLite 汇总库 + 设置）打包为 dosage-sync-backup.zip（默认在数据缓存目录，可自定义备份目录，覆盖式只留最新一份）；「从压缩包恢复」整包还原数据与设置，与同步/备份全程互斥（恢复期间同步、切目录、清缓存等操作一律拒绝），详见本机存储备份方案。已配置 WebDAV 时行为不变，设置页「本机存储」面板仍可随时手动强制生成一次本机备份。

Antigravity 系统计口径说明：读取 ~/.gemini/antigravity(-ide)/conversations/*.db（每会话一个明文 SQLite）中 gen_metadata 表的逐次生成记录（protobuf：f4 用量子消息含 f2 credits 额度点 / f3 输出 token / f5 输入提示词水位 / f9 ≈思考 token，f19 模型名）。官方模型服务端按 credits 计费——credits 写入 usage_record.credits 独立列并计入总量聚合但不进 token 总量（与 Qoder 同构），明细页看「额度」列；输出 token（f3）为精确值，输入 token 为 f5 水位在会话内的相邻差分（首行从 0 起算），属近似口径；本地无缓存明细，cache 两桶为 0。幂等键 = 设备ID:源:conversationId:genIdx（conversationId 取 .db 文件名 UUID），会话库无逐次时间戳，startedAt 取文件 mtime。本地 .pb 旧格式会话（2026-05~07）为整文件加密无法解析，统计起点为现存 .db 最早记录。无需 Antigravity 正在运行；单库损坏/被占用复制临时副本回退，解析失败优雅跳过并写日志，不影响其他源。2026-09-05 初版曾按 state.vscdb 配额快照差值计量（配额百分比点非 token），2026-09-11 发现转录库后整体替换，历史方案见方案.md 2.9.1。

Trae 系统计口径说明：读取 %APPDATA%/<应用>/ModularData/ai-agent/database.db（SQLCipher 整库加密，应用内置硬编码密钥解密）中 chat_turn 表的 context JSON 内 token_usage 五桶（prompt_tokens 含缓存命中，与其余源同口径）。注意 token_usage 为每 turn 的累计值——同一 session 后续 turn 会把前文上下文重复计入 prompt，统计天然偏大，这是 Trae 客户端计量方式；模型名本地不落盘（token_usage.name 为空），一期统一归因源名（trae / trae-cn / trae-solo / trae-solo-cn）；created_at 为秒级时间戳；幂等键为 turn_id。解密实现：koffi FFI + 内置 resources/sqlcipher/（sqlcipher.dll + libcrypto/libssl 三件套），读取时先复制 db+wal+shm 到 %TEMP% 临时目录避免与应用锁冲突，用完即删；1.10.2 起每轮同步还会主动清扫 %TEMP% 下 dosage-trae-* 历史残留（旧版本每小时遗留约 405MB 副本不清、Windows 不自动清临时目录，升级后首轮同步自动回收，无需手动清理）。目录可用 TRAE_DATA_HOME / TRAECN_DATA_HOME / TRAESOLO_DATA_HOME / TRAESOLOCN_DATA_HOME 覆盖。

OpenSquilla 口径说明：读取 %APPDATA%/@opensquilla/desktop-electron/opensquilla/state/sessions.db（明文 SQLite，WAL 模式只读直连）中 usage_events 表的逐次 LLM 调用记录，五桶齐全（input_tokens 含缓存命中，与其余源同口径；cache_write_tokens 映射 cacheCreationTokens）。一条 event = 一次模型调用（本机实测每 event 恰好一个 usage_event_item，无 ensemble 拆分）；total_tokens = 0 的失败重试行（status='unknown'）不采集；run_kind 全收——session_turn 对话、session_naming 自动命名与 onboarding_probe 系统探测均为真实消耗，mode 透传 run_kind。provider 采用事件原文（本机为 tokenrhythm 中转站），模型名走全项目统一规范化（deepseek-v4-pro-0813 → deepseek-v4-pro）。幂等键为 event_id（全局唯一），增量锚点为 started_at_ms（毫秒）；设备标识取 install_telemetry.json 的 install_id，缺失回退 gateway-ownership profile hash。受源端 yoyo 迁移活跃影响，抽取前按列存在性做防御（缺列回退 0，面目全非才报错跳过该源）。目录可用 OPEN_SQUILLA_HOME 覆盖。

Grok 口径说明：读取 ~/.grok/sessions/<项目目录URL编码>/<会话ID>/usage.json 会话账本（Grok CLI 每会话一份 JSON 用量账本，会话进行中随 updatedAt 持续落盘，统计无需 CLI 正在运行），按「轮次 × 模型」粒度入库——同一轮 modelUsage 出现多个模型（fork 情景，如会话中途切 grok-4.6）时各自独立成条、五桶互不混计；modelUsage 缺失回退轮级五桶。五桶齐全（inputTokens 含缓存命中，与其余源同口径；cacheCreationTokens 即缓存写入）。provider 统一为 xAI；模型名走全项目统一规范化。幂等键为 设备:grok:会话ID:轮次号:模型（账本重写时同 id 覆盖更新），增量锚点为轮次 endedAt（毫秒）；账本 mtime 早于回扫窗口的整文件跳过（append-only 优化），写入中断产生的半截 JSON 静默跳过、下轮同步补采。仅写入 usage.json 的会话才有账本（Grok 托盘级会话与被中断会话不落账本，与官方计量一致），costUsdTicks 暂不映射（计费按 token 重算）。设备标识取 ~/.grok/agent_id。目录可用 GROK_HOME 覆盖。

总览「全部」缓存命中率口径（2026-09-11 起）：「全部」视图的总计/今日缓存命中率只统计有缓存机制的源（cache_read 全期求和 > 0）——cache_read 恒为 0 的源（CodeBuddy / Antigravity 系 / Qoder 官方 / Trae CN 等）不参与分子分母，避免无缓存源稀释整体命中率；KPI 脚注的「命中/输入」数值同口径。单源视图不过滤，如实展示该源命中率（无缓存源为 0%）。

快速开始

npm install

# 仅预览前端 UI（脱离 Node 后端，浏览器打开 http://localhost:1420）
npm run dev:web

# 开发调试（Vite + Electron 热更新窗口）
npm run dev

# 打包（NSIS 安装包 + portable 便携版 exe，产物在 release/）
npm run electron:build

发版流程（自动更新）

代码提交后执行 ./scripts/dual-push.sh（同时推送 Codeup 与 GitHub，脚本不入库），再到 GitHub 仓库的 Actions → Release → Run workflow 手动触发发布流水线：构建 → 版本校验 → 自动创建 Release（安装包 / 便携版 / latest.yml / blockmap）。发布后安装版客户端会在启动后及每 6 小时自动检测到新版（可在设置页关闭自动检测），便携版用户到 Releases 手动下载。发版不可撤回，发布前务必先升级 package.json 的版本号并通过本地 npm run build。

图标已生成在 build/（icon.ico / icon.png / tray.png），无需额外步骤。

仓库

https://github.com/HUIdada1/Dosage_sync

Navigation Menu

Repository files navigation

用量同步（Dosage Sync）

此库已转移至我的AgentHub项目进行聚合

技术栈

目录结构

数据源

快速开始

发版流程（自动更新）

仓库

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
build		build
electron		electron
resources/sqlcipher		resources/sqlcipher
src		src
tools		tools
.gitignore		.gitignore
.npmrc		.npmrc
README.md		README.md
index.html		index.html
logo.png		logo.png
package-lock.json		package-lock.json
package.json		package.json
preview.html		preview.html
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

Latest commit

History

Folders and files

Repository files navigation

用量同步（Dosage Sync）

此库已转移至我的AgentHub项目进行聚合

技术栈

目录结构

数据源

快速开始

发版流程（自动更新）

仓库

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages