dsh-claude-usage 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-claude-usage 兼容性怎么样？

基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-claude-usage 有中文文档吗？

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

dsh-claude-usage 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/8/31。

Claude 套餐用量指示器 leonardoxr/dsh-claude-usage

DeepSeek Harness

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

在 GitHub 查看 ↗

在设置栏实时查看 Claude 套餐配额与重置时间

34.1/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

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

自动兼容检查有告警：未发布到 npm registry，仅可从源码安装。

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

dsh plugin --profile web add leonardoxr/dsh-claude-usage

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

状态速览

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

信任档位：需留意

是什么

dsh 原生插件 · model

装得上吗

实装验证未通过（unknown），装前请到仓库确认最近更新与 issue

L4 · 真实安装等级说明 →

安全吗

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

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

还在维护吗

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

档位由哪些信号合成

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

验证判据与等级说明 →

⚠︎ 实装验证未通过（unknown · 2026/10/26） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。

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

安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-claude-usage（未发布到 npm，仅可源码安装）

✓Node 引擎要求 >=20 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/24 14:51:40

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

v2.7.0

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

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

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

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

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

发起网络请求
src/client/store.ts:38
this.inFlight = this.fetch(force)
发起网络请求
src/client/store.ts:46
private async fetch(force: boolean): Promise<void> {
发起网络请求
src/client/store.ts:49
const response = await fetch(`/api/plugins/claude-usage${force ? '?refresh=1' : ''}`, {
读取本地文件
src/credentials.ts:52
raw = readFileSync(file, 'utf8')
发起网络请求
src/usage-api.ts:39
const response = await fetch(options.endpoint ?? DEFAULT_USAGE_ENDPOINT, {
发起网络请求
src/usage-service.ts:73
this.inFlight = this.fetch()
发起网络请求
src/usage-service.ts:96
private async fetch(): Promise<ClaudeUsageResponse> {

扫描于 2026/11/3（0 天前） · 范围全包扫描（包内未声明入口） · 来源 GitHub 仓库

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

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-settings@deepseek-ai/dsh-client-ui-settings-plugins@deepseek-ai/dsh-client-ui-sidebar@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-host-webserver@deepseek-ai/dsh-settings@deepseek-ai/schemastery

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

用户评分

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

广告精选好物

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

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

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

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

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

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

查 MCP 兼容性→

功能亮点

实时查看套餐配额
显示重置时间

DeepSeek Harness 的 Anthropic Claude 套餐用量指示器

README

由 DeepSeek 最新模型翻译生成

dsh-claude-usage 一款精致的 Anthropic Claude 套餐用量指示器，适用于 DeepSeek Harness Web UI。该插件保留标准的 Settings 齿轮图标和标签，同时在最右侧添加一个上下文用量表样式的圆环。圆环内含 Anthropic 标志，并会在鼠标悬停或键盘聚焦时打开详细的配额面板。功能特性 - 外观原生的用量圆环，使用与对话上下文用量表相同的 28 px 几何尺寸和 DSH 设计令牌。 - 完整展示 Claude 套餐限制的配额详情：5-hour 会话窗口、每周窗口、限定模型的每周限制、额外用量状态、套餐和速率限制层级。 - 默认每五分钟轮询一次，可通过 bundle row 配置。 - 鼠标悬停时获取新鲜数据，具备 250 ms 防抖、单个进行中的请求、共享的五分钟轮询缓存、更短的强制悬停缓存以及失败节流。 - 遵循 Anthropic 的 Retry-After 冷却时间；usage endpoint 本身会对激进轮询进行速率限制。 - 保留最后一次成功结果，因此临时的 provider 或网络故障不会清除有用数据。 - 只读凭据访问：插件绝不会写入或刷新 Claude Code 存储的登录信息。

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

dsh-claude-usage

一款精致的 Anthropic Claude 套餐用量指示器，适用于 DeepSeek Harness Web UI。

该插件保留标准的 Settings 齿轮图标和标签，同时在最右侧添加一个上下文用量表样式的圆环。圆环内含 Anthropic 标志，并会在鼠标悬停或键盘聚焦时打开详细的配额面板。

功能特性

- 外观原生的用量圆环，使用与对话上下文用量表相同的 28 px 几何尺寸和 DSH 设计令牌。
- 完整展示 Claude 套餐限制的配额详情：5-hour 会话窗口、每周窗口、限定模型的每周限制、额外用量状态、套餐和速率限制层级。
- 默认每五分钟轮询一次，可通过 bundle row 配置。
- 鼠标悬停时获取新鲜数据，具备 250 ms 防抖、单个进行中的请求、共享的五分钟轮询缓存、更短的强制悬停缓存以及失败节流。
- 遵循 Anthropic 的 Retry-After 冷却时间；usage endpoint 本身会对激进轮询进行速率限制。
- 保留最后一次成功结果，因此临时的 provider 或网络故障不会清除有用数据。
- 只读凭据访问：插件绝不会写入或刷新 Claude Code 存储的登录信息。
- 仅限 loopback 的 API route，以及一个会移除 token、identifier、email 和未知 provider field 的 allowlist normalizer。

要求

- Node.js 20 或更高版本
- pnpm 10
- DeepSeek Harness 0.1.1-rc.2 或兼容版本
- 已使用 Claude 订阅登录的较新版本 Claude Code CLI（claude login）；在 Claude Code 持有有效登录信息之前，指示器会显示指向 claude login 的错误状态
- Windows 或 Linux；Claude Code 在这些系统上将 OAuth credentials 存储于 ~/.claude/.credentials.json（macOS 将 credentials 保存在 Keychain 中，目前尚不支持）

从此 checkout 安装

构建 package：

~~~sh
pnpm install
pnpm run check

从此目录将其添加到 DSH profile：

~~~sh
dsh plugin --profile web add .
dsh --profile web --dump-config
dsh web

开发期间，只有在运行 pnpm run dev 并重新构建插件输出时，Host 更改才会热重载。浏览器客户端更改需要重新构建，然后刷新现有 Web 页面。client bundle 由 DSH 的 client-module system 加载；既不需要也不应使用单独的 Vite server。

使用以下命令移除：

~~~sh
dsh plugin --profile web remove dsh-claude-usage

安装打包产物

tarball 随附预构建的 Host 和 lazy-CJS client artifacts，从而避免安装时的构建批准：

~~~sh
pnpm pack
dsh plugin --profile web add ./dsh-claude-usage-0.1.3.tgz

对于 Git-host 安装，pnpm 10 要求 profile 允许此 package 的 prepare script。请固定一个 commit，并严格遵循 DSH/pnpm 输出的 allowBuilds 指令。

配置

所有四个 field 均可在 Settings → Plugins → Claude usage 中使用。更改会在本地暂存直至点击 Save，通过 DSH Settings 持久化；已保存的设置/profile patch 会实时生效，无需重启。profile row 仍是已保存用户覆盖项之下的基础配置。

bundle 会插入以下 row：

~~~yaml
- id: claude-usage
name: dsh-claude-usage
config:
refreshIntervalMs: 300000
hoverRefreshMinAgeMs: 30000
requestTimeoutMs: 15000
credentialsFile: ''

在 profile 的 cordis.patch.yml 中覆盖整个 row，以更改 composition-layer base。后续 layer 会替换一个 row 的完整 config value；已保存的 Settings UI value 会覆盖该 base。

| 字段 | 默认值 | 含义 |
| refreshIntervalMs | 300000 | 后台轮询间隔；最短 60 seconds。 |
| hoverRefreshMinAgeMs | 30000 | 再次悬停刷新前的最短数据年龄；最短 5 seconds。 |
| requestTimeoutMs | 15000 | 每次 Anthropic usage request 的超时时间。 |
| credentialsFile | (empty) | Claude Code credentials file 的可选绝对路径；留空会选择各 OS 的默认位置。 |

工作原理

1. Host plugin 注入 DSH 的 webServer service，并注册 GET /api/plugins/claude-usage。
2. 每次读取时，它都会在 credentials file 中只读查找 Claude Code OAuth access token。
3. 它会调用 Anthropic 的 OAuth usage endpoint——即 Claude Code 的 /usage command 背后同一个未公开的 beta API——并携带 oauth-2025-04-20 beta header。
4. strict normalizer 将仅含配额的数据（percentages、ISO reset times、extra-usage flags）返回至 loopback browser route。
5. browser 在 sidebar.footer.action 中注册一个独立 action，在 Settings row 的右边缘预留空间，并保持内置 Settings button 及其行为不变。
6. browser 按配置的 cadence 轮询，并在 250 ms hover debounce 后请求一次合并刷新。

过期 token 会在本地被检测到，并显示 "run claude login" 错误状态，而不是持续冲击 endpoint；Claude Code 会在正常使用过程中刷新自己的登录信息。429 response 会启用感知 Retry-After 的冷却机制，确保后台轮询绝不与 Anthropic 的 rate limiter 冲突。

client artifact 并非普通的 browser ESM。tsdown.config.ts 会生成 DSH 所需的 lazy-CJS registration。React 和 DSH UI packages 保持 external，并通过 DSH 的 client module table 解析，以防止重复的 React runtime。

安全与隐私

- 插件会读取 credentials file，但绝不会存储、传输、记录或刷新 token；access token 仅在一次请求期间存在于 Host process 内。
- Web route 仅接受来自 loopback client 的 GET，并拒绝跨站 Origin、Referer 和 Fetch Metadata signals。
- response 会省略 token、account/workspace/user IDs、email、原始 provider payload 和未知 field；normalization 后仅保留经过范围约束的 percentages、reset timestamps、label 和 boolean flags。
- 错误消息为静态字符串，绝不会回显 credential path 或 provider response。
- 除可选的本地 credentials path 外，provider route 不可配置，从而避免成为任意 authenticated proxy。

开发

~~~sh
pnpm run typecheck
pnpm run test
pnpm run build
pnpm run pack:check

默认 suite 会跳过 live provider test。请在已安装 Claude Code 并完成登录时运行：

~~~powershell
$env:CLAUDE_LIVE = '1'
pnpm exec vitest run tests/claude-live.spec.ts

参考资料

- DSH：第一个插件
- DSH：打包与安装
- DSH：添加设置卡片
- DSH：客户端模块
- ccusage — Claude Code 的本地 transcript analytics
- OAuth usage contract 的社区确认：LimitsChecker、claude-usage-widget

许可证

MIT