纯黑主题与余额 zyutsu/dsh-amoled-proxyapi

dsh-amoled-proxyapi

一套 AMOLED（纯黑）主题，用于 DeepSeek Harness 网页 GUI，每种强调色一个主题，另外在侧边栏底部加一个 ProxyAPI 余额读数，点击可打开用量页面。

sidebar foot ● 1 234,56 ₽ ← click → console.proxyapi.ru/usage
⚙ Settings

安装

这个包是 DSH bundle：package.json 里声明了 dsh.bundle.patch，所以配置档把它作为单个 Loader 条目安装，而 dsh.client 标记了 Host 提供给页面的浏览器端部分。lib/ 已提交，所以直接检出就能用，不需要构建步骤。

通过配置档的插件管理器安装到配置档里，给它包路径或仓库 spec 都行：

github:zyutsu/dsh-amoled-proxyapi

手动安装：把仓库克隆到 <DSH_HOME>/profiles/<profile>/plugins/，再把 cordis.patch.yml 里的条目加到配置档自己的 cordis.patch.yml。

需要 DSH ≥ 0.2.0-rc.0 和 Node ≥ 20。

安装了什么

| 贡献 | 位置 | 包的部分 |
| amoled- 主题系列（深色方案，每个 158 个别名 token） | ctx.theme.register | 浏览器 |
| AMOLED тема 行：强调色色块 + 开关 | Settings → General，最后一行 | 浏览器 |
| 余额胶囊 | sidebar.footer.action（Settings 上方） | 浏览器 |
| GET /amoled-proxyapi/balance | Host HTTP 路由 | Node |

两部分装在同一个包里：lib/index.js 是 Loader 条目（Node 部分），package.json 里的 dsh.client 把 lib/client.js 标记为 Host 提供给页面的浏览器部分。

主题系列

八个主题共用一套经过审核的黑色几何，只差一个色相：

| Id | 强调色 | 强调色上的文字 |
| amoled-red | #ff2d3f | white |
| amoled-orange | #ff7a1a | near-black |
| amoled-amber | #ffc02e | near-black |
| amoled-green | #2fd36b | near-black |
| amoled-teal | #17d1c0 | near-black |
| amoled-blue | #3b82f6 | white |
| amoled-violet | #a06bff | white |
| amoled-magenta | #ff4d94 | white |

第三方主题就是一组别名 token 覆盖。ctx.theme.register({ id, colorScheme: 'dark', tokens }) 把它发布出去；ui-layout 的 ThemePresenter 把每个条目写成 <body> 上的内联自定义属性，内联属性优先于 token 样式表。所以调色板分两层工作：

src/palette.js → AMOLED_STATIC 重新指向随包深色调色板计算所依据的原始色阶：偏蓝的中性色阶变成近黑（#000000 画布，#0a0507 … #2f2429 表面），「deepseek blue」强调色阶采用主题自己的色相。
* AMOLED_ALIAS 固定那些必须是绝对值的决定——纯黑画布和侧边栏、细线边框、品牌/主按钮、标签色阶、黑色遮罩、代码 token、引导渐变。

这个模板在红色主题上人工审核一次。其余七个主题由 createTokens() 从它生成：模板里每个字面颜色旋转到强调色的色度向量上，所以明度和 alpha 逐 token 保持不变，只有色相移动——蓝色主题的对比度与红色主题完全一致，只是色相不同。有两小组不旋转，而是固定：

* ACCENT_PINS —— 品牌色、活动导航强调色、引导流程强调色，以及两个色阶的强调色档，都精确等于强调色，所以色板不会说谎。
* SEMANTIC_KEEP —— 错误红。红色错误不能因为主题是蓝色就变成蓝色。绿色和琥珀色状态 token 根本不在模板里，出于同样的原因，它们在所有主题中都保留出厂值。

--dsw-alias-label-primary-foreground 是每个强调色对应的 onAccent 颜色，所以明亮的强调色（琥珀、绿、青）在主按钮上使用深色文字。

第三方主题 id 是进程内偏好，持久化设置 schema 不携带它，因此插件在每次加载时重新应用已存储的强调色，由 localStorage["dsh-amoled:enabled"]（默认开启）和 localStorage["dsh-amoled:color"]（强调色 id）驱动。设置行与出厂的外观控件通过 theme/change 保持同步：在那里选择浅色/深色/跟随系统会关闭该系列，设置行则把同一偏好写回。选择强调色总是开启该系列。系列之前的键 dsh-amoled-red:enabled 仍然有效。

余额读数

浏览器无法读取余额——调用需要账户 API key，而 key 不能到达页面。所以 node 那一半负责网络：

GET /amoled-proxyapi/balance (Host, behind the connection trust fence)
→ ProxyAPI GET https://api.proxyapi.ru/proxyapi/balance
Authorization: Bearer <key>

每次读取都通过凭据服务解析 key（默认 PROXYAPI_API_KEY，与 ProxyAPI 模型服务商使用的引用相同），回退到启动环境。应答缓存在内存中（成功 20 秒，失败 5 秒），并发轮询共享一次上游读取。

该路由始终返回 HTTP 200 和 JSON 信封，所以胶囊能解释原因，而不只是失败：

{"ok":true,"balance":1234.56,"budget":{"limit":50,"used":12.34},
"currency":"RUB","source":"credentials","updatedAt":"…", "usageUrl":"https://console.proxyapi.ru/usage"}

{"ok":false,"code":"forbidden","status":403,
"message":"ключу не разрешён запрос баланса",
"hint":"Включите разрешение «Запрос баланса» в настройках ключа: https://console.proxyapi.ru/keys"}

code 是 no-key、forbidden、network、http、bad-payload、internal 之一。forbidden 最常见： ProxyAPI 会以 403 拒绝 GET /proxyapi/balance，直到 key 本身带有「Запрос баланса」权限——在 <https://console.proxyapi.ru/keys> 启用它。胶囊显示「нет доступа」并带红点，意思正是如此，它的工具提示会链接到修复该问题的页面。

当内置浏览器面板可用时，点击胶囊会在其中打开用量页面标签页类型已注册，否则在新浏览器标签页中打开。

配置

没有插件设置；每个可调项都是环境变量覆盖，这样组合配置保持声明式：

| 变量 | 默认值 |
| DSH_PROXYAPI_BASE_URL | https://api.proxyapi.ru |
| DSH_PROXYAPI_BALANCE_PATH | /proxyapi/balance |
| DSH_PROXYAPI_USAGE_URL | https://console.proxyapi.ru/usage |
| DSH_PROXYAPI_KEY_REF | PROXYAPI_API_KEY |
| DSH_PROXYAPI_OK_TTL_MS | 20000 |
| DSH_PROXYAPI_FAIL_TTL_MS | 5000 |
| DSH_PROXYAPI_TIMEOUT_MS | 15000 |

这些名称也接受作为入口配置（config.baseUrl、config.usageUrl、……），入口配置优先于环境变量。

开发

node build/build-client.mjs # src/*.js -> lib/client.js (one lazy-CJS factory)
node build/test-host.mjs # route contract against a fake carrier + fetch
node build/test-client.mjs # bundle against a fake loader, React, DOM, theme

src/client.js 和 src/palette.js 是普通脚本，没有任何 import，所以打包产物只保留一个外部依赖：react。打包产物注册的模块 id 就是包名——也就是 Host 等待的那一行启动图记录。