dsh-connect-sensenova-token-plan
把商汤接进 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 协作开发，其提交历史里的过程痕迹是工作方式的一部分，不是疏漏
① 积分额度
把商汤 Token Plan 搬进 DSH，写代码时不用切网页就能盯住：
- 积分池：额度窗口（已用 / 剩余 / 百分比 / 重置时间）、返赠余额与到期时间
- 模型清单：套餐覆盖 vs 当前 Key 实际能调，一眼看出哪些模型需要开通
- 每模型消耗：近 N 小时各模型积分排名，"烧分大户"一目了然
「积分额度」tab
首次使用在「连接商汤控制台」填一次账号和密码，之后令牌自动续期。
- 登录失败时表单会直接显示商汤返回的原因（含「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 结构化判定。
- 开关与勾选都在面板热生效，无需重启**，但工具的实际挂载 / 缺席发生在下一次 Host 启动**。细节见 docs/SETUP.md §4 与 docs/PROVIDER-HOT-RELOAD.md。
「接入 API」tab
③ 小浣熊（可选，默认关）
微信扫码登录 xiaohuanxiong.com 网关，独立账号、独立积分余额。
- 上游限流较宽松，适合当作 Token Plan 硬配额池之外的日常通道
- 登录后显示积分余额与模型清单
- 每个模型带上下文窗口 / 最大输出与积分倍率（
free / ×0.75 这类，由网关目录声明；目录没给就不显示，不猜）
- 联网搜索（默认关）：开启后 DSH 的
web_search 工具后端换成小浣熊托管的 MCP，复用小浣熊凭据，无需再单独配搜索端点 key
「小浣熊」tab
边界
- 面板不代你操作账务：不改套餐、不代扣积分、不碰 Key 明文
- 数据来自商汤控制台自己的 API，与网页控制台口径一致
- 真正会「动」的四部分——注册 provider、挂出图工具、接第二个上游、切换联网搜索——全部 opt-in 且默认关闭，不打开时插件退化为纯信息展示
安装
-
在 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 # 桌面端
-
完全退出 DSH（含托盘）再启动。
-
打开 DSH 的 Plugins 页，找到本插件的插件卡（面板是页内的内联卡片，不在侧边栏）。
它是怎么工作的
登录原理：
文档
装到 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。
