dsh-plugin-ollama-usage
Ollama Cloud 账户使用情况显示在 composer 停靠栏、新会话浮层和插件配置卡片中。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:CJ-SH/dsh-plugin-ollama-usage#65fc19fb332606cc16b72258377a469d5942cfc2Plugin Ollama Usage 以 dsh-plugin-ollama-usage 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 dsh 的 Web 对话页显示 Ollama Cloud 账户用量 （5 小时滚动窗口 / 每周），并在「设置 → 插件 → 插件配置」里提供一个完整的配置卡片。
活动会话 · 输入框下方 session 26% · weekly 6%
新会话（hero） 同一条面板
设置 → 插件 → 插件配置 baseURL / 凭据模式 / 密钥
它只读一个端点（GET {baseURL}/api/usage）：不改任何 provider 配置、不发起对话；
没有可用凭据或端点不提供用量时，面板静默消失，不留占位符。
| 位置 | 席位 |
|---|---|
| 活动会话输入框下方 | conversation.composer.dock（id ollama-usage, order 1） |
| 新会话（hero） | shell.overlay（id ollama-usage-hero, order 1） |
| 设置 → 插件 → 插件配置 | settings.plugin.item（key ollama-usage） |
面板同时显示两个窗口，各自带占比；数据默认每 5 分钟刷新一次。
| dsh | 带 web profile 的 dsh；实测 0.1.5-rc.2。席位是内部契约，dsh 升级可能移动它们 |
| Node | `^22.19.0 |
| Ollama Cloud 账号 | /api/usage 需要可用的 API key，见下面的两种模式 |
本包是 dsh bundle：声明 dsh.bundle + cordis.patch.yml，安装即把 bundle 追加进 profile 并应用它的 patch 层
（官方指南）。
从仓库安装（npm 尚未发布；发布后命令相同，只是把路径换回包名）：
git clone https://github.com/CJ-SH/dsh-plugin-ollama-usage
dsh plugin --profile web add ./dsh-plugin-ollama-usage
或者直接用 git URL（不必自己 clone）：
dsh plugin --profile web add github:CJ-SH/dsh-plugin-ollama-usage
lib/ 是仓库里的纯 JavaScript，没有构建步骤，所以 git 安装拿到的就是可运行的产物。
然后预检并重启 dsh —— 插件在启动时加载，而重启会结束 agent 进程，请自己执行：
dsh --profile web --dump-config | grep ollama-usage
dsh plugin --profile web remove dsh-plugin-ollama-usage
配置完全由本插件自己持有：设置命名空间 ollama-usage（baseURL / credentialMode / apiKeyEnv），
密钥经官方凭据 seam 存取。
| 模式 | 密钥来源 | 本插件能否写入 |
|---|---|---|
| 凭据模式（默认） | 复用已有 apiKeyEnv（默认 OLLAMA_API_KEY） | 不能 —— Host 半根本没有接受外部引用名的写入接口 |
| 密钥模式 | 本插件专属引用 OLLAMA_USAGE_API_KEY | 只能写它自己 |
写入接口（credential/set / credential/unset）不接受 ref 参数，物理上无法覆盖某个提供方共用的
OLLAMA_API_KEY；密钥只在 Host 侧读取，从不回传给浏览器，错误信息里也不含密钥。
GET {baseURL}/api/usage + Authorization: Bearer <key>。baseURL 填 https://ollama.com 或
https://ollama.com/api 都可以（原生 API base 以 /api 结尾，代码会补齐）。
端点 404 → 视作「该端点不提供用量」，静默；非 2xx / JSON 非法 / 未配置凭据 → 同样静默（不渲染、不报错）。
响应目前只带 session（5 小时滚动）与 weekly，且不含任何重置时间戳，因此面板显示滚动口径
（「每 5 小时重置 / 每 7 天重置 / 每 30 天重置」）；若端点将来返回 resets_at，代码会自动改显示绝对时间。
patch 只插入自己的一行。Host 半在组合的 webServer 上注册自己的路由（POST /ollama-usage/<endpoint>），
每个请求先问组合的 connection.requestRejection（401/403 逐字回写；缺这个 seam 时 503 拒绝服务）——
与 shipped dsh-host-open-in-app 同一套形状。
早期版本靠拓宽 shipped connection 行的 inject 让 connection.rpc.handle 能注册通道；那会让本插件的
可用性依赖别的 bundle 的配置与层序，自有路由没有这个耦合。
设置与凭据是用户数据，卸载后保留；不需要时手动清理 settings.yaml 里的 ollama-usage 段
（本插件不会写入任何凭据，除非你显式使用密钥模式）。
lib/index.js Host 半：设置命名空间、凭据 seam、/usage 取数、自有的 /ollama-usage 路由
lib/client.js Client 半：三处 UI（module-loader bundle 形式，仅依赖基线 react）
test/host.test.mjs 自检：注册、栅栏/方法/媒体类型/请求体、信封、凭据边界、空态（44 条断言）
test/client.test.mjs 自检：席位、样式生命周期、跨半边契约（27 条断言）
test/card.test.mjs 自检：设置卡片（10 条断言）
test/hero.test.mjs 自检：hero 悬浮件（6 条断言）
cordis.patch.yml 安装时合入 profile 的 loader 行（不覆盖任何别的行）
无构建步骤、运行时零外部依赖：Host 半不 import 任何 @deepseek-ai/*（设置 schema 用
dsh-settings 实际消费的可调用对象 + toJSON()），Client 半只 require('react')（平台基线）。
npm test # 四个 harness，共 87 条断言，无需测试框架
config/read 信封与端点推导、凭据写入边界（凭据模式零写入、密钥模式只写
OLLAMA_USAGE_API_KEY）、四类空态（无凭据服务 / 未配置 / 404 / 非 JSON）、错误信息不含密钥，
以及「不 import 任何 @deepseek-ai/*」。window.__ModuleLoader__ 加载真实 bundle 并挂载到假 ctx —— 断言
三个席位（槽名与 id/key 分离，这正是原型期踩过的坑）、order、样式标签的注入与回收、
以及跨半边契约（客户端调用的每个 endpoint 在 Host 都有对应分支，路由前缀与命名空间两边一致）。fetch）。面板完全不显示。 依次排查：凭据不可用（凭据模式的 apiKeyEnv 未配置，或密钥模式的引用为空）；
GET {baseURL}/api/usage 返回 404 或非 2xx；baseURL 填错；dsh 升级移动了席位。
面板不显示占位符、也不报错 —— 不显示本身就是失败模式。
卡片一直停在「读取中…」。 说明请求没有拿到答复信封：看 dsh 启动日志里有没有
[ollama-usage] route unavailable（路由被别的行占用）或 trust fence unavailable（组合里没有
connection.requestRejection）。
MIT © 2026 HenTaiCJN
Ollama 是 Ollama Inc. 的产品；本插件与它没有隶属关系，只调用其公开 API。