前言¶
用 DeepSeek Harness（DSH）做智能体开发时，若上游选用商汤 SenseNova Token Plan，额度、模型权限和实际消耗往往要切到网页控制台核对；把模型注册进 DSH、处理限频与配额误判，又需要单独配 Key 和 provider。维护者 eghrhegpe 的插件 dsh-connect-sensenova-token-plan（分类：联网工具）把商汤 Token Plan 接进 DSH 的 Plugins 页插件卡，并在会话输入框右侧提供常驻用量胶囊；可选地把商汤模型注册为 DSH provider、接入小浣熊网关，并在 Host 侧对 429 做退避重试，避免限频被当成「额度耗尽」后模型从列表里消失。
下面按定位、功能、安装与典型用法说明，事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-connect-sensenova-token-plan 是 DSH 社区插件（npm 包名同插件搜索名），当前资料中版本为 0.8.1，MIT 许可证。它不替代商汤账务操作：不改套餐、不代扣积分、不在面板里长期保存 Key 明文；默认以信息展示为主（积分与消耗），真正会改动 Host 行为的四项——注册 provider、挂出图工具、接小浣熊上游、切换联网搜索——均为 opt-in 且默认关闭。
面板是 Plugins 页内的内联卡片，不在侧边栏；数据来自商汤控制台 API，与网页控制台口径一致。
核心功能¶
三个 Tab（按使用顺序）¶
-
积分额度
首次在「连接商汤控制台」填写账号与密码，Host 在后台完成标准登录并自动续期（refresh_token 到期前换新，一般无需再输密码）。面板打开时轮询只读本地路由，关闭即停。可查看：积分池（额度窗口、已用/剩余/百分比/重置时间、返赠余额与到期）、模型清单（套餐覆盖 vs 当前 Key 实际可调）、近 N 小时各模型积分消耗排名。登录失败时表单展示商汤返回原因（含平台规则如多次错误锁定）；清除账号用面板底部按钮。 -
接入 API（可选，默认关）
在「API Key」卡粘贴sk-Key 保存后，Host 以sensenova-token-plan注册 OpenAI 兼容 provider，参与对话与出图。语言模型列表随/v1/models刷新，可看图模型自动带图片输入；出图侧 Host 为 agent 注册工具sensenova_draw_image，模型由 catalog 的output_modalities判定。开关与勾选在面板热生效，但工具的实际挂载/缺席发生在下一次 Host 启动（细节见仓库docs/SETUP.md、docs/PROVIDER-HOT-RELOAD.md）。 -
小浣熊（可选，默认关）
微信扫码登录xiaohuanxiong.com网关，独立账号与独立积分；上游限流相对宽松，可作 Token Plan 硬配额之外的日常通道。登录后显示积分余额与模型清单，各模型展示上下文窗口、最大输出及网关声明的积分倍率（如free、×0.75；目录未声明则不显示）。联网搜索（默认关）：开启后 DSH 的web_search后端改为小浣熊托管 MCP，复用小浣熊凭据。
输入框用量胶囊¶
会话输入框右侧常驻用量胶囊，显示当前模型正在消耗哪套配额；点击可展开额度卡（原始用量、重置时刻、池归属）。切模型即换读数，不保留上一模型读数。商汤档对应 5 小时/每周等滚动窗口，小浣熊档读积分余额；前缀 商汤 · / 浣熊 · 标明归属。
429 自愈¶
限频被误判为额度耗尽时，Host 侧纠正并退避重试，避免模型无端从可用列表中消失。
安装与启用¶
- 在 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（含系统托盘）后再启动。
-
打开 Plugins 页，在本插件卡片内使用三个 Tab 与登录表单。
社区目录页：SkillHub - dsh-connect-sensenova-token-plan。DSH 生态强调「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
只盯额度（最常见默认路径）
安装并重启 → Plugins 页打开本插件 →「积分额度」Tab 连接商汤控制台 → 日常在输入框右侧胶囊查看当前模型配额，需要明细时再点开卡片或回到「积分额度」Tab 看模型消耗排名。
要在 DSH 里直接调商汤模型
在「接入 API」Tab 打开开关并保存 sk- Key → 按文档确认需重启 Host 的场景（出图工具挂载）→ 在 DSH 模型选择中使用 sensenova-token-plan provider。
小浣熊 + 可选联网搜索
「小浣熊」Tab 微信扫码登录 → 按需开启模型与「联网搜索」→ 凭据与小浣熊通道复用，无需单独配搜索端点 Key。
排查 provider 是否生效
provider / 出图开关值在插件私有状态文件中（按 profile 分段，见仓库 docs/PITFALLS.md）。在插件源码目录可运行：
npm run doctor # 人类可读：各 profile 的 provider / draw 开关与模型清单
npm run doctor:json # JSON，便于巡检脚本
现象导向排查见仓库 docs/TROUBLESHOOTING.md；doctor --json 的 symptoms 与文档中的症状码对齐。
适用场景与注意¶
适合谁
已在用或计划用商汤 Token Plan 的 DSH 用户：希望少切网页、在会话旁看配额，并可选地把商汤/小浣熊接进同一 Host。
安全与权限
插件以当前 DSH 进程权限运行；安装前建议阅读 GitHub 源码 与 LICENSE。凭据经 DSH 凭据服务保存，资料说明密码不落盘，插件不写明文凭据文件或调试日志。若 refresh_token 被吊销且环境无密码，面板会提示重新登录而非静默展示旧数据。
边界
GET /v1/models 仅区分权限，不计费、不占推理额度；面板不代操作账务。npm 发布包不含完整 docs/，深度配置与踩坑列表请在 GitHub 仓库查看（如 docs/AUTH.md、docs/SENSENOVA-API.md、docs/PITFALLS.md）。
结尾¶
dsh-connect-sensenova-token-plan 把商汤 Token Plan 的额度可视化和可选 API/小浣熊接入收拢到 DSH Plugins 页与输入框胶囊，默认只做展示，扩展能力按需打开。目录与安装入口见 SkillHub 插件页，源码与文档见 GitHub。
