dsh-tlogs
DSH 内嵌用量组件（tlogs = token logs）：在 DeepSeek Harness 侧边栏页脚常驻显示 DeepSeek 开放平台账号的 Token 用量（总会话/项目/今日/当周/当月），含紧凑条、就地展开面板、详细数据视图。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:czk200518-hash/dsh-tlogs#7dcb60869e9d80cc07f50b46c2e62d7e6f1585aeTlogs 以 dsh-tlogs 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →English | 中文
tlogs 在 DSH 桌面端侧边栏页脚常驻显示 Token 用量，含紧凑条、展开面板与详细数据弹窗。
紧凑条常驻页脚：
在 DSH 窗口中的紧凑条展开后是七张卡片：
在 DSH 窗口中的展开面板| 形态 | 内容 |
|---|---|
| 紧凑条 | 总量、今日、请求数。↻ 刷新，▾ 展开 |
| 展开面板 | 总消耗、当前项目、今日、当周、当月、近 7 天、近 30 天 |
| 详细数据弹窗 | 日历、图表、模型、供应商、年、月、当月按天、设置 |
插件的界面语言在详细数据弹窗的设置页签里切换：
| 选项 | 含义 |
|---|---|
| 跟随系统（默认） | DSH 界面语言 → 浏览器语言 → 中文 |
| 中文 / English | 固定该语言 |
选择存在本机浏览器，插件重启后保持；只影响本插件界面，不改 DSH 自身语言。
弹窗按页签组织。图表页签的三张图共享同一套控制项（范围 × 数据源 × 指标 × 粒度），切换任意一项三张图一起变：
用量趋势（折线） 构成占比（饼状） 用量分布（柱状，三段堆叠 + 请求数虚线）日历页签按月列出逐日用量与金额，点某一天看当天明细：
日历| 来源 | 覆盖 | 时效 | 金额 |
|---|---|---|---|
| 平台账单 | 账号全部设备，仅官方通道 | 滞后 10~30 分钟 | 有 |
| 本机会话日志 | 仅本机，含所有供应商 | 实时 | 无 |
两路逐日合并：max(平台, 本机官方通道) + 本机第三方供应商。同一次调用会被两路各记一次，因此取大而不相加。
第三方；其余口径细节见卡片 tooltip。deepseek-v4-flash 属第三方。四种方式：绝对路径、tarball、npm 包名、github:<user>/dsh-tlogs。lib/ 是已构建产物，安装不会构建。
desktop profile 不能用 CLI 安装，改用 设置 → 插件 → 安装；其它 profile 用 dsh plugin --profile web add dsh-tlogs。
安装后重启 DSH。实测 DSH 0.2.0-rc.2（desktop、web）。
| 顺序 | 来源 |
|---|---|
| 1 | 环境变量 DEEPSEEK_PLATFORM_USER_TOKEN |
| 2 | 配置 platformUserToken（明文） |
| 3 | DSH 凭据 TLOGS_USER_TOKEN（面板填写） |
| 4 | 复用 DSH 已登录账号 |
| 5 | 内置登录窗口（桌面端不可用） |
前 3 项优先于自动来源；退出登录只清除第 3 项。
| 配置 | 默认 | 说明 |
|---|---|---|
exposeUsageToModel | false | 注册对话内查询工具 |
useAccountSession | true | 复用 DSH 账号凭据 |
localUsage / localUsageScanDays | true / 32 | 读会话日志与回溯天数 |
enableProjectScope | true | 当前项目卡片 |
persistHistory | true | 历史落盘 |
autoRefreshSeconds | 300 | 定时刷新间隔，0 关闭 |
cacheTTL.total / .current | 1800 / 300 | 缓存秒数 |
startYear / startMonth | 2024 / 4 | 历史起点 |
requestIntervalMs | 1000 | 月度请求间隔 |
numberFormat | short | full 千分位 / short K·M·B |
compactMetrics | [total, today] | 紧凑条指标 |
cacheDir | '' | 空为 <DSH_HOME>/tlogs |
compactMetrics 可选：total、today、week、month、last7、last30、cost_total、cost_today、cost_last7、cost_last30。
环境变量：DEEPSEEK_PLATFORM_USER_TOKEN、TLOGS_CACHE_DIR、DSH_HOME。
| 措施 | 说明 |
|---|---|
| 凭据 | 只暴露 getPlatformSession()；会话凭据仅刷新期间持有；失效标记只存摘要 |
| 网络 | 只连 platform.deepseek.com；不跟重定向；部署头白名单只放行 x- |
| 模型隔离 | 默认不注册工具；打开后项目 id 仍是不可逆哈希 |
| 会话日志 | 只读、只取计数与 provider/model，落盘只存路径哈希 |
| 发布闸门 | npm run verify:secrets |
最小权限配置：
exposeUsageToModel: false
useAccountSession: false
enableProjectScope: false
persistHistory: false
localUsage: false
架构
.credentials.yaml 同用户进程可读——本机凭据的主要暴露面，与插件无关。取舍
使用习惯
pnpm run check # 密钥闸门、文案外置校验、注释闸门、typecheck、build、测试
pnpm run verify:dsh # 用本机 DSH 解析器校验插件声明
pnpm run golden # 在线端到端对拍，需要 DEEPSEEK_PLATFORM_USER_TOKEN
test/golden.test.ts 缺外部 Python 参考脚本时跳过，用 TLOGS_REFERENCE_SCRIPT=<路径> 指定。
GPL-3.0-only，全文见 LICENSE。