@lynn123411/dsh-a6api 1.2.0 → 1.3.0

package/lib/types/client/components/A6ApiSidebarCard.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+interface A6ApiSidebarCardProps {
+    /** 宿主注入:侧边栏是否宽布局(false = 56px rail) */
+    wide: boolean;
+    /** 宿主注入:会话列表快照钩子(取 current 即当前会话 ID) */
+    useSessions?: (selector: (s: any) => any) => any;
+    /** apply 注入:modelDirectories 服务访问器(与 composer 模型选择器同源) */
+    getModelDirectories?: () => any;
+}
+/**
+ * 侧边栏左下角「A6api」按钮 + 向上弹出当前会话 A6api 模型的 MerchantCard 浮层。
+ * 与设置页共享 A6ApiStore 单例:探测/轮询/操作结果实时同步。
+ *
+ * useSessions 是 React hook,不能条件调用:由外层按「壳是否注入」分派到两个固定
+ * 分支(内层恒调用 / 无钩子分支恒不调用),规避 Rules of Hooks 风险。
+ */
+export declare const A6ApiSidebarCard: React.FC<A6ApiSidebarCardProps>;
+export {};

package/lib/types/client/components/ModelCatalogPanel.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+/**
+ * 模型目录页（「可用模型」右侧 tab）：
+ * - 「从 A6API 获取市场模型」：翻页拉取 A6API 市场全部模型 ID 入目录（参数初始为空）
+ * - 「从 OpenRouter 一键查询」：对全部模型查 OpenRouter 并填充参数（name 仅用户手动填写）；
+ *   每行也可单独查询
+ * - 筛选：可用模型（当前令牌白名单，与「可用模型」页同源）/ 参数状态（已填/未填）
+ * - 行内编辑 settings.yaml 原生模型字段；保存后若该模型已在 DSH 启用，
+ *   服务端立即重写 settings.yaml 对应条目（参数即时生效）
+ */
+export declare const ModelCatalogPanel: React.FC;

package/lib/types/client/components/PricePill.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { PriceFluctuationState } from '../../types.js';
+/**
+ * 价格波动胶囊（设置页头部与侧边栏浮层共用）：
+ * 未配置令牌显示 `--`（禁用），无变动置灰（禁用），有待处理时点击跳官网处理。
+ * compact 为浮层内的紧凑缩窄版。
+ */
+export declare const PricePill: React.FC<{
+    pf: PriceFluctuationState;
+    hasToken: boolean;
+    compact?: boolean;
+}>;

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

@@ -1,4 +1,4 @@
-import type { A6ApiConfig, BalanceInfo, ModelCardData, ApiRoutingLogItem, PriceFluctuationState } from '../types.js';
+import type { A6ApiConfig, BalanceInfo, CatalogModelEntry, ModelCardData, ApiRoutingLogItem, PriceFluctuationState, MarketplacePin } from '../types.js';
 export interface StoreState {
     loading: boolean;
     config: A6ApiConfig;
@@ -7,6 +7,20 @@ export interface StoreState {
     dshConfiguredModels: string[];
     recentLogs: ApiRoutingLogItem[];
     probingModelNames: Set<string>;
+    /** 正在执行固定/取消固定/禁用/恢复操作的模型 */
+    actionBusyModels: Set<string>;
+    /** 全量探测是否进行中（store 驱动 UI：进度、取消按钮、重入防护） */
+    probeAllActive: boolean;
+    /** 全量探测总模型数（入队时快照） */
+    probeAllTotal: number;
+    /** 全量探测已完成数（与 state.models 解耦，/state 刷新不丢） */
+    probeAllDoneCount: number;
+    /** 平台固定记录（卡片状态跟随官网） */
+    pins: MarketplacePin[];
+    /** 模型目录（运行时 JSON，字段 = settings.yaml 原生模型字段 + brand） */
+    catalog: CatalogModelEntry[];
+    /** 目录操作进行中（获取市场模型 / OpenRouter 查询） */
+    catalogBusy: 'fetch' | 'query' | null;
     error: string | null;
     priceFluctuation: PriceFluctuationState;
 }
@@ -15,7 +29,16 @@ declare class A6ApiStore {
     private state;
     private listeners;
     private autoRefreshTimer;
-    private pricePollTimer;
+    /** 启动预热已触发（幂等）：插件随 DSH 启动即后台拉一次完整状态 */
+    private warmedUp;
+    /** 全量探测取消标志：置位后不再从队列取新任务，在途探测正常完成 */
+    private probeCancelled;
+    /** 本轮全量探测的模型名快照（null = 未在运行），用于进度计数与 /state 刷新后重挂状态 */
+    private probeAllSnapshot;
+    /** 本轮已完成探测的模型（幂等集合，驱动 probeAllDoneCount） */
+    private probeAllDone;
+    /** 入队前各模型的 probeError 暂存，取消时恢复历史错误提示 */
+    private probeQueuedPrevError;
     constructor();
     subscribe(listener: Listener): () => void;
     private notify;
@@ -23,10 +46,77 @@ declare class A6ApiStore {
     fetchState(): Promise<void>;
     saveConfig(config: Partial<A6ApiConfig>): Promise<boolean>;
     refreshBalance(): Promise<void>;
+    fetchCatalog(): Promise<void>;
+    /** 从 A6API 市场拉取全部模型 ID 并入目录（仅新增/补品牌，不动已有参数） */
+    fetchMarketModels(): Promise<{
+        ok: boolean;
+        total?: number;
+        added?: number;
+        failedPages?: number;
+        error?: string;
+    }>;
+    /** 对全部（或指定）目录模型查 OpenRouter 并填充参数 */
+    queryOpenRouter(modelIds?: string[]): Promise<{
+        ok: boolean;
+        updated?: number;
+        notFound?: string[];
+        error?: string;
+    }>;
+    /** 修改目录条目参数；已启用模型由服务端即时重写 settings.yaml */
+    updateCatalogEntry(id: string, patch: Partial<CatalogModelEntry>): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** 清空模型目录（随后可重新从 A6API 拉取 / OpenRouter 填充） */
+    clearCatalog(): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
     fetchPriceFluctuation(): Promise<void>;
+    /** 单次探测请求（不修改状态，供限流重试循环复用） */
+    private probeOnce;
+    private isRateLimitedOutcome;
+    /** 把一次探测结果应用到卡片（按结果类型走原有映射逻辑） */
+    private applyProbeResult;
     probeModel(modelName: string): Promise<void>;
     probeAll(): Promise<void>;
+    /** 把仍处于 queued 的模型复位为 idle 并恢复入队前的错误文案 */
+    private restoreQueuedModels;
+    /** 取消全量探测：立即复位排队模型，不再取新任务，已在途的探测正常完成并回填卡片 */
+    cancelProbeAll(): void;
     toggleDshModel(modelName: string): Promise<void>;
+    /**
+     * 固定 / 取消固定 / 禁用 / 恢复 的统一执行器。
+     * 成功后会刷新 /state（服务端会把平台固定记录叠加回卡片，跟随官网状态）。
+     */
+    private runMarketplaceAction;
+    /** 固定卡片当前商家到该模型 */
+    pinModel(modelName: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** 取消该模型的固定 */
+    unpinModel(modelName: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** 禁用卡片当前商家对该模型的服务 */
+    disableModel(modelName: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** 恢复被禁用的商家 */
+    restoreModel(modelName: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * 启动预热：插件随 DSH 启动即后台拉取一次完整状态。
+     * 侧边栏按钮在应用启动时就已挂载，预热让用户打开浮层/设置页时数据早已就绪 → 秒开无 spinner。
+     * 未配置凭据时 /state 返回默认回退数据，无害；后续保存配置/轮询会持续刷新。
+     * 目录一并预热（模型目录 tab 徽标/首屏不等待首次进入）。
+     */
+    warmUp(): void;
     private startAutoRefresh;
     stopAutoRefresh(): void;
     initPricePolling(): void;

package/lib/types/index.d.ts

@@ -1,7 +1,7 @@
 export declare const name = "@lynn123411/dsh-a6api";
 export declare const inject: string[];
-export { fetchBalance, fetchTokenModels, fetchRecentLogs, fetchChannelDetails, } from './server/a6api-client.js';
+export { fetchBalance, fetchTokenModels, fetchRecentLogs, fetchChannelDetails, fetchMarketplacePins, } from './server/a6api-client.js';
 export { probeSingleModel, getKnownMerchantsFromLogs } from './server/probe.js';
-export { resolveModelMeta, A6API_CATALOG } from './server/catalog.js';
-export { readPluginConfig, savePluginConfig, syncToDshSettings } from './server/sync.js';
+export { resolveModelMeta, inferBrand, getCatalog, getCatalogEntry, clearCatalog, queryOpenRouter, fetchMarketplaceModels, updateCatalogEntry, } from './server/catalog.js';
+export { createConfigAccess, A6API_CRED_REF, A6API_TOKEN_REF, A6API_USER_REF } from './server/sync.js';
 export declare function apply(ctx: any): void;

package/lib/types/server/a6api-client.d.ts

@@ -1,24 +1,50 @@
-import type { BalanceInfo, MerchantChannelInfo, ApiRoutingLogItem } from '../types.js';
+import type { BalanceInfo, MerchantChannelInfo, ApiRoutingLogItem, MarketplacePin, A6ApiTokenItem } from '../types.js';
 /** Normalize Base URL removing trailing slashes */
 export declare function cleanBaseUrl(url: string): string;
 /** Format relative time */
 export declare function formatRelativeTime(timestampSec: number): string;
 /** Format CNY Price */
 export declare function formatCnyPrice(micros: number, exchangeRate?: number): string;
-export declare function buildWebHeaders(userId?: string, sessionCookie?: string): Record<string, string>;
+export declare function buildWebHeaders(userId?: string, accessToken?: string): Record<string, string>;
 /** Fetch User Balance (Real Account Balance Only) */
-export declare function fetchBalance(baseURL: string, apiKey: string, userId?: string, sessionCookie?: string): Promise<BalanceInfo | null>;
+export declare function fetchBalance(baseURL: string, apiKey: string, userId?: string, accessToken?: string): Promise<BalanceInfo | null>;
 /** Fetch Token Allowed Models */
 export declare function fetchTokenModels(baseURL: string, apiKey: string): Promise<string[]>;
 /** Fetch Recent User Routing Logs */
-export declare function fetchRecentLogs(userId?: string, sessionCookie?: string, limit?: number): Promise<ApiRoutingLogItem[]>;
+export declare function fetchRecentLogs(userId?: string, accessToken?: string, limit?: number): Promise<ApiRoutingLogItem[]>;
 /** Fetch Channel Card details from A6API Marketplace */
-export declare function fetchChannelDetails(channelId: number, userId?: string, sessionCookie?: string, targetModelName?: string, logSnapshot?: any): Promise<MerchantChannelInfo | null>;
+export declare function fetchChannelDetails(channelId: number, userId?: string, accessToken?: string, targetModelName?: string, logSnapshot?: any): Promise<MerchantChannelInfo | null>;
 /** 轻量拉取价格波动条数（仅 pending/unseen） */
-export declare function fetchPriceFluctuation(userId?: string, sessionCookie?: string, accessToken?: string): Promise<{
+export declare function fetchPriceFluctuation(userId?: string, accessToken?: string): Promise<{
     pendingCount: number;
     unseenCount: number;
     totalCount: number;
     notices?: any[];
     authError?: boolean;
 }>;
+interface MarketplaceActionResult {
+    ok: boolean;
+    message?: string;
+    data?: any;
+}
+/** GET /api/marketplace/pins — 当前账号全部固定记录（卡片状态跟随官网的真相源） */
+export declare function fetchMarketplacePins(userId?: string, accessToken?: string): Promise<MarketplacePin[]>;
+/** GET /api/token/?p=1&size=100 — 令牌列表（用于把 API Key 解析为 token_id） */
+export declare function fetchTokens(userId?: string, accessToken?: string): Promise<A6ApiTokenItem[]>;
+/** POST /api/marketplace/pin — 把某模型的流量固定到指定渠道（绑定令牌） */
+export declare function marketplacePin(userId: string | undefined, accessToken: string | undefined, payload: {
+    token_id: number;
+    channel_id: number;
+    model_name: string;
+    fallback_to_smart_routing: boolean;
+}): Promise<MarketplaceActionResult>;
+/** POST /api/marketplace/unpin — 取消某模型的固定 */
+export declare function marketplaceUnpin(userId: string | undefined, accessToken: string | undefined, payload: {
+    token_id: number;
+    model_name: string;
+}): Promise<MarketplaceActionResult>;
+/** POST /api/marketplace/channels/:id/disable?model= — 禁用某渠道对该模型的服务 */
+export declare function marketplaceDisableChannel(userId: string | undefined, accessToken: string | undefined, channelId: number, model: string): Promise<MarketplaceActionResult>;
+/** POST /api/marketplace/channels/:id/restore?model= — 恢复被禁用的渠道 */
+export declare function marketplaceRestoreChannel(userId: string | undefined, accessToken: string | undefined, channelId: number, model: string): Promise<MarketplaceActionResult>;
+export {};

package/lib/types/server/catalog.d.ts

@@ -1,6 +1,45 @@
-import type { A6ApiModelMeta } from '../types.js';
-export declare const A6API_CATALOG: Record<string, A6ApiModelMeta>;
-/** Infer Brand from model name if not in catalog. */
+import type { A6ApiModelMeta, CatalogModelEntry } from '../types.js';
+export declare function catalogFile(): string;
+export declare function getCatalog(): CatalogModelEntry[];
+export declare function getCatalogEntry(id: string): CatalogModelEntry | undefined;
+/** 合并新增条目（不覆盖已有条目的既有字段；仅补缺失字段，参数以用户已保存/查询到的为准）。
+ *  undefined 字段不参与合并（避免覆盖已有值）；按小写 id 去重（保留首个 casing，避免大小写幽灵重复）。 */
+export declare function upsertCatalogEntries(entries: CatalogModelEntry[]): Promise<void>;
+/** 清空目录（重新从 A6API 拉取/OpenRouter 填充前使用）。settings.yaml 已启用条目不受影响 */
+export declare function clearCatalog(): Promise<void>;
+/** 全量替换式更新单个条目（模型目录页保存修改用）；patch 中值为 null 的字段 = 删除该字段。返回更新后的条目 */
+export declare function updateCatalogEntry(id: string, patch: Partial<Omit<CatalogModelEntry, 'id'>>): Promise<CatalogModelEntry | null>;
+/** 从 A6API 模型名推断品牌（目录无数据时的展示兜底，与旧行为一致） */
 export declare function inferBrand(modelId: string): string;
-/** Resolve metadata for any model ID, falling back to safe defaults. */
+/**
+ * 默认推理档位：DSH llm-pi-ai 支持的全部思考档位（THINKING_LEVELS），
+ * wire 值取档位名本身（identity），`off` 无 wire 值（null = 发送时不带思考参数）。
+ * 新获取的市场模型默认声明全部档位，用户可自行修改。
+ */
+export declare const DEFAULT_REASONING_EFFORTS: Record<string, string | null>;
+/**
+ * 解析模型元信息（同步）：目录数据优先，缺失时返回展示兜底值。
+ * 注意：写 settings.yaml 时不要用此函数的兜底值——缺字段应省略（见 buildA6apiBlock）。
+ */
 export declare function resolveModelMeta(modelId: string): A6ApiModelMeta;
+/**
+ * 拉取 A6API 市场支持的全部模型 ID（含品牌）。
+ * 不排除任何模型（图像生成等一并收录，参数由 OpenRouter 查询决定能否填充）。
+ */
+export declare function fetchMarketplaceModels(userId?: string, accessToken?: string): Promise<{
+    models: {
+        id: string;
+        brand?: string;
+        reasoningEfforts: Record<string, string | null>;
+    }[];
+    failedPages: number;
+}>;
+export interface OrQueryResult {
+    updated: CatalogModelEntry[];
+    notFound: string[];
+}
+/**
+ * 对一批模型 ID 查询 OpenRouter 并填充目录（能查到的填充，查不到的保持空参数字段）。
+ * 返回更新统计：updated 为本次填充/变更的条目，notFound 为查无的 ID。
+ */
+export declare function queryOpenRouter(ids: string[]): Promise<OrQueryResult>;

package/lib/types/server/probe.d.ts

@@ -4,6 +4,8 @@ export interface ProbeResult {
     success: boolean;
     channelId?: number;
     channelName?: string;
+    /** 该次请求实际使用的令牌 ID（用于固定/禁用按令牌绑定） */
+    tokenId?: number;
     merchant?: MerchantChannelInfo | null;
     error?: string;
     durationMs?: number;

package/lib/types/server/sync.d.ts

@@ -1,14 +1,33 @@
 import type { A6ApiConfig } from '../types.js';
+/**
+ * DSH 原生配置整合（消除插件独立配置文件 dsh-a6api-config.json）：
+ * - 凭据（API Key / 系统访问令牌 / userId）→ ~/.dsh/.credentials.yaml（refs，0600）
+ * - 非机密状态（baseURL / 模型列表）→ ~/.dsh/settings.yaml 的 llm-pi-ai.providers.a6api 块
+ * - 读写优先走 DSH 原生缝 ctx.credentials / ctx.settings（env 优先语义、串行写队列、schema 校验、
+ *   热发布）；原生服务缺失或写入失败时回退到直接读写两个文件（格式与 DSH 原生一致）。
+ * - 旧版独立配置文件在启动时自动迁移（只填空不覆盖）并归档为 dsh-a6api-config.json.bak。
+ */
 export declare const A6API_CRED_REF = "A6API_API_KEY";
-/** Read plugin dedicated config */
-export declare function readPluginConfig(): Promise<A6ApiConfig>;
-/** Save plugin dedicated config（密钥单一真相源在 ~/.dsh/.credentials.yaml，配置 JSON 不再冗余明文） */
-export declare function savePluginConfig(config: A6ApiConfig): Promise<void>;
+export declare const A6API_TOKEN_REF = "A6API_ACCESS_TOKEN";
+export declare const A6API_USER_REF = "A6API_USER_ID";
 /** Read a key from .credentials.yaml */
 export declare function readCredentialKey(refKey: string): Promise<string | null>;
-/** Write/update a key in .credentials.yaml */
+/**
+ * Write/update a key in .credentials.yaml。
+ * DSH credentials-local 对空 ref 值整体拒收文档（parseRefs 抛错），因此
+ * 空串/undefined = 删除该键行（与原生 unset 语义一致），绝不写入空值。
+ */
 export declare function writeCredentialKey(refKey: string, value: string): Promise<void>;
-/** Sync active models to DSH settings.yaml under llm-pi-ai.providers.a6api */
-export declare function syncToDshSettings(baseURL: string, modelIds: string[]): Promise<void>;
-/** Get currently configured model IDs in DSH settings for a6api */
-export declare function getDshConfiguredModels(): Promise<string[]>;
+export interface ConfigAccess {
+    /** 触发（并等待）旧配置文件的自动迁移；幂等，进程内只执行一次，失败不阻塞 */
+    ensureMigrated(): Promise<void>;
+    /** 读取当前配置：原生缝优先，逐级兜底到旧文件 */
+    readConfig(): Promise<A6ApiConfig>;
+    /** 写入凭据字段（空串 = 清除，走 unset）；settings 同步请用 syncModels */
+    writeConfig(parts: Partial<Pick<A6ApiConfig, 'apiKey' | 'accessToken' | 'userId'>>): Promise<void>;
+    /** 把模型列表（与 baseURL）同步进 DSH settings.yaml 的 llm-pi-ai.providers.a6api 块 */
+    syncModels(baseURL: string, modelIds: string[]): Promise<void>;
+    /** 当前 DSH 已配置的 a6api 模型 ID 列表 */
+    getDshConfiguredModels(): Promise<string[]>;
+}
+export declare function createConfigAccess(ctx: any): ConfigAccess;

package/lib/types/types.d.ts

@@ -4,15 +4,44 @@ export interface A6ApiConfig {
     accessToken?: string;
     userId?: string;
     activeModels: string[];
-    lastSelectedBaseUrl?: string;
-    customBaseURL?: string;
-    /** backward compatibility */
-    sessionCookie?: string;
     /** 服务端脱敏下发：是否已配置 API Key（真实密钥绝不回传客户端） */
     hasApiKey?: boolean;
     /** 服务端脱敏下发：是否已配置系统访问令牌 */
     hasToken?: boolean;
 }
+/**
+ * 模型目录条目（settings.yaml 的 llm-pi-ai 原生模型字段 + 内部 brand）。
+ * 可选字段缺省 = 参数未获取/未填写，写 settings.yaml 时省略该字段（llm-pi-ai 默认值兜底）。
+ */
+export interface CatalogModelEntry {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    maxTokens?: number;
+    input?: ('text' | 'image')[];
+    /** false = 明确非推理模型；dict = 档位 → wire 值（值可为 null，同 llm-pi-ai 语义） */
+    reasoningEfforts?: Record<string, string | null> | false;
+    /** 仅插件内部使用：品牌来自 A6API 市场渠道，不写入 settings.yaml */
+    brand?: string;
+    /** 最近一次 OpenRouter 查询/人工修改时间 */
+    updatedAt?: number;
+}
+/** DSH llm-pi-ai 支持的完整思考档位（THINKING_LEVELS，与 dsh-llm-pi-ai 源码一致） */
+export declare const THINKING_LEVEL_KEYS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+export type ReasoningEffortsValue = Record<string, string | null> | false;
+/**
+ * 校验 reasoningEfforts（DSH llm-pi-ai 语义，服务端与客户端共用）：
+ * - false = 非推理模型，合法
+ * - 键必须 ∈ THINKING_LEVEL_KEYS；值必须非空字符串，仅 off 允许 null
+ * - 空字典、仅 off 无其他档位均非法
+ */
+export declare function validateReasoningEfforts(value: unknown): {
+    ok: true;
+    value: ReasoningEffortsValue;
+} | {
+    ok: false;
+    error: string;
+};
 export interface A6ApiModelMeta {
     id: string;
     name: string;
@@ -103,10 +132,35 @@ export interface MerchantChannelInfo {
     authenticity_guaranteed: boolean;
     authenticity_badge?: string;
     is_pinned?: boolean;
+    /** 官方渠道搜索返回的固定状态：pin_here / pin_elsewhere / undefined */
+    pin_status?: string;
     user_channel_disabled?: boolean;
     supplier_channel_disabled?: boolean;
     raw?: any;
 }
+/** 平台侧固定记录（GET /api/marketplace/pins） */
+export interface MarketplacePin {
+    id?: number;
+    token_id: number;
+    token_name?: string;
+    model_name: string;
+    channel_id?: number;
+    channel_name?: string;
+    supplier_name?: string;
+    supplier_nickname?: string;
+    /** 异常时是否自动切换智能优选（false = 严格固定） */
+    fallback_to_smart_routing?: boolean;
+    created_at?: number;
+    raw?: any;
+}
+/** 令牌列表条目（GET /api/token/，用于把 API Key 解析为 token_id） */
+export interface A6ApiTokenItem {
+    id: number;
+    name?: string;
+    key?: string;
+    status?: number;
+    raw?: any;
+}
 export interface ModelCardData {
     model_name: string;
     brand: string;
@@ -116,7 +170,7 @@ export interface ModelCardData {
     hasReasoning: boolean;
     inDsh: boolean;
     merchant?: MerchantChannelInfo;
-    probeStatus: 'idle' | 'probing' | 'success' | 'error';
+    probeStatus: 'idle' | 'queued' | 'probing' | 'success' | 'error';
     probeError?: string;
     probeLatencyMs?: number;
     lastProbedAt?: number;
@@ -124,6 +178,14 @@ export interface ModelCardData {
     lastRoutedAt?: number;
     /** 服务端算好的相对时间文案（如「3 小时前」），无记录时客户端显示「从未路由」 */
     lastRoutedText?: string;
+    /** 平台固定状态（按当前 API Key 令牌）：固定到卡片商家 / 固定到其他商家 / 未固定 */
+    pinStatus?: 'pin_here' | 'pin_elsewhere';
+    /** 固定的渠道 ID（pin_elsewhere 时用于展示固定到了哪家） */
+    pinnedChannelId?: number;
+    pinnedSupplierName?: string;
+    pinnedFallback?: boolean;
+    /** 该模型对应的固定记录是否属于当前 API Key 令牌（false 时仅作参考展示） */
+    pinTokenMatched?: boolean;
 }
 export interface BalanceInfo {
     hasAccountAuth: boolean;
@@ -144,6 +206,8 @@ export interface ApiRoutingLogItem {
     model_name: string;
     channel?: number | string;
     channel_name?: string;
+    /** 发起该请求的令牌 ID（用于把 API Key 解析为固定/禁用所需的 token_id） */
+    token_id?: number;
     prompt_tokens?: number;
     completion_tokens?: number;
     use_time?: number;
@@ -161,6 +225,8 @@ export interface A6ApiStateResponse {
     models: ModelCardData[];
     dshConfiguredModels: string[];
     recentLogs?: ApiRoutingLogItem[];
+    /** 平台固定记录列表（用于卡片状态跟随官网） */
+    pins?: MarketplacePin[];
 }
 export interface PriceFluctuationState {
     pendingCount: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynn123411/dsh-a6api",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A6API 多模型聚合站接入插件：原生 LLM 提供商注册、账户实时余额与价格波动监控、Token 白名单同步、商户线路探测与全景指标卡片",
   "license": "MIT",
   "author": "lynn123411",