前言¶
在 DeepSeek Harness（DSH）里长时间跑会话时，模型供应商的余额、额度窗口是否够用，往往要切到控制台或第三方页面单独查；同时，工具等待授权、模型追问、回合结束或生成失败时，若窗口不在前台，也容易错过。社区里曾有 dsh-model-usage 与 dsh-reminding 两个独立插件分别承担用量与提醒。维护者 liuchaoxu 将二者合并为 dsh-assistant-suite（助手套件）：会话头部查看用量，设置 → 助手套件 统一管理通知与面板显示。下文介绍其定位、能力与安装用法；事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-assistant-suite 是面向 DeepSeek Harness 的社区插件（npm 包名同 dsh-assistant-suite，当前资料版本 0.1.1，MIT License）。它提供：
- 模型供应商账户的用量查询、余额消耗趋势（Command Code）；
- 系统提醒（授权、提问、回合完成、失败或截断等）。
界面支持深浅色主题、磨砂玻璃面板与窄屏布局，中英文随 DSH 应用语言切换。插件目录页：https://www.skillhub.cn/plugins/liuchaoxu/dsh-assistant-suite。SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
环境要求¶
| 项目 | 要求 |
|---|---|
| DeepSeek Harness | >=0.2.1-rc.2；清单声明兼容 0.2.1-rc.2、0.2.1-rc.5 |
| Node.js | >=18 |
| 界面 | DSH 桌面应用或 Web 界面 |
| 系统通知 | 浏览器或桌面环境支持 Notification API，并允许通知 |
客户端无 npm 运行时依赖；react、react-dom 由 DSH 提供。
核心功能¶
供应商用量¶
点击会话头部的 用量。默认 跟随会话模型，查询当前模型对应供应商账户的余额、额度窗口与请求数；通过 查询对象 可手动切换查询目标，不改变会话实际使用的模型。密钥由宿主按供应商凭据引用读取，浏览器不接收密钥值。
当前 README 列出的适配来源包括 Command Code、DeepSeek API、DeepSeek 登录账户、OpenCode Go、OpenRouter、Moonshot / Kimi、SiliconFlow，以及对带 baseURL 的 OpenAI 兼容路由尝试 New API 的 /api/user/self 约定。各供应商返回字段不同，插件只展示实际返回的数据；OpenCode Zen 按量计费路由无对应适配，不应与 OpenCode Go 混淆。
刷新与时效：
- 默认开启自动刷新，间隔 5 分钟；可选 1、5、15、30、60 分钟，或自定义 1–1440 分钟。
- 刷新时间右侧图标可立即查询；查询中按钮暂时禁用。
- 失败时保留上次成功数据并显示错误；首次失败则显示错误与重试入口。
余额消耗趋势（Command Code）¶
会话组件运行期间，按系统时钟每十分钟整点（:00、:10、:20 等）采样，与面板自动刷新开关独立。记录保存在浏览器本地，保留当前自然月及前两个月。支持今天、昨天、近一周、近一月、自定义日期；点击图表可打开独立大图。可按月份清理或重置当前账户记录。
系统提醒¶
在 设置 → 助手套件 上方管理通知开关与 测试 权限。提醒时机包括：工具等待授权、模型提问 / 计划审阅、回合完成、生成失败或输出截断。点击真实通知可返回对应会话；前台且正在查看同一会话时会抑制通知。子代理会话不单独提醒。
下方可配置用量弹框显示项：余额与额度 为固定核心内容，其余如用量入口、刷新状态、历史趋势、数据来源等可按需显示或隐藏；修改立即生效并保存在本机。
从旧插件迁移¶
启用本套件后，应停用原来的 dsh-model-usage 和 dsh-reminding，避免重复入口、提醒及相同路由。套件保留旧功能的本地存储键；在相同浏览器配置及站点来源下，原有刷新设置、查询对象、历史记录和提醒开关可继续读取。用量显示选项使用套件独立的存储键。
安装与启用¶
DSH 生态里插件可通过界面或 CLI 安装；安装后需确认已启用并重新加载界面，必要时重启应用以加载主机端代码。
插件页面¶
在 DSH 的 Plugins / 插件 页面安装 dsh-assistant-suite 并启用。npm 包发布后可按包名安装；本地开发可通过插件管理工具的 install_bundle 将目标指向项目目录。
CLI¶
对允许 CLI 管理的 profile，使用 README 中的命令：
dsh plugin --profile <profile> add dsh-assistant-suite
本地目录安装：
dsh plugin --profile <profile> add link:/absolute/path/to/dsh-assistant-suite
安装后在插件页面确认已启用。单独执行 npm install 只下载 npm 包，不会自动在 DSH 中启用插件。
典型用法¶
- 安装并启用插件，重新加载 DSH 界面。
- 打开任意会话，点击头部 用量，确认查询对象与账户数据；需要时点击刷新图标或调整自动刷新间隔。
- 使用 Command Code 时，在用量面板查看余额消耗趋势；需要大图或自定义时间段时点击图表。
- 打开 设置 → 助手套件，完成通知 测试 授权，按需开关提醒与面板显示项。
- 若曾安装独立用量 / 提醒插件，停用
dsh-model-usage与dsh-reminding，避免重复。
适用场景与注意¶
适合谁： 在 DSH 中频繁切换模型或供应商、需要就地查看余额与额度、并希望在前台外也能收到授权与回合相关提醒的开发者。
权限与安全： 供应商查询在 宿主进程 执行，会访问相应供应商 API；提醒通过宿主本地路由传递。插件以当前 DSH 进程权限运行，安装前应阅读源码与 MIT 许可证，自行评估凭据与网络访问范围。
数据： 刷新策略、查询对象、历史与显示开关保存在浏览器 localStorage，按浏览器配置及站点来源隔离；清除站点数据会同时清除本地趋势历史。历史趋势不同步到其他浏览器或站点来源。
常见问题： 无用量入口时检查插件启用与显示设置；收不到通知时检查助手套件开关、系统与浏览器通知权限；余额失败时检查 设置 → 模型 中凭据与地址；重复按钮或提醒时检查旧插件或其他通知插件是否仍启用。
结尾¶
dsh-assistant-suite 把供应商用量面板与系统提醒收进一个插件，并在 设置 → 助手套件 统一配置。需要进一步了解或反馈问题，可访问 SkillHub 目录页 与 GitHub 仓库。
