@lynn123411/dsh-a6api 1.5.8 → 1.5.10

package/README.md

@@ -4,7 +4,8 @@ A6API 多模型聚合站深度接入插件：将 A6API 聚合网关无缝注册
 
 ## 特性
 
-- **多标签页优雅布局**：重构并优化设置交互，拆分为「可用模型」、「模型目录」、「账户资产」、「基础配置」四大专属页面，分类清晰、告别页面拥挤。
+- **多标签页优雅布局**：设置交互拆分为「可用模型」、「模型目录」、「账户资产」、「基础配置」四大专属页面，分类清晰、告别页面拥挤。
+- **共享「API中转」设置页**：本插件的四个页面整体作为「设置 - API中转」页的首个 tab（`settings.section` id `relay`），与 `dsh-llm-agentrouter` 的端点卡片同页并列，参与者可增删。内核不允许一页被多个插件共同声明，因此每个参与者各持一份运行时逻辑一致的页壳，**先加载者当选页面宿主**、其余只注册卡片；当选者被卸载后下次启动自动改选。做法与约束见仓库 `docs/rules/shared-settings-page.md`。
 - **全真官方模型卡片复刻**：1:1 像素级复刻 A6API 官网模型卡片视图，包含品牌图标、模型名、商户 ID、渠道说明、输入/输出/缓存读写单价、实时倍率比值胶囊、实时/24h/7d 阶梯成功率点阵、延迟与缓存命中率进度条、智能标签（稳定/低价/高速/高质/保真）以及真实的固定与禁用操作。
 - **混合价估算标注（≈¥x/亿 tokens）**：每张模型卡片价格区新增绿色「≈ ¥x.xx/亿」胶囊——按卡片 24h 实测缓存命中率，把「缓存读价（命中）/ 输入价（未命中）/ 输出价」折算为每 1 亿 tokens 的混合人民币成本（输出 token 占比固定 0.35%，与官网模型市场标注口径一致），悬停展示完整估算式与每 1M 单价，对比模型贵贱一目了然；按次计费等无 token 单价的卡片不展示。
 - **给模型固定商家**：卡片一键「固定商家」/「取消固定」，直接调用 A6API 平台固定接口，把当前卡片商家绑定为该模型的服务渠道（优先路由）；固定自动解析并绑定当前 API Key 令牌，异常时自动切换智能优选（平台默认兜底，无多余开关）；检测到模型已固定到其他商家时，卡片自动切换为该固定商家（含价格/健康度指标），无需手动探测；卡片状态实时跟随官网——官网侧解除固定（如不接受涨价）后插件按钮自动还原。
@@ -12,15 +13,15 @@ A6API 多模型聚合站深度接入插件：将 A6API 聚合网关无缝注册
 - **路由快照时效标注**：每张模型卡片右下角标注「路由快照」时效（该卡片商户数据来自我最近一次路由请求的时刻，相对时间 + 悬停绝对时间），与全网最近成功时间叠放两行；日志中无路由记录的模型显示灰色「从未路由」。
 - **官方 vs 商户全景价格对比**：展开卡片即可查看详细渠道说明、智能标签、真实数据徽章、近 100 次样本统计，以及官方基准价与商户实时价在「输入价/输出价/缓存读/缓存写 (1M)」各维度的清晰对比表格。
 - **真实账户资产看板与调用明细**：在「账户资产」页面实时呈现真实可用余额（美元及折合人民币）、历史总消耗、累计请求次数，并实时捕获展示近期模型请求的路由明细快照（时间、模型、命中商户渠道、总耗时、Token 消耗及状态）。
-- **原生提供商动态注册与一键加入 DSH**：自动向 DSH LLM 运行时注入 `a6api` 目录，在「可用模型」列表点击「添加到 DSH」即可将模型自动增量同步至 `settings.yaml` 与 DSH 对话选择器。
+- **一键加入 DSH 与原生路由接入**：在「可用模型」列表点击「添加到 DSH」即可把模型增量写入 `settings.yaml` 的 `llm-pi-ai.providers.a6api`（由 pi-ai 据此注册 `a6api` 路由），模型随即出现在 DSH 对话选择器中；插件不自行调用 LLM 运行时注册接口。
 - **节点切换与凭据一站式配置**：在「基础配置」页面支持 CDN 推荐节点（`https://api.a6api.com`）、直连备用节点（`https://a6.a6api.com`）与自定义网关节点自由切换，提供 API Key 与系统访问令牌密码显隐切换及获取教程。
 - **DSH 原生配置存储**：全部配置落位 DSH 自有配置体系——凭据（API Key / 系统访问令牌 / userId）存入 `~/.dsh/.credentials.yaml`（0600，env 优先语义），非机密状态（节点 / 模型列表）写入 `settings.yaml` 的 `llm-pi-ai.providers.a6api`，读写走 DSH 原生 `settings` / `credentials` 服务（串行写队列 + schema 校验 + 热发布），不再占用独立配置文件；旧版 `dsh-a6api-config.json` 启动时自动迁移并归档为 `.bak`。启用模型时节点随模型列表一并落盘；移除全部模型时自动移除 DSH 中的 a6api 提供商块（DSH 对手写路由无合法的零模型表示）。
 - **价格波动实时胶囊**：标题栏余额右侧常驻「价格波动：n」胶囊（白底，仅数字变色：`0` 绿/`n>0` 红/`--` 灰），基于 `GET /api/marketplace/price-notices` 的待处理条数每 60s 轻轮询（与余额同频，仅计不处置；待处理 = 通知 `relations[].state === 'open'`，即固定渠道存在未被处理/取代的价格变动，兼容显式 `pendingCount` 字段与 `status ∈ open/pending/effective` 的兜底形态），`n>0` 时一键新标签跳 `https://a6api.com/console/token`，未配置/失效或 `0` 时置灰不可点，满足“只监听不处置”的轻量诉求。
 - **「模型市场」直达胶囊**：设置页标题栏与侧边栏浮层的胶囊行中，价格波动右侧常驻同款「模型市场」胶囊（白底灰字、hover 变绿），点击新标签直达 `https://a6api.com/models`。
 - **侧边栏快捷模型卡片**：主界面左下角（设置按钮上方）常驻「A6api」入口按钮，**任何会话（含子代理）均可展开浮层**，向上弹出当前会话所用模型对应的完整商户卡片（与设置页同一数据源与操作能力：探测/固定/禁用/详情全部可用）；会话切换模型时卡片实时跟随；当前会话未使用 A6api 模型时，模型卡片区域整体置灰且不可交互，顶部账户速览胶囊（余额/价格波动/模型市场）保持正常可用。
 - **侧边栏账户速览胶囊**：浮层顶部常驻「账户余额」（纯展示，每 60s 自动同步）、「价格波动」（行为与标题栏一致，可一键跳官网）与「模型市场」（点击新标签直达 `https://a6api.com/models`）三枚同款胶囊，账号级数据与模型卡片无关，加载/空态恒显示。
-- **后台预热无感加载**：插件随 DSH 启动即后台预热一次完整状态，之后每 60s 静默整体刷新；服务端 `/state` 将余额/模型列表/日志/固定记录等独立上游调用并行拉取（串行 5 次 RTT → 1 次）—— 侧边栏浮层与设置页打开时数据已就绪，秒开无加载等待。服务端对 `/state` 保留 120s 短缓存供轮询复用；「可用模型」页「刷新列表」按钮带 `force=1` 绕过缓存立即向 A6API 重建最新数据（v1.5.3 起）。
-- **模型目录管理**：「可用模型」右侧新增「模型目录」页——一键「从 A6API 获取市场模型」翻页拉取市场支持的全部模型 ID（参数初始为空），再「从 OpenRouter 一键查询」自动填充 `contextWindow / maxTokens / input`（查不到的保持留空可手动填写，每行也可单独查询；`name` 仅用户手动填写，未填则不写入 DSH）；行内编辑全部采用 DSH `settings.yaml` 原生模型字段（name / contextWindow / maxTokens / input / reasoningEfforts），保存后若该模型已在 DSH 启用则立即重写 `llm-pi-ai.providers.a6api` 对应条目即时生效；OpenRouter 查询（单行「查询参数」/「一键查询」）填充到已启用模型时同样立即重写（v1.5.4 起）；支持按「可用（当前令牌白名单）/ 不可用」与「参数已填 / 未填」筛选；可一键「清空目录」（二次确认）后重新从 A6API 获取并重新用 OpenRouter 填充；新获取的模型默认声明 DSH 全部思考档位（off / minimal / low / medium / high / xhigh / max）。内置静态模型目录已移除，所有参数以运行时数据为准（v1.4 起存于 `~/.dsh/dsh-a6api/catalog.json` 插件子目录，与 DSH「组件自建 home 子目录」惯例一致；旧版根目录 `dsh-a6api-catalog.json` 首次加载时自动搬迁并删除），写入 settings.yaml 时缺省字段自动省略（由 DSH 默认值兜底）。
+- **后台预热无感加载**：插件随 DSH 启动即后台预热一次完整状态，之后每 60s 静默整体刷新；服务端 `/state` 将余额/模型列表/日志/固定记录等独立上游调用并行拉取（串行 5 次 RTT → 1 次）—— 侧边栏浮层与设置页打开时数据已就绪，秒开无加载等待。服务端对 `/state` 保留 120s 短缓存供轮询复用；「可用模型」页「刷新列表」按钮带 `force=1` 绕过缓存立即向 A6API 重建最新数据。
+- **模型目录管理**：「可用模型」右侧的「模型目录」页——一键「从 A6API 获取市场模型」翻页拉取市场支持的全部模型 ID（参数初始为空），再「从 OpenRouter 一键查询」自动填充 `contextWindow / maxTokens / input`（查不到的保持留空可手动填写，每行也可单独查询；`name` 仅用户手动填写，未填则不写入 DSH）；行内编辑全部采用 DSH `settings.yaml` 原生模型字段（name / contextWindow / maxTokens / input / reasoningEfforts），保存后若该模型已在 DSH 启用则立即重写 `llm-pi-ai.providers.a6api` 对应条目即时生效；OpenRouter 查询（单行「查询参数」/「一键查询」）填充到已启用模型时同样立即重写；支持按「可用（当前令牌白名单）/ 不可用」与「参数已填 / 未填」筛选；可一键「清空目录」（二次确认）后重新从 A6API 获取并重新用 OpenRouter 填充；新获取的模型默认声明 DSH 全部思考档位（off / minimal / low / medium / high / xhigh / max）。不内置静态模型目录，所有参数以运行时数据为准（存于 `~/.dsh/dsh-a6api/catalog.json` 插件子目录，与 DSH「组件自建 home 子目录」惯例一致；根目录遗留的 `dsh-a6api-catalog.json` 首次加载时自动搬迁并删除），写入 settings.yaml 时缺省字段自动省略（由 DSH 默认值兜底）。
 
 ## 安装
 

package/lib/client.js

@@ -36,7 +36,7 @@ __export(index_exports, {
   name: () => name
 });
 module.exports = __toCommonJS(index_exports);
-var import_react7 = __toESM(require("react"), 1);
+var import_react8 = __toESM(require("react"), 1);
 
 // src/client/components/A6ApiSettings.tsx
 var import_react5 = require("react");
@@ -2688,6 +2688,141 @@ var A6ApiSidebarCardBody = ({
   ] });
 };
 
+// src/client/relay-settings-page.js
+var import_react7 = require("react");
+var RELAY_PAGE_ID = "relay";
+var RELAY_PAGE_ORDER = 120;
+var RELAY_ITEM_SLOT = "relay.settings.item";
+var TABLIST_STYLE = {
+  display: "flex",
+  alignItems: "flex-end",
+  gap: "22px",
+  marginTop: "2px",
+  marginBottom: "16px"
+};
+var TAB_STYLE = {
+  appearance: "none",
+  background: "transparent",
+  // No border on ANY tab: the marker below is the active tab's own element, so
+  // an inactive tab has nothing that could render a line.
+  border: "none",
+  position: "relative",
+  padding: "7px 1px 11px",
+  cursor: "pointer",
+  font: "inherit",
+  fontSize: "13px",
+  lineHeight: "20px",
+  color: "var(--dsw-alias-label-tertiary, inherit)"
+};
+var TAB_ACTIVE_STYLE = Object.assign({}, TAB_STYLE, {
+  color: "var(--dsw-alias-label-primary, inherit)"
+});
+var TAB_MARKER_STYLE = {
+  position: "absolute",
+  left: 0,
+  right: 0,
+  bottom: 0,
+  height: "2px",
+  borderRadius: "2px 2px 0 0",
+  background: "var(--dsw-alias-label-primary, currentColor)"
+};
+var PANEL_STYLE = { margin: 0 };
+var PANEL_HIDDEN_STYLE = { margin: 0, display: "none" };
+function readLabel(label) {
+  if (typeof label === "function") return label();
+  return typeof label === "string" ? label : "";
+}
+function createRelayTabs(ctx) {
+  const locale = ctx.get("locale");
+  let version = -1;
+  let revision = -1;
+  let tabs = [];
+  return {
+    getSnapshot: () => {
+      const nextVersion = ctx.slots.getVersion(RELAY_ITEM_SLOT);
+      const nextRevision = locale === void 0 ? 0 : locale.getSnapshot().revision;
+      if (nextVersion === version && nextRevision === revision) return tabs;
+      version = nextVersion;
+      revision = nextRevision;
+      tabs = ctx.slots.entries(RELAY_ITEM_SLOT).map((entry) => ({
+        id: entry.options.id ?? "",
+        order: entry.options.order ?? 0,
+        label: readLabel(entry.options.label)
+      })).sort((left, right) => left.order - right.order);
+      return tabs;
+    },
+    subscribe: (listener) => {
+      const offSlots = ctx.slots.subscribe(RELAY_ITEM_SLOT, listener);
+      const offLocale = locale === void 0 ? void 0 : locale.subscribe(listener);
+      return () => {
+        offSlots();
+        if (offLocale !== void 0) offLocale();
+      };
+    }
+  };
+}
+function RelaySettingsSection({ renderSlot, relayTabs }) {
+  const tabs = (0, import_react7.useSyncExternalStore)(
+    relayTabs.subscribe,
+    relayTabs.getSnapshot,
+    relayTabs.getSnapshot
+  );
+  const [requested, setRequested] = (0, import_react7.useState)(null);
+  const selected = requested !== null && tabs.some((tab) => tab.id === requested) ? requested : tabs.length > 0 ? tabs[0].id : null;
+  if (selected === null) return null;
+  return (0, import_react7.createElement)(
+    "div",
+    null,
+    (0, import_react7.createElement)(
+      "div",
+      { role: "tablist", style: TABLIST_STYLE },
+      tabs.map((tab) => (0, import_react7.createElement)(
+        "button",
+        {
+          key: tab.id,
+          type: "button",
+          role: "tab",
+          "aria-selected": tab.id === selected,
+          style: tab.id === selected ? TAB_ACTIVE_STYLE : TAB_STYLE,
+          onClick: () => {
+            setRequested(tab.id);
+          }
+        },
+        tab.label,
+        tab.id === selected ? (0, import_react7.createElement)("span", { style: TAB_MARKER_STYLE, "aria-hidden": true }) : null
+      ))
+    ),
+    tabs.map((tab) => (0, import_react7.createElement)(
+      "div",
+      {
+        key: tab.id,
+        role: "tabpanel",
+        hidden: tab.id !== selected,
+        style: tab.id === selected ? PANEL_STYLE : PANEL_HIDDEN_STYLE
+      },
+      renderSlot(RELAY_ITEM_SLOT, {}, { only: tab.id })
+    ))
+  );
+}
+function relayPageClaimed(ctx) {
+  return ctx.slots.entries("settings.section").some((entry) => entry.options.id === RELAY_PAGE_ID);
+}
+function claimRelaySettingsPage(ctx, label) {
+  if (relayPageClaimed(ctx)) return () => {
+  };
+  const relayTabs = createRelayTabs(ctx);
+  const children = {};
+  children[RELAY_ITEM_SLOT] = { kind: "list", scope: "root" };
+  return ctx.slots.register({
+    name: "settings.section",
+    id: RELAY_PAGE_ID,
+    order: RELAY_PAGE_ORDER,
+    label,
+    inject: () => ({ relayTabs }),
+    children
+  }, RelaySettingsSection);
+}
+
 // src/client/styles/main.css
 var main_default = `/* A6API Plugin Styles - Clean Professional DSH Native Theme Integration */
 
@@ -4956,7 +5091,28 @@ body.dsh-a6api-tooltip-active [data-tooltip]::before {
 
 // src/client/index.ts
 var name = "@lynn123411/dsh-a6api";
-var inject = ["slots"];
+var inject = ["slots", "locale"];
+var TAB_NAV = { zh: "A6api", en: "A6api" };
+var RELAY_PAGE_NAV = { zh: "API\u4E2D\u8F6C", en: "API relay" };
+var NS = "settings.a6api";
+function registerNavDicts(ctx) {
+  const locale = ctx && typeof ctx.get === "function" ? ctx.get("locale") : void 0;
+  if (!locale || typeof locale.register !== "function") return;
+  ctx.effect(
+    () => locale.register(NS, {
+      zh: { pageNav: RELAY_PAGE_NAV.zh, tabNav: TAB_NAV.zh },
+      en: { pageNav: RELAY_PAGE_NAV.en, tabNav: TAB_NAV.en }
+    }),
+    "dsh-a6api: shared page dictionaries"
+  );
+}
+function navLabel(ctx, key) {
+  const locale = ctx && typeof ctx.get === "function" ? ctx.get("locale") : void 0;
+  if (locale && typeof locale.bind === "function") {
+    return () => locale.bind(NS)(key);
+  }
+  return () => key === "pageNav" ? RELAY_PAGE_NAV.zh : TAB_NAV.zh;
+}
 function injectStyles() {
   if (typeof document === "undefined") return;
   const styleId = "dsh-a6api-styles";
@@ -5157,29 +5313,43 @@ function apply(ctx) {
   }
   if (typeof window === "undefined") return;
   try {
-    setTimeout(() => {
-      try {
-        store.warmUp();
-      } catch {
-      }
-      try {
-        store.initPricePolling();
-      } catch {
-      }
-    }, 1500);
+    ctx.effect(() => {
+      const warmupTimer = setTimeout(() => {
+        try {
+          store.warmUp();
+        } catch {
+        }
+        try {
+          store.initPricePolling();
+        } catch {
+        }
+      }, 1500);
+      return () => {
+        clearTimeout(warmupTimer);
+        try {
+          store.stopAutoRefresh();
+        } catch {
+        }
+      };
+    }, "dsh-a6api: warmup & price polling");
   } catch {
   }
   try {
     const slots = ctx?.slots || (ctx?.get ? ctx.get("slots") : null);
     if (!slots || typeof slots.inject !== "function") return;
     slots.inject("settings.section", () => {
+      registerNavDicts(ctx);
+      return claimRelaySettingsPage(ctx, navLabel(ctx, "pageNav"));
+    });
+    slots.inject(RELAY_ITEM_SLOT, () => {
       return slots.register(
         {
-          name: "settings.section",
+          name: RELAY_ITEM_SLOT,
+          // id = 本插件的设置命名空间：共享页按 id 过滤本 tab 的面板，故须与卡片自身命名空间一致
           id: "dsh-a6api",
-          // 约定：自有插件设置项 order 从 110 起步进 10（原生最大 100=桌面设置），保证排在所有原生项之下
-          order: 120,
-          label: () => "A6api"
+          order: 10,
+          // label 由共享页投影为外层 tab 标题
+          label: navLabel(ctx, "tabNav")
         },
         A6ApiSettingsPanel
       );
@@ -5193,7 +5363,7 @@ function apply(ctx) {
           order: -1,
           label: () => "A6api"
         },
-        (props) => import_react7.default.createElement(A6ApiSidebarCard, {
+        (props) => import_react8.default.createElement(A6ApiSidebarCard, {
           ...props || {},
           getModelDirectories
         })