dsh-ds-balance 2.1.0 → 2.1.2

package/lib/config.js

@@ -135,7 +135,13 @@ export const Config = z.object({
  * 两边各存一份是因为**宿主与浏览器两个半体不许值导入**；约定本身由测试对着本表兜底。
  */
 export const THRESHOLD_PAIRS = [
-    { currency: 'CNY', warn: 'cnyWarn', critical: 'cnyCritical', defaultWarn: 10, defaultCritical: 5 },
+    {
+        currency: 'CNY',
+        warn: 'cnyWarn',
+        critical: 'cnyCritical',
+        defaultWarn: 10,
+        defaultCritical: 5,
+    },
     { currency: 'USD', warn: 'usdWarn', critical: 'usdCritical', defaultWarn: 2, defaultCritical: 1 },
 ];
 /**

package/lib/domain/errors.js

@@ -39,11 +39,16 @@ export class NetworkError extends AppError {
 /** 把 HTTP 状态码映射到错误码。 */
 export function upstreamCodeOf(status) {
     switch (status) {
-        case 401: return 'UPSTREAM_401';
-        case 402: return 'UPSTREAM_402';
-        case 422: return 'UPSTREAM_422';
-        case 429: return 'UPSTREAM_429';
-        case 503: return 'UPSTREAM_503';
+        case 401:
+            return 'UPSTREAM_401';
+        case 402:
+            return 'UPSTREAM_402';
+        case 422:
+            return 'UPSTREAM_422';
+        case 429:
+            return 'UPSTREAM_429';
+        case 503:
+            return 'UPSTREAM_503';
         default:
             if (status >= 500)
                 return 'UPSTREAM_5XX';

package/lib/domain/select.js

@@ -42,10 +42,10 @@ export function pickBalance(balances, preferred) {
         if (hit !== undefined)
             return hit;
     }
-    return ordered.find((item) => item.currency === 'CNY' && !isZeroMoney(item.total))
-        ?? ordered.find((item) => !isZeroMoney(item.total))
-        ?? ordered.find((item) => item.currency === 'CNY')
-        ?? ordered[0]
-        ?? null;
+    return (ordered.find((item) => item.currency === 'CNY' && !isZeroMoney(item.total)) ??
+        ordered.find((item) => !isZeroMoney(item.total)) ??
+        ordered.find((item) => item.currency === 'CNY') ??
+        ordered[0] ??
+        null);
 }
 //# sourceMappingURL=select.js.map

package/lib/http/handlers.js

@@ -96,7 +96,10 @@ export async function handleBalance(request, deps) {
         return json(toWireBalanceView(view, deps.service.accountTag8() ?? '', requestId));
     }
     catch (error) {
-        deps.logger?.error('ds-balance: balance handler failed', { requestId, error: describeError(error) });
+        deps.logger?.error('ds-balance: balance handler failed', {
+            requestId,
+            error: describeError(error),
+        });
         return json(failureView(requestId, error));
     }
 }
@@ -111,7 +114,10 @@ export async function handleRefresh(request, deps) {
         return json({ requestId, schemaVersion: SCHEMA_VERSION, ...result, error: null });
     }
     catch (error) {
-        deps.logger?.error('ds-balance: refresh handler failed', { requestId, error: describeError(error) });
+        deps.logger?.error('ds-balance: refresh handler failed', {
+            requestId,
+            error: describeError(error),
+        });
         return json({
             requestId,
             schemaVersion: SCHEMA_VERSION,
@@ -145,7 +151,10 @@ async function credentialInfo(deps, ref) {
         };
     }
     catch (error) {
-        deps.logger?.debug('ds-balance: credential describe failed', { ref, error: describeError(error) });
+        deps.logger?.debug('ds-balance: credential describe failed', {
+            ref,
+            error: describeError(error),
+        });
         return null;
     }
 }
@@ -169,7 +178,10 @@ export async function handleConfigGet(_request, deps) {
         return json(await configBody(requestId, deps));
     }
     catch (error) {
-        deps.logger?.error('ds-balance: config read handler failed', { requestId, error: describeError(error) });
+        deps.logger?.error('ds-balance: config read handler failed', {
+            requestId,
+            error: describeError(error),
+        });
         return json({ requestId, schemaVersion: SCHEMA_VERSION, error: toWireError(classify(error)) });
     }
 }
@@ -180,10 +192,20 @@ export async function handleConfigUpdate(request, deps) {
     try {
         const body = await readJsonObject(request);
         if (body === null)
-            return json({ requestId, error: { code: 'VALIDATION', message: 'body must be a JSON object', retryable: false } }, 422);
+            return json({
+                requestId,
+                error: { code: 'VALIDATION', message: 'body must be a JSON object', retryable: false },
+            }, 422);
         const unknown = Object.keys(body).filter((key) => !CONFIG_FIELDS.some((field) => field === key));
         if (unknown.length > 0) {
-            return json({ requestId, error: { code: 'VALIDATION', message: `unknown config field: ${unknown.join(', ')}`, retryable: false } }, 422);
+            return json({
+                requestId,
+                error: {
+                    code: 'VALIDATION',
+                    message: `unknown config field: ${unknown.join(', ')}`,
+                    retryable: false,
+                },
+            }, 422);
         }
         patch = body;
         if (Object.keys(patch).length > 0) {
@@ -197,7 +219,10 @@ export async function handleConfigUpdate(request, deps) {
         }
     }
     catch (error) {
-        deps.logger?.warn('ds-balance: config write rejected', { requestId, error: describeError(error) });
+        deps.logger?.warn('ds-balance: config write rejected', {
+            requestId,
+            error: describeError(error),
+        });
         return json({ requestId, error: toWireError(classify(error)) }, 422);
     }
     // 写完立刻回读，让调用方看到落盘后的真实值（掩码同上）。
@@ -205,7 +230,10 @@ export async function handleConfigUpdate(request, deps) {
         return json(await configBody(requestId, deps));
     }
     catch (error) {
-        deps.logger?.error('ds-balance: config readback failed', { requestId, error: describeError(error) });
+        deps.logger?.error('ds-balance: config readback failed', {
+            requestId,
+            error: describeError(error),
+        });
         return json({ requestId, schemaVersion: SCHEMA_VERSION, error: toWireError(classify(error)) });
     }
 }
@@ -216,9 +244,13 @@ export async function handleTestConnection(request, deps) {
         const body = await readJsonObject(request);
         const config = deps.config.current();
         const rawBaseUrl = body?.baseUrl;
-        const baseUrl = typeof rawBaseUrl === 'string' && rawBaseUrl.trim() !== '' ? rawBaseUrl.trim() : endpointOf(config);
+        const baseUrl = typeof rawBaseUrl === 'string' && rawBaseUrl.trim() !== ''
+            ? rawBaseUrl.trim()
+            : endpointOf(config);
         const rawTimeout = Number(body?.timeoutMs);
-        const timeoutMs = Number.isFinite(rawTimeout) && rawTimeout >= TEST_TIMEOUT_RANGE.min && rawTimeout <= TEST_TIMEOUT_RANGE.max
+        const timeoutMs = Number.isFinite(rawTimeout) &&
+            rawTimeout >= TEST_TIMEOUT_RANGE.min &&
+            rawTimeout <= TEST_TIMEOUT_RANGE.max
             ? Math.trunc(rawTimeout)
             : deps.config.timeoutMs();
         const rawApiKey = body?.apiKey;
@@ -231,16 +263,26 @@ export async function handleTestConnection(request, deps) {
         return json({ requestId, schemaVersion: SCHEMA_VERSION, ...result });
     }
     catch (error) {
-        deps.logger?.warn('ds-balance: test-connection handler failed', { requestId, error: describeError(error) });
+        deps.logger?.warn('ds-balance: test-connection handler failed', {
+            requestId,
+            error: describeError(error),
+        });
         const info = classify(error);
-        return json({ requestId, schemaVersion: SCHEMA_VERSION, ok: false, latencyMs: 0, code: info.code, message: info.message });
+        return json({
+            requestId,
+            schemaVersion: SCHEMA_VERSION,
+            ok: false,
+            latencyMs: 0,
+            code: info.code,
+            message: info.message,
+        });
     }
 }
 /** `GET /api/v1/healthz`。 */
 export async function handleHealthz(_request, deps) {
     const requestId = newRequestId();
     const status = deps.service.status();
-    let store = { ok: false, detail: 'health check failed' };
+    let store;
     try {
         const health = await deps.store.health();
         store = { ok: health.ok, detail: health.detail ?? null };

package/lib/index.js

@@ -11,7 +11,7 @@ import { randomBytes } from 'node:crypto';
 import { credentialRef } from '@deepseek-ai/dsh-credentials';
 import { dshHomePath } from '@deepseek-ai/dsh-home-paths';
 import { ENTRY_ID, THRESHOLD_PAIRS, readConfig, resolveThresholdPairs, } from './config.js';
-import { DomainCoreStore } from './adapters/domain-core-store.js';
+import { DomainCoreStore, } from './adapters/domain-core-store.js';
 import { HttpDeepSeekClient } from './adapters/http-deepseek-client.js';
 import { SALT_BYTES, SALT_ENCODING, loadOrCreateSalt } from './adapters/salt-file.js';
 import { createConsoleLogger } from './adapters/console-logger.js';
@@ -65,7 +65,9 @@ async function resolveSalt(logger) {
         return await loadOrCreateSalt({ path: dshHomePath(SALT_FILE_NAME) });
     }
     catch (error) {
-        logger.error('ds-balance: salt file unavailable, using an ephemeral salt', { error: describeError(error) });
+        logger.error('ds-balance: salt file unavailable, using an ephemeral salt', {
+            error: describeError(error),
+        });
         return randomBytes(SALT_BYTES).toString(SALT_ENCODING);
     }
 }
@@ -97,7 +99,9 @@ function createConfigSource(ctx, refs, logger) {
             if (warned.has(pair.currency))
                 continue;
             warned.add(pair.currency);
-            logger.warn('ds-balance: ' + pair.currency + ' critical must stay below warn; this pair fell back to its defaults', {
+            logger.warn('ds-balance: ' +
+                pair.currency +
+                ' critical must stay below warn; this pair fell back to its defaults', {
                 warn: pair.defaultWarn,
                 critical: pair.defaultCritical,
             });
@@ -143,7 +147,9 @@ function credentialsPort(ctx) {
         async resolve(ref) {
             const resolved = await service.resolve(credentialRef(ref));
             // 未配置时官方回 `undefined`；端口的约定是「值可能为空串」，交给上游判空。
-            return resolved === undefined ? { value: '', source: 'unset' } : { value: resolved.value, source: resolved.source };
+            return resolved === undefined
+                ? { value: '', source: 'unset' }
+                : { value: resolved.value, source: resolved.source };
         },
         describe: (ref) => service.describe(credentialRef(ref)),
     };
@@ -166,14 +172,16 @@ function connectStorage(ctx) {
     ctx.inject(['storageDomain'], (storageCtx) => {
         storageCtx.effect(() => {
             handle.facility = storageCtx.storageDomain;
-            return () => { handle.facility = undefined; };
+            return () => {
+                handle.facility = undefined;
+            };
         }, 'ds-balance: storage facility');
     });
     return async (spec) => {
         const facility = handle.facility;
         if (facility === undefined)
             throw new Error('storageDomain service is unavailable');
-        return await facility.open(spec);
+        return (await facility.open(spec));
     };
 }
 /**
@@ -207,7 +215,14 @@ export async function apply(ctx, refs) {
     // 由 healthz 的 metrics 段暴露（见 .agents/notes 的决策）。
     const metrics = new MemoryMetrics();
     const service = new BalanceService({
-        client, store, keys, config: configService, clock: systemClock, salt, logger, metrics,
+        client,
+        store,
+        keys,
+        config: configService,
+        clock: systemClock,
+        salt,
+        logger,
+        metrics,
     });
     const scheduler = new Scheduler({ target: service, logger });
     ctx.effect(() => {
@@ -235,9 +250,19 @@ export async function apply(ctx, refs) {
     ctx.inject(['connection'], (connectionCtx) => {
         connectionCtx.effect(() => {
             const disposeRoutes = registerHttpRoutes(connectionCtx, {
-                service, config: configService, keys, client, store, scheduler, logger, metrics, credentials,
+                service,
+                config: configService,
+                keys,
+                client,
+                store,
+                scheduler,
+                logger,
+                metrics,
+                credentials,
             });
-            return () => { void disposeRoutes(); };
+            return () => {
+                void disposeRoutes();
+            };
         }, 'ds-balance: http routes');
     });
 }

package/lib/services/balance-service.js

@@ -5,7 +5,7 @@
  * **对外永不抛错**：一切失败都变成 `view.state` 与 `view.error`。
  * @module dsh-ds-balance/services/balance-service
  */
-import { classify, describeError, parseRetryAfter } from '../domain/errors.js';
+import { classify, describeError, parseRetryAfter, } from '../domain/errors.js';
 import { normalize } from '../domain/normalize.js';
 import { pickBalance } from '../domain/select.js';
 import { severityOf, thresholdsFor } from '../domain/severity.js';
@@ -67,7 +67,9 @@ export class BalanceService {
             this.publishGauge();
         }
         catch (error) {
-            this.options.logger?.debug('ds-balance: no snapshot restored', { error: describeError(error) });
+            this.options.logger?.debug('ds-balance: no snapshot restored', {
+                error: describeError(error),
+            });
         }
     }
     /**
@@ -80,7 +82,9 @@ export class BalanceService {
             return this.inflight;
         if (options.force !== true && this.canServeCache())
             return this.toView(options.currency);
-        const run = this.fetchOnce(options.currency).finally(() => { this.inflight = null; });
+        const run = this.fetchOnce(options.currency).finally(() => {
+            this.inflight = null;
+        });
         this.inflight = run;
         return run;
     }
@@ -165,7 +169,9 @@ export class BalanceService {
             if (this.persistWarned)
                 return;
             this.persistWarned = true;
-            this.options.logger?.warn('ds-balance: snapshot not persisted, continuing in memory', { error: describeError(error) });
+            this.options.logger?.warn('ds-balance: snapshot not persisted, continuing in memory', {
+                error: describeError(error),
+            });
         }
     }
     /** 记录一次失败，并把状态推到 `stale` 或 `error`。 */
@@ -197,7 +203,9 @@ export class BalanceService {
             state: this.state,
             stale: this.state === 'stale',
             fetchedAt: this.snapshot?.fetchedAt ?? null,
-            ageMs: this.snapshot === null ? null : Math.max(0, this.options.clock.now() - this.snapshot.fetchedAt),
+            ageMs: this.snapshot === null
+                ? null
+                : Math.max(0, this.options.clock.now() - this.snapshot.fetchedAt),
             isAvailable: this.snapshot?.isAvailable ?? null,
             balances: this.snapshot?.balances ?? [],
             selected: selected === null ? null : { currency: selected.currency, total: selected.total },

package/lib/services/scheduler.js

@@ -60,7 +60,9 @@ export function nextDelayMs(status, options = {}) {
 /** 真正的默认定时器。 */
 const defaultTimers = {
     set: (callback, ms) => setTimeout(callback, ms),
-    clear: (handle) => { clearTimeout(handle); },
+    clear: (handle) => {
+        clearTimeout(handle);
+    },
 };
 /**
  * 刷新调度器。
@@ -118,7 +120,9 @@ export class Scheduler {
         if (!this.running)
             return;
         this.nextAt = this.now() + delay;
-        this.handle = this.timers.set(() => { void this.tick(); }, delay);
+        this.handle = this.timers.set(() => {
+            void this.tick();
+        }, delay);
     }
     /** 跑一轮并按状态排下一轮。 */
     async tick() {

package/lib/types/client/locales.d.ts

@@ -22,6 +22,7 @@ export declare const zh: {
     readonly 'popover.mismatch': "未找到 {wanted} 余额，当前显示 {shown}";
     readonly 'popover.action.useShown': "改用 {shown}";
     readonly 'popover.action.openPlugins': "打开插件页";
+    readonly 'popover.action.openPluginConfig': "打开插件配置页";
     readonly 'state.unavailable': "账户不可用";
     readonly 'state.stale': "数据已过期";
     readonly 'state.error': "读取失败";

package/lib/types/client/settings/fields.d.ts

@@ -123,10 +123,10 @@ export interface DetailsGroupProps {
     children: ReactNode;
 }
 /**
- * 渲染一个原生 details 折叠块。
+ * 渲染二级折叠「自定义设置」。
  *
- * **受控但跟手**：`open` 由 state 持有，用户拨动时从 DOM 读回真实状态，
- * 所以卡片每次重渲染（每敲一个字都会）不会把用户展开的块弹回去。
+ * **受控但跟手**：`open` 由 state 持有，官方 DisclosureRow 的展开体只在 open 时条件渲染，
+ * 卡片每次重渲染（每敲一个字都会）不会把用户展开的块弹回去。
  * @param props - 标题、初始状态与内容。
  * @returns 折叠块元素。
  */

package/lib/types/client/sidebar/BalancePopover.d.ts

@@ -46,10 +46,23 @@ export interface BalancePopoverProps {
      */
     useShownDisabled?: boolean;
     /**
-     * 「切到 Plugins 页」回调。宿主没提供 layout 服务时给 undefined ——
-     * 这时右上角那个图标按钮**不渲染**：不留按不动的死按钮。
+     * 右上角图标：点下去做什么、落到哪里。宿主没提供 layout 服务时给 undefined ——
+     * 这时那个按钮**不渲染**：不留按不动的死按钮。
      */
-    onOpenPlugins?: () => void;
+    pluginsAction?: PluginsAction;
+}
+/**
+ * 浮层右上角图标点下去会发生什么。
+ *
+ * 落点由**宿主能力**决定：宿主提供跨插件深链服务时直达本插件的配置格，
+ * 服务缺席时只能到 Plugins 列表。所以措辞跟着落点分档 ——
+ * 「打开插件配置页」与「打开插件页」各说自己那一件事，不许用一句含糊的话盖住两种落点。
+ */
+export interface PluginsAction {
+    /** 执行跳转；「先关浮层」由父组件包在里面。 */
+    open: () => void;
+    /** 落点是不是本插件的配置格。 */
+    reachesConfig: boolean;
 }
 /**
  * 渲染余额浮层。

package/lib/types/client/sidebar/PercentRing.d.ts

@@ -38,4 +38,4 @@ export interface PercentRingProps {
  * @param props - 状态、边长与可选提示。
  * @returns 圆环 svg；自身 aria-hidden，语义名由调用方的 aria-label 提供。
  */
-export declare function PercentRing({ state, marker, ratio, size, title }: PercentRingProps): JSX.Element;
+export declare function PercentRing({ state, marker, ratio, size, title, }: PercentRingProps): JSX.Element;

package/lib/types/client/sidebar/SidebarBalance.d.ts

@@ -13,14 +13,16 @@
  */
 import { type LocaleKey } from '../locales.ts';
 import { type ConfigSlotProbe } from '../config-slot.ts';
+import { type PluginsAction } from './BalancePopover.tsx';
 /**
- * 「切到 Plugins 页」这个**可选**入口。宿主没提供 layout 服务时整条链不存在，
+ * 「打开本插件配置」这个**可选**入口。宿主没提供 layout 服务时整条链不存在，
  * 浮层右上角的图标因此不渲染 —— 不留按不动的死按钮。
  * 形态与 `configSlotProbe` 一样是个可订阅的小对象：服务可能晚到，图标要能自己出现、也能自己消失。
+ * 快照里带**落点**（见 BalancePopover 的 PluginsAction）：深链服务在不在，措辞跟着分档。
  */
 export interface PluginsNavigation {
-    /** 当前可用的导航回调；服务还没到位时是 undefined。 */
-    getSnapshot: () => (() => void) | undefined;
+    /** 当前可用的动作与落点；宿主没有 layout 服务时是 undefined。 */
+    getSnapshot: () => PluginsAction | undefined;
     /**
      * 订阅它的出现与消失。
      * @param listener - 变化回调。
@@ -41,7 +43,7 @@ export interface SidebarBalanceProps {
      */
     configSlotProbe: ConfigSlotProbe;
     /**
-     * 「切到 Plugins 页」的可选入口：有它才渲染浮层右上角那个图标按钮。
+     * 「打开本插件配置」的可选入口：有它才渲染浮层右上角那个图标按钮。
      * 宿主缺 layout 服务时整条链不存在，图标就不出现。
      */
     pluginsNavigation?: PluginsNavigation;

package/lib/version.d.ts

@@ -8,5 +8,5 @@
 /** 线上 schema 版本。响应里逐条回传，消费方据此判断兼容性。 */
 export declare const SCHEMA_VERSION = 1;
 /** 插件版本。与 `package.json` 的 `version` 一致（有测试兜底）。 */
-export declare const PLUGIN_VERSION = "2.1.0";
+export declare const PLUGIN_VERSION = "2.1.2";
 //# sourceMappingURL=version.d.ts.map

package/lib/version.js

@@ -8,5 +8,5 @@
 /** 线上 schema 版本。响应里逐条回传，消费方据此判断兼容性。 */
 export const SCHEMA_VERSION = 1;
 /** 插件版本。与 `package.json` 的 `version` 一致（有测试兜底）。 */
-export const PLUGIN_VERSION = '2.1.0';
+export const PLUGIN_VERSION = '2.1.2';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ds-balance",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "icon": "./icon.svg",
   "description": "DSH plugin: shows the DeepSeek account balance at the bottom of the sidebar, with a configuration card on the Plugins page.",
   "keywords": [
@@ -67,6 +67,9 @@
     "test": "npm run build && vitest run",
     "test:watch": "vitest",
     "test:contract": "vitest run --config vitest.contract.config.ts",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "check:release": "node scripts/check-release.mjs",
     "check:declaration": "node scripts/check-declaration.mjs"
   },
@@ -101,14 +104,20 @@
     "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.1",
     "@deepseek-ai/dsh-storage-domain": ">=0.1.7-alpha.1",
     "@deepseek-ai/schemastery": "^3.18.3",
+    "@eslint/js": "^10.0.1",
     "@types/node": "^20.0.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.1",
     "clsx": "^2.1.1",
     "esbuild": "^0.21.5",
+    "eslint": "^10.11.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.12.0",
+    "prettier": "^3.9.9",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "typescript": "^5.4.0",
+    "typescript-eslint": "^8.70.1",
     "vitest": "^2.0.0"
   },
   "dependencies": {