dsh-ollama-usage 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-ollama-usage contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# dsh-ollama-usage
+
+DeepSeek Harness 插件：可视化 **Ollama Pro** 账号的用量余量（每 5 小时会话用量 + 周用量），
+支持侧边栏双横条、设置页完整面板、API Key 与用量快照持久化、自动刷新与登录引导。
+
+A DeepSeek Harness plugin that visualizes your **Ollama Pro** usage / remaining quota
+(5-hour session bucket + weekly bucket), with a minimalist sidebar double-bar,
+a full settings panel, persisted API key and usage snapshots, auto-refresh,
+and login guidance.
+
+数据来源为 Ollama 官方接口 `GET https://ollama.com/api/usage`
+（数据与 [ollama.com/settings](https://ollama.com/settings) 页面一致）。
+
+## 功能
+
+- **侧边栏底部双横条**（极简、透明背景）：`会话5h` 淡紫条 + `周用量` 深紫条，
+  各带百分比数字；悬停显示详情；每 60 秒自动更新；窄栏（rail）自动隐藏。
+- **设置页「Ollama 用量」完整面板**：会话（每 5 小时）/ 周用量进度条（已用 X% · 剩余 Y%）、
+  周期起止时间、近 4 周费用、模型请求数排行、最近 5 条会话用量历史、清除 Key。
+- **持久化**：API Key 与用量快照写入 `$DSH_HOME/storages/ollama-usage/usage.json`
+  （权限 600，保留最近 24 条历史），跨对话 / 重启自动恢复。
+- **自动刷新**：Host 每 10 分钟自动查询一次（浏览器页面关闭也持续）；
+  Key 失效（401）自动清除并提示重新登录。
+- **登录引导**：未登录时面板显示步骤指引，一键打开
+  [ollama.com/settings](https://ollama.com/settings) 登录、到
+  [settings/keys](https://ollama.com/settings/keys) 创建 API Key 并粘贴检测；
+  也兼容旧版 CLI 的 `~/.ollama/auth.json` 凭证。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-ollama-usage
+dsh --profile web
+```
+
+或手动把包加入 profile 的 `package.json` 的 `dsh.profile.bundles` 后重启。
+
+## 使用
+
+1. 打开 设置 → **Ollama 用量**。
+2. 若未登录：按面板指引打开 [ollama.com/settings](https://ollama.com/settings)
+   登录账号，在 [settings/keys](https://ollama.com/settings/keys) 创建 API Key
+   （`ollama-` 开头），粘贴到输入框点 **检测**；或在终端运行 `ollama signin` 后点
+   **重新检测本地凭证**。
+3. 检测成功后 Key 与快照即持久化，之后全自动：展开侧边栏即可在底部看到双横条，
+   面板可随时查看详情与历史。
+4. 不再需要时，在面板点 **清除已存 Key** 即可移除本地凭证（历史保留）。
+
+## 数据与隐私
+
+- 仅向 `https://ollama.com/api/usage` 发送带 Bearer 的查询请求；
+- Key 以明文保存在本机 `$DSH_HOME/storages/ollama-usage/usage.json`（权限 600），
+  与 `~/.ollama/auth.json` 同等级信任；需要时可随时清除。
+
+## 开发 / 发布
+
+```bash
+npm install          # 安装依赖(@deepseek-ai/dsh-home-paths)
+npm pack             # 本地打包检查
+npm publish          # 发布到 npm(需先 npm login)
+```
+
+- 宿主入口：`lib/index.js`（ESM，导出 `name` + 默认插件；在 webServer 注册
+  `/ollama-usage` 前缀路由，走 Connection RPC 信封协议）。
+- 客户端入口：`lib/client.js`（`window.__ModuleLoader__.load` bundle；
+  经 `connection.rpc.call('/ollama-usage', endpoint, payload)` 调用宿主）。
+- bundle 接线：`cordis.patch.yml`（Loader 行）+ `package.json` 的
+  `dsh.bundle.patch` / `dsh.client` 声明。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+# dsh-ollama-usage bundle patch.
+#
+# Adds the plugin's single Loader row. The row name resolves from the
+# profile's own node_modules, where `dsh plugin --profile <name> add`
+# installed this package.
+#
+# 安装: dsh plugin --profile web add dsh-ollama-usage
+# 重启: dsh --profile web
+- insert:
+    - id: ollama-usage
+      name: dsh-ollama-usage

package/lib/client.js

@@ -0,0 +1,354 @@
+/**
+ * dsh-ollama-usage 浏览器端 bundle(经 __ModuleLoader__ 加载)。
+ *
+ * 提供三处界面:
+ *  - settings.section「Ollama 用量」:完整面板(会话 5h / 周用量进度条、费用、
+ *    模型请求数、历史记录、API Key 配置、清除 Key);
+ *  - sidebar.footer.action:极简双横条(会话 5h 淡紫 / 周用量深紫,透明背景);
+ *  - tool.view.cordis:Run 卡片内的同款面板。
+ *
+ * 数据通道:Host 在 webServer 注册的 /ollama-usage 前缀路由,经 Connection
+ * RPC 信封协议调用(check / snapshot / forget)。样式为手写 <style> 注入,
+ * 全部使用 --dsw-* 主题变量(带回退值)。
+ */
+
+window.__ModuleLoader__.load({
+  id: 'dsh-ollama-usage',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+
+    const React = require('react')
+
+    const RPC_CHANNEL = '/ollama-usage'
+    const CSS_TAG_ID = 'dsh-ollama-usage/client.css'
+    const SESSION_COLOR = '#b39df7'
+    const WEEKLY_COLOR = '#7c66e8'
+
+    const CSS = [
+      '.olusa-panel{display:flex;flex-direction:column;gap:10px;padding:12px 14px;border:1px solid var(--dsw-alias-border-l1,#3a3a3a);border-radius:10px;background:var(--dsw-alias-bg-layer-1,rgba(128,128,128,.07));font-size:13px;line-height:1.55;color:var(--dsw-alias-label-primary,#e8e8e8)}',
+      '.olusa-head{display:flex;align-items:center;justify-content:space-between;gap:8px}',
+      '.olusa-title{font-weight:650;font-size:13.5px}',
+      '.olusa-btn{border:1px solid var(--dsw-alias-border-l2,#555);background:transparent;color:var(--dsw-alias-label-primary,#e8e8e8);border-radius:6px;padding:3px 10px;font-size:12px;cursor:pointer}',
+      '.olusa-btn:disabled{opacity:.55;cursor:default}',
+      '.olusa-btn-primary{border-color:var(--dsw-alias-brand-primary,#7aa2f7);color:var(--dsw-alias-brand-primary,#7aa2f7)}',
+      '.olusa-hint{color:var(--dsw-alias-label-secondary,#9a9a9a);font-size:12px}',
+      '.olusa-error{color:var(--dsw-alias-state-error-primary,#f7768e)}',
+      '.olusa-ok{color:var(--dsw-alias-state-success-primary,#9ece6a)}',
+      '.olusa-block{display:flex;flex-direction:column;gap:4px}',
+      '.olusa-barhead{display:flex;justify-content:space-between;align-items:baseline;gap:8px}',
+      '.olusa-barlabel{color:var(--dsw-alias-label-primary,#e8e8e8)}',
+      '.olusa-barval{color:var(--dsw-alias-label-secondary,#9a9a9a);font-size:12px;font-variant-numeric:tabular-nums}',
+      '.olusa-bar{height:8px;border-radius:4px;background:var(--dsw-alias-bg-layer-2,rgba(128,128,128,.18));overflow:hidden}',
+      '.olusa-barfill{height:100%;border-radius:4px;transition:width .3s ease}',
+      '.olusa-row{display:flex;justify-content:space-between;gap:8px}',
+      '.olusa-link{color:var(--dsw-alias-brand-primary,#7aa2f7);text-decoration:none}',
+      '.olusa-steps{margin:0;padding-left:18px;display:flex;flex-direction:column;gap:3px}',
+      '.olusa-input{flex:1;min-width:0;background:var(--dsw-alias-bg-layer-2,rgba(128,128,128,.15));border:1px solid var(--dsw-alias-border-l2,#555);color:var(--dsw-alias-label-primary,#e8e8e8);border-radius:6px;padding:5px 8px;font-size:12px;font-family:monospace}',
+      '.olusa-login-title{font-weight:600}',
+      '.olusa-rowbtns{display:flex;gap:6px;margin-top:8px}',
+      '.olusa-models{display:flex;flex-direction:column;gap:3px}',
+      '.olusa-model{display:flex;justify-content:space-between;gap:8px;font-size:12px;color:var(--dsw-alias-label-secondary,#9a9a9a)}',
+      '.olusa-modelname{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+      '.olusa-modelcount{font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-primary,#e8e8e8)}',
+      '.olusa-ver{color:var(--dsw-alias-label-secondary,#9a9a9a);font-size:11px;opacity:.8}',
+      '.olusa-hist{display:flex;flex-direction:column;gap:2px}',
+      '.olusa-histrow{display:flex;justify-content:space-between;gap:8px;font-size:12px;color:var(--dsw-alias-label-secondary,#9a9a9a);font-variant-numeric:tabular-nums}',
+      '.olusa-session{order:-1}',
+      '.olusa-bars{display:flex;flex-direction:column;gap:6px;padding:6px 8px;width:120px;min-width:120px;flex-shrink:0;box-sizing:border-box;background:transparent;border:none}',
+      '.olusa-barsrow{display:flex;flex-direction:column;gap:2px}',
+      '.olusa-barshead{display:flex;justify-content:space-between;align-items:baseline;gap:6px}',
+      '.olusa-barslabel{font-size:10px;color:var(--dsw-alias-label-secondary,#9a9a9a);white-space:nowrap}',
+      '.olusa-barsval{font-size:10px;font-weight:600;font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-primary,#e8e8e8);white-space:nowrap}',
+      '.olusa-minibar{height:8px;border-radius:4px;background:rgba(128,128,128,.28);overflow:hidden}',
+      '.olusa-minibarfill{height:100%;border-radius:4px;transition:width .3s ease}',
+    ].join('\n')
+
+    function injectCss() {
+      if (typeof document === 'undefined') return
+      if (document.querySelector('style[data-plugin-css="' + CSS_TAG_ID + '"]') !== null) return
+      const tag = document.createElement('style')
+      tag.dataset.pluginCss = CSS_TAG_ID
+      tag.textContent = CSS
+      ;(document.head || document.documentElement).appendChild(tag)
+    }
+
+    const pct = (v) => (typeof v === 'number' && Number.isFinite(v) ? Math.round(v * 10) / 10 : null)
+    const colorFor = (p) => {
+      if (p === null) return 'var(--dsw-alias-label-secondary,#9a9a9a)'
+      if (p < 70) return 'var(--dsw-alias-state-success-primary,#9ece6a)'
+      if (p < 90) return 'var(--dsw-alias-state-warn-primary,#e0af68)'
+      return 'var(--dsw-alias-state-error-primary,#f7768e)'
+    }
+    const PERIOD_LABELS = { last_4_weeks: '近 4 周', weekly: '本周', session: '本次会话' }
+    const fmtTime = (iso) => {
+      try {
+        const d = new Date(iso)
+        const p2 = (n) => (n < 10 ? '0' + n : String(n))
+        return p2(d.getMonth() + 1) + '-' + p2(d.getDate()) + ' ' + p2(d.getHours()) + ':' + p2(d.getMinutes())
+      } catch (e) {
+        return String(iso || '')
+      }
+    }
+
+    function apply(ctx) {
+      injectCss()
+
+      const slots = ctx.get('slots')
+      if (slots === undefined) return
+
+      const connection = ctx.get('connection')
+      const rpc = (endpoint, payload) => {
+        if (connection === undefined || connection === null || typeof connection.rpc !== 'object' || typeof connection.rpc.call !== 'function') {
+          return Promise.resolve({ ok: false, error: { code: 'internal', message: 'connection 不可用' } })
+        }
+        return connection.rpc.call(RPC_CHANNEL, endpoint, payload).then((result) => {
+          if (result === null || typeof result !== 'object' || !('ok' in result)) {
+            return { ok: false, error: { code: 'internal', message: 'rpc 响应格式异常' } }
+          }
+          return result
+        })
+      }
+
+      // ── 面板组件 ──────────────────────────────────────────────────
+
+      function BarRow(props) {
+        const p = pct(props.percent)
+        const width = p === null ? 0 : Math.min(100, Math.max(0, p))
+        const remaining = p === null ? null : Math.round((100 - p) * 10) / 10
+        return React.createElement('div', { className: 'olusa-block' + (props.em ? ' olusa-session' : '') },
+          React.createElement('div', { className: 'olusa-barhead' },
+            React.createElement('span', { className: 'olusa-barlabel' }, props.label),
+            React.createElement('span', { className: 'olusa-barval' }, p === null ? '暂无数据' : ('已用 ' + p + '% · 剩余 ' + remaining + '%'))
+          ),
+          React.createElement('div', { className: 'olusa-bar' },
+            React.createElement('div', { className: 'olusa-barfill', style: { width: width + '%', background: colorFor(p) } })
+          )
+        )
+      }
+
+      function LoginBody(props) {
+        return React.createElement('div', { className: 'olusa-block' },
+          React.createElement('div', { className: 'olusa-login-title' }, '尚未登录 Ollama 账号'),
+          React.createElement('ol', { className: 'olusa-steps' },
+            React.createElement('li', null,
+              React.createElement('a', { className: 'olusa-link', href: 'https://ollama.com/settings', target: '_blank', rel: 'noreferrer' }, '打开 ollama.com/settings'),
+              ' 并登录（或注册）Ollama 账号'
+            ),
+            React.createElement('li', null,
+              '在 API Keys 页 ',
+              React.createElement('a', { className: 'olusa-link', href: 'https://ollama.com/settings/keys', target: '_blank', rel: 'noreferrer' }, 'settings/keys'),
+              ' 创建一个 API Key（以 ollama- 开头）'
+            ),
+            React.createElement('li', null, '把 Key 粘贴到下方点击“检测”；或先在终端运行 ollama signin / ollama login，再点“重新检测本地凭证”')
+          ),
+          React.createElement('input', { className: 'olusa-input', placeholder: '粘贴 API Key（ollama-…）', value: props.tokenInput, onChange: (e) => props.onInput(e.target.value), spellCheck: false }),
+          React.createElement('div', { className: 'olusa-rowbtns' },
+            React.createElement('button', { className: 'olusa-btn olusa-btn-primary', disabled: props.busy || !props.tokenInput.trim(), onClick: () => props.onCheck(props.tokenInput.trim()) }, props.busy ? '检测中…' : '检测'),
+            React.createElement('button', { className: 'olusa-btn', disabled: props.busy, onClick: () => props.onRetryLocal() }, '重新检测本地凭证')
+          ),
+          React.createElement('div', { className: 'olusa-hint' }, '提示：检测成功后，Key 与用量快照会保存到 $DSH_HOME/storages/ollama-usage/usage.json（权限 600），跨对话/重启自动恢复并每 10 分钟自动刷新。')
+        )
+      }
+
+      function UsageBody(props) {
+        const d = props.data
+        const periodLabel = PERIOD_LABELS[d.periodType] || (d.periodType ? String(d.periodType).toUpperCase() : '')
+        const periodText = periodLabel && d.periodStart && d.periodEnd
+          ? (periodLabel + '  ' + d.periodStart + ' → ' + d.periodEnd)
+          : periodLabel
+        const costNum = d.cost !== null && d.cost !== undefined && d.cost !== '' ? Number(d.cost) : NaN
+        const costText = Number.isFinite(costNum) ? '$' + costNum.toFixed(2) : null
+        const models = Array.isArray(d.models) ? d.models.slice(0, 5) : []
+        const history = Array.isArray(props.history) ? props.history.slice(-5).reverse() : []
+        return React.createElement('div', { className: 'olusa-block' },
+          (periodText ? React.createElement('div', { className: 'olusa-hint' }, periodText) : null),
+          React.createElement(BarRow, { label: '会话用量（每 5 小时）', percent: d.sessionPercent, em: true }),
+          React.createElement(BarRow, { label: '本周用量（Weekly）', percent: d.weeklyPercent }),
+          (costText !== null
+            ? React.createElement('div', { className: 'olusa-row' },
+                React.createElement('span', null, '近 4 周费用'),
+                React.createElement('span', null, costText))
+            : null),
+          (models.length > 0
+            ? React.createElement('div', { className: 'olusa-models' },
+                React.createElement('div', { className: 'olusa-hint' }, '模型请求数（本周）'),
+                models.map((m) => React.createElement('div', { className: 'olusa-model', key: m.name },
+                  React.createElement('span', { className: 'olusa-modelname' }, m.name),
+                  React.createElement('span', { className: 'olusa-modelcount' }, String(m.requestCount) + ' 次')
+                )))
+            : null),
+          (history.length > 0
+            ? React.createElement('div', { className: 'olusa-hist' },
+                React.createElement('div', { className: 'olusa-hint' }, '最近记录（会话用量）'),
+                history.map((h, i) => React.createElement('div', { className: 'olusa-histrow', key: String(i) },
+                  React.createElement('span', null, fmtTime(h.at)),
+                  React.createElement('span', null, (h.sessionPercent === null || h.sessionPercent === undefined) ? '—' : (h.sessionPercent + '%'))
+                )))
+            : null),
+          (props.updatedAt
+            ? React.createElement('div', { className: 'olusa-hint' }, '上次更新：' + fmtTime(props.updatedAt) + '（每 10 分钟自动刷新）')
+            : null),
+          React.createElement('div', { className: props.persisted ? 'olusa-hint olusa-ok' : 'olusa-error' },
+            props.persisted ? '✓ 已持久化到本地（$DSH_HOME/storages/ollama-usage/usage.json）' : '⚠ 未能写入本地文件（持久化失败，仅当前进程内存）')
+        )
+      }
+
+      function OllamaUsagePanel() {
+        const [phase, setPhase] = React.useState('login')
+        const [data, setData] = React.useState(null)
+        const [history, setHistory] = React.useState(null)
+        const [updatedAt, setUpdatedAt] = React.useState(null)
+        const [persisted, setPersisted] = React.useState(null)
+        const [error, setError] = React.useState('')
+        const [busy, setBusy] = React.useState(false)
+        const [tokenInput, setTokenInput] = React.useState('')
+
+        const applyResult = (res) => {
+          if (res && res.ok) {
+            const v = res.value || {}
+            setData(v.usage || null)
+            setHistory(v.history || null)
+            setUpdatedAt(v.updatedAt || null)
+            if (typeof v.persisted === 'boolean') setPersisted(v.persisted)
+            setError('')
+            setPhase('usage')
+          } else if (res && res.error && (res.error.code === 'no-token' || res.error.code === 'no-data')) {
+            setError('')
+            setPhase('login')
+          } else if (data) {
+            setError((res && res.error && res.error.message) || '刷新失败')
+          } else {
+            setError((res && res.error && res.error.message) || '未知错误')
+            setPhase('error')
+          }
+        }
+
+        const doCheck = (token) => {
+          setBusy(true)
+          rpc('check', token ? { token: token } : {}).then(applyResult).catch((e) => {
+            if (data) setError('刷新失败：' + String((e && e.message) || e))
+            else { setError('调用失败：' + String((e && e.message) || e)); setPhase('error') }
+          }).then(() => setBusy(false))
+        }
+
+        const doForget = () => {
+          rpc('forget', {}).then(() => {
+            setData(null); setHistory(null); setUpdatedAt(null); setPersisted(null); setError(''); setPhase('login')
+          }).catch(() => {})
+        }
+
+        React.useEffect(() => {
+          let disposed = false
+          const refresh = () => rpc('snapshot', {}).then((res) => {
+            if (disposed) return
+            if (res && res.ok && res.value && res.value.usage) {
+              setData(res.value.usage); setHistory(res.value.history || null); setUpdatedAt(res.value.updatedAt || null); setError(''); setPhase('usage')
+            }
+          }).catch(() => {})
+          refresh()
+          const dispose = ctx.interval(refresh, 60000)
+          return () => { disposed = true; dispose() }
+        }, [])
+
+        const body = phase === 'login'
+          ? React.createElement(LoginBody, { tokenInput: tokenInput, onInput: setTokenInput, onCheck: doCheck, onRetryLocal: () => doCheck(''), busy: busy })
+          : phase === 'usage' && data
+            ? React.createElement('div', { className: 'olusa-block' },
+                React.createElement(UsageBody, { data: data, history: history, updatedAt: updatedAt, persisted: persisted }),
+                (error ? React.createElement('div', { className: 'olusa-error' }, String(error)) : null),
+                React.createElement('div', { className: 'olusa-rowbtns' },
+                  React.createElement('button', { className: 'olusa-btn', disabled: busy, onClick: () => doForget() }, '清除已存 Key')
+                )
+              )
+            : React.createElement('div', { className: 'olusa-block' },
+                React.createElement('div', { className: 'olusa-error' }, String(error || '查询失败')),
+                React.createElement('div', { className: 'olusa-hint' },
+                  '请确认已登录：',
+                  React.createElement('a', { className: 'olusa-link', href: 'https://ollama.com/settings', target: '_blank', rel: 'noreferrer' }, '打开 ollama.com/settings'),
+                  '，或粘贴 API Key 重试。'
+                ),
+                React.createElement('input', { className: 'olusa-input', placeholder: '粘贴 API Key（ollama-…）', value: tokenInput, onChange: (e) => setTokenInput(e.target.value), spellCheck: false }),
+                React.createElement('div', { className: 'olusa-rowbtns' },
+                  React.createElement('button', { className: 'olusa-btn olusa-btn-primary', disabled: busy || !tokenInput.trim(), onClick: () => doCheck(tokenInput.trim()) }, busy ? '检测中…' : '检测'),
+                  React.createElement('button', { className: 'olusa-btn', disabled: busy, onClick: () => doCheck('') }, '重试')
+                )
+              )
+
+        return React.createElement('div', { className: 'olusa-panel' },
+          React.createElement('div', { className: 'olusa-head' },
+            React.createElement('span', { className: 'olusa-title' }, '⚡ Ollama 用量余量'),
+            React.createElement('button', { className: 'olusa-btn', disabled: busy, onClick: () => doCheck('') }, busy ? '查询中…' : '刷新')
+          ),
+          body,
+          React.createElement('div', { className: 'olusa-ver' }, 'dsh-ollama-usage · v0.1.0')
+        )
+      }
+
+      // ── 侧边栏双横条 ──────────────────────────────────────────────
+
+      function UsageBars(props) {
+        const [data, setData] = React.useState(null)
+        const [updatedAt, setUpdatedAt] = React.useState(null)
+
+        React.useEffect(() => {
+          let disposed = false
+          const refresh = () => rpc('snapshot', {}).then((res) => {
+            if (disposed) return
+            if (res && res.ok && res.value) { setData(res.value.usage || null); setUpdatedAt(res.value.updatedAt || null) }
+            else { setData(null); setUpdatedAt(null) }
+          }).catch(() => { if (!disposed) { setData(null); setUpdatedAt(null) } })
+          refresh()
+          const dispose = ctx.interval(refresh, 60000)
+          return () => { disposed = true; dispose() }
+        }, [])
+
+        // 防御性判断:仅显式 wide === false(窄栏)才隐藏
+        if (props.wide === false) return null
+
+        const sp = data && typeof data.sessionPercent === 'number' ? Math.min(100, Math.max(0, data.sessionPercent)) : null
+        const wp = data && typeof data.weeklyPercent === 'number' ? Math.min(100, Math.max(0, data.weeklyPercent)) : null
+        const tip = sp === null
+          ? 'Ollama 用量：未登录（设置 → Ollama 用量 配置）'
+          : 'Ollama 会话用量（每 5 小时）：' + (Math.round(sp * 10) / 10) + '% · 周用量：' + (Math.round(wp * 10) / 10) + '%' + (updatedAt ? ' · 更新于 ' + fmtTime(updatedAt) : '')
+        const rows = [
+          { label: '会话5h', p: sp, color: SESSION_COLOR },
+          { label: '周用量', p: wp, color: WEEKLY_COLOR },
+        ]
+        return React.createElement('div', { className: 'olusa-bars', title: tip },
+          rows.map((b) => React.createElement('div', { className: 'olusa-barsrow', key: b.label },
+            React.createElement('div', { className: 'olusa-barshead' },
+              React.createElement('span', { className: 'olusa-barslabel' }, b.label),
+              React.createElement('span', { className: 'olusa-barsval' }, b.p === null ? '—' : (Math.round(b.p * 10) / 10) + '%')
+            ),
+            React.createElement('div', { className: 'olusa-minibar' },
+              React.createElement('div', { className: 'olusa-minibarfill', style: { width: (b.p === null ? 0 : b.p) + '%', background: b.color } })
+            )
+          ))
+        )
+      }
+
+      // ── 槽位注册 ──────────────────────────────────────────────────
+
+      slots.inject('tool.view.cordis', () => slots.register(
+        { name: 'tool.view.cordis', key: 'self' },
+        () => React.createElement(OllamaUsagePanel)
+      ))
+
+      slots.inject('settings.section', () => slots.register(
+        { name: 'settings.section', id: 'ollama-usage', order: 40, label: 'Ollama 用量' },
+        () => React.createElement(OllamaUsagePanel)
+      ))
+
+      slots.inject('sidebar.footer.action', () => slots.register(
+        { name: 'sidebar.footer.action', id: 'olusa-bars', order: -10, label: 'Ollama 用量' },
+        (props) => React.createElement(UsageBars, { wide: !!(props && props.wide) })
+      ))
+    }
+
+    exports.apply = apply
+    exports.inject = ['slots', 'connection', 'timer']
+    return module.exports
+  },
+})

package/lib/index.js

@@ -0,0 +1,385 @@
+/**
+ * dsh-ollama-usage 宿主插件。
+ *
+ * 单一 Loader 行(见 cordis.patch.yml)挂载本模块,职责:
+ *  1. 读取 Ollama 凭证:优先持久化的 API Key(settings 面板检测成功后写入),
+ *     兼容旧版 CLI 的 ~/.ollama/auth.json;
+ *  2. 请求 https://ollama.com/api/usage 获取用量(会话 5h 桶 + 周桶);
+ *  3. 把 Key / 用量快照 / 历史记录持久化到
+ *     $DSH_HOME/storages/ollama-usage/usage.json(权限 0600),跨对话/重启恢复;
+ *  4. 每 10 分钟自动刷新一次(浏览器页面关闭也持续,Key 失效自动清除);
+ *  5. 在 webServer 上注册 /ollama-usage 前缀路由,与客户端走 Connection RPC
+ *     信封协议(check / snapshot / forget / auth-state 四个端点)。
+ *
+ * 纯 JavaScript(ESM),仅依赖 node: 内建能力(含全局 fetch,Node >= 18)与
+ * @deepseek-ai/dsh-home-paths。
+ */
+
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
+
+export const name = 'ollama-usage'
+
+const RPC_CHANNEL = '/ollama-usage'
+const USAGE_URL = 'https://ollama.com/api/usage'
+const FETCH_TIMEOUT_MS = 20000
+const AUTO_REFRESH_MS = 10 * 60 * 1000
+const HISTORY_CAP = 24
+const BODY_LIMIT = 64 * 1024
+
+/* ------------------------------------------------------------------ *
+ * 持久化($DSH_HOME/storages/ollama-usage/usage.json)
+ * 文件结构:{ token, updatedAt, usage, history[] }
+ * ------------------------------------------------------------------ */
+
+function filePath() {
+  return join(resolveDshHome(), 'storages', 'ollama-usage', 'usage.json')
+}
+
+function readFile() {
+  try {
+    const parsed = JSON.parse(readFileSync(filePath(), 'utf8'))
+    if (parsed && typeof parsed === 'object') return parsed
+  } catch {
+    /* 文件不存在或损坏 */
+  }
+  return null
+}
+
+function writeFile(obj) {
+  try {
+    const dir = join(resolveDshHome(), 'storages', 'ollama-usage')
+    mkdirSync(dir, { recursive: true })
+    writeFileSync(filePath(), JSON.stringify(obj), { mode: 0o600 })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/* ------------------------------------------------------------------ *
+ * 凭证
+ * ------------------------------------------------------------------ */
+
+/** 兼容旧版 ollama CLI:~/.ollama/auth.json 里的 { "token": "..." }。 */
+function readLocalToken() {
+  try {
+    const parsed = JSON.parse(readFileSync(join(homedir(), '.ollama', 'auth.json'), 'utf8'))
+    const token = parsed && typeof parsed.token === 'string' ? parsed.token.trim() : ''
+    return token || null
+  } catch {
+    return null
+  }
+}
+
+/* ------------------------------------------------------------------ *
+ * 用量查询与解析
+ * ------------------------------------------------------------------ */
+
+async function fetchUsage(token) {
+  const res = await fetch(USAGE_URL, {
+    headers: { Authorization: 'Bearer ' + token },
+    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+  })
+  return { status: res.status, body: await res.text() }
+}
+
+/** API 返回的 usage 是 0~1 的小数(如 0.213 = 21.3%),统一转成百分比数字。 */
+function toPercent(v) {
+  let n = null
+  if (typeof v === 'number' && Number.isFinite(v)) n = v
+  else if (typeof v === 'string' && v.trim() !== '') {
+    const c = Number(v)
+    if (Number.isFinite(c)) n = c
+  }
+  if (n === null) return null
+  const pct = n <= 1 ? n * 100 : n
+  return Math.round(pct * 10) / 10
+}
+
+function parseUsage(body, status) {
+  let json = null
+  try {
+    json = JSON.parse(body)
+  } catch {
+    return { ok: false, message: '响应不是合法 JSON' }
+  }
+  if (!json || typeof json !== 'object' || Array.isArray(json)) {
+    return { ok: false, message: '响应格式异常' }
+  }
+  const limits = (json && json.limits) || {}
+  const activity = (json && json.activity) || {}
+  const sessionUsage = limits.session && typeof limits.session === 'object' ? toPercent(limits.session.usage) : null
+  const weeklyUsage = limits.weekly && typeof limits.weekly === 'object' ? toPercent(limits.weekly.usage) : null
+  // 模型请求数:真实响应放在 limits.weekly.models(有时 activity.models 也有),按优先级取
+  const weeklyModels = limits.weekly && Array.isArray(limits.weekly.models) ? limits.weekly.models : null
+  const sessionModels = limits.session && Array.isArray(limits.session.models) ? limits.session.models : null
+  const activityModels = Array.isArray(activity.models) ? activity.models : null
+  const rawModels =
+    (weeklyModels && weeklyModels.length ? weeklyModels : null) ||
+    (sessionModels && sessionModels.length ? sessionModels : null) ||
+    (activityModels || [])
+  const models = rawModels
+    .map((m) => ({ name: String((m && m.name) || ''), requestCount: Number((m && m.request_count)) || 0 }))
+    .filter((m) => m.name)
+    .sort((a, b) => b.requestCount - a.requestCount)
+  return {
+    ok: true,
+    usage: {
+      cost: typeof activity.cost === 'string' ? activity.cost : null,
+      periodType: activity.period && typeof activity.period.type === 'string' ? activity.period.type : null,
+      periodStart: activity.period && typeof activity.period.starting_at === 'string' ? activity.period.starting_at : null,
+      periodEnd: activity.period && typeof activity.period.ending_at === 'string' ? activity.period.ending_at : null,
+      sessionPercent: sessionUsage,
+      weeklyPercent: weeklyUsage,
+      models,
+    },
+  }
+}
+
+/** 用 token 查询并把结果写入持久化文件;返回 RpcResult({ ok, value|error })。 */
+async function checkWithToken(token) {
+  let res
+  try {
+    res = await fetchUsage(token)
+  } catch (e) {
+    return { ok: false, error: { code: 'network', message: String((e && e.message) || e) } }
+  }
+  if (res.status === 401 || res.status === 403) {
+    // 凭证失效:清掉持久化的 token,保留历史
+    const rec = readFile()
+    if (rec && rec.token) writeFile({ token: null, updatedAt: rec.updatedAt, usage: rec.usage, history: rec.history || [] })
+    return { ok: false, error: { code: 'unauthorized', message: '凭证无效或已过期(' + res.status + '),请重新登录或更换 API Key' } }
+  }
+  if (res.status >= 400) {
+    return { ok: false, error: { code: 'http-error', message: res.body || ('HTTP ' + res.status) } }
+  }
+  const parsed = parseUsage(res.body, res.status)
+  if (!parsed.ok) {
+    return { ok: false, error: { code: 'internal', message: parsed.message } }
+  }
+  // 持久化:token + 快照 + 历史(保留最近 24 条)
+  const now = new Date().toISOString()
+  const prev = readFile()
+  const history = Array.isArray(prev && prev.history) ? prev.history.slice() : []
+  history.push({ at: now, sessionPercent: parsed.usage.sessionPercent, weeklyPercent: parsed.usage.weeklyPercent })
+  const trimmed = history.length > HISTORY_CAP ? history.slice(history.length - HISTORY_CAP) : history
+  const persisted = writeFile({ token, updatedAt: now, usage: parsed.usage, history: trimmed })
+  return {
+    ok: true,
+    value: { usage: parsed.usage, updatedAt: now, persisted, history: trimmed.slice(-5) },
+  }
+}
+
+/** 自动刷新:读持久化 token 重新查询(页面关闭也持续)。 */
+async function autoRefresh() {
+  try {
+    const rec = readFile()
+    if (rec && rec.token) await checkWithToken(rec.token)
+  } catch {
+    /* 静默失败,下一轮再试 */
+  }
+}
+
+/* ------------------------------------------------------------------ *
+ * RPC 端点分派
+ * ------------------------------------------------------------------ */
+
+async function dispatch(endpoint, payload) {
+  if (endpoint === 'check') {
+    const manual = payload && typeof payload.token === 'string' ? payload.token.trim() : ''
+    let token = manual
+    let rec = null
+    if (!token) {
+      rec = readFile()
+      token = (rec && rec.token) || null
+    }
+    if (!token) token = readLocalToken()
+    if (!token) return { ok: false, error: { code: 'no-token', message: '未检测到本地登录凭证,也未提供 API Key' } }
+    return checkWithToken(token)
+  }
+  if (endpoint === 'snapshot') {
+    const rec = readFile()
+    if (!rec || !rec.usage) return { ok: false, error: { code: 'no-data', message: '暂无持久化的用量数据' } }
+    return { ok: true, value: { tokenPersisted: !!rec.token, updatedAt: rec.updatedAt, history: (rec.history || []).slice(-5), usage: rec.usage } }
+  }
+  if (endpoint === 'forget') {
+    const rec = readFile()
+    if (rec) writeFile({ token: null, updatedAt: rec.updatedAt, usage: rec.usage, history: rec.history || [] })
+    return { ok: true, value: null }
+  }
+  if (endpoint === 'auth-state') {
+    const rec = readFile()
+    return { ok: true, value: { localTokenPresent: !!(rec && rec.token) } }
+  }
+  throw new Error('unknown bridge endpoint ' + JSON.stringify(endpoint))
+}
+
+/* ------------------------------------------------------------------ *
+ * HTTP 桥(镜像 Connection RPC 信封协议,参照 dsh-yolo-mode)
+ * 请求:  POST /ollama-usage/<endpoint>  { type:'client-request', rpcId, method, payload }
+ * 响应:  { type:'server-response', rpcId, result:{ ok, value|error } }
+ * ------------------------------------------------------------------ */
+
+function readRequestBody(req, limit) {
+  return new Promise((resolve, reject) => {
+    const chunks = []
+    let size = 0
+    let done = false
+    const fail = (err) => {
+      if (done) return
+      done = true
+      reject(err)
+    }
+    req.on('data', (chunk) => {
+      if (done) return
+      const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk), 'utf8')
+      size += buf.length
+      if (size > limit) {
+        fail(Object.assign(new Error('request body too large'), { code: 'LIMIT' }))
+        return
+      }
+      chunks.push(buf)
+    })
+    req.on('end', () => {
+      if (done) return
+      done = true
+      resolve(Buffer.concat(chunks).toString('utf8'))
+    })
+    req.on('error', (err) => fail(err))
+  })
+}
+
+function isLoopbackHostname(hostname) {
+  if (hostname === 'localhost' || hostname === '[::1]') return true
+  const parts = hostname.split('.')
+  return (
+    parts.length === 4 &&
+    parts.every((part) => /^\d{1,3}$/.test(part) && Number(part) <= 255) &&
+    parts[0] === '127'
+  )
+}
+
+function isLoopbackHost(rawHost) {
+  let host = typeof rawHost === 'string' ? rawHost.trim() : ''
+  if (host.length === 0) return false
+  if (host.startsWith('[')) {
+    const close = host.indexOf(']')
+    if (close === -1) return false
+    host = host.slice(0, close + 1)
+  } else {
+    const colon = host.indexOf(':')
+    if (colon !== -1) host = host.slice(0, colon)
+  }
+  return isLoopbackHostname(host)
+}
+
+function endpointFromPath(channel, pathname) {
+  if (!pathname.startsWith(channel + '/')) return undefined
+  const endpoint = pathname.slice(channel.length + 1)
+  if (endpoint.length === 0) return undefined
+  if (endpoint.split('/').some((segment) => segment.length === 0 || segment === '.' || segment === '..')) {
+    return undefined
+  }
+  return endpoint
+}
+
+function sendPlain(res, status, text) {
+  res.statusCode = status
+  res.setHeader('Content-Type', 'text/plain; charset=utf-8')
+  res.end(text)
+}
+
+function sendJson(res, status, payload) {
+  res.statusCode = status
+  res.setHeader('Content-Type', 'application/json; charset=utf-8')
+  res.end(JSON.stringify(payload))
+}
+
+function buildServerResponse(rpcId, result) {
+  return { type: 'server-response', rpcId, result }
+}
+
+function buildBadRequestResponse(rpcId) {
+  return buildServerResponse(rpcId, {
+    ok: false,
+    error: { code: 'bad-request', message: 'invalid client-request message', details: { issues: [] } },
+  })
+}
+
+async function handleBridgeRequest(req, res) {
+  if (typeof req.method !== 'string' || req.method !== 'POST') {
+    sendPlain(res, 404, 'not found')
+    return
+  }
+  const contentType = (req.headers['content-type'] ?? '').split(';', 1)[0].trim().toLowerCase()
+  if (contentType !== 'application/json') {
+    sendPlain(res, 415, 'content type must be application/json')
+    return
+  }
+  const hostHeader = req.headers.host
+  if (hostHeader === undefined || !isLoopbackHost(hostHeader)) {
+    sendPlain(res, 403, 'forbidden')
+    return
+  }
+  let raw
+  try {
+    raw = await readRequestBody(req, BODY_LIMIT)
+  } catch (err) {
+    if (err && err.code === 'LIMIT') {
+      sendPlain(res, 413, 'request body too large')
+    } else {
+      sendPlain(res, 400, 'body is not JSON')
+    }
+    return
+  }
+  let body
+  try {
+    body = raw.length === 0 ? {} : JSON.parse(raw)
+  } catch {
+    sendPlain(res, 400, 'body is not JSON')
+    return
+  }
+  const envelope = body
+  if (
+    envelope === null ||
+    typeof envelope !== 'object' ||
+    Array.isArray(envelope) ||
+    envelope.type !== 'client-request' ||
+    typeof envelope.rpcId !== 'string' ||
+    typeof envelope.method !== 'string'
+  ) {
+    sendJson(res, 200, buildBadRequestResponse('invalid-request'))
+    return
+  }
+  const rawUrl = typeof req.url === 'string' ? req.url : '/'
+  const pathname = new URL(rawUrl, 'http://dsh.internal').pathname
+  const endpoint = endpointFromPath(RPC_CHANNEL, pathname)
+  if (endpoint === undefined || envelope.method !== endpoint) {
+    sendJson(res, 200, buildBadRequestResponse(envelope.rpcId))
+    return
+  }
+  const result = await dispatch(endpoint, envelope.payload)
+  sendJson(res, 200, buildServerResponse(envelope.rpcId, result))
+}
+
+/* ------------------------------------------------------------------ *
+ * 插件入口
+ * ------------------------------------------------------------------ */
+
+export default {
+  inject: ['timer'],
+  apply(ctx) {
+    const webServer = ctx.get('webServer')
+    if (webServer !== undefined) {
+      ctx.effect(
+        () => webServer.register({ kind: 'prefix', path: RPC_CHANNEL, handler: handleBridgeRequest }),
+        'ollama-usage: rpc bridge',
+      )
+    }
+    ctx.effect(() => ctx.interval(autoRefresh, AUTO_REFRESH_MS), 'ollama-usage: auto refresh')
+    autoRefresh()
+  },
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "dsh-ollama-usage",
+  "version": "0.1.0",
+  "description": "DeepSeek Harness 插件:可视化 Ollama Pro 账号用量余量(每 5 小时会话用量 + 周用量),支持侧边栏双横条、设置页面板、API Key 与用量快照持久化、自动刷新与登录引导。Ollama Pro usage & remaining-quota visualization for DeepSeek Harness: 5-hour session + weekly quota bars in the sidebar footer, a full settings panel, persisted API key and usage snapshots, auto-refresh and login guidance.",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": ["slots", "connection", "timer"]
+    }
+  },
+  "dshhub": {
+    "schemaVersion": 1,
+    "displayName": "dsh-ollama-usage",
+    "summary": "Ollama Pro 用量余量可视化:会话(5h)/周用量双横条 + 设置页完整面板,Key 与快照持久化,自动刷新,登录引导。",
+    "categories": ["用量", "Web UI", "观测"],
+    "surfaces": ["host", "web"],
+    "capabilities": {
+      "provides": []
+    },
+    "compatibility": {
+      "dsh": ">=0.1.0-rc.5",
+      "node": ">=20"
+    },
+    "permissions": {
+      "network": ["https://ollama.com"]
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SeverusZh/dsh-ollama-usage.git"
+  },
+  "homepage": "https://github.com/SeverusZh/dsh-ollama-usage#readme",
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "client-plugin",
+    "ollama",
+    "ollama-pro",
+    "usage",
+    "quota",
+    "session",
+    "web-ui",
+    "zh",
+    "en"
+  ],
+  "license": "MIT"
+}