前言¶
DeepSeek Harness（DSH）采用插件化架构。在使用过程中，除了模型切换和对话交互，开发者往往需要直观地查看当前资源状态与本地调用记录。dsh-signal 专注于视觉展示与只读状态监控，不涉及登录逻辑或路由修改。
是什么¶
dsh-signal 是一个独立的 Web UI 与观测插件，由 Ricardo-WJP 维护。它为 DSH 增加了水面折射品牌动效、真实余额与剩余额度显示、模型工作说明翻译以及本地 Token 用量统计。
核心功能¶
dsh-signal 提供以下能力：
- 品牌与视觉：提供点阵水流、随指针响应的蓝色折射效果。支持浅深主题切换与减少动态选项。外观参考 Magic UI Border Beam 与 Aceternity Glowing Effect，以原生 CSS 实现。
- 资源监控：显示品牌/订阅身份与可信资源数据。额度条长度代表剩余多少。支持 DeepSeek、OpenCode Go、OpenRouter、Moonshot/Kimi、SiliconFlow 等供应商。Codex 额度需配合 Codex Connect 使用。
- 工作说明：将工具类别翻译为通俗动作，不展示参数。
- 本地统计：提供 Token 日历、筛选、周视图和累计统计。不读取聊天正文，不根据 Token 猜测费用。
安装与启用¶
使用前请确保系统已安装 Node.js 22+ 和 DeepSeek Harness。
推荐使用 npm 安装当前版本 0.6.12：
npx @deepseek-ai/dsh plugin --profile web add dsh-signal@0.6.12
如需从 GitHub 安装已构建版本：
npx @deepseek-ai/dsh plugin --profile web add github:Ricardo-WJP/dsh-signal#v0.6.12
使用其他 profile 时，请将 web 替换为对应名称。
数据与隐私¶
- 凭据安全：余额凭据由 DSH Host 读取，仅向固定或严格允许列表内的官方 HTTPS 端点发送。浏览器不会得到原始凭据。
- 本地统计：用量统计仅读取本地会话的结构化 Token 记录，不上传统计数据。
- 刷新机制：前台调度约 45 秒轮询一次，展开页面、切换模型或任务完成时触发刷新。后台暂停非必要刷新。请求合并、节流和失败退避可能延后读取。供应商缓存仍可能导致延迟，这不是实时推送。
开发¶
插件包含纯逻辑与刷新调度回归测试。如需自行构建：
npm ci
npm run build:client
npm run check
npm pack --dry-run
适用场景¶
适合需要直观视觉反馈和本地调用统计的开发者。注意：这不是登录插件，不修改模型路由，不自动切换模型。
