@yangdcm/dsh-expert-team 1.3.3 → 1.3.5

package/CHANGELOG.md

@@ -3,6 +3,83 @@
 本包遵循[语义化版本](https://semver.org/lang/zh-CN/)。dsh 宿主版本线的对应关系写在
 `package.json` 的 `engines.dsh` 与 `dsh.compatibility` 里，插件市场按它判断"这个插件跟你的宿主兼不兼容"。
 
+## 1.3.5
+
+**性能：修掉 `/state` 的 30 秒级阻塞（它会把整个 `dsh web` 一起拖慢）**，另带两件早已排定的小事。
+
+### 症状与根因（都是实测值，不是估算）
+
+- `GET /plugins/dsh-expert-team/state` 实测 **热态 7.1–9.8 s、冷态 283.6 s**，而面板**绘制只要 52 ms**。
+- **根因 D（最大头）**：端点对**每个**子会话 `await childSessionTiming`，而它对"活存储里查不到"的子代理
+  退回 `sessionQuery.readSession(id)` —— 那是**全量读该子会话日志**。本机实测：单条最大日志
+  **23.4 MiB（70,008 个 zstd frame）→ 解压 0.44 s / 45.4 MiB / 94,820 个事件**；21 条 >1MB 的会话日志
+  仅"解压 + 过管道"就要 **1.11 s**（纯磁盘下限；host 还要逐行 `JSON.parse` + `structuredClone` + replay）。
+- **根因 B**：`WF_EVENT_TTL_MS` 原来是 **3000 ms —— 恰好等于默认轮询间隔 3000 ms** ⇒ **每个 tick 必失效**，
+  父会话日志（多 MB）被一遍遍全量重读。
+- **根因 H3**：客户端**没有 single-flight** —— 实测 8 秒内发出 5 个 `/state`、其中 **4 个重叠**（上一个没回就发下一个）。
+- **后果（这才最要紧）**：这些同步 CPU（≈2.3 s/请求）压在事件循环上，把**整个 web** 拖慢 ——
+  轻量端点 `/settings` 实测被拖到 **20.7 s / 42.5 s**（关掉面板后仍在排队，因为积压已经形成）。
+
+### 修复
+
+- **热点 D**：新增 `subHeaderIndex()` —— 子会话时间**只查表、永不读日志**。三个来源都便宜：
+  ① `listSubagentStatusBySession` 的 `listSessions()` 分支本来就顺带带出了 `createdAt/parentId/depth`；
+  ② 活存储 `ctx.sessions.get(id).header`；③ workflow 事件流的 `startedAt`（父会话日志已按 TTL 缓存）。
+  `/state` 的两个计时调用点全部改用它。三源都拿不到仍**如实降级** `0/''/0`（UI 显示「无时间记录」），**不臆造**。
+- **热点 B**：`WF_EVENT_TTL_MS` 3000 → **30000**（TTL 只是兜底；代价是"run 在会话中途结束"最多晚 30 秒反映到面板）。
+- **客户端**：`load()` 加 **single-flight**（未回绝不发下一个）+ **自适应退避**
+  `clamp(max(基础间隔, 上次耗时×2), 基础间隔, 30000)`；`display.pollMs` 仍是基础节奏（设置说了算）。
+- **写侧守卫**：`/state` 只在**该 session 真实存在**时才 `rememberSessionRun` 落盘 —— 诊断时一个**假 id**
+  曾被写进 `$DSH_HOME/expert-team/session-runs.json`（污染用户数据）。
+
+预计效果：热态从 7.1–9.8 s 降到 **0.15–0.4 s** 量级（以实机复测为准）。
+
+### 另两件小事
+
+- 设置页页头那句「标着「暂未生效」的项尚未接线…」改为**条件渲染**：`INERT_SETTINGS` 现在是空的，
+  无条件渲染会让用户去找一个不存在的标注。判据直接取 hint 里的标记（与后端**同一真源**）。
+- 新增反向参数 **`--one-shot`** / **`--code`**：1.3.4 把设置接成"无 flag 时的默认"之后出现不对称 ——
+  设置成 `persist=true` / `artifacts-only` 后，单条命令**没法反悔**。解析改为**三态**
+  （`true` 显式要 / `false` 显式不要 / `null` 未表态听设置），优先级仍是 **flag > 设置 > 常量**。
+  （曾加过一个 `--no-persist` 别名，被本仓「实现了就必须有文档」的双向一致性断言挡下 ⇒ 去掉别名，一概念一名。）
+
+### 护栏（进 `test:all`）
+
+新增 `state-perf-guard.test.mjs`：热路径**零次 `readSession`**（spy 计数）、源码里不再有
+`await childSessionTiming(ctx, s.id)`、客户端 single-flight 与退避公式、假 id 不落盘、三态反向参数与优先级。
+
+### 1.3.6 待办（诊断列出、本版**有意不做**，避免扩大范围）
+
+懒加载分节（`?section=people`）、`roleFromChildLog` 流式首帧、`listPersisted` 475 个文件的 header 缓存、
+`maxSubs` / deadline 截断。
+## 1.3.4
+
+**把 1.3.2 留下的 7 个"有持久化、无消费者"的设置真的接上**（display 4 + roster 3），并清掉当时的假承诺。
+
+- **display 四项**（此前只有存储层、零消费者；根因是客户端**全仓只有一处 `/settings` 拉取**、且只在设置表单里）：
+  - `pollMs`：浮层/面板轮询与画布 `--watch` 轮询都读它（此前分别写死 3000/1200 与 3000）；
+  - `capsuleMs`：**真正实现**"胶囊 N 毫秒后自动消失"。此前只入队、**永不自动出队** —— 旧代码里的
+    `4000` 是**同文本去重窗口**、被误当成停留时长，所以这个功能**压根不存在**；`0 = 不自动消失` 保留；
+  - `panelWidth`：设置值 = **默认宽度**；拖动结束**防抖写回设置**（单一真源，localStorage 只作首帧缓存），
+    并把三处互不一致的默认/值域对齐（设置 280..900/420、拖动 clamp 640→900、CSS 与画布回退 360→420）；
+  - `defaultTab`：面板初始页签取设置（用户点过就以点击为准）。
+  - 新增**客户端设置桥** `useDisplaySettings()`/`EXPERT_DISPLAY`：挂载时拉一次，**保存成功即当场生效**
+    （不必重启/刷新）；失败静默回默认值，不影响面板工作。
+- **roster 三项**：命令行**没给**对应参数时用设置兜底，优先级 **flag > 设置 > 常量**：
+  - `deliverable`（`artifacts-only` ⇒ `noCode`）、`persist`、`defaultRoles`；
+  - **档位收窄的基线也跟着设置走**（否则"设了默认班底"会让 `--tier` 静默失效）；
+  - 落点是 `createRun` 的**唯一一处**（覆盖 `/team`、浮层决策、`/decide` 等所有建 run 入口），
+    判定抽成纯函数 `resolveRosterDefaults()` 便于单测；`--profile` 点过名的仍优先于设置。
+- **清掉假承诺**：`INERT_SETTINGS` 现为**空对象**（7 项全部接线，机制保留作棘轮落点）；
+  标记文案改为**版本中立**（`（暂未生效：尚未接线 —— …）`），并**移除用户可见文案里的行号**
+  （行号会腐烂、且对用户无意义 —— 证据一律写进代码注释）。
+- **新增护栏** `settings-wiring.test.mjs`（进 `npm run test:all`）：roster 三项**行为级**（真跑 `createRun`，
+  断言 `STATE.json`/`ROSTER.json`/`RUN.log` 三处一致 + flag 优先级 + 档位收窄基线）、画布轮询**行为级**
+  （生成的 live 脚本里就是设置值；越界回默认）、`gates.loopGuard` 的 **getter 语义**（同一钩子实例下改设置
+  ⇒ 行为**双向即时翻转**、**无需重建钩子**），display 四项为**源码级**断言（本包无 DOM、不引依赖）。
+- **更正 1.3.2 的描述**：1.3.2 曾写"待 1.3.3 接线"，而 1.3.3 实际发的是宿主 schema 的枚举中文描述，
+  接线在本版完成 —— 因此标记文案改为**不承诺版本号**。
+
 ## 1.3.3
 
 **宿主 schema 的枚举成员带上中文描述**（1.3.2 记录为"跳过"的那条，实测后补上）。

package/client.js

@@ -22,7 +22,7 @@ window.__ModuleLoader__.load({
     var h = createElement
 
     var CSS =
-      '.exp-panel{position:fixed;top:0;right:0;bottom:0;width:360px;max-width:100vw;display:flex;flex-direction:column;background:var(--dsw-alias-bg-base,var(--bg,#fff));border-left:1px solid var(--dsw-alias-border-l2,var(--border,#d0d7de));box-shadow:-10px 0 32px rgba(0,0,0,.16);z-index:120;font-size:13px;color:var(--dsw-alias-label-primary,var(--text,#1f2328));font-family:-apple-system,"Segoe UI","PingFang SC",sans-serif}' +
+      '.exp-panel{position:fixed;top:0;right:0;bottom:0;width:420px;max-width:100vw;display:flex;flex-direction:column;background:var(--dsw-alias-bg-base,var(--bg,#fff));border-left:1px solid var(--dsw-alias-border-l2,var(--border,#d0d7de));box-shadow:-10px 0 32px rgba(0,0,0,.16);z-index:120;font-size:13px;color:var(--dsw-alias-label-primary,var(--text,#1f2328));font-family:-apple-system,"Segoe UI","PingFang SC",sans-serif}' +
       '.exp-head{padding:12px 16px;border-bottom:1px solid var(--dsw-alias-border-l1,var(--border,#d0d7de));background:linear-gradient(180deg,var(--dsw-alias-bg-module-platform,var(--bg-subtle,#f6f8fa)),var(--dsw-alias-bg-base,var(--bg,#fff)));display:flex;align-items:center;justify-content:space-between;flex:none}' +
       '.exp-head.exp-grab{cursor:move;user-select:none}' +
       '.exp-dock-handle{position:absolute;left:-2px;top:0;bottom:0;width:9px;cursor:col-resize;z-index:3;transition:background .12s}' +
@@ -293,6 +293,74 @@ window.__ModuleLoader__.load({
     function setOpen() { open = !open; notify() }
     function subscribe(f) { listeners.add(f); return function () { listeners.delete(f) } }
     function useExternal(getValue) { var s = useState(getValue()); useEffect(function () { return subscribe(function () { s[1](getValue()) }) }, []); return s[0] }
+
+    // ── 设置桥（1.3.4）：`display.*` 的**唯一**运行态来源 ───────────────────────────
+    // 为什么必须有它：此前全仓只有一处 `/settings` 拉取，而且只在设置表单里 —— display 四项因此
+    // 永远流不到运行态（轮询间隔/胶囊停留/面板宽度/默认页签各自硬编码或读 localStorage）。
+    // 这里建**一条**共享的路：面板挂载时拉一次；设置页保存成功后复用同一条路把新值通知出去
+    // ⇒ 改设置**当场生效**（同一 client、进程内），不必重启。
+    var EXPERT_DISPLAY = { pollMs: 3000, capsuleMs: 4000, panelWidth: 420, defaultTab: 'team' }
+    var DISPLAY_TABS = ['team', 'tasks', 'board', 'info']
+    var DISPLAY_RANGE = { pollMs: [1000, 60000], capsuleMs: [0, 60000], panelWidth: [280, 900] }
+    var displayLoaded = false
+    var displayLoading = null
+    function clampInt(v, lo, hi, def) { var n = Number(v); if (!isFinite(n)) return def; n = Math.round(n); return Math.max(lo, Math.min(hi, n)) }
+    /** 从 `/settings` 响应挑出 display 四项并按值域夹紧；缺项/越界一律回退当前值（不制造 NaN/空白）。 */
+    function pickDisplay(settings) {
+      var d = (settings && settings.display) || {}
+      return {
+        pollMs: clampInt(d.pollMs, DISPLAY_RANGE.pollMs[0], DISPLAY_RANGE.pollMs[1], EXPERT_DISPLAY.pollMs),
+        capsuleMs: clampInt(d.capsuleMs, DISPLAY_RANGE.capsuleMs[0], DISPLAY_RANGE.capsuleMs[1], EXPERT_DISPLAY.capsuleMs),
+        panelWidth: clampInt(d.panelWidth, DISPLAY_RANGE.panelWidth[0], DISPLAY_RANGE.panelWidth[1], EXPERT_DISPLAY.panelWidth),
+        defaultTab: DISPLAY_TABS.indexOf(String(d.defaultTab)) >= 0 ? String(d.defaultTab) : EXPERT_DISPLAY.defaultTab
+      }
+    }
+    /** 应用一份设置：换对象（useExternal 才看得见变化）+ 未拖动过宽度时采纳设置值 + 通知重渲染。 */
+    function applyDisplaySettings(settings) {
+      var next = pickDisplay(settings)
+      var changed = next.pollMs !== EXPERT_DISPLAY.pollMs || next.capsuleMs !== EXPERT_DISPLAY.capsuleMs || next.defaultTab !== EXPERT_DISPLAY.defaultTab
+      EXPERT_DISPLAY = next
+      // 宽度：设置值是**默认宽度**；用户拖过就以拖动结果为准（拖动结束会把宽度写回设置）。
+      if (!panelWidthUserSet && next.panelWidth !== panelWidth) { panelWidth = clampW(next.panelWidth); changed = true }
+      if (changed) notify()
+      return next
+    }
+    function fetchSettingsPayload() {
+      return fetch('/plugins/dsh-expert-team/settings').then(function (r) {
+        return r.json().catch(function () { return null }).then(function (d) { return { ok: r.ok, status: r.status, d: d } })
+      })
+    }
+    /** 拉一次设置（幂等：同一次加载只拉一次；失败静默 —— 面板照旧用默认值工作）。 */
+    function loadDisplaySettings() {
+      if (displayLoaded) return displayLoading || Promise.resolve(EXPERT_DISPLAY)
+      displayLoading = fetchSettingsPayload().then(function (res) {
+        displayLoaded = true
+        if (res.ok && res.d && res.d.ok && res.d.settings) applyDisplaySettings(res.d.settings)
+        return EXPERT_DISPLAY
+      }).catch(function () { displayLoaded = true; return EXPERT_DISPLAY })
+      return displayLoading
+    }
+    /** 运行态取 display 配置（挂载时拉一次；保存后由 applyDisplaySettings 通知更新）。 */
+    function useDisplaySettings() {
+      var v = useExternal(function () { return EXPERT_DISPLAY })
+      useEffect(function () { loadDisplaySettings() }, [])
+      return v
+    }
+    /** 拖动结束把宽度**防抖**写回设置（单一真源）；localStorage 只作首帧缓存。 */
+    var widthSaveTimer = null
+    function persistDisplayWidth(w) {
+      if (widthSaveTimer) clearTimeout(widthSaveTimer)
+      widthSaveTimer = setTimeout(function () {
+        widthSaveTimer = null
+        try {
+          fetch('/plugins/dsh-expert-team/settings', {
+            method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ 'display.panelWidth': w })
+          }).then(function (r) { return r.json().catch(function () { return null }) }).then(function (d) {
+            if (d && d.ok && d.settings) applyDisplaySettings(d.settings)
+          }).catch(function () {})
+        } catch (e) {}
+      }, 400)
+    }
     /** 对话流 workflow 卡是否已回退到 dsh 原生（localStorage 开关，刷新生效）。 */
     function nativeWfOn() { try { return window.localStorage.getItem('et-native-workflow') === '1' } catch (e) { return false } }
     function useCurrentSession() { return useExternal(function () { return currentSessionId }) }
@@ -306,8 +374,12 @@ window.__ModuleLoader__.load({
     function saveLS(key, v) { try { window.localStorage.setItem(key, JSON.stringify(v)) } catch (e) {} }
     var dockState = loadLS('et-dock', true)
     var panelPos = loadLS('et-pos', { x: 0, y: 0 })
-    var panelWidth = loadLS('et-width', 360)
-    function clampW(w) { return Math.max(280, Math.min(640, w)) }
+    // 1.3.4：默认宽度来自设置 `display.panelWidth`（首帧用 localStorage 缓存避免闪烁）；
+    // 值域与设置对齐 280..900（此前 clamp 到 640、CSS 写死 360 —— 三处互不一致）。
+    var panelWidthLS = loadLS('et-width', null)
+    var panelWidthUserSet = typeof panelWidthLS === 'number'
+    var panelWidth = clampW(typeof panelWidthLS === 'number' ? panelWidthLS : EXPERT_DISPLAY.panelWidth)
+    function clampW(w) { return Math.max(280, Math.min(900, w)) }
     function setDock(v) { if (dockState === v) return; dockState = v; if (!v) { panelPos = { x: ((window && window.innerWidth) || 1280) - panelWidth, y: 80 }; saveLS('et-pos', panelPos) } saveLS('et-dock', dockState); notify() }
     function setPanelPos(x, y) { panelPos = { x: x, y: y }; saveLS('et-pos', panelPos); notify() }
     /**
@@ -323,7 +395,7 @@ window.__ModuleLoader__.load({
         if (changed) notify()
       } catch (e) {}
     }
-    function setPanelWidth(w) { panelWidth = clampW(w); saveLS('et-width', panelWidth); notify() }
+    function setPanelWidth(w) { panelWidth = clampW(w); panelWidthUserSet = true; saveLS('et-width', panelWidth); notify(); persistDisplayWidth(panelWidth) }
 
     /**
      * ── 对话流卡片 → 右侧面板的「聚焦意图」通道 ──
@@ -1081,12 +1153,10 @@ window.__ModuleLoader__.load({
       useEffect(function () {
         var alive = true
         setLoading(true); setLoadErr('')
-        fetch('/plugins/dsh-expert-team/settings').then(function (r) {
-          return r.json().catch(function () { return null }).then(function (d) { return { ok: r.ok, status: r.status, d: d } })
-        }).then(function (res) {
+        fetchSettingsPayload().then(function (res) {
           if (!alive) return
           setLoading(false)
-          if (res.ok && res.d && res.d.ok && res.d.schema) { setData(res.d); return }
+          if (res.ok && res.d && res.d.ok && res.d.schema) { applyDisplaySettings(res.d.settings); setData(res.d); return }
           var detail = (res.d && (res.d.error || (res.d.errors || []).join('；'))) || ''
           setLoadErr(t('读取设置失败：HTTP ', 'Reading settings failed: HTTP ') + res.status + (detail ? ' ' + t('（', '(') + detail + t('）', ')') : ''))
         }).catch(function (e) {
@@ -1107,6 +1177,7 @@ window.__ModuleLoader__.load({
             return
           }
           setData(function (prev) { return { schema: (prev && prev.schema) || [], settings: res.d.settings, ok: true } })
+          applyDisplaySettings(res.d.settings)   // 1.3.4：设置页改完 display 四项**当场生效**（不必重启/刷新）
           setMsg('已保存')   // 1.3.2：经逐项核查，没有任何设置需要重启（见 lib/command.js 的 needsRestart 注释）⇒ 死分支已删
         }).catch(function (e) { setErr(String(e && e.message ? e.message : e)); setMsg('') })
       }
@@ -1119,6 +1190,7 @@ window.__ModuleLoader__.load({
         h('button', { className: 'exp-settings-retry', onClick: function () { setRetry(retry + 1) } }, esc(t('重试', 'Retry'))))
       if (!data || !data.schema) return h('div', { className: 'exp-settings' }, h('div', { className: 'exp-empty' }, t('（正在读取设置…）', '(loading settings…)')))
       var model = settingsFormModel(data.schema, data.settings)
+      var hasInertMark = model.some(function (g) { return (g.rows || []).some(function (r) { return /暂未生效/.test(String(r.hint || '')) }) })
       var rows = []
       model.forEach(function (g) {
         rows.push(h('div', { key: 'h-' + g.group, className: 'exp-settings-group' }, esc(g.label) + (g.hint ? ' · ' + esc(g.hint) : '')))
@@ -1151,7 +1223,11 @@ window.__ModuleLoader__.load({
         //   ③ **没有任何一项需要重启** ⇒ 回执只说"已保存"（`needsRestart` 恒 false）。
         //   ④ 标着「暂未生效」的项 = **还没接线**（`INERT_SETTINGS`，见 lib/settings.js）：写在这里
         //      不是承诺，而是如实告知；逐项标记由 per-item hint 携带，不在这里重复。
-        h('div', { className: 'exp-settings-head' }, esc(t('改动即保存并即时生效（上限 / 轮次 / 档位门 / 振荡检测开关在进程内重算）。标着「暂未生效」的项尚未接线，改了不会有作用。', 'Saved on change and applied immediately (caps, rounds, the tier gate and the oscillation switch are recomputed in-process). Items marked as not yet in effect are not wired up — changing them does nothing.'))),
+        // 「暂未生效」那句**只在真有这种项时**才渲染（1.3.5）：INERT_SETTINGS 现在是空的，
+        // 无条件渲染会让用户去找一个不存在的标注。判据直接取 hint 里的标记 ⇒ 与后端单一真源一致。
+        h('div', { className: 'exp-settings-head' }, esc(hasInertMark
+          ? t('改动即保存并即时生效（上限 / 轮次 / 档位门 / 振荡检测开关在进程内重算）。标着「暂未生效」的项尚未接线，改了不会有作用。', 'Saved on change and applied immediately (caps, rounds, the tier gate and the oscillation switch are recomputed in-process). Items marked as not yet in effect are not wired up — changing them does nothing.')
+          : t('改动即保存并即时生效（上限 / 轮次 / 档位门 / 振荡检测开关在进程内重算）。', 'Saved on change and applied immediately (caps, rounds, the tier gate and the oscillation switch are recomputed in-process).'))),
         rows,
         h('div', { className: 'exp-settings-msg' + (err ? ' bad' : '') }, esc(err ? '✗ ' + err : (msg || ''))))
     }
@@ -1179,6 +1255,8 @@ window.__ModuleLoader__.load({
       var pos = usePanelPos()
       useLang() // re-render when the shell language changes
       var pw = usePanelWidth()
+      // 1.3.4：display 四项在这里取（挂载时拉一次设置；保存后即时通知更新）
+      var dispCfg = useDisplaySettings()
       var dataS = useState(null), data = dataS[0], setData = dataS[1]
       var runsMetaS = useState([]); var runsMeta = runsMetaS[0], setRunsMeta = runsMetaS[1]
       var selTask = useState(null); var selTaskV = selTask[0], setSelTask = selTask[1]
@@ -1196,7 +1274,7 @@ window.__ModuleLoader__.load({
       var prevDecRef = useRef(0)
       var hoverS = useState(null); var hoverId = hoverS[0], setHover = hoverS[1]
       var view = useState('dag'); var viewV = view[0], setView = view[1]
-      var tabS = useState('team'); var tab = tabS[0], setTab = tabS[1]
+      var tabS = useState(null); var tab = tabS[0] || dispCfg.defaultTab; var setTab = tabS[1]   // 1.3.4：初始页签来自设置 display.defaultTab
       var listOpenS = useState(false); var listOpen = listOpenS[0], setListOpen = listOpenS[1]
       // 流转视图（波次带）自己的 UI 状态：宽视图 / 波折叠 / 未绑定任务展开
       var wideS = useState(false); var wideV = wideS[0], setWide = wideS[1]
@@ -1272,7 +1350,22 @@ window.__ModuleLoader__.load({
         if (selRunV && selRunV.workspace && selRunV.runId) { q.push('workspace=' + encodeURIComponent(selRunV.workspace)); q.push('run=' + encodeURIComponent(selRunV.runId)) }
         return url + (q.length ? ('?' + q.join('&')) : '')
       }
+      // ── single-flight + 自适应退避（2026-09-15 性能修复）──────────────────────────
+      // 实测：8 秒内曾发 5 个 /state、其中 4 个重叠，而单发可达 7–283 秒 ⇒ 队列只增不减，
+      // 服务端被压垮（连轻量端点 /settings 都涨到 20.7 s / 42.5 s，整个 dsh web 一起卡）。
+      // 两条纪律：① **未回绝不发下一个**（晚一点看到状态，好过把 web 拖死）；
+      //          ② 间隔随上次耗时**退避**（见 reschedule），重活端点不该 1.2 秒一发。
+      var inFlightRef = useRef(false)
+      var lastMsRef = useRef(0)
       function load() {
+        if (inFlightRef.current) return
+        inFlightRef.current = true
+        var t0 = (window.performance && performance.now) ? performance.now() : Date.now()
+        var done = function () {
+          inFlightRef.current = false
+          var now = (window.performance && performance.now) ? performance.now() : Date.now()
+          lastMsRef.current = Math.max(0, now - t0)
+        }
         fetch(stateUrl()).then(function (r) { return r.ok ? r.json() : null }).then(function (d) {
           if (d && d.ok) {
             setData(d); setErr(''); reschedule(d)
@@ -1307,26 +1400,31 @@ window.__ModuleLoader__.load({
             } catch (e) {}
           } else if (d && !d.ok && d.runsAvailable === 0) { setData(null); if (d.runs) setRunsMeta(d.runs); setErr(t('还没有专家团 run。先运行 /team <task> 开一个。', 'No team run yet — run /team <task> first.')) }
           else if (d && !d.ok) { if (d.runs) setRunsMeta(d.runs); setErr(d.error || ''); }
-        }).catch(function () {})
+        }).catch(function () {}).then(done, done)
       }
       // Adaptive refresh: while any member is running, poll fast (workers are
-      // touching files right now); otherwise 3s. Re-schedules after each load.
+      // touching files right now); otherwise the configured cadence.
+      // 2026-09-15：再叠一层**退避** —— 间隔 = clamp(max(基础间隔, 上次耗时×2), 基础间隔, 30000)。
+      // 单发越慢 ⇒ 下次越晚；display.pollMs 仍是基础节奏（设置里那一项依然说了算）。
       function reschedule(d) {
         var m = (d && d.members) || {}
         var busy = Object.keys(m).some(function (k) { var v = m[k]; return v && typeof v === 'object' && (v.activity === 'running' || v.shortStatus === 'running') })
         clearInterval(pollRef.current)
-        pollRef.current = setInterval(load, busy ? 1200 : 3000)
+        // 1.3.4：间隔来自设置 display.pollMs（忙碌时按同一意图加速到 40%，下限 300ms）
+        var base = busy ? Math.max(300, Math.round(dispCfg.pollMs * 0.4)) : dispCfg.pollMs
+        var backoff = Math.max(base, Math.min(30000, Math.round((lastMsRef.current || 0) * 2)))
+        pollRef.current = setInterval(load, backoff)
       }
       useEffect(function () {
         if (!isOpen && !viewMode) return undefined // panel closed & not canvas → no polling
-        load(); pollRef.current = setInterval(load, 3000)
+        load(); pollRef.current = setInterval(load, dispCfg.pollMs)
         // catch up instantly when the user returns to the tab / window
         var onVis = function () { if (document.visibilityState === 'visible') load() }
         var onFocus = function () { load() }
         document.addEventListener('visibilitychange', onVis)
         window.addEventListener('focus', onFocus)
         return function () { clearInterval(pollRef.current); document.removeEventListener('visibilitychange', onVis); window.removeEventListener('focus', onFocus) }
-      }, [sessionId, selRunV, isOpen, viewMode])
+      }, [sessionId, selRunV, isOpen, viewMode, dispCfg.pollMs])
 
       // Make the docked panel reserve space (shift the shell frame) instead of
       // covering the workspace; clears when closed or floating (md-preview trick).
@@ -1710,7 +1808,7 @@ window.__ModuleLoader__.load({
         // 可画宽度三源：实测容器 → 全屏画布按窗口估 → 停靠侧栏宽度偏好。
         // 「宽视图」开关终于有作用了：放宽单卡上限（否则 12 波里每波只有 2–3 人时，
         // 卡片被 176px 封顶、右侧大片空白）。
-        var baseW = flowW || (viewMode ? Math.max(320, ((typeof window !== 'undefined' && window.innerWidth) || 1200) - 340) : (typeof pw === 'number' ? pw : 360))
+        var baseW = flowW || (viewMode ? Math.max(320, ((typeof window !== 'undefined' && window.innerWidth) || 1200) - 340) : (typeof pw === 'number' ? pw : 420))
         var avail = Math.max(240, baseW - 26)
         var widest = 1
         W.waves.forEach(function (w) { widest = Math.max(widest, w.members.length) })
@@ -2335,8 +2433,14 @@ window.__ModuleLoader__.load({
       try {
         var last = activityQ[0]
         if (last && last.text === text && Date.now() - (last.ts || 0) < 4000) return
-        activityQ.unshift({ icon: icon, text: String(text || '').slice(0, 90), ts: Date.now() })
+        var entry = { icon: icon, text: String(text || '').slice(0, 90), ts: Date.now() }
+        activityQ.unshift(entry)
         if (activityQ.length > 8) activityQ.length = 8
+        // 1.3.4：停留时长来自设置 `display.capsuleMs`（0 = 不自动消失）。
+        // ⚠️ 上面那个 4000 是**同文本去重窗口**，不是停留时长 —— 旧实现把它当停留时长，
+        // 于是"胶囊 N 毫秒后消失"这个功能**压根不存在**（只入队、永不自动出队，>8 才截断）。
+        var ttl = EXPERT_DISPLAY.capsuleMs
+        if (ttl > 0) setTimeout(function () { var i = activityQ.indexOf(entry); if (i >= 0) { activityQ.splice(i, 1); notify() } }, ttl)
         notify()
       } catch (e) {}
     }

package/lib/command-parse.js

@@ -29,6 +29,8 @@ export const USAGE = [
   '  /team help                         显示本用法（等价：? / -h / --help）',
   '  /team --persist <task>             启动持久化活团队（成员可反复指挥，跨会话恢复）',
   '  /team --no-code <task>             只产出计划/评审/测试工件，不改代码',
+  '  /team --code <task>                显式要「代码 + 工件」（压过设置里的「交付口径 = 只出工件」）',
+  '  /team --one-shot <task>            显式要「一次性组队」（压过设置里的「默认持久化活团队」）',
   '  /team --confirm <task>             大需求先确认：建 run 但**不自动派工**，面板点「执行」才开工',
   '  /team --tier <档位> <task>         指定流程档位：快速档 / 标准档 / 严格档（不写则在浮层三选一，每次都问）',
   '  /team tier <档位> [--run <run>]    运行中**升档**（快速档→标准档→严格档；不允许降档）',
@@ -145,8 +147,11 @@ export function parseTeamCommand(rawInput) {
   // Consume leading flags; everything after the last flag is the task text.
   const tokens = input.split(/\s+/);
   let i = 0;
-  let persist = false;
-  let noCode = false;
+  // 三态（1.3.5）：null = 未表态（听设置）；true = 显式要；false = **显式不要**（--one-shot / --code）。
+  // 为什么必须三态：1.3.4 把设置接进"无 flag 时的默认"后就出现不对称 —— 设置成 persist=true 之后，
+  // 单条命令没有任何办法要一次性运行（旧代码的布尔默认把"没给 flag"和"显式否"混成同一个 false）。
+  let persist = null;
+  let noCode = null;
   let roles = null;
   let runName = null;
   let profile = null;
@@ -156,7 +161,9 @@ export function parseTeamCommand(rawInput) {
   while (i < tokens.length && tokens[i].startsWith('--')) {
     const flag = tokens[i];
     if (flag === '--persist') persist = true;
+    else if (flag === '--one-shot') persist = false;
     else if (flag === '--no-code') noCode = true;
+    else if (flag === '--code') noCode = false;
     else if (flag === '--allow-rebuild') allowRebuild = true;
     else if (flag.startsWith('--roles')) {
       const eq = flag.indexOf('=');

package/lib/command.js

@@ -1414,6 +1414,21 @@ function sessionRunsPath() { return join(dshHome(), 'expert-team', 'session-runs
  * 旧数据没有 `via`；`runOwnerSession()` 会把"最早那条"当作归属兜底，并对
  * 是否真的可信如实回报（见 `ownerResolved`）。
  */
+/**
+ * 该 session id 是否**真实存在**（写侧守卫，2026-09-15）。
+ *
+ * 为什么需要：/state 允许带任意 `sessionId` 查询，而旧实现在"显式指定 run+workspace"时
+ * **无条件** rememberSessionRun(sid, …) 落盘 —— 性能诊断时用一个**假 id** 就被写进了
+ * `$DSH_HOME/expert-team/session-runs.json`（污染用户数据）。
+ * 只查活存储（便宜、不读日志）；查不到 ⇒ 当只读、**不写盘**。
+ * 代价：已结束的会话"查看某 run"不再被记住（面板退回"按当前工作区自动选 run"）——
+ * 这是**有意**的取舍：宁可不记，也不写假 id。
+ */
+function sessionExists(ctx, sid) {
+  const id = String(sid || '');
+  if (!id) return false;
+  try { return Boolean(ctx?.get?.('sessions')?.get?.(id)); } catch { return false; }
+}
 function rememberSessionRun(sid, ws, runId, via) {
   if (!sid || !ws || !runId) return;
   const prev = SESSION_RUNS.get(sid);
@@ -1704,6 +1719,59 @@ function resolveLoopGuard(config, base) {
   return LOOP_GUARD_ENABLED;
 }
 
+// ── roster 三项：命令行**未显式给出**时用设置兜底（1.3.4 接线）──────────────────────────
+//
+// 为什么放在"建 run 的入口"而不是解析器里：`parseTeamCommand` 是**纯解析**（拿不到设置，也不该拿 ——
+// 它是被测得很细的纯函数）。把"flag 没给 ⇒ 取设置"放在 `createRun` 的**唯一落点**，才能同时覆盖
+// `/team`、浮层决策、`/decide` 等所有建 run 的入口，而不是每个入口各接一遍（那就有了第二个真源）。
+//
+// ⚠️ 键写成**限定路径**（`roster.persist` 等）不是装饰：`settings-consumers.test.mjs` 对**歧义叶子**
+// （`persist`/`deliverable`/`defaultRoles` 在本仓另有同名的不同概念，如 `mode.persist`、`--deliverable`）
+// **只认限定路径**命中的消费者 —— 写成 `r.persist` 会被判成"没有消费者"，而那正是本仓最想避免的假绿。
+/** 读设置的 roster 三项（键 = spec 的限定路径；值已按 spec 归一）。 */
+export function rosterSettings() {
+  const r = (currentSettings() || {}).roster || {};
+  return {
+    'roster.defaultRoles': Array.isArray(r.defaultRoles) && r.defaultRoles.length ? r.defaultRoles.slice() : null,
+    'roster.deliverable': r.deliverable === 'artifacts-only' ? 'artifacts-only' : 'code+artifacts',
+    'roster.persist': r.persist === true,
+  };
+}
+
+/**
+ * 把设置落到一次建 run 的 `mode` 上：**flag > 设置 > 常量**。
+ * 纯函数（设置与常量都由参数传入）⇒ 可单测；`createRun` 只负责调用它。
+ *
+ * @param mode - `parseTeamCommand` 的产物（`persist`/`noCode`/`roles` 都是"flag 给了才为真/非空"）
+ * @param rosterSet - `rosterSettings()` 的产物（可为 undefined）
+ * @param fallbackRoles - 常量兜底班底（默认 `DEFAULT_ROLES`）
+ * @returns `{ persist, noCode, roles, rolesBase, rolesFromSettings }`
+ *   - `rolesBase`：**档位收窄的基线**（设置了 `defaultRoles` 就用它，否则用常量）；
+ *   - `rolesFromSettings`：告知调用方"这个班底来自设置、不是用户点名" ⇒ 档位收窄仍应生效。
+ */
+export function resolveRosterDefaults(mode, rosterSet, fallbackRoles) {
+  const m = mode && typeof mode === 'object' ? mode : {};
+  const base = Array.isArray(fallbackRoles) && fallbackRoles.length ? fallbackRoles.slice() : DEFAULT_ROLES.slice();
+  const settingsRoles = rosterSet && Array.isArray(rosterSet['roster.defaultRoles']) && rosterSet['roster.defaultRoles'].length
+    ? rosterSet['roster.defaultRoles'].slice() : null;
+  const explicitRoles = Array.isArray(m.roles) && m.roles.length ? m.roles.slice() : null;
+  return {
+    // 三态（1.3.5）：true = 显式要；false = **显式不要**（--one-shot / --code 压过设置）；
+    // null/undefined = 未表态 ⇒ 听设置（见 command-parse.js 的三态注释）。
+    persist: m.persist === true ? true : (m.persist === false ? false : Boolean(rosterSet && rosterSet['roster.persist'] === true)),
+    noCode: m.noCode === true ? true : (m.noCode === false ? false : Boolean(rosterSet && rosterSet['roster.deliverable'] === 'artifacts-only')),
+    roles: explicitRoles || settingsRoles,
+    rolesBase: settingsRoles || base,
+    rolesFromSettings: !explicitRoles && Boolean(settingsRoles),
+  };
+}
+
+/** 画布 live 模式的轮询间隔（毫秒）：来自设置 `display.pollMs`（1.3.4 接线），越界回默认 3000。 */
+function canvasPollMs() {
+  const n = Number(((currentSettings() || {}).display || {}).pollMs);
+  return Number.isFinite(n) && n >= 1000 && n <= 60000 ? Math.round(n) : 3000;
+}
+
 /**
  * 解析档位门是软还是硬。**非法值一律回默认（soft）**，不猜也不报错 ——
  * 一个拼错的开关值把流程卡死（hard）比静默放行更糟，而"卡死"正是最贵的失败模式。
@@ -2672,6 +2740,53 @@ async function childSessionTiming(ctx, id) {
   return out;
 }
 
+/**
+ * 子会话 header **索引**：只查表，**永不读日志**。
+ *
+ * 为什么必须有它（2026-09-15 性能诊断）：/state 曾对**每个**子会话调 childSessionTiming，
+ * 而它对"活存储里已查不到"的子代理会退回 sessionQuery.readSession(id) —— 那是**全量读该子会话日志**
+ * （本机实测 21 条 = 23.6 MiB zstd / ~31,000 事件；别的 run 测到 75/92 条）。结果：端点热态 7.1–9.8 s、
+ * 冷态 **283.6 s**，而面板绘制只要 52 ms；请求还压在事件循环上，把整个 dsh web 一起拖慢
+ * （轻量端点 /settings 因此涨到 20.7 s / 42.5 s）。
+ *
+ * 三个来源都**便宜**，按"准且省"排序：
+ *   ① listSubagentStatusBySession 已经带出的 durable header 字段（createdAt/parentId/depth）
+ *      —— 那一支本来就要 listSessions()，字段是**顺带**拿到的，不额外读任何日志；
+ *   ② 活存储 ctx.sessions.get(id).header（子代理还在跑时最省）；
+ *   ③ workflow 事件流的 startedAt（父会话日志已按 WF_EVENT_TTL_MS 缓存，见 workflowEventIndex）。
+ * 三源都拿不到 ⇒ 保持 0/''/0，UI 按「无时间记录」**如实降级**（hasTimestamp:false）——
+ * **不臆造**，也**绝不**为了"看起来有数据"退回全量读日志。
+ *
+ * @returns {Map<string, {createdAt:number, parentId:string, depth:number}>}
+ */
+function subHeaderIndex(ctx, subs, wfLabels) {
+  const out = new Map();
+  for (const s of Array.isArray(subs) ? subs : []) {
+    const id = String((s && s.id) || '');
+    if (!id) continue;
+    let createdAt = Number(s.createdAt) || 0;
+    let parentId = String(s.parentId || '');
+    let depth = Number(s.depth) || 0;
+    if (!createdAt) {
+      try {
+        const hdr = ctx?.get?.('sessions')?.get?.(id)?.header;
+        if (hdr) {
+          createdAt = Number(hdr.createdAt) || 0;
+          if (!parentId) parentId = String(hdr.parentSession || '');
+          if (!depth) depth = Number(hdr.delegationDepth) || 0;
+        }
+      } catch { /* best-effort */ }
+    }
+    if (!createdAt && wfLabels) {
+      const w = typeof wfLabels.get === 'function' ? wfLabels.get(id) : wfLabels[id];
+      const at = w && Number(w.startedAt);
+      if (at) createdAt = at;
+    }
+    out.set(id, { createdAt, parentId, depth });
+  }
+  return out;
+}
+
 async function listSubagentStatusBySession(ctx, sid, knownIds) {
   const root = sid ? await rootSessionId(ctx, sid) : '';
   let rows = [];
@@ -2849,7 +2964,11 @@ async function roleFromChildLog(ctx, id) {
  * tick, while a run that finishes mid-session still converges within a tick.
  * Best-effort: any read failure yields empty results (never throws).
  */
-const WF_EVENT_TTL_MS = 3000;
+// ⚠️ 2026-09-15 性能诊断：TTL 原为 **3000ms，恰好等于默认轮询间隔 3000ms** ⇒ **每个 tick 必失效**，
+// 父会话日志（多 MB）被一遍遍全量重读，这是热态 7.1–9.8 s 的主要来源之一。现改为 30000ms：
+// TTL 只是**兜底**（理想是按日志 mtime/size 失效，留待后续），代价是"run 在会话中途结束"最多晚
+// 30 秒反映到面板 —— 与"每 3 秒重读整个日志"相比，这个交换值得。
+const WF_EVENT_TTL_MS = 30000;
 const WF_EVENT_CACHE = new Map(); // sessionId -> { at, labels: Map, runs: [] }
 async function workflowEventIndex(ctx, sid) {
   const key = String(sid || '');
@@ -3092,9 +3211,9 @@ function buildCanvasHtml({ runId, goal, state, roster, tasks, subagents, dir, cw
   <ol class="path" id="path">${stepper}</ol>
   <section><h2>团队编制 <span class="live" id="live-ts"></span></h2><div class="cards" id="roster">${rosterCards || '<div class="empty">（暂无成员）</div>'}</div></section>
   <section><h2>任务看板</h2><div class="board" id="board">${boardHtml || '<div class="empty">（暂无任务）</div>'}</div></section>
-  <div class="hint">本画布由 <code>/team canvas</code> 动态生成（数据源：${esc(dir)}）。任务/成员状态随各阶段推进更新；想刷新就再跑一次 <code>/team canvas</code>。${watch ? ' <b>── 当前为 live 模式：每 3 秒轮询 host 状态接口自动刷新。</b>' : ''}</div>
+  <div class="hint">本画布由 <code>/team canvas</code> 动态生成（数据源：${esc(dir)}）。任务/成员状态随各阶段推进更新；想刷新就再跑一次 <code>/team canvas</code>。${watch ? ` <b>── 当前为 live 模式：每 ${Math.round(canvasPollMs() / 1000)} 秒轮询 host 状态接口自动刷新。</b>` : ''}</div>
 </div>
-${watch ? watchScript(runId, cwd) : ''}
+${watch ? watchScript(runId, cwd, canvasPollMs()) : ''}
 </body>
 </html>`;
 }
@@ -3103,7 +3222,9 @@ ${watch ? watchScript(runId, cwd) : ''}
 // (md-preview-style host HTTP endpoint, avoiding typert Remotes) and live-updates
 // the phase stepper, roster cards and task board. Falls back silently if the
 // route is unavailable (e.g. webServer not mounted).
-function watchScript(runId, cwd) {
+function watchScript(runId, cwd, pollMs) {
+  // 1.3.4：轮询间隔来自设置 `display.pollMs`（此前是写死的 3000）。
+  const per = Number.isFinite(Number(pollMs)) && Number(pollMs) >= 1000 ? Math.round(Number(pollMs)) : 3000;
   const base = '"/plugins/dsh-expert-team/state"';
   const stateUrl = `(${base}+"?cwd="+encodeURIComponent(${JSON.stringify(cwd)})+"&run="+encodeURIComponent(${JSON.stringify(runId)}))`;
   return `<script>
@@ -3134,7 +3255,7 @@ function watchScript(runId, cwd) {
     }catch(e){}
   }
   function poll(){ fetch(URL).then(function(r){if(!r.ok)return null;return r.json();}).then(function(d){if(d)render(d);}).catch(function(){}); }
-  poll(); setInterval(poll, 3000);
+  poll(); setInterval(poll, ${per});
 })();
 </script>`;
 }
@@ -4252,6 +4373,16 @@ async function settleRuns(cwd, runArg, ctx) {
 
 async function createRun(ctx, invocation, cwd, mode) {
   if (mode.profile) mode = resolveProfile(mode.profile, mode); // apply a named profile (roles/deliverable/note)
+  // ── roster 三项兜底（1.3.4 接线）：**flag > 设置 > 常量**，唯一落点 ────────────────────
+  // 放在 `--profile` 之后：命名档位（`resolveProfile`）显式点过的 roles/deliverable 仍优先于设置，
+  // 与"用户在命令里点名 > 控制台偏好"同一条纪律。
+  const rosterSet = rosterSettings();
+  const rd = resolveRosterDefaults(mode, rosterSet, DEFAULT_ROLES);
+  mode.persist = rd.persist;
+  mode.noCode = rd.noCode;
+  mode.rolesBase = rd.rolesBase;
+  mode.rolesFromSettings = rd.rolesFromSettings;
+  if (rd.roles && !(mode.roles && mode.roles.length)) mode.roles = rd.roles;
   // ── G 线（档位）：先定档位，再建 run（档位要写进 TASK/ROSTER/STATE 三份工件）──────────
   // ① 显式 `--tier` **认不出来就拒绝**：静默退回默认会让用户以为自己选的那个生效了 ——
   //    这正是本仓反复复发的"沉默 ≠ 允许"（SKILL §7.29）。
@@ -4275,8 +4406,11 @@ async function createRun(ctx, invocation, cwd, mode) {
   // ③ **档位真正省派工的地方**：显式 `--tier` 且用户没点过角色名 ⇒ 按档定班底。
   //    （没显式指定时**不**在这里收窄：档位选择发生在浮层，用户选完那一刻才收窄 —— 见 /decide 路由。）
   //    `--roles` / `--profile` 点过名的，一律不动（`narrowedRoles` 只看"是不是基线班底"）。
-  if (pickedTier && !(mode.roles && mode.roles.length)) {
-    const next = narrowedRoles(pickedTier, DEFAULT_ROLES, DEFAULT_ROLES);
+  //    1.3.4：班底来自**设置**（`roster.defaultRoles`）时也算"基线" ⇒ 收窄仍应生效，
+  //    只是基线换成设置里那套（否则"设了默认班底"会让档位收窄静默失效）。
+  if (pickedTier && (!(mode.roles && mode.roles.length) || mode.rolesFromSettings)) {
+    const narrowBase = mode.rolesBase || DEFAULT_ROLES;
+    const next = narrowedRoles(pickedTier, (mode.roles && mode.roles.length ? mode.roles : narrowBase), narrowBase);
     if (next) { mode.roles = next; mode.rolesNarrowedBy = pickedTier; }
   }
   // 批 0-3：planDiscarded **代码强制** —— 用户明确丢弃过的同目标团队，不得由 lead 自动重建。
@@ -4515,7 +4649,7 @@ function warnLeadToolFaceOnce(status, detail) {
   LEAD_TOOLFACE_WARNED.add(status);
   console.warn(`[expert-team] lead 工具面**未**收窄（${status}）：${detail}`);
 }
-export const _live = { pushActivity, phaseAccountingViolations, loggedPhases, authorityViolations, WRITE_TRACER, createWriteTracer, formatConflict, summarizeTool, parseLogLine, roleOfSub, mapRoleToSub, membersFromState, buildRoleSubMap, resolveSubRoles, childSessionTiming, SUB_HEADER_CACHE, workflowEventIndex, workflowChildLabels, workflowChildMeta, workflowRuns, WF_EVENT_CACHE, rememberSessionRun, sessionRunFor, runOwnerSession, SESSION_RUNS, parseTeamCommand, deriveMemberEntries, schemaViolations, runHealth, RUN_STALL_MS, scaffoldFingerprint, SCAFFOLD_REQUIRED, strandedTasks, settleStranded, IN_FLIGHT_STATUSES, normalizeCoverage, SCHEMA_WARN_SEEN, pushActivityEvent, DEFAULT_LIMITS, LIMITS, resolveLimits, capacityViolations, DEFAULT_ROUND_LIMITS, ROUND_LIMITS, ROUND_LIMIT_ENV, resolveRoundLimits, ROUND_LIMIT_OF_KIND, roundOf, isQualityTask, normTitle, roundLimitViolations, reworkLoopWriteGuard, mutateTasks, readStandingRules, appendStandingRule, rulesRun, scopeOverlapWarnings, applyTaskStatus, waitRun, eventFamily, verdictFromToken, normalizeRoleName, truncateCodepoints, filterRunScopedSubs, runCreatedAtMs, runLogTail, liveFiles, LIVE_FILES_CACHE, DEFAULT_ROLES, resolveTierGate, TIER_GATE_ENV, snapshotRun, settingsPath, loadSettingsSync, currentSettings, limitsBaseFromSettings, roundLimitsBaseFromSettings, effectiveTierGate: () => TIER_GATE, ensureSkillInstalled, ensurePresetInstalled, uninstallInstalled, buildSkillRegistration, parseSkillMarkdown, PLUGIN_VERSION, INSTALL_STAMP, runtimeSkillRegistered: () => RUNTIME_SKILL_REGISTERED, agentScopedToolNames, warnLeadToolFaceOnce, resolveLeadToolFace, LEAD_TOOLFACE_ENV, effectiveLeadToolFace: () => LEAD_TOOLFACE, resolveLoopGuard, LOOP_GUARD_ENV, effectiveLoopGuard: () => LOOP_GUARD_ENABLED, installHostSettings, hostValues, hostScope, hostSettingsNote, updateHostSettings, pickFileOnly, pickHostExpressible, buildHostSchema, hostBase, hostSchemaPaths, reapplySettingsDerived, currentSettings, mergeSettings };
+export const _live = { pushActivity, phaseAccountingViolations, loggedPhases, authorityViolations, WRITE_TRACER, createWriteTracer, formatConflict, summarizeTool, parseLogLine, roleOfSub, mapRoleToSub, membersFromState, buildRoleSubMap, resolveSubRoles, childSessionTiming, subHeaderIndex, sessionExists, SUB_HEADER_CACHE, workflowEventIndex, workflowChildLabels, workflowChildMeta, workflowRuns, WF_EVENT_CACHE, rememberSessionRun, sessionRunFor, runOwnerSession, SESSION_RUNS, parseTeamCommand, deriveMemberEntries, schemaViolations, runHealth, RUN_STALL_MS, scaffoldFingerprint, SCAFFOLD_REQUIRED, strandedTasks, settleStranded, IN_FLIGHT_STATUSES, normalizeCoverage, SCHEMA_WARN_SEEN, pushActivityEvent, DEFAULT_LIMITS, LIMITS, resolveLimits, capacityViolations, DEFAULT_ROUND_LIMITS, ROUND_LIMITS, ROUND_LIMIT_ENV, resolveRoundLimits, ROUND_LIMIT_OF_KIND, roundOf, isQualityTask, normTitle, roundLimitViolations, reworkLoopWriteGuard, mutateTasks, readStandingRules, appendStandingRule, rulesRun, scopeOverlapWarnings, applyTaskStatus, waitRun, eventFamily, verdictFromToken, normalizeRoleName, truncateCodepoints, filterRunScopedSubs, runCreatedAtMs, runLogTail, liveFiles, LIVE_FILES_CACHE, DEFAULT_ROLES, resolveTierGate, TIER_GATE_ENV, snapshotRun, settingsPath, loadSettingsSync, currentSettings, limitsBaseFromSettings, roundLimitsBaseFromSettings, effectiveTierGate: () => TIER_GATE, ensureSkillInstalled, ensurePresetInstalled, uninstallInstalled, buildSkillRegistration, parseSkillMarkdown, PLUGIN_VERSION, INSTALL_STAMP, runtimeSkillRegistered: () => RUNTIME_SKILL_REGISTERED, agentScopedToolNames, warnLeadToolFaceOnce, resolveLeadToolFace, LEAD_TOOLFACE_ENV, effectiveLeadToolFace: () => LEAD_TOOLFACE, resolveLoopGuard, LOOP_GUARD_ENV, effectiveLoopGuard: () => LOOP_GUARD_ENABLED, resolveRosterDefaults, rosterSettings, createRun, watchScript, canvasPollMs, installHostSettings, hostValues, hostScope, hostSettingsNote, updateHostSettings, pickFileOnly, pickHostExpressible, buildHostSchema, hostBase, hostSchemaPaths, reapplySettingsDerived, currentSettings, mergeSettings };
 
 export function apply(ctx, config) {
   // 留一份 config：设置在运行时改变（官方面板 / 浮层）时要**用同一份 config** 重算上限与档位门，
@@ -4804,7 +4938,8 @@ export function apply(ctx, config) {
                 let sel = null;
                 if (runParam && wsParam) {
                   sel = await snapshotRun(wsParam, runParam);
-                  if (sel) rememberSessionRun(sid, wsParam, runParam, 'view'); // user deliberately picked a run
+                  // 只在**该会话真实存在**时才记忆（假 id 不得落盘，见 sessionExists）
+                  if (sel && sessionExists(ctx, sid)) rememberSessionRun(sid, wsParam, runParam, 'view'); // user deliberately picked a run
                 } else if (runParam && workspaces.length === 1) {
                   sel = await snapshotRun(workspaces[0], runParam);
                 } else {
@@ -4881,10 +5016,8 @@ export function apply(ctx, config) {
                   if (membersFromState(sel.stateMembers).byRole.size) {
                     subById = buildRoleSubMap(subs, sel.stateMembers, wfLabels); // 已登记：不过滤、不丢
                   } else {
-                    const timingOfSubs = new Map();
-                    for (const s of subs) {
-                      try { timingOfSubs.set(String(s.id || ''), await childSessionTiming(ctx, s.id)); } catch { /* best-effort */ }
-                    }
+                    // 只查表、不读日志（热点 D 修复）：见 subHeaderIndex 的注释。
+                    const timingOfSubs = subHeaderIndex(ctx, subs, wfLabels);
                     const scoped = filterRunScopedSubs(subs, {
                       wfLabels,
                       runId: sel.runId,
@@ -4944,12 +5077,14 @@ export function apply(ctx, config) {
                 }
                 // 时间维度（任何"分批/波次"视图都需要）：createdAt 取自子会话 header，
                 // lastEventAt 复用下面已收集的 per-agent feed 最后一条事件时间（零额外开销）。
-                // **必须走 childSessionTiming 这条 durable 路径**：已结束的子代理会被从活存储里
-                // 清掉，只查 ctx.sessions.get() 会让每个成员都是 0（面板显示「无创建时间记录，
-                // 无法分批」，尽管会话日志第一行就写着 createdAt）。
-                // 不臆造：三源都拿不到就保持 0，UI 按"无时间数据"如实降级。
+                // 走 subHeaderIndex（**只查表**）：已结束的子代理会被从活存储里清掉，但它们的
+                // durable header 字段由 listSubagentStatusBySession 的 listSessions() 分支
+                // **顺带**带出来了（createdAt/parentId/depth），所以不需要再读一次日志。
+                // 2026-09-15：此前这里对每个子会话 await childSessionTiming（会全量 readSession），
+                // 是 /state 冷态 283.6 s 的根因。不臆造：三源都拿不到就保持 0，UI 如实降级。
+                const timingIdx = subHeaderIndex(ctx, subs, wfLabels);
                 const timingOf = {};
-                for (const s of subs) timingOf[String(s.id || '')] = await childSessionTiming(ctx, s.id);
+                for (const s of subs) timingOf[String(s.id || '')] = timingIdx.get(String(s.id || '')) || { createdAt: 0, parentId: '', depth: 0 };
                 sel.agents = subs.map((s) => {
                   const sid2 = String(s.id || '');
                   const t = timingOf[sid2] || { createdAt: 0, parentId: '', depth: 0 };
@@ -5469,10 +5604,13 @@ export function apply(ctx, config) {
 
           // ── F 线：设置控制台路由（GET 读 / POST 写）──────────────────────────────
           // 走 `withRoute`（B 线第 9 项抽出的共享件）：方法校验 / 405 空体 / 500 兜底一条不落。
-          // **诚实边界（2026-09-15 更正）**：此前这里写"`roster`/`gates` 两类改完要重启、`display`
-          // 类即时生效"—— **两句都不实**：前者由 `reapplySettingsDerived()` 当场重算（见下），
-          // 后者在 1.3.2 审核中查明**根本没有消费者**（`display.*` 只有存储层，待 1.3.3 接线，
-          // 已在 hint 上如实标注「暂未生效」）。响应里不再声称任何一类需要重启。
+          // **诚实边界（2026-09-15 更正 → 1.3.4 接线完成）**：此前这里写"`roster`/`gates` 两类改完要
+          // 重启、`display` 类即时生效"—— 当时两句都不实。现状（都已在测试里钉住）：
+          //   · `roster`/`gates`：由 `reapplySettingsDerived()` 当场重算，`roster.defaultRoles` 等在建 run
+          //     时读（见 `resolveRosterDefaults()`）⇒ **无需重启**；
+          //   · `display.*`：1.3.4 起**真的有消费者** —— 浮层/面板由 `client.js` 的 `useDisplaySettings()`
+          //     （单一设置桥 `EXPERT_DISPLAY`）读，画布 live 轮询由本文件的 `canvasPollMs()` 读。
+          // 响应里不声称任何一类需要重启（1.3.2 起 `needsRestart` 恒 false）。
           const disposeSettings = registerLocal({
             kind: 'exact',
             path: '/plugins/dsh-expert-team/settings',

package/lib/settings.js

@@ -62,36 +62,29 @@ export const SETTINGS_SPEC = {
   },
 };
 
-// ── 「暂未生效」的项：**单一真源**（2026-09-15，1.3.2 诚实性收口）────────────────────
+// ── 「暂未生效」的项：**单一真源**（1.3.2 建立 → 1.3.4 接线完成，故现在为空）──────────
 //
-// 为什么需要这张表：审核（两轮独立只读核验 + 全库 grep）发现 20 个设置项里有 10 项的**设置值
-// 没有任何消费者** —— 用户在设置页勾了、改了，什么都不会发生。其中 3 项已在本版处理
-// （`gates.boundaryTasks`/`gates.boundarySpec` 的行为本就**无条件强制**，故直接删除 spec；
-// `gates.loopGuard` 是"接错了源"，已接线）。剩下 7 项**本版只标注、不接线**（留 1.3.3）。
+// 这张表是**两处消费的同一个真源**：
+//   ① `decorateHint()` 把标记追加到 hint（设置页里用户可见）；
+//   ② `settings-consumers.test.mjs` 用它当白名单，语义是**集合相等** ——
+//      新增一个没有消费者的设置项 ⇒ 红；接线后忘了删这一行 ⇒ 也红（清单只减不增）。
 //
-// 为什么不干脆删掉这 7 项：它们描述的是**真要实现的能力**（浮层宽度、默认页签、默认班底…），
-// 不是误加的开关。但"存在即承诺"——把 hint 写成承诺、行为却是空的，与删掉那两条装饰开关的理由
-// 完全一样（不能双重标准）。所以：**如实标注"暂未生效"**，直到真的接上。
+// 历史：1.3.2 的审计（两轮独立只读核验）发现 20 个设置项里 **10 项的设置值没有任何消费者**。
+// 当时处理了 3 项（`gates.boundaryTasks`/`gates.boundarySpec` 的行为本就**无条件强制**，直接删 spec；
+// `gates.loopGuard` 是"接错了源"，已接线），剩下 7 项（display 4 + roster 3）登记在此、界面标注。
+// **1.3.4 把这 7 项全部接线** ⇒ 表空 = "零装饰性开关"的证明。机制保留：将来若又要"先上表盘、后做行为"，
+// 把限定路径写进来即可（界面标注与 ratchet 白名单会自动跟上；接线后删掉那一行，两处同时消失）。
 //
-// 用法（两处消费，同一个真源）：
-//   ① `decorateHint()` 把标记追加到 hint（设置页表单可见）；
-//   ② `settings-consumers.test.mjs` 用它做白名单，语义是**集合相等**：
-//      新增死开关 ⇒ 红；接线后忘了删这一行 ⇒ 也红（逼着清单只减不增）。
-//   键 = 限定路径；值 = 一句"为什么现在没用"（写**实测来源**，不写猜测）。
-export const INERT_SETTINGS = {
-  'display.pollMs': '现值硬编码在浮层（client.js:1317 的 1200/3000）',
-  'display.capsuleMs': '现值硬编码在浮层（client.js:2336 的 4000）',
-  'display.panelWidth': '现值来自 localStorage 的 `et-width`（client.js:309），与设置无关',
-  'display.defaultTab': '现值硬编码为 team（client.js:1198）',
-  'roster.deliverable': '现由 `/team --no-code` 派生（mode.noCode），设置值不参与',
-  'roster.persist': '现仅由 `/team --persist` 置位（mode.persist），设置值不参与',
-  'roster.defaultRoles': '现用常量 DEFAULT_ROLES 或 `--roles`，设置值不参与',
-};
+// ⚠️ 两条文案纪律（1.3.4 的事故换来的）：
+//   · **不承诺版本号** —— 1.3.2 写"待 1.3.3 接线"，而 1.3.3 发布时并未接线 ⇒ 那句话本身成了假承诺；
+//   · **不写行号** —— 行号会腐烂（实测登记后不久就偏移），且对用户毫无意义；
+//     要留证据就写进紧邻的**代码注释**（本仓注释里保留完整出处）。
+export const INERT_SETTINGS = {};
 
-/** 「暂未生效」标记文本（只此一份，`decorateHint` 是唯一加工点）。 */
+/** 「暂未生效」标记文本（只此一份，`decorateHint` 是唯一加工点）。**版本中立**。 */
 export function inertMark(path) {
   const why = INERT_SETTINGS[String(path)];
-  return why ? `（暂未生效：待 1.3.3 接线 —— ${why}）` : '';
+  return why ? `（暂未生效：尚未接线 —— ${why}）` : '';
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yangdcm/dsh-expert-team",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "dsh「专家团」bundle：一句自然语言自动组建/持久化一支 12 角色多智能体团队，共享工作区协议 + 阶段门控编排 + 结构化交接 + 质量门禁/自动调度，实现者直接改代码并产出持久工件；带 live 团队浮层（质量门禁/覆盖率/工件预览）。 · Role-based multi-agent expert team for DeepSeek Harness: one sentence in, a staged and gated team delivery out.",
   "type": "module",
   "license": "MIT",
@@ -84,7 +84,7 @@
     "check:name": "node scripts/rename-package.mjs --check",
     "test:regression": "node regression.test.mjs",
     "test:e2e": "node e2e.test.mjs",
-    "test:all": "node bootstrap.test.mjs && node host-settings.test.mjs && node smoke.test.mjs && node regression.test.mjs && node e2e.test.mjs && node flow.test.mjs && node plan-decide.test.mjs && node plan-discard.test.mjs && node models-honesty.test.mjs && node evidence-gate.test.mjs && node sync-gate.test.mjs && node artifact-writer.test.mjs && node dag.test.mjs && node metrics.test.mjs && node broken-chain.test.mjs && node schema-warn.test.mjs && node template-copy.test.mjs && node task-binding.test.mjs && node role-merge.test.mjs && node wf-recovery.test.mjs && node panorama.test.mjs && node run-ownership.test.mjs && node role-identity.test.mjs && node command-parse.test.mjs && node member-registry.test.mjs && node schema-check.test.mjs && node run-health.test.mjs && node cordis-fs-port.test.mjs && node scaffold-fingerprint.test.mjs && node preset-lint.test.mjs && node stranded-tasks.test.mjs && node agent-scope-guard.test.mjs && node schema-warn-noise.test.mjs && node tool-card-status.test.mjs && node dag-status.test.mjs && node capacity-limits.test.mjs && node task-cas.test.mjs && node write-lock.test.mjs && node card-stall.test.mjs && node multi-session-and-confirm.test.mjs && node standing-rules.test.mjs && node scope-overlap.test.mjs && node task-cancel-protect.test.mjs && node wait-run.test.mjs && node rework-loop.test.mjs && node client-css-integrity.test.mjs && node interception.test.mjs && node mutation-catalog.test.mjs && node write-bypass-ratchet.test.mjs && node asi-hazards.test.mjs && node dispatch-contract.test.mjs && node closure-ledger.test.mjs && node rework-nature.test.mjs && node loop-guard.test.mjs && node vocab-consistency.test.mjs && node state-no-write.test.mjs && node routes-shared.test.mjs && node metrics-render.test.mjs && node metrics-collect.test.mjs && node first-runnable.test.mjs && node closing-budget.test.mjs && node scan-single-source.test.mjs && node tier.test.mjs && node dispatch-ledger.test.mjs && node tier-gate.test.mjs && node tier-badge.test.mjs && node validate-module.test.mjs && node settings.test.mjs && node settings-page.test.mjs && node policy.test.mjs && node phase-accounting.test.mjs && node log-parse-module.test.mjs && node command-parse-module.test.mjs && node authority.test.mjs && node write-tracer.test.mjs && node token-accounting.test.mjs && node lead-toolface.test.mjs && node settings-consumers.test.mjs",
+    "test:all": "node bootstrap.test.mjs && node host-settings.test.mjs && node smoke.test.mjs && node regression.test.mjs && node e2e.test.mjs && node flow.test.mjs && node plan-decide.test.mjs && node plan-discard.test.mjs && node models-honesty.test.mjs && node evidence-gate.test.mjs && node sync-gate.test.mjs && node artifact-writer.test.mjs && node dag.test.mjs && node metrics.test.mjs && node broken-chain.test.mjs && node schema-warn.test.mjs && node template-copy.test.mjs && node task-binding.test.mjs && node role-merge.test.mjs && node wf-recovery.test.mjs && node panorama.test.mjs && node run-ownership.test.mjs && node role-identity.test.mjs && node command-parse.test.mjs && node member-registry.test.mjs && node schema-check.test.mjs && node run-health.test.mjs && node cordis-fs-port.test.mjs && node scaffold-fingerprint.test.mjs && node preset-lint.test.mjs && node stranded-tasks.test.mjs && node agent-scope-guard.test.mjs && node schema-warn-noise.test.mjs && node tool-card-status.test.mjs && node dag-status.test.mjs && node capacity-limits.test.mjs && node task-cas.test.mjs && node write-lock.test.mjs && node card-stall.test.mjs && node multi-session-and-confirm.test.mjs && node standing-rules.test.mjs && node scope-overlap.test.mjs && node task-cancel-protect.test.mjs && node wait-run.test.mjs && node rework-loop.test.mjs && node client-css-integrity.test.mjs && node interception.test.mjs && node mutation-catalog.test.mjs && node write-bypass-ratchet.test.mjs && node asi-hazards.test.mjs && node dispatch-contract.test.mjs && node closure-ledger.test.mjs && node rework-nature.test.mjs && node loop-guard.test.mjs && node vocab-consistency.test.mjs && node state-no-write.test.mjs && node routes-shared.test.mjs && node metrics-render.test.mjs && node metrics-collect.test.mjs && node first-runnable.test.mjs && node closing-budget.test.mjs && node scan-single-source.test.mjs && node tier.test.mjs && node dispatch-ledger.test.mjs && node tier-gate.test.mjs && node tier-badge.test.mjs && node validate-module.test.mjs && node settings.test.mjs && node settings-page.test.mjs && node policy.test.mjs && node phase-accounting.test.mjs && node log-parse-module.test.mjs && node command-parse-module.test.mjs && node authority.test.mjs && node write-tracer.test.mjs && node token-accounting.test.mjs && node lead-toolface.test.mjs && node settings-consumers.test.mjs && node settings-wiring.test.mjs && node state-perf-guard.test.mjs",
     "test:toolcard": "node tool-card-status.test.mjs",
     "test:flow": "node flow.test.mjs",
     "test:decide": "node plan-decide.test.mjs",