dsh-connect-sensenova-token-plan

dsh-connect-sensenova-token-plan

把商汤（SenseNova）接进 DSH 的 Plugins 页插件卡，并在会话输入框实时显示积分额度与用量胶囊。

安装 · 工作原理 · 更新日志 · 问题反馈

把商汤接进 DSH 的 Plugins 页插件卡，另在会话输入框右侧常驻一颗用量胶囊。三个 tab 按使用顺序排列：

• 积分额度——登录一次，实时查看积分余额、额度窗口与每模型消耗，令牌自动续期，之后无需再管；
• 接入 API——把商汤模型注册为 DSH provider，参与对话与出图；
• 小浣熊——微信扫码接入 xiaohuanxiong.com，上游限流较宽松的另一条商汤产品线，独立账号、独立积分。

后台另有 429 自愈：限频被误判为"额度耗尽"时在 Host 侧纠正回退避重试，模型不会无端"消失"。

AI 协作会话请先读 AGENTS.md——验证入口、红线与文档地图都在那里；过程文档与提交历史本身就是本仓库工作面的一部分。 三个常被外部审读问起的疑问，预答在这里：

• lib/ 与根 client.js 是入库的构建产物：github: 安装源不跑 prepack，不入库则直装即坏（docs/ADR.md ADR-005）
• docs/sensenova-api-reference/ 是商汤官方文档的本地容器，逐文件出处与许可见 THIRD_PARTY_NOTICES.md
• 本仓库由 AI 协作开发，其提交历史里的过程痕迹是工作方式的一部分，不是疏漏

分发面：npm 包只含 package.json#files 那 10 项（lib/、client.js、icon.svg、locale/、 cordis.patch.yml、README.md、CHANGELOG.md、THIRD_PARTY_NOTICES.md、LICENSE、 screenshots.json）。docs/、AGENTS.md、src/、test/、assets/ 不在包里——registry 页面上点 docs/… 会 404、写相对路径的截图会裂，所以本文的截图一律是 raw.githubusercontent.com 绝对地址，细则链接请到 GitHub 仓库看。

① 积分额度

把商汤 Token Plan 搬进 DSH，写代码时不用切网页就能盯住：

• 积分池：额度窗口（已用 / 剩余 / 百分比 / 重置时间）、返赠余额与到期时间
• 模型清单：套餐覆盖 vs 当前 Key 实际能调，一眼看出哪些模型需要开通
• 每模型消耗：近 N 小时各模型积分排名，"烧分大户"一目了然

首次使用在「连接商汤控制台」填一次账号和密码，之后令牌自动续期。

• 登录失败时表单会直接显示商汤返回的原因（含「3 次错误锁 15 分钟」这类平台硬规则）；
• 想清除账号，用面板底部的按钮。

② 接入 API（可选，默认关）

把商汤模型注册为 DSH provider，参与对话与出图。

• 在「API Key」卡粘贴 sk- Key 保存后，Host 即以 sensenova-token-plan 之名注册 OpenAI 兼容 provider
• 语言模型：模型列表随 /v1/models 自动刷新、可看图模型自动带图片输入；
• 出图工具：Host 给 agent 注册工具 sensenova_draw_image；模型由 catalog 的 output_modalities 结构化判定。
• 开关、勾选与出图模型偏好都在面板热生效，无需重启**——**出图工具本身也在同一会话内随即挂载/卸载。细节见 docs/SETUP.md §4 与 docs/PROVIDER-HOT-RELOAD.md。

③ 小浣熊（可选，默认关）

微信扫码登录 xiaohuanxiong.com 网关，独立账号、独立积分余额。

• 上游限流较宽松，适合当作 Token Plan 硬配额池之外的日常通道
• 登录后显示积分余额与模型清单
• 每个模型带上下文窗口 / 最大输出与积分倍率（free / ×0.75 这类，由网关目录声明；目录没给就不显示，不猜）
• 联网搜索（默认关）：开启后 DSH 的 web_search 工具后端换成小浣熊托管的 MCP，复用小浣熊凭据，无需再单独配搜索端点 key

输入框用量胶囊

会话输入框右侧常驻一颗用量胶囊，直接显示当前模型正在烧谁的配额；点一下展开额度卡，看得到原始用量、精确重置时刻与池归属。

• 不是第四个 tab：面板关着它也在，切模型即换读数，永远不会显示上一个模型的额度
• 两档读数各自归口：商汤档读 5 小时 / 每周两个滚动窗口，小浣熊档读积分余额（网关未声明上限，不换算百分比）
• 套餐名前缀（商汤 · / 浣熊 · ）说明下面的数字属于哪套额度
• 网关多了新模型时，小浣熊档的读数后面会挂一段 · N 新模型（名字在 tooltip 里，最多三个，7 天后自行消失）。这里的「新」是本机第一次见到它，不是上游的上架时间——网关目录没有这个字段；首次安装时整张名单按「早就见过」记，不会全报成新的

边界

• 面板不代你操作账务：不改套餐、不代扣积分、不碰 Key 明文
• 数据来自商汤控制台自己的 API，与网页控制台口径一致
• 真正会「动」的四部分——注册 provider、挂出图工具、接第二个上游、切换联网搜索——全部 opt-in 且默认关闭，不打开时插件退化为纯信息展示

安装

1. 在 DSH「插件」页搜索 dsh-connect-sensenova-token-plan 点击安装，或运行：

   dsh plugin --profile web add dsh-connect-sensenova-token-plan       # Web 端
   dsh plugin --profile desktop add dsh-connect-sensenova-token-plan  # 桌面端
   

2. 完全退出 DSH（含托盘）再启动。

3. 打开 DSH 的 Plugins 页，找到本插件的插件卡（面板是页内的内联卡片，不在侧边栏）。

找不到入口，或从局域网 IP 打开时面板报 forbidden？见 docs/TROUBLESHOOTING.md D 节。

它是怎么工作的

登录原理：

• Host 在后台用商汤标准登录拿令牌，并自动续期（refresh_token 到期前自动换新，所以不用你再输密码）
• 面板打开时才轮询一个只读本地路由，关掉即停
• 协议细节（OIDC/PKCE、密码 JWE 封包、防锁号节流）见 docs/AUTH.md，接口契约见 docs/SENSENOVA-API.md

文档

• docs/ARCHITECTURE.md — 架构与数据流
• docs/SETUP.md — 配置字段、改动后重启、常见信号
• docs/AUTH.md — 登录 / 续期 / 节流设计
• docs/API.md — 路由与控制台端点
• docs/TESTING.md — 测试体系
• docs/SENSENOVA-API.md — 商汤接口全集（实测）
• docs/PITFALLS.md — 真实踩坑（现象→根因→修法；条数见该文件头，别在这里写死）
• CHANGELOG.md — 版本变化
• docs/README.md — docs/ 全量索引（含 ADR / ROADMAP / PROVIDER-HOT-RELOAD / TROUBLESHOOTING 等上表未列的）

装到 npm 的那一份 不含 docs/（package.json 的 files 白名单只带 cordis.patch.yml / README / CHANGELOG / THIRD_PARTY_NOTICES 等），上列 docs/* 链接在已安装副本上不可用，请到 GitHub 仓库看。

运维诊断：这台机器现在挂没挂 provider？

• 遇到问题先看 docs/TROUBLESHOOTING.md——它按你看到的现象组织（额度栏空的、反复要求登录、模型不出现、改了代码没生效…），而不是按主题；每条带稳定症状码，doctor --json 的 symptoms 字段直接给症状码，人和 agent 走同一条路。
• provider / 出图开关的生效值存在插件私有状态文件里，不在任何配置或路由上。按 profile 分段（见 docs/PITFALLS.md §23）：$DSH_HOME/state/<profile>/<name>/，取不到 profile 名时退回共享目录 $DSH_HOME/state/<name>/——查"到底开没开"用 doctor，它只读状态文件、不碰凭据，Host 没起也能跑：

npm run doctor          # 人读：每个 profile 的 provider / draw 开关与模型清单
npm run doctor:json     # 机器读：JSON（可进你的巡检 / 工单脚本）

诚实声明

• 面板显示的是控制台自己的口径，与网页控制台一致；GET /v1/models 只区分权限，不计费也不占推理额度；
• 续期在令牌过期前触发；若 refresh_token 被吊销且环境里已无密码，面板会明确提示重新登录，而不是静默显示旧数据；
• 凭据（账号、access/refresh token）只经 DSH 凭据服务保存，密码不落盘；本插件不写任何明文凭据文件或调试日志。

许可证

MIT License（Copyright (c) 2026 eghrhegpe），全文见 LICENSE；第三方依赖与合规说明见 THIRD_PARTY_NOTICES.md。