@joekytc/dsh-swarm 0.3.12 → 0.5.1

package/lib/client.js

@@ -560,9 +560,27 @@ window.__ModuleLoader__.load({
 		    () => EMPTY
 		  );
 		}
+		var navigator = null;
+		function setSessionNavigator(next) {
+		  navigator = next;
+		}
 		function openSession(id) {
+		  if (navigator) {
+		    let viaWorkspace = null;
+		    try {
+		      viaWorkspace = navigator();
+		    } catch {
+		      viaWorkspace = null;
+		    }
+		    if (viaWorkspace) {
+		      viaWorkspace.openSession(id);
+		      return;
+		    }
+		  }
 		  if (!service) throw new Error("sessions service unavailable");
-		  service.open(id);
+		  const open = service.open;
+		  if (!open) throw new Error("host exposes neither uiWorkspace nor sessions.open; session jump unavailable");
+		  open(id);
 		}
 		
 		// client/BoardCard.tsx
@@ -1625,7 +1643,7 @@ window.__ModuleLoader__.load({
 		// client/config-store.ts
 		var SWARM_CONFIG_NS = "swarm-config";
 		function createConfigStore(fetchImpl) {
-		  let state = { effective: { wikiVault: { baseUrl: "", pagePrefix: "" }, roles: { models: {} }, reviewEngine: { mode: "delegate", managed: { provider: "", model: "" } }, imDelivery: { fallbackBotId: "" } }, sources: {}, catalog: { providers: [], models: {} }, ocrStatus: null, install: { phase: "idle", log: "" }, saving: false, error: null };
+		  let state = { effective: { wikiVault: { baseUrl: "", pagePrefix: "" }, roles: { models: {} }, chainFallback: { provider: "", model: "", reasoningEffort: "high" }, reviewEngine: { mode: "delegate", managed: { provider: "", model: "" } }, imDelivery: { fallbackBotId: "" } }, sources: {}, catalog: { providers: [], models: {} }, ocrStatus: null, install: { phase: "idle", log: "" }, saving: false, error: null };
 		  const listeners = /* @__PURE__ */ new Set();
 		  const setState = (patch) => {
 		    state = { ...state, ...patch };
@@ -1745,6 +1763,7 @@ window.__ModuleLoader__.load({
 		        "aria-haspopup": "listbox",
 		        "aria-expanded": open,
 		        disabled,
+		        title: current?.label ?? placeholder,
 		        onClick: () => setOpen((v) => !v),
 		        children: [
 		          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("span", { className: current ? void 0 : "dsh-kb-config__select-placeholder", children: current?.label ?? placeholder }),
@@ -1797,6 +1816,15 @@ window.__ModuleLoader__.load({
 		// client/ConfigSection.tsx
 		var import_jsx_runtime9 = require("react/jsx-runtime");
 		var ROLES = ["v", "p", "w", "d", "pt", "dt"];
+		var MAX_FALLBACKS = 2;
+		var ROLE_NAMES = {
+		  v: "\u770B\u677F\u7F16\u6392\u5B98\uFF08V\uFF09",
+		  p: "\u89C4\u5212\u5B98\uFF08P\uFF09",
+		  w: "\u77E5\u8BC6\u5B98\uFF08W\uFF09",
+		  d: "\u5168\u6808\u5F00\u53D1\u5B98\uFF08D\uFF09",
+		  pt: "\u8BA1\u5212\u5BA1\u67E5\u5B98\uFF08PT\uFF09",
+		  dt: "\u4EA4\u4ED8\u8BC4\u5BA1\u5B98\uFF08DT\uFF09"
+		};
 		function ocrBanner(ocr, installing) {
 		  if (installing) return null;
 		  if (ocr === null) return "ocr \u72B6\u6001\u672A\u77E5\u2014\u2014\u59D4\u6258/\u6258\u7BA1\u8BC4\u5BA1\u53EF\u80FD\u4E0D\u53EF\u7528";
@@ -1810,6 +1838,7 @@ window.__ModuleLoader__.load({
 		  const state = (0, import_react9.useSyncExternalStore)(store.subscribe, store.get);
 		  const [draft, setDraft] = (0, import_react9.useState)(null);
 		  const [wireResult, setWireResult] = (0, import_react9.useState)(null);
+		  const [openRole, setOpenRole] = (0, import_react9.useState)(void 0);
 		  (0, import_react9.useEffect)(() => {
 		    void store.load().then(() => setDraft(store.get().effective));
 		    void store.loadOcrStatus();
@@ -1829,9 +1858,33 @@ window.__ModuleLoader__.load({
 		    setDraft(next);
 		    void store.save(next);
 		  };
+		  const roleEntry = (r) => draft.roles.models[r] ?? { provider: "", model: "", reasoningEffort: "", fallbacks: [] };
 		  const setModel = (r, patch) => {
-		    const prev = draft.roles.models[r] ?? { provider: "", model: "", reasoningEffort: "" };
-		    commit({ ...draft, roles: { models: { ...draft.roles.models, [r]: { ...prev, ...patch } } } });
+		    commit({ ...draft, roles: { models: { ...draft.roles.models, [r]: { ...roleEntry(r), ...patch } } } });
+		  };
+		  const setFallback = (r, idx, patch) => {
+		    const fbs = [...roleEntry(r).fallbacks];
+		    const cur = fbs[idx] ?? { provider: "", model: "", reasoningEffort: "" };
+		    fbs[idx] = { ...cur, ...patch };
+		    setModel(r, { fallbacks: fbs });
+		  };
+		  const addFallback = (r) => {
+		    const fbs = roleEntry(r).fallbacks;
+		    if (fbs.length >= MAX_FALLBACKS) return;
+		    setModel(r, { fallbacks: [...fbs, { provider: "", model: "", reasoningEffort: "" }] });
+		  };
+		  const removeFallback = (r, idx) => {
+		    setModel(r, { fallbacks: roleEntry(r).fallbacks.filter((_, i) => i !== idx) });
+		  };
+		  const copyChainToAll = (r) => {
+		    const src = roleEntry(r);
+		    if (!(src.provider && src.model)) return;
+		    const models = { ...draft.roles.models };
+		    for (const o of ROLES) {
+		      if (o === r) continue;
+		      models[o] = { provider: src.provider, model: src.model, reasoningEffort: src.reasoningEffort, fallbacks: src.fallbacks.map((f) => ({ ...f })) };
+		    }
+		    commit({ ...draft, roles: { models } });
 		  };
 		  const commitReviewEngine = (mode, managed) => {
 		    commit({ ...draft, reviewEngine: { mode, managed } });
@@ -1839,11 +1892,26 @@ window.__ModuleLoader__.load({
 		  const onBlur = () => {
 		    void store.save(draft);
 		  };
+		  const chainField = (label, value, placeholder, options, onPick) => /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("label", { className: "dsh-kb-config__field", children: [
+		    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__field-label", children: label }),
+		    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(ConfigSelect, { value, placeholder, options, onChange: onPick })
+		  ] });
+		  const chainSummary = (m) => {
+		    if (!(m.provider && m.model)) return "\u672A\u914D\u7F6E";
+		    const n = (m.fallbacks ?? []).filter((f) => f.provider && f.model).length;
+		    return `${m.provider} / ${m.model}` + (n ? ` \xB7 ${n} \u964D\u7EA7` : "");
+		  };
+		  const providerOptions = state.catalog.providers.map((p) => ({ value: p.id, label: p.name }));
+		  const expandedRole = openRole === void 0 ? ROLES.find((x) => {
+		    const e = draft.roles.models[x];
+		    return Boolean(e?.provider && e?.model);
+		  }) ?? null : openRole;
 		  const ocr = state.ocrStatus;
 		  const banner = ocrBanner(ocr, installing);
 		  const ocrBlocked = installing || ocr === null || !ocr.installed;
 		  const re = draft.reviewEngine;
 		  const managedFieldsEnabled = !ocrBlocked && re.mode === "managed";
+		  const cf = draft.chainFallback ?? { provider: "", model: "", reasoningEffort: "high" };
 		  return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-kb-config", children: [
 		    /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("section", { className: "dsh-kb-config__card", children: [
 		      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("h3", { children: "\u77E5\u8BC6\u5E93" }),
@@ -1871,47 +1939,155 @@ window.__ModuleLoader__.load({
 		    /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("section", { className: "dsh-kb-config__card", children: [
 		      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("h3", { children: "\u6A21\u578B\u94FE" }),
 		      ROLES.map((r) => {
-		        const m = draft.roles.models[r] ?? { provider: "", model: "", reasoningEffort: "" };
+		        const m = roleEntry(r);
+		        const fbs = m.fallbacks ?? [];
+		        const configured = Boolean(m.provider && m.model);
+		        const open = expandedRole === r;
 		        const providerModels = state.catalog.models[m.provider] ?? [];
 		        const efforts = providerModels.find((x) => x.id === m.model)?.efforts ?? [];
-		        return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-kb-config__role", children: [
-		          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("strong", { children: r }),
-		          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-		            ConfigSelect,
+		        return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-kb-config__role-block", children: [
+		          /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(
+		            "button",
 		            {
-		              value: m.provider,
-		              placeholder: "\u9009\u62E9 provider",
-		              options: state.catalog.providers.map((p) => ({ value: p.id, label: p.name })),
-		              onChange: (v) => {
-		                if (v !== m.provider) setModel(r, { provider: v, model: "", reasoningEffort: "" });
-		              }
+		              type: "button",
+		              className: "dsh-kb-config__role-head",
+		              "aria-expanded": open,
+		              onClick: () => setOpenRole(open ? null : r),
+		              children: [
+		                /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__chevron" + (open ? " dsh-kb-config__chevron--open" : ""), "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("svg", { width: "14", height: "14", viewBox: "0 0 16 16", children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+		                  "path",
+		                  {
+		                    d: "M6 3.5 10.5 8 6 12.5",
+		                    fill: "none",
+		                    stroke: "currentColor",
+		                    strokeWidth: "1.5",
+		                    strokeLinecap: "round",
+		                    strokeLinejoin: "round"
+		                  }
+		                ) }) }),
+		                /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("strong", { children: ROLE_NAMES[r] }),
+		                !open && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__role-summary", children: chainSummary(m) })
+		              ]
 		            }
 		          ),
-		          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-		            ConfigSelect,
-		            {
-		              value: m.model,
-		              placeholder: "\u9009\u62E9\u6A21\u578B",
-		              options: providerModels.map((x) => ({ value: x.id, label: x.name })),
-		              onChange: (v) => {
+		          open && /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-kb-config__role-body", children: [
+		            /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__group-label", children: "\u4E3B\u6A21\u578B" }),
+		            chainField(
+		              "\u4F9B\u5E94\u5546",
+		              m.provider,
+		              "\u9009\u62E9 provider",
+		              providerOptions,
+		              (v) => {
+		                if (v !== m.provider) setModel(r, { provider: v, model: "", reasoningEffort: "" });
+		              }
+		            ),
+		            chainField(
+		              "\u6A21\u578B",
+		              m.model,
+		              "\u9009\u62E9\u6A21\u578B",
+		              providerModels.map((x) => ({ value: x.id, label: x.name })),
+		              (v) => {
 		                if (v !== m.model) setModel(r, { model: v, reasoningEffort: "" });
 		              }
-		            }
-		          ),
-		          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-		            ConfigSelect,
-		            {
-		              value: m.reasoningEffort,
-		              placeholder: "\u8DDF\u968F\u9ED8\u8BA4",
-		              options: efforts.map((x) => ({ value: x.id, label: x.name })),
-		              onChange: (v) => {
+		            ),
+		            chainField(
+		              "\u601D\u8003\u7B49\u7EA7",
+		              m.reasoningEffort,
+		              "\u8DDF\u968F\u9ED8\u8BA4",
+		              efforts.map((x) => ({ value: x.id, label: x.name })),
+		              (v) => {
 		                if (v !== m.reasoningEffort) setModel(r, { reasoningEffort: v });
 		              }
-		            }
-		          ),
-		          /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__src", children: state.sources[`roles.models.${r}.model`] === "override" ? "\u5DF2\u8986\u76D6" : "\u7EE7\u627F" })
+		            ),
+		            /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__group-label", children: "\u964D\u7EA7\uFF08\u6700\u591A 2 \u4E2A\uFF0C\u987A\u5E8F = \u5207\u6362\u4F18\u5148\u5E8F\uFF09" }),
+		            fbs.map((f, i) => {
+		              const fProviderModels = state.catalog.models[f.provider] ?? [];
+		              const fEfforts = fProviderModels.find((x) => x.id === f.model)?.efforts ?? [];
+		              return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-kb-config__fb-group", children: [
+		                /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-kb-config__fb-head", children: [
+		                  /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("span", { className: "dsh-kb-config__fb-title", children: [
+		                    "\u964D\u7EA7 ",
+		                    i + 1
+		                  ] }),
+		                  /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+		                    "button",
+		                    {
+		                      type: "button",
+		                      className: "dsh-kb-config__row-btn",
+		                      title: "\u5220\u9664\u8BE5\u964D\u7EA7\u5019\u9009",
+		                      onClick: () => removeFallback(r, i),
+		                      children: "\u5220\u9664"
+		                    }
+		                  )
+		                ] }),
+		                chainField(
+		                  "\u4F9B\u5E94\u5546",
+		                  f.provider,
+		                  "\u9009\u62E9 provider",
+		                  providerOptions,
+		                  (v) => {
+		                    if (v !== f.provider) setFallback(r, i, { provider: v, model: "", reasoningEffort: "" });
+		                  }
+		                ),
+		                chainField(
+		                  "\u6A21\u578B",
+		                  f.model,
+		                  "\u9009\u62E9\u6A21\u578B",
+		                  fProviderModels.map((x) => ({ value: x.id, label: x.name })),
+		                  (v) => {
+		                    if (v !== f.model) setFallback(r, i, { model: v, reasoningEffort: "" });
+		                  }
+		                ),
+		                chainField(
+		                  "\u601D\u8003\u7B49\u7EA7",
+		                  f.reasoningEffort,
+		                  "\u8DDF\u968F\u9ED8\u8BA4",
+		                  fEfforts.map((x) => ({ value: x.id, label: x.name })),
+		                  (v) => {
+		                    if (v !== f.reasoningEffort) setFallback(r, i, { reasoningEffort: v });
+		                  }
+		                )
+		              ] }, i);
+		            }),
+		            /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-kb-config__role-actions", children: [
+		              fbs.length < MAX_FALLBACKS && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+		                "button",
+		                {
+		                  type: "button",
+		                  className: "dsh-kb-config__row-btn",
+		                  disabled: !configured,
+		                  title: configured ? "\u8FFD\u52A0\u4E00\u4E2A\u964D\u7EA7\u5019\u9009" : "\u5148\u9009\u597D\u4E3B\u6A21\u578B\uFF08provider+\u6A21\u578B\uFF09\u518D\u8FFD\u52A0\u964D\u7EA7",
+		                  onClick: () => addFallback(r),
+		                  children: "+ \u964D\u7EA7"
+		                }
+		              ),
+		              /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+		                "button",
+		                {
+		                  type: "button",
+		                  className: "dsh-kb-config__row-btn",
+		                  disabled: !configured,
+		                  title: "\u628A\u8BE5\u89D2\u8272\u7684\u4E3B\u6A21\u578B+\u964D\u7EA7\u94FE\u6574\u4F53\u590D\u5236\u5230\u5176\u4F59\u89D2\u8272",
+		                  onClick: () => copyChainToAll(r),
+		                  children: "\u590D\u5236\u672C\u94FE\u5230\u5168\u90E8\u89D2\u8272"
+		                }
+		              )
+		            ] })
+		          ] })
 		        ] }, r);
-		      })
+		      }),
+		      /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "dsh-kb-config__role dsh-kb-config__role--official", children: [
+		        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__badge", children: "\u5B98\u65B9\u515C\u5E95" }),
+		        cf.provider && cf.model ? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("span", { children: [
+		          cf.provider,
+		          " / ",
+		          cf.model,
+		          "\uFF08reasoningEffort=",
+		          cf.reasoningEffort,
+		          "\uFF09"
+		        ] }) : /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__muted", children: "\u672A\u914D\u7F6E\u2014\u2014\u89D2\u8272\u94FE\u5168\u7A7A\u65F6\u8D70\u5BBF\u4E3B\u9ED8\u8BA4\u6A21\u578B" })
+		      ] }),
+		      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "dsh-kb-config__help", children: "\u6D3E\u53D1\u987A\u5E8F\uFF1A\u4E3B\u6A21\u578B \u2192 \u964D\u7EA7\uFF08\u987A\u5E8F=\u4F18\u5148\u5E8F\uFF0C\u6700\u591A 2 \u4E2A\uFF09\u2192 \u5B98\u65B9\u515C\u5E95\uFF08\u6052\u57AB\u94FE\u5C3E\uFF09\u2192 \u5BBF\u4E3B\u9ED8\u8BA4\u6A21\u578B\uFF1B\u5019\u9009\u4E0D\u53EF\u7528\uFF08\u542B\u5B98\u65B9\u8D26\u53F7\u672A\u767B\u5F55\uFF09\u9759\u9ED8\u5207\u6362\u5E76\u7559 [model-fallback] \u8BC4\u8BBA" })
 		    ] }),
 		    /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("section", { className: "dsh-kb-config__card", children: [
 		      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("h3", { children: "\u8BC4\u5BA1\u5F15\u64CE\uFF08ocr\uFF09" }),
@@ -2893,13 +3069,14 @@ window.__ModuleLoader__.load({
 		`;
 		
 		// client/config.css
-		var config_default = ".dsh-kb-config {\n  /* \u4E0E kanban.css \u5927\u5706\u89D2\u5951\u7EA6\u5BF9\u9F50\uFF08DSH \u5361\u7247 16px\uFF09 */\n  --dsh-kb-config-border: var(--dsw-alias-border-l2, #333);\n  --dsh-kb-config-radius-lg: 16px;\n  --dsh-kb-config-radius-md: 10px;\n  --dsh-kb-config-input: var(--dsw-specific-input-major, rgba(127, 127, 127, 0.12));\n  padding: 16px;\n  font-size: 13px;\n}\n.dsh-kb-config__card { border: 1px solid var(--dsh-kb-config-border); border-radius: var(--dsh-kb-config-radius-lg); padding: 20px; margin-bottom: 16px; }\n.dsh-kb-config__card h3 { margin: 0 0 14px; }\n\n.dsh-kb-config input,\n.dsh-kb-config select {\n  box-sizing: border-box;\n  width: 100%;\n  padding: 8px 12px;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: var(--dsh-kb-config-input);\n  color: var(--dsw-alias-label-primary, inherit);\n  font: inherit;\n  transition: border-color 150ms ease, background-color 150ms ease;\n}\n.dsh-kb-config input:focus,\n.dsh-kb-config select:focus {\n  outline: none;\n  /* \u7126\u70B9/\u9009\u4E2D\u5F3A\u8C03\u8272\u8DDF\u968F\u4E3B\u9898\u524D\u666F\uFF08\u6D45\u8272=\u6697\u3001\u6697\u8272=\u767D\uFF09\uFF0C\u4E0E dsh settings \u8272\u7CFB\u4E00\u81F4 */\n  border-color: var(--dsw-alias-label-primary, currentColor);\n}\n\n/* DSH \u98CE\u683C\u4E0B\u62C9\uFF1Atrigger \u884C\uFF08\u503C + \u203A chevron\uFF09+ \u5F39\u51FA\u83DC\u5355\uFF08\u9009\u4E2D\u6253\u52FE\u3001hover \u9AD8\u4EAE\uFF09 */\n.dsh-kb-config__select { position: relative; min-width: 0; }\n.dsh-kb-config__select-trigger {\n  box-sizing: border-box;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  width: 100%;\n  padding: 8px 12px;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: var(--dsh-kb-config-input);\n  color: var(--dsw-alias-label-primary, inherit);\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n  transition: border-color 150ms ease, background-color 150ms ease;\n}\n.dsh-kb-config__select-trigger:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }\n.dsh-kb-config__select-trigger[aria-expanded='true'] { border-color: var(--dsw-alias-label-primary, currentColor); }\n.dsh-kb-config__select-placeholder { color: var(--dsw-alias-label-tertiary, #999); }\n.dsh-kb-config__select-trigger > span:first-child { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.dsh-kb-config__select-chevron { flex: 0 0 auto; display: inline-flex; color: var(--dsw-alias-label-tertiary, #999); }\n.dsh-kb-config__menu {\n  position: absolute;\n  z-index: 30;\n  top: calc(100% + 6px);\n  left: 0;\n  right: 0;\n  margin: 0;\n  padding: 6px;\n  list-style: none;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-lg);\n  background: var(--dsw-alias-bg-layer-3, #222);\n  color: var(--dsw-alias-label-primary, inherit);\n  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.24);\n  max-height: 260px;\n  overflow: auto;\n}\n.dsh-kb-config__option {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  width: 100%;\n  padding: 8px 10px;\n  border: none;\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n  transition: background-color 150ms ease;\n}\n.dsh-kb-config__option:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }\n.dsh-kb-config__option[data-selected='true'] { color: var(--dsw-alias-state-business-primary, #4b7bff); }\n.dsh-kb-config__option > span:first-child { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.dsh-kb-config__option-check { flex: 0 0 auto; display: inline-flex; }\n\n.dsh-kb-config__label { display: block; margin: 12px 0 6px; font-weight: 600; }\n.dsh-kb-config__help { color: var(--dsw-alias-label-secondary, #888); font-size: 12px; display: block; margin: 6px 0 0; }\n.dsh-kb-config__role { display: grid; grid-template-columns: 32px 1fr 1fr 1fr auto; gap: 10px; margin-bottom: 12px; align-items: center; }\n.dsh-kb-config__src { color: var(--dsw-alias-label-secondary, #888); font-size: 12px; white-space: nowrap; padding-left: 4px; }\n.dsh-kb-config__footer { display: flex; justify-content: flex-end; margin-top: 4px; }\n.dsh-kb-config__footer button {\n  padding: 6px 16px;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  cursor: pointer;\n  transition: background-color 150ms ease;\n}\n.dsh-kb-config__footer button:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }\n.dsh-kb-config__error { color: var(--dsw-alias-state-error-primary, #e5484d); }\n";
+		var config_default = ".dsh-kb-config {\n  /* \u4E0E kanban.css \u5927\u5706\u89D2\u5951\u7EA6\u5BF9\u9F50\uFF08DSH \u5361\u7247 16px\uFF09 */\n  --dsh-kb-config-border: var(--dsw-alias-border-l2, #333);\n  --dsh-kb-config-radius-lg: 16px;\n  --dsh-kb-config-radius-md: 10px;\n  --dsh-kb-config-input: var(--dsw-specific-input-major, rgba(127, 127, 127, 0.12));\n  padding: 16px;\n  font-size: 13px;\n}\n.dsh-kb-config__card { border: 1px solid var(--dsh-kb-config-border); border-radius: var(--dsh-kb-config-radius-lg); padding: 20px; margin-bottom: 16px; }\n.dsh-kb-config__card h3 { margin: 0 0 14px; }\n\n.dsh-kb-config input,\n.dsh-kb-config select {\n  box-sizing: border-box;\n  width: 100%;\n  padding: 8px 12px;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: var(--dsh-kb-config-input);\n  color: var(--dsw-alias-label-primary, inherit);\n  font: inherit;\n  transition: border-color 150ms ease, background-color 150ms ease;\n}\n.dsh-kb-config input:focus,\n.dsh-kb-config select:focus {\n  outline: none;\n  /* \u7126\u70B9/\u9009\u4E2D\u5F3A\u8C03\u8272\u8DDF\u968F\u4E3B\u9898\u524D\u666F\uFF08\u6D45\u8272=\u6697\u3001\u6697\u8272=\u767D\uFF09\uFF0C\u4E0E dsh settings \u8272\u7CFB\u4E00\u81F4 */\n  border-color: var(--dsw-alias-label-primary, currentColor);\n}\n\n/* DSH \u98CE\u683C\u4E0B\u62C9\uFF1Atrigger \u884C\uFF08\u503C + \u203A chevron\uFF09+ \u5F39\u51FA\u83DC\u5355\uFF08\u9009\u4E2D\u6253\u52FE\u3001hover \u9AD8\u4EAE\uFF09 */\n.dsh-kb-config__select { position: relative; min-width: 0; }\n.dsh-kb-config__select-trigger {\n  box-sizing: border-box;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  width: 100%;\n  padding: 8px 12px;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: var(--dsh-kb-config-input);\n  color: var(--dsw-alias-label-primary, inherit);\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n  transition: border-color 150ms ease, background-color 150ms ease;\n}\n.dsh-kb-config__select-trigger:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }\n.dsh-kb-config__select-trigger[aria-expanded='true'] { border-color: var(--dsw-alias-label-primary, currentColor); }\n.dsh-kb-config__select-placeholder { color: var(--dsw-alias-label-tertiary, #999); }\n.dsh-kb-config__select-trigger > span:first-child { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.dsh-kb-config__select-chevron { flex: 0 0 auto; display: inline-flex; color: var(--dsw-alias-label-tertiary, #999); }\n.dsh-kb-config__menu {\n  position: absolute;\n  z-index: 30;\n  top: calc(100% + 6px);\n  left: 0;\n  right: 0;\n  margin: 0;\n  padding: 6px;\n  list-style: none;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-lg);\n  background: var(--dsw-alias-bg-layer-3, #222);\n  color: var(--dsw-alias-label-primary, inherit);\n  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.24);\n  max-height: 260px;\n  overflow: auto;\n}\n.dsh-kb-config__option {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  width: 100%;\n  padding: 8px 10px;\n  border: none;\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n  transition: background-color 150ms ease;\n}\n.dsh-kb-config__option:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }\n.dsh-kb-config__option[data-selected='true'] { color: var(--dsw-alias-state-business-primary, #4b7bff); }\n.dsh-kb-config__option > span:first-child { overflow: hidden; text-overflow: ellipsis; white-space: normal; word-break: break-word; }\n.dsh-kb-config__option-check { flex: 0 0 auto; display: inline-flex; }\n\n.dsh-kb-config__label { display: block; margin: 12px 0 6px; font-weight: 600; }\n.dsh-kb-config__help { color: var(--dsw-alias-label-secondary, #888); font-size: 12px; display: block; margin: 6px 0 0; }\n.dsh-kb-config__role { display: grid; grid-template-columns: 32px 1fr 1fr 1fr auto; gap: 10px; margin-bottom: 12px; align-items: center; }\n.dsh-kb-config__src { color: var(--dsw-alias-label-secondary, #888); font-size: 12px; white-space: nowrap; padding-left: 4px; }\n.dsh-kb-config__footer { display: flex; justify-content: flex-end; margin-top: 4px; }\n.dsh-kb-config__footer button {\n  padding: 6px 16px;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  cursor: pointer;\n  transition: background-color 150ms ease;\n}\n.dsh-kb-config__footer button:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }\n.dsh-kb-config__error { color: var(--dsw-alias-state-error-primary, #e5484d); }\n\n/* \u6A21\u578B\u94FE\u5361\uFF1A\u5BBF\u4E3B provider \u5361\u5C55\u5F00\u98CE\u2014\u2014\u89D2\u8272\u5934\u53EF\u6298\u53E0\u3001\u5B57\u6BB5 label \u5728\u4E0A + \u63A7\u4EF6\u5168\u5BBD\u3001\u964D\u7EA7\u4E3A\u6761\u76EE\u7EC4 */\n.dsh-kb-config__role-block { margin-bottom: 4px; }\n.dsh-kb-config__role-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: 100%;\n  padding: 10px 10px;\n  border: none;\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.dsh-kb-config__role-head:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }\n.dsh-kb-config__chevron { flex: 0 0 auto; display: inline-flex; color: var(--dsw-alias-label-tertiary, #999); transition: transform 150ms ease; }\n.dsh-kb-config__chevron--open { transform: rotate(90deg); }\n.dsh-kb-config__role-summary {\n  margin-left: auto;\n  color: var(--dsw-alias-label-secondary, #888);\n  font-size: 12px;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n/* \u5C55\u5F00\u4F53\u80CC\u666F\u8272\uFF1A\u4E0E\u6298\u53E0\u89D2\u8272\u5934\u5F62\u6210\u5757\u7EA7\u533A\u5206\uFF08\u540C\u5BBF\u4E3B\u8BBE\u7F6E\u5185\u5D4C\u9762\u677F\u5C42\u6B21\uFF09 */\n.dsh-kb-config__role-body {\n  padding: 12px 14px 16px;\n  margin: 8px 0 4px;\n  background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.08));\n  border-radius: var(--dsh-kb-config-radius-md);\n}\n.dsh-kb-config__group-label { display: block; margin: 10px 0 8px; font-weight: 600; }\n.dsh-kb-config__group-label:first-child { margin-top: 0; }\n.dsh-kb-config__field { display: block; margin: 0 0 10px; }\n.dsh-kb-config__field-label { display: block; margin: 0 0 6px; color: var(--dsw-alias-label-secondary, #888); font-size: 12px; }\n.dsh-kb-config__fb-group {\n  margin: 0 0 10px;\n  padding: 10px 12px;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n}\n.dsh-kb-config__fb-head {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  margin: 0 0 8px;\n}\n.dsh-kb-config__fb-title { color: var(--dsw-alias-label-secondary, #888); font-size: 12px; }\n.dsh-kb-config__row-btn {\n  padding: 6px 10px;\n  border: 1px solid var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  font-size: 12px;\n  white-space: nowrap;\n  cursor: pointer;\n  transition: background-color 150ms ease;\n}\n.dsh-kb-config__row-btn:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }\n.dsh-kb-config__row-btn:disabled { opacity: 0.5; cursor: not-allowed; }\n.dsh-kb-config__role-actions { display: flex; gap: 8px; margin-top: 12px; }\n.dsh-kb-config__role--official {\n  display: flex;\n  gap: 10px;\n  align-items: center;\n  margin: 12px 0 0;\n  padding: 8px 10px;\n  border: 1px dashed var(--dsh-kb-config-border);\n  border-radius: var(--dsh-kb-config-radius-md);\n  color: var(--dsw-alias-label-secondary, #888);\n  font-size: 12px;\n}\n.dsh-kb-config__badge {\n  flex: 0 0 auto;\n  padding: 2px 8px;\n  border-radius: 999px;\n  background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12));\n  color: var(--dsw-alias-label-primary, inherit);\n  font-size: 12px;\n  white-space: nowrap;\n}\n.dsh-kb-config__muted { color: var(--dsw-alias-label-tertiary, #999); }\n";
 		
 		// client/index.ts
 		var name = "kanban-board";
-		var inject = ["slots", "sessions"];
+		var inject = ["slots", "sessions", "uiWorkspace"];
 		function apply(ctx) {
 		  setSessionsService(ctx.sessions);
+		  setSessionNavigator(() => ctx.uiWorkspace ?? null);
 		  let style = null;
 		  let configStyle = null;
 		  if (typeof document !== "undefined") {
@@ -2936,6 +3113,7 @@ window.__ModuleLoader__.load({
 		    if (style) style.remove();
 		    if (configStyle) configStyle.remove();
 		    setSessionsService(null);
+		    setSessionNavigator(null);
 		  };
 		}
 		

package/lib/config.d.ts

@@ -19,12 +19,19 @@ export interface KanbanConfig {
             provider: string;
             model: string;
             reasoningEffort?: string;
+            /** 降级候选（顺序=优先序，最多 2 个）；仅 primary 配齐时生效。 */
             fallbacks?: Array<{
                 provider: string;
                 model: string;
                 reasoningEffort?: string;
             }>;
         }>>;
+        /** 全局官方兜底（所有角色共用）：GUI 未配角色链时单候选直用；有配置时垫主+降级链尾。 */
+        chainFallback: {
+            provider: string;
+            model: string;
+            reasoningEffort?: string;
+        };
     };
     dispatcher: {
         staleTimeoutSeconds: number;

package/lib/config.js

@@ -13,7 +13,7 @@ const modelItemSchema = () => Schema.object({
         provider: Schema.string().required(),
         model: Schema.string().required(),
         reasoningEffort: Schema.string().default('high'),
-    })).default([]),
+    })).max(2).default([]),
 });
 export const Config = Schema.object({
     storageDir: Schema.string().default('$DSH_HOME/storages/kanban'),
@@ -25,6 +25,12 @@ export const Config = Schema.object({
         // 角色系统提示词经 personas/kanban-{v,p,w,d}/agent.cordis.yml 组合装配（agentPresets.mount），
         // 随包安装到 $DSH_HOME/.agent-presets/（preset-installer），不再经 config 引用 md 文本。
         models: Schema.dict(modelItemSchema()).default({}),
+        // 官方兜底默认空（不启用）；部署经 bundle patch 配值（如官方账号路由 deepseek-account/deepseek-flash）。
+        chainFallback: Schema.object({
+            provider: Schema.string().default(''),
+            model: Schema.string().default(''),
+            reasoningEffort: Schema.string().default('high'),
+        }).default({ provider: '', model: '', reasoningEffort: 'high' }),
     }),
     dispatcher: Schema.object({
         staleTimeoutSeconds: Schema.number().default(14400),

package/lib/dispatcher/agent-runner.d.ts

@@ -5,6 +5,10 @@ import type { Role } from '../domain/types.js';
 import type { WikiVaultClient } from '../wiki/wiki-vault-client.js';
 import { probeOcr } from '../services/ocr-cli.js';
 import type { AgentModelOptions } from './dispatcher.js';
+/** 关键事件追加落盘 storageDir/dispatcher.log（与 dispatcher.ts 同一文件、同一行格式）——
+ *  agent-runner 未注入 logFile，按 dispatcher 同款方式经 configProvider 派生 storageDir；
+ *  写失败静默忽略（日志只是观测面，事件日志才是事实源）。 */
+export declare function logToDispatcherLog(configProvider: ConfigProvider, msg: string): void;
 /** 角色组合标记（会话10事故根因A）：setup 成功组合角色工具面后写入，live 复用前校验。 */
 interface RoleCompositionMarker {
     role: Role;

package/lib/dispatcher/agent-runner.js

@@ -1,5 +1,6 @@
 import { SessionId } from '@deepseek-ai/dsh-session';
 import { writeFileSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
 import { join } from 'node:path';
 import { probeOcr } from '../services/ocr-cli.js';
 import { installRoleTools, buildReadOnlyWriteGuard, buildDTWriteGuard, buildPlanWriteGuard, buildKbWriteGuard, registerDtTaskChain, unregisterDtTaskChain } from '../roles/toolsets.js';
@@ -7,6 +8,7 @@ import { ensureLocalKbRoot } from '../wiki/local-kb.js';
 import { installCleanFsTools } from '../roles/clean-fs-tools.js';
 import { mountOrRecompose } from '../roles/preset-installer.js';
 import { buildModelCandidates, isModelUnavailableError } from './model-candidates.js';
+import { registerModelChain } from './model-chain.js';
 import { toolName, isGuardSynthesizedReply, lastTurnEnd } from './session-events.js';
 import { filterCandidatesByCatalog } from '../services/llm-catalog.js';
 import { attachSessionToWorkspace, resolveOrCreateWorkspace } from './workspace-attach.js';
@@ -30,14 +32,14 @@ function isInfraError(err) {
 function classifyTurnError(code, message) {
     if (code === 'UNKNOWN_MODEL' || code === 'UNSUPPORTED_REASONING_EFFORT' || code === 'INVALID_REQUEST')
         return 'config';
-    if (code === 'QUOTA' || /quota|rate.?limit|\b429\b/i.test(message) || isInfraError(message))
+    if ((code ?? '').includes('QUOTA') || /quota|rate.?limit|\b429\b|insufficient balance/i.test(message) || isInfraError(message))
         return 'transient';
     return 'unknown';
 }
 /** 关键事件追加落盘 storageDir/dispatcher.log（与 dispatcher.ts 同一文件、同一行格式）——
  *  agent-runner 未注入 logFile，按 dispatcher 同款方式经 configProvider 派生 storageDir；
  *  写失败静默忽略（日志只是观测面，事件日志才是事实源）。 */
-function logToDispatcherLog(configProvider, msg) {
+export function logToDispatcherLog(configProvider, msg) {
     try {
         const storageDir = configProvider.getEffective().storageDir.replace('$DSH_HOME', process.env.DSH_HOME ?? process.cwd());
         writeFileSync(join(storageDir, 'dispatcher.log'), new Date().toISOString() + ' ' + msg + '\n', { flag: 'a' });
@@ -266,7 +268,7 @@ ${task.body}`);
                 (task.attempts > 0 || state.events.some((e) => e.taskId === taskId && e.kind === 'task/claimed'));
             let agent;
             let context = '';
-            const setup = async (agentCtx) => {
+            const setup = async (agentCtx, agent) => {
                 // 思考等级强制（waterfall）：宿主 selection 无 create-options 覆盖层（dsh-host-apiproxy 的
                 // selectionFor 不消费 agentOptions），AgentOptions 也仅有 provider/model/maxTokens——agentOptions
                 // 里的 reasoningEffort 不被宿主消费，新建角色会话思考等级会落回宿主默认。改走 DSH agent/request
@@ -283,7 +285,8 @@ ${task.body}`);
                 // P/W/D = full access（跨目录读：P 读仓库/外部实证、W 读计划、D 执行）；
                 // 但 P 挂 plan 写护栏、W 挂只读护栏（写边界由工具级强制，防"改动源码"，不靠 prompt 软约束）；
                 // PT/DT/V → workspace-write（评审/编排最小权限，PT/DT 只读护栏由 ToolGuard 独立保证）。
-                const session = agentCtx.agent?.session;
+                // approval/sandbox 种子事件经 AgentSetup 第二参的 agent 显式直写（0.2.0 起 ctx.agent 挂载已移除）。
+                const session = agent?.session;
                 session?.append?.('approval/policy', { policy: 'never', source: 'delegation' });
                 const fullAccess = isDExecute || task.assignee === 'p' || task.assignee === 'w';
                 session?.append?.('sandbox/mode', fullAccess ? { mode: 'danger-full-access', source: 'delegation' } : { mode: 'workspace-write', source: 'delegation' });
@@ -318,16 +321,13 @@ ${task.body}`);
                 // PT/DT 是 workspace-write（sandbox_permissions 扩权到天花板是合法功能，剥了破坏官方能力）；
                 // W 虽 fullAccess 但只读护栏全拒 write，shadow 无意义（最小挂载面，V 无执行工具不涉及）。
                 if (task.assignee === 'p' || isDExecute) {
-                    installCleanFsTools(agentCtx, agentCtx.agent);
+                    installCleanFsTools(agentCtx, agent);
                 }
                 // 组合标记——角色工具面成功组合后，把 { role, taskId } 记到进程内 WeakMap（键=Agent 实例）。
-                // 宿主探明：setup 收到的 agentCtx.agent 与发布后 agents.get(id) 返回的是同一 Agent 实例
-                // （dsh-agent types/index.d.ts:38 `agent?: Agent` 安装为 Agent.ctx own property），
-                // 故此处键入的实例即 resumeOrReuse 里 agents.get 命中的实例。agentCtx.agent 缺失（宿主变体）时
-                // 不写标记 → live 复用走工具面校验路径（kanban_complete 可见性），能力无损。
-                const liveAgent = agentCtx.agent;
-                if (liveAgent)
-                    markRoleComposition(liveAgent, { role: task.assignee, taskId: task.id });
+                // AgentSetup 第二参收到的 Agent 与发布后 agents.get(id) 返回的是同一实例，故此处键入的实例
+                // 即 resumeOrReuse 里 agents.get 命中的实例（live 复用走标记匹配，能力无损）。
+                if (agent)
+                    markRoleComposition(agent, { role: task.assignee, taskId: task.id });
                 // 只读评审角色（PT/DT）注册 ToolGuard：拦截 tracked source 写入 / git mutation / 含写标记 bash。
                 // 以 dsh-tools 类型为准：tools.guard(execution => reason|undefined)，execution.name/arguments 为实际字段。
                 if (task.assignee === 'pt' || task.assignee === 'dt') {
@@ -396,7 +396,7 @@ ${task.body}`);
                 const builtCandidates = buildModelCandidates(this.configProvider.getEffective(), task.assignee, this.defaultModel);
                 // 派发前预校验（LLM 目录）：不存在的 provider/model 组合、模型未声明的 reasoningEffort
                 // 直接剔除，不再打进网络白烧会话（UNKNOWN_MODEL / UNSUPPORTED_REASONING_EFFORT 秒退实证形态——
-                // 候选 fallback 只护 create/resume 抛错，turn 期错误不触发切换，必须前置拦截）。
+                // 必须前置拦截）。
                 // fail-open：llm 服务未就绪/目录探测失败 → 全放行，不阻断派发。
                 // 全部候选被拒 → block(model-unavailable) 终态（与 spawn 全候选失败同语义，等人工修配置）。
                 let candidates = builtCandidates;
@@ -422,6 +422,7 @@ ${task.body}`);
                     }
                     candidates = precheck.ok;
                 }
+                let chainStartIndex = 0;
                 if (candidates.length === 0) {
                     // 无任何候选配置：不传 agentOptions（用部署默认），单次尝试
                     agent = hasRunHistory
@@ -435,7 +436,7 @@ ${task.body}`);
                 else {
                     const agents = this.ctx.get('agents');
                     let spawnError = null;
-                    for (const candidate of candidates) {
+                    for (const [candidateIndex, candidate] of candidates.entries()) {
                         try {
                             // hasRunHistory → resumeOrReuse 直接返回 AgentLike（内部已解包 .agent）；create 返回 { agent } 需解包。
                             // 统一归一化为 AgentLike，避免二次解包（h.agent=undefined → if(!agent) 误标 failed）。
@@ -443,6 +444,7 @@ ${task.body}`);
                                 ? await this.resumeOrReuse(agents, task.resumeSessionId ?? `kbn-${taskId}`, { agentOptions: candidate, setup, role: task.assignee, taskId: task.id })
                                 : (await agents.create({ sessionId: SessionId(`kbn-${taskId}`), meta: { cwd: sessionCwd }, agentOptions: candidate, setup })).agent;
                             agent = h;
+                            chainStartIndex = candidateIndex;
                             // 切换成功且非首选 → 发可审计 model/fallback 评论（记录证据，不弹用户）
                             if (candidate !== candidates[0]) {
                                 try {
@@ -468,6 +470,14 @@ ${task.body}`);
                         throw spawnError;
                     }
                 }
+                if (agent && candidates.length > 0) {
+                    registerModelChain(agent, {
+                        candidates,
+                        index: chainStartIndex,
+                        taskId,
+                        comment: async (body) => { await this.kanban.comment(taskId, body, 'system'); },
+                    });
+                }
             }
             catch (err) {
                 // claim/buildContext/spawn 失败也走 failed（attempts 递增）→ 调度器重派/看门狗熔断；不再让任务永久 claimed
@@ -492,7 +502,7 @@ ${task.body}`);
             const attachId = task.resumeSessionId ?? `kbn-${task.id}`;
             await attachSessionToWorkspace(this.ctx, attachId, sessionCwd, 'task ' + task.id + ' ' + task.assignee + '/' + task.mode);
             try {
-                agent.followup({ content: [{ type: 'text', text: context }], source: { kind: 'user' } });
+                agent.followup({ id: randomUUID(), content: [{ type: 'text', text: context }], source: { kind: 'user' } });
                 console.error('[dsh-swarm][debug] runner followup sent ' + taskId);
                 await agent.whenIdle();
                 console.error('[dsh-swarm][debug] runner whenIdle resolved ' + taskId);
@@ -510,7 +520,7 @@ ${task.body}`);
                     : (sessionLike.events ?? []);
                 if (turnEvents.filter((e) => (Number(e?.seq) || 0) > eventsBase).some(isGuardSynthesizedReply)) {
                     console.error('[dsh-swarm][debug] runner guard-synthesized reply detected (from-cache/from-security-guard) ' + taskId + ' — auto followup retry once');
-                    agent.followup({ content: [{ type: 'text', text: '继续未完成的任务：上一条回复是网关安全护栏/语义缓存误拦的合成拒答，并非你的真实结论。请忽略它，从中断处继续执行任务，直至按协议收敛终态（kanban_complete 或 kanban_block）。' }], source: { kind: 'user' } });
+                    agent.followup({ id: randomUUID(), content: [{ type: 'text', text: '继续未完成的任务：上一条回复是网关安全护栏/语义缓存误拦的合成拒答，并非你的真实结论。请忽略它，从中断处继续执行任务，直至按协议收敛终态（kanban_complete 或 kanban_block）。' }], source: { kind: 'user' } });
                     console.error('[dsh-swarm][debug] runner guard-retry followup sent ' + taskId);
                     await agent.whenIdle();
                     console.error('[dsh-swarm][debug] runner guard-retry whenIdle resolved ' + taskId);
@@ -650,7 +660,8 @@ ${task.body}`);
                 // GUI 默认组合 incarnation：缺 kanban_complete → 重跑 setup 幂等补挂后复用。
                 // setup 对 live ctx 的各步均可加：effort waterfall/approval+sandbox append（known 事件类型、
                 // latest-wins）/preset mount（bindings 覆盖）/角色工具（此前为默认组合，无同名冲突）/护栏。
-                await opts.setup(liveCtx);
+                // 双参签名（0.2.0）：repair 重跑 setup 时显式传 live agent 实例（标记随修复自愈）。
+                await opts.setup(liveCtx, live);
                 if (toolsSvc.get('kanban_complete', live))
                     return live; // 修复后必须验证到位，防静默半修复
                 throw new Error('live session composition repair failed: kanban_complete still missing after re-setup (session ' + sessionId + ')');

package/lib/dispatcher/chain-auditor.d.ts

@@ -11,8 +11,9 @@ import type { AuditEvidence, Task } from '../domain/types.js';
  *    a. 作用域收窄：仅扫描会话工作区（session.header.cwd）位于本链发起工作区
  *       （Chain.workspaceDir = /plan: 主 agent 所在工作空间）内的会话，
  *       排除其他项目的主会话（如 评估 项目里调试 dsh-swarm 的会话）；
- *    b. 行为判定：run_code 按实际派发子调用（tool/code-dispatch-start / tool/code-dispatch，
- *       经 rootCallId 关联外层调用）判定是否真的发生写，而非把 run_code 一律视为写；
+ *    b. 行为判定：run_code 按实际派发子调用（新旧宿主双名 tool/code-dispatch[-start] /
+ *       tool/ptc-dispatch[-start]，经 rootCallId 关联外层调用）判定是否真的发生写，而非把
+ *       run_code 一律视为写；
  *    c. 只读排除：bash 命令 / 兜底 code 字符串仅当含写操作标记（BASH_WRITE_RE）且
  *       含 workspacesRoot 路径时才计为写证据；纯只读排查（ls/cat/glob/read/grep）不产生证据。
  * 2. 产物归属核对（fallback，机械可测）：枚举 workspaces/<chainId>/ 下条目；

package/lib/dispatcher/chain-auditor.js

@@ -1,7 +1,7 @@
 // src/dispatcher/chain-auditor.ts
 import { readdirSync } from 'node:fs';
 import { join } from 'node:path';
-import { eventType, toolArgs, toolName } from './session-events.js';
+import { eventType, isRunCodeDispatchEvent, toolArgs, toolName } from './session-events.js';
 import { isPathInside } from './target-repo.js';
 import { headerPresetOf } from './session-preset.js';
 /** 直接写工具（无条件视为写能力；只读工具如 read/glob/grep 不算）。 */
@@ -113,7 +113,7 @@ function sessionWriteEvidence(id, workspacesRoot, events) {
                 }
             }
         }
-        else if (t === 'tool/code-dispatch-start' || t === 'tool/code-dispatch') {
+        else if (isRunCodeDispatchEvent(ev)) {
             const rootCallId = String(dataField(ev, 'rootCallId') ?? '');
             const name = String(dataField(ev, 'name') ?? '');
             if (!rootCallId || !name)

package/lib/dispatcher/model-candidates.d.ts

@@ -2,12 +2,18 @@ import type { KanbanConfig } from '../config.js';
 import type { Role } from '../domain/types.js';
 import type { AgentModelOptions } from './dispatcher.js';
 /**
- * 模型候选链：角色创建时主模型 → fallbacks 依次静默切换。
- * primary = config.roles.models[role]；未配置回退 defaultModel。
+ * 模型候选链（四层）：
+ * ① 角色 primary（config.roles.models[role]）→ ② 降级候选（fallbacks，顺序=优先序，≤2）
+ * → ③ 全局官方兜底（config.roles.chainFallback，恒垫链尾）→ ④ 宿主默认模型（defaultModel）。
+ * 角色链全空 → 官方兜底单候选直用；官方兜底也未配 → 宿主默认模型；都无 → 空链（调用方不传 agentOptions）。
  * reasoningEffort 未指定一律 'high'。
  *
  * @returns 有序候选链（不含不可用者；可能为空 = 无任何配置）
  */
 export declare function buildModelCandidates(config: KanbanConfig, role: Role, defaultModel?: AgentModelOptions): AgentModelOptions[];
-/** 判定 create/resume 错误是否属于 model/provider 不可用（可静默切换下一候选）。 */
+/**
+ * 判定 create/resume 错误是否属于候选不可用（可静默切换下一候选）。
+ * 覆盖三类：provider/model 不可用（无适配器/不存在）、凭据缺失（官方账号未登录
+ * MISSING_CREDENTIAL / 登录提示——不切换会把登录态问题误判成任务失败）。
+ */
 export declare function isModelUnavailableError(err: unknown): boolean;