dsh-codearts 0.5.2 → 1.0.0

package/lib/index.d.mts

@@ -7,18 +7,18 @@ import { AttachmentStore } from "@deepseek-ai/dsh-attachment";
 /**
  * CodeArts model catalog.
  *
- * 目录有两条来源：
- *  1. **动态发现**（`src/discovery.ts` + `upstream.fetchModels`）：启动与每小时
- *     各拉一次，取内置 / 限时福利 / agent-center 三路的并集。这是正常路径。
- *  2. **静态种子**（`FALLBACK_CODEARTS_MODELS`）：仅在发现失败或尚未登录时兜底。
+ * **目录只放上游给的东西。** 唯一来源是动态发现（`src/discovery.ts` +
+ * `upstream.fetchModels`）：启动、每小时、以及卡片上「刷新模型列表」各拉一次，
+ * 取内置 / 限时福利 / agent-center 三路的并集。上游没返回的模型就是没有，
+ * 未登录或三路全失败时目录是空的 —— 不拿一份历史名单冒充「可用模型」。
  *
- * 种子的来龙去脉（诚实标注，别把它当权威）：
- *  - 福利模型的 id 已与真实账号的 `gateway/config` 对齐；
- *  - 商业模型的 id 可信（来自 codearts2api 的 `seedKnownModels`），但
- *    `contextWindow` / `maxTokens` / `supportsImages` 是**占位值**，发现成功时
- *    会被上游真实值覆盖 —— 这正是 `fillFromSeed` 只补缺、不覆盖的原因。
- *    写错的 contextWindow 只影响 DSH 的上下文计量与截断余量，不影响路由；
- *    写错的 maxTokens 会直接让请求失败（见 `MEASURED_MAX_TOKENS`）。
+ * `FALLBACK_CODEARTS_MODELS` 因此**不再往目录里塞模型**，只剩一个按 id 的参数表：
+ * 上游有时不给 `contextWindow` / `maxTokens`，而写错的 `maxTokens` 会让每个请求
+ * 直接失败（见 `MEASURED_MAX_TOKENS`）。它只给发现到的模型补参数，别的什么都不管。
+ *
+ * 福利路由同理：只有 `gateway/config` 亲口给出的模型才算福利（见 `isBenefitModel`）。
+ * 这条渠道 2026-10-21 起整体不可用，于是福利模型当天就从目录里消失 —— 那是事实，
+ * 不是故障，硬撑只会把能正常用的积分模型推到一条不存在的渠道上。
  *
  * @module dsh-codearts/catalog
  */
@@ -29,6 +29,12 @@ interface CodeArtsModelInfo {
   contextWindow: number;
   maxTokens: number;
   supportsImages: boolean;
+  /**
+   * 积分消耗倍率（上游 `credit[].ratio_display` 的原值，如 `0.18x`）。
+   *
+   * 来自模型发现；福利模型由展示层强制成 `x0.00`，不依赖上游是否给 credit。
+   */
+  ratio?: string;
   /**
    * 该模型走限时福利（免费套餐）路由。
    *
@@ -38,12 +44,11 @@ interface CodeArtsModelInfo {
   benefit?: boolean;
 }
 /**
- * Static seed roster. Ids are the *upstream registered* spellings (case
- * matters — `canonicalModel` in upstream.ts passes these through verbatim).
- * Updated 2026-09 from codearts2api's known model set.
+ * 参数表（不是模型名单）：只给**发现到的**模型补 `contextWindow` / `maxTokens` /
+ * `supportsImages`，绝不会因为这里有条目就把模型塞进目录。
  *
  * maxTokens 注记（2026-09-30 实测，scripts/param-probe.mjs 直连上游二分验证）：
- * 免费福利 DeepSeek 模型的 max_tokens 服务端硬上限是 **65536**，更大的值
+ * 福利 DeepSeek 模型的 max_tokens 服务端硬上限是 **65536**，更大的值
  * （73728 / 98304 / 131072 / 384000 / 393216）一律流内报
  * InferHub.001001005.400 "The request param is invalid, Please check it"。
  * 此前的 384000/393216 是占位值：DSH 会把 catalog 的 maxTokens 作为
@@ -52,6 +57,7 @@ interface CodeArtsModelInfo {
 declare const FALLBACK_CODEARTS_MODELS: readonly CodeArtsModelInfo[];
 /** Mutable catalog shared by the shim's `/v1/models` and the adapter. */
 declare class CodeArtsCatalog {
+  /** 空目录起步：没发现过就是没有模型，不拿历史名单冒充。 */
   private models;
   current(): readonly CodeArtsModelInfo[];
   set(models: readonly CodeArtsModelInfo[]): void;
@@ -437,6 +443,8 @@ interface UsageSnapshot {
   today: UsageTotals;
   /** 账本里所有保留天数的合计。 */
   allTime: UsageTotals;
+  /** 最近 30 天（含今天）的合计。 */
+  last30: UsageTotals;
   /** 今天按模型的合计，按 totalTokens 降序。 */
   byModelToday: {
     id: string;
@@ -640,22 +648,23 @@ interface CreditCacheOptions {
  * 而上游对同一账号的并发是有成本/风险的。
  */
 declare class CodeArtsCreditCache {
-  private state;
-  private inflight;
+  /** 按账号分槽：多账号下每个号有自己的余额，不能共用一个快照。 */
+  private readonly states;
+  private readonly inflights;
   private readonly ttlMs;
   private readonly failureTtlMs;
   private readonly load;
   private readonly now;
   constructor(options?: CreditCacheOptions);
-  /** 当前缓存内容（不触发请求），供只想读快照的场景使用。 */
-  peek(): CodeArtsCreditState | undefined;
-  /** 丢掉缓存，下次 get 会重新拉（重新登录/添加账号后调用）。 */
-  invalidate(): void;
+  /** 某账号的缓存内容（不触发请求），供只想读快照的场景使用。 */
+  peek(accountId: string): CodeArtsCreditState | undefined;
+  /** 丢掉缓存，下次 get 会重新拉（重新登录/添加账号后调用）。省略账号则清空全部。 */
+  invalidate(accountId?: string): void;
   /**
-   * 取一次积分。命中缓存直接返回；否则合并成一次上游请求。
+   * 取一次某账号的积分。命中缓存直接返回；否则合并成一次上游请求。
    * **不抛异常**：失败以 `phase: 'error'` 返回，调用方（状态路由）照样能渲染。
    */
-  get(credential: CodeArtsResolved, signal?: AbortSignal): Promise<CodeArtsCreditState>;
+  get(accountId: string, credential: CodeArtsResolved, signal?: AbortSignal): Promise<CodeArtsCreditState>;
   private run;
 }
 //#endregion