dsh-connect-minimaxcode 0.6.3 → 0.6.5

package/README.en.md

@@ -384,6 +384,18 @@ The OAuth token is valid for about an hour and is refreshed automatically by the
 
 ## Changelog
 
+### 0.6.5 (2026-11-12)
+
+- **Fixed "the limit windows never showed up"**: once a plan is held, the upstream changed the quota endpoint's **field names and its meaning** — from the share *used* (the string `"19%"`) to the share *remaining* (the number `90`). The plugin still read the old names, so the windows either could not be read at all or read as the opposite. Both shapes are accepted now, and what leaves the plugin is always the share *used*: 92% remaining is 8% used. The window length is still derived from the answer's own edges (measured: five hours and seven days) rather than assumed.
+- **Added the plan to the card**: the membership answer now names the tier and the day it ends (`token_plan_tier`, `token_plan_expires_at`), and the plugin shows one more line in the pill detail and on the plugin page — "Go · until 2026-12-11". It comes from the same answer as the balance, so it costs no extra request.
+- **An account without a plan sees exactly what it saw before**: the plan fields are simply absent there, so the plugin shows nothing about a plan; the windows are still absent, and the card still says "No M Plan subscription (credits only), so there are no usage windows". The new `tests/free-account.spec.ts` pins that whole path for a free account (balance, plan, windows), and `tests/plan.spec.ts` covers the new field shape, the old one and the free account.
+
+### 0.6.4 (2026-11-11)
+
+- **Fixed "the self-check report never appeared"**: the previous version put the self-check in the client half (the card reports what the host offered), but **the server half was never landed** — the status document had no field to carry the report and no route to receive it, so the card reported into nowhere. It is complete now: the report is received by the plugin's own route and appears in the status document as `capability`.
+- The episode also exposed a process problem: a few anchors in the patch script missed, and its output was covered by another script in the same command, so a partial application was read as a complete one. **Every patch is now checked individually**, and an end-to-end check was added: the report counts as working only once it has travelled from the card through the route and back into the status document.
+- The route-count cases were brought up to date (the host now mounts four routes: status, action, capability, generation).
+
 ### 0.6.3 (2026-11-11)
 
 - **"Could not send it to the conversation" now names the missing piece**: delivering a picture needs several pieces of the host — the session identifier, the sessions service, the session binding, a way to send or to hold a draft, and the input box's attachment channel — and they arrive in different ways. There used to be one blanket failure message; each absence now has its own: the host named no session / offers no sessions service / this session is not reachable / it cannot send / it cannot hold drafts / the input box takes no attachments.

package/README.md

@@ -395,6 +395,18 @@ OAuth 令牌有效期约 1 小时，由客户端自动续期。插件**只在自
 
 ## 更新记录
 
+### 0.6.5（2026-11-12）
+
+- **修复「限额窗口一直显示不出来」**：上游在有了套餐之后改了额度接口的**字段名和语义** —— 从「已用百分比」（字符串 `"19%"`）改成「**剩余**百分比」（数字 `90`）。插件仍按旧字段名读，于是窗口读不到，或者读成相反的意思。现在两种形态都认，且对外一律是「已用百分比」：读到剩余 92% 就是已用 8%。窗口长度仍从响应自身的起止时刻推导（实测 5 小时与 7 天），不写死。
+- **新增套餐显示**：会员接口现在会报出档位与到期日（`token_plan_tier`、`token_plan_expires_at`），插件在胶囊详情与插件页多显示一行，例如「Go · 2026-12-11 到期」。这与余额读的是同一个响应，不额外发请求。
+- **免费用户看到的完全不变**：没有套餐的账户，套餐字段根本不存在，插件也就不显示任何套餐信息；窗口依然读不到，卡片上那句「未订阅 M Plan（仅积分包），因此没有限额窗口」照旧。新增 `tests/free-account.spec.ts` 把免费账户的整条路径钉住（余额、套餐、窗口三样），另加 `tests/plan.spec.ts` 覆盖新字段形态、旧字段形态与免费账户三种情况。
+
+### 0.6.4（2026-11-11）
+
+- **修复「自检报告从未出现」**：上一版把自检能力加在了客户端（卡片上报宿主提供了什么），但**服务端那一半没有落地** —— 状态文档里没有承载报告的字段，也没有接收报告的路由，于是卡片上报到哪里都无人接收。现已补齐：报告由插件自己的路由接收，并出现在状态文档的 `capability` 里。
+- 这次同时暴露了一个流程问题：补丁脚本里有几处锚点未命中，而脚本的输出被同一条命令里的另一个脚本盖住了，于是「部分应用」被当成了「全部应用」。**现在每一处补丁的成败都单独核对**，并且加了端到端验证：报告从卡片出发、经路由回到状态文档，全程贯通才算通过。
+- 顺带补上路由数量的用例（宿主侧现在有四条路由：状态、动作、自检、生成）。
+
 ### 0.6.3（2026-11-11）
 
 - **「无法发送到对话」现在会说明缺哪一步**：把图片送进对话需要宿主的好几块能力（会话标识、会话服务、会话绑定、发送或草稿通道、输入框的附件通道），它们分别以不同方式交到插件手上。原先只有一句笼统的失败提示，现在每种缺失都有各自的话：宿主没给会话标识 / 没有会话服务 / 当前会话不可达 / 会话不支持发送 / 不支持草稿 / 输入框不接受附件。

package/lib/client.js

@@ -77,6 +77,8 @@
         usageRanking: '用量排名前 {percent}%',
         usageBestDay: '最活跃的一天 {date}',
         planNoSubscription: '未订阅 M Plan（仅积分包），因此没有限额窗口',
+        planGeneric: 'M Plan 订阅',
+        planExpires: '{date} 到期',
         generateTitle: '生成',
         generateImage: '图片',
         generateVideo: '视频',
@@ -155,6 +157,8 @@
         usageRanking: 'Top {percent}% by usage',
         usageBestDay: 'Busiest day {date}',
         planNoSubscription: 'No M Plan subscription (credits only), so there are no usage windows',
+        planGeneric: 'M Plan subscription',
+        planExpires: 'until {date}',
         generateTitle: 'Generate',
         generateImage: 'Image',
         generateVideo: 'Video',
@@ -383,6 +387,23 @@
                     return null;
                 return h('div', { style: mutedStyle, 'data-minimax-plan-notice': true }, t('planNoSubscription'));
             }
+            /**
+             * The plan the account holds, when it holds one.
+             *
+             * An account without a plan has nothing to say here, and the card shows
+             * it nothing: the rolling windows it does not have are already
+             * explained by the notice beside them. What this adds is for the
+             * accounts that do hold one — the tier's name and the day it ends.
+             */
+            function planLine(t, plan) {
+                if (plan === undefined || !plan.active)
+                    return null;
+                const tier = plan.tier ?? t('planGeneric');
+                const expiry = plan.expiresAtMs === undefined
+                    ? null
+                    : t('planExpires', { date: day(plan.expiresAtMs) });
+                return h('div', { style: rowStyle, 'data-minimax-plan': true }, h('span', null, tier), h('span', null, expiry ?? ''));
+            }
             /** The pill itself; the gate decides whether it is drawn at all. */
             function CreditPill(props) {
                 const [status] = useStatus();
@@ -415,7 +436,7 @@
                 const detail = available
                     ? 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_), rateLimitBlock(t, status?.rateLimit), planNotice(t, status?.rateLimit), usageProfileBlock(t, status?.usageProfile), usage !== undefined
+                        : null, expiryBlock(t, credits_), rateLimitBlock(t, status?.rateLimit), planNotice(t, status?.rateLimit), planLine(t, status?.plan), usageProfileBlock(t, status?.usageProfile), 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
                         ? row(t('updated', { time: new Date(credits_.updatedAtMs).toLocaleTimeString() }), '')
@@ -913,7 +934,7 @@
                     // usable even when the balance cannot be read.
                     h(GenerationPanel, props));
                 }
-                return h('div', { style: pageStyle, 'data-minimax-page': true }, 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_), rateLimitBlock(t, status?.rateLimit), planNotice(t, status?.rateLimit), signinBlock(t, signin, refresh), h('div', { style: sectionTitleStyle }, t('lots')), (credits_.upcoming ?? []).length === 0
+                return h('div', { style: pageStyle, 'data-minimax-page': true }, 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_), rateLimitBlock(t, status?.rateLimit), planNotice(t, status?.rateLimit), planLine(t, status?.plan), signinBlock(t, signin, refresh), 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)

package/lib/index.d.ts

@@ -320,6 +320,32 @@ interface CreditSummary {
   /** Remaining free (granted) credits. */
   free: number;
 }
+/**
+ * The plan the account subscribes to.
+ *
+ * An account without one still reads a balance — it simply has no rolling
+ * windows, which is what the limit readout used to report as missing. With a
+ * plan the upstream names the tier and the day it ends, and both are worth
+ * showing: the tier says what the account has, the day says how long it has.
+ */
+interface PlanSummary {
+  /** The tier's name, as the upstream spells it ("Go"). */
+  tier?: string;
+  /** When the plan ends, in milliseconds since the epoch. */
+  expiresAtMs?: number;
+  /** Whether the upstream reports an active plan at all. */
+  active: boolean;
+}
+/**
+ * Read the plan out of a membership response.
+ *
+ * The upstream only fills these in for an account that subscribes: without a
+ * plan `has_token_plan` is false and the tier is absent. `subscription_type`
+ * says so too — "mplan" once a plan is held, "none" before.
+ *
+ * @returns The plan, or `undefined` when the response carries no plan fields.
+ */
+declare function parsePlanSummary(document: unknown): PlanSummary | undefined;
 /**
  * Read the credit summary out of a membership response.
  *
@@ -327,6 +353,14 @@ interface CreditSummary {
  * balance fields, so the same fallback chain is used here.
  */
 declare function parseCreditSummary(document: unknown): CreditSummary | undefined;
+/**
+ * Fetch the membership document.
+ *
+ * One answer carries several things: the credit balance, the plan the
+ * account subscribes to, and when that plan ends. They are read together so
+ * that the account is asked once.
+ */
+declare function fetchMembershipDocument(credential: OAuthCredential, region: MinimaxRegion, fetchImpl?: typeof fetch): Promise<Record<string, unknown> | undefined>;
 /**
  * Fetch the current credit balance.
  *
@@ -387,19 +421,24 @@ interface RateLimitWindows {
   weekly: UsageWindow;
 }
 /**
- * Read the two rate-limit windows out of a remains-percent response.
+ * Read the two rate-limit windows out of a remains response.
  *
  * The upstream answers with one entry per metered group; the general one is
  * the only one the plan meters today, and the first entry is used when it is
- * absent. The percents arrive as strings ("19%"), and the counts arrive as -1
- * when the plan does not meter by count, so only the percents and the window
- * edges are read. The window length is derived from the entry's own endpoints
- * rather than assumed to be five hours or seven days — the plan's terms have
+ * absent. The window length is derived from the entry's own endpoints rather
+ * than assumed to be five hours or seven days — the plan's terms have
  * changed before, and the display should follow whatever the server says.
  *
  * A window the server marks as unlimited (`current_*_status` of 3) carries no
  * allowance to be a percentage of, so it produces no window at all: reporting
  * "0%" of an unlimited quota would be a number nobody can act on.
+ *
+ * **Which share the upstream reports changed.** It used to answer with the
+ * share already used, as a string ("19%"); with a plan subscribed it answers
+ * with the share still *remaining*, as a plain number (90). Both are
+ * accepted, and the two are opposites, so what leaves this function is
+ * always the share used — otherwise the same window would read 90% used on
+ * a plan that has barely spent anything.
  */
 declare function parseRateLimitWindows(document: unknown): RateLimitWindows | undefined;
 /**
@@ -493,6 +532,8 @@ declare class MinimaxCredits {
   get rateLimit(): RateLimitWindows | undefined;
   /** Why the windows could not be read, when they could not. */
   get rateLimitError(): string | undefined;
+  /** The plan the account subscribes to, as the last read found it. */
+  get plan(): PlanSummary | undefined;
   /** Why the plan has no windows, when the upstream said so plainly. */
   get rateLimitAbsence(): 'no-subscription' | undefined;
   /** When the windows were last read. */
@@ -985,6 +1026,15 @@ interface UsageStatus {
   /** How many requests were measured. */
   requests: number;
 }
+/** The plan the account subscribes to, as the card reads it. */
+interface PlanStatus {
+  /** Whether the account holds a plan. */
+  active: boolean;
+  /** The tier's name, as the upstream spells it ("Go"). */
+  tier?: string;
+  /** When the plan ends, in milliseconds since the epoch. */
+  expiresAtMs?: number;
+}
 /** The plan's two rolling usage windows, as the card reads them. */
 interface RateLimitStatus {
   /** Whether the windows could be read. */
@@ -1085,8 +1135,17 @@ interface StatusDocument {
   login?: LoginStatus;
   /** The account's usage profile, when it could be read. */
   usageProfile?: UsageProfileStatus;
+  /** The plan the account subscribes to, when there is one. */
+  plan?: PlanStatus;
   /** The choices the generation endpoints offer. */
   generation?: GenerationOptions;
+  /** What the host offered the card the last time it looked. */
+  capability?: {
+    /** When the card reported it. */
+    at: number;
+    /** One entry per piece the card looked for. */
+    findings: Record<string, string>;
+  };
 }
 /** Inputs the document is derived from. */
 interface StatusDeps {
@@ -1117,8 +1176,17 @@ interface StatusDeps {
   login?: LoginStatus;
   /** The account's usage profile, when the account API could be reached. */
   usageProfile?: UsageProfileStatus;
+  /** The plan the account subscribes to, when there is one. */
+  plan?: PlanStatus;
   /** The choices the generation endpoints offer. */
   generation?: GenerationOptions;
+  /** What the host offered the card the last time it looked. */
+  capability?: {
+    /** When the card reported it. */
+    at: number;
+    /** One entry per piece the card looked for. */
+    findings: Record<string, string>;
+  };
 }
 /**
  * Build the card's status document.
@@ -1201,4 +1269,4 @@ declare const inject: string[];
  */
 declare function apply(ctx: Context): void;
 //#endregion
-export { type AuthState, type CatalogModel, type CatalogSource, type Credential, type CreditSummary, DEVICE_CODE_GRANT, DEVICE_CODE_PATH, type DeviceLoginState, EMPTY_USAGE, FALLBACK_MODELS, MEMBERSHIP_PATH, MINIMAXCODE_PROVIDER_ID, MINIMAX_ACTION_PATH, MINIMAX_AUTH_FILENAME, MINIMAX_DATA_DIR, MINIMAX_GATEWAYS, MINIMAX_OAUTH_CLIENT_ID, MINIMAX_REGIONS, MINIMAX_STATUS_PATH, MINIMAX_STREAM_IDLE_TIMEOUT_MS, MODEL_PRICES, MinimaxCatalog, MinimaxCredits, type MinimaxRegion, type ModelUsage, type OAuthCredential, type OAuthState, PLUGIN_CREDENTIAL_FILENAME, PLUGIN_STATE_FILENAME, type PluginCredential, type PluginState, REMAINS_PERCENT_PATH, type RateLimitWindows, SIGNIN_CLAIM_PATH, SIGNIN_CLAIM_RESULT, SIGNIN_CYCLE_DAYS, SIGNIN_DAY_STATUS, SIGNIN_PANEL_PATH, type SigninClaim, type SigninDay, type SigninPanel, type StatusDocument, type TokenClaims, UsageMeter, apply, authPath, bearerToken, catalogUrl, chatBaseUrl, claimSignin, createMinimaxCodeAdapter, dataDir, daysRemaining, decodeClaims, deletePluginCredential, dshHome, ensureOAuthCredential, estimateCny, expiresInMs, expiryLevel, fetchCreditSummary, fetchRateLimitWindows, fetchSigninPanel, inject, localDay, makePkce, name, parseAuthDocument, parseCatalog, parseCreditSummary, parseOAuthDocument, parseRateLimitWindows, parseSigninClaim, parseSigninPanel, pluginCredentialPath, pluginStatePath, pollDeviceLogin, priceFor, readCredential, readOAuthCredential, readPluginCredential, readPluginState, refreshOAuthCredential, refreshPluginCredential, startDeviceLogin, statusDocument, timezoneId, writeOAuthCredential, writePluginCredential, writePluginState };
+export { type AuthState, type CatalogModel, type CatalogSource, type Credential, type CreditSummary, DEVICE_CODE_GRANT, DEVICE_CODE_PATH, type DeviceLoginState, EMPTY_USAGE, FALLBACK_MODELS, MEMBERSHIP_PATH, MINIMAXCODE_PROVIDER_ID, MINIMAX_ACTION_PATH, MINIMAX_AUTH_FILENAME, MINIMAX_DATA_DIR, MINIMAX_GATEWAYS, MINIMAX_OAUTH_CLIENT_ID, MINIMAX_REGIONS, MINIMAX_STATUS_PATH, MINIMAX_STREAM_IDLE_TIMEOUT_MS, MODEL_PRICES, MinimaxCatalog, MinimaxCredits, type MinimaxRegion, type ModelUsage, type OAuthCredential, type OAuthState, PLUGIN_CREDENTIAL_FILENAME, PLUGIN_STATE_FILENAME, type PlanSummary, type PluginCredential, type PluginState, REMAINS_PERCENT_PATH, type RateLimitWindows, SIGNIN_CLAIM_PATH, SIGNIN_CLAIM_RESULT, SIGNIN_CYCLE_DAYS, SIGNIN_DAY_STATUS, SIGNIN_PANEL_PATH, type SigninClaim, type SigninDay, type SigninPanel, type StatusDocument, type TokenClaims, UsageMeter, apply, authPath, bearerToken, catalogUrl, chatBaseUrl, claimSignin, createMinimaxCodeAdapter, dataDir, daysRemaining, decodeClaims, deletePluginCredential, dshHome, ensureOAuthCredential, estimateCny, expiresInMs, expiryLevel, fetchCreditSummary, fetchMembershipDocument, fetchRateLimitWindows, fetchSigninPanel, inject, localDay, makePkce, name, parseAuthDocument, parseCatalog, parseCreditSummary, parseOAuthDocument, parsePlanSummary, parseRateLimitWindows, parseSigninClaim, parseSigninPanel, pluginCredentialPath, pluginStatePath, pollDeviceLogin, priceFor, readCredential, readOAuthCredential, readPluginCredential, readPluginState, refreshOAuthCredential, refreshPluginCredential, startDeviceLogin, statusDocument, timezoneId, writeOAuthCredential, writePluginCredential, writePluginState };

package/lib/index.js

@@ -746,6 +746,16 @@ const MINIMAX_ACTION_PATH = "/plugins/dsh-connect-minimaxcode/action";
 * takes a minute and a half and is polled.
 */
 const MINIMAX_GENERATE_PATH = "/plugins/dsh-connect-minimaxcode/generate";
+/**
+* Route the card reports what the host offers it on.
+*
+* Delivering a generated picture into a conversation needs several pieces of
+* the host — the session, its face, the input box's attachment channel — and
+* they are handed over in different ways. Reporting what is actually there
+* turns "it did not work" into "this piece is missing", which is the only
+* useful answer when something like that goes wrong.
+*/
+const MINIMAX_CAPABILITY_PATH = "/plugins/dsh-connect-minimaxcode/capability";
 const HINTS = {
 	"app-missing": "未找到 MiniMax Code 的登录信息。请先安装并登录 MiniMax Code 桌面 App，然后重启 DSH。",
 	"not-signed-in": "MiniMax Code 尚未登录。请在 MiniMax Code 桌面 App 中登录后重启 DSH。",
@@ -776,6 +786,8 @@ function statusDocument(deps) {
 		...deps.signin === void 0 ? {} : { signin: deps.signin },
 		...deps.login === void 0 ? {} : { login: deps.login },
 		...deps.usageProfile === void 0 ? {} : { usageProfile: deps.usageProfile },
+		...deps.plan === void 0 ? {} : { plan: deps.plan },
+		...deps.capability === void 0 ? {} : { capability: deps.capability },
 		...deps.generation === void 0 ? {} : { generation: deps.generation }
 	};
 	if (auth.state === "expired") return {
@@ -1363,6 +1375,29 @@ async function ensureOAuthCredential(region, env = process.env, now = Date.now()
 	}
 }
 /**
+* Read the plan out of a membership response.
+*
+* The upstream only fills these in for an account that subscribes: without a
+* plan `has_token_plan` is false and the tier is absent. `subscription_type`
+* says so too — "mplan" once a plan is held, "none" before.
+*
+* @returns The plan, or `undefined` when the response carries no plan fields.
+*/
+function parsePlanSummary(document) {
+	if (typeof document !== "object" || document === null) return void 0;
+	const record = document;
+	const hasTokenPlan = record.has_token_plan;
+	const tier = typeof record.token_plan_tier === "string" && record.token_plan_tier.length > 0 ? record.token_plan_tier : void 0;
+	const expires = toNumber$1(record.token_plan_expires_at);
+	const expiresAtMs = expires === void 0 || expires <= 0 ? void 0 : expires;
+	if (hasTokenPlan !== true && tier === void 0 && expiresAtMs === void 0) return void 0;
+	return {
+		tier,
+		expiresAtMs,
+		active: hasTokenPlan === true || tier !== void 0
+	};
+}
+/**
 * Read the credit summary out of a membership response.
 *
 * The app's settings page prefers the summary and falls back to the flat
@@ -1400,11 +1435,13 @@ function toNumber$1(value) {
 	}
 }
 /**
-* Fetch the current credit balance.
+* Fetch the membership document.
 *
-* @returns The balance, or `undefined` when the account has no credit summary.
+* One answer carries several things: the credit balance, the plan the
+* account subscribes to, and when that plan ends. They are read together so
+* that the account is asked once.
 */
-async function fetchCreditSummary(credential, region, fetchImpl = fetch) {
+async function fetchMembershipDocument(credential, region, fetchImpl = fetch) {
 	const response = await fetchImpl(`${MINIMAX_ACCOUNT_HOSTS[region]}${MEMBERSHIP_PATH}`, {
 		method: "POST",
 		headers: {
@@ -1414,7 +1451,17 @@ async function fetchCreditSummary(credential, region, fetchImpl = fetch) {
 		body: "{}"
 	});
 	if (!response.ok) throw new Error(`membership request failed: HTTP ${response.status}`);
-	return parseCreditSummary(await response.json());
+	const document = await response.json();
+	return typeof document === "object" && document !== null ? document : void 0;
+}
+/**
+* Fetch the current credit balance.
+*
+* @returns The balance, or `undefined` when the account has no credit summary.
+*/
+async function fetchCreditSummary(credential, region, fetchImpl = fetch) {
+	const document = await fetchMembershipDocument(credential, region, fetchImpl);
+	return document === void 0 ? void 0 : parseCreditSummary(document);
 }
 /**
 * Read the credit lots out of a ledger response.
@@ -1476,19 +1523,24 @@ async function fetchCreditLots(credential, region, fetchImpl = fetch) {
 	return lots;
 }
 /**
-* Read the two rate-limit windows out of a remains-percent response.
+* Read the two rate-limit windows out of a remains response.
 *
 * The upstream answers with one entry per metered group; the general one is
 * the only one the plan meters today, and the first entry is used when it is
-* absent. The percents arrive as strings ("19%"), and the counts arrive as -1
-* when the plan does not meter by count, so only the percents and the window
-* edges are read. The window length is derived from the entry's own endpoints
-* rather than assumed to be five hours or seven days — the plan's terms have
+* absent. The window length is derived from the entry's own endpoints rather
+* than assumed to be five hours or seven days — the plan's terms have
 * changed before, and the display should follow whatever the server says.
 *
 * A window the server marks as unlimited (`current_*_status` of 3) carries no
 * allowance to be a percentage of, so it produces no window at all: reporting
 * "0%" of an unlimited quota would be a number nobody can act on.
+*
+* **Which share the upstream reports changed.** It used to answer with the
+* share already used, as a string ("19%"); with a plan subscribed it answers
+* with the share still *remaining*, as a plain number (90). Both are
+* accepted, and the two are opposites, so what leaves this function is
+* always the share used — otherwise the same window would read 90% used on
+* a plan that has barely spent anything.
 */
 function parseRateLimitWindows(document) {
 	if (typeof document !== "object" || document === null) return void 0;
@@ -1497,8 +1549,8 @@ function parseRateLimitWindows(document) {
 	const entry = remains.find((item) => typeof item === "object" && item !== null && item.model_name === "general") ?? remains[0];
 	if (typeof entry !== "object" || entry === null) return void 0;
 	const record = entry;
-	const interval = readWindow(record.current_interval_used_percent, record.start_time, record.end_time, record.current_interval_status);
-	const weekly = readWindow(record.current_weekly_used_percent, record.weekly_start_time, record.weekly_end_time, record.current_weekly_status);
+	const interval = readWindow(record.current_interval_used_percent, record.current_interval_remaining_percent, record.start_time, record.end_time, record.current_interval_status);
+	const weekly = readWindow(record.current_weekly_used_percent, record.current_weekly_remaining_percent, record.weekly_start_time, record.weekly_end_time, record.current_weekly_status);
 	if (interval === void 0 || weekly === void 0) return void 0;
 	return {
 		interval,
@@ -1511,10 +1563,25 @@ function parseRateLimitWindows(document) {
 * The desktop app reads it the same way: `isUnlimited: 3 === status`.
 */
 const UNLIMITED_STATUS = 3;
+/**
+* The share of a window's allowance already used, whichever way it is reported.
+*
+* The endpoint named the used share `current_*_used_percent` and then
+* renamed it to `current_*_remaining_percent` while inverting its meaning.
+* The used share is what a person needs, so it is what this returns; the
+* remaining share is subtracted from a hundred to get there.
+*/
+function readUsedPercent(used, remaining) {
+	const usedPercent = parsePercent(used);
+	if (usedPercent !== void 0) return usedPercent;
+	const remainingPercent = parsePercent(remaining);
+	if (remainingPercent === void 0) return void 0;
+	return 100 - remainingPercent;
+}
 /** Assemble one window from its percent and edge fields; all must be present. */
-function readWindow(percent, startAtMs, resetAtMs, status) {
+function readWindow(percent, remainingPercent, startAtMs, resetAtMs, status) {
 	if (status === UNLIMITED_STATUS) return void 0;
-	const usedPercent = parsePercent(percent);
+	const usedPercent = readUsedPercent(percent, remainingPercent);
 	const start = toNumber$1(startAtMs);
 	const reset = toNumber$1(resetAtMs);
 	if (usedPercent === void 0 || start === void 0 || reset === void 0) return void 0;
@@ -1707,6 +1774,7 @@ var MinimaxCredits = class {
 	#ledgerError;
 	#rateLimit;
 	#rateLimitError;
+	#plan;
 	#rateLimitAbsence;
 	#rateLimitAtMs;
 	#usageProfile;
@@ -1744,6 +1812,10 @@ var MinimaxCredits = class {
 	get rateLimitError() {
 		return this.#rateLimitError;
 	}
+	/** The plan the account subscribes to, as the last read found it. */
+	get plan() {
+		return this.#plan;
+	}
 	/** Why the plan has no windows, when the upstream said so plainly. */
 	get rateLimitAbsence() {
 		return this.#rateLimitAbsence;
@@ -1774,7 +1846,9 @@ var MinimaxCredits = class {
 	async refresh(credential, region, fetchImpl = fetch, now = Date.now()) {
 		let changed = false;
 		try {
-			const summary = await fetchCreditSummary(credential, region, fetchImpl);
+			const document = await fetchMembershipDocument(credential, region, fetchImpl);
+			if (document !== void 0) this.#plan = parsePlanSummary(document);
+			const summary = document === void 0 ? void 0 : parseCreditSummary(document);
 			if (summary === void 0) this.#error = "membership response carried no credit summary";
 			else {
 				const previous = this.#snapshot;
@@ -2646,6 +2720,8 @@ function apply(ctx) {
 	let loginPending = false;
 	/** Whether the server refused the plugin's own credential. */
 	let revokedByServer = false;
+	/** What the card last reported about what the host offered it. */
+	let capability;
 	/**
 	* Give up on the plugin's own credential after the server refused it.
 	*
@@ -2943,6 +3019,20 @@ function apply(ctx) {
 			updatedAt: profile.lastUpdateTime
 		};
 	};
+	/**
+	* The plan the account holds, as the card reads it.
+	*
+	* It comes from the same membership answer as the balance, so it is free.
+	*/
+	const buildPlanStatus = () => {
+		const held = credits.plan;
+		if (held === void 0) return void 0;
+		return {
+			active: held.active,
+			tier: held.tier,
+			expiresAtMs: held.expiresAtMs
+		};
+	};
 	/** The plan's rolling usage windows as the card reads them. */
 	const buildRateLimitStatus = () => {
 		if (creditState === "signed-out" || creditState === "expired") return { state: creditState };
@@ -3092,6 +3182,8 @@ function apply(ctx) {
 			signin: buildSigninStatus(),
 			login: buildLoginStatus(),
 			usageProfile: buildUsageProfileStatus(),
+			plan: buildPlanStatus(),
+			capability,
 			generation: {
 				imageModels: [...IMAGE_MODELS],
 				imageAspectRatios: [...IMAGE_ASPECT_RATIOS],
@@ -3407,6 +3499,36 @@ function apply(ctx) {
 				}
 			}
 		}));
+		webCtx.effect(() => webCtx.webServer.register({
+			kind: "exact",
+			path: MINIMAX_CAPABILITY_PATH,
+			handler: async (req, res) => {
+				if (!isLoopback(req.headers.host)) {
+					res.writeHead(403, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "loopback only" }));
+					return;
+				}
+				try {
+					const raw = new URL(req.url ?? "/", "http://127.0.0.1").searchParams.get("report") ?? "";
+					let findings = {};
+					try {
+						const parsed = JSON.parse(raw);
+						if (typeof parsed === "object" && parsed !== null) for (const [key, value] of Object.entries(parsed)) findings[key] = String(value);
+					} catch {
+						findings = { report: "unreadable" };
+					}
+					capability = {
+						at: Date.now(),
+						findings
+					};
+					res.writeHead(204);
+					res.end();
+				} catch (error) {
+					res.writeHead(500, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: error instanceof Error ? error.message : String(error) }));
+				}
+			}
+		}));
 		webCtx.effect(() => webCtx.webServer.register({
 			kind: "exact",
 			path: MINIMAX_GENERATE_PATH,
@@ -3470,4 +3592,4 @@ async function readRequestBody(req) {
 	return text;
 }
 //#endregion
-export { DEVICE_CODE_GRANT, DEVICE_CODE_PATH, EMPTY_USAGE, FALLBACK_MODELS, MEMBERSHIP_PATH, MINIMAXCODE_PROVIDER_ID, MINIMAX_ACTION_PATH, MINIMAX_AUTH_FILENAME, MINIMAX_DATA_DIR, MINIMAX_GATEWAYS, MINIMAX_OAUTH_CLIENT_ID, MINIMAX_REGIONS, MINIMAX_STATUS_PATH, MINIMAX_STREAM_IDLE_TIMEOUT_MS, MODEL_PRICES, MinimaxCatalog, MinimaxCredits, PLUGIN_CREDENTIAL_FILENAME, PLUGIN_STATE_FILENAME, REMAINS_PERCENT_PATH, SIGNIN_CLAIM_PATH, SIGNIN_CLAIM_RESULT, SIGNIN_CYCLE_DAYS, SIGNIN_DAY_STATUS, SIGNIN_PANEL_PATH, UsageMeter, apply, authPath, bearerToken, catalogUrl, chatBaseUrl, claimSignin, createMinimaxCodeAdapter, dataDir, daysRemaining, decodeClaims, deletePluginCredential, dshHome, ensureOAuthCredential, estimateCny, expiresInMs, expiryLevel, fetchCreditSummary, fetchRateLimitWindows, fetchSigninPanel, inject, localDay, makePkce, name, parseAuthDocument, parseCatalog, parseCreditSummary, parseOAuthDocument, parseRateLimitWindows, parseSigninClaim, parseSigninPanel, pluginCredentialPath, pluginStatePath, pollDeviceLogin, priceFor, readCredential, readOAuthCredential, readPluginCredential, readPluginState, refreshOAuthCredential, refreshPluginCredential, startDeviceLogin, statusDocument, timezoneId, writeOAuthCredential, writePluginCredential, writePluginState };
+export { DEVICE_CODE_GRANT, DEVICE_CODE_PATH, EMPTY_USAGE, FALLBACK_MODELS, MEMBERSHIP_PATH, MINIMAXCODE_PROVIDER_ID, MINIMAX_ACTION_PATH, MINIMAX_AUTH_FILENAME, MINIMAX_DATA_DIR, MINIMAX_GATEWAYS, MINIMAX_OAUTH_CLIENT_ID, MINIMAX_REGIONS, MINIMAX_STATUS_PATH, MINIMAX_STREAM_IDLE_TIMEOUT_MS, MODEL_PRICES, MinimaxCatalog, MinimaxCredits, PLUGIN_CREDENTIAL_FILENAME, PLUGIN_STATE_FILENAME, REMAINS_PERCENT_PATH, SIGNIN_CLAIM_PATH, SIGNIN_CLAIM_RESULT, SIGNIN_CYCLE_DAYS, SIGNIN_DAY_STATUS, SIGNIN_PANEL_PATH, UsageMeter, apply, authPath, bearerToken, catalogUrl, chatBaseUrl, claimSignin, createMinimaxCodeAdapter, dataDir, daysRemaining, decodeClaims, deletePluginCredential, dshHome, ensureOAuthCredential, estimateCny, expiresInMs, expiryLevel, fetchCreditSummary, fetchMembershipDocument, fetchRateLimitWindows, fetchSigninPanel, inject, localDay, makePkce, name, parseAuthDocument, parseCatalog, parseCreditSummary, parseOAuthDocument, parsePlanSummary, parseRateLimitWindows, parseSigninClaim, parseSigninPanel, pluginCredentialPath, pluginStatePath, pollDeviceLogin, priceFor, readCredential, readOAuthCredential, readPluginCredential, readPluginState, refreshOAuthCredential, refreshPluginCredential, startDeviceLogin, statusDocument, timezoneId, writeOAuthCredential, writePluginCredential, writePluginState };

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-connect-minimaxcode",
   "displayName": "DSH Connect MiniMax Code",
   "description": "把本机已登录的 MiniMax Code 桌面 App 模型接入 DeepSeek Harness：零配置、Anthropic Messages 兼容、动态模型目录，并显示积分余额与到期 — bring MiniMax Code desktop app models into DSH with a dynamic model catalog and a credit balance with expiry details.",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "author": "JeffTsuiCUG",
   "contributors": [
     {