@ljwei-stak/dsh-model-router 0.16.1 → 0.16.3

package/.dsh-plugin/client.js

@@ -1876,33 +1876,72 @@ function ModelProfileEditor({ routes, settingsScope, onSaved }) {
   } }, "\u5220\u9664\u6B64\u6A21\u578B\u914D\u7F6E")), notice && /* @__PURE__ */ import_react.default.createElement("p", { className: notice.tone === "error" ? "mr-error" : "mr-profile-success", role: notice.tone === "error" ? "alert" : "status" }, notice.text), /* @__PURE__ */ import_react.default.createElement("p", { className: "mr-caption" }, "\u8D28\u91CF\u8BC4\u5206\u548C\u4EF7\u683C\u90FD\u662F\u7528\u6237\u63D0\u4F9B\u7684\u4F30\u503C\u3002\u672A\u586B\u5199\u5355\u4EF7\u65F6\u663E\u793A\u201C\u4EF7\u683C\u5F85\u914D\u7F6E\u201D\uFF1B\u9884\u7B97\u53EA\u5F71\u54CD\u672C\u5730\u89C4\u5212\uFF0C\u4E0D\u9650\u5236\u5B9E\u9645\u8D26\u5355\u3002CLI \u6A21\u578B\u540D\u987B\u4E0E\u5382\u5546\u5DE5\u5177\u6838\u5BF9\u3002\u6267\u884C\u65B9\u5F0F\u51B3\u5B9A\u8BE5\u6A21\u578B\u6536\u5230\u4EFB\u52A1\u65F6\u8D70\u5B98\u65B9\u65E0\u754C\u9762\u5DE5\u5177\u8FD8\u662F\u6A21\u578B\u76EE\u5F55 API\uFF1B\u5B98\u65B9\u5DE5\u5177\u5931\u8D25\u65F6\u4ECD\u4F1A\u56DE\u9000 API\u3002\u8BA1\u8D39\u65B9\u5F0F\u9ED8\u8BA4\u8BA2\u9605\u4F18\u5148\uFF1A\u5148\u7528 CLI \u8D26\u53F7\u767B\u5F55\u6216\u7F16\u7A0B\u5957\u9910 Key \u8DEF\u7EBF\uFF0C\u8BA2\u9605\u989D\u5EA6\u7528\u5C3D\u6216\u9650\u6D41\u65F6\u540C\u4E00\u6B65\u9AA4\u81EA\u52A8\u6539\u7528 API Key\uFF0C\u5E76\u8BB0\u5165\u8FD0\u884C\u5386\u53F2\u3002"))));
 }
 
-// .dsh-plugin/client/tool-install-state.mjs
-function stableVersionOrder(left, right) {
-  const parse = (value) => /^([0-9]+)\.([0-9]+)\.([0-9]+)$/.exec(String(value ?? ""));
-  const current = parse(left);
-  const target = parse(right);
-  if (!current || !target) return null;
-  for (let index = 1; index <= 3; index += 1) {
-    const delta = Number(current[index]) - Number(target[index]);
-    if (delta) return Math.sign(delta);
+// .dsh-plugin/shared/version-order.mjs
+var VERSION = /^(\d{1,6})\.(\d{1,6})\.(\d{1,6})(?:-[0-9A-Za-z.-]{1,64})?$/;
+function compareReleaseVersions(left, right) {
+  const parse = (value) => {
+    const match = VERSION.exec(String(value ?? ""));
+    return match ? { parts: match.slice(1, 4).map(Number), pre: String(value).includes("-") } : null;
+  };
+  const a = parse(left);
+  const b2 = parse(right);
+  if (!a || !b2) return null;
+  for (let index = 0; index < 3; index += 1) {
+    if (a.parts[index] !== b2.parts[index]) return a.parts[index] > b2.parts[index] ? 1 : -1;
   }
+  if (a.pre !== b2.pre) return a.pre ? -1 : 1;
   return 0;
 }
+
+// .dsh-plugin/client/tool-install-state.mjs
 function toolInstallAction({ tool, probe, readiness, job, probeStatus, latestVersion = null }) {
   const running = job?.status === "running";
   const installed = probe?.installed === true;
-  const order = installed && latestVersion ? stableVersionOrder(probe.version, latestVersion) : null;
-  const ready = readiness?.ready === true;
+  const order = installed && latestVersion ? compareReleaseVersions(probe.version, latestVersion) : null;
   const desktop = tool.manager === "signed-windows-installer";
   const noRunner = desktop || tool.headlessAdapter === true;
-  const repair = installed && !noRunner && readiness?.ready === false;
+  const repair = installed && !noRunner && readiness?.ready === false && order !== 0;
   const label = running ? "\u5B89\u88C5\u4E2D\u2026" : !installed ? job?.status === "failed" ? "\u91CD\u8BD5\u5B89\u88C5" : desktop ? "\u4E0B\u8F7D\u6700\u65B0\u5B89\u88C5\u5668" : "\u4E00\u952E\u5B89\u88C5\u6700\u65B0\u7248" : order === -1 ? `\u66F4\u65B0\u5230\u6700\u65B0\u7248 ${latestVersion}` : order === 1 ? "\u5DF2\u9AD8\u4E8E\u6700\u65B0\u6B63\u5F0F\u7248" : repair ? "\u4FEE\u590D\u5B98\u65B9\u6267\u884C\u5165\u53E3" : order === 0 ? "\u5DF2\u662F\u6700\u65B0\u7248\u672C" : "\u5B89\u88C5\u6700\u65B0\u7248";
-  const current = order === 0 && (ready || noRunner);
+  const current = order === 0;
+  const interactive = probeStatus === "ready" || probeStatus === "refreshing";
   return {
     label,
-    disabled: probeStatus !== "ready" || running || installed && (order === 1 || current)
+    disabled: !interactive || running || installed && (order === 1 || current)
   };
 }
+function installClickRefusal({ tool, submitting = false, running = false } = {}) {
+  if (!tool) return "\u672A\u77E5\u5B98\u65B9\u5DE5\u5177\uFF0C\u65E0\u6CD5\u5F00\u59CB\u5B89\u88C5\u3002";
+  if (tool.unsupported) return String(tool.unsupportedReason ?? "").trim() || "\u6B64\u5DE5\u5177\u6682\u4E0D\u652F\u6301\u4E00\u952E\u5B89\u88C5\u3002";
+  if (submitting || running) return "\u8BE5\u5DE5\u5177\u6B63\u5728\u5B89\u88C5\uFF0C\u8BF7\u7B49\u5F85\u5F53\u524D\u4EFB\u52A1\u7ED3\u675F\u3002";
+  return "";
+}
+function payloadError(payload, fallback) {
+  if (!payload || typeof payload !== "object") return fallback;
+  if (typeof payload.error === "string" && payload.error.trim()) return payload.error.trim();
+  const message = payload.error?.message;
+  if (typeof message === "string" && message.trim()) return message.trim();
+  return fallback;
+}
+function acceptedInstallJob(response) {
+  const fallback = "\u5B89\u88C5\u4EFB\u52A1\u672A\u88AB\u63A5\u53D7\u3002";
+  if (!response || typeof response !== "object") return { job: null, error: fallback };
+  let payload = response;
+  if (payload.ok === false) return { job: null, error: payloadError(payload, fallback) };
+  if (payload.ok === true && payload.value && typeof payload.value === "object") {
+    payload = payload.value;
+    if (payload.ok === false) return { job: null, error: payloadError(payload, fallback) };
+    if (payload.ok === true && payload.value && typeof payload.value === "object") payload = payload.value;
+  }
+  if (payload.accepted === true && payload.job && typeof payload.job === "object") return { job: payload.job, error: "" };
+  return { job: null, error: payloadError(payload, fallback) };
+}
+function shouldApplyInstallStatus(localJob, remoteJob) {
+  if (!remoteJob || typeof remoteJob !== "object") return false;
+  const localStarted = typeof localJob?.startedAt === "string" ? localJob.startedAt : "";
+  const remoteStarted = typeof remoteJob.startedAt === "string" ? remoteJob.startedAt : "";
+  if (!localStarted || !remoteStarted) return true;
+  return remoteStarted >= localStarted;
+}
 
 // .dsh-plugin/client/router-insights.jsx
 var import_react2 = __toESM(require("react"), 1);
@@ -12115,7 +12154,7 @@ var xterm_default = `/**
 `;
 
 // .dsh-plugin/client/host-version.mjs
-var ROUTER_CLIENT_VERSION = true ? "0.16.1" : "";
+var ROUTER_CLIENT_VERSION = true ? "0.16.3" : "";
 var STALE_HOST_MESSAGE = "\u63D2\u4EF6\u540E\u53F0\u7248\u672C\u8F83\u65E7\uFF0C\u8BF7\u5B8C\u5168\u9000\u51FA\u5E76\u91CD\u542F Harness\uFF08\u5305\u62EC\u6258\u76D8\u56FE\u6807\uFF09\u540E\u518D\u4F7F\u7528\u3002";
 function isMissingRemoteMethod(message) {
   const value = String(message ?? "");
@@ -12921,7 +12960,10 @@ function PlanResults({ plan, ledger, headingRef }) {
   const purposeLabel = { analysis: "\u4EFB\u52A1\u5206\u6790", execution: "\u4EFB\u52A1\u5B9E\u65BD", verification: "\u72EC\u7ACB\u9A8C\u8BC1", synthesis: "\u7ED3\u679C\u6574\u5408" };
   return /* @__PURE__ */ import_react5.default.createElement("section", { className: "mr-card mr-results", "aria-label": "\u8DEF\u7531\u5EFA\u8BAE" }, /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-card-head" }, /* @__PURE__ */ import_react5.default.createElement("div", null, /* @__PURE__ */ import_react5.default.createElement("h2", { className: "mr-card-title", ref: headingRef, tabIndex: -1 }, "\u8DEF\u7531\u5EFA\u8BAE"), /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-card-copy" }, "\u672C\u5730\u8BA1\u7B97\u5B8C\u6210\uFF0C\u672A\u5411\u6A21\u578B\u53D1\u9001\u4EFB\u52A1\u5185\u5BB9\u3002"))), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-card-body" }, /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-result-grid" }, /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric" }, /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric-label" }, "\u63A8\u8350\u8DEF\u7EBF"), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric-value" }, selected ? `${selected.provider}/${selected.model}` : "\u6682\u65E0\u8DEF\u7EBF")), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric" }, /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric-label" }, "\u4EFB\u52A1\u590D\u6742\u5EA6 \xB7 \u5206\u503C\uFF080\u20131\uFF09"), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric-value" }, { simple: "\u7B80\u5355", balanced: "\u4E2D\u7B49", complex: "\u590D\u6742" }[plan.complexity.band] || plan.complexity.band, " \xB7 ", plan.complexity.value)), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric" }, /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric-label" }, "\u4F30\u7B97\u603B\u6210\u672C"), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric-value" }, money2(plan.estimatedCost))), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric" }, /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric-label" }, "\u8DEF\u7531\u65B9\u6848"), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-metric-value" }, ROUTING_PRESETS[plan.preset]?.label ?? "\u5747\u8861"))), budget?.exceeded && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-error", role: "alert" }, "\u6267\u884C\u524D\u9884\u7B97\u68C0\u67E5\uFF1A", budget.message, " \u5B9E\u9645\u6267\u884C\u65F6\u5C06\u6309\u8BBE\u7F6E\u81EA\u52A8\u964D\u7EA7\u6216\u6682\u505C\u8BE2\u95EE\u3002"), budget?.limited && !budget.exceeded && budget.estimateKnown && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-caption" }, "\u6267\u884C\u524D\u9884\u7B97\u68C0\u67E5\uFF1A\u672C\u6B21\u9884\u4F30 ", money2(plan.estimatedCost), "\uFF0C\u5269\u4F59\u989D\u5EA6 ", money2(budget.remainingUsd), "\u3002"), plan.loginRequired && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-caption" }, "\u63A8\u8350\u6A21\u578B\u7684\u5B98\u65B9 CLI \u672A\u767B\u5F55\uFF0C\u6267\u884C\u65F6\u76F4\u63A5\u8D70\u6A21\u578B\u76EE\u5F55 API\uFF1B\u53EF\u5728\u201C\u5B98\u65B9\u5DE5\u5177\u201D\u5361\u7247\u70B9\u201C\u53BB\u767B\u5F55\u201D\u3002"), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-channel-line" }, /* @__PURE__ */ import_react5.default.createElement("span", { className: "mr-control-label" }, "\u6267\u884C\u6E20\u9053"), /* @__PURE__ */ import_react5.default.createElement(ChannelBadge, { item: plan })), /* @__PURE__ */ import_react5.default.createElement("details", { className: "mr-plan-explanation" }, /* @__PURE__ */ import_react5.default.createElement("summary", null, "\u67E5\u770B\u89C4\u5212\u4F9D\u636E\u4E0E\u4F30\u7B97\u8BF4\u660E"), /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-caption" }, plan.reason), /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-caption" }, plan.pricingNotice, " ", plan.qualityNotice, " ", plan.availabilityNotice, " ", plan.modalityNotice || "")), plan.optimization.budgetExceeded && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-error" }, "\u6309\u5DF2\u63D0\u4F9B\u5355\u4EF7\u4F30\u7B97\uFF0C\u4EFB\u52A1\u53EF\u80FD\u8D85\u8FC7\u672C\u6B21\u9884\u7B97\u3002\u9884\u7B97\u53EA\u5F71\u54CD\u5EFA\u8BAE\uFF0C\u4E0D\u4F1A\u963B\u6B62\u5B9E\u9645\u6263\u8D39\u3002"), plan.mode === "team" && /* @__PURE__ */ import_react5.default.createElement(import_react5.default.Fragment, null, /* @__PURE__ */ import_react5.default.createElement("h3", { className: "mr-section-title" }, "\u56E2\u961F\u5DE5\u4F5C\u5305"), /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-caption" }, "\u4E0B\u65B9\u6A21\u578B\u662F\u89C4\u5212\u5EFA\u8BAE\uFF1B\u6258\u7BA1\u6267\u884C\u4F1A\u6309\u5382\u5546 CLI \u7684\u6A21\u578B\u540D\u89C4\u5219\u9009\u7528\uFF0C\u672A\u6838\u9A8C\u6620\u5C04\u65F6\u4F7F\u7528\u8BE5 CLI \u7684\u9ED8\u8BA4\u6A21\u578B\u3002"), plan.team.workPackages.length > 1 && /* @__PURE__ */ import_react5.default.createElement(DagView, { packages: plan.team.workPackages, label: "\u5DE5\u4F5C\u5305\u4F9D\u8D56\u56FE", renderNode: (item) => /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-package-route" }, item.recommendedProvider, "/", item.recommendedModel) }), plan.team.workPackages.length === 0 ? /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-empty" }, "\u5F53\u524D\u76EE\u5F55\u6CA1\u6709\u53EF\u5206\u914D\u7684\u6A21\u578B\u8DEF\u7EBF\u3002") : plan.team.workPackages.map((item, index) => /* @__PURE__ */ import_react5.default.createElement("details", { className: "mr-package mr-package-details", key: item.id }, /* @__PURE__ */ import_react5.default.createElement("summary", null, /* @__PURE__ */ import_react5.default.createElement("span", { className: "mr-package-name" }, index + 1, ". ", item.name), /* @__PURE__ */ import_react5.default.createElement("span", { className: "mr-package-route" }, item.recommendedProvider, "/", item.recommendedModel)), item.objective && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-package-copy" }, "\u5177\u4F53\u76EE\u6807\uFF1A", item.objective), /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-package-copy" }, purposeLabel[item.purpose] ?? item.purpose, item.dependsOn.length > 0 ? ` \xB7 \u4F9D\u8D56\uFF1A${item.dependsOn.map((id2) => packageNames.get(id2) ?? id2).join("\u3001")}` : ""), /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-package-copy" }, "\u96BE\u5EA6\uFF1A", { simple: "\u7B80\u5355", balanced: "\u4E2D\u7B49", complex: "\u56F0\u96BE" }[item.difficulty] || item.difficulty || "\u5F85\u8BC4\u4F30", " \xB7 \u8D39\u7528\uFF1A", money2(item.estimatedCost)), /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-package-copy" }, "\u9A8C\u6536\uFF1A", item.verificationChecklist.join("\uFF1B")), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-channel-line" }, /* @__PURE__ */ import_react5.default.createElement(ChannelBadge, { item }), item.loginRequired && /* @__PURE__ */ import_react5.default.createElement("span", { className: "mr-pill" }, "CLI \u672A\u767B\u5F55")), item.channelDetail && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-package-copy" }, "\u6E20\u9053\u8BF4\u660E\uFF1A", item.channelDetail)))), plan.routingBypassed && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-caption" }, "\u5DF2\u6307\u5B9A\u5355\u4E00\u6A21\u578B\uFF0C\u672A\u4E0E\u5176\u4ED6\u8DEF\u7EBF\u6BD4\u8F83\u3002\u5728\u5B98\u65B9\u4F1A\u8BDD\u4E2D\u8C03\u7528 ", /* @__PURE__ */ import_react5.default.createElement("code", null, "model_router_execute"), " \u5E76\u4F20\u5165\u8BE5 provider \u4E0E model \u5373\u53EF\u76F4\u63A5\u6267\u884C\uFF1B\u82E5\u8BE5\u6A21\u578B\u5141\u8BB8\u5B98\u65B9\u5DE5\u5177\uFF0C\u4F1A\u4F18\u5148\u4F7F\u7528\u5BF9\u5E94 CLI\u3002"), plan.mode === "team" && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-caption" }, plan.team.handoff)));
 }
-var remoteError = (response, fallback) => text5(response?.error?.message) || text5(response?.value?.error) || fallback;
+var remoteError = (response, fallback) => remoteErrorText(
+  text5(response?.error?.message) || text5(response?.value?.error) || (typeof response?.error === "string" ? response.error : ""),
+  fallback
+);
 function probeLabel(probe) {
   if (!probe) return "\u5C1A\u672A\u68C0\u6D4B";
   if (probe.installed) return `\u5DF2\u5B89\u88C5${probe.version ? ` \xB7 ${probe.version}` : ""}`;
@@ -12939,10 +12981,22 @@ function OfficialToolsCard({ listOfficialTools, installOfficialTool, cancelOffic
   const request = import_react5.default.useRef(0);
   const submitting = import_react5.default.useRef(/* @__PURE__ */ new Set());
   const polling = import_react5.default.useRef(/* @__PURE__ */ new Set());
+  const jobsRef = import_react5.default.useRef({});
+  const rememberJobs = (updater) => {
+    setJobs((previous) => {
+      const next = typeof updater === "function" ? updater(previous) : updater;
+      jobsRef.current = next;
+      return next;
+    });
+  };
   const refresh = async () => {
     onRefreshHealth?.();
     const current = ++request.current;
-    setProbeState((previous) => ({ ...previous, status: "loading", error: "" }));
+    setProbeState((previous) => ({
+      ...previous,
+      status: previous.probes.length > 0 ? "refreshing" : "loading",
+      error: ""
+    }));
     try {
       if (typeof listOfficialTools !== "function") throw new Error("\u5B98\u65B9\u5DE5\u5177\u5B89\u88C5\u6865\u5C1A\u672A\u52A0\u8F7D\u3002");
       const response = await listOfficialTools();
@@ -12955,8 +13009,16 @@ function OfficialToolsCard({ listOfficialTools, installOfficialTool, cancelOffic
       onProbes({ probes, capabilities, readiness, hostVersion: typeof response.value?.hostVersion === "string" ? response.value.hostVersion : null });
     } catch (error) {
       if (!mounted.current || current !== request.current) return;
-      setProbeState({ status: "error", probes: [], capabilities: [], readiness: [], error: text5(error?.message) || "\u65E0\u6CD5\u68C0\u6D4B\u5B98\u65B9\u5DE5\u5177\u3002" });
-      onProbes({ probes: [], capabilities: [], readiness: [] });
+      const message = remoteErrorText(text5(error?.message), "\u65E0\u6CD5\u68C0\u6D4B\u5B98\u65B9\u5DE5\u5177\u3002");
+      let kept = false;
+      setProbeState((previous) => {
+        if (previous.probes.length > 0) {
+          kept = true;
+          return { ...previous, status: "ready", error: message };
+        }
+        return { status: "error", probes: [], capabilities: [], readiness: [], error: message };
+      });
+      if (!kept) onProbes({ probes: [], capabilities: [], readiness: [] });
     }
   };
   import_react5.default.useEffect(() => {
@@ -12971,7 +13033,16 @@ function OfficialToolsCard({ listOfficialTools, installOfficialTool, cancelOffic
           return null;
         }
       })).then((entries) => {
-        if (mounted.current) setJobs((previous) => ({ ...Object.fromEntries(entries.filter(Boolean)), ...previous }));
+        if (!mounted.current) return;
+        rememberJobs((previous) => {
+          const next = { ...previous };
+          for (const entry of entries) {
+            if (!entry) continue;
+            const [id2, job] = entry;
+            if (shouldApplyInstallStatus(previous[id2], job)) next[id2] = job;
+          }
+          return next;
+        });
       });
     }
     return () => {
@@ -12991,12 +13062,20 @@ function OfficialToolsCard({ listOfficialTools, installOfficialTool, cancelOffic
         if (!listening || !mounted.current) return;
         if (!response?.ok) throw new Error(remoteError(response, "\u65E0\u6CD5\u83B7\u53D6\u5B89\u88C5\u8FDB\u5EA6\u3002"));
         const job = response.value?.job;
-        if (!job) throw new Error("\u5B89\u88C5\u4EFB\u52A1\u72B6\u6001\u6682\u4E0D\u53EF\u7528\u3002");
-        setJobs((previous) => ({ ...previous, [id2]: job }));
-        setRowErrors((previous) => ({ ...previous, [id2]: "" }));
+        const local = jobsRef.current[id2];
+        if (!job) {
+          if (local?.status === "running") return;
+          throw new Error("\u5B89\u88C5\u4EFB\u52A1\u72B6\u6001\u6682\u4E0D\u53EF\u7528\u3002");
+        }
+        if (!shouldApplyInstallStatus(local, job)) return;
+        rememberJobs((previous) => shouldApplyInstallStatus(previous[id2], job) ? { ...previous, [id2]: job } : previous);
+        setRowErrors((previous) => ({
+          ...previous,
+          [id2]: job.status === "failed" ? text5(job.error) || "\u5B89\u88C5\u5931\u8D25\u3002" : ""
+        }));
         if (job.status !== "running") void refresh();
       } catch (error) {
-        if (listening && mounted.current) setRowErrors((previous) => ({ ...previous, [id2]: text5(error?.message) || "\u5B89\u88C5\u72B6\u6001\u8BFB\u53D6\u5931\u8D25\uFF0C\u5C06\u7EE7\u7EED\u91CD\u8BD5\u3002" }));
+        if (listening && mounted.current) setRowErrors((previous) => ({ ...previous, [id2]: remoteErrorText(text5(error?.message), "\u5B89\u88C5\u72B6\u6001\u8BFB\u53D6\u5931\u8D25\uFF0C\u5C06\u7EE7\u7EED\u91CD\u8BD5\u3002") }));
       } finally {
         polling.current.delete(id2);
       }
@@ -13011,21 +13090,43 @@ function OfficialToolsCard({ listOfficialTools, installOfficialTool, cancelOffic
   }, [jobs, officialToolInstallStatus]);
   const install = async (id2) => {
     const tool = OFFICIAL_TOOLS.find((item) => item.id === id2);
-    if (!tool || tool.unsupported || submitting.current.has(id2) || jobs[id2]?.status === "running") return;
+    const refusal = installClickRefusal({
+      tool,
+      submitting: submitting.current.has(id2),
+      running: jobsRef.current[id2]?.status === "running"
+    });
+    if (refusal) {
+      setRowErrors((previous) => ({ ...previous, [id2]: refusal }));
+      return;
+    }
     submitting.current.add(id2);
+    const startedAt = (/* @__PURE__ */ new Date()).toISOString();
     setRowErrors((previous) => ({ ...previous, [id2]: "" }));
-    setJobs((previous) => ({ ...previous, [id2]: { tool: id2, status: "running", outputTail: [] } }));
+    rememberJobs((previous) => ({
+      ...previous,
+      [id2]: { tool: id2, status: "running", outputTail: [], startedAt, error: null }
+    }));
     try {
       if (typeof installOfficialTool !== "function") throw new Error("\u5B98\u65B9\u5DE5\u5177\u5B89\u88C5\u6865\u5C1A\u672A\u52A0\u8F7D\u3002");
       const response = await installOfficialTool(id2);
       if (!mounted.current) return;
-      if (!response?.ok || !response.value?.accepted || !response.value?.job) throw new Error(remoteError(response, "\u5B89\u88C5\u4EFB\u52A1\u672A\u88AB\u63A5\u53D7\u3002"));
-      setJobs((previous) => ({ ...previous, [id2]: response.value.job }));
+      const accepted = acceptedInstallJob(response);
+      if (!accepted.job) throw new Error(remoteErrorText(accepted.error, "\u5B89\u88C5\u4EFB\u52A1\u672A\u88AB\u63A5\u53D7\u3002"));
+      rememberJobs((previous) => shouldApplyInstallStatus(previous[id2], accepted.job) ? { ...previous, [id2]: accepted.job } : previous);
     } catch (error) {
-      if (mounted.current) {
-        setJobs((previous) => ({ ...previous, [id2]: { tool: id2, status: "failed", error: text5(error?.message) || "\u5B89\u88C5\u542F\u52A8\u5931\u8D25\u3002" } }));
-        setRowErrors((previous) => ({ ...previous, [id2]: text5(error?.message) || "\u5B89\u88C5\u542F\u52A8\u5931\u8D25\u3002" }));
-      }
+      if (!mounted.current) return;
+      const message = remoteErrorText(text5(error?.message), "\u5B89\u88C5\u542F\u52A8\u5931\u8D25\u3002");
+      rememberJobs((previous) => ({
+        ...previous,
+        [id2]: {
+          ...previous[id2] ?? {},
+          tool: id2,
+          status: "failed",
+          error: message,
+          startedAt: previous[id2]?.startedAt || startedAt
+        }
+      }));
+      setRowErrors((previous) => ({ ...previous, [id2]: message }));
     } finally {
       submitting.current.delete(id2);
     }
@@ -13037,7 +13138,7 @@ function OfficialToolsCard({ listOfficialTools, installOfficialTool, cancelOffic
       const response = await cancelOfficialToolInstall(id2);
       if (!mounted.current) return;
       if (!response?.ok || !response.value?.accepted || !response.value?.job) throw new Error(remoteError(response, "\u53D6\u6D88\u8BF7\u6C42\u672A\u88AB\u63A5\u53D7\u3002"));
-      setJobs((previous) => ({ ...previous, [id2]: response.value.job }));
+      rememberJobs((previous) => ({ ...previous, [id2]: response.value.job }));
       if (response.value.job.status !== "running") void refresh();
     } catch (error) {
       if (mounted.current) setRowErrors((previous) => ({ ...previous, [id2]: text5(error?.message) || "\u65E0\u6CD5\u53D6\u6D88\u5B89\u88C5\u3002" }));
@@ -13048,7 +13149,7 @@ function OfficialToolsCard({ listOfficialTools, installOfficialTool, cancelOffic
   const readinessById = Object.fromEntries(probeState.readiness.map((item) => [item.id, item]));
   return /* @__PURE__ */ import_react5.default.createElement("section", { className: "mr-card", "aria-label": "\u5B98\u65B9\u5DE5\u5177" }, /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-card-head" }, /* @__PURE__ */ import_react5.default.createElement("div", null, /* @__PURE__ */ import_react5.default.createElement("h2", { className: "mr-card-title" }, "\u5B98\u65B9\u5DE5\u5177 \xB7 \u4F53\u68C0"), /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-card-copy" }, "\u68C0\u6D4B\u672C\u673A\u5B98\u65B9\u5DE5\u5177\u7684\u5B89\u88C5\u3001\u7248\u672C\u548C\u767B\u5F55\u72B6\u6001\uFF0C\u5E76\u4ECE\u56FA\u5B9A\u6CE8\u518C\u8868\u4E00\u952E\u5B89\u88C5\u6216\u66F4\u65B0\u5230\u5404\u5382\u5546\u6700\u65B0\u7248\uFF08\u65B0\u7248\u672C\u672A\u7ECF\u63D2\u4EF6\u6D4B\u8BD5\uFF09\u3002\u672A\u767B\u5F55\u7684\u5DE5\u5177\u70B9\u201C\u53BB\u767B\u5F55\u201D\u67E5\u770B\u767B\u5F55\u547D\u4EE4\u3002ZCode \u4F1A\u6253\u5F00\u5B98\u65B9\u5B89\u88C5\u7A97\u53E3\u4F9B\u4F60\u9009\u62E9\u76EE\u5F55\uFF1B\u5B8C\u6210\u540E\u91CD\u65B0\u4F53\u68C0\u3002")), /* @__PURE__ */ import_react5.default.createElement("button", { className: "mr-button mr-button-secondary", type: "button", disabled: probeState.status === "loading", onClick: () => {
     void refresh();
-  } }, "\u91CD\u65B0\u4F53\u68C0")), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-card-body" }, probeState.status === "loading" && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-empty", role: "status" }, "\u6B63\u5728\u68C0\u6D4B\u672C\u673A\u5B98\u65B9\u5DE5\u5177\u2026"), probeState.status === "error" && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-error", role: "alert" }, probeState.error), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-tools", role: "list", "aria-label": "\u5B98\u65B9\u5DE5\u5177\u6CE8\u518C\u8868" }, OFFICIAL_TOOLS.map((tool) => {
+  } }, "\u91CD\u65B0\u4F53\u68C0")), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-card-body" }, probeState.status === "loading" && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-empty", role: "status" }, "\u6B63\u5728\u68C0\u6D4B\u672C\u673A\u5B98\u65B9\u5DE5\u5177\u2026"), probeState.error && /* @__PURE__ */ import_react5.default.createElement("p", { className: "mr-error", role: "alert" }, probeState.error), /* @__PURE__ */ import_react5.default.createElement("div", { className: "mr-tools", role: "list", "aria-label": "\u5B98\u65B9\u5DE5\u5177\u6CE8\u518C\u8868" }, OFFICIAL_TOOLS.map((tool) => {
     const command = installCommandLine(tool);
     const probe = byId[tool.id];
     const capability = capabilitiesById[tool.id];

package/.dsh-plugin/official-tools-remote-service.mjs

@@ -81,9 +81,14 @@ export class OfficialToolsRemoteService extends TypertRemoteService {
   /** Re-probe the local fixed registry; the caller cannot supply a command. */
   async list() {
     const tools = await probeAllTools({ fresh: true })
-    const executionReadiness = await Promise.all(tools.map(tool => tool.installed
-      ? officialToolReadiness(tool.id)
-      : Promise.resolve({ id: tool.id, ready: false, reason: 'CLI 尚未安装或版本检测失败。' })))
+    const executionReadiness = await Promise.all(tools.map(async tool => {
+      if (!tool.installed) return { id: tool.id, ready: false, reason: 'CLI 尚未安装或版本检测失败。' }
+      try {
+        return await officialToolReadiness(tool.id)
+      } catch (error) {
+        return { id: tool.id, ready: false, reason: `执行入口检测失败：${String(error?.message ?? error).slice(0, 200)}` }
+      }
+    }))
     return { tools, executionCapabilities: officialToolExecutionCapabilities(), executionReadiness, hostVersion: HOST_PLUGIN_VERSION }
   }
 

package/.dsh-plugin/shared/latest-versions.mjs

@@ -12,6 +12,9 @@ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises'
 import { dirname, join } from 'node:path'
 import { resolveStateHome } from './router-state.mjs'
 import { OFFICIAL_TOOLS } from './official-tool-registry.mjs'
+import { compareReleaseVersions, isReleaseVersion } from './version-order.mjs'
+
+export { compareReleaseVersions, isReleaseVersion } from './version-order.mjs'
 
 export const LATEST_CACHE_MS = 12 * 60 * 60_000
 export const LATEST_FAILURE_RETRY_MS = 30 * 60_000
@@ -19,27 +22,6 @@ export const LATEST_TIMEOUT_MS = 5_000
 export const NPM_REGISTRY = 'https://registry.npmjs.org'
 export const ZCODE_DOWNLOAD_PAGE = 'https://zcode.z.ai/en/docs/install'
 const MAX_DOCUMENT_BYTES = 2_000_000
-const VERSION = /^(\d{1,6})\.(\d{1,6})\.(\d{1,6})(?:-[0-9A-Za-z.-]{1,64})?$/
-
-export function isReleaseVersion(value) {
-  return typeof value === 'string' && VERSION.test(value)
-}
-
-/** Numeric comparison of x.y.z[-pre]; a prerelease sorts below its release. */
-export function compareReleaseVersions(left, right) {
-  const parse = value => {
-    const match = VERSION.exec(String(value ?? ''))
-    return match ? { parts: match.slice(1, 4).map(Number), pre: String(value).includes('-') } : null
-  }
-  const a = parse(left)
-  const b = parse(right)
-  if (!a || !b) return null
-  for (let index = 0; index < 3; index += 1) {
-    if (a.parts[index] !== b.parts[index]) return a.parts[index] > b.parts[index] ? 1 : -1
-  }
-  if (a.pre !== b.pre) return a.pre ? -1 : 1
-  return 0
-}
 
 /** True only when both versions parse and the latest is strictly newer. */
 export function updateAvailable(installed, latest) {

package/.dsh-plugin/shared/official-tool-executor.mjs

@@ -171,6 +171,42 @@ function versionAtLeast(value, minimum) {
   return true
 }
 
+/** Relative bin path inside a package. Reject `..` and empty segments. */
+export function normalizeRelativeBin(value) {
+  const text = String(value ?? '').trim().replace(/\\/g, '/').replace(/^\.\//, '')
+  if (!text || text.split('/').some(part => part === '' || part === '..')) return ''
+  return text
+}
+
+/**
+ * Official entry files to try, declared bin first. `./dist/main.mjs` matches
+ * the pinned `dist/main.mjs`. A package whose bin moved still resolves when
+ * the file stays inside that package.
+ */
+export function packageBinCandidates(binField, binName, expectedBin) {
+  const declared = normalizeRelativeBin(binField && typeof binField === 'object' ? binField[binName] : binField)
+  const expected = normalizeRelativeBin(expectedBin)
+  return [...new Set([declared, expected].filter(Boolean))]
+}
+
+async function readPackageEntry(packageDirectory, packageName, binName, expectedBin, workspace, seen) {
+  try {
+    const manifest = JSON.parse(await readFile(join(packageDirectory, 'package.json'), 'utf8'))
+    if (manifest.name !== packageName) return null
+    const packageRoot = await realpath(packageDirectory)
+    if (packageRoot === workspace || inside(workspace, packageRoot) || seen.has(packageRoot)) return null
+    for (const relativeBin of packageBinCandidates(manifest.bin, binName, expectedBin)) {
+      try {
+        const entry = await realpath(join(packageRoot, relativeBin))
+        if (!inside(packageRoot, entry) || !(await stat(entry)).isFile()) continue
+        seen.add(packageRoot)
+        return { entry, packageRoot, version: manifest.version, source: 'verified-npm-package' }
+      } catch { /* try the package's other bin candidate */ }
+    }
+  } catch { /* this directory is not the requested package */ }
+  return null
+}
+
 /** Resolve the package's real `bin` file, never its Windows .cmd shim. */
 async function findGlobalPackageEntries(packageName, binName, expectedBin, workspace) {
   await ensureNpmPrefixOnPath()
@@ -181,19 +217,13 @@ async function findGlobalPackageEntries(packageName, binName, expectedBin, works
     const moduleParents = [join(directory, 'node_modules')]
     if (basename(directory).toLowerCase() === '.bin') moduleParents.push(resolve(directory, '..'))
     if (!IS_WINDOWS) moduleParents.push(resolve(directory, '..', 'lib', 'node_modules'))
-    for (const modules of moduleParents) {
-      const packageDirectory = join(modules, ...packageParts)
-      try {
-        const manifest = JSON.parse(await readFile(join(packageDirectory, 'package.json'), 'utf8'))
-        if (manifest.name !== packageName || manifest.bin?.[binName] !== expectedBin) continue
-        const packageRoot = await realpath(packageDirectory)
-        if (packageRoot === workspace || inside(workspace, packageRoot)) continue
-        if (seen.has(packageRoot)) continue
-        const entry = await realpath(join(packageRoot, expectedBin))
-        if (!inside(packageRoot, entry) || !(await stat(entry)).isFile()) continue
-        seen.add(packageRoot)
-        found.push({ entry, packageRoot, version: manifest.version, source: 'verified-npm-package' })
-      } catch { /* this PATH entry is not the requested package */ }
+    const candidates = moduleParents.map(modules => join(modules, ...packageParts))
+    // Native installs put the exe in `<package>/bin` and that directory on PATH
+    // (for example D:\Program Files\Claude\node_modules\@anthropic-ai\claude-code\bin).
+    candidates.push(directory, resolve(directory, '..'))
+    for (const packageDirectory of candidates) {
+      const entry = await readPackageEntry(packageDirectory, packageName, binName, expectedBin, workspace, seen)
+      if (entry) found.push(entry)
     }
   }
   return found

package/.dsh-plugin/shared/official-tools-runtime.mjs

@@ -7,6 +7,8 @@
  * a package name, executable or argument. Installs are serialized (npm global
  * state must not interleave), output is kept as a bounded tail, and success is
  * always confirmed by a fresh probe rather than the installer's exit code.
+ * When a newer release is known, a probe that is still older fails the job
+ * instead of reporting success.
  */
 import { spawn } from 'node:child_process'
 import { mkdir, mkdtemp, realpath, rm, writeFile } from 'node:fs/promises'
@@ -15,6 +17,7 @@ import { getOfficialTool, installCommandLine, OFFICIAL_TOOLS } from './official-
 import { discoverZCodeBundle, unverifiedZCodeInstalls } from './zcode-bundle.mjs'
 import { openZCodeInstaller } from './zcode-installer.mjs'
 import { compareReleaseVersions, latestVersions } from './latest-versions.mjs'
+import { versionStillOlder } from './version-order.mjs'
 
 const PROBE_TIMEOUT_MS = 8_000
 const INSTALL_TIMEOUT_MS = 900_000
@@ -30,6 +33,70 @@ const probeCache = new Map()
 const PROBE_CACHE_MS = 60_000
 const installJobs = new Map()
 let installChain = Promise.resolve()
+const CLAUDE_UPDATE_TIMEOUT_MS = 180_000
+
+/** Non-interactive updater for a native Claude Code install. npm does not move that copy. */
+export const CLAUDE_UPDATE_ARGS = Object.freeze(['update'])
+
+/**
+ * Spawn shape for a fixed registry command.
+ *
+ * Windows needs `shell: true` so `npm.cmd` / `where.exe` resolve. Node itself
+ * wraps that as `cmd.exe /d /s /c`. Pre-quoting every argument (0.16.2) made
+ * cmd strip the wrong quotes and launch `node` against a missing script:
+ * `MODULE_NOT_FOUND` at `executeUserEntryPoint` with an empty requireStack.
+ * That failed `npm config get prefix`, `--version`, and `npm install -g` for
+ * every official tool. Keep the executable and argv separate.
+ */
+export function shellSpawnSpec(executable, args = [], { useShell = false } = {}) {
+  return { file: String(executable), args: [...(args ?? [])], shell: Boolean(useShell) }
+}
+
+/** Decode a CLI banner. Native Windows exes often write UTF-16 to a pipe. */
+export function decodeProcessOutput(value) {
+  const bytes = Buffer.isBuffer(value) ? value : Buffer.from(value ?? '')
+  if (bytes.length >= 2 && bytes[0] === 0xFF && bytes[1] === 0xFE) {
+    return bytes.toString('utf16le').replace(/^\uFEFF/, '')
+  }
+  if (bytes.length >= 2 && bytes[0] === 0xFE && bytes[1] === 0xFF) {
+    const swapped = Buffer.from(bytes)
+    swapped.swap16()
+    return swapped.toString('utf16le').replace(/^\uFEFF/, '')
+  }
+  const sample = bytes.subarray(0, Math.min(bytes.length, 64))
+  let zeros = 0
+  for (let index = 1; index < sample.length; index += 2) if (sample[index] === 0) zeros += 1
+  const pairs = Math.floor(sample.length / 2)
+  if (pairs >= 4 && zeros >= pairs * 0.6) return bytes.toString('utf16le').replace(/\u0000/g, '')
+  return bytes.toString('utf8').replace(/^\uFEFF/, '')
+}
+
+/** Absolute paths printed by `where` / `which`, one per line. */
+export function locatorPaths(stdout) {
+  return String(stdout ?? '').split(/\r?\n/).map(line => line.trim().replace(/^"|"$/g, '')).filter(line => {
+    if (!line || /^INFO:/i.test(line)) return false
+    return isAbsolute(line)
+  })
+}
+
+/** Visible failure when the installer exited cleanly but the probed copy is still older. */
+export function staleInstallMessage(label, installedVersion, latestVersion) {
+  return `${label} 的更新没有生效：检测到的版本仍是 ${installedVersion}，低于最新 ${latestVersion}。PATH 上可能有另一份更早的安装。请查看本行安装日志。`
+}
+
+/**
+ * Which updater to run. `order` is compareReleaseVersions(installed, latest):
+ * -1 older, 0 same, 1 newer, null when either version is unknown.
+ */
+export function officialUpdatePlan({ toolId, installed, order, platform }) {
+  if (installed && order === 1) return 'refuse-downgrade'
+  if (installed && order === 0) return 'already-current'
+  if (installed && order === -1 && toolId === 'claude-code') return 'claude-update-then-registry'
+  if (installed && (order === -1 || order === null) && toolId === 'minimax-code' && platform === 'win32') {
+    return 'minimax-official-installer'
+  }
+  return 'registry-install'
+}
 
 async function trustedExecutionReadiness(toolId) {
   // Loaded only during an install to avoid coupling fast version probes to
@@ -44,19 +111,28 @@ function runCapture(executable, args, { timeoutMs, onOutput, useShell = false, s
       resolve({ ok: false, code: null, stdout: '', stderr: '', timedOut: false, cancelled: true })
       return
     }
-    let stdout = ''
-    let stderr = ''
+    const stdoutChunks = []
+    const stderrChunks = []
+    const decoded = chunks => decodeProcessOutput(Buffer.concat(chunks))
+    const pushChunk = (chunks, data) => {
+      const buf = Buffer.isBuffer(data) ? data : Buffer.from(data)
+      chunks.push(buf)
+      let total = chunks.reduce((sum, chunk) => sum + chunk.length, 0)
+      while (total > 64_000 && chunks.length > 1) total -= chunks.shift().length
+      return decodeProcessOutput(buf)
+    }
     let settled = false
     let stopReason = null
     let child
     try {
-      child = spawn(executable, args, {
+      const spec = shellSpawnSpec(executable, args, { useShell })
+      child = spawn(spec.file, spec.args, {
         stdio: ['ignore', 'pipe', 'pipe'],
         windowsHide: true,
         // Windows npm CLIs install as .cmd shims; only cmd.exe can execute
         // them. Safe here because every executable and argument comes from
         // the fixed registry — caller input never reaches this boundary.
-        shell: useShell,
+        shell: spec.shell,
         ...(env ? { env } : {}),
       })
     } catch (error) {
@@ -87,7 +163,7 @@ function runCapture(executable, args, { timeoutMs, onOutput, useShell = false, s
       } else {
         try { child.kill('SIGTERM') } catch { /* already gone */ }
       }
-      graceTimer = setTimeout(() => finish({ ok: false, code: null, stdout, stderr,
+      graceTimer = setTimeout(() => finish({ ok: false, code: null, stdout: decoded(stdoutChunks), stderr: decoded(stderrChunks),
         timedOut: reason === 'timeout', cancelled: reason === 'cancel' }), 5_000)
       graceTimer.unref?.()
     }
@@ -97,20 +173,20 @@ function runCapture(executable, args, { timeoutMs, onOutput, useShell = false, s
     if (signal?.aborted) onAbort()
     child.stdout?.on('data', data => {
       if (settled || stopReason) return
-      stdout = appendBounded(stdout, String(data))
-      onOutput?.(String(data))
+      onOutput?.(pushChunk(stdoutChunks, data))
     })
     child.stderr?.on('data', data => {
       if (settled || stopReason) return
-      stderr = appendBounded(stderr, String(data))
-      onOutput?.(String(data))
+      onOutput?.(pushChunk(stderrChunks, data))
     })
     child.on('error', error => {
+      const stdout = decoded(stdoutChunks)
+      const stderr = decoded(stderrChunks)
       finish({ ok: false, code: null, stdout, stderr: `${stderr}${error.message}`.trim(),
         timedOut: stopReason === 'timeout', cancelled: stopReason === 'cancel' })
     })
     child.on('close', (code, signal) => {
-      finish({ ok: !stopReason && code === 0, code, stdout, stderr,
+      finish({ ok: !stopReason && code === 0, code, stdout: decoded(stdoutChunks), stderr: decoded(stderrChunks),
         timedOut: stopReason === 'timeout', cancelled: stopReason === 'cancel', signal })
     })
   })
@@ -145,14 +221,14 @@ async function fetchOfficialMiniMaxInstaller(signal) {
   return officialMiniMaxInstaller(Buffer.concat(chunks))
 }
 
-async function runOfficialMiniMaxInstaller(job) {
+async function runOfficialMiniMaxInstaller(job, { reason } = {}) {
   let staging = null
   let prefixRoot = null
   try {
     job.finishedAt = null
     job.error = null
     job.phase = 'downloading-and-verifying'
-    pushLine(job, '— npm 原生依赖未就绪；改用 MiniMax 官方 Windows 安装脚本（安装最新版）—')
+    pushLine(job, reason || '— npm 原生依赖未就绪；改用 MiniMax 官方 Windows 安装脚本（安装最新版）—')
     const prefixResult = await runCapture('npm', ['config', 'get', 'prefix'], {
       timeoutMs: 5_000, useShell: true, signal: job.controller.signal,
     })
@@ -208,6 +284,10 @@ async function runOfficialMiniMaxInstaller(job) {
     if (!probe.installed || !readiness.ready) {
       throw new Error(`官方安装器完成，但执行入口未通过 npm registry 摘要核验：${readiness.reason ?? probe.detail}`)
     }
+    const latest = await latestVersions.lookup(job.tool).catch(() => null)
+    if (latest?.version && versionStillOlder(probe.version, latest.version)) {
+      throw new Error(staleInstallMessage(job.tool.label, probe.version, latest.version))
+    }
     job.status = 'succeeded'
     job.finishedAt = new Date().toISOString()
     pushLine(job, `— 官方安装器已完成，MiniMax Code ${probe.version ?? ''} 的执行入口已核验 —`)
@@ -229,11 +309,6 @@ async function runOfficialMiniMaxInstaller(job) {
 /** Tools whose ready-check failure can be repaired by reinstalling the same version. */
 const CAPABILITY_REPAIRABLE = new Set(['claude-code', 'codex', 'kimi-code', 'minimax-code', 'mimo-code', 'grok-build'])
 
-function appendBounded(current, addition) {
-  const merged = current + addition
-  return merged.length > 64_000 ? merged.slice(merged.length - 32_000) : merged
-}
-
 /** Extract the first version-looking token from a CLI banner. */
 export function versionFromBanner(banner) {
   const match = String(banner ?? '').match(/\d+\.\d+\.\d+(?:-[0-9A-Za-z.]+)?/)
@@ -288,16 +363,28 @@ async function probeUncached(tool, runner) {
     if (!located.ok || !located.stdout.trim()) {
       continue
     }
-    const attempt = await runner(executable, ['--version'], { timeoutMs: PROBE_TIMEOUT_MS })
+    const attempt = await runner(executable, ['--version'], { timeoutMs: PROBE_TIMEOUT_MS, useShell: IS_WINDOWS })
     if (attempt.timedOut) {
       return { id: tool.id, installed: false, version: null, status: 'probe-timeout', detail: `${executable} --version 超时（${PROBE_TIMEOUT_MS / 1000}s）` }
     }
-    if (attempt.ok) {
-      const banner = `${attempt.stdout}\n${attempt.stderr}`.trim()
+    const attempts = [attempt]
+    if (!versionFromBanner(probeBanner(attempt))) {
+      for (const target of locatorPaths(located.stdout)) {
+        if (target === executable) continue
+        const direct = await runner(target, ['--version'], { timeoutMs: PROBE_TIMEOUT_MS, useShell: false })
+        attempts.push(direct)
+        if (direct.timedOut) break
+        if (direct.ok || versionFromBanner(probeBanner(direct))) break
+      }
+    }
+    const chosen = attempts.find(item => item && (item.ok || versionFromBanner(probeBanner(item)))) ?? attempt
+    const banner = probeBanner(chosen)
+    const version = versionFromBanner(banner)
+    if (chosen.ok || version) {
       return {
         id: tool.id,
         installed: true,
-        version: versionFromBanner(banner),
+        version,
         status: 'installed',
         detail: tool.probeNote ?? '',
         bannerLine: banner.split('\n').find(Boolean)?.slice(0, 200) ?? '',
@@ -308,7 +395,7 @@ async function probeUncached(tool, runner) {
       installed: false,
       version: null,
       status: 'probe-failed',
-      detail: `${executable} --version 退出码 ${attempt.code ?? '信号终止'}；程序可能损坏或版本过旧。${attempt.stderr.split('\n').find(Boolean)?.slice(0, 120) ?? ''}`,
+      detail: `${executable} --version 退出码 ${chosen.code ?? '信号终止'}；程序可能损坏或版本过旧。${String(chosen.stderr ?? '').split('\n').find(Boolean)?.slice(0, 120) ?? ''}`,
     }
   }
   return { id: tool.id, installed: false, version: null, status: 'not-installed', detail: '未在 PATH 中找到官方命令。' }
@@ -316,7 +403,7 @@ async function probeUncached(tool, runner) {
 
 /** Default runner: real spawn with the platform's shell for .cmd shims. */
 export const defaultRunner = (executable, args, options = {}) =>
-  runCapture(executable, args, { ...options, useShell: IS_WINDOWS })
+  runCapture(executable, args, { useShell: IS_WINDOWS, ...options })
 
 let prefixPromise = null
 
@@ -365,12 +452,31 @@ export async function installedToolIds() {
  * Probe every registry tool in parallel (the slowest single probe bounds the
  * wall time; the cache keeps repeat calls instant).
  */
+/** One tool's probe failure must not reject detection of the rest of the page. */
+export async function probeToolSafely(tool, runner, options) {
+  try {
+    return await probeToolWith(tool, runner, options)
+  } catch (error) {
+    return {
+      id: tool.id,
+      installed: false,
+      version: null,
+      status: 'probe-failed',
+      detail: `检测失败：${String(error?.message ?? error).slice(0, 200)}`,
+    }
+  }
+}
+
 export async function probeAllTools({ fresh = false } = {}) {
   await ensureNpmPrefixOnPath()
-  return Promise.all(OFFICIAL_TOOLS.map(tool => probeToolWith(tool, defaultRunner,
+  return Promise.all(OFFICIAL_TOOLS.map(tool => probeToolSafely(tool, defaultRunner,
     fresh ? { cacheMs: 0 } : {})))
 }
 
+function probeBanner(attempt) {
+  return `${attempt?.stdout ?? ''}\n${attempt?.stderr ?? ''}`.trim()
+}
+
 export function probeSnapshot() {
   return [...probeCache.values()].map(entry => entry.value)
 }
@@ -444,6 +550,86 @@ export function startInstall(toolId) {
   return jobView(job)
 }
 
+function captureLines(job) {
+  return chunk => {
+    for (const line of String(chunk).split(/\r?\n/)) {
+      if (line.trim()) pushLine(job, line.slice(0, 500))
+    }
+  }
+}
+
+/** Mark the job succeeded only when the fresh probe is installed, ready, and not still older. */
+async function finishVerifiedInstall(job, probe) {
+  job.postInstallProbe = probe
+  if (job.cancelRequested) { markCancelled(job); return true }
+  if (!probe.installed) {
+    job.status = 'failed'
+    job.finishedAt = new Date().toISOString()
+    job.error = `安装命令已完成，但重探测失败：${probe.detail}`
+    return true
+  }
+  const latest = await latestVersions.lookup(job.tool).catch(() => null)
+  if (latest?.version && versionStillOlder(probe.version, latest.version)) {
+    failBecauseStillOlder(job, probe, latest.version)
+    return true
+  }
+  const readiness = await trustedExecutionReadiness(job.tool.id)
+  if (job.cancelRequested) { markCancelled(job); return true }
+  if (!readiness.ready) {
+    if (IS_WINDOWS && job.tool.id === 'minimax-code') {
+      await runOfficialMiniMaxInstaller(job)
+      return true
+    }
+    job.status = 'failed'
+    job.finishedAt = new Date().toISOString()
+    job.error = `安装命令和版本探测已成功，但官方执行入口未就绪：${readiness.reason}`
+    return true
+  }
+  job.status = 'succeeded'
+  job.finishedAt = new Date().toISOString()
+  pushLine(job, `— 已安装 ${job.tool.label} ${probe.version ?? ''}，官方执行入口已核验（新版本未经插件测试）—`)
+  return true
+}
+
+function failBecauseStillOlder(job, probe, latestVersion) {
+  job.postInstallProbe = probe
+  job.status = 'failed'
+  job.finishedAt = new Date().toISOString()
+  job.error = staleInstallMessage(job.tool.label, probe?.version, latestVersion)
+}
+
+/**
+ * Native Claude Code lives outside the npm prefix. `claude update` is the
+ * vendor's non-interactive updater; return true when the job is finished.
+ */
+async function tryClaudeUpdate(job, latestVersion) {
+  if (job.cancelRequested) { markCancelled(job); return true }
+  pushLine(job, '$ claude update')
+  job.phase = 'installing'
+  const outcome = await runCapture('claude', CLAUDE_UPDATE_ARGS, {
+    timeoutMs: CLAUDE_UPDATE_TIMEOUT_MS,
+    useShell: IS_WINDOWS,
+    signal: job.controller.signal,
+    onOutput: captureLines(job),
+  })
+  if (job.status !== 'running') return true
+  if (outcome.cancelled || job.cancelRequested) { markCancelled(job); return true }
+  if (!outcome.ok) {
+    pushLine(job, `— claude update 未完成（退出码 ${outcome.code ?? '信号终止'}），将继续尝试注册表安装 —`)
+    return false
+  }
+  await ensureNpmPrefixOnPath()
+  probeCache.delete(job.tool.id)
+  const probe = await probeToolWith(job.tool, defaultRunner)
+  if (job.cancelRequested) { markCancelled(job); return true }
+  if (latestVersion && versionStillOlder(probe.version, latestVersion)) {
+    job.postInstallProbe = probe
+    pushLine(job, `— claude update 已结束，但探测到的版本仍是 ${probe.version}，低于 ${latestVersion} —`)
+    return false
+  }
+  return finishVerifiedInstall(job, probe)
+}
+
 async function runInstallJob(manager, args, job) {
   if (job.status !== 'running') return
   job.phase = 'preflight'
@@ -452,10 +638,12 @@ async function runInstallJob(manager, args, job) {
   probeCache.delete(job.tool.id)
   const before = await probeToolWith(job.tool, defaultRunner)
   if (job.cancelRequested) { markCancelled(job); return }
+  let latest = null
+  let order = null
   if (before.installed) {
-    const latest = await latestVersions.lookup(job.tool, { fresh: true }).catch(() => null)
+    latest = await latestVersions.lookup(job.tool, { fresh: true }).catch(() => null)
     if (job.cancelRequested) { markCancelled(job); return }
-    const order = latest?.version ? compareReleaseVersions(before.version, latest.version) : null
+    order = latest?.version ? compareReleaseVersions(before.version, latest.version) : null
     if (order === 1) {
       job.status = 'failed'
       job.finishedAt = new Date().toISOString()
@@ -476,59 +664,76 @@ async function runInstallJob(manager, args, job) {
       pushLine(job, `— 已是最新版本 ${before.version}，但执行入口未就绪：${readiness.reason}；重新安装修复 —`)
     }
   }
+  const plan = officialUpdatePlan({
+    toolId: job.tool.id,
+    installed: before.installed === true,
+    order,
+    platform: process.platform,
+  })
+  let triedClaudeUpdate = false
+  if (plan === 'claude-update-then-registry') {
+    triedClaudeUpdate = true
+    const finished = await tryClaudeUpdate(job, latest?.version)
+    if (finished || job.status !== 'running') return
+  } else if (plan === 'minimax-official-installer') {
+    await runOfficialMiniMaxInstaller(job, {
+      reason: '— 已安装的 MiniMax Code 由官方安装目录接管；直接运行官方 Windows 安装脚本以更新到最新版 —',
+    })
+    return
+  }
   job.phase = 'installing'
   const outcome = await runCapture(manager, args, {
     timeoutMs: INSTALL_TIMEOUT_MS,
     useShell: IS_WINDOWS,
     signal: job.controller.signal,
-    onOutput: chunk => {
-      for (const line of chunk.split(/\r?\n/)) {
-        if (line.trim()) pushLine(job, line.slice(0, 500))
-      }
-    },
+    onOutput: captureLines(job),
   })
   if (job.status !== 'running') return
   if (outcome.cancelled || job.cancelRequested) { markCancelled(job); return }
-  job.finishedAt = new Date().toISOString()
   job.exitCode = outcome.code
   job.timedOut = outcome.timedOut
   if (outcome.timedOut) {
     job.status = 'failed'
+    job.finishedAt = new Date().toISOString()
     job.error = `安装超时（${INSTALL_TIMEOUT_MS / 1000}s），已终止。`
-  } else if (outcome.ok) {
-    job.phase = 'verifying'
-    await ensureNpmPrefixOnPath()
-    probeCache.delete(job.tool.id)
-    const probe = await probeToolWith(job.tool, defaultRunner)
-    if (job.cancelRequested) { markCancelled(job); return }
-    job.postInstallProbe = probe
-    if (!probe.installed) {
-      job.status = 'failed'
-      job.error = `安装命令已完成，但重探测失败：${probe.detail}`
-    } else {
-      const latest = await latestVersions.lookup(job.tool).catch(() => null)
-      if (latest?.version && compareReleaseVersions(probe.version, latest.version) === -1) {
-        pushLine(job, `— 注意：PATH 上的 ${job.tool.label} 仍是 ${probe.version}，低于最新 ${latest.version}；可能有另一份旧安装排在 PATH 前面 —`)
-      }
-      const readiness = await trustedExecutionReadiness(job.tool.id)
-      if (job.cancelRequested) { markCancelled(job); return }
-      if (!readiness.ready) {
-        if (IS_WINDOWS && job.tool.id === 'minimax-code') await runOfficialMiniMaxInstaller(job)
-        else {
-          job.status = 'failed'
-          job.error = `安装命令和版本探测已成功，但官方执行入口未就绪：${readiness.reason}`
-        }
-      } else {
-        job.status = 'succeeded'
-        pushLine(job, `— 已安装 ${job.tool.label} ${probe.version ?? ''}，官方执行入口已核验（新版本未经插件测试）—`)
-      }
+    return
+  }
+  if (!outcome.ok) {
+    if (IS_WINDOWS && job.tool.id === 'minimax-code') {
+      await runOfficialMiniMaxInstaller(job)
+      return
     }
-  } else if (IS_WINDOWS && job.tool.id === 'minimax-code') {
-    await runOfficialMiniMaxInstaller(job)
-  } else {
     job.status = 'failed'
+    job.finishedAt = new Date().toISOString()
     job.error = `安装命令失败（退出码 ${outcome.code ?? '信号终止'}）。${outcome.stderr.split('\n').find(Boolean)?.slice(0, 200) ?? ''}`
+    return
+  }
+  job.phase = 'verifying'
+  await ensureNpmPrefixOnPath()
+  probeCache.delete(job.tool.id)
+  const probe = await probeToolWith(job.tool, defaultRunner)
+  if (job.cancelRequested) { markCancelled(job); return }
+  job.postInstallProbe = probe
+  const latestAfter = (await latestVersions.lookup(job.tool).catch(() => null)) ?? latest
+  const stillOlder = Boolean(latestAfter?.version && versionStillOlder(probe.version, latestAfter.version))
+  if (stillOlder && job.tool.id === 'claude-code' && !triedClaudeUpdate) {
+    triedClaudeUpdate = true
+    const finished = await tryClaudeUpdate(job, latestAfter.version)
+    if (finished || job.status !== 'running') return
+    failBecauseStillOlder(job, job.postInstallProbe ?? probe, latestAfter.version)
+    return
+  }
+  if (stillOlder && IS_WINDOWS && job.tool.id === 'minimax-code') {
+    pushLine(job, `— npm 完成后 ${job.tool.label} 仍是 ${probe.version}，低于最新 ${latestAfter.version}；改用官方安装脚本 —`)
+    await runOfficialMiniMaxInstaller(job)
+    return
+  }
+  if (stillOlder) {
+    pushLine(job, `— 注意：PATH 上的 ${job.tool.label} 仍是 ${probe.version}，低于最新 ${latestAfter.version} —`)
+    failBecauseStillOlder(job, probe, latestAfter.version)
+    return
   }
+  await finishVerifiedInstall(job, probe)
 }
 
 async function runZCodeInstallJob(job) {

package/.dsh-plugin/shared/version-order.mjs

@@ -0,0 +1,30 @@
+/**
+ * Pure x.y.z[-pre] ordering shared by the Host and the Desktop client.
+ * No Node APIs: the client bundle imports this file.
+ */
+const VERSION = /^(\d{1,6})\.(\d{1,6})\.(\d{1,6})(?:-[0-9A-Za-z.-]{1,64})?$/
+
+export function isReleaseVersion(value) {
+  return typeof value === 'string' && VERSION.test(value)
+}
+
+/** Numeric comparison of x.y.z[-pre]; a prerelease sorts below its release. */
+export function compareReleaseVersions(left, right) {
+  const parse = value => {
+    const match = VERSION.exec(String(value ?? ''))
+    return match ? { parts: match.slice(1, 4).map(Number), pre: String(value).includes('-') } : null
+  }
+  const a = parse(left)
+  const b = parse(right)
+  if (!a || !b) return null
+  for (let index = 0; index < 3; index += 1) {
+    if (a.parts[index] !== b.parts[index]) return a.parts[index] > b.parts[index] ? 1 : -1
+  }
+  if (a.pre !== b.pre) return a.pre ? -1 : 1
+  return 0
+}
+
+/** True when both versions parse and the installed copy is strictly older. */
+export function versionStillOlder(installedVersion, latestVersion) {
+  return compareReleaseVersions(installedVersion, latestVersion) === -1
+}

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.16.3 — 2026-10-09
+
+Stable patch under the npm `latest` tag. Fully quit Harness, including a WebUI server process or the desktop tray, and restart after upgrading so the Host reloads. Existing 0.16.2 artifacts remain unchanged.
+
+- Windows `shell: true` spawns again pass the executable and arguments separately. 0.16.2 pre-quoted that command line; cmd then started Node on a missing script (`MODULE_NOT_FOUND`, empty `requireStack`, Node 24) for every official tool's probe, `npm config get prefix`, and `npm install -g`.
+- A `--version` banner that contains a version counts as installed, including UTF-16 output from a native Windows executable. If the name on PATH fails, the absolute path from `where`/`which` is tried without a shell. One probe or readiness failure stays on that card.
+- Package entry lookup accepts `./dist/main.mjs` and a `bin/` directory that is itself on PATH. A CLI that is already the latest release stays on “已是最新版本” instead of “修复官方执行入口”.
+- The 0.16.2 update-button behavior remains: the click keeps its own job, refresh does not disable a visible update, and an install that leaves the probed version older fails with a row error.
+- Release validation on Linux: 630 tests passed, 4 conditional skips, `npm run check:client` passed. No Harness WebUI, Harness Desktop, or Windows `cmd.exe` run was available in this environment.
+
+## 0.16.2 — 2026-10-09
+
+Stable patch under the npm `latest` tag. Fully quit Harness, including the tray process, and restart after upgrading. Existing 0.16.1 artifacts remain unchanged.
+
+- Official-tools update/install clicks keep the job started by that click. A status poll no longer replaces it with an older finished job or clears a failure.
+- Refreshing an existing probe no longer disables the update button. A click that cannot start, and an install whose probed version is still older than latest, show an error on that row.
+- Installed Claude Code runs `claude update` before the registry npm install. Installed Windows MiniMax runs the official installer. Other registry cards share the same click path and fail visibly when the probed version does not advance.
+- Release validation: 628 tests passed, 4 conditional skips, client check passed. No paid calls or real CLI installs were part of this verification.
+
 ## 0.16.1 — 2026-10-08
 
 Stable maturity patch under the npm `latest` tag. Fully quit Harness, including the tray process, and restart after upgrading. Existing 0.16.0 artifacts remain unchanged.

package/INSTALLATION_GUIDE.zh.md

@@ -2,7 +2,7 @@
 
 模型路由从 **0.12.0** 起独立发布；GAL 是新的 **0.1.0** 插件。两者均声明支持官方 **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**，可分别安装和更新。
 
-当前路由正式版为 **0.16.1**。在既有动态公开数据和分任务类型反馈学习的基础上，本版完善反馈缓存/解释、异步刷新与设置保存，并保护不完整费用历史下的有限预算执行。公开数据默认关闭；主观偏好调整不改变公共能力评分或质量门槛。源码开发可使用独立模拟 UI 预览；安装时选择下方精确版本。
+当前路由正式版为 **0.16.3**。本版恢复全部官方工具卡片的检测与安装：Windows 上不再把每条探测和 `npm` 命令预先加引号，单张卡片的失败不会清空整页。0.16.2 的更新按钮修复和 0.16.1 的反馈缓存仍然保留。公开数据默认关闭；主观偏好调整不改变公共能力评分或质量门槛。源码开发可使用独立模拟 UI 预览；安装时选择下方精确版本。
 
 [路由 README](README.zh.md) · [迁移说明](MIGRATION.md) · [独立 GAL README](https://github.com/Alice-Marx/deepseek-harness-galgame#readme)
 
@@ -10,7 +10,7 @@
 
 | 需求 | 添加插件输入框 | 安装后的入口 |
 | --- | --- | --- |
-| 分析复杂度、按质量和费用选模型、调用官方工具 | `@ljwei-stak/dsh-model-router@0.16.1` | 模型路由 |
+| 分析复杂度、按质量和费用选模型、调用官方工具 | `@ljwei-stak/dsh-model-router@0.16.3` | 模型路由 |
 | 剧情、立绘、音乐、存档、自由对话 | `@ljwei-stak/dsh-galgame@0.1.0` | Gal 模块 |
 | 两者都要 | 分别安装上面两个包 | 模型路由 + Gal 模块 |
 
@@ -24,7 +24,7 @@
 2. 在“包名、GitHub 仓库地址或本地目录路径”输入框填一个完整包名，例如：
 
    ```text
-   @ljwei-stak/dsh-model-router@0.16.1
+   @ljwei-stak/dsh-model-router@0.16.3
    ```
 
    只想安装 GAL 时填写：
@@ -40,7 +40,7 @@
    ```
 
 4. 核对预览的包名、版本和宿主兼容信息，安装并启用。完全退出 Harness（包括托盘进程）再启动，确保 Host 加载新代码。
-5. 检查插件详情与侧边栏：路由应为 **0.16.1 / 模型路由**；GAL 应为 **0.1.0 / Gal 模块**。仅装路由时没有 GAL 入口是预期行为。
+5. 检查插件详情与侧边栏：路由应为 **0.16.3 / 模型路由**；GAL 应为 **0.1.0 / Gal 模块**。仅装路由时没有 GAL 入口是预期行为。
 
 普通用户无需 `npm install -g`，该命令不会把插件注册到当前 Harness profile。
 
@@ -48,13 +48,13 @@
 
 进入对应 Release 下载 `.tgz`：
 
-- [模型路由 Releases](https://github.com/Alice-Marx/dsh-model-router/releases)（也可运行 `npm pack @ljwei-stak/dsh-model-router@0.16.1` 获取同一安装包）
+- [模型路由 Releases](https://github.com/Alice-Marx/dsh-model-router/releases)（也可运行 `npm pack @ljwei-stak/dsh-model-router@0.16.3` 获取同一安装包）
 - [独立 GAL v0.1.0](https://github.com/Alice-Marx/deepseek-harness-galgame/releases/tag/v0.1.0)
 
 在“添加插件”填写下载文件的**绝对路径**，例如：
 
 ```text
-D:\Plugins\ljwei-stak-dsh-model-router-0.16.1.tgz
+D:\Plugins\ljwei-stak-dsh-model-router-0.16.3.tgz
 ```
 
 ```text
@@ -64,7 +64,7 @@ D:\Plugins\ljwei-stak-dsh-galgame-0.1.0.tgz
 如附有 `.sha256` 文件，用 PowerShell 计算并比较摘要：
 
 ```powershell
-Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-model-router-0.16.1.tgz'
+Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-model-router-0.16.3.tgz'
 Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-galgame-0.1.0.tgz'
 ```
 
@@ -74,7 +74,7 @@ Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-galgame-0
 
 1. 在旧合并插件的 GAL 播放器导出需要保留的剧情进度，并备份整个 Harness profile。每份 JSON 仅保存**当前剧情状态**，不含所有手动槽、设置、已读记录或本地音乐；重要槽位可依次读档再导出。
 2. 在**同一个 profile**安装独立 `@ljwei-stak/dsh-galgame@0.1.0`。
-3. 0.13.0 起包名改为 `@ljwei-stak/dsh-model-router`（旧包名最后版本为 0.13.0，内容相同，之后不再更新）：在插件管理器卸载原 `@ljwei-stak/model-router-galgame`（保留 profile 与应用数据），再添加 `@ljwei-stak/dsh-model-router@0.16.1`。不要两个同时安装（条目 id 与工具名相同）；条目 id 未变，路由设置与执行记录会保留。完成两项更新后再玩剧情，避免同时操作旧合并入口和新入口。
+3. 0.13.0 起包名改为 `@ljwei-stak/dsh-model-router`（旧包名最后版本为 0.13.0，内容相同，之后不再更新）：在插件管理器卸载原 `@ljwei-stak/model-router-galgame`（保留 profile 与应用数据），再添加 `@ljwei-stak/dsh-model-router@0.16.3`。不要两个同时安装（条目 id 与工具名相同）；条目 id 未变，路由设置与执行记录会保留。完成两项更新后再玩剧情，避免同时操作旧合并入口和新入口。
 4. 现在路由与 GAL 各有一个入口。独立 GAL 沿用旧存档 localStorage 键，核对当前进度和三槽；更换 profile 或进度未恢复时，先切换到匹配剧目，再导入 JSON 备份。
 5. 后续分别更新需要的插件；只用路由可以不启用或不安装 GAL。保留 profile 与应用数据，卸载插件时不要清理故事数据。
 
@@ -82,7 +82,7 @@ GAL 核心只包含**《回声之城·正篇》**与**《旧城迁移篇：未
 
 ## 5. 模型路由第一次使用
 
-工作台自 0.15.0 起分成**任务与执行、模型配置、官方工具、预算与安全**四页；0.16.1 沿用该布局。切换页面保留安装任务、终端会话和未完成的输入。
+工作台自 0.15.0 起分成**任务与执行、模型配置、官方工具、预算与安全**四页；0.16.3 沿用该布局。切换页面保留安装任务、终端会话和未完成的输入。
 
 1. 在 Harness 官方**模型**页配置供应商、模型与凭据。插件读取准确的 `provider/model` 目录，模型档案不保存 API Key。
 2. 在**模型配置**刷新目录，逐条填写自报质量评分、核对过的输入/输出单价（USD / 百万 token）和擅长方向；缺价留空。可选 `cliModel` 必须是该厂商 CLI 已验证接受的名字。可选 LiveBench 名称须准确对应版本与推理档位；它是用户确认的映射，不自动证明实际执行档位。
@@ -114,7 +114,7 @@ GAL 核心只包含**《回声之城·正篇》**与**《旧城迁移篇：未
 | 检查 | 预期 |
 | --- | --- |
 | 宿主版本 | 0.2.0-rc.1 或 0.2.0-rc.2；包括 `rc` 后缀。 |
-| 路由独立安装 | 0.16.1 详情、模型路由入口、目录和模型档案可用；不出现旧合并 GAL 入口。 |
+| 路由独立安装 | 0.16.3 详情、模型路由入口、目录和模型档案可用；不出现旧合并 GAL 入口。 |
 | GAL 独立安装 | 0.1.0 详情、Gal 模块入口、标题与两部核心剧情可用；不要求安装路由。 |
 | 共同安装 | 两个入口各一份，路由工具和 GAL 播放器均能使用。 |
 | 存档迁移 | 同 profile 可读旧键；跨 profile 用匹配剧目 JSON 导入；旧篇目的数据不覆盖。 |
@@ -125,11 +125,11 @@ GAL 核心只包含**《回声之城·正篇》**与**《旧城迁移篇：未
 | 动态公开数据 | 默认关闭；自行启用后核对快照版本、校验时间及失败/过期状态；人工单价仍优先。 |
 | 可编辑执行 | 在干净测试仓库核对审批、隔离工作区、补丁整合、厂商实际模型与计费。 |
 
-历史 0.15.0 的自动测试验证为 220 项通过、3 项 Windows 平台跳过；组件 UI 预览检查使用模拟数据。**0.16.1 的发布验证见[更新记录](CHANGELOG.md)**，不把模拟公开源/模型流和组件预览当作真实付费调用或 Harness Desktop 端到端验收；上表中的实际安装、账号和工作区检查仍需在使用环境中完成。
+历史 0.15.0 的自动测试验证为 220 项通过、3 项 Windows 平台跳过；组件 UI 预览检查使用模拟数据。**0.16.3 的发布验证见[更新记录](CHANGELOG.md)**，不把模拟公开源/模型流和组件预览当作真实付费调用或 Harness Desktop 端到端验收；上表中的实际安装、账号和工作区检查仍需在使用环境中完成。
 
 ## 8. 开发者从完整源码构建
 
-路由需要 Node.js **22.19+** 与 **pnpm 10.34.6**。从完整源码仓库根目录构建；复现正式版 0.16.1 时检出对应发布标签。旧版（如 0.15.0）标签保留其当时内容。运行：
+路由需要 Node.js **22.19+** 与 **pnpm 10.34.6**。从完整源码仓库根目录构建；复现正式版 0.16.3 时检出对应发布标签。旧版（如 0.15.0）标签保留其当时内容。运行：
 
 ```powershell
 pnpm install --frozen-lockfile --strict-peer-dependencies

package/README.md

@@ -1,14 +1,18 @@
 # Model Router · DeepSeek Harness Desktop
 
-Version: **0.16.1**. See [routing research](docs/ROUTING_RESEARCH.zh.md), [mathematical derivation and experiments](docs/ROUTING_DERIVATION_EXPERIMENTS.zh.md), and the [LiveBench evidence audit and validation protocol](docs/ROUTING_LIVEBENCH_VALIDATION.zh.md). The latest public 2026-06-25 score/cost tables are aggregates; its paired question-quality/cost matrix has not been obtained, and no real routing gain is claimed.
+Version: **0.16.3**. See [routing research](docs/ROUTING_RESEARCH.zh.md), [mathematical derivation and experiments](docs/ROUTING_DERIVATION_EXPERIMENTS.zh.md), and the [LiveBench evidence audit and validation protocol](docs/ROUTING_LIVEBENCH_VALIDATION.zh.md). The latest public 2026-06-25 score/cost tables are aggregates; its paired question-quality/cost matrix has not been obtained, and no real routing gain is claimed.
 
 A cost-aware model-routing workbench for **DeepSeek Harness Desktop**. Describe a task, compare your configured models, inspect the plan, and explicitly choose when to execute it.
 
+**0.16.3:** restores official-tools detection and install for every registry card. Windows probes and `npm` are spawned with separate arguments again, so cmd no longer launches Node against a missing script. A version banner still counts as installed, one card's probe error stays on that row, and a CLI that is already current is not sent through “修复官方执行入口”.
+
+**0.16.2:** the official-tools update/install button keeps the job started by that click, stays usable while a previous probe is refreshing, and shows a row error when the click cannot start or the probed version does not advance. Installed Claude Code runs `claude update` before the registry npm install. Installed Windows MiniMax runs the official installer.
+
 **0.16.1:** [maturity improvements and validation](docs/ROUTING_MATURITY.zh.md) adds stable feedback cache identity, per-model/task feedback explanations, source-refresh and settings-race protection, and budget gates for unreadable or incomplete cost history. Mechanism tests do not establish real quality–cost gains.
 
 **0.16.0:** [dynamic data and adaptive feedback](docs/ROUTING_ADAPTIVE_LEARNING.zh.md) adds opt-in public benchmark/curated fixed-USD pricing refresh and task-specific, time-decayed, shrinkage-regularized subjective utility. Objective proxy quality floors remain separate. Public sources default off; preferences are shared within one local DSH_HOME and limited to the latest 200 runs. This is not a universal vendor-price scraper or evidence of real quality–cost gains.
 
-Current version: **0.16.1** (`@ljwei-stak/dsh-model-router`). Its declared host compatibility is **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**. The router and [GAL](https://github.com/Alice-Marx/deepseek-harness-galgame) have been independent plugins since 0.12.0.
+Current version: **0.16.3** (`@ljwei-stak/dsh-model-router`). Its declared host compatibility is **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**. The router and [GAL](https://github.com/Alice-Marx/deepseek-harness-galgame) have been independent plugins since 0.12.0.
 
 **0.15.0 changes:** a four-tab workbench with routing advice directly below task planning, protection against stale execution previews, preserved spending totals across history pruning and retries, and a standalone mock UI preview for source development.
 
@@ -40,16 +44,16 @@ Generating a route recommendation is local: it does not start a vendor CLI or ma
 Open **Plugins → Add plugin** and enter:
 
 ```text
-@ljwei-stak/dsh-model-router@0.16.1
+@ljwei-stak/dsh-model-router@0.16.3
 ```
 
-Use the official HTTPS npm source `https://registry.npmjs.org/` when a mirror lacks that exact version. Enable the plugin, then fully quit Harness (including its tray process) and restart it. Plugin details should show **0.16.1** and the sidebar should contain **模型路由** (Model Router). A global `npm install -g` alone does not register a Desktop plugin.
+Use the official HTTPS npm source `https://registry.npmjs.org/` when a mirror lacks that exact version. Enable the plugin, then fully quit Harness (including its tray process) and restart it. Plugin details should show **0.16.3** and the sidebar should contain **模型路由** (Model Router). A global `npm install -g` alone does not register a Desktop plugin.
 
 You can instead install a local `.tgz` archive or its extracted inner `package` directory through the plugin manager. Both must contain `package.json` and `.dsh-plugin`. See [releases](https://github.com/Alice-Marx/dsh-model-router/releases) for archived builds, or build your own checkout below.
 
 ### Upgrade from the old package name
 
-The old name `@ljwei-stak/model-router-galgame` ended at 0.13.0. Remove that plugin entry while retaining your profile/application data, then add `@ljwei-stak/dsh-model-router@0.16.1`. Do not keep both entries installed: they share the internal plugin id `model-router-galgame` and tool names. The retained id lets existing router settings and history carry over.
+The old name `@ljwei-stak/model-router-galgame` ended at 0.13.0. Remove that plugin entry while retaining your profile/application data, then add `@ljwei-stak/dsh-model-router@0.16.3`. Do not keep both entries installed: they share the internal plugin id `model-router-galgame` and tool names. The retained id lets existing router settings and history carry over.
 
 For the combined 0.11.x package, back up the profile and export the GAL saves you want to preserve before upgrading. Story playback, artwork, music and saves now belong to the independent `@ljwei-stak/dsh-galgame` package. The detailed save limitations are in [MIGRATION.md](MIGRATION.md).
 

package/README.zh.md

@@ -1,14 +1,18 @@
 # Model Router · DeepSeek Harness 模型路由插件
 
-版本：**0.16.1**。选模求解器概览见[路由研究说明](docs/ROUTING_RESEARCH.zh.md)；公式、条件证明与实验见[数学推导与实验记录](docs/ROUTING_DERIVATION_EXPERIMENTS.zh.md)。[LiveBench 最新证据与验证协议](docs/ROUTING_LIVEBENCH_VALIDATION.zh.md)已核查 2026-06-25 聚合评分/费用；最新逐题质量—费用矩阵尚未取得，不声称真实路由收益。
+版本：**0.16.3**。选模求解器概览见[路由研究说明](docs/ROUTING_RESEARCH.zh.md)；公式、条件证明与实验见[数学推导与实验记录](docs/ROUTING_DERIVATION_EXPERIMENTS.zh.md)。[LiveBench 最新证据与验证协议](docs/ROUTING_LIVEBENCH_VALIDATION.zh.md)已核查 2026-06-25 聚合评分/费用；最新逐题质量—费用矩阵尚未取得，不声称真实路由收益。
 
 为 **DeepSeek Harness Desktop** 提供任务规划、成本感知的模型分配和官方工具执行工作台。输入任务，比较已配置模型，审阅计划，再明确选择是否执行。
 
+**0.16.3**：恢复全部官方工具卡片的检测和安装。Windows 上的探测与 `npm` 再次按独立参数启动，避免 cmd 把 Node 指到不存在的脚本。只要输出版本号就视为已安装；单张卡片的检测错误留在该行；已经是最新版的 CLI 不再被收成「修复官方执行入口」。
+
+**0.16.2**：官方工具的更新/安装按钮会保留本次点击启动的任务；已有探测结果时重新体检不再把按钮禁用成无响应；点击无法开始、或安装后探测版本仍低于最新版时，在该行显示错误。已安装的 Claude Code 先执行 `claude update`，再按注册表走 npm；已安装的 Windows MiniMax 走官方安装脚本。
+
 **0.16.1 成熟度改进**：稳定反馈缓存、分模型/任务解释、刷新与设置竞态保护，以及费用历史不可读取或不完整时的预算门禁。[推导与验证](docs/ROUTING_MATURITY.zh.md)随安装包提供，机制测试不等于真实质量—成本收益。
 
 **0.16.0 新增**：[动态数据与持续反馈](docs/ROUTING_ADAPTIVE_LEARNING.zh.md)：可选公开价格/LiveBench快照刷新；按任务类型、时间衰减和低样本收缩调整个人偏好，质量门槛独立保留。设置在“预算与安全”，公开源默认关闭；价格源需提供按官方文档核对的固定USD单价JSON，不是通用官网抓价器。本地DSH_HOME共享、最近200运行窗口，暂无真实收益证明。
 
-当前版本为 **0.16.1**，包名为 `@ljwei-stak/dsh-model-router`；声明兼容的宿主为 **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**。自 0.12.0 起，路由与 [GAL](https://github.com/Alice-Marx/deepseek-harness-galgame) 已拆成两个独立插件。
+当前版本为 **0.16.3**，包名为 `@ljwei-stak/dsh-model-router`；声明兼容的宿主为 **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**。自 0.12.0 起，路由与 [GAL](https://github.com/Alice-Marx/deepseek-harness-galgame) 已拆成两个独立插件。
 
 **0.15.0 更新**：工作台分为四页，路由建议紧接任务规划展示；执行输入变化时丢弃旧预览；裁剪历史或重试后仍保留费用累计；源码开发新增独立模拟 UI 预览。
 
@@ -40,16 +44,16 @@
 打开 **插件 → 添加插件**，填写：
 
 ```text
-@ljwei-stak/dsh-model-router@0.16.1
+@ljwei-stak/dsh-model-router@0.16.3
 ```
 
-镜像缺少该精确版本时使用官方 HTTPS npm 源 `https://registry.npmjs.org/`。安装并启用后，完全退出 Harness（包括托盘进程）再启动。插件详情应显示 **0.16.1**，侧栏出现**模型路由**。仅运行全局 `npm install -g` 不会把插件注册到桌面版 profile。
+镜像缺少该精确版本时使用官方 HTTPS npm 源 `https://registry.npmjs.org/`。安装并启用后，完全退出 Harness（包括托盘进程）再启动。插件详情应显示 **0.16.3**，侧栏出现**模型路由**。仅运行全局 `npm install -g` 不会把插件注册到桌面版 profile。
 
 也可在插件管理器填写本地 `.tgz` 文件的绝对路径，或解压后的内层 `package` 目录；其中应包含 `package.json` 与 `.dsh-plugin`。[历史发布页](https://github.com/Alice-Marx/dsh-model-router/releases)提供归档；已克隆源码的开发方式见下文。
 
 ### 从旧包名升级
 
-`@ljwei-stak/model-router-galgame` 的最后版本为 0.13.0。保留 profile 与应用数据，移除旧插件条目，再添加 `@ljwei-stak/dsh-model-router@0.16.1`。不要同时安装两个包：它们共用内部插件 id `model-router-galgame` 与工具名；id 保留使已有路由设置和执行历史能够延续。
+`@ljwei-stak/model-router-galgame` 的最后版本为 0.13.0。保留 profile 与应用数据，移除旧插件条目，再添加 `@ljwei-stak/dsh-model-router@0.16.3`。不要同时安装两个包：它们共用内部插件 id `model-router-galgame` 与工具名；id 保留使已有路由设置和执行历史能够延续。
 
 从 0.11.x 合并版迁移时，先备份 profile 并导出希望保留的 GAL 进度。剧情、立绘、音乐、自由模式和存档属于独立 `@ljwei-stak/dsh-galgame` 插件。导出范围及同 profile 迁移的限制见 [MIGRATION.md](MIGRATION.md)。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ljwei-stak/dsh-model-router",
-  "version": "0.16.1",
+  "version": "0.16.3",
   "type": "module",
   "description": "Model Router for official DeepSeek Harness Desktop: cost-aware task routing, dependent work packages and official vendor CLI discovery, installation and execution. GAL is available separately as @ljwei-stak/dsh-galgame.",
   "repository": {
@@ -57,6 +57,7 @@
     ".dsh-plugin/shared/vendor-minimax-adapter.mjs",
     ".dsh-plugin/shared/vendor-mimo-grok-adapter.mjs",
     ".dsh-plugin/shared/latest-versions.mjs",
+    ".dsh-plugin/shared/version-order.mjs",
     ".dsh-plugin/shared/npm-attestation.mjs",
     ".dsh-plugin/shared/zcode-bundle.mjs",
     ".dsh-plugin/shared/zcode-installer.mjs",