@ychris12138/dsh-usage-stats 0.2.9 → 0.2.10

package/README.md

@@ -98,6 +98,7 @@ npx --yes github:Ychris12138/dsh-usage-stats --no-enable
 | Z.ai / 智谱 | 订阅 | `ZAI_API_KEY` | Coding Plan quota/subscription |
 | Kimi For Coding | 订阅 | `KIMI_API_KEY` | `/coding/v1/usages` |
 | MiniMax Coding Plan | 订阅 | `MINIMAX_API_KEY` | `/v1/token_plan/remains` |
+| Ollama 云 | 订阅 | `OLLAMA_API_KEY` | `/api/usage`（5小时 + 周窗口） |
 | New API | 余额 | provider 推理 Token | `/api/usage/token/` |
 | Sub2API / Passion | 自动判别 | provider `apiKeyEnv` | `/v1/usage` |
 | Sub2API 面板（真实） | 余额 | provider 推理 Token | `/user/balance`（复用 apiKey） |
@@ -139,10 +140,28 @@ KIMI_API_KEY: your-kimi-key
 MINIMAX_API_KEY: your-minimax-key
 # 中国区 MiniMax 用户可选；默认 global
 MINIMAX_API_REGION: cn
+OLLAMA_API_KEY: sk-ollama-your-key
 ```
 
 OpenCode Go 依次尝试 Harness credential、`~/.local/share/opencode/auth.json`，最后才使用显式 `OPENCODE_GO_AUTH_COOKIE + OPENCODE_GO_WORKSPACE_ID` 兼容回退。Bearer usage endpoint 目前不是公开 API，可能随上游变化；Cookie 等同登录凭据，不应进入日志或 issue。
 
+Ollama 云读取 `OLLAMA_API_KEY`，调用 `/api/usage` 展示两个订阅窗口（5 小时会话 + 每周），无余额；`usage` 按 0..1 比例换算为进度条。
+
+Ollama 适配器只对**已配置的 provider** 生效，不会自动添加账户：当 provider 的 id 为 `ollama`，或其 baseURL 主机为 `ollama.com`（含子域）时自动选用；本地 Ollama（`localhost:11434`）不会被当作云配额账户。特殊代理/自定义端点可用显式 monitor 绑定：
+
+```yaml
+# ~/.dsh/profiles/web/cordis.patch.yml
+- insert:
+    - id: usage-stats
+      name: dsh-usage-stats
+      config:
+        monitors:
+          relay-ollama:            # 你配置的 provider id
+            adapter: ollama
+            usageBaseURL: https://ollama.example.com
+            credentialRef: OLLAMA_API_KEY   # 非已配置 provider 时必填
+```
+
 Z.ai 全球区使用 `api.z.ai`，中国区使用 `open.bigmodel.cn`。MiniMax 优先使用官方 `www.minimax.io` / `www.minimaxi.com` Token Plan 地址，并解析 5 小时与周窗口的剩余比例和重置时间。
 
 ### New API、Sub2API 与自定义 monitor

package/lib/accounts.js

@@ -52,6 +52,7 @@ const ADAPTERS = new Set([
 	"zai-token-plan",
 	"kimi-token-plan",
 	"minimax-token-plan",
+	"ollama",
 	"declarative"
 ]);
 const SENSITIVE_HEADERS = new Set([
@@ -189,6 +190,15 @@ function defaultAdapter(provider) {
 	try {
 		const hostname = new URL(provider.baseURL).hostname.toLowerCase();
 		if (hostname === "passionapi.com" || hostname.endsWith(".passionapi.com")) return "sub2api";
+		// Ollama Cloud is detected by its canonical host so a user-configured
+		// provider with a custom id still gets the quota adapter; local Ollama
+		// (localhost:11434) never matches and stays without an account adapter.
+		// The id check is gated on the hostname so a local install that happens
+		// to use the canonical "ollama" id is not misread as a cloud account.
+		// Subdomains (e.g. api.ollama.com) are recognized for identification
+		// only: the usage query always targets the canonical ollama.com host,
+		// which is where the /api/usage endpoint is served.
+		if ((providerId === "ollama" || hostname === "ollama.com" || hostname.endsWith(".ollama.com")) && !privateHostname(hostname)) return "ollama";
 	} catch {
 		// A malformed provider URL is handled by the adapter when it is queried.
 	}
@@ -198,7 +208,7 @@ function defaultAdapter(provider) {
 
 function adapterMode(adapter, monitor) {
 	if (adapter === "declarative") return monitor.mode;
-	if (["opencode-go", "zai-token-plan", "kimi-token-plan", "minimax-token-plan"].includes(adapter)) return "subscription";
+	if (["opencode-go", "zai-token-plan", "kimi-token-plan", "minimax-token-plan", "ollama"].includes(adapter)) return "subscription";
 	return "balance";
 }
 
@@ -1118,7 +1128,8 @@ export async function queryAccount(spec, credentials, deps = {}) {
 		const subscriptionId = spec.adapter === "zai-token-plan" ? "zai"
 			: spec.adapter === "kimi-token-plan" ? "kimi"
 				: spec.adapter === "minimax-token-plan" ? "minimax"
-					: "opencode-go";
+					: spec.adapter === "ollama" ? "ollama"
+						: "opencode-go";
 		const provider = await collectSubscription(subscriptionId, credentials, {
 			apiKeyRef: spec.apiKeyRef,
 			region: spec.monitor.region

package/lib/client.js

@@ -62,6 +62,7 @@ window.__ModuleLoader__.load({
 			".usg_accountCard{--usg-providerAccent:#1f6feb;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:linear-gradient(135deg,color-mix(in srgb,var(--usg-providerAccent) 8%,transparent),transparent 42%);border-radius:12px;padding:10px 11px;display:flex;flex-direction:column;gap:9px}",
 			".usg_accountCard[data-provider=deepseek],.usg_accountCard[data-provider=deepseek-official]{--usg-providerAccent:#1f6feb}",
 			".usg_accountCard[data-provider=opencode-go]{--usg-providerAccent:#00a67d}",
+			".usg_accountCard[data-provider=ollama],.usg_accountCard[data-adapter=ollama]{--usg-providerAccent:#d97706}",
 			".usg_accountCard[data-provider=zai],.usg_accountCard[data-provider=zai-coding-cn]{--usg-providerAccent:#7656e8}",
 			".usg_accountCard[data-provider=openrouter]{--usg-providerAccent:#6366f1}",
 			".usg_accountCard[data-provider=moonshotai],.usg_accountCard[data-provider=moonshotai-cn],.usg_accountCard[data-provider=kimi],.usg_accountCard[data-provider=kimi-coding]{--usg-providerAccent:#e07a1f}",
@@ -960,6 +961,7 @@ window.__ModuleLoader__.load({
 				"deepseek-official": "DS",
 				deepseek: "DS",
 				"opencode-go": "GO",
+				ollama: "OL",
 				openrouter: "OR",
 				moonshotai: "K",
 				"moonshotai-cn": "K",
@@ -968,7 +970,7 @@ window.__ModuleLoader__.load({
 				zai: "Z",
 				"zai-coding-cn": "Z"
 			};
-			return known[provider.id] ?? String(provider.displayName ?? provider.id).replace(/[^A-Za-z0-9]/g, "").slice(0, 2).toUpperCase();
+			return known[provider.id] ?? known[provider.adapter] ?? String(provider.displayName ?? provider.id).replace(/[^A-Za-z0-9]/g, "").slice(0, 2).toUpperCase();
 		}
 
 		/** Balance-mode body rendered inside the shared provider account frame. */
@@ -1129,6 +1131,7 @@ window.__ModuleLoader__.load({
 			return react_jsx_runtime.jsxs("article", {
 				className: S.accountCard,
 				"data-provider": provider.id,
+				"data-adapter": provider.adapter ?? provider.accountMode ?? "",
 				"data-account-mode": mode,
 				children: [
 					react_jsx_runtime.jsxs("div", {

package/lib/subscriptions.js

@@ -38,6 +38,7 @@ const MINIMAX_LEGACY_HOSTS = {
 };
 const MINIMAX_USAGE_PATH = "/v1/api/openplatform/coding_plan/remains";
 const MINIMAX_TOKEN_PLAN_PATH = "/v1/token_plan/remains";
+const OLLAMA_USAGE_URL = "https://ollama.com/api/usage";
 const DEFAULT_TIMEOUT_MS = 15000;
 
 const REFS = {
@@ -48,7 +49,8 @@ const REFS = {
 	zaiRegion: "ZAI_API_REGION",
 	kimiApiKey: "KIMI_API_KEY",
 	minimaxApiKey: "MINIMAX_API_KEY",
-	minimaxRegion: "MINIMAX_API_REGION"
+	minimaxRegion: "MINIMAX_API_REGION",
+	ollamaApiKey: "OLLAMA_API_KEY"
 };
 
 function numberOrNull(value) {
@@ -576,6 +578,61 @@ async function collectMiniMax(credentials, deps) {
 	}
 }
 
+/**
+ * Ollama Cloud usage monitor.
+ *
+ * Ollama's cloud /api/usage endpoint reports consumed usage ratios for two
+ * limit windows (a 5-hour session window and a weekly window), plus an
+ * activity cost. There is no monetary balance, so this adapter presents the
+ * two windows as subscription-style progress bars, mirroring OpenCode Go.
+ */
+function ollamaWindowFromObject(limit, kind) {
+	if (limit === null || typeof limit !== "object") return null;
+	// limits.session.usage / limits.weekly.usage are 0..1 consumed ratios
+	// (observed 0.0x..0.3x on live data). clampPercent maps any numeric ratio
+	// onto 0..100, so an over-quota window renders as a fully-used bar rather
+	// than silently disappearing, mirroring the OpenCode Go adapter.
+	const ratio = numberOrNull(limit.usage);
+	if (ratio === null) return null;
+	const usedPercent = round1(clampPercent(ratio * 100));
+	return {
+		kind,
+		usedPercent,
+		remainingPercent: round1(100 - usedPercent)
+	};
+}
+
+function parseOllama(body) {
+	const limits = body?.limits;
+	if (limits === null || typeof limits !== "object") return [];
+	return [
+		ollamaWindowFromObject(limits.session, "session"),
+		ollamaWindowFromObject(limits.weekly, "weekly")
+	].filter(Boolean);
+}
+
+async function collectOllama(credentials, deps) {
+	const apiKeyRef = deps.apiKeyRef ?? REFS.ollamaApiKey;
+	const apiKey = await resolveCredential(credentials, apiKeyRef);
+	if (apiKey === "") return { id: "ollama", displayName: "Ollama", mode: "subscription", status: "not-configured", plan: "Ollama", missingCredentials: [apiKeyRef], windows: [] };
+	try {
+		const body = await request(nonEmptyUrl(deps.baseURL, "/api/usage") ?? OLLAMA_USAGE_URL, {
+			headers: { authorization: `Bearer ${apiKey}`, accept: "application/json" }
+		}, deps, "json");
+		const windows = parseOllama(body);
+		return {
+			id: "ollama",
+			displayName: "Ollama",
+			mode: "subscription",
+			status: windows.length > 0 ? "ok" : "invalid-response",
+			plan: "Ollama",
+			windows
+		};
+	} catch (error) {
+		return { id: "ollama", displayName: "Ollama", mode: "subscription", status: normalizedStatus(error), plan: "Ollama", windows: [] };
+	}
+}
+
 /** Query one subscription/token-plan adapter. */
 export async function collectSubscription(providerId, credentials, options = {}, deps = {}) {
 	const shared = {
@@ -596,6 +653,7 @@ export async function collectSubscription(providerId, credentials, options = {},
 	});
 	if (providerId === "kimi") return collectKimi(credentials, shared);
 	if (providerId === "minimax") return collectMiniMax(credentials, shared);
+	if (providerId === "ollama") return collectOllama(credentials, shared);
 	return { id: providerId, displayName: providerId, mode: "subscription", status: "unavailable", windows: [] };
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ychris12138/dsh-usage-stats",
   "description": "Token usage heatmap, provider balances, and subscription quotas for the dsh web GUI",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Ychris12138/dsh-usage-stats.git"