dsh-api-ledger 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-api-ledger 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-api-ledger 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-api-ledger 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/9/22。

API 用量账本 LAwLi3tCoding/dsh-api-ledger

DeepSeek Harness

LAwLi3tCoding40 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

在会话里随时查看 Token 用量与估算费用

29.5/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/26 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add LAwLi3tCoding/dsh-api-ledger

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · model

装得上吗

本站已真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 40 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求

查看扫描证据（共 17 处，展示前 17 条）

发起网络请求
lib/client.js:573
return fetch('/api-ledger/report', {
发起网络请求
lib/client.js:609
return fetch('/api-ledger/preferences', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(args) })
读取本地文件
lib/config.js:9
const raw = existsSync(file) ? readFileSync(file, 'utf8') : '{}'
读取本地文件
lib/config.js:9
const raw = existsSync(file) ? readFileSync(file, 'utf8') : '{}'
写入本地文件
lib/config.js:64
writeFileSync(temp, JSON.stringify(cfg, null, 2) + '\n', { mode: 0o600 })
写入本地文件
lib/config.js:65
renameSync(temp, file)
读取本地文件
lib/records.js:40
if (!existsSync(file)) return { rows: [], skipped: 0 }
读取本地文件
lib/records.js:43
text = readFileSync(file, 'utf8')
读取本地文件
lib/records.js:66
const info = statSync(file)
读取本地文件
lib/records.js:70
const fd = readFileSync(file)
写入本地文件
lib/records.js:84
writeFileSync(tmp, contents)
写入本地文件
lib/records.js:85
renameSync(tmp, file)
写入本地文件
lib/records.js:117
mkdirSync(this.home, { recursive: true })
写入本地文件
lib/records.js:148
appendFileSync(this.recordsFile, `${JSON.stringify(record)}\n`)
读取本地文件
lib/records.js:309
if (!existsSync(this.rollupFile)) return null
读取本地文件
lib/records.js:311
const parsed = JSON.parse(readFileSync(this.rollupFile, 'utf8'))
写入本地文件
lib/records.js:343
mkdirSync(dirname(file), { recursive: true })

扫描于 2026/10/31（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

查看Token用量
估算费用
按池出报表

DSH API 用量与费用账本，按池出报表，支持人民币/美元显示

README

由 DeepSeek 最新模型翻译生成

DSH API 账本 English / 中英双语功能概览：演示数据功能示意图，使用演示数据，不是真实账户截图。不用离开会话，就能查看本次对话花了多少钱。 API 账本把 Token 用量和 API 估算费用放进 DSH：会话完整报告、设置页总览、输入框下方的会话金额，以及左下角的一行今日金额。哪些地方用起来方便？ - 随手查看费用：不用频繁打开独立报表；会话费用放在输入框下面，今日费用放在侧边栏，点击即可打开设置中的账本。 - 相同模型可以按不同接口计价：价格按「路由 + 模型」配置，官方接口和企业网关互不混用。 - 分组由使用者决定：默认按路由分别统计，需要时再设置相同账单分组。不会因为共用凭据引用就自动合并，也不会把展示分组当作共用余额。 - 四处展示同步切换币种：CNY/USD 选择会保存并同步，避免不同页面各用一种显示币种。 - 能看懂费用怎么来的：最近调用标明计价来源，未配置单价显示未计价，历史记录保留当时使用的单价。 - 无需部署额外服务：用量与配置保存在本机，不读取 API Key 的值，也不上传到插件自建的统计服务。这些是插件的具体使用价值，不代表其他用量插件都不具备相同能力。这里统计的是已记录用量与估算费用，不是供应商账单或账户余额。

展开完整文档（README 剩余 1 节）

DSH API 账本

English / 中英双语

功能概览：演示数据

功能示意图，使用演示数据，不是真实账户截图。

不用离开会话，就能查看本次对话花了多少钱。

API 账本把 Token 用量和 API 估算费用放进 DSH：会话完整报告、设置页总览、输入框下方的会话金额，以及左下角的一行今日金额。

哪些地方用起来方便？

- 随手查看费用：不用频繁打开独立报表；会话费用放在输入框下面，今日费用放在侧边栏，点击即可打开设置中的账本。
- 相同模型可以按不同接口计价：价格按「路由 + 模型」配置，官方接口和企业网关互不混用。
- 分组由使用者决定：默认按路由分别统计，需要时再设置相同账单分组。不会因为共用凭据引用就自动合并，也不会把展示分组当作共用余额。
- 四处展示同步切换币种：CNY/USD 选择会保存并同步，避免不同页面各用一种显示币种。
- 能看懂费用怎么来的：最近调用标明计价来源，未配置单价显示未计价，历史记录保留当时使用的单价。
- 无需部署额外服务：用量与配置保存在本机，不读取 API Key 的值，也不上传到插件自建的统计服务。

这些是插件的具体使用价值，不代表其他用量插件都不具备相同能力。这里统计的是已记录用量与估算费用，不是供应商账单或账户余额。

四处展示

| 位置 | 用途 |
| 会话 → API 账本 | 本会话费用、最近调用、模型分布、Token 构成和用量趋势 |
| 设置 → API 账本 | 跨会话报表、周期筛选、今日／昨日对比、账户与计价 |
| 会话输入框下方 | 本会话已用金额 |
| 侧边栏左下角 | 单行今日费用，点击打开账本设置 |

安装

需要 Node.js 20+ 和兼容的 DSH。已在 DSH Desktop 2.0.13／内置 DSH 0.1.5-rc.2 验证；插件无需构建，没有运行时 npm 依赖。

DSH Desktop：从 GitHub 安装

git clone https://github.com/LAwLi3tCoding/dsh-api-ledger.git
cd dsh-api-ledger
node scripts/install.mjs

重启 DSH 后，打开「设置 → API 账本」或会话的「API 账本」Tab。安装使用本地链接，请保留克隆目录。更新时执行 git pull 后重启；卸载该链接安装时执行 node scripts/install.mjs --uninstall。

DSH CLI：安装到 CLI 管理的 profile

GitHub 安装
dsh plugin --profile web add github:LAwLi3tCoding/dsh-api-ledger

npm 安装
dsh plugin --profile web add dsh-api-ledger

将 web 换成自己的 CLI profile。DSH 0.1.5-rc.2 的 desktop profile 由 Electron 专管，不能直接使用 dsh plugin --profile desktop add ...。桌面端请使用上面的安装脚本，或在市场收录完成后通过桌面市场安装；提交 PR 不等于已经上架。

配置计价

打开「设置 → API 账本 → 账户与计价」，选择路由和模型。每个模型单独保存，切换前先保存当前修改。

| 方式 | 含义 |
| 官方价表估算 | 已识别的 DeepSeek 官方直连在没有显式配置时默认使用，按内置 USD 价表及峰谷规则估算 |
| 参考价估算 | 手动选择固定的官方非高峰 USD 快照，不判断时间和节假日 |
| 自定义单价 | 按每百万 Token 填写非缓存输入、输出、缓存读和缓存写价格及币种；允许零价格 |
| 仅记录用量 | 不猜测费用；其他接口的默认方式 |

官方接口按实际 URL 识别，并考虑 DeepSeek 适配器的启动环境覆盖；名称包含 DeepSeek 不代表官方直连。内置官方价表核验日期为 2026-09-21，支持 deepseek-flash、deepseek-v4-flash、deepseek-v4-flash-vision-exp 和 deepseek-v4-pro。按请求开始时间及 2026 年中国节假日判断峰谷；未知模型或其他日历年份仅记录用量。价表随插件版本更新，并非实时拉取。

名称与分组调整会更新历史报表的展示，修改单价只影响后续调用。已有自定义配置不会被升级覆盖。重置／删除账本配置保留 DSH 模型配置与历史调用。历史及停用路由单独折叠展示；只有账本配置、没有历史和当前模型配置的路由，删除后会从列表消失。

统计边界与本地数据

- CNY/USD 是展示折算，固定使用 1 CNY = 0.14 USD，不是实时汇率，也不是供应商的币种结算比例。
- 调用结束并上报用量后计入；页面可见时每 10 秒刷新。「今日」按客户端本地日历计算。
- 金额是估算费用，不是官方账单、余额、预算或订阅扣费。部分调用未计价时，只汇总已知费用。
- 历史金额和原始单价不变。疑似将 USD 数字标成 CNY 的旧记录会显示提示，不自动重算。
- 非缓存输入与缓存 Token 分开计价，推理 Token 不重复累加；适配器需要提供兼容的标准化用量。
- 安装前的调用不补录。缺失用量无法恢复，当前进程会显示缺失次数。嵌套调用会去重，但一个外层调用扇出多个上游流仍可能漏计。
- 配置位于 $DSH_HOME/api-ledger/config.json；逐次记录保存在 records.jsonl，rollup.json 为派生汇总。未设置 DSH_HOME 时使用 ~/.dsh/api-ledger/。这些本地数据及凭据不随插件分发。内存最多保留最近 200,000 条记录。

开发与反馈

npm run check
npm test
npm pack --dry-run

测试覆盖计价边界、官方接口识别、历史金额不变、配置冲突、同源写入、流式捕获、报表周期、双语与四处展示。问题请提交到 Issues，使用匿名示例，不要上传 API Key 或私人会话日志。

许可证：MIT。