dsh-rely
DeepSeek Harness 插件：输入框下方常驻显示 绿萝中转站 余额。支持阈值灯、可配置刷新间隔
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xiaoming132887/dsh-rely#1f9aeaca335cbeea761f8b9e19a39dca2965239aRely 以 dsh-rely 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness 用的插件：在聊天输入框正上方常驻一条极简状态条 —— 只有中转站名字 + 余额，数字的颜色本身就是状态灯。点一下展开设置抽屉，里面只留三个输入框：API Key / 刷新间隔 / 阈值。
┌──────────────────────────────┐
│ 绿萝 $35.49 │ ← 输入框上面这一行，点它开设置
├──────────────────────────────┤
│ 输入框… │
└──────────────────────────────┘
按顺序探测，第一个能解析出数字的胜出；全都拿不到就如实显示「查询失败」，不伪造数字。
| 中转站类型 | 请求 | 取的字段 |
|---|---|---|
| Sub2API | GET {base}/v1/usage?start_date=&end_date=&timezone= | remaining / quota.remaining（币种取 unit） |
| new-api | POST {base}/api/user/self | data.available_balance（美元）或 data.quota（500000 ≈ $1） |
| one-api | GET {base}/api/user/balance | balance |
| OpenAI 兼容额度 | GET {base}/v1/dashboard/billing/credit_grants | total_available |
认证一律 Authorization: Bearer <你的 sk-…>。
⚠️
hard_limit_usd（OpenAI 的账户硬上限）不是余额，本插件不会拿它顶替，取不到就空着 —— 这是踩过的坑。
dsh plugin --profile <你的 profile 名> add github:xiaoming132887/dsh-rely
git clone https://github.com/xiaoming132887/dsh-rely
dsh plugin --profile <你的 profile 名> add file:/绝对路径/dsh-rely
装完要重启一次 DSH：宿主半区（src/index.js，负责余额请求和 HTTP 路由）是 Node 模块，进程启动时只加载一次，停用/启用插件不会重新导入。
桌面端 profile 常叫
desktop，DSH 端一般是web；用哪个就看你的$DSH_HOME/profiles/下面有哪个目录。
点状态条 → 底部抽屉：
| 项 | 说明 |
|---|---|
| API Key | sk-…。留空保存 = 保留原 Key。已经保存过会显示打码值 + 🔒，要换得先点「更换 Key」。 |
| 服务端刷新（秒） | 宿主多久去中转站拉一次余额，1–60 秒。建议 30 秒以上：每次都拉一整段用量数据，太勤容易被限流。 |
| 绿线阈值 (USD) | 余额高于它 → 绿色 |
| 黄线阈值 (USD) | 介于两者之间 → 黄色；再低 → 红色 |
Key 的解析顺序（不用配就能跑）：
$DSH_HOME/rely/state.json，权限 0600）—— 一旦有值就标记为已锁定；ZDXJL_API_KEY（$DSH_HOME/.credentials.yaml 的 refs，或同名环境变量）。锁死规则：已锁定后，不带 unlockKey: true 的覆盖请求会被服务端直接忽略 —— 空值不会把 Key 清掉，重启也从 state.json 原样读回。
站点名字和地址是代码常量，界面不提供编辑，state.json 里的历史值也覆盖不了：
// src/index.js
const RELAY_NAME_LOCKED = '绿萝'
const RELAY_BASE_LOCKED = 'https://zdxjl.com'
const RELAY_KEY_ENV = 'ZDXJL_API_KEY'
换自己的站：改这三行（RELAY_KEY_ENV 填你在 DSH 凭据里存的 Key 名）→ 重启 DSH。
浏览器半区通过这两条路由读数据，本机 curl 也能调（需要 DSH 的登录会话）：
| 方法 | 路径 | 说明 |
|---|---|---|
GET/POST | /rely/balances | 读缓存；?force=1 或 POST = 立即现拉（有 1.5s 节流） |
GET | /rely/config | 当前配置（Key 只回打码预览） |
POST | /rely/config | 保存配置（阈值/刷新间隔/Key），持久化到 state.json |
dsh-rely/
├── package.json # dsh.bundle.patch + dsh.client(platform: web)
├── cordis.patch.yml # 往 profile 加载器树里插一条 entry
├── src/index.js # 宿主半区：定时拉余额 + /rely/* 路由 + 配置持久化
└── client/client.js # 浏览器半区：状态条 + 设置抽屉（手写模块，无构建步骤）
浏览器半区是手写的 window.__ModuleLoader__.load({ id, factory }) 模块，只 require("react")，没有打包步骤。
| 改的文件 | 生效方式 |
|---|---|
client/client.js | 刷新页面（F5）即可 |
src/index.js（宿主路由、余额请求、配置存储） | 必须重启 DSH |
两条都踩过坑：
path 注册两次。 DSH 的 webServer.register 遇到重复 (kind, path) 会 throw，而这个异常会把整个 inject 作用域里的 effect 全部回滚 —— 表现是「插件加载成功，但 /rely/* 全部 404，整条链路静默死掉」。所以 GET/POST /rely/config 必须写在同一个 handler 里。conversation.input.dock，它的容器是 display:contents，我们的行直接变成 composerStack 的 flex 子项。之前为了「独占一行」给父容器加过 flex-wrap，结果把同屏的「tok/s · 缓存命中」状态条挤没了。正确做法：只用自己的类，父容器一个字节都不碰。composerStack 是 flex column，conversation.input.dock 排在输入框前面 → 天然在输入框上方。order 不要设大，设大了反而会掉到输入框下面。| 现象 | 原因 / 处理 |
|---|---|
| 状态条显示「查询失败」 | 点开抽屉看那一行红字。401/403 → Key 不对；404 → 站点接口路径不在上表里。 |
| 状态条显示「未配置」 | 没有可用 Key：抽屉里填一个，或在 DSH 凭据里存 ZDXJL_API_KEY。 |
| 显示的数字一直不动 | 「服务端刷新」被设得太长，或宿主半区没重载 → 重启 DSH。 |
/rely/* 全部 404 | 宿主半区没挂上：确认插件是启用状态，然后重启 DSH。 |
| 数字明明在变，页面不动 | 浏览器半区按「前端轮询」拉缓存；刷新页面或等一个轮询周期。 |