@leonhardthust/dsh-decision-engine 1.12.0 → 1.13.0

package/config.example.yml

@@ -413,15 +413,17 @@ guardFallbackReasoningEffort: ""
 # ============================================================================
 # 匿名使用统计（可选）
 # ============================================================================
-# 只上报「装了多少台、每天有多少人在用」，用来改进插件。字段只有七个：
-# 匿名安装 id（首次运行随机生成的 UUIDv4，与账号无关）、插件版本、平台、
-# 架构、宿主版本、当日决策数、事件类型。
+# 用途只有一个：让作者知道还有多少人在用、哪些版本/平台在用、每天判了多少
+# 次，用来判断这个插件值不值得继续维护（以及优先修哪个平台的问题）。
 #
-# 绝不上报：API key、prompt / 工具参数、文件路径、provider 地址、会话内容、
-# 用户名；服务端也不记录 IP。删掉 analytics.json 即换新身份。
+# 上报字段（全部）：随机安装 id（首次运行生成的 UUIDv4，与账号无关）、插件版本、
+# 平台、架构、宿主版本、当天决策数、事件类型（install / daily heartbeat）。
 #
-#   off      完全联网都不做（连版本检查都没有）
-#   install  仅首次运行上报一次「装了」
+# 绝不上报：API key、prompt / 工具参数、文件路径、provider 地址、模型名、会话
+# 内容、用户名；服务端也不记录 IP。删掉 analytics.json 即换新身份。
+#
+#   off      完全关闭：一个请求都不发
+#   install  仅首次运行上报一次「装了」，之后不再联网
 #   daily    每天上报一次，附带当日决策数（默认）
 #
 # telemetryLevel: daily

package/docs/releasing.md

@@ -1,6 +1,6 @@
 # npm 发布
 
-发布目标：`@leonhardthust/dsh-decision-engine`，当前版本 `1.12.0`，公开包。
+发布目标：`@leonhardthust/dsh-decision-engine`，当前版本 `1.13.0`，公开包。
 
 本分支基于 `zuosus/dsh-decision-engine` 的 MIT 代码，保留原作者与许可证；npm scope、源码仓库、bundle 引用和浏览器主模块 / charts chunk 标识已同步为本分支身份。内部 API、样式标识和用户数据目录保留旧名称以兼容已有配置。不要同时启用原包与本 scoped fork，它们提供相同的服务与页面。
 
@@ -9,7 +9,7 @@
 - `.github/workflows/ci.yml`：main push、PR、手动运行或发布工作流复用；Ubuntu 24.04 + Node.js 24 + Vite+ 1.6.0。执行 frozen install、完整测试与接线、隔离情景、实际打包和 tarball 检查。失败不会被忽略。
 - `.github/workflows/publish.yml`：每次 `main` push 自动检测版本。先比较整个 push 的 `before` 与当前 manifest，拒绝错误包名、非法或倒退版本；再只读查询 npmjs。当前版本已上传则跳过；当前版本高于 npmjs latest 且未上传则进入完整验证及发布。多提交 push 比较整个 push 前后，不仅比较 HEAD 的父提交。
 - 后续发版只需修改 `package.json` 版本并提交到 main；无需创建 tag 或手动点运行。发布依赖检测和本次提交的完整 CI 均成功，不跳过测试。稳定版本发布到 `latest`，预发布版本自动进入 `next`。
-- 当前 `1.12.0` 包含 DEC-072 / DEC-073：新增阿里云百炼（workspace + 地域拼端点）与 TokenHub（tokenhub.com；腾讯云 TokenHub 无决策端点）预设，设置页暴露百炼的 Workspace ID / 地域；「免费模型」从独立开关合并为 provider 下拉第一项。`1.11.2` 的 never 回退、`1.11.1` 的 DEC-070、`1.11.0` 的审计修复、`1.10.0` 的五项改动依次见 DEC-062 ~ DEC-071。
+- 当前 `1.13.0` 包含 DEC-074：匿名使用统计的用途/字段/边界重写；连通性测试从页脚前移到连接方式组，同时探测决策端点与回退语言模型，结果按链路分卡展示（摘要 + 可折叠详情）。`1.12.0` 的 DEC-072 / DEC-073、`1.11.2` 的 never 回退、`1.11.1` 的 DEC-070、`1.11.0` 的审计修复、`1.10.0` 的五项改动依次见 DEC-062 ~ DEC-073。
 - checkout 与 setup-vp Action 固定到已核对的 commit SHA；不通过 `pull_request_target` 运行不可信 PR。
 - 验证任务只有 `contents: read`；只有发布 job 有 `id-token: write`。发布 step 只使用 OIDC（trusted publishing），不再读取任何 npm token secret。代码 checkout 不保留 Git 凭据。此工作流不会自动修改版本、提交源码或推送 Git。
 
@@ -58,7 +58,7 @@ Windows 全量测试最近仍有 3 个既有 POSIX 文件权限断言失败；
 授权及完整验证均满足后：
 
 ```powershell
-npm publish ./release-artifacts/leonhardthust-dsh-decision-engine-1.12.0.tgz --registry "https://registry.npmjs.org/" --access public --tag latest
+npm publish ./release-artifacts/leonhardthust-dsh-decision-engine-1.13.0.tgz --registry "https://registry.npmjs.org/" --access public --tag latest
 npm view @leonhardthust/dsh-decision-engine version --registry "https://registry.npmjs.org/" --json
 ```
 
@@ -66,4 +66,4 @@ npm view @leonhardthust/dsh-decision-engine version --registry "https://registry
 
 ## 安装
 
-DSH 插件管理中使用 `@leonhardthust/dsh-decision-engine` 或指定 `@leonhardthust/dsh-decision-engine@1.12.0`。安装和启用是另外的用户动作，发布工作流不会修改本机 DSH profile。
+DSH 插件管理中使用 `@leonhardthust/dsh-decision-engine` 或指定 `@leonhardthust/dsh-decision-engine@1.13.0`。安装和启用是另外的用户动作，发布工作流不会修改本机 DSH profile。

package/lib/client.js

@@ -144,11 +144,15 @@ window.__ModuleLoader__.load({
       "auto｜由服务端决定（实测约 7.2s，比 never 慢）": "auto | decided by the server (measured ~7.2s, slower than never)",
       "always｜总是思考（约 +5s，质量收益未实测）": "always | always think (about +5s; quality gain not measured)",
       // —— 匿名使用统计（DEC-020）——
-      "匿名统计": "Anonymous stats",
+      "匿名使用统计": "Anonymous usage stats",
       "每天上报一次：匿名安装 id、版本、平台与当日决策数": "Reports once a day: anonymous install id, version, platform, and today's decision count",
+      "每天一次，只用于让作者判断插件还有多少人在用、值不值得继续维护：随机安装 ID、插件版本、平台/架构、宿主版本、当天决策次数。不含会话内容、文件路径、密钥、模型名或身份信息。": "Once a day, used only so the author can tell how many people still use the plugin and whether it is worth maintaining: a random install ID, plugin version, platform/arch, host version, and today's decision count. No conversation content, file paths, keys, model names, or identity information.",
       "已关闭：任何情况下都不联网": "Off: never touches the network",
+      "完全关闭：不发送任何请求。": "Fully off: no request is ever sent.",
       "仅首次运行上报一次「安装了」，之后不再联网": "Reports \"installed\" once on first run, then never again",
+      "仅在第一次运行时上报一次「安装了」（字段同上），之后不再联网。": "Reports \"installed\" once on the first run (same fields as above), then never touches the network again.",
       "off（不联网）": "off (no network)",
+      "off（完全关闭）": "off (fully disabled)",
       "install（仅首次）": "install (first run only)",
       "daily（每天一次，默认）": "daily (once a day, default)",
       "auto（先 /decisions）": "auto (/decisions first)",
@@ -188,6 +192,10 @@ window.__ModuleLoader__.load({
       "重试": "Retry",
       "测试中…": "Testing…",
       "测试端点": "Test endpoint",
+      "连通性测试": "Connectivity test",
+      "分别向决策端点与回退语言模型各发一次最小请求；仅在你点击时发生，会消耗少量 token": "Sends one minimal request to the decision endpoint and to the fallback language model. Only when you click; uses a few tokens.",
+      "已跳过": "Skipped",
+      "详情": "Details",
       "未保存：密钥太短（至少 10 个字符）": "Not saved: the key is too short (at least 10 characters)",
       "测试端点失败": "Endpoint test failed",
       // —— 使用免费模型（DEC-030，原名「跟随服务端下发」，DEC-037 改名） ——
@@ -7273,10 +7281,11 @@ window.__ModuleLoader__.load({
         setProviderError("");
         try {
           const result = await call("/test", { method: "POST" });
-          // 服务端返回的整段诊断（provider / 端点 / HTTP 码 / 请求 id / 响应体）
-          // 原样展示：只报「失败」而不给细节，用户无法判断该改地址还是改 key。
+          // DEC-074：服务端现在返回分链路的 `results`（决策端点 / 回退模型），
+          // 界面优先渲染成两张卡片；`text` 只作为旧服务端的兜底与纯文本记录。
           setMsg({
             ok: result.ok === true,
+            results: Array.isArray(result.results) ? result.results : null,
             text: result.ok === true
               ? t("端点连通 ✅\n{text}", { text: result.text ?? "" })
               : tr(result.text ?? "") || t("端点返回失败"),
@@ -7865,6 +7874,109 @@ window.__ModuleLoader__.load({
           ),
           "endpoint",
         ),
+        // 4b2) 连通性测试：从页脚前移到它要验证的对象旁边（provider / 模型 /
+        //      端点 / key 都在上面几行）。一次点击同时测两条链路：决策端点
+        //      （自拼 System One）与回退语言模型（宿主 llm.stream）。结果就
+        //      显示在下面，不再需要滚到页脚找「测试」的结论。
+        row(
+          "连通性测试",
+          t("分别向决策端点与回退语言模型各发一次最小请求；仅在你点击时发生，会消耗少量 token"),
+          h(
+            "button",
+            {
+              type: "button",
+              onClick: runTest,
+              disabled: busy !== "",
+              style: { ...S.saveBtn, flexShrink: 0 },
+            },
+            busy === "test" ? "测试中…" : "测试端点",
+          ),
+          "connectivity",
+        ),
+        msg !== null
+          ? h(
+              "div",
+              {
+                style: { display: "flex", flexDirection: "column", gap: "8px", marginTop: "10px" },
+                key: "test-msg",
+              },
+              // 结构化结果（DEC-074）：每条链路一张小卡片——先给结论（通/不通/
+              // 跳过）+ 一行摘要，原始诊断折叠进「详情」。旧服务端只回 `text`
+              // 时退回整段文本，不至于空白。
+              ...(Array.isArray(msg.results)
+                ? msg.results.map((item) => {
+                    const tone = item.skipped === true ? "#fbbf24" : item.ok === true ? "#4ade80" : "#f87171";
+                    const icon = item.skipped === true ? "–" : item.ok === true ? "✓" : "✕";
+                    return h(
+                      "div",
+                      {
+                        key: `test-${item.key ?? item.label}`,
+                        style: {
+                          border: `1px solid ${tone}55`,
+                          borderRadius: "8px",
+                          padding: "8px 10px",
+                          background: `${tone}0d`,
+                        },
+                      },
+                      h(
+                        "div",
+                        { style: { display: "flex", alignItems: "center", gap: "8px" } },
+                        h("span", { style: { color: tone, fontWeight: 600 } }, icon),
+                        h("span", { style: { fontWeight: 600 } }, item.label),
+                        item.skipped === true
+                          ? h("span", { style: { ...S.meta, marginTop: 0, color: tone } }, t("已跳过"))
+                          : null,
+                      ),
+                      h(
+                        "div",
+                        { style: { ...S.meta, marginTop: "4px", whiteSpace: "pre-wrap", wordBreak: "break-all" } },
+                        item.summary ?? "",
+                      ),
+                      typeof item.detail === "string" && item.detail.length > 0 && item.detail !== item.summary
+                        ? h(
+                            "details",
+                            { style: { marginTop: "4px" } },
+                            h(
+                              "summary",
+                              { style: { cursor: "pointer", ...S.meta, marginTop: 0, opacity: 0.7 } },
+                              t("详情"),
+                            ),
+                            h(
+                              "pre",
+                              {
+                                style: {
+                                  margin: "6px 0 0",
+                                  whiteSpace: "pre-wrap",
+                                  wordBreak: "break-all",
+                                  fontSize: "12px",
+                                  opacity: 0.8,
+                                  fontFamily: "inherit",
+                                },
+                              },
+                              item.detail,
+                            ),
+                          )
+                        : null,
+                    );
+                  })
+                : [
+                    h(
+                      "div",
+                      {
+                        style: {
+                          ...S.meta,
+                          marginTop: 0,
+                          color: msg.ok ? "#4ade80" : "#f87171",
+                          whiteSpace: "pre-wrap",
+                          fontFamily: "inherit",
+                          fontSize: "13px",
+                        },
+                      },
+                      msg.text,
+                    ),
+                  ]),
+            )
+          : null,
         // 4c) 密钥保存位置：默认托管到 .credentials.yaml（DEC-037 从 API Key 紧邻处
         //     下移到这里：它讲的是「这把 key 存到哪个文件」，不是「怎么连上服务」，
         //     夹在连接组中间会打断 provider → 模型 → key → 端点这条阅读线；
@@ -8663,12 +8775,14 @@ window.__ModuleLoader__.load({
         // 放在「思考模式」之后：它同样是「一次性选择、改完即存」的下拉，
         // 与上面的开关/下拉一组，不与 provider 表格混在一起。
         row(
-          "匿名统计",
-          draft.telemetryLevel === "daily"
-            ? "每天上报一次：匿名安装 id、版本、平台与当日决策数"
+          "匿名使用统计",
+          // 与下拉的兜底保持一致：undefined 时下拉显示 daily，说明也必须说 daily，
+          // 否则首帧会出现「选中的是 daily、解释却写仅首次」的自相矛盾。
+          (draft.telemetryLevel ?? "daily") === "daily"
+            ? t("每天一次，只用于让作者判断插件还有多少人在用、值不值得继续维护：随机安装 ID、插件版本、平台/架构、宿主版本、当天决策次数。不含会话内容、文件路径、密钥、模型名或身份信息。")
             : draft.telemetryLevel === "off"
-              ? "已关闭：任何情况下都不联网"
-              : "仅首次运行上报一次「安装了」，之后不再联网",
+              ? t("完全关闭：不发送任何请求。")
+              : t("仅在第一次运行时上报一次「安装了」（字段同上），之后不再联网。"),
           h(
             "select",
             {
@@ -8689,10 +8803,10 @@ window.__ModuleLoader__.load({
                 "option",
                 { key: value, value },
                 value === "off"
-                  ? "off（不联网）"
+                  ? t("off（完全关闭）")
                   : value === "install"
-                    ? "install（仅首次）"
-                    : "daily（每天一次，默认）",
+                    ? t("install（仅首次）")
+                    : t("daily（每天一次，默认）"),
               ),
             ),
           ),
@@ -8701,8 +8815,10 @@ window.__ModuleLoader__.load({
       ];
 
       const footerItems = [
-        // 页脚常驻在所有分组之下：保存状态、测试端点、状态信息与诊断结果。
+        // 页脚常驻在所有分组之下：保存状态与状态信息。
         //   它回答的是「刚才那一下存没存」，与页面哪一组展开无关。
+        //   连通性测试已前移到「连接方式」组（DEC-074）——它要验证的对象都在
+        //   那里，结论也该贴着对象显示。
         // 4g) 自动保存状态行：**没有「保存」按钮**，改动即落盘。
         //    这一行回答的是「刚才那一下到底存没存」：进行中 / 已存 /
         //    失败原因（附重试）。原来那个按钮的「保存中…」搬到这里。
@@ -8755,16 +8871,6 @@ window.__ModuleLoader__.load({
                 "重试",
               )
             : null,
-          h(
-            "button",
-            {
-              type: "button",
-              disabled: busy !== "",
-              onClick: runTest,
-              style: { ...S.saveBtn, background: "transparent", color: "inherit" },
-            },
-            busy === "test" ? "测试中…" : "测试端点",
-          ),
         ),
         // 4h) 状态信息（紧凑）
         h(
@@ -8795,20 +8901,6 @@ window.__ModuleLoader__.load({
               }) + (activeKeyStatus.configured === true ? "" : t("（未读到）"))
             : null,
         ),
-        msg !== null
-          ? h(
-              "div",
-              {
-                style: {
-                  ...S.meta,
-                  marginTop: "10px",
-                  color: msg.ok ? "#4ade80" : "#f87171",
-                },
-                key: "msg",
-              },
-              msg.text,
-            )
-          : null,
       ];
 
       // 配置 tab 的全部内容。

package/lib/index.js

@@ -654,9 +654,10 @@ export const Config = z.object({
     .description("缓存存活时间；改策略或配置后旧裁决不应继续被复用"),
   telemetryLevel: z.union([...TELEMETRY_LEVELS]).default(DEFAULTS.telemetryLevel)
     .description(
-      "匿名使用统计：off 完全不联网 / install 仅首次运行报一次（默认）/ "
-        + "daily 每天报一次（含当日决策数）。只上报插件版本、平台、架构与计数，"
-        + "永不上报 prompt、密钥、路径或会话内容",
+      "匿名使用统计：off 完全不联网 / install 仅首次运行报一次 / daily 每天一次（默认，含当天决策数）。"
+        + "用途只有「判断还有多少人在用、哪些版本与平台在用、值不值得继续维护」；"
+        + "上报随机安装 ID、插件版本、平台/架构、宿主版本与决策计数，"
+        + "永不上报 prompt、密钥、路径、模型名或会话内容",
     ),
   telemetryEndpoint: z.string().default(DEFAULTS.telemetryEndpoint)
     .description("统计上报地址；留空用内置端点（https://dsh.zuos.us/api/e）"),
@@ -3150,6 +3151,108 @@ export function apply(ctx, config) {
     return { ok: false, text: `provider: ${provider.label}（${provider.id}）\nPOST ${usedEndpoint}\n请求失败（${Date.now() - started}ms）` };
   };
 
+  /**
+   * 探测回退语言模型（guardFallback = model 时）。
+   *
+   * 为什么要单独测：决策端点与回退模型是两条完全不同的链路——前者是自己拼的
+   * System One 请求，后者走宿主的 `llm.stream`。决策端点通、回退模型 401 的
+   * 情况完全可能发生；只测前者会让用户以为整套守卫都在工作，而真正需要兜底
+   * 时才发现回退模型不可用。
+   *
+   * 刻意只测「显式指定 provider/model」这一种策略：
+   *   - session 用的是当前会话模型，设置页没有会话上下文，测不了（也不该猜）；
+   *   - allow / deny 根本不调模型，没有可测的链路。
+   *
+   * 这是一次最小的真实模型调用（maxTokens 16），只在用户点「测试」时发生；
+   * 失败/超时都折叠成一段可读诊断，绝不让测试按钮本身抛错。
+   *
+   * @returns `{ ok: boolean|null, skipped?: boolean, text }`；null = 本策略不适用。
+   */
+  const probeFallbackModel = async () => {
+    const policy = cfg.guardFallback;
+    if (policy !== "model") {
+      return {
+        ok: null,
+        skipped: true,
+        text: `回退语言模型: 当前策略为 ${policy}，不调用独立模型（${policy === "session" ? "使用会话当前模型，设置页无法离线测试" : "没有可测的模型链路"}）`,
+      };
+    }
+    const provider = typeof cfg.guardFallbackProvider === "string" ? cfg.guardFallbackProvider.trim() : "";
+    const model = typeof cfg.guardFallbackModel === "string" ? cfg.guardFallbackModel.trim() : "";
+    if (provider.length === 0 || model.length === 0) {
+      return { ok: false, text: "回退语言模型: 策略为 model，但 provider / model 未填全" };
+    }
+    const llm = ctx.get?.("llm");
+    if (typeof llm?.stream !== "function") {
+      return { ok: false, text: "回退语言模型: 宿主未提供 llm.stream，无法测试（请确认 DSH 版本支持该服务）" };
+    }
+    const configuredTimeout = Number.isFinite(cfg.timeoutMs) ? cfg.timeoutMs : 20000;
+    const timeoutMs = Math.max(8000, Math.min(20000, configuredTimeout));
+    const effort = typeof cfg.guardFallbackReasoningEffort === "string" ? cfg.guardFallbackReasoningEffort.trim() : "";
+    const started = Date.now();
+    try {
+      const stream = llm.stream({
+        provider,
+        model,
+        ...(effort.length > 0 ? { reasoningEffort: effort } : {}),
+        // 只要求一个词：这是连通性测试，不是质量评测；输出越短越省钱。
+        messages: [{ role: "user", content: [{ type: "text", text: "Reply with the single word: pong" }] }],
+        tools: [],
+        maxTokens: 16,
+        signal: AbortSignal.timeout(timeoutMs),
+        purpose: "decision-engine-connectivity",
+      });
+      let finish = null;
+      let text = "";
+      for await (const chunk of stream) {
+        if (chunk?.type === "text-delta") text += chunk.text;
+        if (chunk?.type === "finish") finish = chunk.reason?.kind ?? "unknown";
+      }
+      // length 也算连通：模型确实回应了，只是 16 token 被截断（例如它先输出了
+      // 一段思考）。只有「没有 finish 或 finish 不是正常结束」才算失败。
+      const ok = finish === "stop" || finish === "length";
+      return {
+        ok,
+        text:
+          `回退语言模型: ${provider} / ${model}${effort.length > 0 ? `（effort ${effort}）` : ""}\n` +
+          `耗时 ${Date.now() - started}ms　finish: ${finish ?? "(无)"}\n` +
+          `响应: ${text.trim().slice(0, 120) || "(空)"}`,
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        ok: false,
+        text: `回退语言模型: ${provider} / ${model}\n请求失败（${Date.now() - started}ms）: ${message}`,
+      };
+    }
+  };
+
+  /**
+   * 把 probe() 的多行诊断压成一句「人先看这个」的结论。
+   *
+   * 原始输出是给排查用的（request id、尝试过的路径、响应体），但测试按钮的
+   * 第一眼需要一个能判断「通没通、多快」的短句；详情仍然保留，折叠起来。
+   *
+   * @param text - probe() 返回的完整文本。
+   * @returns 一行摘要（不抛错，解析不出来就取前两行）。
+   */
+  const summarizeProbe = (text) => {
+    const lines = String(text ?? "").split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    const provider = lines.find((line) => line.startsWith("provider: "));
+    const post = lines.find((line) => line.startsWith("POST "));
+    const http = lines.find((line) => line.startsWith("HTTP "));
+    const failed = lines.find((line) => line.startsWith("请求失败"));
+    const reason = lines.find((line) => line.startsWith("失败原因: "));
+    const parts = [];
+    if (provider) parts.push(provider.slice("provider: ".length));
+    if (post) parts.push(post);
+    if (http) parts.push(http.replace(/\s+/g, " "));
+    else if (failed) parts.push(failed);
+    if (reason) parts.push(reason.slice("失败原因: ".length));
+    if (parts.length === 0) return lines.slice(0, 2).join(" · ") || "（无结果）";
+    return parts.join(" · ");
+  };
+
   // ---- 面板 API：给前端 UI 用（不经过 settings 服务）-------------------------
   ctx.inject?.(["connection"], () => {
     const connection = ctx.get?.("connection");
@@ -3847,8 +3950,42 @@ export function apply(ctx, config) {
       methods: ["POST"],
       requestBody: "buffered",
       fetch: async () => {
-        const result = await probe();
-        return json({ ok: result.ok, text: result.text });
+        // 两条链路各测一次：决策端点是自拼的 System One 请求，回退模型走宿主
+        // 的 llm.stream。只测前者会让「决策端点通、回退模型不可用」被误报成
+        // 整体健康——而回退模型恰好是审批通道不可用时的兜底裁判。
+        const decision = await probe();
+        await reloadOwnConfig();
+        const fallback = await probeFallbackModel();
+        // fallback.ok 为 null 表示该策略不适用（session / allow / deny），
+        // 不能把「没有这条链路」算成失败；但明确失败（false）必须让整体变红。
+        const ok = decision.ok === true && fallback.ok !== false;
+        // 给界面一份结构化结果：每条链路一个短摘要 + 可折叠的原始诊断。
+        // 摘要与详情分开，是因为用户第一眼只需要「通没通、多快」，排查时才
+        // 展开 request id / 响应体。
+        const results = [
+          {
+            key: "decision",
+            label: "决策端点",
+            ok: decision.ok === true,
+            skipped: false,
+            summary: summarizeProbe(decision.text),
+            detail: decision.text,
+          },
+          {
+            key: "fallback",
+            label: "回退语言模型",
+            ok: fallback.ok,
+            skipped: fallback.skipped === true,
+            summary: fallback.text,
+            detail: fallback.detail ?? null,
+          },
+        ];
+        return json({
+          ok,
+          // `text` 保留给旧前端/日志：纯文本仍然可读。
+          text: [decision.text, fallback.text].filter((line) => typeof line === "string" && line.length > 0).join("\n\n"),
+          results,
+        });
       },
     });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leonhardthust/dsh-decision-engine",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "dsh-decision-engine: a cheap judgement layer for DeepSeek Harness — a small decision model answers structured questions before the main model acts, so calls can be allowed, escalated, rerouted to a cheaper model, or skipped. All eight decision points (tool authorization, model routing, delegation, compaction, turn continuation, retrieval, skill pick, COT translation) are implemented and individually switchable. Works against any service exposing a decision endpoint: built-in presets (system one, bamboonode, SiliconFlow, Silicon Flow) or a custom base URL.",
   "icon": "./icon.svg",
   "type": "module",