dsh-connect-minimaxcode 0.3.0 → 0.4.0

package/README.md

@@ -184,6 +184,28 @@ Content-Type: application/json
 | `token_plan_credit.remaining_credits` | 已购积分池 | ❌ |
 | `query_balance.available_amount` | 开放平台钱包（元） | ❌ |
 
+### 积分会过期吗？会
+
+积分不是一池子，而是**按笔发放的批次**，每批有自己的到期日。客户端每天发一批，每批大约在**发放后 29 天**到期，于是形成一条逐日错开的 30 天阶梯：
+
+```
+GET https://agent.minimax.cn/minimax-cloud/api/v1/credit/details?page=1&page_size=100
+→ details[] { granted_amount, remaining_amount, consumed_amount, granted_at_ms, expire_at_ms }
+```
+
+实测本机 23 笔：09-20 发的在 10-19 到期，09-21 发的在 10-20 到期……另有一笔 08-25 发的在 **2027-08-25** 到期（一年期批次）。
+
+插件据此在**插件页面**（设置 → 插件 → DSH Connect MiniMax Code）与输入框下方的胶囊里给出：
+
+- **7 天内到期**的剩余积分，以及最近一笔的到期日
+- **30 天内到期**的剩余积分
+- 接下来几笔**到期批次**的清单（日期 + 金额）
+- 余额条与本机消耗（token 数、等效金额）
+
+只统计**仍有余额**的批次：已发放但用光的批次到期时并没有东西可损失，把它算进去会让每个账号都看起来"快过期了"。
+
+> 台账的 `remaining_amount` 合计与余额接口的 `total_remaining_amount` 会**略有出入**（实测差 0.006，浮点累加所致；两次采样之间余额本身也会变）。插件以**余额接口**显示总额，台账只用来回答"什么时候过期"。
+
 ### 消耗怎么算
 
 两路数据各管一件事：
@@ -199,6 +221,8 @@ Content-Type: application/json
 
   折算出的金额是**等效金额**，不是扣费：积分与金额之间 MiniMax 没有公开换算关系（套餐只公布了 1×/3×/12× 的相对倍数），所以插件不会把它说成「花了多少积分」。
 
+  > 官方价目表没有单列**缓存写入**（`cache_creation_input_tokens`）的单价，因此插件只统计它的 token 数、**不折算金额**，以免给出一个没有公开依据的数字。
+
 ### 关于续期
 
 OAuth 令牌有效期约 1 小时，由客户端自动续期。插件**只在自己的令牌已过期时**才用 App 已存的 refresh token 续一次，并把轮换后的新令牌按客户端**原格式原子写回**同一个文件（`generation` 保持不变），因此桌面 App 的登录态不受影响。插件不会发起登录、不会登出、也不会调用任何付费/订阅类接口。
@@ -219,6 +243,13 @@ OAuth 令牌有效期约 1 小时，由客户端自动续期。插件**只在自
 
 ## 更新记录
 
+### 0.4.0（2026-10-19）
+
+- **新增「积分即将过期」**：积分是按笔发放、每批独立到期的（发放后约 29 天）。插件读取积分台账 `GET /minimax-cloud/api/v1/credit/details`，在**插件页面**与胶囊里显示 7 天内到期、30 天内到期、最近一笔到期日与到期批次清单。
+- **只统计仍有余额的批次**，避免把「已用光但快到期」的批次算成损失。
+- **插件页面卡片**：在「设置 → 插件 → DSH Connect MiniMax Code」新增一张卡片（余额、赠送/购买拆分、到期分布、到期批次、本机消耗与等效金额），列表里则显示一行摘要。
+- 胶囊与卡片共用一个状态存储与同一个轮询器，多个界面不会重复请求账户接口。
+
 ### 0.3.0（2026-10-19）
 
 - **新增积分余额显示**：对话框输入框下方的胶囊显示 MiniMax Code 的剩余积分（赠送/购买拆分），点开可看两次读取之间的消耗、本机累计 token 与按官方价目表折算的等效金额。

package/lib/client.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * The browser half: a credit pill in the composer's dock.
+ * The browser half: the credit balance, in the composer and on the page.
  *
  * The host loads a client bundle as a classic script and calls
  * `window.__ModuleLoader__.load`, handing the factory a `require` that
@@ -8,10 +8,10 @@
  * the host — this file installs no React of its own, and ships no bundler
  * output: it is a script, so it can be dropped into the page as-is.
  *
- * The pill shows the account's remaining credits and what this host's
- * conversations have used, both read from the plugin's own status route. It
- * degrades quietly: a failed read keeps the last value rather than blanking
- * the dock.
+ * Two surfaces read the same data: a pill in the composer's dock, and a card
+ * on the plugin's own page. Both read it through one store with one ticker,
+ * so the account API is asked once per interval no matter how many surfaces
+ * are on screen.
  */
 ;
 (function bootstrapMinimaxCodeClient() {
@@ -32,7 +32,13 @@
         unavailable: '积分不可用',
         expired: '登录态已过期',
         signedOut: '未登录 MiniMax Code',
-        close: '收起',
+        expiring: '即将过期',
+        expiringIn: '{amount} 积分 · {date} 到期',
+        expiringNone: '7 天内没有积分到期',
+        expiringSoon: '30 天内到期 {amount} 积分',
+        nextExpiry: '最近一笔到期',
+        lots: '到期批次',
+        noLots: '没有待到期的积分批次',
     };
     const en = {
         title: 'MiniMax Code credits',
@@ -47,7 +53,13 @@
         unavailable: 'Credits unavailable',
         expired: 'Sign-in expired',
         signedOut: 'MiniMax Code not signed in',
-        close: 'Hide',
+        expiring: 'Expiring soon',
+        expiringIn: '{amount} credits · expires {date}',
+        expiringNone: 'No credits expire within 7 days',
+        expiringSoon: '{amount} credits expire within 30 days',
+        nextExpiry: 'Next expiry',
+        lots: 'Expiring grants',
+        noLots: 'No grant is waiting to expire',
     };
     const loader = globalThis.__ModuleLoader__;
     if (loader === undefined)
@@ -83,38 +95,81 @@
                     return value.toFixed(4);
                 return value.toFixed(2);
             }
-            /** The pill, plus the detail panel it opens. */
-            function CreditPill(props) {
+            /** Format a date as a short day. */
+            function day(value) {
+                if (value === undefined)
+                    return '—';
+                const date = new Date(value);
+                return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`;
+            }
+            /**
+             * The shared status store.
+             *
+             * One ticker serves every surface, so a second surface costs no extra
+             * request. The store starts when the first surface subscribes and stops
+             * when the last one leaves.
+             */
+            const listeners = new Set();
+            let snapshot;
+            let timer;
+            async function load() {
+                try {
+                    const response = await fetch(STATUS_PATH, { headers: { accept: 'application/json' } });
+                    if (!response.ok)
+                        return;
+                    const document = await response.json();
+                    snapshot = document;
+                    for (const listener of listeners)
+                        listener(snapshot);
+                }
+                catch {
+                    // Keep the last value: a failed poll is not worth a blank pill.
+                }
+            }
+            function subscribe(listener) {
+                listeners.add(listener);
+                if (listeners.size === 1) {
+                    void load();
+                    timer = setInterval(() => { void load(); }, POLL_INTERVAL_MS);
+                }
+                return () => {
+                    listeners.delete(listener);
+                    if (listeners.size === 0 && timer !== undefined) {
+                        clearInterval(timer);
+                        timer = undefined;
+                    }
+                };
+            }
+            /** Read the shared status into a component's state. */
+            function useStatus() {
                 const [status, setStatus] = React.useState(undefined);
+                React.useEffect(() => subscribe(setStatus), []);
+                return status;
+            }
+            /** A row of label and value. */
+            function row(label, value) {
+                return h('div', { style: rowStyle }, h('span', null, label), h('span', null, value));
+            }
+            /** The expiry block, shared by the pill's detail and the page card. */
+            function expiryBlock(t, credits_) {
+                if (credits_ === undefined)
+                    return null;
+                const expiring = credits_.expiring ?? 0;
+                const next = credits_.nextExpiryAtMs;
+                return h('div', { style: expiryBoxStyle, 'data-minimax-credits-expiry': true }, h('div', { style: rowStyle }, h('span', null, t('expiring')), h('span', { style: expiring > 0 ? warnStyle : undefined }, expiring > 0
+                    ? t('expiringIn', { amount: credits(expiring, 2), date: day(next) })
+                    : t('expiringNone'))), credits_.expiringSoon !== undefined && credits_.expiringSoon > 0
+                    ? row(t('expiringSoon', { amount: credits(credits_.expiringSoon, 2) }), '')
+                    : null, next !== undefined ? row(t('nextExpiry'), day(next)) : null);
+            }
+            /** The pill in the composer's dock. */
+            function CreditPill(props) {
+                const status = useStatus();
                 const [open, setOpen] = React.useState(false);
-                // `t` comes from the host's locale service when the slot declares the
-                // namespace; the built-in copy is the fallback for a host that does not.
                 const t = props.t ?? ((key, params) => {
                     const template = zh[key] ?? key;
                     return template.replace(/\{(\w+)\}/g, (_match, name) => String(params?.[name] ?? ''));
                 });
-                React.useEffect(() => {
-                    let cancelled = false;
-                    const load = async () => {
-                        try {
-                            const response = await fetch(STATUS_PATH, { headers: { accept: 'application/json' } });
-                            if (!response.ok)
-                                return;
-                            const document = await response.json();
-                            if (!cancelled)
-                                setStatus(document);
-                        }
-                        catch {
-                            // Keep the last value: a failed poll is not worth a blank pill.
-                        }
-                    };
-                    void load();
-                    const timer = setInterval(() => { void load(); }, POLL_INTERVAL_MS);
-                    return () => {
-                        cancelled = true;
-                        clearInterval(timer);
-                    };
-                }, []);
                 const credits_ = status?.credits;
                 const usage = status?.usage;
                 const available = credits_?.state === 'ok' && credits_.total !== undefined;
@@ -122,14 +177,12 @@
                     ? t('balance', { total: credits(credits_.total, 2) })
                     : t(credits_?.state === 'expired' ? 'expired' : credits_?.state === 'signed-out' ? 'signedOut' : 'unavailable');
                 const detail = available
-                    ? h('div', { style: detailStyle, 'data-minimax-credits-detail': true }, h('div', { style: detailRowStyle }, h('span', null, t('free')), h('span', null, credits(credits_.free, 3))), h('div', { style: detailRowStyle }, h('span', null, t('purchased')), h('span', null, credits(credits_.purchased, 3))), credits_.consumed !== undefined && credits_.consumed > 0
-                        ? h('div', { style: detailRowStyle }, h('span', null, t('consumed')), h('span', null, credits(credits_.consumed, 3)))
-                        : null, usage !== undefined
-                        ? h('div', { style: detailRowStyle }, h('span', null, t('tokens', { count: tokens(usage.inputTokens + usage.outputTokens + usage.cacheReadTokens) })), h('span', null, t('cost', { amount: money(usage.estimatedCny) })))
-                        : null, usage !== undefined && usage.requests > 0
-                        ? h('div', { style: detailRowStyle }, h('span', null, t('requests', { count: usage.requests })), h('span', null, usage.lastModel ?? ''))
+                    ? h('div', { style: detailStyle, 'data-minimax-credits-detail': true }, row(t('free'), credits(credits_.free, 3)), row(t('purchased'), credits(credits_.purchased, 3)), credits_.consumed !== undefined && credits_.consumed > 0
+                        ? row(t('consumed'), credits(credits_.consumed, 3))
+                        : null, expiryBlock(t, credits_), usage !== undefined
+                        ? h('div', { style: rowStyle }, h('span', null, t('tokens', { count: tokens(usage.inputTokens + usage.outputTokens + usage.cacheReadTokens) })), h('span', null, t('cost', { amount: money(usage.estimatedCny) })))
                         : null, credits_.updatedAtMs !== undefined
-                        ? h('div', { style: detailRowStyle }, h('span', null, t('updated', { time: new Date(credits_.updatedAtMs).toLocaleTimeString() })), h('span', null, ''))
+                        ? row(t('updated', { time: new Date(credits_.updatedAtMs).toLocaleTimeString() }), '')
                         : null)
                     : null;
                 return h('div', { style: wrapStyle, 'data-minimax-credits': true }, h('button', {
@@ -139,6 +192,39 @@
                     onClick: () => setOpen(!open),
                 }, label), open ? detail : null);
             }
+            /**
+             * The card on the plugin's own page.
+             *
+             * The summary view is the one line the plugin list shows; the page view
+             * is the full card, where the expiry detail belongs.
+             */
+            function PluginPage(props) {
+                const status = useStatus();
+                const t = props.t ?? ((key, params) => {
+                    const template = zh[key] ?? key;
+                    return template.replace(/\{(\w+)\}/g, (_match, name) => String(params?.[name] ?? ''));
+                });
+                const credits_ = status?.credits;
+                const usage = status?.usage;
+                const available = credits_?.state === 'ok' && credits_.total !== undefined;
+                if (props.view === 'summary') {
+                    if (!available)
+                        return h('span', null, t('unavailable'));
+                    return h('span', { 'data-minimax-credits-summary': true }, t('balance', { total: credits(credits_.total, 2) }), credits_.expiring !== undefined && credits_.expiring > 0
+                        ? ` · ${t('expiringIn', { amount: credits(credits_.expiring, 2), date: day(credits_.nextExpiryAtMs) })}`
+                        : '');
+                }
+                if (!available) {
+                    return h('div', { style: cardStyle, 'data-minimax-credits-card': true }, h('div', { style: cardTitleStyle }, t('title')), h('div', { style: rowStyle }, h('span', null, t('unavailable')), h('span', null, credits_?.state === 'expired' ? t('expired') : '')));
+                }
+                return h('div', { style: cardStyle, 'data-minimax-credits-card': true }, h('div', { style: cardTitleStyle }, t('title')), h('div', { style: bigNumberStyle }, t('balance', { total: credits(credits_.total, 2) })), row(t('free'), credits(credits_.free, 3)), row(t('purchased'), credits(credits_.purchased, 3)), expiryBlock(t, credits_), h('div', { style: sectionTitleStyle }, t('lots')), (credits_.upcoming ?? []).length === 0
+                    ? h('div', { style: mutedStyle }, t('noLots'))
+                    : h('ul', { style: listStyle }, ...(credits_.upcoming ?? []).map((lot, index) => h('li', { key: `${lot.expireAtMs}-${index}`, style: rowStyle }, h('span', null, day(lot.expireAtMs)), h('span', null, credits(lot.amount, 2))))), usage !== undefined
+                    ? h('div', { style: usageBoxStyle }, row(t('tokens', { count: tokens(usage.inputTokens + usage.outputTokens + usage.cacheReadTokens) }), ''), row(t('cost', { amount: money(usage.estimatedCny) }), ''), usage.requests > 0 ? row(t('requests', { count: usage.requests }), usage.lastModel ?? '') : null)
+                    : null, credits_.updatedAtMs !== undefined
+                    ? h('div', { style: mutedStyle }, t('updated', { time: new Date(credits_.updatedAtMs).toLocaleTimeString() }))
+                    : null);
+            }
             const wrapStyle = {
                 position: 'relative',
                 display: 'inline-flex',
@@ -162,7 +248,7 @@
                 bottom: 'calc(100% + 6px)',
                 left: 0,
                 zIndex: 10,
-                minWidth: '220px',
+                minWidth: '240px',
                 borderRadius: '8px',
                 background: 'var(--dsh-panel-background, Canvas)',
                 color: 'var(--dsh-panel-foreground, CanvasText)',
@@ -173,11 +259,36 @@
                 lineHeight: 1.6,
                 textAlign: 'left',
             };
-            const detailRowStyle = {
+            const rowStyle = {
                 display: 'flex',
                 justifyContent: 'space-between',
                 gap: '16px',
             };
+            const expiryBoxStyle = {
+                marginTop: '6px',
+                paddingTop: '6px',
+                borderTop: '1px solid var(--dsh-panel-border, currentColor)',
+                opacity: 0.95,
+            };
+            const warnStyle = { color: 'var(--dsh-warning, #b45309)' };
+            const cardStyle = {
+                display: 'flex',
+                flexDirection: 'column',
+                gap: '6px',
+                fontSize: '13px',
+                lineHeight: 1.6,
+            };
+            const cardTitleStyle = { fontWeight: 600 };
+            const bigNumberStyle = { fontSize: '20px', fontWeight: 600, marginBottom: '2px' };
+            const sectionTitleStyle = { marginTop: '8px', fontWeight: 600 };
+            const mutedStyle = { opacity: 0.7, fontSize: '12px' };
+            const listStyle = { listStyle: 'none', margin: 0, padding: 0 };
+            const usageBoxStyle = {
+                marginTop: '8px',
+                paddingTop: '6px',
+                borderTop: '1px solid var(--dsh-panel-border, currentColor)',
+                opacity: 0.9,
+            };
             return {
                 inject: ['slots', 'locale'],
                 apply(ctx) {
@@ -192,6 +303,13 @@
                         order: 2,
                         locale: NAMESPACE,
                     }, CreditPill));
+                    // The plugin's own page, keyed by the package name, where the
+                    // balance and the expiry schedule are spelled out.
+                    context.slots.inject('plugins.bundle.config', () => context.slots.register({
+                        name: 'plugins.bundle.config',
+                        key: BUNDLE_NAME,
+                        locale: NAMESPACE,
+                    }, PluginPage));
                 },
             };
         },

package/lib/index.d.ts

@@ -308,6 +308,45 @@ interface CreditSnapshot {
    */
   consumed: number;
 }
+/**
+ * One grant of credits.
+ *
+ * Credits are granted in lots, and each lot carries its own expiry: the
+ * desktop app grants credits daily, and every lot falls due about a month
+ * later on a day of its own. Credits in a lot are lost when that day arrives.
+ */
+interface CreditLot {
+  /** How much this lot was granted. */
+  granted: number;
+  /** How much of it is left. */
+  remaining: number;
+  /** How much of it has been used. */
+  consumed: number;
+  /** When the lot was granted, in milliseconds since the epoch. */
+  grantedAtMs: number;
+  /** When the lot expires, in milliseconds since the epoch. */
+  expireAtMs: number;
+  /** The upstream's kind of lot, when it says. */
+  creditType?: number;
+}
+/** What the lots say about credits that are about to be lost. */
+interface ExpirySummary {
+  /** Credits in lots that expire within {@link EXPIRING_WINDOW_DAYS} days. */
+  expiring: number;
+  /** How many lots that is. */
+  expiringLots: number;
+  /** Credits in lots that expire within {@link EXPIRING_HORIZON_DAYS} days. */
+  expiringSoon: number;
+  /** When the next lot with credits left expires. */
+  nextExpiryAtMs?: number;
+  /** The next lots with credits left, soonest first. */
+  upcoming: {
+    amount: number;
+    expireAtMs: number;
+  }[];
+  /** Credits left across every lot. */
+  totalRemaining: number;
+}
 /**
  * Keeps the current balance and the change between reads.
  *
@@ -320,12 +359,32 @@ declare class MinimaxCredits {
   get snapshot(): CreditSnapshot | undefined;
   /** Why the last read failed, when one did. */
   get error(): string | undefined;
+  /** The credit lots as last read. */
+  get lots(): readonly CreditLot[];
+  /** What the lots say about expiry, when the ledger could be read. */
+  get expiry(): ExpirySummary | undefined;
+  /** When the ledger was last read. */
+  get ledgerAtMs(): number | undefined;
+  /** Why the ledger could not be read, when it could not. */
+  get ledgerError(): string | undefined;
   /**
    * Read the balance and record how much was consumed since the last read.
    *
+   * The credit ledger is read alongside it, but a ledger that cannot be read
+   * never hides the balance: the two come from different endpoints and only
+   * the balance is essential.
+   *
    * @returns Whether the balance changed.
    */
   refresh(credential: OAuthCredential, region: MinimaxRegion, fetchImpl?: typeof fetch, now?: number): Promise<boolean>;
+  /**
+   * Read the credit ledger and work out what is about to expire.
+   *
+   * A failure here is remembered but never thrown: the balance is what the
+   * user needs most, and a ledger that is temporarily unavailable must not
+   * take it down with it.
+   */
+  refreshLedger(credential: OAuthCredential, region: MinimaxRegion, fetchImpl?: typeof fetch, now?: number): Promise<void>;
 }
 //#endregion
 //#region src/usage.d.ts
@@ -434,6 +493,23 @@ interface CreditStatus {
   updatedAtMs?: number;
   /** Why the balance could not be read. */
   error?: string;
+  /** Credits that expire within the next week. */
+  expiring?: number;
+  /** How many grants that is. */
+  expiringLots?: number;
+  /** Credits that expire within the next month. */
+  expiringSoon?: number;
+  /** When the next grant with credits left expires. */
+  nextExpiryAtMs?: number;
+  /** The next grants with credits left, soonest first. */
+  upcoming?: {
+    amount: number;
+    expireAtMs: number;
+  }[];
+  /** When the ledger was read, in milliseconds since the epoch. */
+  ledgerAtMs?: number;
+  /** Why the ledger could not be read. */
+  ledgerError?: string;
 }
 /** What the plugin's own requests have used. */
 interface UsageStatus {

package/lib/index.js

@@ -716,6 +716,8 @@ const MINIMAX_ACCOUNT_HOSTS = {
 };
 /** Membership endpoint: carries the credit summary. */
 const MEMBERSHIP_PATH = "/matrix/api/v1/commerce/get_membership_info";
+/** Credit ledger endpoint: per-grant amounts and expiry. */
+const CREDIT_DETAILS_PATH = "/minimax-cloud/api/v1/credit/details";
 /** OAuth token endpoint. */
 const TOKEN_PATH = "/oauth2/token";
 /** Absolute path of the app's credential file for a region. */
@@ -961,6 +963,84 @@ async function fetchCreditSummary(credential, region, fetchImpl = fetch) {
 	return parseCreditSummary(await response.json());
 }
 /**
+* Read the credit lots out of a ledger response.
+*
+* Lots that carry no expiry are ignored: a lot without an expiry date would
+* otherwise be treated as one that never expires.
+*/
+function parseCreditLots(document) {
+	if (typeof document !== "object" || document === null) return [];
+	const details = document.details;
+	if (!Array.isArray(details)) return [];
+	const lots = [];
+	for (const entry of details) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const record = entry;
+		const expireAtMs = toNumber(record.expire_at_ms);
+		if (expireAtMs === void 0) continue;
+		const granted = toNumber(record.granted_amount) ?? 0;
+		const remaining = toNumber(record.remaining_amount) ?? 0;
+		lots.push({
+			granted,
+			remaining,
+			consumed: toNumber(record.consumed_amount) ?? Math.max(0, granted - remaining),
+			grantedAtMs: toNumber(record.granted_at_ms) ?? 0,
+			expireAtMs,
+			creditType: toNumber(record.credit_type)
+		});
+	}
+	return lots.sort((a, b) => a.expireAtMs - b.expireAtMs);
+}
+/**
+* Fetch the credit ledger.
+*
+* The ledger is paginated, so every page is read. The number of pages comes
+* from the account's own `total_count` rather than from a guess, and a lot
+* count that stops growing ends the walk.
+*/
+async function fetchCreditLots(credential, region, fetchImpl = fetch) {
+	const pageSize = 100;
+	const lots = [];
+	let page = 1;
+	let total = Number.POSITIVE_INFINITY;
+	while (lots.length < total && page <= 50) {
+		const response = await fetchImpl(`${MINIMAX_ACCOUNT_HOSTS[region]}${CREDIT_DETAILS_PATH}?page=${page}&page_size=${pageSize}`, { headers: { authorization: `Bearer ${credential.token}` } });
+		if (!response.ok) throw new Error(`credit ledger request failed: HTTP ${response.status}`);
+		const document = await response.json();
+		const batch = parseCreditLots(document);
+		lots.push(...batch);
+		const count = toNumber(document.total_count);
+		if (count !== void 0) total = count;
+		if (batch.length < pageSize) break;
+		page += 1;
+	}
+	return lots;
+}
+/**
+* Summarize what is about to expire.
+*
+* Only lots that still hold credits count: a lot that was granted and used up
+* expires with nothing to lose, and counting it would make every account look
+* like it is about to lose credits.
+*/
+function summarizeExpiry(lots, now = Date.now()) {
+	const alive = lots.filter((lot) => lot.remaining > 0 && lot.expireAtMs > now);
+	const within = (days) => alive.filter((lot) => lot.expireAtMs - now <= days * 864e5);
+	const week = within(7);
+	const month = within(30);
+	return {
+		expiring: week.reduce((sum, lot) => sum + lot.remaining, 0),
+		expiringLots: week.length,
+		expiringSoon: month.reduce((sum, lot) => sum + lot.remaining, 0),
+		nextExpiryAtMs: alive[0]?.expireAtMs,
+		upcoming: alive.slice(0, 5).map((lot) => ({
+			amount: lot.remaining,
+			expireAtMs: lot.expireAtMs
+		})),
+		totalRemaining: lots.reduce((sum, lot) => sum + lot.remaining, 0)
+	};
+}
+/**
 * Keeps the current balance and the change between reads.
 *
 * The first read has nothing to compare against, so it reports no movement
@@ -969,6 +1049,10 @@ async function fetchCreditSummary(credential, region, fetchImpl = fetch) {
 var MinimaxCredits = class {
 	#snapshot;
 	#error;
+	#lots = [];
+	#expiry;
+	#ledgerAtMs;
+	#ledgerError;
 	/** The balance as last read. */
 	get snapshot() {
 		return this.#snapshot;
@@ -977,29 +1061,68 @@ var MinimaxCredits = class {
 	get error() {
 		return this.#error;
 	}
+	/** The credit lots as last read. */
+	get lots() {
+		return this.#lots;
+	}
+	/** What the lots say about expiry, when the ledger could be read. */
+	get expiry() {
+		return this.#expiry;
+	}
+	/** When the ledger was last read. */
+	get ledgerAtMs() {
+		return this.#ledgerAtMs;
+	}
+	/** Why the ledger could not be read, when it could not. */
+	get ledgerError() {
+		return this.#ledgerError;
+	}
 	/**
 	* Read the balance and record how much was consumed since the last read.
 	*
+	* The credit ledger is read alongside it, but a ledger that cannot be read
+	* never hides the balance: the two come from different endpoints and only
+	* the balance is essential.
+	*
 	* @returns Whether the balance changed.
 	*/
 	async refresh(credential, region, fetchImpl = fetch, now = Date.now()) {
+		let changed = false;
 		try {
 			const summary = await fetchCreditSummary(credential, region, fetchImpl);
-			if (summary === void 0) {
-				this.#error = "membership response carried no credit summary";
-				return false;
+			if (summary === void 0) this.#error = "membership response carried no credit summary";
+			else {
+				const previous = this.#snapshot;
+				this.#snapshot = {
+					summary,
+					fetchedAtMs: now,
+					consumed: previous === void 0 ? 0 : previous.summary.total - summary.total
+				};
+				this.#error = void 0;
+				changed = previous === void 0 || previous.summary.total !== summary.total;
 			}
-			const previous = this.#snapshot;
-			this.#snapshot = {
-				summary,
-				fetchedAtMs: now,
-				consumed: previous === void 0 ? 0 : previous.summary.total - summary.total
-			};
-			this.#error = void 0;
-			return previous === void 0 || previous.summary.total !== summary.total;
 		} catch (error) {
 			this.#error = error instanceof Error ? error.message : String(error);
-			return false;
+		}
+		await this.refreshLedger(credential, region, fetchImpl, now);
+		return changed;
+	}
+	/**
+	* Read the credit ledger and work out what is about to expire.
+	*
+	* A failure here is remembered but never thrown: the balance is what the
+	* user needs most, and a ledger that is temporarily unavailable must not
+	* take it down with it.
+	*/
+	async refreshLedger(credential, region, fetchImpl = fetch, now = Date.now()) {
+		try {
+			const lots = await fetchCreditLots(credential, region, fetchImpl);
+			this.#lots = lots;
+			this.#expiry = summarizeExpiry(lots, now);
+			this.#ledgerAtMs = now;
+			this.#ledgerError = void 0;
+		} catch (error) {
+			this.#ledgerError = error instanceof Error ? error.message : String(error);
 		}
 	}
 };
@@ -1206,6 +1329,7 @@ function apply(ctx) {
 	/** The credit balance as the card and the browser half read it. */
 	const buildCreditStatus = () => {
 		const snapshot = credits.snapshot;
+		const expiry = credits.expiry;
 		if (snapshot === void 0) return {
 			state: creditState,
 			...credits.error === void 0 ? {} : { error: credits.error }
@@ -1216,7 +1340,16 @@ function apply(ctx) {
 			purchased: snapshot.summary.purchased,
 			free: snapshot.summary.free,
 			consumed: snapshot.consumed,
-			updatedAtMs: snapshot.fetchedAtMs
+			updatedAtMs: snapshot.fetchedAtMs,
+			...expiry === void 0 ? {} : {
+				expiring: expiry.expiring,
+				expiringLots: expiry.expiringLots,
+				expiringSoon: expiry.expiringSoon,
+				nextExpiryAtMs: expiry.nextExpiryAtMs,
+				upcoming: expiry.upcoming
+			},
+			...credits.ledgerAtMs === void 0 ? {} : { ledgerAtMs: credits.ledgerAtMs },
+			...credits.ledgerError === void 0 ? {} : { ledgerError: credits.ledgerError }
 		};
 	};
 	/** What this host's own requests have used. */

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-connect-minimaxcode",
   "displayName": "DSH Connect MiniMax Code",
-  "description": "把本机已登录的 MiniMax Code 桌面 App 的模型接入 DeepSeek Harness：复用其登录态，提供 Anthropic Messages 兼容接入与动态模型目录。",
-  "version": "0.3.0",
+  "description": "把本机已登录的 MiniMax Code 桌面 App 的模型接入 DeepSeek Harness：复用其登录态，提供 Anthropic Messages 兼容接入、动态模型目录与积分余额/到期提示。",
+  "version": "0.4.0",
   "author": "JeffTsuiCUG",
   "license": "MIT",
   "private": false,
@@ -84,6 +84,7 @@
       "inject": [
         "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-plugin-manager",
         "@deepseek-ai/dsh-client-locale"
       ]
     }