@a9i5k4/dsh-auto-memory 2.5.2 → 3.0.0

package/lib/client.js

@@ -7,7 +7,7 @@
  *   3. settings.section      — 自动记忆设置页(存储位置、注入、反思风格)
  * Data flows over /api/dsh-auto-memory/* (loopback-only host routes).
  */
-console.log('[dsh-auto-memory] client v2.5.2 fingerprint: per-session-workspace')
+console.log('[dsh-auto-memory] client v3.0.0 fingerprint: index-self-heal')
 window.__ModuleLoader__.load({
   id: '@a9i5k4/dsh-auto-memory',
   factory: (require) => {
@@ -15,6 +15,18 @@ window.__ModuleLoader__.load({
     var exports = module.exports
     var React = require('react')
     var h = React.createElement
+    // react-dom 的 createPortal(2026-09-16): 抽屉要浮在整页之上, 必须挂到 body ——
+    // 挂在看板容器内的话, 页面往下滚它就被推出视口, 用户「点开的页签看不见」。
+    // 这是 dsh-context 的同类做法(它也用 createPortal 渲染居中弹窗)。
+    // require 失败时降级为 null ⇒ 抽屉退回容器内渲染(功能不丢, 只是不能浮)。
+    var createPortal = null
+    try { createPortal = require('react-dom').createPortal } catch (e) { createPortal = null }
+    /** 把节点送进 body —— 浮窗必须挂在 body 才能浮在整页之上且不随页面滚动跑出视口。
+     *  createPortal 不可用时原样返回(退回常规渲染, 功能不丢)。 */
+    function kxPortal(node) {
+      if (!createPortal || typeof document === 'undefined' || !document.body) return node
+      return createPortal(node, document.body)
+    }
     var useState = React.useState
     var useEffect = React.useEffect
     var useReducer = React.useReducer
@@ -252,6 +264,7 @@ window.__ModuleLoader__.load({
         fProjectDir: '项目记忆目录', fProjectDirHint: '相对各工作区的目录名(默认 .dsh-memory)。',
         fInject: '注入记忆上下文', fInjectHint: '每次组装提示词时自动注入 <memory_system> 块。',
         fBudget: '注入预算(字符)', fBudgetHint: '记忆块总预算,超出部分截断。默认 1600(≈400-600 token/轮);活跃会话每轮都注入这段背景,调低更省 token,调高保留更多记忆。',
+        fExclude: '排除来源(每行一条)', fExcludeHint: '这些来源不再进注入,避免坏记忆反复灌入把结果一路带偏。四种写法:记忆 id(mem_xxx)、整层(log/whiteboard/project/user/reflection)、目录前缀(以 / 或 \\ 结尾)、精确文件路径。与 supersede 互补:supersede 管"被新版替代",这里管"整条来源不可信"。被挡下的条数会在注入里以 [降级] 如实标注。',
         fNoteCap: '项目笔记容量上限(字符)', fNoteCapHint: '项目笔记 MEMORY.md 的容量上限,默认 12000。超出时自动整理:先把较早内容交给模型折叠成要点,失败则退回整条归档(原文进 archive,不丢)——新记忆不会被堵在外面。注意与上面的「注入预算」不是一回事:这个管文件本体大小,注入预算管每轮往上下文塞多少摘要。',
         fUserCap: '用户级记忆容量上限(字符)', fUserCapHint: '用户级 MEMORY.md(跨项目规则)的容量上限,默认 12000。整理方式与项目笔记相同(先折叠成要点,必要时整条归档)。',
         fSnapGap: '快照最小间隔(轮)', fSnapGapHint: '动态记忆快照内容变化后,至少隔 N 轮才重新注入,避免每轮日志微变都追加快照导致历史膨胀。默认 5;0=每轮都尝试(仍受内容变化约束)。',
@@ -271,6 +284,8 @@ window.__ModuleLoader__.load({
         awayTitle: '欢迎回来', awayMsg: '你离开的这段时间,我已经帮你把日志整理好了。记忆窗口已打开,可以看看这段时间的状况。',
         sumTitle: '时段总结',
         fReflect: '每日反思', fReflectHint: '昨天有工作日志时,会话首轮主动呈现昨日反思。',
+        fAutoContinue: '自动接续', fAutoContinueHint: '水位达到阈值时弹出确认卡,同意即接续到新会话(沿用工作区/模型/思考档位)。出厂默认关闭(功能仍在测试期);本开关独立于交接白板——关白板不影响水位测量与接续资格。',
+        handoffSwitchTitle: '白板与自动接续开关', handoffSwitchHint: '两个开关出厂默认均为关闭(功能仍在测试期);此处与「设置 → 上下文」读写同一对配置键,任一处改动即全局生效。', handoffOn: '交接白板:开', handoffOff: '交接白板:关',
         fHandoff: '交接白板', fHandoffHint: 'PLAN.md 全貌快照 + 四段式交接账本:模型在理解全貌/阶段完成时写入,注入动态快照首位,面板「白板」页签可实时查看,跨上下文窗口续命。',
         fWaterWindow: '水位估计窗口(token)', fWaterWindowHint: '会话消息按官方公式(4 字符≈1 token)估算达到该值即视为上下文将满;0=关闭。默认 65536(128K 窗口的保守半量),按所用模型调整。',
         fWaterAdvisory: '水位交接建议', fWaterAdvisoryHint: '水位越阈时在动态快照注入交接建议(写账本/刷新白板/建议开新窗);无人值守时静默。',
@@ -284,7 +299,7 @@ window.__ModuleLoader__.load({
         fMaintSchedule: '定时 30 天蒸馏', fMaintScheduleHint: '每天到点自动把超过 30 天的旧日志蒸馏归档(等价 memory_maintain);无旧日志时零成本跳过。',
         fMaintScheduleTime: '蒸馏触发时间', fMaintScheduleTimeHint: 'HH:MM,默认 10:00(与固化时间错开)。',
         waterCardTitle: '上下文水位', waterAutoSrc: '自动检测', waterManualSrc: '手动设定', waterOfficialSrc: '官方路由容量', waterFallbackSrc: '回退默认值', waterNotMeasured: '本会话尚未测量(发送一轮后自动更新)', waterMeterOfficial: '官方计量', waterMeterHeuristic: '启发式降级', waterThresholdHint: '水位达到 {t} 时注入交接建议并自动补写账本;计量优先用官方 token-meter(与聊天框 context ring 同源),不可用时降级启发式估算;窗口优先取官方路由容量(request/context 的 contextWindow),其次按当前模型查 settings.yaml contextWindow,也可在下方手动覆盖;触发分母=官方声明窗口(provider 自报过硬限时取较小值),预留输出不参与扣减。',
-        autoContTitle: '自动接续', autoContHint: '开启后:水位达到阈值、且旧会话已空闲(harness 权威 running 位在轮次边界转为 false,取代旧「两轮水位持平」)时,弹出确认卡——同意=立即接续,拒绝=本轮跳过(同一边界不再提示),30-40 秒无操作视为挂机自动接续;接续前先让旧 Agent 刷新白板 PLAN 与交接账本,再建新会话(沿用工作区/模型/思考档位)并注入分层交接材料;触发后默认 30 分钟内不重复。', autoContOn: '自动接续:开', autoContOff: '自动接续:关', autoContThreshold: '阈值', autoContCountdown: '⏳ {s} 秒后自动接续…', autoContCancel: '取消', autoContConfirm: '本会话上下文已用 {p}%(按官方声明窗口计,官方约 80% 才压缩),旧会话已空闲(轮次边界)——现在接续到新会话?', autoContAgree: '同意接续', autoContReject: '拒绝', autoContTimeout: '{s} 秒后自动接续(视为挂机)', autoContRejected: '已跳过本次接续(下一个轮次边界再提醒)',
+        autoContTitle: '自动接续', autoContHint: '开启后:水位达到阈值即弹出确认卡——同意=立即接续,拒绝=本轮跳过(同一边界不再提示),30-40 秒无操作视为挂机自动接续;接续流程为先终止旧会话当前回合(未完成的回答会被打断)→ 让旧 Agent 刷新白板 PLAN 与交接账本并等它真正执行完 → 再建新会话(沿用工作区/模型/思考档位)并注入分层交接材料;触发后默认 30 分钟内不重复。', autoContOn: '自动接续:开', autoContOff: '自动接续:关', autoContThreshold: '阈值', autoContCountdown: '⏳ {s} 秒后自动接续…', autoContCancel: '取消', autoContConfirm: '本会话上下文已用 {p}%(按官方声明窗口计,官方约 80% 才压缩)。现在接续到新会话?点「同意接续」会先终止旧会话当前回合(未完成的回答会被打断),再让旧会话刷新白板与账本,然后建新会话。', autoContAgree: '同意接续', autoContReject: '拒绝', autoContTimeout: '{s} 秒后自动接续(视为挂机)', autoContRejected: '已跳过本次接续(下一个轮次边界再提醒)',
         continueCardTitle: '一键接续', continueCardHint: '写好交接账本→创建新会话→把交接材料作为首条消息预载,并自动切换到新会话继续任务(接续材料含白板节选+最新账本;当前工作区无账本时自动取全局最近一篇)。', continueBtn: '一键接续到新会话', continueBusy: '处理中…',
         fStyle: '反思风格', fStyleHint: '生活化 / 专业性 / 由内容决定。',
         fLocale: '界面语言', fLocaleHint: '默认跟随 DSH 系统语言;也可手动指定中文 / English。', followSystem: '跟随系统语言',
@@ -403,6 +418,7 @@ window.__ModuleLoader__.load({
         fProjectDir: 'Project memory dir', fProjectDirHint: 'Directory name relative to each workspace (default .dsh-memory).',
         fInject: 'Inject memory context', fInjectHint: 'Auto-inject <memory_system> block into every prompt.',
         fBudget: 'Injection budget (chars)', fBudgetHint: 'Total budget for the memory block; excess is truncated. Default 1600 (~400-600 tokens/turn); this background is injected every turn, so lower = fewer tokens, higher = more memory retained.',
+        fExclude: 'Excluded sources (one per line)', fExcludeHint: 'These sources never enter injection again, so a bad memory cannot keep steering the result. Four forms: memory id (mem_xxx), whole layer (log/whiteboard/project/user/reflection), directory prefix (ending in / or \\), exact file path. Complements supersede: supersede covers "replaced by a newer version", this covers "this source is untrustworthy". Blocked counts are reported as a [降级] line, never silently.',
         fNoteCap: 'Project note capacity (chars)', fNoteCapHint: 'Capacity cap for the project MEMORY.md, default 12000. When exceeded the framework auto-consolidates: older content is first folded into bullet points by the model, falling back to whole-record archiving (originals go to archive, never lost) — new memories are never blocked. This is NOT the injection budget above: this caps the file itself, the injection budget caps the digest added to each turn.',
         fUserCap: 'User memory capacity (chars)', fUserCapHint: 'Capacity cap for the user-level MEMORY.md (cross-project rules), default 12000. Same consolidation behaviour (fold into points first, whole-record archive as fallback).',
         fSnapGap: 'Snapshot min gap (turns)', fSnapGapHint: 'After the dynamic memory snapshot changes, re-inject at least N turns later, so small per-turn log changes do not append a new snapshot every turn (history bloat). Default 5; 0 = try every turn (still change-gated).',
@@ -422,6 +438,8 @@ window.__ModuleLoader__.load({
       awayTitle: 'Welcome back', awayMsg: 'While you were away, I tidied up your logs. The memory panel is open — take a look at what happened.',
       sumTitle: 'Period summary',
         fReflect: 'Daily reflection', fReflectHint: 'When yesterday has logs, the agent presents the reflection at session start.',
+        fAutoContinue: 'Auto continue', fAutoContinueHint: 'Shows a confirm card once the water level passes the threshold; agreeing continues into a new session (workspace/model/reasoning effort are carried over). Off by default (still in testing); independent of the handoff whiteboard — turning the whiteboard off never disables water-level measurement or continue eligibility.',
+        handoffSwitchTitle: 'Whiteboard & auto continue switches', handoffSwitchHint: 'Both default to off (still in testing). These are the same config keys as Settings → Context — changing either applies globally.', handoffOn: 'Handoff whiteboard: on', handoffOff: 'Handoff whiteboard: off',
         fHandoff: 'Handoff whiteboard', fHandoffHint: 'PLAN.md snapshot + four-part handoff ledger: written by the model at milestones, injected first in the dynamic snapshot, live in the Whiteboard tab — context that survives windows.',
         fWaterWindow: 'Water-level window (tokens)', fWaterWindowHint: 'Session messages priced with the official meter (4 chars ≈ 1 token); past this, context is considered nearly full; 0 disables. Default 65536 — a conservative half of a 128K window.',
         fWaterAdvisory: 'Water-level handoff advisory', fWaterAdvisoryHint: 'Injects a handoff advisory past the threshold (write ledger / refresh plan / suggest a new window); silent in unattended mode.',
@@ -435,7 +453,7 @@ window.__ModuleLoader__.load({
         fMaintSchedule: 'Scheduled 30-day distill', fMaintScheduleHint: 'Once a day at the set time, distill & archive logs older than 30 days (same flow as memory_maintain); zero cost when nothing to archive.',
         fMaintScheduleTime: 'Distill time', fMaintScheduleTimeHint: 'HH:MM, default 10:00 (staggered from the consolidation time).',
         waterCardTitle: 'Context water level', waterAutoSrc: 'auto-detected', waterManualSrc: 'manual', waterOfficialSrc: 'route capacity', waterFallbackSrc: 'fallback default', waterNotMeasured: 'Not measured for this session yet (updates after the next turn)', waterMeterOfficial: 'official meter', waterMeterHeuristic: 'heuristic fallback', waterThresholdHint: 'Past {t} of the window, the handoff advisory is injected and the skeleton ledger is backfilled; metering prefers the official token-meter (same source as the chat context ring), falling back to the heuristic when unavailable; the window prefers the official route capacity (request/context contextWindow), then the active model in settings.yaml, or your manual override below; the trigger denominator is the official declared window (min with any provider-reported hard limit) — the reserved output budget is not deducted.',
-        autoContTitle: 'Auto continue', autoContHint: 'When on: once the water level passes the threshold AND the old session is idle (the authoritative harness running bit flipped to false at a turn boundary, replacing the old "level unchanged across two polls"), a confirm card appears — Agree = continue now, Decline = skip this boundary (no re-prompt for it), no answer for 30-40s = unattended, continue automatically. Before continuing, the old agent refreshes PLAN + ledger; the new session keeps workspace/model/reasoning effort and receives layered handoff material; suppressed for 30 minutes after each run.', autoContOn: 'Auto continue: on', autoContOff: 'Auto continue: off', autoContThreshold: 'Threshold', autoContCountdown: '⏳ Auto-continue in {s}s…', autoContCancel: 'Cancel', autoContConfirm: 'Context at {p}% of the official declared window (official compaction starts ~80%) and the old session is idle (turn boundary) — continue into a new session now?', autoContAgree: 'Continue', autoContReject: 'Decline', autoContTimeout: 'auto-continue in {s}s (unattended)', autoContRejected: 'Skipped this handoff (will ask again at the next turn boundary)',
+        autoContTitle: 'Auto continue', autoContHint: 'When on: a confirm card appears once the water level passes the threshold — Agree = continue now, Decline = skip this boundary (no re-prompt for it), no answer for 30-40s = unattended, continue automatically. The handoff sequence is: stop the old turn first (an unfinished answer will be interrupted) → have the old agent refresh PLAN + ledger and wait until it has really run → then create the new session, which keeps workspace/model/reasoning effort and receives layered handoff material; suppressed for 30 minutes after each run.', autoContOn: 'Auto continue: on', autoContOff: 'Auto continue: off', autoContThreshold: 'Threshold', autoContCountdown: '⏳ Auto-continue in {s}s…', autoContCancel: 'Cancel', autoContConfirm: 'Context at {p}% of the official declared window (official compaction starts ~80%). Continue into a new session now? Agreeing stops the old turn first (an unfinished answer will be interrupted), then the old agent refreshes PLAN + ledger before the new session is created.', autoContAgree: 'Continue', autoContReject: 'Decline', autoContTimeout: 'auto-continue in {s}s (unattended)', autoContRejected: 'Skipped this handoff (will ask again at the next turn boundary)',
         continueCardTitle: 'One-click continue', continueCardHint: 'Writes the handoff ledger → creates a new session → injects the handoff material as the first message → switches to the new session automatically (material = PLAN excerpt + latest ledger; falls back to the most recent global ledger when this workspace has none).', continueBtn: 'Continue in a new session', continueBusy: 'Working…',
         fStyle: 'Reflection style', fStyleHint: 'Life-style / Professional / Auto.',
         fLocale: 'UI language', fLocaleHint: 'Follows the DSH system language by default; you can also pin Chinese / English.', followSystem: 'Follow system language',
@@ -567,6 +585,27 @@ window.__ModuleLoader__.load({
 
     // ───────────────────────── 更新弹窗 / 首次指导 ─────────────────────────
     var CHANGELOG = {
+      '3.0.0': { zh: [
+        '★ 大版本：底层重建收官。检索、注入、容量、并发四条底层全部重做；白板与看板从「实验特性」变成出厂形态。',
+        '★ 白板默认开启（原来默认关）。交接白板 + 四段式交接账本是这一版的招牌能力，出厂关着等于新用户看不到它。想彻底关掉：设置 → 自动化 → 交接白板。',
+        '★ 白板默认「新版看板」：结构化索引（条目/标签/线索/版本链）+ 列式泳道视图 + 两个遍历工具（按标签展开 memory_expand_pre / 按 id 回溯 memory_trace_pre）。旧的文字白板完整保留，设置页一键切回（「旧版白板」）。',
+        '说明：自动接续**仍然默认关闭**——水位判据还没在你的机器上实测到位，这一版特意不动它，等验证满意再考虑。',
+        '修复:语义唤回长期「查不到东西」的真因。语义索引因一次没收尾的同步被永久占住（重启也只能暂时缓解），此后每轮都退化成「关键词 + 常驻目录」。现已修好：索引能建起来，唤回恢复语义检索。',
+        '修复:升级弹窗原先只弹 2.1.0 的旧说明（版本号写死），所以你一直看不到新版更新日志。现在会自动展示当前版本的说明。',
+        '修复:同时开两个会话时「谁也没法注入」、点进不同工作区时语义模型跟着走——4 处状态被两会话互相覆盖，现已按会话/工作区分开。',
+        '新增:自动接续的续航材料更完整；上下文将满时给出的白板/账本提示更稳。',
+        '老用户不受影响：你自己设过的开关与阈值一律沿用，只有从没设过的那几项会吃新默认。',
+      ], en: [
+        '★ Major release: the ground-up rebuild is complete. Retrieval, injection, capacity and concurrency were all rebuilt; the whiteboard and kanban are now shipping defaults rather than experiments.',
+        '★ Whiteboard is now ON by default (it used to be off). The handoff whiteboard plus four-part ledgers are this release\'s headline feature — off by default meant new users never saw them. To disable entirely: Settings → Automation → Handoff whiteboard.',
+        '★ Whiteboard now defaults to the new kanban: a structured index (entries/tags/cues/version chain), a column-swimlane view, and two traversal tools (expand by tag, trace by id). The old text whiteboard is fully retained — switch back with one click in Settings.',
+        'Note: auto-continue remains OFF by default — the water-level criteria have not yet been validated on your machine, so this release deliberately leaves it alone.',
+        'Fix: the real cause of semantic recall coming up empty for weeks. A sync that never finished had permanently occupied the index slot (restarting only helped temporarily), so every turn degraded to keyword + resident catalog. Fixed: the index now builds, and recall is semantic again.',
+        'Fix: the upgrade dialog only ever showed the old 2.1.0 notes (the version was hardcoded), so you never saw the current release notes. It now shows the version you actually upgraded to.',
+        'Fix: with two sessions open, neither could inject, and the semantic model followed you between workspaces — four pieces of state were overwriting each other. Now scoped per session/workspace.',
+        'New: more complete carry-over material for auto-continue; steadier whiteboard/ledger prompting as context fills up.',
+        'Existing users are unaffected: any switch or threshold you set yourself is kept — only never-set keys pick up the new defaults.',
+      ] },
       '2.5.2': { zh: [
         '修复:开启「无人值守模式」的用户切换工作区失灵(面板恒显示启动目录、日志 0)——防漂移锁此前全局钉死首个工作区,现改为按会话锁定,只防本会话内的目录漂移;未开启该模式的用户行为不变。',
         '修复:面板白板/账本恒显示「最近活跃会话」的内容——现在按你正在查看的会话取数;会话经工作区绑定创建(无 cwd)时也能正确解析;解析不出身份时如实提示「当前会话未绑定工作区」,不再展示错误路径。',
@@ -895,11 +934,82 @@ window.__ModuleLoader__.load({
       else dialogQueue.push(d)
       notifyDialog()
     }
+    // issue#40:宿主配置控制自动播放;localStorage 只记录**用户动作**,不得反过来当开关。
+    var tourNavigationEpoch = 0
+    var welcomeTourConfig = null
+    function decodeWelcomeConfigPre(response) {
+      if (!response || typeof response !== 'object' || Array.isArray(response)) return null
+      var cfg = response.config
+      if (!cfg && Object.prototype.hasOwnProperty.call(response, 'welcomeTourEnabled')) cfg = response
+      if (!cfg || typeof cfg !== 'object' || Array.isArray(cfg)) return null
+      if (cfg.welcomeTourEnabled !== undefined && typeof cfg.welcomeTourEnabled !== 'boolean') return null
+      return cfg
+    }
+    function welcomeAutoAllowedPre(cfg) {
+      if (!cfg || cfg.welcomeTourEnabled === false) return false
+      try { if (localStorage.getItem('dsh-auto-memory.tourDismissed') === '1') return false } catch (_) { return false }
+      return true
+    }
+    function dismissWelcomeTourPre(reason) {
+      tourNavigationEpoch++
+      if (reason === 'user') {
+        try { localStorage.setItem('dsh-auto-memory.tourDismissed', '1') } catch (_) {}
+      }
+      function target(d) { return d && d.kind === 'welcomeTour' && (reason !== 'config' || !d.manual) }
+      dialogQueue = dialogQueue.filter(function (d) { return !target(d) })
+      if (target(dialogState)) dialogState = dialogQueue.shift() || null
+      notifyDialog()
+    }
+    function rememberWelcomeConfigPre(response) {
+      welcomeTourConfig = decodeWelcomeConfigPre(response)
+      if (welcomeTourConfig && welcomeTourConfig.welcomeTourEnabled === false) dismissWelcomeTourPre('config')
+      return welcomeTourConfig
+    }
+    // 焦点陷阱:向导内的 Tab 不得逃到背景页面;Esc 关闭;关闭后焦点归还触发元素。
+    function installTourFocusPre(root, close, doc) {
+      if (!root || !doc) return function () {}
+      var previous = doc.activeElement
+      var selector = 'button:not([disabled]),a[href],input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])'
+      function focusables() {
+        return Array.prototype.filter.call(root.querySelectorAll(selector), function (el) { return el.getClientRects().length > 0 && el.getAttribute('aria-hidden') !== 'true' })
+      }
+      function onKey(e) {
+        if (e.key === 'Escape') { e.preventDefault(); e.stopPropagation(); close(); return }
+        if (e.key !== 'Tab') return
+        var items = focusables(), first = items[0], last = items[items.length - 1]
+        if (!items.length) { e.preventDefault(); root.focus(); return }
+        if (e.shiftKey && (doc.activeElement === first || !root.contains(doc.activeElement))) { e.preventDefault(); last.focus() }
+        else if (!e.shiftKey && (doc.activeElement === last || !root.contains(doc.activeElement))) { e.preventDefault(); first.focus() }
+      }
+      var keyTarget = typeof doc.addEventListener === 'function' ? doc : root
+      keyTarget.addEventListener('keydown', onKey, true)
+      var initial = focusables()[0] || root
+      initial.focus()
+      return function () {
+        keyTarget.removeEventListener('keydown', onKey, true)
+        if (previous && previous.isConnected && typeof previous.focus === 'function' &&
+            (root.contains(doc.activeElement) || doc.activeElement === doc.body)) previous.focus()
+      }
+    }
+    function openManualWelcomeTourPre() {
+      tourNavigationEpoch++
+      openDialog({ kind: 'welcomeTour', manual: true })
+    }
+    function loadWelcomeConfigPre(timeoutMs) {
+      return new Promise(function (resolve) {
+        var finished = false
+        var timer = setTimeout(function () { if (!finished) { finished = true; resolve(null) } }, timeoutMs || 5000)
+        apiGet(API.config).then(function (d) {
+          if (finished) return
+          finished = true; clearTimeout(timer); resolve(rememberWelcomeConfigPre(d))
+        }, function () { if (!finished) { finished = true; clearTimeout(timer); resolve(null) } })
+      })
+    }
     function closeDialog() { dialogState = dialogQueue.shift() || null; notifyDialog() }
     function onDialog(fn) { dialogListeners.add(fn); return function () { dialogListeners.delete(fn) } }
     // 调试/重看入口:控制台 window['dsh-auto-memory.openWelcomeTour']() 随时重开首启向导
     try {
-      window['dsh-auto-memory.openWelcomeTour'] = function () { openDialog({ kind: 'welcomeTour' }) }
+      window['dsh-auto-memory.openWelcomeTour'] = function () { openManualWelcomeTourPre() }
     } catch (eOpenTour) {}
     function cmpVersion(a, b) {
       var pa = String(a).split('.').map(Number), pb = String(b).split('.').map(Number)
@@ -958,6 +1068,7 @@ window.__ModuleLoader__.load({
       pyCancel: ROUTE_PREFIX + '/python-setup/cancel',
       pyStatus: ROUTE_PREFIX + '/python-setup/status',
       handoffState: ROUTE_PREFIX + '/handoff-state',
+      kanbanBoard: ROUTE_PREFIX + '/kanban-board',
       handoffContinue: ROUTE_PREFIX + '/handoff-continue',
       handoffPermission: ROUTE_PREFIX + '/handoff-permission',
       autoContState: ROUTE_PREFIX + '/auto-continue-state',
@@ -994,11 +1105,30 @@ window.__ModuleLoader__.load({
      */
     function saveConfigPatch(patch, hooks) {
       var h = hooks || {}
-      var p = apiPost(API.config, patch)
+      // issue#40:保存后立刻用**回传的真实配置**刷新向导闸,而不是等下次启动重新拉取。
+      // 关掉开关时顺手撤下正在显示的向导(否则"点了关闭但窗口还开着"——界面无即时回显)。
+      var p = apiPost(API.config, patch).then(function (d) {
+        rememberWelcomeConfigPre(d)
+        if (patch && typeof patch.welcomeTourEnabled === 'boolean') {
+          welcomeTourConfig = Object.assign({}, welcomeTourConfig || {}, { welcomeTourEnabled: patch.welcomeTourEnabled })
+          if (patch.welcomeTourEnabled === false) dismissWelcomeTourPre('config')
+        }
+        return d
+      })
       if (h.onSaved || h.onError) p.then(function (d) { if (h.onSaved) h.onSaved(d) }, function (e) { if (h.onError) h.onError(e) })
       else p.catch(function () {})
       return p
     }
+    /**
+     * 读配置的唯一解包出口(2026-09-14 实测止血):宿主 GET /config **恒返回外壳** `{ config, path }`
+     * (见 lib/index.js:8461),配置键在 `d.config` 上。
+     * 直读外壳的旧写法(`c.autoContinueEnabled`)恒得 undefined ⇒ `undefined === false` 恒假 ⇒ `!(…)` 恒真
+     * ⇒ 开关显示**恒为「开」**,与真实配置无关;更糟的是点击算的是 `!autoCfg.enabled` = `!true` = **false**
+     * ⇒ 该按钮**只能关、永远开不起来**(用户报障原话「我点开关,它并没有真正开关」)。
+     * 纪律:任何 `apiGet(API.config)` 的返回值都必须经这层解包,禁止直读外壳上的配置键。
+     * 回归守卫:tests/smoke/smoke-test-switch-decouple-pre.mjs D5。
+     */
+    function configOf(d) { return (d && d.config) || {} }
     /**
      * 语义引擎状态的统一刷新(2026-09-10 第 0 步止血):此前同一段 fetch + 状态写回在界面里逐字重复 10 处,
      * 响应形状或失败兜底要改时得挨个改。apply 收合并后的状态对象(已带 loaded:true),onError 可省。
@@ -1017,7 +1147,7 @@ window.__ModuleLoader__.load({
       '  max-width: calc(100vw - 32px); max-height: calc(100vh - 32px);',
       '  display: flex; flex-direction: column; overflow: hidden; z-index: 3000; pointer-events: auto;',
       '  border-radius: 16px; font: 13px/1.55 system-ui, "Segoe UI", sans-serif;',
-      '  background: color-mix(in srgb, var(--dsw-alias-bg-overlay, rgba(255,255,255,.86)) 58%, transparent);',
+      '  background: color-mix(in srgb, var(--dsw-alias-bg-layer-2, rgba(255,255,255,.86)) 58%, transparent);',
       '  -webkit-backdrop-filter: blur(28px) saturate(1.55); backdrop-filter: blur(28px) saturate(1.55);',
       '  border: 1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.35)) 65%, transparent);',
       '  box-shadow: 0 24px 64px rgba(0,0,0,.22), 0 4px 16px rgba(0,0,0,.10), inset 0 1px 0 rgba(255,255,255,.22);',
@@ -1065,7 +1195,7 @@ window.__ModuleLoader__.load({
       '[data-dam-settings-group] h3 { margin: 0; color: var(--dsw-alias-label-primary, #1f2328); font-size: calc(14px * var(--dam-scale)); }',
       '[data-dam-settings-group] p { margin: 4px 0 14px; color: var(--dsw-alias-label-secondary, #68717d); font-size: calc(11.5px * var(--dam-scale)); line-height: 1.5; }',
       '[data-dam-settings-row] { padding: 10px 0; }',
-      '[data-dam-savebar] { position: sticky; bottom: 0; z-index: 3; display: flex; align-items: center; gap: 10px; flex-wrap: wrap; padding: 10px 14px; margin: 6px -16px -16px; background: color-mix(in srgb, var(--dsw-alias-bg-overlay, rgba(255,255,255,.92)) 74%, transparent); backdrop-filter: blur(16px) saturate(1.4); -webkit-backdrop-filter: blur(16px) saturate(1.4); border-top: 1px solid color-mix(in srgb, var(--dsw-alias-border-l1, #c5cbd3) 38%, transparent); border-radius: 0 0 14px 14px; transition: background .25s ease; }',
+      '[data-dam-savebar] { position: sticky; bottom: 0; z-index: 3; display: flex; align-items: center; gap: 10px; flex-wrap: wrap; padding: 10px 14px; margin: 6px -16px -16px; background: color-mix(in srgb, var(--dsw-alias-bg-layer-2, rgba(255,255,255,.92)) 74%, transparent); backdrop-filter: blur(16px) saturate(1.4); -webkit-backdrop-filter: blur(16px) saturate(1.4); border-top: 1px solid color-mix(in srgb, var(--dsw-alias-border-l1, #c5cbd3) 38%, transparent); border-radius: 0 0 14px 14px; transition: background .25s ease; }',
       '[data-dam-savebar] button { opacity: .5; transition: opacity .2s ease, background .2s ease, color .2s ease; }',
       '[data-dam-savebar] button[data-dirty="true"] { opacity: 1; background: var(--dam-accent, #1d4ed8); color: #fff; font-weight: 650; box-shadow: 0 3px 12px color-mix(in srgb, var(--dam-accent, #1d4ed8) 35%, transparent); }',
       '[data-dam-settings-row] > [data-dam-row] { margin-bottom: 3px; }',
@@ -1118,13 +1248,13 @@ window.__ModuleLoader__.load({
       '[data-dam-spinner] { width: 18px; height: 18px; border: 2px solid color-mix(in srgb, var(--dam-accent, #4f7cff) 22%, transparent); border-top-color: var(--dam-accent, #4f7cff); border-radius: 50%; animation: dam-spin .8s linear infinite; }',
       '@keyframes dam-spin { to { transform: rotate(360deg); } }',
       '@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {',
-      '  [data-dam-panel] { background: var(--dsw-alias-bg-overlay, #ffffff); } }',
+      '  [data-dam-panel] { background: var(--dsw-alias-bg-layer-2, #ffffff); } }',
       // ── 首启引导向导(Win11 OOBE × macOS 欢迎 × Liquid Glass) ──
       '[data-dam-tour-backdrop] { position: fixed; inset: 0; z-index: 2147482900; display: flex; align-items: center; justify-content: center;',
       '  background: radial-gradient(ellipse at 50% 42%, rgba(20,30,60,.30), rgba(6,10,22,.44)); backdrop-filter: blur(5px); -webkit-backdrop-filter: blur(5px); animation: dam-tour-fade .28s ease both; }',
       '@keyframes dam-tour-fade { from { opacity: 0 } to { opacity: 1 } }',
-      '[data-dam-tour] { position: relative; width: min(620px, calc(100vw - 48px)); border-radius: 22px; overflow: hidden; padding-bottom: 4px;',
-      '  background: color-mix(in srgb, var(--dsw-alias-bg-overlay, rgba(30,34,46,.9)) 60%, transparent);',
+      '[data-dam-tour] { position: relative; width: min(620px, calc(100vw - 48px)); border-radius: 22px; max-height: calc(100vh - 32px); max-height: calc(100dvh - 32px); overflow-y: auto; overflow-x: hidden; touch-action: pan-y; box-sizing: border-box; padding-bottom: 4px;',
+      '  background: color-mix(in srgb, var(--dsw-alias-bg-layer-2, rgba(30,34,46,.9)) 60%, transparent);',
       '  backdrop-filter: blur(30px) saturate(1.6); -webkit-backdrop-filter: blur(30px) saturate(1.6);',
       '  border: 1px solid rgba(255,255,255,.5);',
       '  box-shadow: 0 32px 90px rgba(8,14,38,.5), 0 6px 24px rgba(8,14,38,.28), inset 0 1px 0 rgba(255,255,255,.5), inset 0 -1px 0 rgba(255,255,255,.14);',
@@ -1343,6 +1473,483 @@ window.__ModuleLoader__.load({
         h('div', { className: 'dam-content' }, props.children))
     }
 
+    // ─────────────────────────────────────────────────────────────────────────
+    // 白板看板(2026-09-16「兼并 dsh-graph」) —— 列式泳道可视化。
+    //
+    // 立场: 不挂 dsh-graph 插件(那会往 profile 里加第二个 bundle、第二份存储、第二套工具命名空间),
+    //   而是把它的**可视化形态**长在 auto-memory 自己身上: 数据源是自家的 handoff/index.json,
+    //   渲染在自家的面板里, 由 boardMode 一档切换(legacy 文字白板 / graph 列式看板)。
+    //   ⇒ 一份数据、一个插件、一个开关。
+    //
+    // 视觉: 与面板既有液态玻璃令牌一致(--dam-* / --dsw-alias-*), 不引第三方 CSS。
+    // 纯展示组件: 只读 data, 不发起任何写操作(看板改卡留待后续; 先保证「看得见」)。
+    // ─────────────────────────────────────────────────────────────────────────
+    var KANBAN_TONES = {
+      ok: { bg: 'color-mix(in srgb, #3fa96a 18%, transparent)', fg: '#2f7d4f' },
+      warn: { bg: 'color-mix(in srgb, #d4a94f 20%, transparent)', fg: '#8a6a1f' },
+      unknown: { bg: 'color-mix(in srgb, currentColor 10%, transparent)', fg: 'inherit' },
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // 看板 v2(2026-09-16 「大刀阔斧」批) —— 缩放 / 布局 / 交互全部补齐。
+    //
+    // v1 的三个致命体验问题(用户实测反馈):
+    //   ① 大小不可调: 只有面板全局 4 档 --dam-scale, 列宽 210px 写死不随字号变;
+    //   ② 看不见: 6 列 × 210px = 1260px 塞进 440px 面板, 只能看到 2 列且无滚动提示;
+    //   ③ 看不全: 预览 maxHeight 3.6em 硬截断, 无法展开。
+    // ⇒ v2: 看板自带字号 ×N 与列宽 ×N(独立于 --dam-scale, localStorage 记忆) + 纵向堆叠默认 +
+    //   泳道可折叠 + 卡片可展开看全文 + 泳道内搜索 + 「最近更新」聚合视图 + 空泳道收起。
+    // ─────────────────────────────────────────────────────────────────────────
+    var KANBAN_ZOOM_KEY = 'dam-kanban-zoom'
+    var KANBAN_COL_KEY = 'dam-kanban-cols'
+    var KANBAN_LAYOUT_KEY = 'dam-kanban-layout'
+
+    function readLsNum(key, def) {
+      try { var v = parseFloat(localStorage.getItem(key)); return isFinite(v) && v > 0 ? v : def } catch (e) { return def }
+    }
+    function writeLs(key, val) { try { localStorage.setItem(key, String(val)) } catch (e) {} }
+
+    /** 单张卡片: 标题 + 判据徽章 + 预览/全文 + 小节徽章 + 标签 + 来源。可点击展开。 */
+    function KanbanCard(props) {
+      var c = props.card || {}
+      var zoom = Number(props.zoom) || 1
+      var expanded = !!props.expanded
+      var onToggle = props.onToggle
+      var tone = KANBAN_TONES[(c.badge && c.badge.tone) || 'unknown'] || KANBAN_TONES.unknown
+      var body = expanded ? (c.full || c.preview || '') : (c.preview || '')
+      var canExpand = (c.full || '').length > (c.preview || '').length
+      return h('div', {
+        'data-dam-kcard': '',
+        title: c.source + (c.section ? ' §' + c.section : '') + (c.anchored ? ' · 有锚点' : ''),
+        style: {
+          border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.22)) 70%, transparent)',
+          borderRadius: '8px', padding: '7px 9px', marginBottom: '7px',
+          background: 'color-mix(in srgb, currentColor 3%, transparent)',
+        },
+      }, [
+        h('div', { style: { display: 'flex', alignItems: 'flex-start', gap: '6px' } }, [
+          h('div', { style: { flex: '1 1 auto', fontWeight: 600, fontSize: (12.5 * zoom) + 'px', lineHeight: '1.35', wordBreak: 'break-word' } }, c.title || c.short),
+          h('span', {
+            style: { flex: '0 0 auto', fontSize: (10 * zoom) + 'px', padding: '1px 5px', borderRadius: '4px', background: tone.bg, color: tone.fg, whiteSpace: 'nowrap' },
+          }, (c.badge && c.badge.text) || ''),
+        ]),
+        // 文档来源(小节卡的关键上下文: 同名的「目标」小节来自哪篇账本)
+        c.docTitle ? h('div', { 'data-dam-hint': '', style: { marginTop: '2px', fontSize: (10 * zoom) + 'px', opacity: .62, wordBreak: 'break-word' } }, c.docTitle) : null,
+        body ? h('div', {
+          'data-dam-hint': '',
+          style: {
+            marginTop: '4px', lineHeight: '1.45', fontSize: (11.5 * zoom) + 'px', whiteSpace: 'pre-wrap', wordBreak: 'break-word',
+            maxHeight: expanded ? 'none' : (7.2 * zoom) + 'em', overflow: 'hidden',
+          },
+        }, body) : null,
+        (canExpand || (c.full || '').length > 300) ? h('button', {
+          'data-dam-btn': '', onClick: function (e) { e.stopPropagation(); if (onToggle) onToggle(c.id) },
+          style: { marginTop: '3px', padding: '1px 6px', fontSize: (10 * zoom) + 'px', opacity: .7 },
+        }, expanded ? (locale === 'zh' ? '收起' : 'collapse') : (locale === 'zh' ? '展开全文' : 'expand')) : null,
+        (c.tags && c.tags.length) || (c.sectionTags && c.sectionTags.length) ? h('div', { style: { marginTop: '4px', display: 'flex', flexWrap: 'wrap', gap: '4px' } },
+          (c.tags || []).map(function (tg) {
+            return h('span', { key: 't' + tg, 'data-dam-hint': '', style: { fontSize: (10 * zoom) + 'px', padding: '0 4px', borderRadius: '3px', background: 'color-mix(in srgb, currentColor 8%, transparent)' } }, tg)
+          }).concat((c.sectionTags || []).map(function (tg) {
+            return h('span', { key: 's' + tg, 'data-dam-hint': '', style: { fontSize: (10 * zoom) + 'px', padding: '0 4px', borderRadius: '3px', background: 'color-mix(in srgb, #4f7cff 14%, transparent)', opacity: .85 } }, '§' + tg)
+          }))) : null,
+        h('div', { 'data-dam-hint': '', style: { marginTop: '4px', fontSize: (10 * zoom) + 'px' } },
+          '#' + (c.short || '') + (c.bullets ? ' · ' + c.bullets + (locale === 'zh' ? ' 条' : ' items') : '') + (c.versionCount ? ' · v' + c.versionCount : '')),
+      ])
+    }
+
+    /** 看板主体: 布局可切(纵向堆叠/横向泳道) + 缩放 + 折叠 + 搜索 + 聚合视图。 */
+    function KanbanBoard(props) {
+      var kb = props.data || {}
+      var lanes = kb.lanes || []
+      var stats = kb.stats || {}
+      var total = stats.total || 0
+      var zoomPair = useState(function () { return readLsNum(KANBAN_ZOOM_KEY, 1) })
+      var zoom = zoomPair[0], setZoom = zoomPair[1]
+      var colPair = useState(function () { return readLsNum(KANBAN_COL_KEY, 280) })
+      var colW = colPair[0], setColW = colPair[1]
+      var layoutPair = useState(function () {
+        try { return localStorage.getItem(KANBAN_LAYOUT_KEY) || 'stack' } catch (e) { return 'stack' }
+      })
+      var layout = layoutPair[0], setLayout = layoutPair[1]
+      var foldedPair = useState({})
+      var folded = foldedPair[0], setFolded = foldedPair[1]
+      var expPair = useState({})
+      var expanded = expPair[0], setExpanded = expPair[1]
+      var viewPair = useState('lanes')     // lanes | recent
+      var view = viewPair[0], setView = viewPair[1]
+      var qPair = useState('')
+      var q = qPair[0], setQ = qPair[1]
+
+      if (!lanes.length || !total) {
+        return h('div', { 'data-dam-hint': '' }, locale === 'zh'
+          ? '新版看板已启用,但索引里还没有条目——写一次白板或账本(memory_note)后这里会出现泳道卡片。'
+          : 'Graph board is on, but the index has no entries yet — write a plan or ledger (memory_note) and cards will appear.')
+      }
+      var zh = locale === 'zh'
+      var setZoomBoth = function (d) { var v = Math.min(2.2, Math.max(0.7, Math.round((zoom + d) * 100) / 100)); setZoom(v); writeLs(KANBAN_ZOOM_KEY, v) }
+      var setColBoth = function (d) { var v = Math.min(720, Math.max(180, colW + d)); setColW(v); writeLs(KANBAN_COL_KEY, v) }
+      var toggleLayout = function () { var v = layout === 'stack' ? 'lane' : 'stack'; setLayout(v); writeLs(KANBAN_LAYOUT_KEY, v) }
+      var toggleFold = function (k) { setFolded(Object.assign({}, folded, { [k]: !folded[k] })) }
+      var toggleCard = function (id) { setExpanded(Object.assign({}, expanded, { [id]: !expanded[id] })) }
+      var matchQ = function (c) {
+        if (!q.trim()) return true
+        var s = q.trim().toLowerCase()
+        return (c.title + ' ' + (c.docTitle || '') + ' ' + (c.preview || '') + ' ' + (c.tags || []).join(' ') + ' ' + (c.sectionTags || []).join(' ')).toLowerCase().indexOf(s) >= 0
+      }
+      var isStack = layout === 'stack'
+      var sum = zh
+        ? ('共 ' + total + ' 张小节卡' + (stats.omitted ? '(另有 ' + stats.omitted + ' 张已省略)' : '') + ' · 有锚点 ' + (stats.anchored || 0) + ' · 来源 ' + (stats.cardSource === 'section' ? '按小节切分' : '按文件'))
+        : (total + ' section cards' + (stats.omitted ? ' (' + stats.omitted + ' omitted)' : '') + ' · anchored ' + (stats.anchored || 0))
+
+      var btn = function (label, onClick, title) {
+        return h('button', { 'data-dam-btn': '', onClick: onClick, title: title || '', style: { padding: '1px 7px', fontSize: '11px' } }, label)
+      }
+
+      // 工具条: 缩放 / 布局 / 视图 / 搜索
+      var bar = h('div', { 'data-dam-kbar': '', style: { display: 'flex', flexWrap: 'wrap', gap: '5px', alignItems: 'center', marginBottom: '8px' } }, [
+        btn('A-', function () { setZoomBoth(-0.1) }, zh ? '缩小字号' : 'smaller'),
+        h('span', { 'data-dam-hint': '', style: { fontSize: '10.5px', minWidth: '36px', textAlign: 'center' } }, Math.round(zoom * 100) + '%'),
+        btn('A+', function () { setZoomBoth(0.1) }, zh ? '放大字号' : 'bigger'),
+        h('span', { style: { width: '6px' } }),
+        btn('W-', function () { setColBoth(-40) }, zh ? '收窄列宽' : 'narrower'),
+        h('span', { 'data-dam-hint': '', style: { fontSize: '10.5px', minWidth: '44px', textAlign: 'center' } }, isStack ? '' : colW + 'px'),
+        btn('W+', function () { setColBoth(40) }, zh ? '加宽列宽' : 'wider'),
+        h('span', { style: { width: '6px' } }),
+        btn(isStack ? (zh ? '纵向' : 'stack') : (zh ? '横向' : 'lane'), toggleLayout, zh ? '切换泳道排布' : 'toggle layout'),
+        btn(view === 'lanes' ? (zh ? '泳道' : 'lanes') : (zh ? '最近' : 'recent'), function () { setView(view === 'lanes' ? 'recent' : 'lanes') }, zh ? '切换视图' : 'toggle view'),
+        h('input', {
+          'data-dam-input': '', value: q, placeholder: zh ? '搜索…' : 'search…',
+          onChange: function (e) { setQ(e.target.value) },
+          style: { flex: '1 1 90px', minWidth: '80px', fontSize: '11px', padding: '2px 6px' },
+        }),
+      ])
+
+      var renderCard = function (c, i) {
+        return h(KanbanCard, { key: c.id + '#' + i, card: c, zoom: zoom, expanded: !!expanded[c.id], onToggle: toggleCard })
+      }
+
+      // 最近视图(P9): 跨泳道按 mtime 倒序
+      if (view === 'recent') {
+        var rec = (kb.recent || []).filter(matchQ)
+        return h('div', null, [
+          h('div', { 'data-dam-hint': '', style: { marginBottom: '6px' } }, sum),
+          bar,
+          rec.length
+            ? h('div', { style: { columnWidth: isStack ? 'auto' : colW + 'px' } }, rec.map(function (c, i) {
+              return h('div', { key: c.id + '#' + i }, [
+                h('div', { 'data-dam-hint': '', style: { fontSize: '10px', marginTop: '4px' } }, (c.laneLabel || '') + ' · ' + (c.source || '')),
+                renderCard(c, i),
+              ])
+            }))
+            : h('div', { 'data-dam-hint': '' }, zh ? '无命中' : 'no match'),
+        ])
+      }
+
+      // 泳道视图: 纵向堆叠(默认, 适配 440px 面板) 或 横向泳道
+      var wrapStyle = isStack
+        ? { display: 'block' }
+        : { display: 'flex', gap: '10px', overflowX: 'auto', alignItems: 'flex-start', paddingBottom: '6px' }
+      var laneStyle = isStack
+        ? { border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.22)) 55%, transparent)', borderRadius: '10px', padding: '8px', background: 'color-mix(in srgb, currentColor 2.5%, transparent)', marginBottom: '9px' }
+        : { flex: '0 0 auto', width: colW + 'px', minWidth: '160px', border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.22)) 55%, transparent)', borderRadius: '10px', padding: '8px', background: 'color-mix(in srgb, currentColor 2.5%, transparent)' }
+
+      return h('div', null, [
+        h('div', { 'data-dam-hint': '', style: { marginBottom: '6px', wordBreak: 'break-word' } }, sum),
+        bar,
+        h('div', { 'data-dam-kanban': '', 'data-dam-layout': layout, style: wrapStyle },
+          lanes.map(function (lane) {
+            var cards = (lane.cards || []).filter(matchQ)
+            var isFolded = !!folded[lane.key]
+            var empty = !lane.count
+            // P14: 空泳道默认收起(不占位), 但仍给出可点开的标题
+            return h('div', { key: lane.key, 'data-dam-lane': lane.key, style: Object.assign({}, laneStyle, empty ? { opacity: .55 } : {}) }, [
+              h('div', {
+                style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: isFolded ? '0' : '7px', cursor: 'pointer', gap: '6px' },
+                onClick: function () { toggleFold(lane.key) },
+              }, [
+                h('div', { style: { fontWeight: 700, fontSize: (12 * zoom) + 'px' } },
+                  (isFolded ? '▸ ' : '▾ ') + lane.label),
+                h('span', { 'data-dam-hint': '', style: { fontSize: (10.5 * zoom) + 'px', whiteSpace: 'nowrap' } },
+                  String(lane.count || 0) + (q.trim() && cards.length !== lane.count ? ' (' + cards.length + ')' : '') + (lane.omitted ? ' +' + lane.omitted : '')),
+              ]),
+              isFolded ? null : (cards.length
+                ? h('div', isStack ? { style: { columnWidth: colW + 'px', columnGap: '10px' } } : null,
+                  cards.map(function (c, i) { return renderCard(c, i) }))
+                : h('div', { 'data-dam-hint': '', style: { padding: '4px 0', fontSize: '11px' } },
+                  empty ? (zh ? '(本泳道暂无内容)' : '(empty)') : (zh ? '无命中' : 'no match'))),
+            ])
+          })),
+      ])
+    }
+
+    // ══════════════════════════════════════════════════════════════════════════
+    // 整页白板看板(2026-09-16「双承载面」批) —— 注册在 conversation.view 槽位。
+    //
+    // 为什么需要它: 侧边面板固定 440px, 而矩阵式布局(首列行标签 + N 列)需要 ~1000px+。
+    //   把矩阵塞进 440px 就是「大小不可调 / 看着挤」的结构性根因 ⇒ 宽容器另开一个承载面。
+    //
+    // 与面板的关系(两者共存, 非替换):
+    //   · 侧边面板 = 常驻入口, 窄, 用**列表视图**(KanbanBoard, 泳道堆叠);
+    //   · 整页看板 = 会话页顶栏 Tab, 宽, 用**矩阵视图**(行=日期分组, 列=小节类型)。
+    //   同一份数据(/kanban-board 一个路由同时回 lanes 与 matrix), 按容器宽度选形态。
+    //
+    // 交互: 行折叠 + 卡片点开右侧抽屉(宽屏才放得下全文, 这才是有别于面板的价值)。
+    // ══════════════════════════════════════════════════════════════════════════
+
+    // 泳道配色(2026-09-16): 每条泳道一个色相, 让「一眼看出哪列是什么」。
+    // 取值优先走官方令牌(跟随宿主明暗主题), 令牌缺失时回落到可读色值。
+    var KX_LANE_COLOR = {
+      goal: 'var(--dsw-alias-brand-primary, #4c8dff)',           // 目标 · 蓝
+      state: 'var(--dsw-alias-state-success-primary, #3aa675)',   // 进行中 · 绿
+      deadend: 'var(--dsw-alias-state-error-primary, #d66666)',   // 失败与弯路 · 红
+      progress: 'var(--dsw-alias-state-warn-primary, #e0a53a)',   // 进度与下一步 · 橙
+      archive: 'var(--dsw-alias-label-tertiary, #8b93a7)',        // 版本归档 · 灰蓝
+      misc: 'var(--dsw-alias-label-dimmed, #6b7280)',             // 其它 · 暗灰
+    }
+    function kxLaneColor(key) { return KX_LANE_COLOR[key] || KX_LANE_COLOR.misc }
+
+    /** 判据徽章(与面板同口径, 抽出来避免两处漂移)。 */
+    function kxBadge(crit, zh) {
+      var m = {
+        passed: ['✓', zh ? '通过' : 'passed', 'rgba(58,166,117,.20)', '#3aa675'],
+        warned: ['!', zh ? '有警告' : 'warned', 'rgba(224,165,58,.20)', '#e0a53a'],
+        failed: ['✕', zh ? '未通过' : 'failed', 'rgba(214,102,102,.20)', '#d66666'],
+        unknown: ['·', zh ? '未校验' : 'unchecked', 'rgba(128,128,128,.18)', 'inherit'],
+      }
+      var v = m[crit] || m.unknown
+      return h('span', {
+        'data-dam-kx-badge': crit,
+        title: v[1],
+        style: { flexShrink: 0, fontSize: '10px', padding: '0 4px', borderRadius: '3px', background: v[2], color: v[3] },
+      }, v[0])
+    }
+
+    /** 矩阵里的紧凑卡(只给全貌, 全文进抽屉)。 */
+    function KanbanMatrixCard(props) {
+      var c = props.card
+      var zh = props.zh
+      // 左侧色条按**泳道**取色(不是按有无 tag): 这样同一列内颜色一致, 跨列一眼可辨。
+      var accent = kxLaneColor(props.laneKey)
+      return h('div', {
+        'data-dam-kx-card': c.id,
+        'data-dam-kx-lane': props.laneKey || '',
+        title: c.title + '  ·  ' + c.docTitle,
+        onClick: props.onOpen,
+        style: {
+          border: '1px solid var(--dsw-alias-border-l1, rgba(128,128,128,.28))',
+          borderLeft: '3px solid ' + accent,
+          borderRadius: '5px', padding: '6px 8px', marginBottom: '5px', cursor: 'pointer',
+          background: 'var(--dsw-alias-bg-layer-3, rgba(128,128,128,.07))',
+          transition: 'transform .12s ease, box-shadow .12s ease, border-color .12s ease',
+        },
+        onMouseEnter: function (e) {
+          e.currentTarget.style.transform = 'translateY(-1px)'
+          e.currentTarget.style.boxShadow = '0 2px 10px var(--dsw-alias-bg-mask-1, rgba(0,0,0,.18))'
+          e.currentTarget.style.borderColor = accent
+        },
+        onMouseLeave: function (e) {
+          e.currentTarget.style.transform = ''
+          e.currentTarget.style.boxShadow = ''
+          e.currentTarget.style.borderColor = 'var(--dsw-alias-border-l1, rgba(128,128,128,.28))'
+        },
+      }, [
+        h('div', { key: 't', style: { display: 'flex', alignItems: 'center', gap: '5px' } }, [
+          kxBadge(c.criteria, zh),
+          h('span', { key: 'n', style: {
+            flex: 1, minWidth: 0, fontSize: '12.5px', fontWeight: 600,
+            color: 'var(--dsw-alias-label-primary)',
+            overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap',
+          } }, c.title),
+          c.bullets ? h('span', { key: 'b', 'data-dam-hint': '', style: { fontSize: '10.5px', flexShrink: 0 } }, '·' + c.bullets) : null,
+          c.anchored ? h('span', { key: 'a', title: '已有锚点', style: { fontSize: '10.5px', flexShrink: 0, color: 'var(--dsw-alias-state-success-primary, #3aa675)' } }, '⚓') : null,
+        ]),
+        c.preview ? h('div', { key: 'p', 'data-dam-hint': '', style: {
+          fontSize: '11px', lineHeight: 1.45, marginTop: '4px',
+          color: 'var(--dsw-alias-label-secondary)',
+          overflow: 'hidden', display: '-webkit-box', WebkitLineClamp: 2, WebkitBoxOrient: 'vertical',
+        } }, c.preview) : null,
+      ])
+    }
+
+    /** 整页矩阵看板: 行=日期分组, 列=小节类型。 */
+    function KanbanView(props) {
+      var st = useState(null), data = st[0], setData = st[1]
+      var st2 = useState(null), drawer = st2[0], setDrawer = st2[1]
+      var st3 = useState({}), folded = st3[0], setFolded = st3[1]
+      var st4 = useState(''), q = st4[0], setQ = st4[1]
+      var st5 = useState(1), zoom = st5[0], setZoom = st5[1]
+      var st6 = useState(0), tick = st6[0], bump = st6[1]
+      var zh = (locale || 'zh').indexOf('zh') === 0
+      useEffect(function () {
+        var alive = true
+        apiGet(API.kanbanBoard, { sessionId: currentSessionIdClient() })
+          .then(function (k) { if (alive) setData(k && k.enabled ? k : null) })
+          .catch(function () { if (alive) setData(null) })
+        return function () { alive = false }
+      }, [tick])
+
+      var mx = data && data.matrix
+      var cols = (mx && mx.columns) || []
+      var rows = (mx && mx.rows) || []
+      var kw = q.trim().toLowerCase()
+      var hit = function (c) { return !kw || String(c.title + ' ' + c.preview + ' ' + c.docTitle).toLowerCase().indexOf(kw) >= 0 }
+
+      var total = (mx && mx.stats && mx.stats.totalCards) || 0
+      var missing = (mx && mx.stats && mx.stats.missingDeadend) || []
+
+      return h('div', { 'data-dam-kanban-view': '', style: {
+        // position:relative 是**必需**的: 抽屉用 absolute 定位, 它的参照系就是这里 ⇒ 抽屉被裁剪在
+        // 看板承载面内, 不会像 fixed 那样越界盖住底部输入框。overflow:hidden 同时兜底裁剪。
+        position: 'relative', height: '100%', overflow: 'hidden', boxSizing: 'border-box',
+        color: 'var(--dsw-alias-label-primary)', fontSize: '12px',
+      } }, [
+      // 内滚动层(与抽屉分离: 抽屉不该跟着内容一起滚)
+      h('div', { 'data-dam-kx-scroll': '', style: { height: '100%', overflow: 'auto', padding: '12px 16px', boxSizing: 'border-box' } }, [
+        // ── 概览条 ──
+        h('div', { key: 'hdr', style: { display: 'flex', alignItems: 'baseline', gap: '10px', flexWrap: 'wrap', marginBottom: '8px' } }, [
+          h('strong', { key: 't', style: { fontSize: '14px' } }, zh ? '白板看板 · 时间矩阵' : 'Whiteboard · time matrix'),
+          h('span', { key: 's', 'data-dam-hint': '' },
+            zh
+              ? (String(total) + ' 张小节卡 / ' + String(rows.length) + ' 天 / ' + (mx && mx.stats ? mx.stats.dateFrom + ' → ' + mx.stats.dateTo : ''))
+              : (String(total) + ' cards / ' + String(rows.length) + ' days')),
+          missing.length
+            ? h('span', { key: 'm', 'data-dam-kx-warn': '', title: missing.join(', '), style: { color: '#e0a53a' } },
+              zh ? ('⚠ ' + missing.length + ' 天缺「失败与弯路」') : ('⚠ ' + missing.length + ' days missing dead-ends'))
+            : null,
+        ]),
+        // ── 工具条 ──
+        h('div', { key: 'bar', style: { display: 'flex', gap: '6px', alignItems: 'center', marginBottom: '8px', flexWrap: 'wrap' } }, [
+          h('input', { key: 'q', 'data-dam-input': '', placeholder: zh ? '搜索标题/正文/来源…' : 'search…', value: q, onChange: function (e) { setQ(e.target.value) }, style: { minWidth: '200px' } }),
+          h('button', { key: 'zo', 'data-dam-btn': '', onClick: function () { setZoom(Math.max(0.8, zoom - 0.1)) } }, 'A-'),
+          h('span', { key: 'zv', 'data-dam-hint': '', style: { minWidth: '38px', textAlign: 'center' } }, Math.round(zoom * 100) + '%'),
+          h('button', { key: 'zi', 'data-dam-btn': '', onClick: function () { setZoom(Math.min(1.6, zoom + 0.1)) } }, 'A+'),
+          h('button', { key: 'rf', 'data-dam-btn': '', onClick: function () { setData(null); bump(function (n) { return n + 1 }) } }, zh ? '刷新' : 'reload'),
+        ]),
+        // ── 空态 / 错误态(不静默) ──
+        !data ? h('div', { key: 'ph', 'data-dam-kx-empty': 'nodata', 'data-dam-hint': '' },
+          zh ? '看板未启用或加载失败(需 boardMode=graph 且 handoff 已开启)。' : 'Board unavailable.') : null,
+        data && !mx ? h('div', { key: 'nm', 'data-dam-kx-empty': 'nomatrix', 'data-dam-hint': '' },
+          zh ? '本次载荷缺矩阵视图。' : 'No matrix in payload.') : null,
+        data && mx && !rows.length ? h('div', { key: 'nr', 'data-dam-kx-empty': 'norows', 'data-dam-hint': '' },
+          zh ? '白板里还没有账本文档。' : 'No ledger docs yet.') : null,
+        // ── 矩阵本体 ──
+        data && mx && rows.length ? h('div', {
+          key: 'grid',
+          style: {
+            display: 'grid',
+            // 首列 170px 行标签(日期要放得下) + N 列自适应
+            gridTemplateColumns: '170px repeat(' + cols.length + ', minmax(190px, 1fr))',
+            gap: '6px',
+            fontSize: (12 * zoom) + 'px',
+          },
+        }, [].concat(
+          // 表头: 与内容区用底色 + 下边框拉开层次, sticky 吸顶
+          [h('div', { key: 'hc0', 'data-dam-kx-head': 'row', style: {
+            fontWeight: 700, padding: '8px 6px', position: 'sticky', top: 0, zIndex: 3,
+            fontSize: '11.5px', letterSpacing: '.03em', textTransform: 'uppercase',
+            color: 'var(--dsw-alias-label-tertiary)',
+            background: 'var(--dsw-alias-bg-layer-1)',
+            borderBottom: '2px solid var(--dsw-alias-border-l2, rgba(128,128,128,.45))',
+          } }, zh ? '日期' : 'Date')],
+          cols.map(function (c) {
+            return h('div', { key: 'hc-' + c.key, 'data-dam-kx-head': c.key, style: {
+              fontWeight: 700, padding: '8px 6px', display: 'flex', gap: '6px', alignItems: 'center',
+              position: 'sticky', top: 0, zIndex: 3,
+              color: 'var(--dsw-alias-label-primary)',
+              background: 'var(--dsw-alias-bg-layer-1)',
+              borderBottom: '2px solid ' + kxLaneColor(c.key),
+            } }, [
+              // 顶部色点 = 该列身份, 与卡片左条同色 ⇒ 列↔卡片的归属一眼可辨
+              h('span', { key: 'dot', 'data-dam-kx-dot': c.key, style: {
+                width: '8px', height: '8px', borderRadius: '50%', flexShrink: 0,
+                background: kxLaneColor(c.key), boxShadow: '0 0 0 2px ' + kxLaneColor(c.key) + '33',
+              } }),
+              h('span', { key: 'l', style: { flex: 1, minWidth: 0 } }, c.label),
+              h('span', { key: 'n', 'data-dam-hint': '', style: { fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } }, String(c.count || 0)),
+            ])
+          }),
+          // 数据行
+          rows.reduce(function (acc, r) {
+            var isFolded = !!folded[r.key]
+            acc.push(h('div', {
+              key: 'rl-' + r.key,
+              'data-dam-kx-row': r.key,
+              onClick: function () { setFolded(function (f) { var n = Object.assign({}, f); n[r.key] = !n[r.key]; return n }) },
+              style: {
+                padding: '8px 6px', cursor: 'pointer', userSelect: 'none',
+                fontWeight: 700, fontSize: '12.5px',
+                color: 'var(--dsw-alias-label-primary)',
+                background: 'var(--dsw-alias-bg-layer-2)',
+                borderRadius: '5px',
+                borderTop: '1px solid var(--dsw-alias-border-l1, rgba(128,128,128,.28))',
+              },
+              title: zh ? '点击折叠/展开该日' : 'toggle',
+            }, (isFolded ? '▸ ' : '▾ ') + r.label + '  (' + String(r.docs) + ')'))
+            cols.forEach(function (c) {
+              var cells = ((r.cells || {})[c.key] || []).filter(hit)
+              acc.push(h('div', {
+                key: 'rc-' + r.key + '-' + c.key,
+                'data-dam-kx-cell': c.key,
+                style: {
+                  padding: '3px 2px', minWidth: 0,
+                  borderTop: '1px solid var(--dsw-alias-border-l1, rgba(128,128,128,.18))',
+                  // 极淡的泳道底色(color-mix 把主色压到 ~5%): 让整列连成一片而不抢内容
+                  background: 'color-mix(in srgb, ' + kxLaneColor(c.key) + ' 5%, transparent)',
+                },
+              }, isFolded ? null : (cells.length
+                ? cells.map(function (c2) { return h(KanbanMatrixCard, { key: c2.id, card: c2, zh: zh, laneKey: c.key, onOpen: function () { setDrawer(c2) } }) })
+                : h('div', { 'data-dam-hint': '', style: { fontSize: '10px', padding: '2px 4px', opacity: .5 } }, kw ? '—' : ''))))
+            })
+            return acc
+          }, [])
+        )) : null,
+        ]),   // ← 闭合内滚动层(data-dam-kx-scroll)
+        // ── 右侧浮窗(portal 到 body) ──
+        // ★ 2026-09-16 二次修正: 上一版改成容器内 absolute 后, **页面往下滚它就被推出视口**
+        //   (用户实测「在页面下部分没办法看到点开的页签」)。absolute 的参照系是容器, 容器会滚。
+        //   正解 = createPortal 挂到 document.body + position:fixed ⇒ 参照系是视口, 永远可见,
+        //   且因为脱离容器, 不会被容器的 overflow 裁剪。底部留 96px 安全边距避开输入区。
+        drawer ? kxPortal(h('div', {
+          key: 'dr',
+          'data-dam-kx-drawer': drawer.id,
+          style: {
+            position: 'fixed', top: '52px', right: '16px', bottom: '96px',
+            width: 'min(560px, 42vw)', zIndex: 2147483000,
+            display: 'flex', flexDirection: 'column',
+            background: 'var(--dsw-alias-bg-layer-2, rgba(24,24,28,.97))', backdropFilter: 'blur(16px)',
+            border: '1px solid var(--dsw-alias-border-l1, rgba(128,128,128,.35))',
+            borderRadius: '10px',
+            boxShadow: '0 12px 40px var(--dsw-alias-bg-mask-1, rgba(0,0,0,.35))',
+            color: 'var(--dsw-alias-label-primary)', fontSize: '12.5px', lineHeight: 1.6,
+            overflow: 'hidden',
+          },
+        }, [
+          h('div', { key: 'h', style: { display: 'flex', alignItems: 'center', gap: '8px', marginBottom: '8px' } }, [
+            kxBadge(drawer.criteria, zh),
+            h('strong', { key: 't', style: { flex: 1, fontSize: '14px' } }, drawer.title),
+            h('button', { key: 'x', 'data-dam-btn': '', onClick: function () { setDrawer(null) } }, '✕'),
+          ]),
+          h('div', { key: 'meta', 'data-dam-hint': '', style: { marginBottom: '8px', display: 'flex', gap: '8px', flexWrap: 'wrap' } }, [
+            h('span', { key: 'd' }, drawer.docTitle),
+            h('span', { key: 's' }, drawer.source),
+            h('span', { key: 'i' }, '#' + drawer.short),
+            drawer.anchored ? h('span', { key: 'a', title: drawer.anchorId }, '⚓ ' + String(drawer.anchorId).slice(0, 14)) : null,
+          ]),
+          (drawer.sectionTags && drawer.sectionTags.length)
+            ? h('div', { key: 'sg', style: { display: 'flex', gap: '4px', flexWrap: 'wrap', marginBottom: '8px' } },
+              drawer.sectionTags.map(function (tg, i) { return h('span', { key: i, 'data-dam-chip': '', style: { fontSize: '10px', padding: '1px 5px', borderRadius: '3px', background: 'rgba(76,141,255,.18)' } }, tg) }))
+            : null,
+          h('pre', { key: 'body', 'data-dam-kx-full': drawer.id, style: { whiteSpace: 'pre-wrap', wordBreak: 'break-word', fontFamily: 'inherit', margin: 0, fontSize: '12px' } }, drawer.full || drawer.preview || ''),
+        ].map(function (node, i) {
+          // 头部固定、正文滚动: 把内容各自包一层; 正文那层给 flex:1 + overflow:auto
+          if (i === 0) return h('div', { key: 'headwrap', style: { padding: '12px 14px 8px', flexShrink: 0 } }, node)
+          if (i === 1) return h('div', { key: 'metawrap', style: { padding: '0 14px', flexShrink: 0 } }, node)
+          if (i === 2) return node ? h('div', { key: 'tagwrap', style: { padding: '0 14px', flexShrink: 0 } }, node) : null
+          return h('div', { key: 'bodywrap', style: { padding: '8px 14px 14px', flex: 1, overflow: 'auto', minHeight: 0 } }, node)
+        }))) : null,
+      ])
+    }
+
     function Loading(props) {
       var label = props && props.label ? props.label : t('loading')
       return h('div', { 'data-dam-loading': '' }, h('span', { 'data-dam-spinner': '', 'aria-hidden': 'true' }), h('span', null, label))
@@ -1736,7 +2343,7 @@ window.__ModuleLoader__.load({
       }
       // 美术规格对齐 artifacts/m7-live-pre/ui-assets/semantic-tier-ui.html 组件③
       var card = { border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(255,255,255,.16)) 55%, transparent)', borderRadius: '12px', padding: '10px 12px', marginBottom: '9px', background: 'color-mix(in srgb, var(--dsw-alias-bg-layer-1, rgba(128,128,128,.08)) 45%, transparent)', boxShadow: '0 4px 14px rgba(0,0,0,.12), inset 0 1px 0 rgba(255,255,255,.14)' }
-      var badge = function (txt, bg, fg) { return h('span', { style: { fontSize: 'calc(10.5px * var(--dam-scale))', fontWeight: 700, padding: '2px 8px', borderRadius: '6px', background: bg, color: fg || 'var(--dsw-alias-text-primary, inherit)', letterSpacing: '.02em' } }, txt) }
+      var badge = function (txt, bg, fg) { return h('span', { style: { fontSize: 'calc(10.5px * var(--dam-scale))', fontWeight: 700, padding: '2px 8px', borderRadius: '6px', background: bg, color: fg || 'var(--dsw-alias-label-primary, inherit)', letterSpacing: '.02em' } }, txt) }
       var decBg = { emit: ['rgba(47,164,106,.24)', '#7fdcb0'], prefetch: ['rgba(196,138,42,.2)', '#e8c584'], suppress: ['rgba(128,128,128,.16)', 'rgba(255,255,255,.65)'] }
       var laneBg = { explicit: ['rgba(111,155,255,.24)', '#b9ceff'], proactive: ['rgba(160,120,255,.22)', '#d4c2ff'] }
       var reasonChip = function (txt) { return h('span', { style: { fontFamily: 'ui-monospace, Consolas, monospace', fontSize: 'calc(10px * var(--dam-scale))', padding: '2px 7px', borderRadius: '5px', background: 'rgba(255,214,150,.1)', color: '#ffd9a1' } }, txt) }
@@ -1774,7 +2381,7 @@ window.__ModuleLoader__.load({
         index[k].push(row)
       })
       var card = { border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(255,255,255,.16)) 55%, transparent)', borderRadius: '12px', padding: '10px 12px', marginBottom: '9px', background: 'color-mix(in srgb, var(--dsw-alias-bg-layer-1, rgba(128,128,128,.08)) 45%, transparent)', boxShadow: '0 4px 14px rgba(0,0,0,.12), inset 0 1px 0 rgba(255,255,255,.14)' }
-      var badge = function (txt, bg, fg) { return h('span', { style: { fontSize: 'calc(10.5px * var(--dam-scale))', fontWeight: 700, padding: '2px 8px', borderRadius: '6px', background: bg, color: fg || 'var(--dsw-alias-text-primary, inherit)', letterSpacing: '.02em' } }, txt) }
+      var badge = function (txt, bg, fg) { return h('span', { style: { fontSize: 'calc(10.5px * var(--dam-scale))', fontWeight: 700, padding: '2px 8px', borderRadius: '6px', background: bg, color: fg || 'var(--dsw-alias-label-primary, inherit)', letterSpacing: '.02em' } }, txt) }
       var decBg = { emit: ['rgba(47,164,106,.24)', '#7fdcb0'], prefetch: ['rgba(196,138,42,.2)', '#e8c584'], suppress: ['rgba(128,128,128,.16)', 'rgba(255,255,255,.65)'] }
       var laneBg = { explicit: ['rgba(111,155,255,.24)', '#b9ceff'], proactive: ['rgba(160,120,255,.22)', '#d4c2ff'] }
       var reasonChip = function (txt) { return h('span', { style: { fontFamily: 'ui-monospace, Consolas, monospace', fontSize: 'calc(10px * var(--dam-scale))', padding: '2px 7px', borderRadius: '5px', background: 'rgba(255,214,150,.1)', color: '#ffd9a1' } }, txt) }
@@ -1909,7 +2516,9 @@ window.__ModuleLoader__.load({
           body: JSON.stringify({ action: action, procedureId: procedureId, v: v }) })
           .then(function (r) { return r.json() })
           .then(function (j) {
-            setActMsg(action + ': ' + (j && (j.decision || j.reason || (j.ok === false ? (j.reason || 'rejected') : 'ok')) || 'done'))
+            // issue #30:附带 reasonCodes —— 否则"点了晋升但没晋级"只显示 keep，看不出原因
+            // (如 observation-only / diversity-below-3 / no-success-criteria)。
+            setActMsg(action + ': ' + (j && (j.decision || j.reason || (j.ok === false ? (j.reason || 'rejected') : 'ok')) || 'done') + (j && Array.isArray(j.reasonCodes) && j.reasonCodes.length ? ' (' + j.reasonCodes.join(', ') + ')' : ''))
             setRefresh(function (x) { return x + 1 })
           })
           .catch(function (e) { setActMsg(action + ' failed: ' + String(e && e.message)) })
@@ -1942,16 +2551,18 @@ window.__ModuleLoader__.load({
           pipeline.map(function (p) {
             var ev = p.evidence || {}
             return h('div', { 'data-dam-content': '', key: p.procedureId, style: { padding: '5px 0', borderBottom: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(255,255,255,.16)) 40%, transparent)' } },
-              h('div', null, h('b', null, p.title), h('span', { 'data-dam-hint': '', style: { marginLeft: '6px' } }, '[' + p.stage + ']' + (p.pinned ? ' 📌' : '') + (p.riskLevel === 'high' ? ' ⚠' : '')),
+              h('div', null, h('b', null, p.title), h('span', { 'data-dam-hint': '', style: { marginLeft: '6px' } }, '[' + p.stage + ']' + (p.observationOnly ? (locale === 'zh' ? ' · 观察（不参与自动晋升）' : ' · observation-only') : '') + (p.pinned ? ' 📌' : '') + (p.riskLevel === 'high' ? ' ⚠' : '')),
                 h('span', { 'data-dam-hint': '', style: { marginLeft: '6px' } }, (locale === 'zh' ? '成功 ' : 'succ ') + (ev.success || 0) + ' · ' + (locale === 'zh' ? '会话 ' : 'sess ') + (ev.sessions || 0))),
               h('div', { style: { display: 'flex', gap: '6px', marginTop: '5px' } },
-                h('button', { 'data-dam-btn': '', style: { fontSize: 'calc(10.5px * var(--dam-scale))', padding: '3px 10px' }, onClick: function () { hubAct('promote', p.procedureId) } }, locale === 'zh' ? '晋升' : 'promote'),
-                h('button', { 'data-dam-btn': '', style: { fontSize: 'calc(10.5px * var(--dam-scale))', padding: '3px 10px' }, onClick: function () { hubAct('activate', p.procedureId) } }, locale === 'zh' ? '直接激活' : 'activate'),
+                // issue #30:纯 episode 观察行**结构上**不可能晋升(无 successCriteria),
+                // 继续显示"晋升"按钮只会让人反复点击却看不到变化 ⇒ 直接隐藏并打观察标。
+                !p.observationOnly && h('button', { 'data-dam-btn': '', style: { fontSize: 'calc(10.5px * var(--dam-scale))', padding: '3px 10px' }, onClick: function () { hubAct('promote', p.procedureId) } }, locale === 'zh' ? '晋升' : 'promote'),
+                !p.observationOnly && p.stage === 'validated' && h('button', { 'data-dam-btn': '', style: { fontSize: 'calc(10.5px * var(--dam-scale))', padding: '3px 10px' }, onClick: function () { hubAct('activate', p.procedureId) } }, locale === 'zh' ? '直接激活' : 'activate'),
                 h('button', { 'data-dam-btn': '', style: { fontSize: 'calc(10.5px * var(--dam-scale))', padding: '3px 10px', opacity: .75 }, onClick: function () { hubAct('deprecate', p.procedureId) } }, locale === 'zh' ? '弃用' : 'deprecate'),
                 h('button', { 'data-dam-btn': '', style: { fontSize: 'calc(10.5px * var(--dam-scale))', padding: '3px 10px', opacity: .75 }, onClick: function () { hubAct('pin', p.procedureId, !p.pinned) } }, p.pinned ? (locale === 'zh' ? '取消置顶' : 'unpin') : (locale === 'zh' ? '置顶' : 'pin'))))
           })))
       }
-      if (actMsg) rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '6px', color: 'var(--dsw-alias-warn, #e8c584)' } }, actMsg))
+      if (actMsg) rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '6px', color: 'var(--dsw-alias-state-warn-primary, #e8c584)' } }, actMsg))
       // 事实层
       rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '12px' } }, t('hubFacts')))
       var factList = (facts && facts.recent) || []
@@ -1960,7 +2571,7 @@ window.__ModuleLoader__.load({
           return h('div', { 'data-dam-content': '', key: f.factId, style: { padding: '3px 0' } }, f.subject + ' · ' + f.predicate + (f.object ? ' · ' + f.object : ''))
         }) : h('div', { 'data-dam-content': '' }, t('hubFactsEmpty'))))
       if (facts && facts.pendingConflicts && facts.pendingConflicts.length) {
-        rows.push(h('div', { 'data-dam-hint': '', style: { color: 'var(--dsw-alias-warn, #e8c584)' } }, t('hubConflicts') + ': ' + facts.pendingConflicts.length))
+        rows.push(h('div', { 'data-dam-hint': '', style: { color: 'var(--dsw-alias-state-warn-primary, #e8c584)' } }, t('hubConflicts') + ': ' + facts.pendingConflicts.length))
       }
       // 经历层
       rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '12px' } }, t('hubEpisodic')))
@@ -2027,7 +2638,7 @@ window.__ModuleLoader__.load({
       var counts = data.counts || { total: 0, ok: 0, stale: 0, unrepairable: 0 }
       var rows = []
       if (data.indexEnabled === false) {
-        rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '6px', color: 'var(--dsw-alias-warn, #e8c584)' } },
+        rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '6px', color: 'var(--dsw-alias-state-warn-primary, #e8c584)' } },
           locale === 'zh' ? '⚠ 记忆锚定索引未启用:语料健康不做 sidecar 比对(无 stale 可修)。如需「修复 stale / 删除记忆」,请到 设置 → 自动记忆引擎 开启「记忆锚定索引」。此提示不影响记忆读写与检索。' : '⚠ Memory anchor index disabled: corpus health performs no sidecar comparison (nothing stale). To use repair/delete, enable "Memory anchor index" under Settings → Semantic engine. Read/write/recall are unaffected.'))
       }
       rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '8px' } }, t('storageScanHint')))
@@ -2056,7 +2667,7 @@ window.__ModuleLoader__.load({
                 if (!(delFile && delId)) return
                 act('delete', { filePath: delFile, memoryId: delId }, function () { setDelId('') })
               } }, locale === 'zh' ? '删除' : 'delete')))))
-      if (msg) rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '6px', color: 'var(--dsw-alias-warn, #e8c584)' } }, msg))
+      if (msg) rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '6px', color: 'var(--dsw-alias-state-warn-primary, #e8c584)' } }, msg))
       var audit = (data.audit || []).slice(-4)
       if (audit.length) {
         rows.push(h('div', { 'data-dam-hint': '', style: { marginTop: '12px', opacity: .7 } },
@@ -2156,7 +2767,7 @@ window.__ModuleLoader__.load({
       var t0 = Date.now()
       var timeoutMs = 90000
       try {
-        var cfg = await apiGet(API.config)
+        var cfg = configOf(await apiGet(API.config))
         var sec = cfg && Number(cfg.autoContinueRefreshTimeoutSeconds)
         if (sec >= 15 && sec <= 600) timeoutMs = sec * 1000
       } catch (eC) {}
@@ -2227,7 +2838,7 @@ window.__ModuleLoader__.load({
       autoState.suppressUntil = Date.now() + 5 * 60 * 1000
       try {
         var cfg = null
-        try { cfg = await apiGet(API.config) } catch (eCfg) {}
+        try { cfg = configOf(await apiGet(API.config)) } catch (eCfg) {}
         var ritual = !(cfg && cfg.autoContinueRefreshRitual === false) && !(opts && opts.skipRefresh)
         if (ritual) { try { await refreshOldSession(onMsg) } catch (eRf) {} }
         onMsg(locale === 'zh' ? '正在构造交接材料(含旧会话转写)…' : 'Preparing handoff material (incl. prev-session transcript)…')
@@ -2251,6 +2862,10 @@ window.__ModuleLoader__.load({
       var openPair = useState(null)
       var open = openPair[0]
       var setOpen = openPair[1]
+      // 白板看板数据(2026-09-16 兼并 dsh-graph): graph 档有值 → 渲染列式泳道; legacy 档恒 null。
+      var kbDataPair = useState(null)
+      var kbData = kbDataPair[0]
+      var setKbData = kbDataPair[1]
       var contentPair = useState('')
       var content = contentPair[0]
       var setContent = contentPair[1]
@@ -2262,16 +2877,46 @@ window.__ModuleLoader__.load({
       var contMsg = contMsgPair[0]
       var setContMsg = contMsgPair[1]
       // M-CM6-C 自动接续(①轮次边界触发 + ②确认卡由全局 AutoContinueHost 执行;这里只读/写开关与阈值)
+      // 2026-09-14 解耦:白板页也读写这两个开关,且与设置页共用**同一对配置键**
+      // (autoContinueEnabled / handoffEnabled)——两处不可能各说各话。
+      // 注:两个键出厂默认均为 false(功能仍在测试期),默认关、界面可开。
       var autoPair = useState(null)
       var autoCfg = autoPair[0]
       var setAutoCfg = autoPair[1]
+      var hbPair = useState(false)
+      var handoffOn = hbPair[0]
+      var setHandoffOn = hbPair[1]
+      // WB-GRAPH boardMode 本地镜像(2026-09-16): 接续面板按钮即时翻面用; 初值从配置取, 保存成功后本地翻面。
+      var boardModePair = useState('legacy')
+      var boardModeLocal = boardModePair[0]
+      var setBoardModeLocal = boardModePair[1]
+      // 白板开关改动后必须重取白板数据(host 的 handoffPanelData 按 handoffEnabled 决定 enabled),
+      // 否则「刚打开白板」页面上仍是旧的 enabled:false。
+      var reloadPair = useState(0)
+      var reloadKey = reloadPair[0]
+      var setReload = reloadPair[1]
       useEffect(function () {
-        apiGet(API.config).then(function (c) {
-          setAutoCfg({ enabled: !(c && c.autoContinueEnabled === false), threshold: (c && Number(c.autoContinueThreshold)) || 0.75 })
+        apiGet(API.config).then(function (d) {
+          // 解包外壳(见 configOf):旧实现直读 `c.autoContinueEnabled`,d 其实是 `{ config, path }`
+          // ⇒ 两个开关**显示恒为「开」**,且点击只会写 false(唯一可写方向是「关」)。
+          var c = configOf(d)
+          setAutoCfg({ enabled: !(c.autoContinueEnabled === false), threshold: Number(c.autoContinueThreshold) || 0.75 })
+          setHandoffOn(!(c.handoffEnabled === false))
+          setBoardModeLocal(c.boardMode === 'graph' ? 'graph' : 'legacy')
         }).catch(function () { setAutoCfg({ enabled: false, threshold: 0.7 }) })
       }, [])
+      // 2026-09-14 修复:patch 里是**配置键**(autoContinueEnabled / autoContinueThreshold),而本地状态用的是
+      // enabled / threshold。旧实现直接把 patch 并进本地状态 ⇒ 写的是 autoCfg.autoContinueEnabled,而按钮读的是
+      // autoCfg.enabled ⇒ **按钮永远不回弹**:点了看似没反应,再点还是按同一个旧值计算(用户观感「自动接续无法开关」)。
+      // 阈值输入同病:输入框读 autoCfg.threshold,旧实现写 autoCfg.autoContinueThreshold ⇒ 显示也不更新。
+      // 注意:写入配置本身一直是成功的(宿主端单键合并),坏的只是本地回显 —— 所以"看起来没开关"与"其实已写盘"并存。
       var autoSave = function (patch) {
-        setAutoCfg(function (p) { return Object.assign({}, p, patch) })
+        setAutoCfg(function (p) {
+          var next = Object.assign({}, p)
+          if (patch.autoContinueEnabled !== undefined) next.enabled = patch.autoContinueEnabled
+          if (patch.autoContinueThreshold !== undefined) next.threshold = patch.autoContinueThreshold
+          return next
+        })
         saveConfigPatch(patch)
       }
       async function oneClickContinue() {
@@ -2289,8 +2934,14 @@ window.__ModuleLoader__.load({
         var alive = true
         setData(null)
         apiGet(API.handoffState, { sessionId: sid }).then(function (d) { if (alive) setData(d) }).catch(function () {})
+        // 白板看板(2026-09-16 兼并 dsh-graph): 与白板数据同源同批拉取。
+        // legacy 档宿主返回 { enabled:false } ⇒ 保持 kbData=null, 看板块不渲染(逐字节不变)。
+        apiGet(API.kanbanBoard, { sessionId: sid }).then(function (k) {
+          if (!alive) return
+          setKbData(k && k.enabled ? k : null)
+        }).catch(function () { if (alive) setKbData(null) })
         return function () { alive = false }
-      }, [sid])
+      }, [sid, reloadKey])
       // 切换会话即刷新水位卡:订阅官方会话列表快照,current 变化时重取(2026-09-08)
       useEffect(function () {
         var unsub = null
@@ -2323,7 +2974,25 @@ window.__ModuleLoader__.load({
         return name
       }
       if (!data) return h(Loading)
-      if (!data.enabled) return h(Card, { title: t('planTitle') }, h('div', { 'data-dam-hint': '' }, t('planDisabled')))
+      // 开关卡(2026-09-14 解耦):**先渲染开关,再谈白板内容** —— 旧实现在 !data.enabled 处直接 return,
+      // 而白板开关默认关 ⇒ 白板页连开关都看不到(默认关 + 无处可开 = 死锁)。
+      // 两个按钮与设置页共用同一对配置键,写盘路径也是既有机制(saveConfigPatch / autoSave)。
+      var switchCard = h(Card, { title: t('handoffSwitchTitle') }, h('div', { 'data-dam-content': '' }, [
+        h('div', { 'data-dam-hint': '', style: { marginBottom: '6px' } }, t('handoffSwitchHint')),
+        h('div', { 'data-dam-row': '' }, [
+          h('button', { 'data-dam-btn': '', 'data-dam-key': 'handoffEnabled', onClick: function () { var v = !handoffOn; setHandoffOn(v); saveConfigPatch({ handoffEnabled: v }, { onSaved: function () { setReload(function (n) { return n + 1 }) } }) } }, handoffOn ? t('handoffOn') : t('handoffOff')),
+          // WB-GRAPH 白板模式快捷切换(接续面板, 2026-09-16): 与设置页同一配置键 boardMode, 点击翻面+提示需重启。
+          // 用 reloadKey 作重渲染源(切换成功后 force reload), 避免引入新的状态耦合。
+          h('button', { 'data-dam-btn': '', 'data-dam-key': 'boardMode', key: 'bm-' + reloadKey, style: { marginLeft: '8px' }, onClick: function () {
+            var next = boardModeLocal === 'graph' ? 'legacy' : 'graph'
+            setBoardModeLocal(next)
+            saveConfigPatch({ boardMode: next }, { onSaved: function () { setReload(function (n) { return n + 1 }); window.alert(locale === 'zh' ? (next === 'graph' ? '已切到新版看板（dsh-graph）。重启 dsh web 后生效。' : '已切回旧版白板。重启 dsh web 后生效。') : (next === 'graph' ? 'Switched to graph board. Restart dsh web to take effect.' : 'Switched back to legacy board. Restart dsh web to take effect.')) } })
+          } }, locale === 'zh' ? (boardModeLocal === 'graph' ? '看板版·点击回旧版' : '旧版白板·点击切看板') : (boardModeLocal === 'graph' ? 'Graph board · back to legacy' : 'Legacy board · switch to graph')),
+          autoCfg ? h('button', { 'data-dam-btn': '', 'data-dam-key': 'autoContinueEnabled', style: { marginLeft: '8px' }, onClick: function () { autoSave({ autoContinueEnabled: !autoCfg.enabled }) } }, autoCfg.enabled ? t('autoContOn') : t('autoContOff')) : null,
+          autoCfg ? h('label', { 'data-dam-hint': '', style: { marginLeft: '8px' } }, t('autoContThreshold') + ' ', h('input', { 'data-dam-input': '', type: 'number', min: 0.5, max: 0.95, step: 0.05, value: String(autoCfg.threshold), onChange: function (e) { var v = Number(e.target.value); if (v >= 0.5 && v <= 0.95) autoSave({ autoContinueThreshold: v }) } })) : null,
+        ]),
+      ]))
+      if (!data.enabled) return h('div', null, [switchCard, h(Card, { title: t('planTitle') }, h('div', { 'data-dam-hint': '' }, t('planDisabled')))])
       var wl = data.waterLevel || {}
       // 2026-09-13(工作区切换修复):宿主对当前会话解析不出工作区身份时(wsBound:false),如实提示
       // 而不是渲染另一个会话/启动目录下的白板内容(旧全局单值行为的残余观感)。
@@ -2333,6 +3002,48 @@ window.__ModuleLoader__.load({
       } else {
         rows.push(h(Card, { title: t('planTitle') }, h('div', { 'data-dam-content': '' }, data.plan || t('planEmpty'))))
       }
+      // ── 白板看板(2026-09-16 兼并 dsh-graph): graph 档在白板页顶部渲染列式泳道 ──
+      // 数据来自 /kanban-board(自家 sidecar 投影); legacy 档 kb 为 null ⇒ 整块不渲染,
+      // 页面与旧版逐字节相同。看板置顶: 它才是「一眼看全貌」的那一层, 文字白板退居其次。
+      if (kbData) {
+        rows.unshift(h(Card, { title: (locale === 'zh' ? '白板看板 · 全流程可视化' : 'Whiteboard kanban · full flow') }, h('div', { 'data-dam-content': '' }, h(KanbanBoard, { data: kbData }))))
+      }
+      // ── P2-5 前端(2026-09-16): 新版看板的结构化视图(tag 导航 + 段视图)──────────
+      // 后端 handoffPanelData 已在 graph 档返回 structured(by_tag 倒排 + 按 kind 分组的条目摘要)。
+      // legacy 档 structured 为 null ⇒ 本卡**完全不渲染**, 页面与旧版逐字节相同(开关解耦纪律)。
+      //
+      // v2(2026-09-16 晚): **看板可视化在场时隐藏这两张文字卡** —— 用户实测反馈「就是没有图」:
+      // 它们与真看板内容重复(tag 导航的 0 个标签、段视图的条目流水), 同屏出现会让人以为
+      // 这就是「新版看板」的全部。真看板(kbData)在场时, 文字卡退位; 其缺失时仍作兜底显示,
+      // 保证「结构化数据始终可达」(不删功能, 只是不再与图争位)。
+      if (data.structured && !kbData) {
+        var st = data.structured
+        var tagKids = []
+        tagKids.push(h('div', { 'data-dam-hint': '', style: { marginBottom: '6px' } },
+          (locale === 'zh' ? '结构化索引: ' : 'Structured index: ') + st.total + (locale === 'zh' ? ' 个条目 · ' : ' entries · ') + (st.tags || []).length + (locale === 'zh' ? ' 个标签' : ' tags') + (st.rebuiltAt ? ' · ' + String(st.rebuiltAt).slice(0, 19).replace('T', ' ') : '')))
+        if ((st.tags || []).length) {
+          tagKids.push(h('div', { 'data-dam-row': '', style: { flexWrap: 'wrap' } }, st.tags.map(function (tg) {
+            return h('button', { 'data-dam-btn': '', key: 'tg-' + tg.tag, title: tg.tag, style: { marginRight: '6px', marginBottom: '6px' } },
+              tg.tag + ' ×' + tg.count)
+          })))
+          tagKids.push(h('div', { 'data-dam-hint': '', style: { marginTop: '4px' } },
+            locale === 'zh' ? '标签来自账本/白板行内标记(tag:xxx / type:xxx / topic:xxx)。模型侧可用 memory_expand_pre(tag) 按标签展开条目、memory_trace_pre(id) 回溯来源与版本链。' : 'Tags come from inline markers (tag:xxx / type:xxx / topic:xxx). The model can use memory_expand_pre(tag) to expand by tag and memory_trace_pre(id) to trace origin and version chain.'))
+        } else {
+          tagKids.push(h('div', { 'data-dam-muted': '' }, locale === 'zh' ? '尚无标签——在账本/白板里写 tag:xxx 后重新写入即出现。' : 'No tags yet — write tag:xxx in a ledger/plan and re-save.'))
+        }
+        rows.push(h(Card, { title: locale === 'zh' ? '新版看板 · 标签导航' : 'Graph board · tag navigation' }, h('div', { 'data-dam-content': '' }, tagKids)))
+        var secKids = []
+        ;(st.sections || []).forEach(function (sc) {
+          if (!sc.count) return
+          secKids.push(h('div', { 'data-dam-hint': '', style: { marginTop: '6px', fontWeight: 600 } }, sc.kind + ' · ' + sc.count))
+          ;(sc.items || []).forEach(function (it) {
+            secKids.push(h('div', { style: { fontSize: 'calc(12px * var(--dam-scale))', marginLeft: '8px' } },
+              h('span', { 'data-dam-hint': '' }, String(it.id || '').slice(4, 12) + ' '),
+              h('span', { title: it.source || '' }, (it.section ? '§' + it.section + ' ' : '') + String(it.preview || '').slice(0, 90))))
+          })
+        })
+        if (secKids.length) rows.push(h(Card, { title: locale === 'zh' ? '新版看板 · 段视图' : 'Graph board · sections' }, h('div', { 'data-dam-content': '' }, secKids)))
+      }
       if (wl.window > 0) {
         // 2.2.4:百分比显示真实水位(旧版截断到 150% 会把「窗口算错」伪装成「刚好超一点」);进度条宽度仍按 100% 截断。
         var rawPct = Math.round((wl.ratio || 0) * 100)
@@ -2352,13 +3063,8 @@ window.__ModuleLoader__.load({
         ])))
       }
       if (autoCfg && wl.window > 0) {
-        rows.unshift(h(Card, { title: t('autoContTitle') }, h('div', { 'data-dam-content': '' }, [
-          h('div', { 'data-dam-hint': '', style: { marginBottom: '6px' } }, t('autoContHint')),
-          h('div', { 'data-dam-row': '' },
-            h('button', { 'data-dam-btn': '', onClick: function () { autoSave({ autoContinueEnabled: !autoCfg.enabled }) } }, autoCfg.enabled ? t('autoContOn') : t('autoContOff')),
-            h('label', { 'data-dam-hint': '', style: { marginLeft: '8px' } }, t('autoContThreshold') + ' ',
-              h('input', { 'data-dam-input': '', type: 'number', min: 0.5, max: 0.95, step: 0.05, value: String(autoCfg.threshold), style: { width: '64px' }, onChange: function (e) { var v = Number(e.target.value); if (v >= 0.5 && v <= 0.95) autoSave({ autoContinueThreshold: v }) } }))),
-        ])))
+        // 2026-09-14:开关与阈值统一收进顶部常显的开关卡(同一配置键只应有一个入口),此处只留说明。
+        rows.unshift(h(Card, { title: t('autoContTitle') }, h('div', { 'data-dam-content': '' }, h('div', { 'data-dam-hint': '' }, t('autoContHint')))))
       }
       if (open) {
         rows.unshift(h(Card, { title: t('planFileTitle') + ' · ' + open }, h('div', { 'data-dam-content': '' }, content || t('empty'))))
@@ -2379,7 +3085,9 @@ window.__ModuleLoader__.load({
           contMsg ? h('div', { 'data-dam-hint': '', style: { marginTop: '4px' } }, contMsg) : null,
         ])))
       }
-      return h('div', null, rows)
+      // 2026-09-14 修复:开关卡此前只在「未启用」分支被返回 ⇒ 白板一旦开启,白板页就再也看不到开关(开得了、关不掉)。
+      // 开关卡必须在**两种**状态下都渲染 —— 它是这个页面上唯一的开关入口。
+      return h('div', null, [switchCard].concat(rows))
     }
 
     function ReflectionsTab() {
@@ -2549,13 +3257,13 @@ window.__ModuleLoader__.load({
           h('g', null, children.map(function (n, i) {
             return h('g', { key: 'branch-' + i },
               h('line', { x1: n.center.x, y1: n.center.y + 38, x2: n.x, y2: n.y - 22, stroke: '#8b949e', strokeOpacity: .48, strokeWidth: 1.2 }),
-              h('rect', { x: n.x - (compact ? 82 : 92), y: n.y - 22, width: compact ? 164 : 184, height: 44, rx: 10, fill: 'color-mix(in srgb, var(--dsw-alias-bg-overlay, #fff) 92%, transparent)', stroke: 'color-mix(in srgb, var(--dam-accent, #1d4ed8) 42%, #8b949e)', strokeOpacity: .8 }),
+              h('rect', { x: n.x - (compact ? 82 : 92), y: n.y - 22, width: compact ? 164 : 184, height: 44, rx: 10, fill: 'color-mix(in srgb, var(--dsw-alias-bg-layer-2, #fff) 92%, transparent)', stroke: 'color-mix(in srgb, var(--dam-accent, #1d4ed8) 42%, #8b949e)', strokeOpacity: .8 }),
               h('text', { x: n.x, y: n.y - 5, textAnchor: 'middle', fontSize: compact ? 9.5 : 10.5, fontWeight: 650, fill: 'currentColor' }, String(n.item && n.item.label || n.item || '').slice(0, 22)),
               h('text', { x: n.x, y: n.y + 10, textAnchor: 'middle', fontSize: 8, fill: '#7d8793' }, String(n.item && n.item.detail || '').slice(0, 26)))
           })),
           h('g', null, centers.map(function (c) {
             return h('g', { key: c.ws.path, 'data-dam-graph-node': '', onPointerDown: function (ev) { ev.stopPropagation() }, onClick: function () { onSelect(c.ws) } },
-              h('rect', { x: c.x - 100, y: c.y - 38, width: 200, height: 76, rx: 16, fill: 'color-mix(in srgb, var(--dam-accent, #1d4ed8) 22%, var(--dsw-alias-bg-overlay, #fff))', stroke: 'var(--dam-accent, #1d4ed8)', strokeWidth: 2 }),
+              h('rect', { x: c.x - 100, y: c.y - 38, width: 200, height: 76, rx: 16, fill: 'color-mix(in srgb, var(--dam-accent, #1d4ed8) 22%, var(--dsw-alias-bg-layer-2, #fff))', stroke: 'var(--dam-accent, #1d4ed8)', strokeWidth: 2 }),
               h('text', { x: c.x, y: c.y - 5, textAnchor: 'middle', fontSize: compact ? 10.5 : 12, fontWeight: 650, fill: 'currentColor' }, h('tspan', { x: c.x, dy: 0 }, String(c.ws.name || '').slice(0, 12)), h('tspan', { x: c.x, dy: 13 }, String(c.ws.name || '').slice(12, 24))),
               h('text', { x: c.x, y: c.y + 15, textAnchor: 'middle', fontSize: 8, fill: '#7d8793' }, (c.ws.logCount || 0) + ' ' + t('logEntries')))
           }))))
@@ -2748,7 +3456,7 @@ window.__ModuleLoader__.load({
               h('div', { style: { minHeight: '34px', flex: 1, borderLeft: '2px solid color-mix(in srgb, var(--dam-accent, #1d4ed8) 24%, transparent)', paddingLeft: '9px' } }, hourEvents.length ? hourEvents.map(function (en) { var qs = QUADRANT_STYLE[en.quadrant] || QUADRANT_STYLE['未分类']; return h('div', { key: en.time + en.title, 'data-dam-calendar-event': '', onClick: function (ev) { ev.stopPropagation(); toggleDone(en) }, style: { marginBottom: '4px', padding: '4px 7px', borderRadius: 6, background: 'color-mix(in srgb, ' + qs.color + ' 18%, transparent)', color: qs.color, textDecoration: en.done ? 'line-through' : 'none' } }, (en.time || '') + '  ' + en.title + (en.note ? ' · ' + en.note : '')) }) : h('span', { 'data-dam-hint': '' }, locale === 'zh' ? '点击添加事件' : 'Click to add event'))))
           })(hourSlot)
         }
-        rows.push(h('div', { 'data-dam-calendar-modal': '', style: { position: 'absolute', inset: 0, zIndex: 10, overflow: 'auto', borderRadius: '16px', background: 'color-mix(in srgb, var(--dsw-alias-bg-overlay, rgba(255,255,255,.9)) 78%, transparent)', backdropFilter: 'blur(20px) saturate(1.4)', WebkitBackdropFilter: 'blur(20px) saturate(1.4)', padding: '16px' } }, h('div', { 'data-dam-row': '' }, h('div', { style: { fontWeight: 700, flex: 1 } }, dayView + ' · ' + (locale === 'zh' ? '当天安排' : 'Day schedule')), h('button', { 'data-dam-btn': '', onClick: function () { setDayView(null) } }, '✕')), timeline))
+        rows.push(h('div', { 'data-dam-calendar-modal': '', style: { position: 'absolute', inset: 0, zIndex: 10, overflow: 'auto', borderRadius: '16px', background: 'color-mix(in srgb, var(--dsw-alias-bg-layer-2, rgba(255,255,255,.9)) 78%, transparent)', backdropFilter: 'blur(20px) saturate(1.4)', WebkitBackdropFilter: 'blur(20px) saturate(1.4)', padding: '16px' } }, h('div', { 'data-dam-row': '' }, h('div', { style: { fontWeight: 700, flex: 1 } }, dayView + ' · ' + (locale === 'zh' ? '当天安排' : 'Day schedule')), h('button', { 'data-dam-btn': '', onClick: function () { setDayView(null) } }, '✕')), timeline))
       }
       // 添加/编辑浮层(液态玻璃)
       if (draft) {
@@ -2756,7 +3464,7 @@ window.__ModuleLoader__.load({
           'data-dam-calendar-modal': '',
           style: {
             position: 'absolute', inset: 0, zIndex: 10, borderRadius: '16px',
-            background: 'color-mix(in srgb, var(--dsw-alias-bg-overlay, rgba(255,255,255,.9)) 70%, transparent)',
+            background: 'color-mix(in srgb, var(--dsw-alias-bg-layer-2, rgba(255,255,255,.9)) 70%, transparent)',
             backdropFilter: 'blur(20px) saturate(1.4)', WebkitBackdropFilter: 'blur(20px) saturate(1.4)',
             display: 'flex', flexDirection: 'column', padding: '18px', gap: '10px',
             border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.35)) 60%, transparent)',
@@ -3007,7 +3715,7 @@ window.__ModuleLoader__.load({
         return function () { alive = false }
       }, [])
       // 可读性兜底(@ProperSAMA PR#12,适配版):DSH Desktop 增强模式 + 透明/Mica 窗口材质下,
-      // 主题令牌 --dsw-alias-bg-overlay 本身就是半透明的,面板文字几乎不可读。判别信号用
+      // 主题令牌 --dsw-alias-bg-layer-2 本身就是半透明的,面板文字几乎不可读。判别信号用
       // 「令牌自身的 alpha」(增强模式显著低于普通模式的 0.86-0.9):< 0.65 时把面板背景提升到
       // 0.96(保留色相)并弱化顶部高光。普通模式令牌不透明 → 不触发,液态玻璃观感零变化。
       useEffect(function () {
@@ -3016,7 +3724,7 @@ window.__ModuleLoader__.load({
         if (!el) return
         try {
           var cs = getComputedStyle(el)
-          var token = cs.getPropertyValue('--dsw-alias-bg-overlay')
+          var token = cs.getPropertyValue('--dsw-alias-bg-layer-2')
           var col = parseCssColor((token || '').trim() || cs.backgroundColor)
           if (col && col.a < 0.65) {
             el.style.background = 'rgba(' + col.r + ', ' + col.g + ', ' + col.b + ', 0.96)'
@@ -3243,20 +3951,26 @@ window.__ModuleLoader__.load({
         if (ph === 'downloading' || ph === 'verifying' || ph === 'done' || ph === 'error') return undefined
         apiPost(API.semanticDownload, { action: 'start', mirror: 'auto' }).catch(function () {})
       }, [tourShowing, tourStep, wizSt.ready])
+      // issue#40:向导展示期间装焦点陷阱(移动端浮层吞点击/Esc 关不掉的关键一环)。
+      useEffect(function () {
+        if (!dialogState || dialogState.kind !== 'welcomeTour') return undefined
+        var root = document.querySelector('[data-dam-tour]')
+        return installTourFocusPre(root, function () { dismissWelcomeTourPre('user') }, document)
+      }, [dialogState ? dialogState.kind : null])
       if (!dialogState) return null
       // 左下角小卡片(记忆按钮上方),高透明毛玻璃,不遮全屏
       var overlay = { position: 'fixed', left: '10px', bottom: '64px', zIndex: 2147483000, width: 'min(360px, calc(100vw - 20px))', maxHeight: 'min(46vh, 430px)', display: 'flex', flexDirection: 'column' }
       var box = {
         overflow: 'auto', borderRadius: '14px', padding: '12px 14px', display: 'flex', flexDirection: 'column', gap: '6px',
-        background: 'color-mix(in srgb, var(--dsw-alias-bg-overlay, rgba(24,26,32,.9)) 58%, transparent)',
+        background: 'color-mix(in srgb, var(--dsw-alias-bg-layer-2, rgba(24,26,32,.9)) 58%, transparent)',
         backdropFilter: 'blur(14px) saturate(1.3)', WebkitBackdropFilter: 'blur(14px) saturate(1.3)',
         border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.35)) 45%, transparent)',
         boxShadow: '0 8px 28px rgba(0,0,0,.18)',
       }
-      var head = { fontSize: 'calc(13px * var(--dam-scale))', fontWeight: 700, color: 'var(--dsw-alias-text-primary, inherit)' }
+      var head = { fontSize: 'calc(13px * var(--dam-scale))', fontWeight: 700, color: 'var(--dsw-alias-label-primary, inherit)' }
       var sub = { fontSize: 'calc(11px * var(--dam-scale))', opacity: .7 }
       var item = { fontSize: 'calc(11px * var(--dam-scale))', lineHeight: 1.55, padding: '1px 0 1px 16px', position: 'relative' }
-      var close = { alignSelf: 'flex-end', padding: '4px 16px', borderRadius: '8px', border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.35)) 45%, transparent)', background: 'color-mix(in srgb, var(--dsw-alias-brand-primary, #4f7cff) 12%, transparent)', color: 'var(--dsw-alias-text-primary, inherit)', cursor: 'pointer', fontSize: 'calc(11.5px * var(--dam-scale))' }
+      var close = { alignSelf: 'flex-end', padding: '4px 16px', borderRadius: '8px', border: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.35)) 45%, transparent)', background: 'color-mix(in srgb, var(--dsw-alias-brand-primary, #4f7cff) 12%, transparent)', color: 'var(--dsw-alias-label-primary, inherit)', cursor: 'pointer', fontSize: 'calc(11.5px * var(--dam-scale))' }
       var dot = { position: 'absolute', left: '0', top: '10px', width: '7px', height: '7px', borderRadius: '50%', background: 'var(--dsw-alias-brand-primary, #4f7cff)' }
       // 通用开场舞台必须在 first/notice/update 三个分支之前完成赋值；var 只提升声明、不提升赋值。
       var skipUpdateIntro = function () { setUpdateSkip(true) }
@@ -3425,11 +4139,9 @@ window.__ModuleLoader__.load({
             })
           } catch (eChain) {}
         }
-        var closeOrRemind = function () {
-          // 关闭时机提醒:未到完成步就关 → 先落到完成步(重开位置指引),再点才开始使用
-          if (tourStep < TOUR_STEPS.length - 1) setTourStep(TOUR_STEPS.length - 1)
-          else finishTour()
-        }
+        // issue#40:"关闭"就是关闭 —— 旧实现把 ✕ 变成"先跳到最后一步再点"，手机端体感即"关不掉"。
+        // 现在 ✕ 直接撤下向导并记录**用户动作**(tourDismissed)，此后不再自动播放。
+        var closeOrRemind = function () { dismissWelcomeTourPre('user') }
         var step = TOUR_STEPS[Math.min(tourStep, TOUR_STEPS.length - 1)]
         var isLast = tourStep >= TOUR_STEPS.length - 1
         // 每步只生成当前图形所需 DOM；避免旧实现一次创建 22 个 span、非当前零件塌成 0/2px。
@@ -3456,7 +4168,7 @@ window.__ModuleLoader__.load({
               el.style.setProperty('--dam-mx', (((e.clientX - r.left) / r.width) * 100).toFixed(1) + '%')
               el.style.setProperty('--dam-my', (((e.clientY - r.top) / r.height) * 100).toFixed(1) + '%')
             } },
-          h('div', { 'data-dam-tour': '' },
+          h('div', { 'data-dam-tour': '', role: 'dialog', 'aria-modal': true, tabIndex: -1, 'aria-label': locale === 'zh' ? '欢迎向导' : 'Welcome tour' },
             h('div', { 'data-dam-tour-glare': '' }),
             h('button', { 'data-dam-tour-close': '', title: t('close'), onClick: closeOrRemind }, '✕'),
             h('div', { 'data-dam-tour-orb-wrap': '', key: 'orb' + tourStep, 'data-step': String(tourStep), 'data-art': step.art || 'bubble' },
@@ -3540,7 +4252,7 @@ window.__ModuleLoader__.load({
         var nTitle = zh ? (n.title || '') : (n.titleEn || n.title || '')
         var nMsg = zh ? (n.message || '') : (n.messageEn || n.message || '')
         var isUrgent = n.level === 'urgent'
-        var accent = isUrgent ? 'var(--dsw-alias-danger, #e5534b)' : 'var(--dsw-alias-brand-primary, #4f7cff)'
+        var accent = isUrgent ? 'var(--dsw-alias-state-error-primary, #e5534b)' : 'var(--dsw-alias-brand-primary, #4f7cff)'
         var noticeButton = h('button', { 'data-dam-btn': '', style: close, onClick: function () {
           try {
             var arr = []
@@ -3687,7 +4399,7 @@ window.__ModuleLoader__.load({
           // 带上当前会话 id:宿主据此只在「属于本窗口的」armed 上弹确认卡(2026-09-10)
           var sidQ = ''
           try { sidQ = String(currentSessionIdClient() || '') } catch (eS) {}
-          apiGet(API.config).then(function (c) { if (alive) setAcCfg(c || {}) }).catch(function () {})
+          apiGet(API.config).then(function (d) { if (alive) setAcCfg(configOf(d)) }).catch(function () {})
           apiGet(API.autoContState, sidQ ? { sessionId: sidQ } : {}).then(function (s) { if (alive && s) setAcState(s) }).catch(function () {})
         }
         load()
@@ -3880,12 +4592,12 @@ window.__ModuleLoader__.load({
         if (mdlLoading) kids.push(h('div', { 'data-dam-hint': '' }, locale === 'zh' ? '正在检测可用模型…' : 'Detecting models…'))
         if (mdlErr) kids.push(h('div', { 'data-dam-error': '' }, mdlErr))
         if (!mdlLoading && !mdlErr && mdlData) {
-          kids.push(h('button', { key: '__default__', 'data-dam-btn': '', style: { display: 'block', width: '100%', textAlign: 'left', padding: '4px 6px', opacity: cfg.subagentModel ? 1 : 0.75 }, onClick: function () { set('subagentModel', ''); set('subagentProvider', ''); setMdlOpen(false) } },
+          kids.push(h('button', { key: '__default__', 'data-dam-btn': '', style: { display: 'block', width: '100%', textAlign: 'left', padding: '4px 6px', opacity: cfg.subagentModel ? 1 : 0.75 }, onClick: function () { setMany({ subagentModel: '', subagentProvider: '' }); setMdlOpen(false) } },
             locale === 'zh' ? '跟随路由默认（留空）' : 'Follow routing default (empty)'))
           ;(mdlData.providers || []).forEach(function (p) {
             var modelBtns = (p.models || []).length
               ? p.models.map(function (m) {
-                  return h('button', { key: p.id + '/' + m.id, 'data-dam-btn': '', style: { display: 'block', width: '100%', textAlign: 'left', padding: '3px 6px', fontWeight: cfg.subagentModel === m.id ? 700 : 400 }, onClick: function () { set('subagentModel', m.id); set('subagentProvider', p.id); setMdlOpen(false) } },
+                  return h('button', { key: p.id + '/' + m.id, 'data-dam-btn': '', style: { display: 'block', width: '100%', textAlign: 'left', padding: '3px 6px', fontWeight: cfg.subagentModel === m.id ? 700 : 400 }, onClick: function () { setMany({ subagentModel: m.id, subagentProvider: p.id }); setMdlOpen(false) } },
                     m.id + (m.name && m.name !== m.id ? ' · ' + m.name : '') + (cfg.subagentModel === m.id ? ' ✓' : ''))
                 })
               : [h('div', { key: 'none', 'data-dam-hint': '' }, locale === 'zh' ? '（该 provider 未列出模型）' : '(no models advertised)')]
@@ -3899,7 +4611,7 @@ window.__ModuleLoader__.load({
           if (!(mdlData.providers || []).length && !(mdlData.failures || []).length) {
             kids.push(h('div', { 'data-dam-hint': '' }, locale === 'zh' ? '未检测到 provider;可直接在下方手动输入。' : 'No providers detected; use manual input below.'))
           }
-          kids.push(h('input', { key: '__manual__', 'data-dam-input': '', style: { marginTop: '6px', width: '100%' }, value: cfg.subagentModel || '', placeholder: locale === 'zh' ? '手动输入(可选,provider 跟随路由默认)' : 'manual entry (optional, provider follows routing default)', onChange: function (e) { set('subagentModel', String(e.target.value || '').trim()); set('subagentProvider', '') } }))
+          kids.push(h('input', { key: '__manual__', 'data-dam-input': '', style: { marginTop: '6px', width: '100%' }, value: cfg.subagentModel || '', placeholder: locale === 'zh' ? '手动输入(可选,provider 跟随路由默认)' : 'manual entry (optional, provider follows routing default)', onChange: function (e) { setMany({ subagentModel: String(e.target.value || '').trim(), subagentProvider: '' }) } }))
         }
         // 思考强度(DSH 0.1.5 agentOptions.reasoningEffort):与模型成对下发给子代理;留空=跟随模型默认。
         // 合法值按 DeepSeek 适配器口径 off|low|high|max(默认 high)——服务端同样做白名单过滤。
@@ -3985,7 +4697,15 @@ window.__ModuleLoader__.load({
         return function () { clearInterval(iv) }
       }, [sem && sem.download && sem.download.phase])
       if (!cfg) return err ? h('div', { 'data-dam-error': '' }, err) : h(Loading)
-      function set(key, value) { var next = Object.assign({}, cfg); next[key] = value; setCfg(next); setDirty(true) }
+    // issue #52:旧实现 `var next = Object.assign({}, cfg); next[key] = value` 读的是**本次渲染的闭包快照**。
+    // 同一个事件里连续调 `set('subagentModel', m); set('subagentProvider', p)` 时,React 批处理两次
+    // 更新,而第二次仍基于同一个旧 cfg ⇒ 把第一次写进去的值**覆盖回旧值**。
+    // 典型症状:subagentModel 存过一个后来被删除的模型后,无论换模型/清空/手输都无法覆盖,
+    // 插件持续按已删除模型派子代理(issue #52)。
+    // 修法:改用函数式更新,基于**最新** prev 派生 next,成对字段不再互相覆盖。
+    function set(key, value) { setCfg(function (prev) { var next = Object.assign({}, prev); next[key] = value; return next }); setDirty(true) }
+    /** 原子更新多个字段(issue #52 建议口径):一次函数式更新写入成对字段,避免先后覆盖。 */
+    function setMany(patch) { setCfg(function (prev) { return Object.assign({}, prev, patch) }); setDirty(true) }
       function checkUpdate() {
         if (checkingUpdate) return
         setCheckingUpdate(true)
@@ -4004,10 +4724,20 @@ window.__ModuleLoader__.load({
       function save() {
         if (busy) return
         setBusy(true); setMsg(''); setErr('')
-        saveConfigPatch(cfg, {
-          onSaved: function (d) { setCfg(d.config); setDirty(false); setMsg(t('saved') + (d.migrated ? ' ' + d.migrated : '')); setBusy(false); if (d && d.config && d.config.locale) applyLocalePref(d.config.locale); refreshSem(setSem) },
-          onError: function (e) { setErr(e.message); setBusy(false) }
-        })
+        // 2026-09-14 修「跨入口互相覆盖」:旧实现把整份 cfg 快照 POST,而宿主端语义是 { ...this.config, ...patch } 合并
+        // ⇒ 只要本页加载之后又从别的入口(白板页开关 / 向导 / 接续页)改过任何键,这里一保存就会把它们**回滚**成
+        // 加载时的旧值(用户观感:「打开白板,原有设置被覆盖」)。改为先取回宿主当前配置,只提交与远端不同的键。
+        apiGet(API.config).then(function (d0) {
+          var remote = (d0 && d0.config) || {}
+          var patch = {}
+          Object.keys(cfg).forEach(function (k) {
+            if (JSON.stringify(cfg[k]) !== JSON.stringify(remote[k])) patch[k] = cfg[k]
+          })
+          saveConfigPatch(patch, {
+            onSaved: function (d) { setCfg(d.config); setDirty(false); setMsg(t('saved') + (d.migrated ? ' ' + d.migrated : '')); setBusy(false); if (d && d.config && d.config.locale) applyLocalePref(d.config.locale); refreshSem(setSem) },
+            onError: function (e) { setErr(e.message); setBusy(false) }
+          })
+        }).catch(function (e) { setErr(e.message); setBusy(false) })
       }
       function field(label, control, hint) {
         return h('div', { 'data-dam-settings-row': '' },
@@ -4291,6 +5021,18 @@ window.__ModuleLoader__.load({
           : null]),
         section('injection', sectionLabels.injection, [field(t('fInject'), h('input', { type: 'checkbox', checked: !!cfg.injectEnabled, onChange: function (e) { set('injectEnabled', e.target.checked) } }), t('fInjectHint')),
         field(t('fBudget'), h('input', { 'data-dam-input': '', type: 'number', min: 400, value: cfg.injectBudgetChars, onChange: function (e) { set('injectBudgetChars', Number(e.target.value) || 2400) } }), t('fBudgetHint')),
+        // 群反馈第 4 条:排除来源(每行一条)。textarea 便于粘贴多行路径;
+        // 空行/纯空白在写回时被过滤,避免"看起来配了其实没配"。
+        field(t('fExclude'), h('textarea', {
+          'data-dam-input': '', rows: 3,
+          style: { width: '100%', resize: 'vertical', fontFamily: 'inherit' },
+          value: (Array.isArray(cfg.injectExcludeSources) ? cfg.injectExcludeSources : []).join('\n'),
+          placeholder: 'mem_0123456789abcdef0123456789abcdef\nD:\\ws\\.dsh-memory\\archive\\\nlog',
+          onChange: function (e) {
+            var lines = String(e.target.value || '').split('\n').map(function (x) { return x.trim() }).filter(Boolean)
+            set('injectExcludeSources', lines)
+          },
+        }), t('fExcludeHint')),
         field(t('fNoteCap'), h('input', { 'data-dam-input': '', type: 'number', min: 500, value: cfg.noteCapacityChars === undefined ? 12000 : cfg.noteCapacityChars, onChange: function (e) { set('noteCapacityChars', Number(e.target.value) || 12000) } }), t('fNoteCapHint')),
         field(t('fUserCap'), h('input', { 'data-dam-input': '', type: 'number', min: 500, value: cfg.userCapacityChars === undefined ? 12000 : cfg.userCapacityChars, onChange: function (e) { set('userCapacityChars', Number(e.target.value) || 12000) } }), t('fUserCapHint')),
         field(t('fDays'), h('input', { 'data-dam-input': '', type: 'number', min: 1, max: 14, value: cfg.recentDaysInjected, onChange: function (e) { set('recentDaysInjected', Number(e.target.value) || 1) } }), t('fDaysHint')),
@@ -4332,13 +5074,37 @@ window.__ModuleLoader__.load({
           locale === 'zh' ? '用于时段总结、问候语、自动沉淀、蒸馏等 subagent 功能;模型与思考强度(off/low/high/max)都经 DSH 的 agentOptions 下发,留空跟随路由与模型默认。保存后生效。' : 'For scheduled summaries, greetings, auto-consolidation and distillation subagents; model and reasoning effort (off/low/high/max) are delivered via DSH agentOptions. Empty follows routing and model defaults. Applies after saving.'),
         mdlOpen ? buildModelDrawer() : null,
         ]),
-        section('context', sectionLabels.context, [field(t('fHandoff'), h('input', { type: 'checkbox', checked: cfg.handoffEnabled !== false, onChange: function (e) { set('handoffEnabled', e.target.checked) } }), t('fHandoffHint')),
+        // 2026-09-14 解耦:交接白板与自动接续各自独立成项(旧实现只在白板页有接续按钮,且 enabled 还被
+        // handoffEnabled 二次与运算)。两者出厂默认均为 false(功能仍在测试期),这里与白板页读写完全相同的配置键。
+        section('context', sectionLabels.context, [field(t('fHandoff'), h('input', { type: 'checkbox', 'data-dam-key': 'handoffEnabled', checked: cfg.handoffEnabled !== false, onChange: function (e) { set('handoffEnabled', e.target.checked) } }), t('fHandoffHint')),
+        field(t('fAutoContinue'), h('input', { type: 'checkbox', 'data-dam-key': 'autoContinueEnabled', checked: cfg.autoContinueEnabled !== false, onChange: function (e) { set('autoContinueEnabled', e.target.checked) } }), t('fAutoContinueHint')),
         field(t('fHandoffPlan'), h('input', { 'data-dam-input': '', type: 'number', min: 200, value: cfg.handoffPlanChars === undefined ? 1200 : cfg.handoffPlanChars, onChange: function (e) { set('handoffPlanChars', Number(e.target.value) || 1200) } }), t('fHandoffPlanHint')),
         field(t('fHandoffLedger'), h('input', { 'data-dam-input': '', type: 'number', min: 100, value: cfg.handoffLedgerChars === undefined ? 800 : cfg.handoffLedgerChars, onChange: function (e) { set('handoffLedgerChars', Number(e.target.value) || 800) } }), t('fHandoffLedgerHint')),
         field(t('fWaterWindow'), h('input', { 'data-dam-input': '', type: 'number', min: 0, value: cfg.waterLevelWindowTokens === undefined ? 65536 : cfg.waterLevelWindowTokens, onChange: function (e) { set('waterLevelWindowTokens', Number(e.target.value) || 0) } }), t('fWaterWindowHint')),
         field(t('fWaterThreshold'), h('input', { 'data-dam-input': '', type: 'number', min: 0.1, max: 1.5, step: 0.05, value: cfg.waterLevelThreshold === undefined ? 0.75 : cfg.waterLevelThreshold, onChange: function (e) { set('waterLevelThreshold', Number(e.target.value) || 0.75) } }), t('fWaterThresholdHint')),
         field(t('fWaterAdvisory'), h('input', { type: 'checkbox', checked: cfg.waterLevelAdvisory !== false, onChange: function (e) { set('waterLevelAdvisory', e.target.checked) } }), t('fWaterAdvisoryHint')),
         field(t('fWaterAuto'), h('input', { type: 'checkbox', checked: cfg.waterLevelAutoHandoff !== false, onChange: function (e) { set('waterLevelAutoHandoff', e.target.checked) } }), t('fWaterAutoHint')),
+        // WB-GRAPH 白板线一键切换(2026-09-16, board_mode_v1): 旧版白板(默认) / 新版看板(dsh-graph vendor
+        // + sidecar + 遍历工具, 工具数 14→16)。开关解耦: 只管白板线; 切换需重启 dsh web 生效(工具注册在启动期)。
+        field(locale === 'zh' ? '白板模式（旧版白板 / 新版看板）' : 'Board mode (legacy / graph)', (function () {
+          var cur = cfg.boardMode === 'graph' ? 'graph' : 'legacy'
+          // ★2026-09-16 修 BUG-3(设置页切换不落盘): 旧实现 `set('boardMode', m)` 只改**本地 React 态**
+          // 然后 reload —— 配置从未写到服务端, 刷新后仍是旧值(界面回跳原档), 用户会判定"开关坏了"。
+          // 正解: 走与接续面板同一个写入路径 `saveConfigPatch(API.config, patch)`(见 :999 定义),
+          // 写盘成功后再 reload; 失败则在界面提示, 不静默假装成功。
+          // 同时满足用户硬性偏好: 开关类改动必须**即时回显**(写盘后立即 reload 呈现新档)。
+          function pick(m) {
+            set('boardMode', m) // 先本地回显(即时反馈)
+            saveConfigPatch({ boardMode: m }, {
+              onSaved: function () { window.setTimeout(function () { window.location.reload() }, 350) },
+              onError: function (e) { setErr(String((e && e.message) || e || 'save failed')) },
+            })
+          }
+          return h('div', { 'data-dam-row': '' },
+            h('button', { 'data-dam-btn': '', 'data-dam-key': 'boardMode', style: { fontWeight: cur === 'legacy' ? 700 : 400, opacity: cur === 'legacy' ? 1 : 0.65 }, onClick: function () { if (cur !== 'legacy') pick('legacy') } }, locale === 'zh' ? '旧版白板' : 'Legacy board'),
+            h('button', { 'data-dam-btn': '', 'data-dam-key': 'boardModeGraph', style: { marginLeft: '6px', fontWeight: cur === 'graph' ? 700 : 400, opacity: cur === 'graph' ? 1 : 0.65 }, onClick: function () { if (cur !== 'graph') pick('graph') } }, locale === 'zh' ? '新版看板（dsh-graph）' : 'Graph board (dsh-graph)'))
+        })(),
+          locale === 'zh' ? '一键切换白板形态。默认「旧版白板」=一切行为不变；切到「新版看板」后启用 dsh-graph 看板、白板结构化索引（handoff/index.json）与两个遍历工具（memory_expand_pre / memory_trace_pre，工具数 14→16）。切换后需重启 dsh web 生效；再点回旧版即完全回滚。' : 'One-click switch for the board form. Default "Legacy board" keeps everything unchanged; "Graph board" enables the dsh-graph kanban, the structured handoff index (handoff/index.json) and two traversal tools (memory_expand_pre / memory_trace_pre, tool count 14→16). Restart dsh web after switching; switch back to fully roll back.'),
         field(locale === 'zh' ? '子代理痕迹回收' : 'Subagent trace recycle', h('input', { type: 'checkbox', checked: cfg.subagentGcEnabled !== false, onChange: function (e) { set('subagentGcEnabled', e.target.checked) } }),
           locale === 'zh' ? '本插件的一次性子代理(自动沉淀 / 时段总结 / 问候 / 蒸馏)每跑一次都会在 ~/.dsh/sessions 留下一个持久化会话;数量上千后会话列表会明显变慢。开启后任务一结束就把这些痕迹移入 ~/.dsh/subagent-gc-backup 备份(可回滚),不影响子代理结果。默认开。' : 'Every one-shot subagent this plugin spawns (auto-consolidation, scheduled summary, greeting, distillation) leaves a persisted session under ~/.dsh/sessions; hundreds of them slow the session list down. When on, each trace is moved into ~/.dsh/subagent-gc-backup right after the task ends (reversible), never affecting the subagent result. On by default.'),
         field(locale === 'zh' ? '兜底回收保留天数' : 'Fallback recycle keep days', h('input', { 'data-dam-input': '', type: 'number', min: 0, value: cfg.subagentGcKeepDays === undefined ? 3 : cfg.subagentGcKeepDays, onChange: function (e) { set('subagentGcKeepDays', Number(e.target.value) || 0) } }),
@@ -4460,7 +5226,8 @@ window.__ModuleLoader__.load({
       // v0.1.38:旧 first 卡已删除 → 全新安装直接完整欢迎向导;老用户按 seen/向导完成态补大更新。
       // 抽成具名函数便于状态机单测(startup-dispatch)。
       var MAJOR_TOUR_KEY = 'dsh-auto-memory.majorTourV130'
-      function dispatchStartupDialog(d) {
+      function dispatchStartupDialog(d, cfg) {
+        var allowTour = welcomeAutoAllowedPre(cfg)
         if (d && d.current) {
           try {
             var seen = localStorage.getItem('dsh-auto-memory.seenVersion')
@@ -4469,28 +5236,31 @@ window.__ModuleLoader__.load({
             var firstDone = localStorage.getItem('dsh-auto-memory.firstRunDone')
             // 0.1.38:旧的 first 欢迎卡已删除(内容被 welcomeTour 完整覆盖,且小卡形态无 ✕ 关闭)。
             // 全新安装直接完整欢迎向导(分步功能开关+引擎检测/下载引导)。
+            // issue#40:三个自动弹出分支都必须过 allowTour 配置闸 —— 否则 welcomeTourEnabled=false 形同虚设。
             var freshInstall = !seen && !firstDone && !wizDone
             var isExisting = !!seen || !!firstDone || !!wizDone
-            if (freshInstall) {
+            if (allowTour && freshInstall) {
               openDialog({ kind: 'welcomeTour' })
               try { localStorage.setItem(MAJOR_TOUR_KEY, '1') } catch (eF) {}
               return
             }
             // 老用户(有使用痕迹)seen < 0.1.30(大更新前版本)或从未看过向导 → 补一次完整欢迎向导
             // (含引擎下载引导;0.1.29→0.1.34 直升即使曾看过旧版也重放,确保引导不漏)
-            if (isExisting && !wizDone && (!seen || cmpVersion(seen, '0.1.30') < 0)) {
+            if (allowTour && isExisting && !wizDone && (!seen || cmpVersion(seen, '0.1.30') < 0)) {
               openDialog({ kind: 'welcomeTour' })
               try { localStorage.setItem(MAJOR_TOUR_KEY, '1') } catch (eM) {}
               return
             }
-            if (majorPending && isExisting && !wizDone) {
+            if (allowTour && majorPending && isExisting && !wizDone) {
               openDialog({ kind: 'welcomeTour' })
               try { localStorage.setItem(MAJOR_TOUR_KEY, '1') } catch (eM) {}
               return
             }
             if (seen && seen !== d.current) {
-              // 只弹 2.1.0 大更新卡(历次小更新已总结并入),不逐个弹历史版本——大更新内容才是要传达的
-              var bigKey = '2.1.0'
+              // ★2026-09-17 修复:bigKey 原是硬编码 '2.1.0' ⇒ 老用户升级到 3.0.0 时弹的仍是 2.1.0 的
+              // 说明卡,本版 changelog 根本送达不了(违反「用户读得到的弹窗 changelog」要求)。
+              // 改为**动态取当前版本**:只要 CHANGELOG 里有本版条目就弹本版,以后每个大版本自动正确。
+              var bigKey = (CHANGELOG[d.current] ? d.current : '2.1.0')
               if (CHANGELOG[bigKey]) {
                 openDialog({ kind: 'update', versions: [{ version: bigKey, items: CHANGELOG[bigKey] }], currentVersion: d.current })
                 try { localStorage.setItem('dsh-auto-memory.seenVersion', d.current) } catch (e3b) {}
@@ -4507,7 +5277,39 @@ window.__ModuleLoader__.load({
           } catch (e) {}
         }
       }
-      apiGet(API.updateCheck).then(dispatchStartupDialog).catch(function () {})
+      // issue#40:不得与 update-check 抢跑 —— 配置未知时(Null)一律**不自动播放**,等配置到达再分发。
+      var startupEpoch = tourNavigationEpoch
+      Promise.all([
+        apiGet(API.updateCheck).catch(function () { return null }),
+        loadWelcomeConfigPre(5000),
+      ]).then(function (pair) {
+        // 配置闸的清理动作会推进 epoch;此时仍要送达版本通知,但向导必须保持关闭。
+        var cfg = pair[1]
+        if (tourNavigationEpoch !== startupEpoch) cfg = { welcomeTourEnabled: false }
+        dispatchStartupDialog(pair[0], cfg)
+      }).catch(function () {})
+      // 会话切换 / 浏览器前进后退 都视为"用户已离开向导"⇒ 撤下,避免浮层跨页面残留(移动端体感:关不掉)。
+      if (typeof window['dsh-auto-memory.disposeTourNavigation'] === 'function') window['dsh-auto-memory.disposeTourNavigation']()
+      var lastTourSession = currentSessionIdClient()
+      var tourSessionDispose = null
+      function tourNavigated() { dismissWelcomeTourPre('navigation') }
+      try {
+        if (sessions && sessions.list && typeof sessions.list.subscribe === 'function') {
+          tourSessionDispose = sessions.list.subscribe(function () {
+            var sid = currentSessionIdClient()
+            if (sid !== lastTourSession) { lastTourSession = sid; dismissWelcomeTourPre('navigation') }
+          })
+        }
+        window.addEventListener('popstate', tourNavigated)
+        window.addEventListener('hashchange', tourNavigated)
+      } catch (_) {}
+      window['dsh-auto-memory.disposeTourNavigation'] = function () {
+        if (typeof tourSessionDispose === 'function') tourSessionDispose()
+        window.removeEventListener('popstate', tourNavigated)
+        window.removeEventListener('hashchange', tourNavigated)
+        tourSessionDispose = null
+      }
+      if (typeof ctx !== 'undefined' && ctx && typeof ctx.effect === 'function') ctx.effect(function () { return window['dsh-auto-memory.disposeTourNavigation'] }, 'auto-memory:tour-navigation')
 
       // 动态通知(发布者→用户:重大 bug 提醒,不依赖发版):启动检查 + 每小时刷新;按 id 去重,urgent 优先
       function checkNotices() {
@@ -4590,6 +5392,16 @@ window.__ModuleLoader__.load({
           surfaceDisposers.push(slots.inject('settings.section', function () {
             return slots.register({ name: 'settings.section', id: 'auto-memory', order: 25, label: t('autoMemory') + ' (pre)' }, function (props) { return h(SettingsPage, { close: props && props.close }) })
           }))
+          // 2026-09-16「双承载面」: 会话页顶栏再挂一个**整页白板看板**(与侧边面板共存)。
+          // 面板 440px 装不下矩阵, 整页 ~1000px+ 可以 ⇒ 两者按容器宽度各用其形态。
+          // 与 boardMode 闸门解耦: 组件内部自己取数, 非 graph 档拿到 enabled:false 就显示提示,
+          // 不改变 legacy 档下顶栏是否出现该 Tab 的行为(那由宿主/开关层决定, 本处不加判断)。
+          surfaceDisposers.push(slots.inject('conversation.view', function () {
+            return slots.register(
+              { name: 'conversation.view', id: 'auto-memory-kanban', order: 80, label: function () { return locale === 'zh' ? '白板看板' : 'Whiteboard' } },
+              function (props) { return h(KanbanView, props || {}) },
+            )
+          }))
         } catch (e) {
           console.warn('[dsh-auto-memory] slot registration failed', e)
         }