@joekytc/dsh-swarm 0.1.2 → 0.2.0

package/README.md

@@ -35,7 +35,7 @@ Six roles are dispatched by the scheduler as one-shot agent sessions (determinis
 | **V** | Orchestrator | Drives the phase machine, creates one card per phase, posts `[blocked-review]` guidance on stalls. Never executes. | `kanban_create` + task tools + spec view |
 | **P** | Planner | Reads spec + repo facts (incl. read-only self-checks), writes an OpenSpec implementation plan, opts into PT via `pt_decision.needed`. Never executes. | Task tools + spec view, read-only (writes only `openspec/changes/`) |
 | **PT** | Plan reviewer | Read-only review of P's plan (requirements alignment, completeness, logic). Outputs verdict + issues. | Task tools + spec view, **read-only ToolGuard** |
-| **W** | Wiki bridge | W2/W3 KB sync (`w:kb`). Never touches code/git. | Task tools + `wiki_search/read/write` + read-only spec view |
+| **W** | Knowledge officer | W2/W3 KB sync (`w:kb`). Never touches code/git. | Task tools + `wiki_search/read/write` (remote) / `skill`→llm-wiki (local) + read-only spec view |
 | **D** | Executor | The *only* role that writes code: worktree → implement → verify → `[AI-GEN]` commit → push feature branch (merging into the spec-declared target branch is done by the system only after DT passes). | Task tools + wiki read + bash/fs/run_code (full dev) + subagent (spawn/fork/list-agents) + goal |
 | **DT** | Implementation reviewer | Empirically verifies D's work (test/build/typecheck/diff/git + open-code-review), writes review page to KB. Read-only against the repo. | Task tools + wiki read/write (review namespace) + bash/fs/run_code, **read-only ToolGuard** |
 
@@ -132,7 +132,7 @@ All keys are optional; defaults shown. Schema lives in `src/config.ts`.
 |---|---|---|
 | `storageDir` | `$DSH_HOME/storages/kanban` | Event log (`events.jsonl`), orchestration state, per-task workspaces, `dispatcher.log` |
 | `wikiVault.baseUrl` | `''` (empty) | wiki-vault HTTP service for KB reads/writes — required for KB features; set to your own server |
-| `wikiVault.pagePrefix` | `projects/` | Whitelist prefix for W page writes |
+| `wikiVault.pagePrefix` | `projects/` | Whitelist root prefix; actual page paths are projects/<repoSlug>/… (repoSlug derived from the chain workspaceDir) |
 | `roles.models.<role>` | `{}` | Per-role model: `{ provider, model, reasoningEffort?, fallbacks?[] }` |
 | `roles.models.<role>.reasoningEffort` | `high` | Default reasoning effort for all roles |
 | `roles.models.<role>.fallbacks` | `[]` | Silent fallback candidates (audited via `[model-fallback]` comment) |
@@ -188,7 +188,7 @@ Key guarantees (two):
   creates chains or tasks — "who decided to run what" stays explicit and auditable.
 - **Session binding prevents cross-task escalation** (a W agent bound to task A
   cannot complete/block task B even though both are W tasks); DT writes are
-  confined to the `projects/<chain>/review/` namespace by a ToolGuard on top of
+  confined to the `projects/<repoSlug>/<chain>/review/` namespace by a ToolGuard on top of
   the matrix; and no role agent can approve specs, unblock, or confirm audits —
   those are human trust anchors; `system` handles only mechanical bookkeeping.
 

package/README.zh-CN.md

@@ -35,7 +35,7 @@ dsh-swarm 针对以上三种问题编码了*契约*：每个角色只有一项
 | **V** | 编排者 | 驱动相位机，逐相位建卡，停滞时发布 `[blocked-review]` 指引。绝不执行。 | `kanban_create` + 任务工具 + 规格查看 |
 | **P** | 规划者 | 读取规格 + 仓库事实（含只读自查），编写 OpenSpec 实施计划，用 `pt_decision.needed` 决定是否需要 PT。绝不执行。 | 任务工具 + 规格查看，只读（仅写 `openspec/changes/`） |
 | **PT** | 计划评审者 | 对 P 的计划做只读评审（需求对齐、完整性、逻辑）。输出裁决 + 问题清单。 | 任务工具 + 规格查看，**只读 ToolGuard** |
-| **W** | 知识库桥 | W2/W3 知识库同步（`w:kb`）。绝不碰代码/git。 | 任务工具 + `wiki_search/read/write` + 只读规格查看 |
+| **W** | 知识官 | W2/W3 知识库同步（`w:kb`）。绝不碰代码/git。 | 任务工具 + 远程 `wiki_search/read/write` / 本地 `skill`→llm-wiki + 只读规格查看 |
 | **D** | 执行者 | *唯一*写代码的角色：worktree → 实现 → 验证 → `[AI-GEN]` 提交 → 推送特性分支（合入规格声明的目标分支由 system 在 DT 通过后执行）。 | 任务工具 + wiki 只读 + bash/fs/run_code（完整开发面）+ subagent（spawn/fork/list-agents）+ goal |
 | **DT** | 实现评审者 | 实证验证 D 的工作（test/build/typecheck/diff/git + open-code-review），把评审页写入知识库。对仓库只读。 | 任务工具 + wiki 读写（评审命名空间）+ bash/fs/run_code，**只读 ToolGuard** |
 
@@ -123,7 +123,7 @@ dsh plugin --profile <name> add ./dsh-swarm
 |---|---|---|
 | `storageDir` | `$DSH_HOME/storages/kanban` | 事件日志（`events.jsonl`）、编排状态、每任务工作区、`dispatcher.log` |
 | `wikiVault.baseUrl` | `''`（空） | 知识库读写用的 wiki-vault HTTP 服务——知识库功能必需，填你自己的服务地址 |
-| `wikiVault.pagePrefix` | `projects/` | W 页面写入的白名单前缀 |
+| `wikiVault.pagePrefix` | `projects/` | W 页面写入的白名单根前缀；页面实际路径为 projects/<repoSlug>/…（repoSlug 由链 workspaceDir 派生） |
 | `roles.models.<role>` | `{}` | 每角色模型：`{ provider, model, reasoningEffort?, fallbacks?[] }` |
 | `roles.models.<role>.reasoningEffort` | `high` | 所有角色默认推理强度 |
 | `roles.models.<role>.fallbacks` | `[]` | 静默回退候选（经 `[model-fallback]` 评论审计） |
@@ -178,7 +178,7 @@ dsh plugin --profile <name> add ./dsh-swarm
   从不建链/建任务——"谁决定运行什么"保持显式、可审计。
 - **会话绑定阻止跨任务越权**（绑定到任务 A 的 W agent，即使任务 B 同为 W 任务，也
   不能 complete/block 任务 B）；DT 的写入被矩阵之上的 ToolGuard 限定在
-  `projects/<chain>/review/` 命名空间；且任何角色 agent 都不能批准规格、解除阻塞或
+  `projects/<repoSlug>/<chain>/review/` 命名空间；且任何角色 agent 都不能批准规格、解除阻塞或
   确认审计——这些是人类信任锚；`system` 只做机械性记账。
 
 ### 交付契约（上游欠下游）

package/client/BoardCard.tsx

@@ -1,11 +1,16 @@
 import type { TaskCardView } from './workflow-model.js';
+import { openSession, useSessionIds } from './session-bridge.js';
 
 /** T26：双行 Profile 任务卡。Profile 只用于头像/节点强调，不整卡染色。
- *  角色卡标题不可改（仅需求链标题可改），根元素为 div role=button。 */
-export function BoardCard(props: { view: TaskCardView; onOpen: (taskId: string) => void }) {
+ *  角色卡标题不可改（仅需求链标题可改），根元素为 div role=button。
+ *  「会话」按钮：真实会话（resumeSessionId ?? sessionId）在宿主列表时显示，点击应用内跳转，不触发开详情；
+ *  跳会话后经 onOpenView('chat', sessionId) 切回对话视图（openView 由宿主 conversation shell 经 owner props 下发）。 */
+export function BoardCard(props: { view: TaskCardView; onOpen: (taskId: string) => void; onOpenView?: (view: string, focus: string) => void }) {
   const { view } = props;
   const { task } = view;
   const blocked = view.lineState === 'blocked' && view.dependencyLabel.length > 0;
+  const sessionIds = useSessionIds();
+  const sessionId = task.resumeSessionId ?? task.sessionId;
   return (
     <div
       role="button"
@@ -21,6 +26,23 @@ export function BoardCard(props: { view: TaskCardView; onOpen: (taskId: string)
       <span className={`dsh-kb-profile dsh-kb-profile--${task.assignee}`}>{task.assignee.toUpperCase()}</span>
       <span className="dsh-kb-task__title">{task.title}</span>
       <span className="dsh-kb-task__status-row">
+        {sessionIds.has(sessionId) && (
+          <button
+            type="button"
+            className="dsh-kb-task__session"
+            onClick={(e) => {
+              e.stopPropagation();
+              openSession(sessionId);
+              props.onOpenView?.('chat', sessionId);
+              // 宿主会话切换异步落位，首次 openView 偶发写入旧会话 store 被吞；500ms 后重试兜底。
+              // 若首枪已生效，看板 tab 卸载，回调只是幂等的 store 写入，无副作用；不设 unmount 清理是有意为之。
+              window.setTimeout(() => props.onOpenView?.('chat', sessionId), 500);
+            }}
+            onKeyDown={(e) => { e.stopPropagation(); }}
+          >
+            会话
+          </button>
+        )}
         <span className="dsh-kb-task__status">{view.statusLabel}</span>
       </span>
       <span className="dsh-kb-task__meta">

package/client/ConfigSection.tsx

@@ -0,0 +1,71 @@
+import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { createConfigStore, type EditableSnapshot } from './config-store.js';
+import { ConfigSelect } from './ConfigSelect.js';
+
+const ROLES = ['v', 'p', 'w', 'd', 'pt', 'dt'] as const;
+type Model = { provider: string; model: string; reasoningEffort: string };
+
+/** T9：settings.section 配置面板——本地 draft 编辑态、下拉选中即存、级联下拉、来源徽章、右下角重置。 */
+export function ConfigSection({ fetchImpl, close }: { fetchImpl?: typeof fetch; close: () => void }) {
+  const storeRef = useRef<ReturnType<typeof createConfigStore> | null>(null);
+  if (!storeRef.current) storeRef.current = createConfigStore(fetchImpl ?? ((...args: Parameters<typeof fetch>) => fetch(...args)));
+  const store = storeRef.current;
+  const state = useSyncExternalStore(store.subscribe, store.get);
+  const [draft, setDraft] = useState<EditableSnapshot | null>(null);
+
+  useEffect(() => {
+    void store.load().then(() => setDraft(store.get().effective));
+  }, [store]);
+
+  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 onBlur = () => { void store.save(draft); };
+
+  return (
+    <div className="dsh-kb-config">
+      <section className="dsh-kb-config__card">
+        <h3>知识库</h3>
+        <label className="dsh-kb-config__label">baseUrl</label>
+        <input value={draft.wikiVault.baseUrl} onBlur={onBlur}
+          onChange={(e) => setDraft({ ...draft, wikiVault: { ...draft.wikiVault, baseUrl: e.target.value } })} />
+        <span className="dsh-kb-config__help">llm-wiki 知识库外链 HTTP 地址（如 http://192.168.122.111:3000）；留空则使用本地 llm-wiki 兜底</span>
+        <label className="dsh-kb-config__label">pagePrefix</label>
+        <input value={draft.wikiVault.pagePrefix} onBlur={onBlur}
+          onChange={(e) => setDraft({ ...draft, wikiVault: { ...draft.wikiVault, pagePrefix: e.target.value } })} />
+        <span className="dsh-kb-config__help">llm-wiki 页面路径前缀（如 projects/）</span>
+      </section>
+      <section className="dsh-kb-config__card">
+        <h3>模型链</h3>
+        {ROLES.map((r) => {
+          const m = draft.roles.models[r] ?? { provider: '', model: '', reasoningEffort: '' };
+          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>
+          );
+        })}
+      </section>
+      <div className="dsh-kb-config__footer">
+        <button onClick={() => { void store.reset().then((r) => setDraft(r.effective)); }}>重置</button>
+      </div>
+      {state.error && <div className="dsh-kb-config__error">{state.error}</div>}
+    </div>
+  );
+}

package/client/ConfigSelect.tsx

@@ -0,0 +1,69 @@
+import { useEffect, useRef, useState } from 'react';
+
+export interface ConfigSelectOption { value: string; label: string }
+
+/**
+ * DSH 风格下拉：trigger 行（值 + › chevron）+ 弹出菜单（选中打勾、hover 高亮）。
+ * 对齐 dsh settings 页 picker 交互：点击外部/Esc 关闭，选中即提交。
+ */
+export function ConfigSelect({ value, options, placeholder, onChange, onCommit }: {
+  value: string;
+  options: ConfigSelectOption[];
+  placeholder: string;
+  onChange: (value: string) => void;
+  onCommit?: () => void;
+}) {
+  const [open, setOpen] = useState(false);
+  const rootRef = useRef<HTMLDivElement | null>(null);
+
+  useEffect(() => {
+    if (!open) return;
+    const onDocDown = (e: MouseEvent) => {
+      if (rootRef.current && !rootRef.current.contains(e.target as Node)) setOpen(false);
+    };
+    const onKey = (e: KeyboardEvent) => { if (e.key === 'Escape') setOpen(false); };
+    document.addEventListener('mousedown', onDocDown);
+    document.addEventListener('keydown', onKey);
+    return () => {
+      document.removeEventListener('mousedown', onDocDown);
+      document.removeEventListener('keydown', onKey);
+    };
+  }, [open]);
+
+  const current = options.find((o) => o.value === value);
+  return (
+    <div className="dsh-kb-config__select" ref={rootRef}>
+      <button type="button" className="dsh-kb-config__select-trigger" aria-haspopup="listbox" aria-expanded={open}
+        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">
+          <svg width="12" height="12" 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>
+      </button>
+      {open && (
+        <ul className="dsh-kb-config__menu" role="listbox">
+          {options.map((o) => (
+            <li key={o.value || '__empty__'}>
+              <button type="button" role="option" aria-selected={o.value === value}
+                className="dsh-kb-config__option" data-selected={o.value === value || undefined}
+                onClick={() => { onChange(o.value); setOpen(false); onCommit?.(); }}>
+                <span>{o.label}</span>
+                {o.value === value && (
+                  <span className="dsh-kb-config__option-check" aria-hidden="true">
+                    <svg width="14" height="14" viewBox="0 0 16 16">
+                      <path d="M3 8.5 6.5 12 13 4.5" fill="none" stroke="currentColor" strokeWidth="1.5"
+                        strokeLinecap="round" strokeLinejoin="round" />
+                    </svg>
+                  </span>
+                )}
+              </button>
+            </li>
+          ))}
+        </ul>
+      )}
+    </div>
+  );
+}

package/client/KanbanBoard.tsx

@@ -15,6 +15,8 @@ export function KanbanBoard(props: {
   postAction(action: unknown): Promise<unknown>;
   /** purge 类操作无事件流，成功后需重拉权威快照。 */
   onResync?(): Promise<void>;
+  /** 会话跳转后切回对话视图：透传给 WorkflowRail→BoardCard，由宿主 conversation shell owner props（openView）下发。 */
+  onOpenView?(view: string, focus: string): void;
 }) {
   const { board } = props.snapshot;
   const [collapsed, setCollapsed] = useState<Set<string>>(() => defaultCollapsed());
@@ -155,6 +157,7 @@ export function KanbanBoard(props: {
         onToggleFilter={toggleFilter}
         onToggleChain={toggleChain}
         onOpenTask={openTask}
+        onOpenView={props.onOpenView}
         onConfirmAudit={(chainId) => void runAction({ type: 'confirm-audit', chainId })}
         onRenameChain={(chainId, title) => void runAction({ type: 'rename', chainId, title })}
         onDeleteChain={async (chainId) => {

package/client/KanbanTab.tsx

@@ -4,8 +4,9 @@ import { useKanbanBoard } from './useKanbanBoard.js';
 import { KanbanBoard } from './KanbanBoard.js';
 import { ConnectionBanner } from './ConnectionBanner.js';
 
-/** T30：会话中心 conversation.view 第三个 tab（对话→轨迹→看板）。全高布局，无浮层/拖拽/宽度记忆。 */
-export function KanbanTab(props: { store?: BoardStore } = {}) {
+/** T30：会话中心 conversation.view 第三个 tab（对话→轨迹→看板）。全高布局，无浮层/拖拽/宽度记忆。
+ *  会话跳转后切回对话视图：宿主 conversation shell 经 owner props 下发 openView，透传至看板。 */
+export function KanbanTab(props: { store?: BoardStore; openView?: (view: string, focus: string) => void } = {}) {
   const own = useMemo(() => props.store ?? createBoardStore(), [props.store]);
   const snapshot = useKanbanBoard(own);
 
@@ -19,7 +20,7 @@ export function KanbanTab(props: { store?: BoardStore } = {}) {
     <div className="dsh-kb-tab" role="region" aria-label="看板">
       <ConnectionBanner connection={snapshot.connection} lastSuccessAt={snapshot.lastSuccessAt} onRetry={() => void own.retry()} />
       {snapshot.board
-        ? <KanbanBoard snapshot={snapshot} postAction={(action) => own.postAction(action)} onResync={() => own.retry()} />
+        ? <KanbanBoard snapshot={snapshot} onOpenView={props.openView} postAction={(action) => own.postAction(action)} onResync={() => own.retry()} />
         : <div className="dsh-kb-loading">加载看板…</div>}
     </div>
   );

package/client/TaskDrawer.tsx

@@ -42,7 +42,7 @@ export function TaskDrawer(props: {
 }) {
   const { task, events, handoff, specCard, chain } = props;
   const [tab, setTab] = useState<string>('overview');
-  const [pending, setPending] = useState<{ kind: 'block' | 'complete' | 'archive'; value: string } | null>(null);
+  const [pending, setPending] = useState<{ kind: 'archive'; value: string } | null>(null);
   const timeline = events.filter((e) => e.taskId === task.id).toSorted((a, b) => a.seq - b.seq);
   const comments = timeline.filter((e) => e.kind === 'task/commented');
   const submitComment = (el: HTMLInputElement) => {
@@ -51,20 +51,12 @@ export function TaskDrawer(props: {
     props.onComment(value);
     el.value = '';
   };
-  const arm = (kind: 'block' | 'complete' | 'archive') => {
+  const arm = (kind: 'archive') => {
     setPending({ kind, value: '' });
     if (kind === 'archive') {
       window.setTimeout(() => setPending((current) => (current?.kind === 'archive' ? null : current)), 3000);
     }
   };
-  // T32 fix：complete/block 服务端强制要求 summary/reason，在确认态内联收集，避免 400 后永久失败
-  const submitPayload = (kind: 'block' | 'complete') => {
-    if (pending?.kind !== kind || !pending.value.trim()) return;
-    const value = pending.value;
-    setPending(null);
-    if (kind === 'block') props.onAction({ type: 'block', taskId: task.id, reason: value });
-    else props.onAction({ type: 'complete', taskId: task.id, summary: value });
-  };
   const submitArchive = () => {
     if (pending?.kind !== 'archive') return;
     setPending(null);
@@ -84,8 +76,6 @@ export function TaskDrawer(props: {
         ) : null}
         {!props.readOnly && (
           <div className="dsh-kb-detail__actions">
-          {task.status === 'running' && <button type="button" onClick={() => arm('complete')}>完成</button>}
-          {task.status === 'running' && <button type="button" onClick={() => arm('block')}>阻塞</button>}
           {task.status === 'blocked' && <button type="button" onClick={() => props.onAction({ type: 'unblock', taskId: task.id })}>解除阻塞</button>}
           {task.status === 'failed' && <button type="button" onClick={() => props.onAction({ type: 'retry', taskId: task.id })}>重试</button>}
           {['done', 'failed', 'blocked'].includes(task.status) && (
@@ -93,20 +83,6 @@ export function TaskDrawer(props: {
               {pending?.kind === 'archive' ? '确认归档' : '归档'}
             </button>
           )}
-          {pending?.kind === 'complete' && (
-            <span className="dsh-kb-action-form">
-              <input aria-label="交接摘要" value={pending.value} onChange={(e) => setPending({ kind: 'complete', value: e.target.value })} placeholder="交接摘要" />
-              <button type="button" disabled={!pending.value.trim()} onClick={() => submitPayload('complete')}>确认完成</button>
-              <button type="button" onClick={() => setPending(null)}>取消</button>
-            </span>
-          )}
-          {pending?.kind === 'block' && (
-            <span className="dsh-kb-action-form">
-              <input aria-label="阻塞原因" value={pending.value} onChange={(e) => setPending({ kind: 'block', value: e.target.value })} placeholder="阻塞原因" />
-              <button type="button" disabled={!pending.value.trim()} onClick={() => submitPayload('block')}>确认阻塞</button>
-              <button type="button" onClick={() => setPending(null)}>取消</button>
-            </span>
-          )}
           </div>
         )}
       </header>

package/client/WorkflowRail.tsx

@@ -22,6 +22,8 @@ export function WorkflowRail(props: {
   onToggleFilter(filter: ChainFilter): void;
   onToggleChain(chainId: string): void;
   onOpenTask(taskId: string): void;
+  /** 会话跳转后切回对话视图：透传给 BoardCard，由宿主 conversation shell owner props（openView）下发。 */
+  onOpenView?(view: string, focus: string): void;
   /** D23：用户 GUI 确认链完成产物归属（POST /kanban/action {type:'confirm-audit'}）。 */
   onConfirmAudit?(chainId: string): void;
   /** T7：GUI 链标题改名（POST /kanban/action {type:'rename', chainId, title}）。 */
@@ -132,7 +134,7 @@ export function WorkflowRail(props: {
                 <ol className="dsh-kb-nodes">
                   {(matched.length > 0 ? matched : view.tasks).map((item) => (
                     <li key={item.task.id} className={`dsh-kb-node dsh-kb-node--${item.lineState}`}>
-                      <BoardCard view={item} onOpen={props.onOpenTask} />
+                      <BoardCard view={item} onOpen={props.onOpenTask} onOpenView={props.onOpenView} />
                     </li>
                   ))}
                 </ol>

package/client/config-store.ts

@@ -0,0 +1,51 @@
+/** settings.section 插槽注册 id（T9）。 */
+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 EditableSnapshot {
+  wikiVault: { baseUrl: string; pagePrefix: string };
+  roles: { models: Partial<Record<string, EditableModelSnapshot>> };
+}
+export interface ConfigState {
+  effective: EditableSnapshot;
+  sources: Record<string, string>;
+  catalog: { providers: Array<{ id: string; name: string }>; models: Record<string, Array<{ id: string; name: string; efforts: Array<{ id: string; name: string }> }>> };
+  saving: boolean;
+  error: string | null;
+}
+
+/** T9：配置外部 store（GET /kanban/config + /kanban/llm-catalog；PUT 保存；POST reset），fetch 注入便于测试。 */
+export function createConfigStore(fetchImpl: typeof fetch) {
+  let state: ConfigState = { effective: { wikiVault: { baseUrl: '', pagePrefix: '' }, roles: { models: {} } }, sources: {}, catalog: { providers: [], models: {} }, 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;
+  const subscribe = (listener: () => void) => { listeners.add(listener); return () => { listeners.delete(listener); }; };
+  const load = async () => {
+    const [cfg, cat] = await Promise.all([
+      fetchImpl('/kanban/config').then((r) => r.json()),
+      fetchImpl('/kanban/llm-catalog').then((r) => r.json()),
+    ]);
+    setState({ effective: cfg.effective, sources: cfg.sources, catalog: cat });
+  };
+  const save = async (snap: EditableSnapshot) => {
+    setState({ saving: true, error: null });
+    try {
+      const r = await fetchImpl('/kanban/config', {
+        method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(snap),
+      });
+      const d = await r.json();
+      if (!r.ok) { setState({ error: (d.fields ?? []).join(', ') || 'save failed' }); return false; }
+      setState({ effective: d.effective, sources: d.sources });
+      return true;
+    } catch (e) { setState({ error: String(e) }); return false; }
+    finally { setState({ saving: false }); }
+  };
+  const reset = async () => {
+    const r = await fetchImpl('/kanban/config/reset', { method: 'POST' }).then((x) => x.json());
+    setState({ effective: r.effective, sources: r.sources });
+    return r;
+  };
+  return { get, subscribe, load, save, reset };
+}

package/client/config.css

@@ -0,0 +1,110 @@
+.dsh-kb-config {
+  /* 与 kanban.css 大圆角契约对齐（DSH 卡片 16px） */
+  --dsh-kb-config-border: var(--dsw-alias-border-l2, #333);
+  --dsh-kb-config-radius-lg: 16px;
+  --dsh-kb-config-radius-md: 10px;
+  --dsh-kb-config-input: var(--dsw-specific-input-major, rgba(127, 127, 127, 0.12));
+  padding: 16px;
+  font-size: 13px;
+}
+.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; }
+.dsh-kb-config__card h3 { margin: 0 0 14px; }
+
+.dsh-kb-config input,
+.dsh-kb-config select {
+  box-sizing: border-box;
+  width: 100%;
+  padding: 8px 12px;
+  border: 1px solid var(--dsh-kb-config-border);
+  border-radius: var(--dsh-kb-config-radius-md);
+  background: var(--dsh-kb-config-input);
+  color: var(--dsw-alias-label-primary, inherit);
+  font: inherit;
+  transition: border-color 150ms ease, background-color 150ms ease;
+}
+.dsh-kb-config input:focus,
+.dsh-kb-config select:focus {
+  outline: none;
+  /* 焦点/选中强调色跟随主题前景（浅色=暗、暗色=白），与 dsh settings 色系一致 */
+  border-color: var(--dsw-alias-label-primary, currentColor);
+}
+
+/* DSH 风格下拉：trigger 行（值 + › chevron）+ 弹出菜单（选中打勾、hover 高亮） */
+.dsh-kb-config__select { position: relative; min-width: 0; }
+.dsh-kb-config__select-trigger {
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  width: 100%;
+  padding: 8px 12px;
+  border: 1px solid var(--dsh-kb-config-border);
+  border-radius: var(--dsh-kb-config-radius-md);
+  background: var(--dsh-kb-config-input);
+  color: var(--dsw-alias-label-primary, inherit);
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+  transition: border-color 150ms ease, background-color 150ms ease;
+}
+.dsh-kb-config__select-trigger:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12)); }
+.dsh-kb-config__select-trigger[aria-expanded='true'] { border-color: var(--dsw-alias-label-primary, currentColor); }
+.dsh-kb-config__select-placeholder { color: var(--dsw-alias-label-tertiary, #999); }
+.dsh-kb-config__select-trigger > span:first-child { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dsh-kb-config__select-chevron { flex: 0 0 auto; display: inline-flex; color: var(--dsw-alias-label-tertiary, #999); }
+.dsh-kb-config__menu {
+  position: absolute;
+  z-index: 30;
+  top: calc(100% + 6px);
+  left: 0;
+  right: 0;
+  margin: 0;
+  padding: 6px;
+  list-style: none;
+  border: 1px solid var(--dsh-kb-config-border);
+  border-radius: var(--dsh-kb-config-radius-lg);
+  background: var(--dsw-alias-bg-layer-3, #222);
+  color: var(--dsw-alias-label-primary, inherit);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.24);
+  max-height: 260px;
+  overflow: auto;
+}
+.dsh-kb-config__option {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  width: 100%;
+  padding: 8px 10px;
+  border: none;
+  border-radius: var(--dsh-kb-config-radius-md);
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+  transition: background-color 150ms ease;
+}
+.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-check { flex: 0 0 auto; display: inline-flex; }
+
+.dsh-kb-config__label { display: block; margin: 12px 0 6px; font-weight: 600; }
+.dsh-kb-config__help { color: var(--dsw-alias-label-secondary, #888); font-size: 12px; display: block; margin: 6px 0 0; }
+.dsh-kb-config__role { display: grid; grid-template-columns: 32px 1fr 1fr 1fr auto; gap: 10px; margin-bottom: 12px; align-items: center; }
+.dsh-kb-config__src { color: var(--dsw-alias-label-secondary, #888); font-size: 12px; white-space: nowrap; padding-left: 4px; }
+.dsh-kb-config__footer { display: flex; justify-content: flex-end; margin-top: 4px; }
+.dsh-kb-config__footer button {
+  padding: 6px 16px;
+  border: 1px solid var(--dsh-kb-config-border);
+  border-radius: var(--dsh-kb-config-radius-md);
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  cursor: pointer;
+  transition: background-color 150ms ease;
+}
+.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); }

package/client/index.ts

@@ -1,17 +1,39 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context } from '@deepseek-ai/cordis';
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client';
 import { KanbanTab } from './KanbanTab.js';
+
+// alpha.2 (0.1.2-rc.1)：dsh-client-runtime 已移除，`slots` service 由宿主 client-modules
+// 运行时注入（对齐宿主内置 dsh-client-ui-jobs 的 `inject: ['sessions','slots']` 用法）。
+// 类型面无对外发布入口，故本地声明最小契约；运行时形状以宿主注入为准。
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    slots: {
+      inject(name: string, provider: () => unknown): unknown;
+      register(options: Record<string, unknown>, component: unknown): unknown;
+    };
+  }
+}
+import { ConfigSection } from './ConfigSection.js';
+import { SWARM_CONFIG_NS } from './config-store.js';
+import { setSessionsService } 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'];
+export const inject = ['slots', 'sessions'];
 
 /** 浏览器半入口（roster 行 id: kanban-board）：把看板挂到 conversation.view（会话中心 tab，additive）。
  *  对齐 DSH 原生注册：对话(id=chat, order=0) → 轨迹(id=trajectory, order=10) → 看板(id=kanban, order=20)。
+ *  T9：另把 ConfigSection 挂到 settings.section（id=swarm-config, order=30）。
  *  数据桥为节点端 /kanban HTTP 路由；ui-conversation 包仅运行时声明 slot（dsh.client.inject 排依赖序），浏览器半不直接 import。 */
-export function apply(ctx: ClientContext): (() => void) | void {
+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);
   let style: HTMLStyleElement | null = null;
+  let configStyle: HTMLStyleElement | null = null;
   if (typeof document !== 'undefined') {
     style = document.head.querySelector<HTMLStyleElement>('style[data-dsh-swarm]');
     if (!style) {
@@ -20,6 +42,13 @@ export function apply(ctx: ClientContext): (() => void) | void {
       style.textContent = css;
       document.head.appendChild(style);
     }
+    configStyle = document.head.querySelector<HTMLStyleElement>('style[data-dsh-swarm-config]');
+    if (!configStyle) {
+      configStyle = document.createElement('style');
+      configStyle.setAttribute('data-dsh-swarm-config', '');
+      configStyle.textContent = configCss;
+      document.head.appendChild(configStyle);
+    }
   }
   ctx.slots.inject('conversation.view' as never, () =>
     ctx.slots.register(
@@ -27,5 +56,11 @@ export function apply(ctx: ClientContext): (() => void) | void {
       KanbanTab as never,
     ),
   );
-  return () => { if (style) style.remove(); };
+  ctx.slots.inject('settings.section' as never, () =>
+    ctx.slots.register(
+      { name: 'settings.section', id: SWARM_CONFIG_NS, order: 30, label: 'Swarm 配置' } as never,
+      ConfigSection as never,
+    ),
+  );
+  return () => { if (style) style.remove(); if (configStyle) configStyle.remove(); setSessionsService(null); };
 }

package/client/kanban.css

@@ -29,8 +29,10 @@
   --dsh-kb-dt: #ec4899; /* 实现评审：玫红 */
   height: 100%;
   width: 100%;
-  min-width: 715px; /* 看板最小宽度 */
-  max-width: 780px; /* 看板最大宽度 */
+  /* 接入宿主会话流宽度系统：自适应 clamp + 拖拽偏好（--dsh-chat-content-width 由
+     宿主 ConversationRoot 定义，拖拽手柄官方已实现）；780px 仅为变量缺失时的兜底 */
+  min-width: 0;
+  max-width: var(--dsh-chat-content-width, 780px);
   margin-inline: auto;
   display: flex;
   flex-direction: column;
@@ -705,6 +707,21 @@
   align-items: center;
   gap: 4px;
 }
+.dsh-kb-task__session {
+  flex: none;
+  padding: 0 6px;
+  font-size: 11px;
+  line-height: 18px;
+  border: 1px solid color-mix(in srgb, currentColor 40%, transparent);
+  border-radius: 4px;
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+  opacity: 0.85;
+}
+.dsh-kb-task__session:hover {
+  opacity: 1;
+}
 .dsh-kb-rename-overlay {
   position: fixed;
   inset: 0;