前言¶
DeepSeek Harness（DSH）的理念是「一切皆插件」。如果你在用 Web UI 或 Desktop 端，右下角总会多一个挂件入口。在 ChatGPT / Codex 订阅额度管理上，常见做法要么依赖桌面端的挂件（需要额外安装）、要么在浏览器里输入 API Key。前者多了一层依赖，后者把敏感凭据放进浏览器。下面介绍的 dsh-gpt-niang 是一个 DSH 原生插件，用一只可交互的桌宠承载额度信息，且额度由宿主侧插件直连后端获取，令牌不进入浏览器。
这是什么¶
dsh-gpt-niang 是 DeepSeek Harness 的一个桌面挂件插件，由 Deepsleep-one 维护。它把一只可拖拽、可抛掷、可散步、会打瞌睡的桌宠挂在 Web UI 和 Desktop 页面右下角，点击后弹出 OpenAI / Codex 订阅额度气泡，展示 5 小时窗口与周上限、模型级可用性、积分与附加额度池，并在额度警戒时发出告警音。该插件纯 DSH 实现，不依赖 Codex 桌面端、不需要本机安装 Node 或 PowerShell、不写开机自启、不注册计划任务。
核心功能¶
桌宠交互¶
| 操作 | 效果 |
|---|---|
| 左键点击 | 开/关额度面板，角色蹦一下并「叮」一声 |
| 拖拽 | 跟着指针走，身体按速度倾斜（±13°） |
| 松手（有位移） | 抛出去：重力 2100px/s²，撞墙/落地反弹并带摩擦，停下后记住落点 |
| 右键 | 8 项菜单（见下表） |
| 放着不管 5 分钟 | 打瞌睡，头顶飘 Z z；点一下先「唔…我醒了」，第一下只唤醒不开面板 |
落点、缩放、折叠状态、音效开关全部记在 localStorage。重力只在被抛出后的飞行阶段生效，所以手动把角色摆到半空它不会自己掉下去。
右键菜单：
| 项 | 作用 |
|---|---|
| 刷新额度 | 强制刷新（绕过 45s 缓存） |
| 散步：开 / 关 | 沿窗口底部来回走，走走停停（默认关） |
| 闲聊：开 / 关 | 每 1.5–4 分钟冒一句话，额度紧张时换语气（默认开） |
| 放大一点 / 缩小一点 | 缩放 0.75–1.6 |
| 音效：开 / 关 | 点击「叮」声 |
| 告警音：开 / 关 | 额度警戒时的提示音（独立开关） |
| 复位位置 / 复位大小 | 回到右下角默认 |
角色图加载失败时会自动退回内联 SVG 小人，不会留一个破图占位。
额度面板¶
打开时强制刷新一次，之后每 60s 轮询；Esc 或点空白处关闭。面板包含：
- 5 小时窗口 / 周上限：百分比 + 进度条 + 重置时间（
MM-DD HH:mm（N 小时后）） - 模型用量：按模型列出可用性。
model_usage只给「是否可用 / 何时可用 / 是否需积分」，默认显示状态 chip（可用/x 可用/需积分/不可用）；只有当接口真的下发了百分比时才画进度条，绝不编造数字 - 积分与附加：余额、超额是否已达上限、花费控制、附加额度池（有则显示）
- 每个分区点标题栏即可折叠，折叠状态记在 localStorage
配色与告警：剩余 ≤30% 变黄、≤10% 变红并让角色轻微抖动、状态点呼吸。告警音只在变差跨线时响一次（10% 警戒三连降调，30% 警戒两连音），额度恢复后再次掉下去还会重新响，不会每轮轮询都吵你。
安装与启用¶
插件代码托管在 GitHub 仓库 Deepsleep-one/dsh-gpt-niang。安装前需要 OpenAI Codex 的登录凭据，任一即可（优先级顺序见前置条件）。
git clone https://github.com/Deepsleep-one/dsh-gpt-niang.git
# 安装（写工作区之外，需要 danger-full-access）
dsh plugin --profile desktop add 'link:<克隆下来的绝对路径>'
# 卸载
dsh plugin --profile desktop remove dsh-gpt-niang
装完重启 DSH Desktop（或刷新 Web UI）才会加载新 bundle；改 link 目录里的代码同样只需重启。本插件没有 @deepseek-ai/dsh* peer 依赖，不会被 profile 的兼容性闸门拦下。
典型用法¶
- 按上述命令安装插件并重启 DSH Desktop。
- 在 Web UI 或 Desktop 页面右下角会出现一只桌宠，默认静止在右下角。
- 左键点击桌宠，打开额度面板，查看 5 小时窗口、周上限、模型可用性、积分与附加额度。
- 右键桌宠，打开菜单，可开启散步、关闭闲聊、调整缩放、开启/关闭音效与告警音。
- 将桌宠拖出窗口再松手，可抛掷，观察其重力与反弹效果。
- 让桌宠在原地停留 5 分钟以上，它会打瞌睡；点击可唤醒并打开面板。
适用场景与注意¶
适合需要常驻查看 ChatGPT / Codex 订阅额度、希望以低侵入方式集成到 DSH 工作流中的开发者。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。代码采用 MIT 许可，角色立绘来自上游项目但不适用 MIT，仅供个人非商业使用；商用或做素材包分发需替换立绘或保留上游声明。
短结尾¶
dsh-gpt-niang 用一只桌宠把额度管理从「浏览器输入 Key」和「桌面端挂件」两种常见方案都绕过去，直接在 DSH 内部获取额度，减少依赖与安全风险。完整文档与源码见项目目录页与 GitHub 仓库。
