@joekytc/dsh-swarm 0.3.12 → 0.5.1

package/client/ConfigSection.tsx

@@ -1,9 +1,15 @@
 import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
-import { createConfigStore, type EditableSnapshot, type OcrStatus } from './config-store.js';
-import { ConfigSelect } from './ConfigSelect.js';
+import { createConfigStore, type EditableSnapshot, type ModelFallback, type OcrStatus } from './config-store.js';
+import { ConfigSelect, type ConfigSelectOption } from './ConfigSelect.js';
 
 const ROLES = ['v', 'p', 'w', 'd', 'pt', 'dt'] as const;
 type Model = { provider: string; model: string; reasoningEffort: string };
+/** 单角色降级候选上限（与服务端 schema/派发链合成同口径）。 */
+const MAX_FALLBACKS = 2;
+/** 角色名（对齐 personas 各 kanban preset 目录 preset.yml 的 name 字段）。 */
+const ROLE_NAMES: Record<(typeof ROLES)[number], string> = {
+  v: '看板编排官（V）', p: '规划官（P）', w: '知识官（W）', d: '全栈开发官（D）', pt: '计划审查官（PT）', dt: '交付评审官（DT）',
+};
 
 /** ocr 卡横幅文案：null=已安装无横幅；安装中不显示横幅（spinner 行替代）。 */
 function ocrBanner(ocr: OcrStatus | null, installing: boolean): string | null {
@@ -14,6 +20,8 @@ function ocrBanner(ocr: OcrStatus | null, installing: boolean): string | null {
 }
 
 /** settings.section 配置面板——本地 draft 编辑态、下拉选中即存、级联下拉、来源徽章。
+ *  第二卡「模型链」：每角色主模型级联下拉 + 「+ 降级」追加降级行（provider→model→effort 级联 + 删除，
+ *  顺序=优先序、上限 2）+「复制本链到全部角色」快捷；官方兜底为全局只读尾行（恒垫链尾，编辑入口在部署配置）。
  *  第三卡「评审引擎（ocr）」：安装单飞（组件持轮询定时器 1.5s）、模式切换、托管提供方/模型级联、应用到 ocr。
  *  无「重置」：各用户模型配置不同，无有意义的公共默认值可回退（历史教训：重置按钮已移除，勿再加回）。 */
 export function ConfigSection({ fetchImpl, close }: { fetchImpl?: typeof fetch; close: () => void }) {
@@ -23,6 +31,8 @@ export function ConfigSection({ fetchImpl, close }: { fetchImpl?: typeof fetch;
   const state = useSyncExternalStore(store.subscribe, store.get);
   const [draft, setDraft] = useState<EditableSnapshot | null>(null);
   const [wireResult, setWireResult] = useState<{ ok: boolean; log: string } | null>(null);
+  // 手风琴展开态：undefined=用户未点过（默认展开第一个已配置角色）；null=用户全部收起；字符串=用户点开的角色。
+  const [openRole, setOpenRole] = useState<string | null | undefined>(undefined);
 
   useEffect(() => {
     void store.load().then(() => setDraft(store.get().effective));
@@ -42,14 +52,58 @@ export function ConfigSection({ fetchImpl, close }: { fetchImpl?: typeof fetch;
   if (!draft) return <div className="dsh-kb-config">加载中…</div>;
 
   const commit = (next: EditableSnapshot) => { setDraft(next); void store.save(next); };
-  const setModel = (r: string, patch: Partial<Model>) => {
-    const prev = draft.roles.models[r] ?? { provider: '', model: '', reasoningEffort: '' };
-    commit({ ...draft, roles: { models: { ...draft.roles.models, [r]: { ...prev, ...patch } } } });
+  const roleEntry = (r: string) => draft.roles.models[r] ?? { provider: '', model: '', reasoningEffort: '', fallbacks: [] as ModelFallback[] };
+  const setModel = (r: string, patch: Partial<Model> & { fallbacks?: ModelFallback[] }) => {
+    commit({ ...draft, roles: { models: { ...draft.roles.models, [r]: { ...roleEntry(r), ...patch } } } });
+  };
+  const setFallback = (r: string, idx: number, patch: Partial<Model>) => {
+    const fbs = [...roleEntry(r).fallbacks];
+    const cur = fbs[idx] ?? { provider: '', model: '', reasoningEffort: '' };
+    fbs[idx] = { ...cur, ...patch };
+    setModel(r, { fallbacks: fbs });
+  };
+  const addFallback = (r: string) => {
+    const fbs = roleEntry(r).fallbacks;
+    if (fbs.length >= MAX_FALLBACKS) return;
+    setModel(r, { fallbacks: [...fbs, { provider: '', model: '', reasoningEffort: '' }] });
+  };
+  const removeFallback = (r: string, idx: number) => {
+    setModel(r, { fallbacks: roleEntry(r).fallbacks.filter((_, i) => i !== idx) });
+  };
+  /** 主模型+降级链整体深拷贝到其余角色（顺序=优先序原样保留）。 */
+  const copyChainToAll = (r: string) => {
+    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: 'delegate' | 'managed', managed: { provider: string; model: string }) => {
     commit({ ...draft, reviewEngine: { mode, managed } });
   };
   const onBlur = () => { void store.save(draft); };
+  /** 链字段：label 在上 + 全宽下拉（宿主 provider 卡排版）。 */
+  const chainField = (label: string, value: string, placeholder: string, options: ConfigSelectOption[], onPick: (v: string) => void) => (
+    <label className="dsh-kb-config__field">
+      <span className="dsh-kb-config__field-label">{label}</span>
+      <ConfigSelect value={value} placeholder={placeholder} options={options} onChange={onPick} />
+    </label>
+  );
+  /** 折叠态链摘要：provider/model · N 降级；未配置明示。 */
+  const chainSummary = (m: { provider: string; model: string; fallbacks?: ModelFallback[] }) => {
+    if (!(m.provider && m.model)) return '未配置';
+    const n = (m.fallbacks ?? []).filter((f) => f.provider && f.model).length;
+    return `${m.provider} / ${m.model}` + (n ? ` · ${n} 降级` : '');
+  };
+  const providerOptions = state.catalog.providers.map((p) => ({ value: p.id, label: p.name }));
+  // 手风琴：同一时刻至多一个角色展开；用户未点过时默认展开第一个已配置角色。
+  const expandedRole = openRole === undefined ? 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);
@@ -57,6 +111,8 @@ export function ConfigSection({ fetchImpl, close }: { fetchImpl?: typeof fetch;
   const ocrBlocked = installing || ocr === null || !ocr.installed;
   const re = draft.reviewEngine;
   const managedFieldsEnabled = !ocrBlocked && re.mode === 'managed';
+  // 版本倾斜防御：旧服务端 bundle 快照缺 chainFallback/fallbacks 字段时按空值处理，不崩面板。
+  const cf = draft.chainFallback ?? { provider: '', model: '', reasoningEffort: 'high' };
 
   return (
     <div className="dsh-kb-config">
@@ -74,25 +130,78 @@ export function ConfigSection({ fetchImpl, close }: { fetchImpl?: typeof fetch;
       <section className="dsh-kb-config__card">
         <h3>模型链</h3>
         {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 (
-            <div key={r} className="dsh-kb-config__role">
-              <strong>{r}</strong>
-              <ConfigSelect value={m.provider} placeholder="选择 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: '' }); }} />
-              <ConfigSelect value={m.model} placeholder="选择模型"
-                options={providerModels.map((x) => ({ value: x.id, label: x.name }))}
-                onChange={(v) => { if (v !== m.model) setModel(r, { model: v, reasoningEffort: '' }); }} />
-              <ConfigSelect value={m.reasoningEffort} placeholder="跟随默认"
-                options={efforts.map((x) => ({ value: x.id, label: x.name }))}
-                onChange={(v) => { if (v !== m.reasoningEffort) setModel(r, { reasoningEffort: v }); }} />
-              <span className="dsh-kb-config__src">{state.sources[`roles.models.${r}.model`] === 'override' ? '已覆盖' : '继承'}</span>
+            <div key={r} className="dsh-kb-config__role-block">
+              <button type="button" className="dsh-kb-config__role-head" aria-expanded={open}
+                onClick={() => setOpenRole(open ? null : r)}>
+                <span className={'dsh-kb-config__chevron' + (open ? ' dsh-kb-config__chevron--open' : '')} aria-hidden="true">
+                  <svg width="14" height="14" viewBox="0 0 16 16">
+                    <path d="M6 3.5 10.5 8 6 12.5" fill="none" stroke="currentColor" strokeWidth="1.5"
+                      strokeLinecap="round" strokeLinejoin="round" />
+                  </svg>
+                </span>
+                <strong>{ROLE_NAMES[r]}</strong>
+                {!open && <span className="dsh-kb-config__role-summary">{chainSummary(m)}</span>}
+              </button>
+              {open && (
+                <div className="dsh-kb-config__role-body">
+                  <span className="dsh-kb-config__group-label">主模型</span>
+                  {chainField('供应商', m.provider, '选择 provider', providerOptions,
+                    (v) => { if (v !== m.provider) setModel(r, { provider: v, model: '', reasoningEffort: '' }); })}
+                  {chainField('模型', m.model, '选择模型', providerModels.map((x) => ({ value: x.id, label: x.name })),
+                    (v) => { if (v !== m.model) setModel(r, { model: v, reasoningEffort: '' }); })}
+                  {chainField('思考等级', m.reasoningEffort, '跟随默认', efforts.map((x) => ({ value: x.id, label: x.name })),
+                    (v) => { if (v !== m.reasoningEffort) setModel(r, { reasoningEffort: v }); })}
+                  <span className="dsh-kb-config__group-label">降级（最多 2 个，顺序 = 切换优先序）</span>
+                  {fbs.map((f, i) => {
+                    const fProviderModels = state.catalog.models[f.provider] ?? [];
+                    const fEfforts = fProviderModels.find((x) => x.id === f.model)?.efforts ?? [];
+                    return (
+                      <div key={i} className="dsh-kb-config__fb-group">
+                        <div className="dsh-kb-config__fb-head">
+                          <span className="dsh-kb-config__fb-title">降级 {i + 1}</span>
+                          <button type="button" className="dsh-kb-config__row-btn" title="删除该降级候选"
+                            onClick={() => removeFallback(r, i)}>删除</button>
+                        </div>
+                        {chainField('供应商', f.provider, '选择 provider', providerOptions,
+                          (v) => { if (v !== f.provider) setFallback(r, i, { provider: v, model: '', reasoningEffort: '' }); })}
+                        {chainField('模型', f.model, '选择模型', fProviderModels.map((x) => ({ value: x.id, label: x.name })),
+                          (v) => { if (v !== f.model) setFallback(r, i, { model: v, reasoningEffort: '' }); })}
+                        {chainField('思考等级', f.reasoningEffort, '跟随默认', fEfforts.map((x) => ({ value: x.id, label: x.name })),
+                          (v) => { if (v !== f.reasoningEffort) setFallback(r, i, { reasoningEffort: v }); })}
+                      </div>
+                    );
+                  })}
+                  <div className="dsh-kb-config__role-actions">
+                    {fbs.length < MAX_FALLBACKS && (
+                      <button type="button" className="dsh-kb-config__row-btn" disabled={!configured}
+                        title={configured ? '追加一个降级候选' : '先选好主模型（provider+模型）再追加降级'}
+                        onClick={() => addFallback(r)}>+ 降级</button>
+                    )}
+                    <button type="button" className="dsh-kb-config__row-btn" disabled={!configured}
+                      title="把该角色的主模型+降级链整体复制到其余角色"
+                      onClick={() => copyChainToAll(r)}>复制本链到全部角色</button>
+                  </div>
+                </div>
+              )}
             </div>
           );
         })}
+        <div className="dsh-kb-config__role dsh-kb-config__role--official">
+          <span className="dsh-kb-config__badge">官方兜底</span>
+          {cf.provider && cf.model
+            ? <span>{cf.provider} / {cf.model}（reasoningEffort={cf.reasoningEffort}）</span>
+            : <span className="dsh-kb-config__muted">未配置——角色链全空时走宿主默认模型</span>}
+        </div>
+        <span className="dsh-kb-config__help">
+          派发顺序：主模型 → 降级（顺序=优先序，最多 2 个）→ 官方兜底（恒垫链尾）→ 宿主默认模型；候选不可用（含官方账号未登录）静默切换并留 [model-fallback] 评论
+        </span>
       </section>
       <section className="dsh-kb-config__card">
         <h3>评审引擎（ocr）</h3>

package/client/ConfigSelect.tsx

@@ -36,6 +36,7 @@ export function ConfigSelect({ value, options, placeholder, onChange, onCommit,
     <div className="dsh-kb-config__select" ref={rootRef}>
       <button type="button" className="dsh-kb-config__select-trigger" aria-haspopup="listbox" aria-expanded={open}
         disabled={disabled}
+        title={current?.label ?? placeholder}
         onClick={() => setOpen((v) => !v)}>
         <span className={current ? undefined : 'dsh-kb-config__select-placeholder'}>{current?.label ?? placeholder}</span>
         <span className="dsh-kb-config__select-chevron" aria-hidden="true">

package/client/config-store.ts

@@ -1,11 +1,14 @@
-/** settings.section 插槽注册 id（T9）。 */
+/** settings.section 插槽注册 id。 */
 export const SWARM_CONFIG_NS = 'swarm-config';
 
 /** 手写本地类型：与 src/domain/config-override.ts 的 EditableSnapshot 同形，客户端不 import 服务端。 */
-export interface EditableModelSnapshot { provider: string; model: string; reasoningEffort: string; }
+export interface ModelFallback { provider: string; model: string; reasoningEffort: string; }
+export interface EditableModelSnapshot { provider: string; model: string; reasoningEffort: string; fallbacks: ModelFallback[]; }
 export interface EditableSnapshot {
   wikiVault: { baseUrl: string; pagePrefix: string };
   roles: { models: Partial<Record<string, EditableModelSnapshot>> };
+  /** 官方兜底（全局只读投影）：编辑入口在部署配置，面板仅展示链尾并原样回传。 */
+  chainFallback: ModelFallback;
   reviewEngine: { mode: 'delegate' | 'managed'; managed: { provider: string; model: string } };
   /** 默认投递机器人（预设未命中的落点）。本面板不编辑：用户经 /sms 交互写入，原样回传避免清空。 */
   imDelivery: { fallbackBotId: string };
@@ -25,7 +28,7 @@ export interface ConfigState {
 
 /** 配置外部 store（GET /kanban/config + /kanban/llm-catalog + ocr 运维面；PUT 保存；POST reset），fetch 注入便于测试。 */
 export function createConfigStore(fetchImpl: typeof fetch) {
-  let state: ConfigState = { 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: ConfigState = { 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 = new Set<() => void>();
   const setState = (patch: Partial<ConfigState>) => { state = { ...state, ...patch }; for (const l of [...listeners]) l(); };
   const get = () => state;

package/client/config.css

@@ -88,7 +88,7 @@
 }
 .dsh-kb-config__option:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }
 .dsh-kb-config__option[data-selected='true'] { color: var(--dsw-alias-state-business-primary, #4b7bff); }
-.dsh-kb-config__option > span:first-child { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dsh-kb-config__option > span:first-child { overflow: hidden; text-overflow: ellipsis; white-space: normal; word-break: break-word; }
 .dsh-kb-config__option-check { flex: 0 0 auto; display: inline-flex; }
 
 .dsh-kb-config__label { display: block; margin: 12px 0 6px; font-weight: 600; }
@@ -108,3 +108,91 @@
 }
 .dsh-kb-config__footer button:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }
 .dsh-kb-config__error { color: var(--dsw-alias-state-error-primary, #e5484d); }
+
+/* 模型链卡：宿主 provider 卡展开风——角色头可折叠、字段 label 在上 + 控件全宽、降级为条目组 */
+.dsh-kb-config__role-block { margin-bottom: 4px; }
+.dsh-kb-config__role-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  padding: 10px 10px;
+  border: none;
+  border-radius: var(--dsh-kb-config-radius-md);
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+}
+.dsh-kb-config__role-head:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }
+.dsh-kb-config__chevron { flex: 0 0 auto; display: inline-flex; color: var(--dsw-alias-label-tertiary, #999); transition: transform 150ms ease; }
+.dsh-kb-config__chevron--open { transform: rotate(90deg); }
+.dsh-kb-config__role-summary {
+  margin-left: auto;
+  color: var(--dsw-alias-label-secondary, #888);
+  font-size: 12px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+/* 展开体背景色：与折叠角色头形成块级区分（同宿主设置内嵌面板层次） */
+.dsh-kb-config__role-body {
+  padding: 12px 14px 16px;
+  margin: 8px 0 4px;
+  background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.08));
+  border-radius: var(--dsh-kb-config-radius-md);
+}
+.dsh-kb-config__group-label { display: block; margin: 10px 0 8px; font-weight: 600; }
+.dsh-kb-config__group-label:first-child { margin-top: 0; }
+.dsh-kb-config__field { display: block; margin: 0 0 10px; }
+.dsh-kb-config__field-label { display: block; margin: 0 0 6px; color: var(--dsw-alias-label-secondary, #888); font-size: 12px; }
+.dsh-kb-config__fb-group {
+  margin: 0 0 10px;
+  padding: 10px 12px;
+  border: 1px solid var(--dsh-kb-config-border);
+  border-radius: var(--dsh-kb-config-radius-md);
+}
+.dsh-kb-config__fb-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin: 0 0 8px;
+}
+.dsh-kb-config__fb-title { color: var(--dsw-alias-label-secondary, #888); font-size: 12px; }
+.dsh-kb-config__row-btn {
+  padding: 6px 10px;
+  border: 1px solid var(--dsh-kb-config-border);
+  border-radius: var(--dsh-kb-config-radius-md);
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  white-space: nowrap;
+  cursor: pointer;
+  transition: background-color 150ms ease;
+}
+.dsh-kb-config__row-btn:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }
+.dsh-kb-config__row-btn:disabled { opacity: 0.5; cursor: not-allowed; }
+.dsh-kb-config__role-actions { display: flex; gap: 8px; margin-top: 12px; }
+.dsh-kb-config__role--official {
+  display: flex;
+  gap: 10px;
+  align-items: center;
+  margin: 12px 0 0;
+  padding: 8px 10px;
+  border: 1px dashed var(--dsh-kb-config-border);
+  border-radius: var(--dsh-kb-config-radius-md);
+  color: var(--dsw-alias-label-secondary, #888);
+  font-size: 12px;
+}
+.dsh-kb-config__badge {
+  flex: 0 0 auto;
+  padding: 2px 8px;
+  border-radius: 999px;
+  background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12));
+  color: var(--dsw-alias-label-primary, inherit);
+  font-size: 12px;
+  white-space: nowrap;
+}
+.dsh-kb-config__muted { color: var(--dsw-alias-label-tertiary, #999); }

package/client/index.ts

@@ -15,14 +15,15 @@ declare module '@deepseek-ai/cordis' {
 }
 import { ConfigSection } from './ConfigSection.js';
 import { SWARM_CONFIG_NS } from './config-store.js';
-import { setSessionsService } from './session-bridge.js';
+import { setSessionsService, setSessionNavigator } from './session-bridge.js';
 import css from './kanban.css';
 import configCss from './config.css';
 
 export const name = 'kanban-board';
 
-/** 所需 client 服务（cordis fiber inject——loader 把模块导出当作对象插件传入）。 */
-export const inject = ['slots', 'sessions'];
+/** 所需 client 服务（cordis fiber inject——loader 把模块导出当作对象插件传入）。
+ *  uiWorkspace：0.1.7 起宿主内置的视图所有者导航（会话跳转新接缝），fiber inject 会等待其就绪。 */
+export const inject = ['slots', 'sessions', 'uiWorkspace'];
 
 /** 浏览器半入口（roster 行 id: kanban-board）：把看板挂到 conversation.view（会话中心 tab，additive）。
  *  对齐 DSH 原生注册：对话(id=chat, order=0) → 轨迹(id=trajectory, order=10) → 看板(id=kanban, order=20)。
@@ -32,6 +33,9 @@ export function apply(ctx: Context): (() => void) | void {
   // cast：@deepseek-ai/dsh-session（服务端包）也 merge 了 cordis Context.sessions: SessionStore，
   // 类型面被其覆盖；浏览器半运行时注入的实为 dsh-api-session-controller 的 ISessions。
   setSessionsService(ctx.sessions as unknown as ISessions);
+  // 会话跳转导航：0.2.0+ 宿主提供 uiWorkspace（视图所有者），但注册晚于 client apply——
+  // 只传惰性 getter（点击时解析+try/catch 降级），apply 期绝不触碰属性，防 cordis 未就绪 throw 炸掉入口注册。
+  setSessionNavigator(() => (ctx as { uiWorkspace?: { openSession(target: string): void } }).uiWorkspace ?? null);
   let style: HTMLStyleElement | null = null;
   let configStyle: HTMLStyleElement | null = null;
   if (typeof document !== 'undefined') {
@@ -62,5 +66,5 @@ export function apply(ctx: Context): (() => void) | void {
       ConfigSection as never,
     ),
   );
-  return () => { if (style) style.remove(); if (configStyle) configStyle.remove(); setSessionsService(null); };
+  return () => { if (style) style.remove(); if (configStyle) configStyle.remove(); setSessionsService(null); setSessionNavigator(null); };
 }

package/client/session-bridge.ts

@@ -32,8 +32,32 @@ export function useSessionIds(): ReadonlySet<string> {
   );
 }
 
-/** 应用内跳转到指定会话（宿主 ISessions.open 对不在列表的 id fail loud，调用方须先经 useSessionIds 门控）。 */
+/** 新宿主导航接缝：dsh 0.2.0 起 ISessions.open 移除，会话导航归视图所有者（uiWorkspace.openSession）。
+ *  宿主以 getter 惰性供给（uiWorkspace 注册晚于 client apply，apply 期属性访问会在 cordis 上 throw）；
+ *  0.1.7 底线宿主无此服务，getter 返回 null 走旧 open 转发。 */
+let navigator: (() => { openSession(target: string): void } | null) | null = null;
+
+export function setSessionNavigator(next: (() => { openSession(target: string): void } | null) | null): void {
+  navigator = next;
+}
+
+/** 应用内跳转到指定会话（调用方须先经 useSessionIds 门控，宿主对不在列表的 id fail loud）。 */
 export function openSession(id: string): void {
+  // 优先 0.2.0+ 视图所有者导航；解析失败视同服务缺席；旧宿主退回 ISessions.open 转发；两者皆缺则响亮报错。
+  if (navigator) {
+    let viaWorkspace: { openSession(target: string): void } | null = null;
+    try {
+      viaWorkspace = navigator();
+    } catch {
+      viaWorkspace = null;
+    }
+    if (viaWorkspace) {
+      viaWorkspace.openSession(id);
+      return;
+    }
+  }
   if (!service) throw new Error('sessions service unavailable');
-  service.open(id as never);
+  const open = (service as { open?: (target: string) => void }).open;
+  if (!open) throw new Error('host exposes neither uiWorkspace nor sessions.open; session jump unavailable');
+  open(id);
 }

package/cordis.patch.yml

@@ -26,58 +26,16 @@
           staleTimeoutSeconds: 14400
           maxRetries: 3
           heartbeatIntervalSeconds: 300
-        # 角色模型候选链（Task 12）：逐角色 primary + fallbacks，主模型不可用静默切换（[model-fallback] 证据），
-        # 全候选不可用 → block(model-unavailable) 抛用户；reasoningEffort 缺省 high。部署实际值以本文件为准。
+        # 角色模型链：GUI 配置面板（模型链卡）为唯一编辑入口——逐角色 primary + fallbacks(≤2)，
+        # 主模型不可用静默切换（[model-fallback] 证据），全候选不可用 → block(model-unavailable) 抛用户；
+        # reasoningEffort 缺省 high。本 patch 不再硬编码角色模型，仅保留全局官方兜底：
+        # GUI 未配角色链 → 官方兜底单候选直用；有配置 → 官方兜底恒垫链尾（官方账号路由，登录态授权；
+        # 未登录 MISSING_CREDENTIAL 归入候选切换判定，不误判任务失败）。
         roles:
-          models:
-            v:
-              provider: 'ark'
-              model: 'deepseek-v4-flash'
-              reasoningEffort: 'high'
-              fallbacks:
-                - provider: 'openai'
-                  model: 'gpt-5.6-sol'
-                  reasoningEffort: 'high'
-            p:
-              provider: 'ark'
-              model: 'deepseek-v4-flash'
-              reasoningEffort: 'high'
-              fallbacks:
-                - provider: 'openai'
-                  model: 'gpt-5.6-sol'
-                  reasoningEffort: 'high'
-            w:
-              provider: 'ark'
-              model: 'deepseek-v4-flash'
-              reasoningEffort: 'high'
-              fallbacks:
-                - provider: 'openai'
-                  model: 'gpt-5.6-sol'
-                  reasoningEffort: 'high'
-            d:
-              provider: 'ark'
-              model: 'deepseek-v4-flash'
-              reasoningEffort: 'high'
-              fallbacks:
-                - provider: 'openai'
-                  model: 'gpt-5.6-sol'
-                  reasoningEffort: 'high'
-            pt:
-              provider: 'ark'
-              model: 'deepseek-v4-flash'
-              reasoningEffort: 'high'
-              fallbacks:
-                - provider: 'openai'
-                  model: 'gpt-5.6-sol'
-                  reasoningEffort: 'high'
-            dt:
-              provider: 'ark'
-              model: 'deepseek-v4-flash'
-              reasoningEffort: 'high'
-              fallbacks:
-                - provider: 'openai'
-                  model: 'gpt-5.6-sol'
-                  reasoningEffort: 'high'
+          chainFallback:
+            provider: 'deepseek-account'
+            model: 'deepseek-flash'
+            reasoningEffort: 'high'
         prefixRoutes:
           plan: '/plan:'
           openspec: '/openspec:'
@@ -85,4 +43,4 @@
           enabled: true
           contentMinWidth: 715
           contentMaxWidth: 780
-          sseHeartbeatSeconds: 20
+          sseHeartbeatSeconds: 10