dsh-qoder-connect 0.2.4 → 0.2.5

package/README.en.md

@@ -19,7 +19,7 @@ Configure only what you use: a variant with no saved PAT shows no model group an
 - **One-toggle context window** — each variant card's *Context window* tab lists every model's capacity (the default and the largest declared window) and carries its own *“Use the largest declared context window”* preference (on by default): on, requests declare the maximum (e.g. Qwen3.8-Max at 1M); off, the default (200K). The two variants keep independent toggle state.
 - **Model visibility toggles & batch controls** — each variant card provides a dedicated *Model Toggles* tab (between *Context window* and *Credit details*) to freely enable or hide individual models; disabled models are hidden from the DSH model picker, keeping it tidy; includes instant search by name/ID and one-click *Enable all* / *Disable all* batch operations.
 - **Daily auto check-in & logs** — claims the daily 100 Credits automatically, **at a time you can set per variant on the card** (10:00 UTC+8 by default, the upstream's reset moment), with independent toggles and startup catch-up protection. The card features a dedicated *Check-in log* panel with audit trails, *Check in now*, *Refresh*, and *Clear logs* quick actions.
-- **Sidebar quota card + credit details** — the *“Qoder sidebar display”* card toggles a per-variant sidebar quota widget (off by default; each toggle needs its variant's PAT saved) with one shared refresh interval (default 5 min, minimum 1 min). Clicking the sidebar widget opens the *Qoder quota* panel: one row per credit package — *“Remaining / Total + bar | Expires”* — plus the cycle share and reset time. Click the same widget again to close; click the other to switch variants.
+- **Sidebar quota card + credit details** — the *“Qoder sidebar display”* card toggles a per-variant sidebar quota widget (off by default; each toggle needs its variant's PAT saved) with one shared refresh interval (default 5 min, minimum 1 min). Clicking the sidebar widget opens the *Qoder quota* panel: one row per credit package — *“Remaining / Total + bar | Expires”* — where a campaign grant (the international edition’s *SOTA Exclusive Credits*, for one) keeps its own upstream-given title and **its own expiry**. When the account reports no overall deadline (the upstream’s year-9999 sentinel), the panel states when the PAT was authorized rather than a fabricated date. Click the same widget again to close; click the other to switch variants.
 - **Rate display `x<priceFactor>`** — each model name is suffixed with the upstream-reported price multiplier (e.g. `Some Model · x0.79`, free is `x0`), spelled `x<n>` from the catalog's `price_factor`. Display only — it never changes the request; models whose rate the upstream did not report simply show no suffix.
 
 ## Screenshots

package/README.md

@@ -19,7 +19,7 @@
 - **上下文窗口一键切换**：两张变体卡片的「上下文窗口」页列出每个模型的容量（默认值与上游声明的最大值），并各自提供「使用上游声明的最大上下文窗口」开关（默认勾选）：勾选按最大窗口（如 Qwen3.8-Max 的 1M）发请求，不勾选按默认窗口（200K），两版开关状态独立保存、互不影响。
 - **模型自由开关与批量管理**：两张变体卡片均提供「模型开关」页（位于上下文窗口与额度明细之间），可自由开启或关闭指定模型；关闭的模型将自动从 DeepSeek Harness 的模型选择器中隐藏，避免误选与列表冗长；顶部提供按名称/ID的即时搜索框，并支持全选与一键「批量开启」/「批量关闭」。
 - **每日自动签到与日志明细**：支持每天自动签到领取 100 Credits 算力额度，**签到时刻可在卡片上自定义**（默认 10:00，即上游刷新时间，按 UTC+8），配备双端开关与开机防漏补签机制；卡片常驻「签到日志」面板，提供执行流水记录与「立即签到」、「刷新」、「清空日志」快捷操作。
-- **侧栏额度展示 + 额度明细**：「Qoder 侧栏展示」卡片可分别为两版开启侧栏底部的额度小卡（默认关，开启前需为该变体保存 PAT），共享一个刷新间隔（默认 5 分钟，最小 1 分钟）。点侧栏小卡在中间面板打开「Qoder 额度」明细：按资源包逐行给出「剩余 / 总量 + 进度条｜到期时间」，合计占比与本轮重置时间一并展示；再点同一张卡关闭，点另一张切换到对应版本。
+- **侧栏额度展示 + 额度明细**：「Qoder 侧栏展示」卡片可分别为两版开启侧栏底部的额度小卡（默认关，开启前需为该变体保存 PAT），共享一个刷新间隔（默认 5 分钟，最小 1 分钟）。点侧栏小卡在中间面板打开「Qoder 额度」明细：按资源包逐行给出「剩余 / 总量 + 进度条｜到期时间」，活动赠送包（如国际版「SOTA 专属积分」）按上游给定的名称与**各自的到期日**单独成行；账号整体无到期（上游回 9999 占位值）时展示 PAT 的授权时间而非假日期；再点同一张卡关闭，点另一张切换到对应版本。
 - **倍率显示 `x<priceFactor>`**：模型名后直接拼上游报价的价格倍率（如 `某模型 · x0.79`，免费为 `x0`），来自目录接口的 `price_factor` 字段，仅作展示、不影响请求；上游未报倍率的模型不显示后缀，不会凭空补一个数。
 
 ## 界面一览

package/lib/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { D as QoderCatalogStore, O as qoderCatalogPath, U as qoderCredentialIdentity, V as QoderCredentialStore, b as createQoderTransport, f as QODER_CONNECT_VERSION, i as variantFor, k as FALLBACK_QODER_MODELS, l as qoderHostHeartbeatPath, m as QoderUpstreamClient, r as QODER_VARIANTS, s as isHeartbeatProcessAlive, t as CHINA_VARIANT, u as readHostHeartbeat, y as validateApiKey } from "./variants-OJKPI_c7.js";
+import { D as QoderCatalogStore, O as qoderCatalogPath, U as qoderCredentialIdentity, V as QoderCredentialStore, b as createQoderTransport, f as QODER_CONNECT_VERSION, i as variantFor, k as FALLBACK_QODER_MODELS, l as qoderHostHeartbeatPath, m as QoderUpstreamClient, r as QODER_VARIANTS, s as isHeartbeatProcessAlive, t as CHINA_VARIANT, u as readHostHeartbeat, y as validateApiKey } from "./variants-Dus_Yq3R.js";
 import { readFile } from "node:fs/promises";
 import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";

package/lib/client.js

@@ -42,6 +42,63 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/quota-merge.ts
 		/**
+		* The active UI language, kept here because the sidebar card and the dashboard
+		* label the SAME package and must not pick different words for it.
+		*
+		* The client entry mirrors `ctx.locale` into this one setter; a build or a test
+		* that never calls it leaves `zh` as the answer, which is the language the
+		* plugin's own copy and its Chinese-first users read.
+		*/
+		let activeLanguage = "zh";
+		/** Record the host's active locale; anything but `en` selects the Chinese title. */
+		function setActiveLanguage(localeId) {
+			activeLanguage = typeof localeId === "string" && localeId.toLowerCase().startsWith("en") ? "en" : "zh";
+		}
+		/**
+		* The label one credit account renders with.
+		*
+		* `packageName` is the host's single-language best guess (the upstream sends a
+		* localized title only for campaign grants). Where a title map exists, the
+		* active language wins and the other language backstops it, so an English UI
+		* says "SOTA Exclusive Credits" and a Chinese one says "SOTA 专属积分" about one
+		* package — never the campaign code the upstream `name` field carries.
+		*/
+		function accountDisplayName(account, language = activeLanguage) {
+			const titles = account.packageNameI18n;
+			if (titles === void 0) return account.packageName;
+			const other = language === "en" ? "zh" : "en";
+			return titles[language] ?? titles[other] ?? account.packageName;
+		}
+		/**
+		* Format an upstream expiry instant the way every quota surface prints dates.
+		*
+		* The card once printed the raw ISO string ("2026-10-19T02:00:00.000Z") in a
+		* date column: unreadable, and in UTC at that — the day a user's grant ends is
+		* the day on their clock, so the render is localized rather than verbatim. An
+		* unparseable value stays verbatim rather than becoming a made-up date.
+		*/
+		function formatExpiryText(value) {
+			if (value === void 0) return void 0;
+			const parsed = Date.parse(value);
+			if (Number.isNaN(parsed)) return value;
+			return new Intl.DateTimeFormat(hostLocale(), { dateStyle: "medium" }).format(new Date(parsed));
+		}
+		/**
+		* Format an instant with its time of day, in the language the cards are
+		* already using. The PAT's authorization line needs the clock time as well as
+		* the day; a package's expiry line needs only the day.
+		*/
+		function formatStampText(atMs) {
+			return new Intl.DateTimeFormat(hostLocale(), {
+				dateStyle: "medium",
+				timeStyle: "short"
+			}).format(new Date(atMs));
+		}
+		/** The BCP-47 tag the active language formats dates with. */
+		function hostLocale() {
+			return activeLanguage === "en" ? "en-US" : "zh-CN";
+		}
+		/**
 		* Group credit accounts by (packageName, packageEndTime) and sum each group.
 		*
 		* A missing figure counts as 0 (the user's ruling): a package whose total the
@@ -70,6 +127,7 @@ window.__ModuleLoader__.load({
 				if (existing === void 0) {
 					groups.set(key, {
 						packageName: account.packageName,
+						...account.packageNameI18n === void 0 ? {} : { packageNameI18n: account.packageNameI18n },
 						packageEndTime: account.packageEndTime,
 						remain: account.remain,
 						size: account.size,
@@ -288,6 +346,16 @@ window.__ModuleLoader__.load({
 		function quotaSignInState() {
 			return signInSnapshot;
 		}
+		/**
+		* Note that the label language changed and wake every subscribed surface.
+		*
+		* A package title is re-read at render, and the cards re-render on this
+		* revision — so without a bump an English-UI user who switched to Chinese kept
+		* seeing "SOTA Exclusive Credits" until the next poll.
+		*/
+		function noteQuotaLanguage() {
+			bump();
+		}
 		/** Subscribe to any flag change; returns the disposer. */
 		function onQuotaSettingsChange(listener) {
 			listeners.add(listener);
@@ -2604,19 +2672,26 @@ window.__ModuleLoader__.load({
 								style: tabPanelStyle,
 								children: [status.credits === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									style: quotaListStyle,
-									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-										style: rowStyle,
-										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
-											style: quotaTitleStyle,
-											children: t("creditsHeading")
-										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-											style: bodyStyle,
-											children: status.credits.unlimited === true ? t("creditsTotalUnlimited") : t("creditsUsed", { percent: formatPercentText(status.credits.total) })
-										})]
-									}), status.credits.cycleResetTime === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-										style: descriptionStyle,
-										children: t("cycleResetAt", { time: formatCycleReset(status.credits.cycleResetTime) })
-									})]
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											style: rowStyle,
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+												style: quotaTitleStyle,
+												children: t("creditsHeading")
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												style: bodyStyle,
+												children: status.credits.unlimited === true ? t("creditsTotalUnlimited") : t("creditsUsed", { percent: formatPercentText(status.credits.total) })
+											})]
+										}),
+										status.credits.cycleResetTime === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											style: descriptionStyle,
+											children: t("cycleResetAt", { time: formatCycleReset(status.credits.cycleResetTime) })
+										}),
+										status.credits.cycleResetTime !== void 0 || status.pat?.savedAtMs === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+											style: descriptionStyle,
+											children: t("patAuthorizedAt", { time: formatTime(status.pat.savedAtMs) })
+										})
+									]
 								}), status.creditsError === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 									style: errorStyle,
 									children: t("creditsError", { message: status.creditsError })
@@ -2658,7 +2733,7 @@ window.__ModuleLoader__.load({
 										style: quotaTitleStyle,
 										children: t("creditsDetailHeading")
 									}), status.credits.accounts.filter((account) => account.remain > 0 || account.unlimited === true).map((account, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CreditBar, {
-										label: account.packageName,
+										label: accountDisplayName(account),
 										remain: account.remain,
 										size: account.size,
 										unlimited: account.unlimited,
@@ -3279,7 +3354,7 @@ window.__ModuleLoader__.load({
 				const percent = group.unlimited ? void 0 : clampPercent(group.remain, group.size);
 				const detail = group.unlimited ? "∞" : percent === void 0 ? `${group.remain.toLocaleString()} · ?` : `${group.remain.toLocaleString()} / ${group.size.toLocaleString()}`;
 				bars.push({
-					label: group.packageName,
+					label: accountDisplayName(group),
 					detail,
 					percent: percent === void 0 ? void 0 : `${formatPercentText(percent)}%`,
 					usedPercent: usedPercentText(group.remain, group.size),
@@ -3340,7 +3415,7 @@ window.__ModuleLoader__.load({
 			return sortPackageRows(accounts).map((account) => {
 				const percent = account.unlimited === true ? void 0 : clampPercent(account.remain, account.size);
 				return {
-					name: account.packageName,
+					name: accountDisplayName(account),
 					remain: account.remain,
 					size: account.size,
 					percent,
@@ -3459,7 +3534,7 @@ window.__ModuleLoader__.load({
 						children: [
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 								className: "qdp-footLabel",
-								title: bar.packageEndTime !== void 0 ? `${t("quotaExpires")} ${bar.packageEndTime}` : t("quotaNoExpiry"),
+								title: bar.packageEndTime !== void 0 ? `${t("quotaExpires")} ${formatExpiryText(bar.packageEndTime) ?? bar.packageEndTime}` : t("quotaNoExpiry"),
 								children: [bar.label, bar.usedPercent === void 0 ? null : t("quotaPackageUsed", { percent: bar.usedPercent })]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -3506,6 +3581,7 @@ window.__ModuleLoader__.load({
 			const loading = state.loading;
 			const fetchedAt = quotaStatusFetchedAt(activeVariant);
 			const credits = status !== void 0 && "credits" in status ? status.credits : void 0;
+			const patAuthorizedAt = status !== void 0 && status.status === "signed-in" ? status.pat?.savedAtMs : void 0;
 			const rows = credits === void 0 ? [] : buildPackageRows(credits.accounts ?? []);
 			const nameKey = activeVariant === "qoder-global" ? "quotaCardGlobal" : "quotaCardCN";
 			const signedIn = status?.status === "signed-in";
@@ -3696,7 +3772,7 @@ window.__ModuleLoader__.load({
 										}),
 										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("td", {
 											className: "qdp-expiry",
-											children: row.packageEndTime ?? t("quotaNoExpiry")
+											children: (row.packageEndTime !== void 0 ? formatExpiryText(row.packageEndTime) : void 0) ?? t("quotaNoExpiry")
 										})
 									] }, `${index}\u0000${row.name}\u0000${row.packageEndTime ?? ""}`)) })]
 								}),
@@ -3705,9 +3781,13 @@ window.__ModuleLoader__.load({
 									children: [
 										t("quotaExpires"),
 										" ",
-										credits.cycleResetTime
+										formatExpiryText(credits.cycleResetTime) ?? credits.cycleResetTime
 									]
-								}) : null
+								}) : null,
+								patAuthorizedAt === void 0 || credits.cycleResetTime !== void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: "qdp-windowReset",
+									children: t("patAuthorizedAt", { time: formatStampText(patAuthorizedAt) })
+								})
 							] })]
 						})
 					]
@@ -4050,7 +4130,9 @@ window.__ModuleLoader__.load({
 			quotaPackageUsed: "(used {percent}%)",
 			quotaColPackage: "Package",
 			quotaColRemain: "Remaining / Total",
-			quotaColExpiry: "Expires"
+			quotaColExpiry: "Expires",
+			/** Line stating when the PAT in effect was authorized (saved). */
+			patAuthorizedAt: "PAT authorized {time}"
 		};
 		const zh = {
 			title: "Qoder（国内版）",
@@ -4223,7 +4305,8 @@ window.__ModuleLoader__.load({
 			quotaPackageUsed: "(已使用{percent}%)",
 			quotaColPackage: "资源包",
 			quotaColRemain: "剩余 / 总量",
-			quotaColExpiry: "到期时间"
+			quotaColExpiry: "到期时间",
+			patAuthorizedAt: "PAT 授权于 {time}"
 		};
 		//#endregion
 		//#region src/client/index.tsx
@@ -4341,6 +4424,19 @@ window.__ModuleLoader__.load({
 					en
 				}), "dsh-qoder-connect: settings copy");
 				const t = ctx.locale.bind(namespace);
+				const applyLanguage = (localeId) => {
+					setActiveLanguage(localeId);
+					noteQuotaLanguage();
+				};
+				applyLanguage(ctx.locale.getLocale().active);
+				ctx.effect(() => {
+					const dispose = ctx.on("locale/change", (snapshot) => {
+						applyLanguage(snapshot.active);
+					});
+					return () => {
+						dispose();
+					};
+				}, "dsh-qoder-connect: package title language");
 				/**
 				* The bound quota settings face, filled in as soon as a host configuration
 				* service becomes available (see the two `ctx.inject` callbacks below).

package/lib/index.d.ts

@@ -17,9 +17,12 @@ import { SettingsNamespace } from "@deepseek-ai/dsh-settings";
  * seed — writes there, so a profile directory never collects loose
  * `.qoder-*` files and the whole plugin's footprint is one folder.
  *
- * Fallbacks, in order: `DSH_QODER_DATA_DIR` env override → the discovered
- * profile → the Harness home (a checkout running its own tests, or a host
- * loading the plugin from outside any profile).
+ * Fallbacks, in order: `DSH_QODER_DATA_DIR` env override → the profile the host
+ * reports as running → the discovered profile → the Harness home (a checkout
+ * running its own tests, or a host loading the plugin from outside any profile).
+ *
+ * The host-reported profile outranks discovery because it is the running
+ * profile rather than an inference about it; see {@link configurePluginPaths}.
  *
  * Split out of `auth.ts` so catalog/probe/heartbeat stores can import the
  * directory without pulling in the credential code (and its upstream
@@ -34,10 +37,10 @@ declare const QODER_DATA_DIR_ENV = "DSH_QODER_DATA_DIR";
 /**
  * The plugin's data directory: `<profile>/.dsh-qoder-connect`.
  *
- * Falls back to the Harness home when no profile can be discovered — a
- * checkout running its own tests, or a host that loads the plugin from
- * outside a profile — so the plugin always has somewhere to write, and
- * `DSH_QODER_DATA_DIR` overrides either way.
+ * Falls back to profile discovery, then to the Harness home when no profile can
+ * be determined — a checkout running its own tests, or a host that loads the
+ * plugin from outside a profile — so the plugin always has somewhere to write,
+ * and `DSH_QODER_DATA_DIR` overrides either way.
  */
 declare function qoderPluginDataDir(): string;
 //#endregion
@@ -181,9 +184,23 @@ interface QoderWebCreditAccount {
    * When the package's credit expires, carried through in whatever form the
    * upstream reported it (an ISO string or a numeric epoch-millisecond value
    * normalized to an ISO string). Absent when the upstream reported no
-   * expiry — rendered as "no expiry", never guessed into a date.
+   * expiry — rendered as "no expiry", never guessed into a date. The
+   * year-9999 "never" sentinel the upstream uses for an uncapped allowance is
+   * dropped at the transport, so it never arrives here as a date.
    */
   packageEndTime?: string;
+  /**
+   * The package's localized display titles, when the upstream named it (a
+   * campaign grant's `SOTA 专属积分` / `SOTA Exclusive Credits`). `packageName`
+   * remains the best single-language guess for renderers that do not consult
+   * this map.
+   */
+  packageNameI18n?: {
+    zh?: string | undefined;
+    en?: string | undefined;
+  };
+  /** The opaque upstream campaign code behind the same grant, when known. */
+  packageCode?: string;
 }
 /** Aggregated credit answer rendered by the plugin card. */
 interface QoderWebCredits {
@@ -686,6 +703,38 @@ interface QoderQuota {
   percentage: number;
   unit: string;
 }
+/**
+ * A named grant of credits that expires on its own schedule.
+ *
+ * The international upstream reports these in `dedicatedResourcePackages`: one
+ * entry per campaign package (the SOTA exclusive credits, for one). Every
+ * bucket the reader already knows (`userQuota`, `orgResourcePackage`,
+ * `addOnQuota`) shares the single cycle-level `expiresAt`, whereas a dedicated
+ * package carries its OWN `expiresAt` and its own localized title — so it is
+ * its own shape, not just another `QoderQuota`.
+ */
+interface QoderDedicatedResourcePackage extends QoderQuota {
+  /** Upstream package id (`01a1426f-…`), when reported. */
+  id?: string | undefined;
+  /** Raw upstream name — usually an opaque campaign code, not display copy. */
+  name?: string | undefined;
+  /** Localized display title from `displayLabels`, when the upstream sends one. */
+  title?: {
+    zh?: string | undefined;
+    en?: string | undefined;
+  } | undefined;
+  /**
+   * This package's own expiry, ISO. Deliberately NOT the account's cycle-level
+   * `expiresAt`: a campaign grant ends when the grant ends, and reporting the
+   * account's (sentinel `9999`) date against it is what made the card's dates
+   * wrong.
+   */
+  expiresAt?: string | undefined;
+  /** Whether the upstream says the package is currently usable. */
+  available?: boolean | undefined;
+  /** Upstream lifecycle marker (`QUOTA_DETAIL_STATUS_ACTIVE`). */
+  status?: string | undefined;
+}
 interface QoderQuotaUsage {
   userQuota?: QoderQuota | undefined;
   orgResourcePackage?: QoderQuota | undefined;
@@ -697,6 +746,15 @@ interface QoderQuotaUsage {
    * than the account actually holds (two on the web, one here).
    */
   addOnQuota?: QoderQuota | undefined;
+  /**
+   * Campaign grants with their own expiry and display title (the international
+   * edition's SOTA exclusive credits land here).
+   *
+   * Dropping this array hid a whole 2,000-credit package from the card: the
+   * reader mapped only the three named buckets above, so the credit was real
+   * and simply never rendered.
+   */
+  dedicatedResourcePackages?: readonly QoderDedicatedResourcePackage[] | undefined;
   totalUsagePercentage?: number | undefined;
   isQuotaExceeded?: boolean | undefined;
   expiresAt?: string | undefined;
@@ -804,8 +862,25 @@ interface QoderCreditAccount {
   remain: number;
   size: number;
   unlimited?: true;
-  /** Expiry of this package, verbatim from the upstream (ISO string). */
+  /**
+   * Expiry of this package, verbatim from the upstream (ISO string).
+   *
+   * Absent when the upstream reported no expiry — which now includes the
+   * year-9999 "never" sentinel the transport drops rather than forwarding.
+   */
   packageEndTime?: string;
+  /**
+   * The package's own localized titles, when the upstream sent a real display
+   * name (a campaign grant's `SOTA 专属积分`). The renderer picks the active
+   * language; `packageName` stays the single-language best guess it falls back
+   * to, so a card that never consults this map still shows a sensible label.
+   */
+  packageNameI18n?: {
+    zh?: string | undefined;
+    en?: string | undefined;
+  };
+  /** Opaque upstream code for the same grant (`act-20261014-129`), when known. */
+  packageCode?: string;
 }
 /** The aggregated credit answer the card renders. */
 interface QoderCredits {
@@ -915,10 +990,17 @@ declare class QoderUpstreamClient {
   /**
    * The subscriber's quota answer, mapped onto the card's credit shape.
    *
-   * Qoder reports one personal quota and an optional organization resource
-   * package; each becomes a package row the card already knows how to draw.
-   * An unbounded personal allowance (`total === 0`, not exceeded) is the
-   * account's "unlimited" state.
+   * Qoder reports one personal quota, an optional organization resource
+   * package, bonus credits, and — on the international edition — a list of
+   * campaign grants under `dedicatedResourcePackages`. Each becomes a package
+   * row the card already knows how to draw. An unbounded personal allowance
+   * (`total === 0`, not exceeded) is the account's "unlimited" state.
+   *
+   * A campaign grant carries its OWN expiry and its OWN localized title, and
+   * neither may be borrowed from the account: `usage.expiresAt` is the
+   * year-9999 "never" sentinel for a personal account, while the grant really
+   * does end, and `name` is an opaque campaign code while the readable copy
+   * lives in `displayLabels`.
    */
   fetchCredits(signal?: AbortSignal): Promise<QoderCredits>;
   /**

package/lib/index.js

@@ -1,4 +1,4 @@
-import { A as QoderCatalog, B as QODER_PAT_ENV_GLOBAL, C as getMachineId, D as QoderCatalogStore, E as randomSentinel, F as QODER_PROBE_PATH, G as QODER_DATA_DIR_ENV, H as patTail, I as QODER_SETTINGS_FACE_PATH, J as qoderPluginDataDir, K as QODER_DATA_DIR_NAME, L as QODER_STATUS_PATH, M as QODER_GLOBAL_AUTH_PATH, N as QODER_GLOBAL_PROBE_PATH, O as qoderCatalogPath, P as QODER_GLOBAL_STATUS_PATH, R as QODER_AUTH_FILENAME, S as utc8WallClock, T as probeModel, U as qoderCredentialIdentity, V as QoderCredentialStore, W as qoderOwnAuthPath, Y as qoderStateDir, _ as modelInfoOf, a as QODER_HOST_HEARTBEAT_FILENAME, b as createQoderTransport, c as processStartTimeMs, d as writeHostHeartbeat, f as QODER_CONNECT_VERSION, g as kindFromQoderFailure, h as classifyUpstreamError, i as variantFor, j as QODER_AUTH_PATH, k as FALLBACK_QODER_MODELS, l as qoderHostHeartbeatPath, m as QoderUpstreamClient, n as GLOBAL_VARIANT, o as clearHostHeartbeat, p as KIND_STATUS, q as qoderMachineIdPath, r as QODER_VARIANTS, s as isHeartbeatProcessAlive, t as CHINA_VARIANT, u as readHostHeartbeat, v as normalizeCredits, w as PROBE_EFFORT_CANDIDATES, x as formatUtc8Date, y as validateApiKey, z as QODER_PAT_ENV_CN } from "./variants-OJKPI_c7.js";
+import { A as QoderCatalog, B as QODER_PAT_ENV_GLOBAL, C as getMachineId, D as QoderCatalogStore, E as randomSentinel, F as QODER_PROBE_PATH, G as QODER_DATA_DIR_ENV, H as patTail, I as QODER_SETTINGS_FACE_PATH, J as qoderMachineIdPath, K as QODER_DATA_DIR_NAME, L as QODER_STATUS_PATH, M as QODER_GLOBAL_AUTH_PATH, N as QODER_GLOBAL_PROBE_PATH, O as qoderCatalogPath, P as QODER_GLOBAL_STATUS_PATH, R as QODER_AUTH_FILENAME, S as utc8WallClock, T as probeModel, U as qoderCredentialIdentity, V as QoderCredentialStore, W as qoderOwnAuthPath, X as qoderStateDir, Y as qoderPluginDataDir, _ as modelInfoOf, a as QODER_HOST_HEARTBEAT_FILENAME, b as createQoderTransport, c as processStartTimeMs, d as writeHostHeartbeat, f as QODER_CONNECT_VERSION, g as kindFromQoderFailure, h as classifyUpstreamError, i as variantFor, j as QODER_AUTH_PATH, k as FALLBACK_QODER_MODELS, l as qoderHostHeartbeatPath, m as QoderUpstreamClient, n as GLOBAL_VARIANT, o as clearHostHeartbeat, p as KIND_STATUS, q as configurePluginPaths, r as QODER_VARIANTS, s as isHeartbeatProcessAlive, t as CHINA_VARIANT, u as readHostHeartbeat, v as normalizeCredits, w as PROBE_EFFORT_CANDIDATES, x as formatUtc8Date, y as validateApiKey, z as QODER_PAT_ENV_CN } from "./variants-Dus_Yq3R.js";
 import z from "@deepseek-ai/schemastery";
 import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
 import { dirname, join, resolve } from "node:path";
@@ -2541,6 +2541,11 @@ const lastLiveFetchAt = /* @__PURE__ */ new Map();
 * without re-registering the provider.
 */
 function apply(ctx, config) {
+	const profileContext = ctx.get("profileContext");
+	configurePluginPaths({
+		profileDir: typeof profileContext?.dir === "string" ? profileContext.dir : void 0,
+		diagnostics: ctx.logger
+	});
 	const store = new SettingsStore();
 	let current = () => ({
 		...readConfig(config),

package/lib/{variants-OJKPI_c7.js → variants-Dus_Yq3R.js}

@@ -2,7 +2,7 @@ import crypto, { createHash, randomBytes } from "node:crypto";
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
-import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, writeFileSync } from "node:fs";
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
 import { EMPTY_RESPONSE_CODE, LlmError, ProviderRequestId, ReasoningEffortId, ToolCallId, attributionHeaders, contentHasImage, createAssistantMessage, createToolResultMessage, createUserMessage } from "@deepseek-ai/dsh-llm";
@@ -21,9 +21,12 @@ import { execFileSync } from "node:child_process";
 * seed — writes there, so a profile directory never collects loose
 * `.qoder-*` files and the whole plugin's footprint is one folder.
 *
-* Fallbacks, in order: `DSH_QODER_DATA_DIR` env override → the discovered
-* profile → the Harness home (a checkout running its own tests, or a host
-* loading the plugin from outside any profile).
+* Fallbacks, in order: `DSH_QODER_DATA_DIR` env override → the profile the host
+* reports as running → the discovered profile → the Harness home (a checkout
+* running its own tests, or a host loading the plugin from outside any profile).
+*
+* The host-reported profile outranks discovery because it is the running
+* profile rather than an inference about it; see {@link configurePluginPaths}.
 *
 * Split out of `auth.ts` so catalog/probe/heartbeat stores can import the
 * directory without pulling in the credential code (and its upstream
@@ -40,6 +43,30 @@ const QODER_DATA_DIR_ENV = "DSH_QODER_DATA_DIR";
 const PROFILES_DIR_NAME = "profiles";
 /** The npm name of this package, as a profile's manifest declares it. */
 const PLUGIN_PACKAGE_NAME = "dsh-qoder-connect";
+/** Host-reported facts about the running profile; see {@link configurePluginPaths}. */
+let hostProfileDir;
+let diagnostics;
+/**
+* Adopt the host's answer for which profile is running, before any path is
+* resolved.
+*
+* `dsh` provides a `profileContext` service (`{ name, dir, … }`) on the host
+* context of every profile it boots — the CLI launcher and the desktop
+* application both, from the same shared boot code — so `dir` is the directory
+* this process booted in, not a guess about it.
+*
+* Called on every `apply()`, which overwrites both fields: a reload arriving
+* without a profile context clears the previous answer instead of keeping it.
+*
+* @param host - the host's report.
+* @param host.profileDir - `profileContext.dir`, when the host has one.
+* @param host.diagnostics - where an ambiguous discovery fallback is reported.
+*/
+function configurePluginPaths(host) {
+	const reported = host.profileDir;
+	hostProfileDir = typeof reported === "string" && reported.trim() !== "" ? reported : void 0;
+	diagnostics = host.diagnostics;
+}
 function pluginPackageRoot() {
 	try {
 		return dirname(dirname(fileURLToPath(import.meta.url)));
@@ -66,15 +93,40 @@ function profileDeclaresPlugin(profileDir) {
 	}
 }
 /**
+* Whether a profile's OWN `node_modules` is a link rather than a directory.
+*
+* This is the shape a residual directory takes when it was left behind by
+* copying another profile's manifest and pointing the whole tree at that
+* profile. A real install links the package (`node_modules/<name>`), not the
+* directory holding it, so this shape never identifies the running copy.
+*
+* An ABSENT `node_modules` is deliberately not this shape: a profile whose
+* packages resolve from the shared `profiles/node_modules` has none of its own,
+* and that profile may still be the one running.
+*/
+function profileNodeModulesIsLinked(profileDir) {
+	try {
+		return lstatSync(join(profileDir, "node_modules")).isSymbolicLink();
+	} catch {
+		return false;
+	}
+}
+/**
 * Whether a profile's installed copy of this plugin resolves to this package.
 *
 * This is what separates two profiles that both declare the plugin — a `web` and
 * a `desktop` profile can each list it — so the data directory follows the
 * profile whose copy is actually running rather than the first one found.
+*
+* A whole-tree link is rejected first (see {@link profileNodeModulesIsLinked}):
+* the realpath comparison cannot tell that shape apart from a real installation,
+* so a residual directory would claim this package just as convincingly as the
+* live copy.
 */
 function profileLinksToThisPackage(profileDir) {
 	const own = pluginPackageRoot();
 	if (own === void 0) return false;
+	if (profileNodeModulesIsLinked(profileDir)) return false;
 	try {
 		return realpathSync(join(profileDir, "node_modules", PLUGIN_PACKAGE_NAME)) === realpathSync(own);
 	} catch {
@@ -85,8 +137,17 @@ function profileLinksToThisPackage(profileDir) {
 * The profile directory this plugin belongs to, or undefined when none can be
 * determined.
 *
-* A single declaring profile is accepted without the link test, so a normal
-* (non-linked) install still resolves.
+* A single declaring profile is accepted without the link test, so a profile
+* whose packages resolve from the shared `profiles/node_modules` — which has no
+* copy of its own to compare — still resolves. A whole-tree link is refused even
+* then: that shape is a residual directory whatever else is true, and there is
+* nothing else it could be.
+*
+* With several declaring profiles only those whose copy resolves here are
+* eligible. Exactly one eligible candidate is an answer; two or more is a tie
+* broken by `readdirSync` order, which Node leaves undefined — so both that and
+* "nothing eligible" are reported, because either way the data directory is
+* about to leave the profile the user expects and nothing else would say so.
 */
 function discoverProfileDir() {
 	const profilesRoot = join(resolveDshHome(), PROFILES_DIR_NAME);
@@ -103,21 +164,34 @@ function discoverProfileDir() {
 		if (profileDeclaresPlugin(dir)) candidates.push(dir);
 	}
 	if (candidates.length === 0) return void 0;
-	if (candidates.length === 1) return candidates[0];
-	return candidates.find((candidate) => profileLinksToThisPackage(candidate));
+	if (candidates.length === 1) {
+		const only = candidates[0];
+		if (profileNodeModulesIsLinked(only)) {
+			diagnostics?.warn(`qoder: the only profile declaring this plugin, ${only}, links its entire node_modules elsewhere and so cannot be the running copy; the data directory falls back to the Harness home.`);
+			return;
+		}
+		return only;
+	}
+	const eligible = candidates.filter((candidate) => profileLinksToThisPackage(candidate));
+	if (eligible.length === 0) {
+		diagnostics?.warn(`qoder: ${candidates.length} profiles declare this plugin, none holds the running copy, and the host reported no running profile; the data directory falls back to the Harness home. Candidates: ${candidates.join(", ")}`);
+		return;
+	}
+	if (eligible.length > 1) diagnostics?.warn(`qoder: ${eligible.length} profiles hold a copy resolving to this package and the host reported no running profile; the data directory follows ${eligible[0]} on nothing but directory order. Candidates: ${eligible.join(", ")}`);
+	return eligible[0];
 }
 /**
 * The plugin's data directory: `<profile>/.dsh-qoder-connect`.
 *
-* Falls back to the Harness home when no profile can be discovered — a
-* checkout running its own tests, or a host that loads the plugin from
-* outside a profile — so the plugin always has somewhere to write, and
-* `DSH_QODER_DATA_DIR` overrides either way.
+* Falls back to profile discovery, then to the Harness home when no profile can
+* be determined — a checkout running its own tests, or a host that loads the
+* plugin from outside a profile — so the plugin always has somewhere to write,
+* and `DSH_QODER_DATA_DIR` overrides either way.
 */
 function qoderPluginDataDir() {
 	const override = process.env[QODER_DATA_DIR_ENV];
 	if (override !== void 0 && override.trim() !== "") return override;
-	const base = discoverProfileDir() ?? resolveDshHome();
+	const base = hostProfileDir ?? discoverProfileDir() ?? resolveDshHome();
 	return join(base, QODER_DATA_DIR_NAME);
 }
 /**
@@ -2505,12 +2579,77 @@ function normalizeQuota(raw) {
 }
 function normalizeExpiresAt(rawExpires) {
 	if (rawExpires === void 0 || rawExpires === null) return void 0;
-	if (typeof rawExpires === "number" && rawExpires > 0) return new Date(rawExpires).toISOString();
+	if (typeof rawExpires === "number" && rawExpires > 0) return toExpiryIso(rawExpires);
 	if (typeof rawExpires === "string" && rawExpires.length > 0) {
 		const parsed = Date.parse(rawExpires);
-		if (!Number.isNaN(parsed) && parsed > 0) return new Date(parsed).toISOString();
+		if (!Number.isNaN(parsed) && parsed > 0) return toExpiryIso(parsed);
 	}
 }
+/**
+* The year at which Qoder stops meaning a date and starts meaning "never".
+*
+* The upstream encodes an uncapped allowance as the year-9999 sentinel
+* `253402214400000`, which is a valid timestamp and a real date to any parser.
+* Rendering it as the account's expiry told the user the quota resets in the
+* year 10000, so the sentinel must be read as the absence of an expiry.
+*/
+const NEVER_EXPIRY_YEAR = 9999;
+/** ISO instant for a parsed expiry, or undefined for the "never" sentinel. */
+function toExpiryIso(atMs) {
+	return new Date(atMs).getUTCFullYear() >= NEVER_EXPIRY_YEAR ? void 0 : new Date(atMs).toISOString();
+}
+/** Localized `displayLabels` values, keyed by bare language (`zh` / `en`). */
+function labelI18n(raw) {
+	const out = {};
+	if (!raw || typeof raw !== "object") return out;
+	for (const [key, value] of Object.entries(raw)) {
+		const text = asString(value);
+		if (text === void 0) continue;
+		const language = key.slice(0, 2).toLowerCase();
+		if (language === "zh") out.zh = text;
+		else if (language === "en") out.en = text;
+	}
+	return out;
+}
+/**
+* One campaign grant, including the title the upstream localized for it.
+*
+* `name` is an opaque code (`act-20261014-129`) — the human copy lives in
+* `displayLabels` under `dimension: 'title'`, so that is what the row is
+* labelled with and the code is kept only as provenance.
+*/
+function normalizeDedicatedPackage(raw) {
+	if (!raw || typeof raw !== "object") return void 0;
+	const quota = normalizeQuota(raw);
+	if (quota === void 0) return void 0;
+	const title = (Array.isArray(raw.displayLabels) ? raw.displayLabels : []).find((label) => label?.dimension === "title");
+	const id = asString(raw.id);
+	const name = asString(raw.name);
+	const status = asString(raw.status);
+	const expiresAt = normalizeExpiresAt(raw.expiresAt);
+	return {
+		...quota,
+		...id === void 0 ? {} : { id },
+		...name === void 0 ? {} : { name },
+		...title === void 0 ? {} : (() => {
+			const parsed = labelI18n(title.valueI18n);
+			const fallback = asString(title.value);
+			if (parsed.zh === void 0 && parsed.en === void 0 && fallback === void 0) return {};
+			return { title: {
+				...parsed.zh !== void 0 ? { zh: parsed.zh } : fallback !== void 0 ? { zh: fallback } : {},
+				...parsed.en !== void 0 ? { en: parsed.en } : fallback !== void 0 ? { en: fallback } : {}
+			} };
+		})(),
+		...expiresAt === void 0 ? {} : { expiresAt },
+		...typeof raw.available === "boolean" ? { available: raw.available } : {},
+		...status === void 0 ? {} : { status }
+	};
+}
+function normalizeDedicatedPackages(raw) {
+	if (!Array.isArray(raw)) return void 0;
+	const packages = raw.map((entry) => normalizeDedicatedPackage(entry)).filter((entry) => entry !== void 0);
+	return packages.length > 0 ? packages : void 0;
+}
 function asString(value) {
 	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 }
@@ -2670,6 +2809,10 @@ var QoderUsageReader = class {
 			userQuota: normalizeQuota(data.userQuota),
 			orgResourcePackage: normalizeQuota(data.orgResourcePackage),
 			addOnQuota: normalizeQuota(data.addOnQuota),
+			...(() => {
+				const packages = normalizeDedicatedPackages(data.dedicatedResourcePackages);
+				return packages === void 0 ? {} : { dedicatedResourcePackages: packages };
+			})(),
 			totalUsagePercentage: typeof data.totalUsagePercentage === "number" ? data.totalUsagePercentage : void 0,
 			isQuotaExceeded: typeof data.isQuotaExceeded === "boolean" ? data.isQuotaExceeded : false,
 			expiresAt: normalizeExpiresAt(data.expiresAt),
@@ -4365,10 +4508,17 @@ var QoderUpstreamClient = class {
 	/**
 	* The subscriber's quota answer, mapped onto the card's credit shape.
 	*
-	* Qoder reports one personal quota and an optional organization resource
-	* package; each becomes a package row the card already knows how to draw.
-	* An unbounded personal allowance (`total === 0`, not exceeded) is the
-	* account's "unlimited" state.
+	* Qoder reports one personal quota, an optional organization resource
+	* package, bonus credits, and — on the international edition — a list of
+	* campaign grants under `dedicatedResourcePackages`. Each becomes a package
+	* row the card already knows how to draw. An unbounded personal allowance
+	* (`total === 0`, not exceeded) is the account's "unlimited" state.
+	*
+	* A campaign grant carries its OWN expiry and its OWN localized title, and
+	* neither may be borrowed from the account: `usage.expiresAt` is the
+	* year-9999 "never" sentinel for a personal account, while the grant really
+	* does end, and `name` is an opaque campaign code while the readable copy
+	* lives in `displayLabels`.
 	*/
 	async fetchCredits(signal) {
 		const usage = (await this.transport.readAccount({
@@ -4397,6 +4547,18 @@ var QoderUpstreamClient = class {
 			size: addOn.total,
 			...usage.expiresAt === void 0 ? {} : { packageEndTime: usage.expiresAt }
 		});
+		for (const pack of usage.dedicatedResourcePackages ?? []) {
+			const titles = pack.title;
+			const fallbackName = titles?.zh ?? titles?.en ?? pack.name ?? "专属资源包";
+			accounts.push({
+				packageName: fallbackName,
+				...titles === void 0 ? {} : { packageNameI18n: titles },
+				...pack.name === void 0 ? {} : { packageCode: pack.name },
+				remain: pack.remaining,
+				size: pack.total,
+				...pack.expiresAt === void 0 ? {} : { packageEndTime: pack.expiresAt }
+			});
+		}
 		const unlimited = usage.isQuotaExceeded === false && personal !== void 0 && personal.total === 0;
 		return {
 			total: usage.totalUsagePercentage ?? personal?.percentage ?? 0,
@@ -4662,7 +4824,7 @@ const DEFAULT_MAX_TOKENS = 32768;
 const DEFAULT_CONTEXT_WINDOW = 18e4;
 //#endregion
 //#region src/version.ts
-const QODER_CONNECT_VERSION = "0.2.4";
+const QODER_CONNECT_VERSION = "0.2.5";
 //#endregion
 //#region src/host-heartbeat.ts
 /**
@@ -4859,4 +5021,4 @@ function variantFor(id) {
 	return QODER_VARIANTS.find((variant) => variant.id === id);
 }
 //#endregion
-export { QoderCatalog as A, QODER_PAT_ENV_GLOBAL as B, getMachineId as C, QoderCatalogStore as D, randomSentinel as E, QODER_PROBE_PATH as F, QODER_DATA_DIR_ENV as G, patTail as H, QODER_SETTINGS_FACE_PATH as I, qoderPluginDataDir as J, QODER_DATA_DIR_NAME as K, QODER_STATUS_PATH as L, QODER_GLOBAL_AUTH_PATH as M, QODER_GLOBAL_PROBE_PATH as N, qoderCatalogPath as O, QODER_GLOBAL_STATUS_PATH as P, QODER_AUTH_FILENAME as R, utc8WallClock as S, probeModel as T, qoderCredentialIdentity as U, QoderCredentialStore as V, qoderOwnAuthPath as W, qoderStateDir as Y, modelInfoOf as _, QODER_HOST_HEARTBEAT_FILENAME as a, createQoderTransport as b, processStartTimeMs as c, writeHostHeartbeat as d, QODER_CONNECT_VERSION as f, kindFromQoderFailure as g, classifyUpstreamError as h, variantFor as i, QODER_AUTH_PATH as j, FALLBACK_QODER_MODELS as k, qoderHostHeartbeatPath as l, QoderUpstreamClient as m, GLOBAL_VARIANT as n, clearHostHeartbeat as o, KIND_STATUS as p, qoderMachineIdPath as q, QODER_VARIANTS as r, isHeartbeatProcessAlive as s, CHINA_VARIANT as t, readHostHeartbeat as u, normalizeCredits as v, PROBE_EFFORT_CANDIDATES as w, formatUtc8Date as x, validateApiKey as y, QODER_PAT_ENV_CN as z };
+export { QoderCatalog as A, QODER_PAT_ENV_GLOBAL as B, getMachineId as C, QoderCatalogStore as D, randomSentinel as E, QODER_PROBE_PATH as F, QODER_DATA_DIR_ENV as G, patTail as H, QODER_SETTINGS_FACE_PATH as I, qoderMachineIdPath as J, QODER_DATA_DIR_NAME as K, QODER_STATUS_PATH as L, QODER_GLOBAL_AUTH_PATH as M, QODER_GLOBAL_PROBE_PATH as N, qoderCatalogPath as O, QODER_GLOBAL_STATUS_PATH as P, QODER_AUTH_FILENAME as R, utc8WallClock as S, probeModel as T, qoderCredentialIdentity as U, QoderCredentialStore as V, qoderOwnAuthPath as W, qoderStateDir as X, qoderPluginDataDir as Y, modelInfoOf as _, QODER_HOST_HEARTBEAT_FILENAME as a, createQoderTransport as b, processStartTimeMs as c, writeHostHeartbeat as d, QODER_CONNECT_VERSION as f, kindFromQoderFailure as g, classifyUpstreamError as h, variantFor as i, QODER_AUTH_PATH as j, FALLBACK_QODER_MODELS as k, qoderHostHeartbeatPath as l, QoderUpstreamClient as m, GLOBAL_VARIANT as n, clearHostHeartbeat as o, KIND_STATUS as p, configurePluginPaths as q, QODER_VARIANTS as r, isHeartbeatProcessAlive as s, CHINA_VARIANT as t, readHostHeartbeat as u, normalizeCredits as v, PROBE_EFFORT_CANDIDATES as w, formatUtc8Date as x, validateApiKey as y, QODER_PAT_ENV_CN as z };

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-qoder-connect",
   "displayName": "DSH Qoder Connect",
   "description": "将 Qoder（国内版 / 国际版）的模型接入 DeepSeek Harness — bring Qoder (CN & international) models into DeepSeek Harness.",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "author": "corrinehu",
   "keywords": [
     "dsh-plugin",