dsh-decision-engine 0.5.0 → 0.5.1

package/lib/client.js

@@ -833,8 +833,13 @@ window.__ModuleLoader__.load({
         // 4) API Key：每个 provider 一格，各自保存各自的 key
         row(
           `API Key${keyOk ? `（已配置 ${activeKeyStatus?.hint ?? view.keyHint ?? ""}）` : "（未配置）"}`,
-          activeKeyStatus !== null && activeKeyStatus.refName
-            ? `存到「${storageValue === "config" ? "插件配置" : ".credentials.yaml"}」的 ${activeKeyStatus.refName}`
+          activeKeyStatus !== null
+            ? storageValue === "config"
+              // 存到配置文件时，目标是该 provider 的显式字段名（如
+              // bamboonodeApiKey），而不是凭据变量名——两者是不同的位置，
+              // 混着说会让人去 .credentials.yaml 里找 key。
+              ? `存到插件配置 config.yml 的 ${activeKeyStatus.keyField || "显式 key 字段"}（明文）`
+              : `存到 .credentials.yaml 的 ${activeKeyStatus.refName}`
             : "留空则不修改；粘贴新 key 后点保存",
           h("input", {
             type: "password",
@@ -854,7 +859,7 @@ window.__ModuleLoader__.load({
         row(
           "密钥保存位置",
           storageValue === "config"
-            ? "存进插件配置 config.yml（自包含，便于随目录备份；注意是明文）"
+            ? `存进插件配置 config.yml 的 ${activeKeyStatus?.keyField || "显式 key 字段"}（自包含，便于随目录备份；注意是明文）`
             : "存进 ~/.dsh/.credentials.yaml（默认，与其他服务统一托管）",
           h(
             "select",
@@ -1132,9 +1137,15 @@ window.__ModuleLoader__.load({
           `模型 ${view.model || "(服务端默认)"} · 超时 ${view.timeoutMs}ms · 请求 ${view.stats?.requests ?? 0} 次（缓存 ${view.stats?.cached ?? 0}）`,
           // 密钥来源一律取「当前 provider 自己那一条」：用顶层 keyEnvName 会
           // 在切换后短暂显示上一家的名字（服务端字段与本地选择不同步时）。
-          activeKeyStatus?.refName ? h("br", null) : null,
-          activeKeyStatus?.refName
-            ? `密钥来源 ${activeKeyStatus.refName}${activeKeyStatus.configured === true ? "" : "（未读到）"}`
+          //
+          // 显示的是**真实命中的来源**（sourceLabel，服务端算好），而不是
+          // `apiKeyEnv`。后者只是「若走凭据文件时该查哪个变量名」，
+          // 在 keyStorage=config 时根本没被读取——照它显示会让人以为
+          // key 存在 .credentials.yaml 里，甚至误判它过期了。
+          activeKeyStatus !== null ? h("br", null) : null,
+          activeKeyStatus !== null
+            ? `密钥来源 ${activeKeyStatus.sourceLabel ?? activeKeyStatus.refName ?? "未知"}` +
+              `${activeKeyStatus.configured === true ? "" : "（未读到）"}`
             : null,
         ),
         msg !== null

package/lib/index.js

@@ -1641,13 +1641,40 @@ export function apply(ctx, config) {
         }),
       );
 
+    /**
+     * 把「密钥来源」翻成用户能核对的一句话。
+     *
+     * 为什么不让前端自己拼：界面只知道变量名（`BAMBOO_API_KEY`），
+     * 不知道真正命中的是配置文件里的哪一格。只显示变量名会造成误判——
+     * 用户看到 `BAMBOO_API_KEY` 会以为 key 在 `.credentials.yaml` 里，
+     * 而实际生效的可能是 `config.yml` 的 `bamboonodeApiKey`，甚至以为
+     * 那个变量「过期了」。来源判定与文案因此都放在服务端，只有一份真相。
+     *
+     * @param source - config / credentials / env / none。
+     * @param provider - 已解析的 provider（提供 keyField 与 apiKeyEnv）。
+     * @returns 可直接展示的中文说明。
+     */
+    const keySourceLabel = (source, provider) => {
+      if (source === "config") {
+        const field = provider.preset?.keyField ?? "显式 key 字段";
+        return `配置文件 ${CONFIG_FILE_NAME} 的 ${field}`;
+      }
+      if (source === "credentials") {
+        return `~/.dsh/.credentials.yaml 的 ${provider.apiKeyEnv}`;
+      }
+      if (source === "env") {
+        return `环境变量 ${provider.apiKeyEnv}`;
+      }
+      return "未配置";
+    };
+
     /**
      * 汇总三个 provider 各自的 key 状态。
      *
      * 只回报「有没有」「从哪来的」「末四位」，绝不回传明文——
      * 这份 JSON 会经过浏览器，明文 key 不应出现在网络响应里。
      *
-     * @returns id → `{ configured, hint, source, refName }`。
+     * @returns id → `{ configured, hint, source, refName, sourceLabel }`。
      */
     const buildKeyStatus = () => {
       const out = {};
@@ -1656,19 +1683,32 @@ export function apply(ctx, config) {
         const key = resolveKey({ ...cfg, provider: id }, probe);
         const inCredentials =
           probe.apiKeyEnv.length > 0 && readCredentialFromDsh(probe.apiKeyEnv) !== undefined;
+        const source =
+          probe.explicitKey.length > 0
+            ? "config"
+            : inCredentials
+              ? "credentials"
+              : key === undefined
+                ? "none"
+                : "env";
         out[id] = {
           configured: key !== undefined,
           hint: key === undefined ? "" : `…${key.slice(-4)}`,
           refName: probe.apiKeyEnv,
+          // 该 provider 的显式 key 字段名：`keyStorage=config` 时保存的目标。
+          // 与 refName（凭据文件/环境变量的变量名）是两个不同的位置，
+          // 界面上必须分开说，否则「存到插件配置的 BAMBOO_API_KEY」这种
+          // 自相矛盾的文案就会出现。
+          keyField: probe.preset?.keyField ?? "",
           // explicit = 配置里写了明文；credentials = 凭据文件；env = 环境变量
-          source:
-            probe.explicitKey.length > 0
-              ? "config"
-              : inCredentials
-                ? "credentials"
-                : key === undefined
-                  ? "none"
-                  : "env",
+          source,
+          // 给界面直接用的可读来源。**必须由服务端算**：只有这里同时知道
+          // provider 的显式字段名（bamboonodeApiKey）与真正命中的来源。
+          //
+          // 早先界面只显示 `apiKeyEnv`（如 BAMBOO_API_KEY），在
+          // keyStorage=config 时会造成严重误解——那个变量根本没被读取，
+          // 用户会以为 key 存在 .credentials.yaml 里，甚至以为它过期了。
+          sourceLabel: keySourceLabel(source, probe),
         };
       }
       return out;

package/lib/providers.js

@@ -485,6 +485,10 @@ export function providerCatalog() {
       endpointStyle: preset.endpointStyle,
       defaultModel: preset.defaultModel,
       apiKeyEnv: preset.apiKeyEnv,
+      // 该 provider 的显式 key 字段名（`bamboonodeApiKey` 等）。
+      // 界面用它说明「key 存在配置文件的哪一格」——只报变量名会让人
+      // 以为 key 在 .credentials.yaml 里，而实际生效的可能是配置文件。
+      keyField: preset.keyField,
       hint: preset.hint,
       hintEn: preset.hintEn,
       customizable: id === "custom",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-decision-engine",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "dsh-decision-engine: a cheap judgement layer for DeepSeek Harness — all nine decision points (tool authorization, model routing, delegation, compaction, turn continuation, retrieval, skill pick, session title, COT translation) are implemented and individually switchable, and it works against any system-one style API (system one, bamboonode, or a custom base URL).",
   "icon": "./icon.svg",
   "type": "module",