iterate-plugin 3.5.7 → 3.7.0

package/src/client/index.ts

@@ -82,7 +82,45 @@ import {
   SEVERITY_LABEL,
   SEVERITY_COLOR,
   stoppedReasonLabel,
+  // ── gap fixes ──
+  START_INSTRUCTIONS, // #1: registered instruction set (test-locked)
+  dashboardRunState, // #5: running vs onboarding empty state
+  buildRoundComparison, // #13: cross-round comparison table
+  buildDiskSnapshotInstruction, // #4: pull `.iterate/` artifacts into the stream
+  diskEmptyStateText, // #4: "not pulled" vs "pulled and empty"
+  toolCalledInSession, // #4: which read-side tools ran this session
+  buildFixInstruction, // #10: single-finding fix payload w/ content + round
+  buildAssignFixesInstruction, // #10: "one call per finding" batch wording
+  buildArchitecturalFixInstruction, // #10: force:true still needs 4 required fields
+  buildCheckpointResumeInstruction, // #10: resume takes {operation} only
+  buildCheckpointClearInstruction, // #10: clear takes {operation} only
+  buildRollbackInstruction, // #10: shared rollback payload
+  buildQualityGateQueryInstruction, // #10: JSON-carrying query instruction
+  buildQualityGateClearInstruction, // #10: JSON-carrying clear instruction
+  buildTriageReadbackInstruction, // #7: close the write-back loop
+  buildExperienceListInstruction, // #3/#10: JSON list payload for F9
+  buildDefenseEventsListInstruction, // #3/#10: JSON list payload for F10
+  buildConfigFieldInstruction, // #8: field → iterate_config write instruction
+  configFieldByKey, // #8: field lookup for the settings picker
+  CONFIG_EDIT_FIELDS, // #8: field list incl. validation.commands
+  buildConfigReadInstruction, // #8b: read instruction (write -> read-back loop)
+  scanSessionForConfigRead, // #8b: latest config echoed into the session
+  configValueByPath, // #8b: current value of the selected dotted key
+  DISK_SNAPSHOT_SOURCES, // #4/#3: read-side tools listed by the pull instruction
 } from '../../lib/parse.js'
+import {
+  configureLangStorage,
+  detectLang,
+  getLang,
+  setLang,
+  subscribeLang,
+  t,
+  tf,
+  LANG_NAMES,
+  LANG_STORAGE_KEY,
+  type Lang,
+} from './i18n.ts'
+import { noteSession, readSession, subscribeSession } from './session-cache.ts'
 
 // ─── Module contract ─────────────────────────────────────────────────────────
 
@@ -247,6 +285,17 @@ interface ObsManifest {
   approval?: ObsApproval
   /** Why the run ended: converged / max_rounds_reached / aborted_by_validation. */
   stoppedReason?: string | null
+  /** Gap #6: per-round validation rows persisted by `iterate_transcript capture`. */
+  validations?: ObsValidation[]
+}
+
+/** One `iterate_validate` outcome for a round (gap #6 contract). */
+interface ObsValidation {
+  round?: number
+  command?: string
+  exitCode?: number | null
+  allowed?: boolean
+  rejectReason?: string
 }
 
 // ─── Quality command center data types (v3.1+; mirrors src/types.ts) ────────
@@ -426,6 +475,7 @@ const ITERATE_CSS = `
 }
 .iterate-btn[data-primary] { border-color: var(--dsw-alias-brand-primary); color: var(--dsw-alias-brand-primary); }
 .iterate-btn[data-copied] { border-color: var(--dsw-alias-state-success-primary); color: var(--dsw-alias-state-success-primary); }
+.iterate-btn[data-failed], .iterate-cmd[data-failed] { border-color: var(--dsw-alias-state-error-primary); color: var(--dsw-alias-state-error-primary); }
 .iterate-payload { width: 100%; margin-top: 8px; padding: 8px; border: 1px solid var(--dsw-alias-border-l1); border-radius: 8px; background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-primary); font-family: var(--dsw-font-mono, ui-monospace, monospace); font-size: 11px; white-space: pre-wrap; }
 
 .iterate-stats { margin: 10px 0; border: 1px solid var(--dsw-alias-border-l1); border-radius: 12px; background: var(--dsw-alias-bg-layer-1); padding: 12px 14px; }
@@ -610,6 +660,16 @@ const ITERATE_CSS = `
 .iterate-obs-block-head[data-click] { cursor: pointer; }
 .iterate-obs-block-body { padding: 8px 10px; }
 .iterate-obs-chip { display: inline-flex; align-items: center; gap: 6px; padding: 2px 8px; border-radius: 6px; background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l1); font-size: 11px; color: var(--dsw-alias-label-secondary); white-space: nowrap; }
+/* Gap #6: validation / gate status colors (pass=green, fail=red). */
+.iterate-obs-chip[data-status="pass"], .iterate-obs-badge[data-status="pass"] { color: var(--dsw-alias-state-success-primary); background: color-mix(in srgb, var(--dsw-alias-state-success-primary) 12%, transparent); border-color: color-mix(in srgb, var(--dsw-alias-state-success-primary) 28%, transparent); }
+.iterate-obs-chip[data-status="fail"], .iterate-obs-badge[data-status="fail"] { color: var(--dsw-alias-state-error-primary); background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent); border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary) 28%, transparent); }
+.iterate-obs-row[data-status="fail"] { color: var(--dsw-alias-state-error-primary); }
+.iterate-obs-row[data-highlight] { background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 14%, transparent); border-radius: 6px; padding-left: 6px; padding-right: 6px; border-bottom-color: transparent; font-weight: 600; }
+/* Gap #13: cross-round comparison table. */
+.iterate-obs-table { width: 100%; border-collapse: collapse; font-size: 11px; }
+.iterate-obs-table th, .iterate-obs-table td { text-align: left; padding: 5px 8px; border-bottom: 1px solid var(--dsw-alias-border-l1); white-space: nowrap; }
+.iterate-obs-table th { color: var(--dsw-alias-label-secondary); font-weight: 600; }
+.iterate-obs-table td { color: var(--dsw-alias-label-primary); }
 .iterate-obs-msg { padding: 2px 0; color: var(--dsw-alias-label-secondary); line-height: 1.5; font-size: 11px; word-break: break-word; }
 .iterate-obs-file { font-family: var(--dsw-font-mono, ui-monospace, monospace); font-size: 10.5px; color: var(--dsw-alias-label-secondary); word-break: break-all; }
 .iterate-obs-bar { display: flex; align-items: center; gap: 6px; font-size: 11px; color: var(--dsw-alias-label-secondary); flex-wrap: wrap; }
@@ -682,6 +742,37 @@ function removeStorageByPrefix(prefix: string): number {
   return removed
 }
 
+// ─── Language (bilingual UI) ─────────────────────────────────────────────────
+
+/**
+ * Subscribe a component to language changes. Components that render `t()` /
+ * `tf()` must call this so a language switch repaints them — the slot
+ * wrappers registered in `apply()` apply it once per slot, so no panel can be
+ * forgotten.
+ */
+function useLang(): Lang {
+  const [lang, set] = React.useState<Lang>(getLang())
+  React.useEffect(() => subscribeLang(set), [])
+  return lang
+}
+
+/**
+ * Newest session published by the session-scoped slots (session-cache.ts).
+ * `useSyncExternalStore` keeps a root-scoped panel consistent with the store
+ * even when a session lands between render and effect.
+ */
+function useSessionSnapshot(): unknown {
+  return React.useSyncExternalStore(subscribeSession, readSession, readSession)
+}
+
+/** Wrap a slot component so its whole subtree re-renders on a language change. */
+function withLang<P extends object>(Component: React.ComponentType<P>): React.ComponentType<P> {
+  return function LangScoped(props: P) {
+    useLang()
+    return React.createElement(Component, props)
+  }
+}
+
 /** Copy text to the clipboard, resolving to whether it actually succeeded. */
 function copyText(text: string): Promise<boolean> {
   if (typeof navigator !== 'undefined' && navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
@@ -738,11 +829,28 @@ function severityLabel(severity: string | undefined): string {
   return SEVERITY_LABEL[coerceSeverity(severity)]
 }
 
+/** Render a config value read back from the session (arrays stay inline JSON). */
+function formatConfigValue(value: unknown): string {
+  if (typeof value === 'string') return value
+  if (value === undefined) return '—'
+  if (value === null) return 'null'
+  try {
+    return JSON.stringify(value) ?? String(value)
+  } catch {
+    return String(value)
+  }
+}
+
+/** Wrap a badge in full-width (zh) or ASCII (en) parentheses. */
+function parenthesize(label: string): string {
+  return getLang() === 'en' ? ` (${label})` : `（${label}）`
+}
+
 /** Badge text for the run's live/finished state, annotated with the stop reason. */
 function runStatusText(live: boolean, manifest: ObsManifest | null | undefined): string {
-  if (live) return '运行中'
+  if (live) return t('运行中')
   const reason = manifest && typeof manifest.stoppedReason === 'string' ? manifest.stoppedReason : ''
-  return reason ? stoppedReasonLabel(reason) : '已结束'
+  return reason ? stoppedReasonLabel(reason, getLang()) : t('已结束')
 }
 
 /** Resolve the slots service: prefer the typed `ctx.slots`, fall back to `ctx.get`. */
@@ -858,7 +966,7 @@ function TrendChart({ points }: { points: Array<{ round: number; count: number }
       key: p.round,
       className: 'iterate-trend-bar',
       'data-hot': p.count > 0 ? '' : undefined,
-      title: `Round ${p.round}：${p.count} 项`,
+      title: tf(`Round {a0}：{a1} 项`, { a0: p.round, a1: p.count }),
       style: { height: `${Math.max(4, Math.round((p.count / max) * 24))}px` },
     }),
   )
@@ -868,20 +976,42 @@ function TrendChart({ points }: { points: Array<{ round: number; count: number }
   return React.createElement('div', {
     className: 'iterate-trend',
     role: 'img',
-    'aria-label': `各轮发现数量趋势：${summary}`,
+    'aria-label': tf(`各轮发现数量趋势：{a0}`, { a0: summary }),
   }, ...bars)
 }
 
 /** Start-iteration launcher shown on the empty dashboard: copies a runnable
- *  command (the browser cannot invoke harness tools directly, so every action
- *  follows the panel's copy-to-command pattern). */
+ *  instruction (the browser cannot invoke harness tools directly, so every
+ *  action follows the panel's copy-to-command pattern).
+ *
+ *  Gap #1: the plugin registers NO dsh command (`src/index.ts` only registers
+ *  17 tools + a system prompt), so `/iterate` never existed — the copied text
+ *  is now a natural-language instruction from `START_INSTRUCTIONS`, which the
+ *  model resolves through the `workflow` tool exactly as the skill prompt
+ *  teaches. Label/tooltip say "指令", never "命令". */
 function StartIterationButton() {
   const [copied, setCopied] = React.useState<string | null>(null)
+  const [failed, setFailed] = React.useState<string | null>(null)
+  const timers = React.useRef<number[]>([])
+  React.useEffect(
+    () => () => {
+      for (const t of timers.current) clearTimeout(t)
+      timers.current = []
+    },
+    [],
+  )
   const copy = (key: string, text: string) => {
     copyText(text).then((ok) => {
       if (ok) {
+        setFailed(null)
         setCopied(key)
-        setTimeout(() => setCopied((cur) => (cur === key ? null : cur)), 1600)
+        const t = window.setTimeout(() => setCopied((cur) => (cur === key ? null : cur)), 1600)
+        timers.current.push(t)
+      } else {
+        // Copy failure must be visible, not silent — otherwise the button
+        // looks like a no-op and the user never learns the instruction text.
+        setCopied(null)
+        setFailed(key)
       }
     })
   }
@@ -891,14 +1021,15 @@ function StartIterationButton() {
       className: 'iterate-cmd',
       'data-primary': primary ? '' : undefined,
       'data-copied': copied === key ? '' : undefined,
+      'data-failed': failed === key ? '' : undefined,
       onClick: () => copy(key, command),
       title,
-    }, copied === key ? '已复制' : label)
+    }, copied === key ? t('已复制') : failed === key ? t('复制失败') : label)
   return React.createElement(
     'span',
     { className: 'iterate-dashboard-launch' },
-    btn('start-full', '完整迭代', '/iterate', true, '复制启动命令：完整「审查 → 修复 → 验证」闭环'),
-    btn('start-review', '仅评审', '/iterate review-only', false, '复制启动命令：只审查不修改（dry-run）'),
+    btn('start-full', t('完整迭代'), START_INSTRUCTIONS.full, true, t('复制启动指令：完整「审查 → 修复 → 验证 → 复盘」闭环（粘贴给模型即可）')),
+    btn('start-review', t('仅评审'), START_INSTRUCTIONS.reviewOnly, false, t('复制启动指令：只审查不修改（dry-run）（粘贴给模型即可）')),
   )
 }
 
@@ -915,6 +1046,12 @@ function ConvergenceDashboard(props: SlotProps) {
   // The `conversation.input.dock` slot owner share (InputZone) provides
   // `session` as a point-in-time snapshot — read it directly, never subscribe.
   const session = props && props.session ? props.session : null
+  // Publish it for ROOT-scoped panels (the settings card reads the config
+  // read-back through this cache). In an effect, not during render: notifying
+  // subscribers while another component is rendering is a React error.
+  React.useEffect(() => {
+    noteSession(session)
+  }, [session])
   const report = latestReport(session)
 
   React.useEffect(() => {
@@ -926,15 +1063,47 @@ function ConvergenceDashboard(props: SlotProps) {
   }, [report && hashReport(report) + ':' + getCurrentRound(report)])
 
   if (!report) {
+    // Gap #5: split the old single empty state in two. A run that is already
+    // in flight has no aggregated report yet (round 1 is still in
+    // review → fix → validate), but showing "运行一次评审后…" + a start button
+    // mid-run tells the user nothing is happening — and invites a second
+    // concurrent start. The transcript alone carries round + phase.
+    const runState = dashboardRunState(latestTranscript(session))
+    if (runState.state === 'running') {
+      return React.createElement(
+        'div',
+        { 'data-iterate-root': '', 'data-iterate': 'dashboard', 'data-run-state': 'running', className: 'iterate-dashboard iterate-dashboard-empty' },
+        React.createElement('span', { className: 'iterate-round-badge', 'data-live': '' }, t('运行中')),
+        React.createElement(
+          'span',
+          { className: 'iterate-empty-hint' },
+          tf(`第 {a0} 轮进行中{a1}——首轮汇总报告落地后，这里会显示收敛进度与发现统计。`, { a0: String(runState.round), a1: runState.phase ? tf(` · 阶段「{a0}」`, { a0: runState.phase }) : '' }),
+        ),
+        // No start button while a run is active.
+      )
+    }
+    if (runState.state === 'done') {
+      return React.createElement(
+        'div',
+        { 'data-iterate-root': '', 'data-iterate': 'dashboard', 'data-run-state': 'done', className: 'iterate-dashboard iterate-dashboard-empty' },
+        React.createElement('span', { className: 'iterate-round-badge' }, t('已结束')),
+        React.createElement(
+          'span',
+          { className: 'iterate-empty-hint' },
+          tf(`上次迭代在第 {a0} 轮后停止{a1}，但没有可展示的汇总报告。`, { a0: String(runState.round), a1: runState.stoppedReason ? parenthesize(stoppedReasonLabel(runState.stoppedReason, getLang())) : '' }),
+        ),
+        React.createElement(StartIterationButton, null),
+      )
+    }
     // Empty/onboarding state: first-time users otherwise see nothing and have
-    // no idea the plugin exists or how to start. Provide a one-click command
-    // that launches the loop (copied for paste — the browser cannot call
-    // harness tools directly).
+    // no idea the plugin exists or how to start. Provide a one-click copy of
+    // the startup instruction (the browser cannot call harness tools
+    // directly, and dsh exposes no command API to plugins).
     return React.createElement(
       'div',
-      { 'data-iterate-root': '', 'data-iterate': 'dashboard', className: 'iterate-dashboard iterate-dashboard-empty' },
+      { 'data-iterate-root': '', 'data-iterate': 'dashboard', 'data-run-state': 'empty', className: 'iterate-dashboard iterate-dashboard-empty' },
       React.createElement('span', { className: 'iterate-round-badge' }, 'iterate'),
-      React.createElement('span', { className: 'iterate-empty-hint' }, '运行一次评审后，这里会显示收敛进度与发现统计。'),
+      React.createElement('span', { className: 'iterate-empty-hint' }, t('运行一次评审后，这里会显示收敛进度与发现统计。')),
       React.createElement(StartIterationButton, null),
     )
   }
@@ -954,15 +1123,15 @@ function ConvergenceDashboard(props: SlotProps) {
     ? React.createElement('span', {
         className: 'iterate-chip-resume',
         key: 'resume',
-        title: '本次迭代从上一次中断的断点继续执行',
-      }, `已中断恢复 ×${String(resumeCount)}`)
+        title: t('本次迭代从上一次中断的断点继续执行'),
+      }, tf(`已中断恢复 ×{a0}`, { a0: String(resumeCount) }))
     : null
   const imageChip = imageCount > 0
     ? React.createElement('span', {
         className: 'iterate-chip-images',
         key: 'images',
-        title: '会话中检测到用户附带的图片，评审将作为视觉证据参考',
-      }, `附件图片 ${String(imageCount)}`)
+        title: t('会话中检测到用户附带的图片，评审将作为视觉证据参考'),
+      }, tf(`附件图片 {a0}`, { a0: String(imageCount) }))
     : null
 
   // Live run-state awareness: surface the transcript's current workflow phase
@@ -976,8 +1145,8 @@ function ConvergenceDashboard(props: SlotProps) {
         key: 'phase',
         'data-live': transcript.active === true ? '' : undefined,
         title: transcript.active === true
-          ? `当前处于「${phase}」阶段（运行中）`
-          : `最近一次执行停留在「${phase}」阶段（已结束）`,
+          ? tf(`当前处于「{a0}」阶段（运行中）`, { a0: phase })
+          : tf(`最近一次执行停留在「{a0}」阶段（已结束）`, { a0: phase }),
       }, `${phase} · ${runStatusText(transcript.active === true, transcript)}`)
     : null
 
@@ -990,7 +1159,7 @@ function ConvergenceDashboard(props: SlotProps) {
         className: 'iterate-chip-taskmode',
         key: 'taskmode',
         'data-mode': taskMode,
-        title: taskMode === 'code' ? '代码模式：直接修改文件' : '迭代模式：审查-修复循环',
+        title: taskMode === 'code' ? t('代码模式：直接修改文件') : t('迭代模式：审查-修复循环'),
       }, taskMode === 'code' ? '● code' : '● iterate')
     : null
 
@@ -1009,7 +1178,7 @@ function ConvergenceDashboard(props: SlotProps) {
       React.createElement(
         'span',
         { key: '+more', className: 'iterate-dim-badge iterate-dim-more', title: dimNames.slice(6).join(', ') },
-        `+${overflow} 更多`,
+        tf(`+{a0} 更多`, { a0: overflow }),
       ),
     )
   }
@@ -1024,7 +1193,7 @@ function ConvergenceDashboard(props: SlotProps) {
     ? React.createElement('span', {
         className: 'iterate-metric',
         key: 'fixes',
-        title: '本轮已应用的原子修复数（正常模式）',
+        title: t('本轮已应用的原子修复数（正常模式）'),
       }, `${String(fixCount)} fixes`)
     : null
 
@@ -1035,8 +1204,8 @@ function ConvergenceDashboard(props: SlotProps) {
     ? React.createElement('span', {
         className: 'iterate-chip-resume',
         key: 'converged',
-        title: '审查已收敛：最后一轮未发现新问题',
-      }, '✓ 已收敛')
+        title: t('审查已收敛：最后一轮未发现新问题'),
+      }, t('✓ 已收敛'))
     : null
 
   const sevMetric = (key: 'critical' | 'high' | 'medium' | 'low', label: string) =>
@@ -1104,14 +1273,14 @@ function StatsCard(props: SlotProps) {
       React.createElement('td', { style: { color: SEVERITY_COLOR.low } }, String(h.low)),
     ),
   )
-  const trendLine = `首轮 ${trend.firstRound} → 末轮 ${trend.lastRound} 项，降幅 ${trend.reductionPercent}%${trend.converged ? '，已收敛' : ''}`
-  const completion = buildCompletionSummary(report)
+  const trendLine = tf(`首轮 {a0} → 末轮 {a1} 项，降幅 {a2}%{a3}`, { a0: trend.firstRound, a1: trend.lastRound, a2: trend.reductionPercent, a3: trend.converged ? t('，已收敛') : '' })
+  const completion = buildCompletionSummary(report, getLang())
 
   return React.createElement('div', { 'data-iterate-root': '', 'data-iterate': 'stats', className: 'iterate-stats' },
     React.createElement('div', { className: 'iterate-triage-head' },
-      React.createElement('span', {}, 'Iterate · 收敛统计'),
+      React.createElement('span', {}, t('Iterate · 收敛统计')),
       React.createElement('span', { className: 'iterate-triage-hint' },
-        `Round ${getCurrentRound(report)}/${getTotalRounds(report)} · ${total} findings · ${report.convergence && report.convergence.converged ? '已收敛' : '未收敛'}`,
+        `Round ${getCurrentRound(report)}/${getTotalRounds(report)} · ${total} findings · ${report.convergence && report.convergence.converged ? t('已收敛') : t('未收敛')}`,
       ),
     ),
     React.createElement('div', { className: 'iterate-stats-grid' }, ...rows),
@@ -1122,15 +1291,15 @@ function StatsCard(props: SlotProps) {
         className: 'iterate-btn',
         'data-primary': showHistory ? '' : undefined,
         onClick: () => setShowHistory((v) => !v),
-      }, showHistory ? '收起历史' : '历史 / 趋势'),
+      }, showHistory ? t('收起历史') : t('历史 / 趋势')),
     ),
     showHistory
       ? React.createElement('div', { className: 'iterate-history-body' },
           React.createElement('table', { className: 'iterate-history-table' },
             React.createElement('thead', {},
               React.createElement('tr', {},
-                React.createElement('th', {}, '轮次'),
-                React.createElement('th', {}, '发现'),
+                React.createElement('th', {}, t('轮次')),
+                React.createElement('th', {}, t('发现')),
                 React.createElement('th', { style: { color: SEVERITY_COLOR.critical } }, 'CRIT'),
                 React.createElement('th', { style: { color: SEVERITY_COLOR.high } }, 'HIGH'),
                 React.createElement('th', { style: { color: SEVERITY_COLOR.medium } }, 'MED'),
@@ -1176,6 +1345,31 @@ function TriagePanel(props: SlotProps) {
   const [selectAll, setSelectAll] = React.useState(false)
   // v3.0: Command mode for native action buttons
   const [cmdCopied, setCmdCopied] = React.useState<string | null>(null)
+  const [cmdFailed, setCmdFailed] = React.useState<string | null>(null)
+  // Audit: pending copy-reset timers must not outlive the panel (a unmounted
+  // setState is a React warning / leaked timer).
+  const cmdTimers = React.useRef<number[]>([])
+  React.useEffect(() => () => {
+    for (const t of cmdTimers.current) clearTimeout(t)
+    cmdTimers.current = []
+  }, [])
+
+  /** Copy + flip `cmdCopied` for 1.6s, or surface `cmdFailed` on clipboard
+   *  denial so the button never looks like a dead control. */
+  const copyWithFeedback = (text: string, key: string) => {
+    copyText(text).then((ok) => {
+      if (ok) {
+        setCmdFailed(null)
+        setCmdCopied(key)
+        cmdTimers.current.push(window.setTimeout(() => setCmdCopied((cur) => (cur === key ? null : cur)), 1600))
+      } else {
+        setCmdCopied(null)
+        setCmdFailed(key)
+        // Fall back to the inline payload box so the text stays copyable by hand.
+        setPayload(text)
+      }
+    })
+  }
 
   /** Persist the verdicts to localStorage whenever they change. Kept OUT of
    *  the state updater (updaters must stay pure — React may double-invoke them
@@ -1263,66 +1457,41 @@ function TriagePanel(props: SlotProps) {
 
   // v3.0: Command handlers for native action buttons
   const doApproveArchitecturalFix = () => {
-    // Architectural findings exceed the atomic threshold, so "approving" one
-    // means telling the model to apply it as a deliberate forced change via
-    // iterate_fix with force:true (is_architectural is not a real parameter).
-    const cmd = '请调用 `iterate_fix`，对本项目剩余架构型 finding 生成修复内容并设置 force: true 应用（架构修复允许超过 atomic 阈值）'
-    copyText(cmd).then((ok) => {
-      if (ok) {
-        setCmdCopied('approve-arch')
-        setTimeout(() => setCmdCopied(null), 1600)
-      }
-    })
+    // Gap #10: `force: true` exists on `iterate_fix`, but the tool still
+    // requires file / content / finding / round — the old copy text implied a
+    // lone force flag was enough. The builder names all four and marks the two
+    // the model must fill in.
+    const cmd = buildArchitecturalFixInstruction(findings as IterateFinding[])
+    if (!cmd) return
+    copyWithFeedback(cmd, 'approve-arch')
   }
 
   const doTriggerNewRound = () => {
-    const cmd = '请继续执行下一轮迭代审查'
-    copyText(cmd).then((ok) => {
-      if (ok) {
-        setCmdCopied('new-round')
-        setTimeout(() => setCmdCopied(null), 1600)
-      }
-    })
+    const cmd = t('请继续执行下一轮迭代审查')
+    copyWithFeedback(cmd, 'new-round')
   }
 
   const doRollbackToCheckpoint = () => {
     // iterate_checkpoint has NO rollback operation (save/load/resume/clear
     // only); reverting applied fixes is done via iterate_rollback by fix id,
     // so the paste-able instruction must point there instead.
-    const cmd = '请回滚上一轮迭代的修复：调用 `iterate_history` 查看本轮 fix id，再用 `iterate_rollback` 逐个撤销这些修复'
-    copyText(cmd).then((ok) => {
-      if (ok) {
-        setCmdCopied('rollback')
-        setTimeout(() => setCmdCopied(null), 1600)
-      }
-    })
+    const cmd = t('请回滚上一轮迭代的修复：调用 `iterate_history` 查看本轮 fix id，再用 `iterate_rollback` 逐个撤销这些修复')
+    copyWithFeedback(cmd, 'rollback')
   }
 
   // v3.1+ §8: assign the currently scoped findings to the model for fixing.
-  // Scoping mirrors the batch buttons (visible when selectAll is off, all
-  // otherwise); produces one paste-able iterate_fix instruction carrying each
-  // finding's file/line/dimension/severity/summary.
+  // Gap #10: `iterate_fix` takes ONE finding + required `content` (full new
+  // file) + required `round` — never an array — so the payload now says so
+  // explicitly instead of handing the model a raw array to translate.
   const doAssignFindings = () => {
     const targetAll = selectAll
     const scopeIndices = targetAll ? allIndices : indices
     const scopeFindings = (findings as IterateFinding[])
       .filter((f, i) => scopeIndices.includes(i))
-      .map((f) => ({
-        file: String(f.file || ''),
-        ...(typeof f.line === 'number' && f.line > 0 ? { line: f.line } : {}),
-        dimension: String(f.dimension || ''),
-        severity: String(f.severity || ''),
-        summary: String(f.summary || ''),
-        ...(f.suggested_fix ? { suggested_fix: String(f.suggested_fix) } : {}),
-      }))
     if (scopeFindings.length === 0) return
-    const cmd = `请调用 \`iterate_fix\` 指派并修复以下 findings：\n\n\`\`\`json\n${JSON.stringify(scopeFindings, null, 2)}\n\`\`\``
-    copyText(cmd).then((ok) => {
-      if (ok) {
-        setCmdCopied('assign')
-        setTimeout(() => setCmdCopied(null), 1600)
-      }
-    })
+    const cmd = buildAssignFixesInstruction(scopeFindings)
+    if (!cmd) return
+    copyWithFeedback(cmd, 'assign')
   }
 
   const doCopyYaml = () => {
@@ -1331,23 +1500,45 @@ function TriagePanel(props: SlotProps) {
     copyText(yaml).then((ok) => {
       if (ok) {
         setCopied(true)
-        setTimeout(() => setCopied(false), 1600)
+        cmdTimers.current.push(window.setTimeout(() => setCopied(false), 1600))
       } else {
         // Copy failed (permissions/unsupported) — reveal the payload as a
         // manual-copy fallback instead of claiming success.
         setPayload(yaml)
+        setCmdFailed('yaml')
       }
     })
   }
 
+  // Gap #7: the SAFE path is `iterate_triage apply` (validation, dedupe,
+  // backup, automatic rollback) — so it is now the primary action, and it
+  // tells the user what happens after they paste.
   const doBuildInstruction = () => {
     const text = buildApplyInstruction(ignored)
+    if (!text) return
+    setPayload(text)
+    copyWithFeedback(text, 'apply')
+  }
+
+  // Gap #7: closing the write-back loop — copying is not writing, so offer a
+  // readback instruction (`iterate_triage list`) to verify what landed.
+  const doReadback = () => {
+    const text = buildTriageReadbackInstruction()
     setPayload(text)
-    if (text) copyText(text)
+    copyWithFeedback(text, 'readback')
   }
 
-  const rows = (filtered as IterateFinding[]).map((finding, i) => {
-    const index = indices[i] as number
+  // Audit: `filtered` and `indices` are produced together, but an
+  // out-of-range slot would otherwise render a row keyed `undefined` whose
+  // verdict writes to `verdicts["undefined"]`. Pair them up-front so the
+  // mapping index can never drift from the original findings index.
+  const rowPairs: Array<{ index: number; finding: IterateFinding }> = []
+  for (let i = 0; i < filtered.length; i++) {
+    const idx = indices[i]
+    const f = filtered[i]
+    if (typeof idx === 'number' && f) rowPairs.push({ index: idx, finding: f as IterateFinding })
+  }
+  const rows = rowPairs.map(({ index, finding }) => {
     const severity = finding.severity || 'low'
     const verdict = verdicts[String(index)] || 'keep'
     const isSelected = selected === index
@@ -1386,27 +1577,27 @@ function TriagePanel(props: SlotProps) {
       ),
       React.createElement('div', { className: 'iterate-finding-summary' }, String(finding.summary || '')),
       React.createElement('div', { className: 'iterate-finding-actions' },
-        btn('y 修复', 'keep', '保留该 finding，进入修复'),
-        btn('n 跳过', 'skip', '跳过该 finding'),
-        btn('a 已知有意', 'ignore', '标记为已知有意并写入 known_intentional'),
+        btn(t('y 修复'), 'keep', t('保留该 finding，进入修复')),
+        btn(t('n 跳过'), 'skip', t('跳过该 finding')),
+        btn(t('a 已知有意'), 'ignore', t('标记为已知有意并写入 known_intentional')),
       ),
     )
   })
 
   return React.createElement('div', { 'data-iterate-root': '', 'data-iterate': 'triage', className: 'iterate-triage' },
     React.createElement('div', { className: 'iterate-triage-head' },
-      React.createElement('span', { role: 'heading', 'aria-level': 3 }, `Iterate · Findings 分诊 (${filtered.length}/${findings.length})`),
-      React.createElement('span', { className: 'iterate-triage-hint' }, 'y=修复 · n=跳过 · a=已知有意 · ↑/↓ 选择'),
+      React.createElement('span', { role: 'heading', 'aria-level': 3 }, tf(`Iterate · Findings 分诊 ({a0}/{a1})`, { a0: filtered.length, a1: findings.length })),
+      React.createElement('span', { className: 'iterate-triage-hint' }, t('y=修复 · n=跳过 · a=已知有意 · ↑/↓ 选择')),
     ),
     React.createElement('div', { className: 'iterate-filter' },
-      React.createElement('select', { className: 'iterate-filter-select', value: filter.severities[0] || '', onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setSeverityFilter(e.target.value), 'aria-label': '按严重度筛选' },
-        React.createElement('option', { value: '' }, '全部严重度'),
+      React.createElement('select', { className: 'iterate-filter-select', value: filter.severities[0] || '', onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setSeverityFilter(e.target.value), 'aria-label': t('按严重度筛选') },
+        React.createElement('option', { value: '' }, t('全部严重度')),
         ...options.severities.map((s) =>
           React.createElement('option', { key: s.value, value: s.value }, `${severityLabel(s.value)} (${s.count})`),
         ),
       ),
-      React.createElement('select', { className: 'iterate-filter-select', value: filter.dimensions[0] || '', onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setDimensionFilter(e.target.value), 'aria-label': '按维度筛选' },
-        React.createElement('option', { value: '' }, '全部维度'),
+      React.createElement('select', { className: 'iterate-filter-select', value: filter.dimensions[0] || '', onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setDimensionFilter(e.target.value), 'aria-label': t('按维度筛选') },
+        React.createElement('option', { value: '' }, t('全部维度')),
         ...options.dimensions.map((d) =>
           React.createElement('option', { key: d.value, value: d.value }, `${d.value} (${d.count})`),
         ),
@@ -1414,74 +1605,105 @@ function TriagePanel(props: SlotProps) {
       React.createElement('input', {
         className: 'iterate-filter-search',
         type: 'search',
-        placeholder: '搜索文件 / 摘要…',
-        'aria-label': '搜索文件或摘要',
+        placeholder: t('搜索文件 / 摘要…'),
+        'aria-label': t('搜索文件或摘要'),
         value: filter.search,
         onChange: (e: React.ChangeEvent<HTMLInputElement>) => setSearchFilter(e.target.value),
       }),
       React.createElement('span', { className: 'iterate-filter-count' },
         isFilterActive
-          ? React.createElement('button', { className: 'iterate-batch-btn', onClick: clearFilter }, `清除筛选（显示 ${filtered.length}）`)
-          : `共 ${findings.length} 项`,
+          ? React.createElement('button', { className: 'iterate-batch-btn', onClick: clearFilter }, tf(`清除筛选（显示 {a0}）`, { a0: filtered.length }))
+          : tf(`共 {a0} 项`, { a0: findings.length }),
       ),
     ),
     React.createElement('div', { className: 'iterate-batch' },
-      React.createElement('span', { className: 'iterate-batch-label' }, '批量作用于：'),
+      React.createElement('span', { className: 'iterate-batch-label' }, t('批量作用于：')),
       React.createElement('button', {
         className: selectAll ? 'iterate-batch-btn iterate-batch-scope' : 'iterate-batch-btn iterate-batch-scope iterate-batch-scope-on',
         onClick: () => setSelectAll(false),
-        title: '批量按钮仅作用于当前筛选可见的 findings',
-      }, `可见 ${indices.length}`),
+        title: t('批量按钮仅作用于当前筛选可见的 findings'),
+      }, tf(`可见 {a0}`, { a0: indices.length })),
       React.createElement('button', {
         className: selectAll ? 'iterate-batch-btn iterate-batch-scope iterate-batch-scope-on' : 'iterate-batch-btn iterate-batch-scope',
         onClick: () => setSelectAll(true),
-        title: '批量按钮作用于全部 findings',
-      }, `全部 ${allIndices.length}`),
+        title: t('批量按钮作用于全部 findings'),
+      }, tf(`全部 {a0}`, { a0: allIndices.length })),
       React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('keep') }, 'y'),
       React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('skip') }, 'n'),
       React.createElement('button', { className: 'iterate-batch-btn', onClick: () => applyBatch('ignore') }, 'a'),
-      React.createElement('button', { className: 'iterate-batch-btn', onClick: doResetVerdicts, title: '把所有判定恢复为默认 y（修复）' }, '重置'),
+      React.createElement('button', { className: 'iterate-batch-btn', onClick: doResetVerdicts, title: t('把所有判定恢复为默认 y（修复）') }, t('重置')),
     ),
     ...rows,
     React.createElement('div', { className: 'iterate-triage-foot' },
-      React.createElement('span', {}, `y ${counts.keep} · n ${counts.skip} · a ${counts.ignore} · 待写回 known_intentional：${ignoredCount} 条`),
-      React.createElement('span', { style: { display: 'flex', gap: 6 } },
+      React.createElement('span', {}, tf(`y {a0} · n {a1} · a {a2} · 待写回 known_intentional：{a3} 条`, { a0: counts.keep, a1: counts.skip, a2: counts.ignore, a3: ignoredCount })),
+      React.createElement('span', { style: { display: 'flex', gap: 6, flexWrap: 'wrap' } },
+        // Gap #7: the apply instruction (safe path) is PRIMARY; the raw YAML
+        // is demoted to an explicit "just the snippet" escape hatch.
+        React.createElement('button', {
+          className: 'iterate-btn', 'data-primary': '',
+          'data-copied': cmdCopied === 'apply' ? '' : undefined,
+          'data-failed': cmdFailed === 'apply' ? '' : undefined,
+          onClick: doBuildInstruction, disabled: ignoredCount === 0,
+          title: ignoredCount === 0
+            ? t('当前没有标记为「已知有意」的 finding')
+            : t('复制应用指令：粘贴后模型会调用 iterate_triage apply（校验、去重、写入前备份、失败自动回滚）'),
+        }, cmdCopied === 'apply' ? t('已复制') : cmdFailed === 'apply' ? t('复制失败') : tf(`生成应用指令{a0}`, { a0: ignoredCount > 0 ? `（${ignoredCount}）` : '' })),
         React.createElement('button', {
-          className: 'iterate-btn', 'data-primary': '', 'data-copied': copied ? '' : undefined,
+          className: 'iterate-btn',
+          'data-copied': copied ? '' : undefined,
+          'data-failed': cmdFailed === 'yaml' ? '' : undefined,
           onClick: doCopyYaml, disabled: ignoredCount === 0,
-          title: ignoredCount === 0 ? '当前没有标记为「已知有意」的 finding' : '复制 known_intentional YAML',
-        }, copied ? '已复制' : `复制 known_intentional${ignoredCount > 0 ? `（${ignoredCount}）` : ''}`),
+          title: ignoredCount === 0
+            ? t('当前没有标记为「已知有意」的 finding')
+            : t('只复制 known_intentional YAML 片段（需自行粘到 iterate.config.yaml 的 personalization.known_intentional 下）'),
+        }, copied ? t('已复制') : cmdFailed === 'yaml' ? t('复制失败') : t('仅复制 YAML 片段')),
         React.createElement('button', {
-          className: 'iterate-btn', onClick: doBuildInstruction, disabled: ignoredCount === 0,
-          title: ignoredCount === 0 ? '当前没有标记为「已知有意」的 finding' : '生成 iterate_triage 应用指令',
-        }, '生成应用指令'),
+          className: 'iterate-btn',
+          'data-copied': cmdCopied === 'readback' ? '' : undefined,
+          'data-failed': cmdFailed === 'readback' ? '' : undefined,
+          onClick: doReadback,
+          title: t('复制 iterate_triage list 指令，核对已经写入的 known_intentional 条目（写回闭环确认）'),
+        }, cmdCopied === 'readback' ? t('已复制') : cmdFailed === 'readback' ? t('复制失败') : t('回读已写入条目')),
       ),
+      cmdCopied === 'apply'
+        ? React.createElement('span', { className: 'iterate-triage-hint', role: 'status' }, t('已复制应用指令——粘贴回会话，模型将调用 iterate_triage apply 并回报写入条数。'))
+        : cmdCopied === 'readback'
+          ? React.createElement('span', { className: 'iterate-triage-hint', role: 'status' }, t('已复制回读指令——粘贴回会话可列出当前已写入的 known_intentional。'))
+          : null,
     ),
     // v3.0: Command buttons for native actions (§8)
     React.createElement('div', { className: 'iterate-triage-foot', style: { borderTop: '1px solid var(--dsw-alias-border-l1)' } },
-      React.createElement('span', { style: { fontSize: 11, fontWeight: 600, color: 'var(--dsw-alias-label-secondary)' } }, '指挥操作'),
-      React.createElement('span', { style: { display: 'flex', gap: 6 } },
+      React.createElement('span', { style: { fontSize: 11, fontWeight: 600, color: 'var(--dsw-alias-label-secondary)' } }, t('指挥操作')),
+      React.createElement('span', { style: { display: 'flex', gap: 6, flexWrap: 'wrap' } },
         React.createElement('button', {
-          className: 'iterate-cmd', 'data-primary': '', 'data-copied': cmdCopied === 'approve-arch' ? '' : undefined,
+          className: 'iterate-cmd', 'data-primary': '',
+          'data-copied': cmdCopied === 'approve-arch' ? '' : undefined,
+          'data-failed': cmdFailed === 'approve-arch' ? '' : undefined,
           onClick: doApproveArchitecturalFix,
-          title: '批准架构修复（复制指令文本）',
-        }, cmdCopied === 'approve-arch' ? '已复制' : '批准架构修复'),
+          title: t('批准架构修复（复制指令文本：iterate_fix force:true，含全部必填参数）'),
+        }, cmdCopied === 'approve-arch' ? t('已复制') : cmdFailed === 'approve-arch' ? t('复制失败') : t('批准架构修复')),
         React.createElement('button', {
-          className: 'iterate-cmd', 'data-copied': cmdCopied === 'new-round' ? '' : undefined,
+          className: 'iterate-cmd',
+          'data-copied': cmdCopied === 'new-round' ? '' : undefined,
+          'data-failed': cmdFailed === 'new-round' ? '' : undefined,
           onClick: doTriggerNewRound,
-          title: '触发新一轮迭代审查',
-        }, cmdCopied === 'new-round' ? '已复制' : '触发新一轮'),
+          title: t('触发新一轮迭代审查'),
+        }, cmdCopied === 'new-round' ? t('已复制') : cmdFailed === 'new-round' ? t('复制失败') : t('触发新一轮')),
         React.createElement('button', {
-          className: 'iterate-cmd', 'data-primary': '', 'data-copied': cmdCopied === 'assign' ? '' : undefined,
+          className: 'iterate-cmd', 'data-primary': '',
+          'data-copied': cmdCopied === 'assign' ? '' : undefined,
+          'data-failed': cmdFailed === 'assign' ? '' : undefined,
           onClick: doAssignFindings,
           disabled: (selectAll ? allIndices : indices).length === 0,
-          title: selectAll ? `指派全部 ${allIndices.length} 个 findings 修复` : `指派当前可见 ${indices.length} 个 findings 修复`,
-        }, cmdCopied === 'assign' ? '已复制' : '指派修复'),
+          title: selectAll ? tf(`指派全部 {a0} 个 findings 修复（逐个 iterate_fix）`, { a0: allIndices.length }) : tf(`指派当前可见 {a0} 个 findings 修复（逐个 iterate_fix）`, { a0: indices.length }),
+        }, cmdCopied === 'assign' ? t('已复制') : cmdFailed === 'assign' ? t('复制失败') : t('指派修复')),
         React.createElement('button', {
-          className: 'iterate-cmd', 'data-danger': '', 'data-copied': cmdCopied === 'rollback' ? '' : undefined,
+          className: 'iterate-cmd', 'data-danger': '',
+          'data-copied': cmdCopied === 'rollback' ? '' : undefined,
+          'data-failed': cmdFailed === 'rollback' ? '' : undefined,
           onClick: doRollbackToCheckpoint,
-          title: '回滚到上一个检查点',
-        }, cmdCopied === 'rollback' ? '已复制' : '回滚检查点'),
+          title: t('回滚到上一个检查点'),
+        }, cmdCopied === 'rollback' ? t('已复制') : cmdFailed === 'rollback' ? t('复制失败') : t('回滚检查点')),
       ),
     ),
     payload
@@ -1504,15 +1726,15 @@ function VerdictBanner(props: SlotProps) {
     'div',
     { 'data-iterate-root': '', 'data-iterate': 'verdict', className: 'iterate-verdict' },
     React.createElement('span', { className: 'iterate-verdict-tag', 'data-ok': ok ? '' : undefined, 'data-warn': ok ? undefined : '' },
-      ok ? '报告已批准' : '报告需修订'),
+      ok ? t('报告已批准') : t('报告需修订')),
     React.createElement('span', { className: 'iterate-verdict-detail' },
-      item(verdict.totalFindings, '项发现'),
-      item(verdict.totalRounds, '轮'),
-      item(verdict.checksRun, '项审查'),
+      item(verdict.totalFindings, t('项发现')),
+      item(verdict.totalRounds, t('轮')),
+      item(verdict.checksRun, t('项审查')),
       ok
-        ? phrase('报告通过全部一致性检查')
-        : item(verdict.reportIssues, '处报告缺陷'),
-      phrase(verdict.converged ? '已收敛' : '未收敛'),
+        ? phrase(t('报告通过全部一致性检查'))
+        : item(verdict.reportIssues, t('处报告缺陷')),
+      phrase(verdict.converged ? t('已收敛') : t('未收敛')),
     ),
   )
 }
@@ -1561,7 +1783,7 @@ function ProgressCapsule() {
     const listener = (payload: { round: number; converged: boolean }) => {
       const converged = payload && payload.converged === true
       const round = payload && typeof payload.round === 'number' ? payload.round : '?'
-      setInfo({ text: converged ? `Round ${round} 完成 · 已收敛` : `Round ${round} 完成`, ok: converged })
+      setInfo({ text: converged ? tf(`Round {a0} 完成 · 已收敛`, { a0: round }) : tf(`Round {a0} 完成`, { a0: round }), ok: converged })
       if (timer) clearTimeout(timer)
       // Converged notifications stay a bit longer.
       timer = setTimeout(() => setInfo(null), converged ? 3600 : 2400)
@@ -1584,7 +1806,17 @@ function ProgressCapsule() {
 }
 
 /** Settings page section (root scope; reads localStorage + latest known data). */
-function SettingsPanel(_props: SlotProps) {
+function SettingsPanel(props: SlotProps) {
+  // Re-render on a language switch (the slot wrapper covers the tree; this
+  // keeps the panel honest even if it is ever rendered directly).
+  const lang = useLang()
+  // Root-scoped slot: the host renders settings OUTSIDE the session scope, so
+  // take the session the session-scoped slots published (a host that does pass
+  // `props.session` wins). This is what makes the config read-back visible.
+  // The hook is called UNCONDITIONALLY — a conditional hook would break the
+  // panel as soon as a host started passing `props.session`.
+  const cachedSession = useSessionSnapshot()
+  const session = props && props.session ? props.session : cachedSession
   const [enabled, setEnabled] = React.useState(themeEnabled)
   const [guideCopied, setGuideCopied] = React.useState(false)
   const [statusCopied, setStatusCopied] = React.useState(false)
@@ -1592,9 +1824,37 @@ function SettingsPanel(_props: SlotProps) {
   const [showStatus, setShowStatus] = React.useState(false)
   const [confirming, setConfirming] = React.useState(false)
   const [clearedInfo, setClearedInfo] = React.useState<number | null>(null)
+  // Gap #8: "pick a field → generate an iterate_config write instruction".
+  // Defaults to validation.commands, the field the old guide omitted entirely
+  // (and the root cause of the zero-verification P0).
+  const [cfgField, setCfgField] = React.useState<string>(
+    () => (CONFIG_EDIT_FIELDS.some((f) => f.key === 'validation.commands') ? 'validation.commands' : (CONFIG_EDIT_FIELDS[0]?.key ?? 'goal')),
+  )
+  const [cfgCopied, setCfgCopied] = React.useState(false)
+  const [cfgFailed, setCfgFailed] = React.useState(false)
+  const [cfgText, setCfgText] = React.useState<string | null>(null)
+  // Gap #1 (3.7.0): the read half of the write -> read-back loop.
+  const [cfgReadCopied, setCfgReadCopied] = React.useState(false)
+  const [cfgReadText, setCfgReadText] = React.useState<string | null>(null)
+  const [pullCopied, setPullCopied] = React.useState(false)
+  const [copyError, setCopyError] = React.useState<'guide' | 'status' | 'pull' | 'cfgRead' | null>(null)
   const guide = buildConfigEditGuide()
   const statusGuide = buildRuntimeStatusGuide()
 
+  // What the config actually says right now: latest `iterate_config` result
+  // echoed into the session, then the value of the field being edited.
+  const cfgMeta = configFieldByKey(cfgField)
+  const cfgRead = scanSessionForConfigRead(session)
+  const cfgCurrent = cfgRead ? configValueByPath(cfgRead, cfgField) : null
+  const cfgFieldLabel = cfgMeta ? cfgMeta.label[getLang()] : cfgField
+
+  // Audit: don't leak flash timers across settings unmounts.
+  const cfgTimers = React.useRef<number[]>([])
+  React.useEffect(() => () => {
+    for (const t of cfgTimers.current) clearTimeout(t)
+    cfgTimers.current = []
+  }, [])
+
   const toggleTheme = () => {
     const next = !enabled
     setEnabled(next)
@@ -1602,54 +1862,84 @@ function SettingsPanel(_props: SlotProps) {
   }
 
   /** Flash a per-slot "已复制" state for the given duration. */
-  const flashCopied = (slot: 'guide' | 'status') => {
-    const setter = slot === 'guide' ? setGuideCopied : setStatusCopied
+  const flashCopied = (slot: 'guide' | 'status' | 'pull' | 'cfgRead') => {
+    const setter =
+      slot === 'guide' ? setGuideCopied : slot === 'status' ? setStatusCopied : slot === 'pull' ? setPullCopied : setCfgReadCopied
     setter(true)
-    setTimeout(() => setter(false), 1600)
+    cfgTimers.current.push(window.setTimeout(() => setter(false), 1600))
   }
 
-  /** Copy a guide/status block; flash success only when it actually copied. */
-  const doCopy = (text: string, slot: 'guide' | 'status') => {
+  /** Copy a guide/status block; flash success only when it actually copied,
+   *  and surface a visible error when the clipboard write is refused (the old
+   *  behaviour was a silent no-op, which reads as a broken button). */
+  const doCopy = (text: string, slot: 'guide' | 'status' | 'pull' | 'cfgRead') => {
     copyText(text).then((ok) => {
+      setCopyError(ok ? null : slot)
       if (ok) flashCopied(slot)
     })
   }
 
+  /** Gap #8: build + copy the write instruction for the selected field. */
+  const doBuildConfigInstruction = () => {
+    const text = buildConfigFieldInstruction(cfgField)
+    setCfgText(text)
+    copyText(text).then((ok) => {
+      setCfgFailed(!ok)
+      setCfgCopied(ok)
+      cfgTimers.current.push(window.setTimeout(() => setCfgCopied(false), 1600))
+      // On failure the raw text stays on screen for a manual copy.
+      if (!ok) return
+    })
+  }
+
+  /** Copy the read-back instruction; a refused clipboard reveals it below. */
+  const doCopyConfigRead = () => {
+    const text = buildConfigReadInstruction()
+    copyText(text).then((ok) => {
+      setCopyError(ok ? null : 'cfgRead')
+      if (ok) {
+        flashCopied('cfgRead')
+        return
+      }
+      setCfgReadText(text)
+    })
+  }
+
   /** Two-step destroy guard: first click arms, second click clears. */
   const requestClear = () => {
     if (confirming) {
       const count = removeStorageByPrefix(TRIAGE_STORAGE_PREFIX)
       setClearedInfo(count)
       setConfirming(false)
-      setTimeout(() => setClearedInfo(null), 3000)
+      cfgTimers.current.push(window.setTimeout(() => setClearedInfo(null), 3000))
       return
     }
     setConfirming(true)
-    setTimeout(() => setConfirming(false), 3000)
+    cfgTimers.current.push(window.setTimeout(() => setConfirming(false), 3000))
   }
 
   const clearButton = clearedInfo !== null
-    ? React.createElement('button', { className: 'iterate-btn', 'data-copied': '', disabled: true }, `已清除 ${clearedInfo} 条`)
+    ? React.createElement('button', { className: 'iterate-btn', 'data-copied': '', disabled: true }, tf(`已清除 {a0} 条`, { a0: clearedInfo }))
     : React.createElement('button', {
         className: 'iterate-btn',
         'data-danger': confirming ? undefined : '',
         'data-confirm': confirming ? '' : undefined,
         onClick: requestClear,
-        title: confirming ? '再次点击以确认清除全部判定' : '清除所有分诊判定记录（需要二次确认）',
-      }, confirming ? '确认清除？' : '清除分诊')
+        title: confirming ? t('再次点击以确认清除全部判定') : t('清除所有分诊判定记录（需要二次确认）'),
+      }, confirming ? t('确认清除？') : t('清除分诊'))
 
   const themeCard = React.createElement('div', { key: 'theme', className: 'iterate-scard' },
     React.createElement('div', { className: 'iterate-scard-head' },
       React.createElement('div', {},
-        React.createElement('div', { className: 'iterate-settings-title' }, '迭代主题'),
-        React.createElement('div', { className: 'iterate-settings-desc' }, '启用暖琥珀配色的 iterate 专属皮肤，覆盖 dsh 默认主题令牌。'),
+        React.createElement('div', { className: 'iterate-settings-title' }, t('迭代主题')),
+        React.createElement('div', { className: 'iterate-settings-desc' }, t('启用暖琥珀配色的 iterate 专属皮肤，覆盖 dsh 默认主题令牌。')),
       ),
       React.createElement('div', { className: 'iterate-scard-actions' },
-        React.createElement('span', { className: 'iterate-chip', 'data-ok': enabled ? '' : undefined }, enabled ? '已启用' : '已关闭'),
+        React.createElement('span', { className: 'iterate-chip', 'data-ok': enabled ? '' : undefined }, enabled ? t('已启用') : t('已关闭')),
         React.createElement('button', {
           role: 'switch',
           'aria-checked': enabled,
-          'aria-label': '开关 iterate 主题',
+          'aria-label': t('开关 iterate 主题'),
           className: 'iterate-switch',
           'data-on': enabled ? '' : undefined,
           onClick: toggleTheme,
@@ -1658,14 +1948,36 @@ function SettingsPanel(_props: SlotProps) {
     ),
   )
 
+  const langCard = React.createElement('div', { key: 'lang', className: 'iterate-scard' },
+    React.createElement('div', { className: 'iterate-scard-head' },
+      React.createElement('div', {},
+        React.createElement('div', { className: 'iterate-settings-title' }, t('界面语言')),
+        React.createElement('div', { className: 'iterate-settings-desc' },
+          t('面板文案的显示语言；复制给模型的指令保持中文，与 SKILL.md 的工作流契约一致。'),
+        ),
+      ),
+      React.createElement('div', { className: 'iterate-scard-actions' },
+        React.createElement('span', { className: 'iterate-chip', 'data-ok': '' }, LANG_NAMES[lang]),
+        React.createElement('button', {
+          role: 'switch',
+          'aria-checked': lang === 'en',
+          'aria-label': t('切换界面语言'),
+          className: 'iterate-switch',
+          'data-on': lang === 'en' ? '' : undefined,
+          onClick: () => setLang(lang === 'en' ? 'zh' : 'en'),
+        }, React.createElement('span', { className: 'iterate-switch-knob' })),
+      ),
+    ),
+  )
+
   const dataCard = React.createElement('div', { key: 'data', className: 'iterate-scard' },
     React.createElement('div', { className: 'iterate-scard-head' },
       React.createElement('div', {},
-        React.createElement('div', { className: 'iterate-settings-title' }, '分诊持久化'),
-        React.createElement('div', { className: 'iterate-settings-desc' }, 'y / n / a 判定保存在本地浏览器（localStorage），刷新会话后仍保留。'),
+        React.createElement('div', { className: 'iterate-settings-title' }, t('分诊持久化')),
+        React.createElement('div', { className: 'iterate-settings-desc' }, t('y / n / a 判定保存在本地浏览器（localStorage），刷新会话后仍保留。')),
       ),
       React.createElement('div', { className: 'iterate-scard-actions' },
-        React.createElement('span', { className: 'iterate-chip' }, '本地保存'),
+        React.createElement('span', { className: 'iterate-chip' }, t('本地保存')),
         clearButton,
       ),
     ),
@@ -1674,19 +1986,85 @@ function SettingsPanel(_props: SlotProps) {
   const guideCard = React.createElement('div', { key: 'guide', className: 'iterate-scard' },
     React.createElement('div', { className: 'iterate-scard-head' },
       React.createElement('div', {},
-        React.createElement('div', { className: 'iterate-settings-title' }, '配置管理'),
-        React.createElement('div', { className: 'iterate-settings-desc' }, '目标 / 维度 / 最大轮数写在项目的 iterate.config.yaml，复制指引可让模型按需调整。'),
+        React.createElement('div', { className: 'iterate-settings-title' }, t('配置管理')),
+        React.createElement('div', { className: 'iterate-settings-desc' }, t('目标 / 维度 / 最大轮数 / validation.commands 写在项目的 iterate.config.yaml，复制指引可让模型按需调整。')),
       ),
       React.createElement('div', { className: 'iterate-scard-actions' },
-        React.createElement('button', { className: 'iterate-btn', 'data-primary': '', 'data-copied': guideCopied ? '' : undefined, onClick: () => doCopy(guide, 'guide') }, guideCopied ? '已复制' : '复制指引'),
-        React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => setShowGuide((v) => !v) }, showGuide ? '收起' : '展开'),
+        React.createElement('button', { className: 'iterate-btn', 'data-primary': '', 'data-copied': guideCopied ? '' : undefined, onClick: () => doCopy(guide, 'guide') }, guideCopied ? t('已复制') : t('复制指引')),
+        React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => setShowGuide((v) => !v) }, showGuide ? t('收起') : t('展开')),
       ),
     ),
+    // Gap #8: wire up the previously-dead `buildConfigFieldInstruction` — pick
+    // a field, generate the `iterate_config` write payload for it, paste it to
+    // the model. `validation.commands` is the default selection.
+    React.createElement('div', { className: 'iterate-guide-bar', style: { marginTop: 8, flexWrap: 'wrap' } },
+      React.createElement('select', {
+        className: 'iterate-filter-select',
+        value: cfgField,
+        'aria-label': t('选择要修改的配置字段'),
+        onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setCfgField(e.target.value),
+      },
+        ...CONFIG_EDIT_FIELDS.map((f) =>
+          React.createElement('option', { key: f.key, value: f.key }, getLang() === 'en' ? `${f.label.en} (${f.key})` : `${f.label.zh}（${f.key}）`),
+        ),
+      ),
+      React.createElement('span', { className: 'iterate-settings-desc' },
+        cfgMeta?.hint[getLang()] ?? '',
+      ),
+      React.createElement('button', {
+        className: 'iterate-btn', 'data-primary': '',
+        'data-copied': cfgCopied ? '' : undefined,
+        'data-failed': cfgFailed ? '' : undefined,
+        onClick: doBuildConfigInstruction,
+        title: t('生成并复制该字段的 iterate_config 写入指令（写入前自动备份、失败自动回滚）'),
+      }, cfgCopied ? t('已复制') : cfgFailed ? t('复制失败') : t('生成写入指令')),
+      cfgFailed
+        ? React.createElement('span', { className: 'iterate-settings-desc' }, t('剪贴板被拒绝——指令已展示在下方，请手动复制。'))
+        : null,
+    ),
+    // Gap #1 (3.7.0): close the write -> read-back loop. Three honest states:
+    // nothing echoed yet, the value the model read back, or a read-back that
+    // never contained this field (defaults are in play — say so, don't blank).
+    React.createElement('div', { className: 'iterate-guide-bar', style: { marginTop: 8, flexWrap: 'wrap' } },
+      React.createElement('span', { className: 'iterate-settings-desc' },
+        !cfgRead
+          ? t('尚未回读当前配置——点「回读当前配置」复制指令发给模型，回显后即可在此看到当前值。')
+          : cfgCurrent && cfgCurrent.resolved
+            ? tf('当前值 {a0}：{a1}', { a0: cfgFieldLabel, a1: formatConfigValue(cfgCurrent.value) })
+            : tf('回读结果中没有 {a0}（该字段可能尚未写入配置文件）。', { a0: cfgFieldLabel }),
+      ),
+      React.createElement('button', {
+        className: 'iterate-btn',
+        'data-primary': '',
+        'data-copied': cfgReadCopied ? '' : undefined,
+        onClick: doCopyConfigRead,
+        title: t('复制回读指令：让模型调用 iterate_config(operation:"read") 并回显结果'),
+      }, cfgReadCopied ? t('已复制') : t('回读当前配置')),
+    ),
+    cfgReadText
+      ? React.createElement('div', { className: 'iterate-guide' },
+          React.createElement('div', { className: 'iterate-guide-bar' },
+            React.createElement('span', {}, t('回读指令（粘贴给模型）')),
+            React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => doCopy(cfgReadText, 'cfgRead') }, t('复制')),
+          ),
+          React.createElement('div', { className: 'iterate-guide-body' }, cfgReadText),
+        )
+      : null,
+    cfgText
+      ? React.createElement('div', { className: 'iterate-guide' },
+          React.createElement('div', { className: 'iterate-guide-bar' },
+            React.createElement('span', {}, t('写入指令（粘贴给模型）')),
+            React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => doCopy(cfgText, 'guide') }, t('复制')),
+          ),
+          React.createElement('div', { className: 'iterate-guide-body' }, cfgText),
+        )
+      : null,
     showGuide
       ? React.createElement('div', { className: 'iterate-guide' },
           React.createElement('div', { className: 'iterate-guide-bar' },
-            React.createElement('span', {}, 'iterate.config.yaml 可编辑字段'),
-            React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => doCopy(guide, 'guide') }, '复制'),
+            React.createElement('span', {}, t('iterate.config.yaml 可编辑字段')),
+            React.createElement('span', { className: 'iterate-chip' }, t('中文（粘贴给模型的契约文案）')),
+            React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => doCopy(guide, 'guide') }, t('复制')),
           ),
           React.createElement('div', { className: 'iterate-guide-body' }, guide),
         )
@@ -1696,19 +2074,27 @@ function SettingsPanel(_props: SlotProps) {
   const statusCard = React.createElement('div', { key: 'status', className: 'iterate-scard' },
     React.createElement('div', { className: 'iterate-scard-head' },
       React.createElement('div', {},
-        React.createElement('div', { className: 'iterate-settings-title' }, '状态概览'),
-        React.createElement('div', { className: 'iterate-settings-desc' }, '查看运行时产物布局与清理指引。iterate_status / iterate_history / iterate_prune 工具用于查看和管理。'),
+        React.createElement('div', { className: 'iterate-settings-title' }, t('状态概览')),
+        React.createElement('div', { className: 'iterate-settings-desc' }, t('查看运行时产物布局与清理指引。iterate_status / iterate_history / iterate_prune 工具用于查看和管理。')),
       ),
       React.createElement('div', { className: 'iterate-scard-actions' },
-        React.createElement('button', { className: 'iterate-btn', 'data-primary': '', 'data-copied': statusCopied ? '' : undefined, onClick: () => doCopy(statusGuide, 'status') }, statusCopied ? '已复制' : '复制指引'),
-        React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => setShowStatus((v) => !v) }, showStatus ? '收起' : '展开'),
+        React.createElement('button', { className: 'iterate-btn', 'data-primary': '', 'data-copied': statusCopied ? '' : undefined, onClick: () => doCopy(statusGuide, 'status') }, statusCopied ? t('已复制') : t('复制指引')),
+        // Gap #4: RUNTIME_ARTIFACTS stops being documentation-only — this
+        // copies the instruction that makes the model echo those artifacts
+        // into the session so the observatory panels can read them.
+        React.createElement('button', {
+          className: 'iterate-btn', 'data-copied': pullCopied ? '' : undefined,
+          onClick: () => doCopy(buildDiskSnapshotInstruction(), 'pull'),
+        }, pullCopied ? t('已复制') : t('拉取磁盘快照')),
+        React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => setShowStatus((v) => !v) }, showStatus ? t('收起') : t('展开')),
       ),
     ),
     showStatus
       ? React.createElement('div', { className: 'iterate-guide' },
           React.createElement('div', { className: 'iterate-guide-bar' },
-            React.createElement('span', {}, '运行时布局与清理'),
-            React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => doCopy(statusGuide, 'status') }, '复制'),
+            React.createElement('span', {}, t('运行时布局与清理')),
+            React.createElement('span', { className: 'iterate-chip' }, t('中文（粘贴给模型的契约文案）')),
+            React.createElement('button', { className: 'iterate-btn', 'data-ghost': '', onClick: () => doCopy(statusGuide, 'status') }, t('复制')),
           ),
           React.createElement('div', { className: 'iterate-guide-body' }, statusGuide),
         )
@@ -1719,18 +2105,26 @@ function SettingsPanel(_props: SlotProps) {
     React.createElement('div', { className: 'iterate-scard-head' },
       React.createElement('div', {},
         React.createElement('div', { className: 'iterate-settings-title' }, 'iterate'),
-        React.createElement('div', { className: 'iterate-settings-desc' }, '为每次代码评审生成 Review 报告与交互式分诊视图，专注 AI 自我审查与修正。'),
+        React.createElement('div', { className: 'iterate-settings-desc' }, t('为每次代码评审生成 Review 报告与交互式分诊视图，专注 AI 自我审查与修正。')),
       ),
       React.createElement('span', { className: 'iterate-pill' },
         React.createElement('span', { className: 'iterate-pill-dot' }),
-        '就绪',
+        t('就绪'),
       ),
     ),
   )
 
   return React.createElement('div', { 'data-iterate-root': '', 'data-iterate': 'settings', className: 'iterate-settings' },
-    React.createElement('div', { className: 'iterate-settings-title', style: { fontSize: 15, fontWeight: 700 } }, 'iterate 设置'),
+    React.createElement('div', { className: 'iterate-settings-title', style: { fontSize: 15, fontWeight: 700 } }, t('iterate 设置')),
     banner,
+    copyError
+      ? React.createElement('div', { key: 'copy-err', className: 'iterate-scard', role: 'alert' },
+          React.createElement('div', { className: 'iterate-settings-desc' },
+            t('剪贴板写入被拒绝，复制未生效——请展开对应区块手动选中文本复制。'),
+          ),
+        )
+      : null,
+    langCard,
     themeCard,
     dataCard,
     guideCard,
@@ -1740,36 +2134,63 @@ function SettingsPanel(_props: SlotProps) {
 
 // ─── Runtime observatory panel (F1–F7) ──────────────────────────────────────
 
-/** Tab id → label for the observatory's eight panels. Live (real-time activity
- * stream) is first so it is the default view; F-panels follow. */
+/** Tab id → label for the observatory's eleven panels. Live (real-time
+ *  activity stream) is first so it is the default view; F-panels follow.
+ *  Gap #14: labels carry the "Fn" number used everywhere else (README,
+ *  code comments, the copy instructions), so the docs and the UI line up. */
+/** Visible labels per tab, per language (module constants are evaluated once,
+ *  so they carry BOTH languages and resolve at render time). */
 const OBS_TABS = [
-  { key: 'live', label: '实时活动流' },
-  { key: 'f1', label: '审查线程' },
-  { key: 'f2', label: '收敛趋势' },
-  { key: 'f3', label: '发现定位' },
-  { key: 'f4', label: '修复与回滚' },
-  { key: 'f5', label: '断点恢复' },
-  { key: 'f6', label: '运行控制台' },
-  { key: 'f7', label: '决策时间线' },
+  { key: 'live', label: { zh: '实时活动流', en: 'Live activity' }, hotkey: '' },
+  { key: 'f1', label: { zh: '审查线程', en: 'Review threads' }, hotkey: '1' },
+  { key: 'f2', label: { zh: '收敛趋势', en: 'Convergence trend' }, hotkey: '2' },
+  { key: 'f3', label: { zh: '发现定位', en: 'Finding locations' }, hotkey: '3' },
+  { key: 'f4', label: { zh: '修复与回滚', en: 'Fixes & rollback' }, hotkey: '4' },
+  { key: 'f5', label: { zh: '断点恢复', en: 'Checkpoint resume' }, hotkey: '5' },
+  { key: 'f6', label: { zh: '运行控制台', en: 'Run console' }, hotkey: '6' },
+  { key: 'f7', label: { zh: '决策时间线', en: 'Decision timeline' }, hotkey: '7' },
   // v3.0: Quality Command Center tabs
-  { key: 'f8', label: '质量门禁' },
-  { key: 'f9', label: '经验银行' },
-  { key: 'f10', label: '防御事件' },
+  { key: 'f8', label: { zh: '质量门禁', en: 'Quality gate' }, hotkey: '8' },
+  { key: 'f9', label: { zh: '经验银行', en: 'Experience bank' }, hotkey: '9' },
+  { key: 'f10', label: { zh: '防御事件', en: 'Defense events' }, hotkey: '0' },
 ] as const
 
-/** Live subagent activity badges: type → Chinese label + dsw token color accent. */
-const OBS_LIVE_META: Record<string, { label: string; color: string }> = {
-  read: { label: '阅读', color: 'var(--dsw-alias-brand-primary)' },
-  fix: { label: '修复', color: 'var(--dsw-alias-state-success-primary)' },
-  rollback: { label: '回滚', color: 'var(--dsw-alias-state-error-primary)' },
-  diff: { label: '差异', color: 'var(--dsw-alias-state-warn-primary)' },
-  review: { label: '审查', color: 'var(--dsw-alias-brand-primary)' },
-  triage: { label: '分流', color: 'var(--dsw-alias-state-warn-primary)' },
-  checkpoint: { label: '断点', color: 'var(--dsw-alias-brand-primary)' },
-  validate: { label: '校验', color: 'var(--dsw-alias-state-success-primary)' },
-  log: { label: '记录', color: 'var(--dsw-alias-label-secondary)' },
-  prune: { label: '清理', color: 'var(--dsw-alias-state-warn-primary)' },
-  info: { label: '信息', color: 'var(--dsw-alias-label-secondary)' },
+/** Digit → tab id. `1-9` map to F1–F9, `0` to F10, `-` back to the live feed
+ *  (the default view). Digits are used instead of F1–F10 to avoid clashing
+ *  with browser/system F-key bindings. */
+const OBS_HOTKEY_TABS: Record<string, (typeof OBS_TABS)[number]['key']> = {
+  1: 'f1', 2: 'f2', 3: 'f3', 4: 'f4', 5: 'f5',
+  6: 'f6', 7: 'f7', 8: 'f8', 9: 'f9', 0: 'f10',
+  '-': 'live',
+}
+
+/** Visible label for a tab (keeps the number prefix in sync with `OBS_TABS`). */
+function obsTabLabel(t: (typeof OBS_TABS)[number]): string {
+  const label = t.label[getLang()]
+  if (t.key === 'live') return label
+  return `${t.key.toUpperCase()} ${label}`
+}
+
+/** Hotkey hint shown in the collapsed header, e.g. "11 页 · 按 1-9/0 切 Fn、- 回实时流". */
+function obsHotkeyHint(): string {
+  return getLang() === 'en'
+    ? `${String(OBS_TABS.length)} tabs · keys 1-9/0 switch Fn, - returns to the live feed`
+    : tf(`{a0} 页 · 按 1-9/0 切 Fn、- 回实时流`, { a0: String(OBS_TABS.length) })
+}
+
+/** Live subagent activity badges: type → label + dsw token color accent. */
+const OBS_LIVE_META: Record<string, { label: { zh: string; en: string }; color: string }> = {
+  read: { label: { zh: '阅读', en: 'Read' }, color: 'var(--dsw-alias-brand-primary)' },
+  fix: { label: { zh: '修复', en: 'Fix' }, color: 'var(--dsw-alias-state-success-primary)' },
+  rollback: { label: { zh: '回滚', en: 'Rollback' }, color: 'var(--dsw-alias-state-error-primary)' },
+  diff: { label: { zh: '差异', en: 'Diff' }, color: 'var(--dsw-alias-state-warn-primary)' },
+  review: { label: { zh: '审查', en: 'Review' }, color: 'var(--dsw-alias-brand-primary)' },
+  triage: { label: { zh: '分流', en: 'Triage' }, color: 'var(--dsw-alias-state-warn-primary)' },
+  checkpoint: { label: { zh: '断点', en: 'Checkpoint' }, color: 'var(--dsw-alias-brand-primary)' },
+  validate: { label: { zh: '校验', en: 'Validate' }, color: 'var(--dsw-alias-state-success-primary)' },
+  log: { label: { zh: '记录', en: 'Log' }, color: 'var(--dsw-alias-label-secondary)' },
+  prune: { label: { zh: '清理', en: 'Prune' }, color: 'var(--dsw-alias-state-warn-primary)' },
+  info: { label: { zh: '信息', en: 'Info' }, color: 'var(--dsw-alias-label-secondary)' },
 }
 const OBS_LIVE_FALLBACK_COLOR = 'var(--dsw-alias-label-secondary)'
 
@@ -1820,16 +2241,13 @@ function latestDefenseEvents(session: unknown): ObsDefenseResult | null {
   return scanSessionForDefenseEvents(session) as ObsDefenseResult | null
 }
 
-/** Build a human-pasteable `iterate_fix` instruction for one finding. */
+/** Build a human-pasteable `iterate_fix` instruction for one finding.
+ *  Gap #10: delegates to the shared builder so the payload always names the
+ *  four required `iterate_fix` params (file / content / finding / round) and
+ *  marks `content` + `round` as model-supplied instead of shipping a partial
+ *  call the model has to guess at. */
 function buildObsFixInstruction(f: ObsFinding): string {
-  const payload = JSON.stringify({
-    file: String(f.file || ''),
-    ...(typeof f.line === 'number' && f.line > 0 ? { line: f.line } : {}),
-    dimension: String(f.dimension || ''),
-    summary: String(f.summary || ''),
-    ...(f.suggested_fix ? { suggested_fix: String(f.suggested_fix) } : {}),
-  }, null, 2)
-  return `请调用 \`iterate_fix\` 修复以下 finding：\n\n\`\`\`json\n${payload}\n\`\`\``
+  return buildFixInstruction(f as unknown as Record<string, unknown>)
 }
 
 /**
@@ -1843,6 +2261,9 @@ function buildObsFixInstruction(f: ObsFinding): string {
  */
 function ObservatoryPanel(props: SlotProps) {
   const session = props && props.session ? props.session : null
+  React.useEffect(() => {
+    noteSession(session)
+  }, [session])
   const manifest = latestTranscript(session)
   // v3.1+: command-center data scanned straight out of the session stream.
   const qualityGate = latestQualityGate(session)
@@ -1880,6 +2301,40 @@ function ObservatoryPanel(props: SlotProps) {
   const copyTimer = React.useRef<ReturnType<typeof setTimeout> | null>(null)
   React.useEffect(() => () => { if (copyTimer.current) clearTimeout(copyTimer.current) }, [])
 
+  // Gap #14: digit shortcuts for tab switching. Digit keys (1-9 / 0 / -) are
+  // used instead of F1–F10 so we never fight the browser's own F-key handling.
+  // Guards mirror the triage panel: no modifier keys, no editable focus, and
+  // only while the observatory is expanded AND focus is inside it — so the
+  // keys never steal input from the composer or another panel.
+  React.useEffect(() => {
+    const doc = typeof document !== 'undefined' ? document : null
+    if (!doc || !open) return
+    const onKeyDown = (ev: KeyboardEvent) => {
+      if (ev.metaKey || ev.ctrlKey || ev.altKey || ev.shiftKey) return
+      const t = ev.target as HTMLElement | null
+      if (t && (t.tagName === 'INPUT' || t.tagName === 'TEXTAREA' || t.tagName === 'SELECT')) return
+      if (t && typeof t.isContentEditable === 'boolean' && t.isContentEditable) return
+      const rootEl = doc.querySelector('[data-iterate="obs"]')
+      if (!rootEl) return
+      const activeEl = doc.activeElement as HTMLElement | null
+      // Act when focus is INSIDE the observatory, or nowhere in particular
+      // (body/null — some browsers never focus a <button> on click). Focus
+      // parked on a non-editable element outside the panel keeps standard
+      // behavior; focus in the composer was already excluded above.
+      const inPanel = activeEl === rootEl ||
+        (activeEl !== null && typeof rootEl.contains === 'function' && rootEl.contains(activeEl))
+      const idle = activeEl === null || activeEl === doc.body
+      if (!inPanel && !idle) return
+      const next = OBS_HOTKEY_TABS[ev.key]
+      if (!next) return
+      ev.preventDefault()
+      setTab(next)
+    }
+    doc.addEventListener('keydown', onKeyDown)
+    return () => doc.removeEventListener('keydown', onKeyDown)
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [open])
+
   /** Copy an instruction, flashing "已复制" on the originating button only when the copy actually succeeded. */
   const copyInstruction = (key: string, text: string) => {
     if (!text) return
@@ -1891,6 +2346,12 @@ function ObservatoryPanel(props: SlotProps) {
     })
   }
 
+  // Gap #4: `.iterate/` artifacts are unreachable from the browser — this is
+  // the one instruction that makes the model echo them into the session
+  // stream, which is what every panel scans.
+  const pullInstruction = buildDiskSnapshotInstruction()
+  const pullTitle = tf(`复制拉取磁盘快照指令：让模型逐个调用 {a0} 并回显完整结果`, { a0: DISK_SNAPSHOT_SOURCES.map((s) => s.tool).join(' / ') })
+
   /** Toggle one thread; a manual toggle exits any forced all/none mode. */
   const toggleThread = (key: string) => {
     setThreadMode('auto')
@@ -1901,10 +2362,19 @@ function ObservatoryPanel(props: SlotProps) {
     })
   }
 
-  /** Export the full observatory snapshot as JSON (download, then copy fallback). */
+  /** Export the full observatory snapshot as JSON (download, then copy fallback).
+   *  Gap #11: the payload also carries the four on-disk artifacts the panels
+   *  render (quality gate, experience bank, defense events, final report) —
+   *  previously only `manifest` + `live` were exported, so a review could not
+   *  be reconstructed from the file. */
   const exportObservatory = () => {
     if (!manifest) return
-    const json = serializeObservatoryExport(manifest, manifest.live || [])
+    const json = serializeObservatoryExport(manifest, manifest.live || [], {
+      qualityGate,
+      experienceBank,
+      defenseEvents,
+      report: latestReport(session),
+    })
     const filename = `iterate-observatory-${new Date().toISOString().replace(/[:.]/g, '-')}.json`
     const flash = () => {
       setCopiedKey('export')
@@ -1937,8 +2407,16 @@ function ObservatoryPanel(props: SlotProps) {
   if (!manifest) {
     return React.createElement('div', { 'data-iterate-root': '', 'data-iterate': 'obs', className: 'iterate-obs' },
       React.createElement('div', { className: 'iterate-obs-head', 'data-closed': '' },
-        React.createElement('span', { className: 'iterate-obs-title' }, 'iterate 观测台'),
-        React.createElement('span', { className: 'iterate-obs-head-meta' }, '暂无运行时观测数据'),
+        React.createElement('span', { className: 'iterate-obs-title' }, t('iterate 观测台')),
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, tf(`暂无运行时观测数据 · {a0}`, { a0: obsHotkeyHint() })),
+        React.createElement('button', {
+          className: 'iterate-btn', 'data-copied': copiedKey === 'pull-snapshot' ? '' : undefined,
+          onClick: (e: React.MouseEvent<HTMLButtonElement>) => {
+            e.stopPropagation()
+            copyInstruction('pull-snapshot', pullInstruction)
+          },
+          title: t('复制拉取磁盘快照指令：磁盘上可能已有历史产物，回显进会话后观测台即可填充'),
+        }, copiedKey === 'pull-snapshot' ? t('已复制') : t('拉取磁盘快照')),
       ),
     )
   }
@@ -1964,49 +2442,49 @@ function ObservatoryPanel(props: SlotProps) {
   const renderThreads = () => {
     const rounds = manifest.rounds || []
     if (rounds.length === 0) {
-      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无审查线程')
+      return React.createElement('div', { className: 'iterate-obs-empty' }, t('暂无审查线程'))
     }
     return React.createElement('div', {},
       React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8, flexWrap: 'wrap' } },
-        React.createElement('b', {}, '审查线程'),
-        React.createElement('button', { className: 'iterate-btn', onClick: () => setAllThreads('all'), title: '展开全部线程' }, '全部展开'),
-        React.createElement('button', { className: 'iterate-btn', onClick: () => setAllThreads('none'), title: '收起全部线程' }, '全部收起'),
+        React.createElement('b', {}, t('审查线程')),
+        React.createElement('button', { className: 'iterate-btn', onClick: () => setAllThreads('all'), title: t('展开全部线程') }, t('全部展开')),
+        React.createElement('button', { className: 'iterate-btn', onClick: () => setAllThreads('none'), title: t('收起全部线程') }, t('全部收起')),
         React.createElement('span', { className: 'iterate-filter-count' },
-          `${threadMode === 'all' ? '全部展开' : threadMode === 'none' ? '全部收起' : '自由切换'} · ${rounds.length} 轮`,
+          tf(`{a0} · {a1} 轮`, { a0: threadMode === 'all' ? t('全部展开') : threadMode === 'none' ? t('全部收起') : t('自由切换'), a1: rounds.length }),
         ),
       ),
       ...rounds.map((r, ri) => {
       const threads = r.threads || []
       const fCount = threads.reduce((sum, t) => sum + (t.findings ? t.findings.length : 0), 0)
       const threadBlocks = threads.length === 0
-        ? [React.createElement('div', { key: 'none', className: 'iterate-obs-empty' }, '本轮无线程')]
-        : threads.map((t, ti) => {
+        ? [React.createElement('div', { key: 'none', className: 'iterate-obs-empty' }, t('本轮无线程'))]
+        : threads.map((th, ti) => {
             const key = `${ri}-${ti}`
             const expanded = isThreadExpanded(key)
-            const dim = t.dimension || '未命名维度'
-            const tFindings = t.findings || []
-            const files = t.readFiles || []
-            const msgs = t.messages || []
+            const dim = th.dimension || t('未命名维度')
+            const tFindings = th.findings || []
+            const files = th.readFiles || []
+            const msgs = th.messages || []
             return React.createElement('div', { key, className: 'iterate-obs-block' },
-              React.createElement('div', { className: 'iterate-obs-block-head', 'data-click': '', onClick: () => toggleThread(key), title: expanded ? '收起线程' : '展开线程' },
+              React.createElement('div', { className: 'iterate-obs-block-head', 'data-click': '', onClick: () => toggleThread(key), title: expanded ? t('收起线程') : t('展开线程') },
                 React.createElement('span', {}, expanded ? '−' : '+'),
                 React.createElement('b', {}, dim),
-                React.createElement('span', { className: 'iterate-obs-chip' }, `attempt ${typeof t.attempt === 'number' ? t.attempt : '?'}`),
+                React.createElement('span', { className: 'iterate-obs-chip' }, `attempt ${typeof th.attempt === 'number' ? th.attempt : '?'}`),
                 React.createElement('span', { className: 'iterate-obs-chip' }, `${tFindings.length} findings`),
               ),
               expanded
                 ? React.createElement('div', { className: 'iterate-obs-block-body' },
                     React.createElement('div', { className: 'iterate-obs-bar' },
-                      React.createElement('b', {}, '叙述'),
-                      React.createElement('span', { className: 'iterate-obs-head-meta' }, `${msgs.length} 条`),
+                      React.createElement('b', {}, t('叙述')),
+                      React.createElement('span', { className: 'iterate-obs-head-meta' }, tf(`{a0} 条`, { a0: msgs.length })),
                     ),
                     ...(msgs.length === 0
-                      ? [React.createElement('div', { key: 'msg-none', className: 'iterate-obs-empty' }, '无线索叙述')]
+                      ? [React.createElement('div', { key: 'msg-none', className: 'iterate-obs-empty' }, t('无线索叙述'))]
                       : msgs.map((m, mi) => React.createElement('div', { key: mi, className: 'iterate-obs-msg' }, String(m)))),
                     ...(files.length > 0
                       ? [
                           React.createElement('div', { key: 'files-h', className: 'iterate-obs-bar', style: { marginTop: 6 } },
-                            React.createElement('b', {}, '读取文件'),
+                            React.createElement('b', {}, t('读取文件')),
                           ),
                           ...files.map((f, fi) =>
                             React.createElement('div', { key: `f${fi}`, className: 'iterate-obs-file' }, String(f)),
@@ -2014,10 +2492,10 @@ function ObservatoryPanel(props: SlotProps) {
                         ]
                       : []),
                     React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 6 } },
-                      React.createElement('b', {}, '发现'),
+                      React.createElement('b', {}, t('发现')),
                     ),
                     ...(tFindings.length === 0
-                      ? [React.createElement('div', { key: 'finding-none', className: 'iterate-obs-empty' }, '本线程无发现')]
+                      ? [React.createElement('div', { key: 'finding-none', className: 'iterate-obs-empty' }, t('本线程无发现'))]
                       : tFindings.map((f, fi) => threadFindingPill(f, `tf${fi}`))),
                   )
                 : null,
@@ -2026,7 +2504,7 @@ function ObservatoryPanel(props: SlotProps) {
       return React.createElement('div', { key: ri, className: 'iterate-obs-block' },
         React.createElement('div', { className: 'iterate-obs-block-head' },
           React.createElement('b', {}, `Round ${typeof r.round === 'number' ? r.round : ri + 1}`),
-          React.createElement('span', { className: 'iterate-obs-chip' }, `${threads.length} 线程`),
+          React.createElement('span', { className: 'iterate-obs-chip' }, tf(`{a0} 线程`, { a0: threads.length })),
           React.createElement('span', { className: 'iterate-obs-head-meta' }, `${fCount} findings`),
         ),
         React.createElement('div', { className: 'iterate-obs-block-body' }, ...threadBlocks),
@@ -2038,14 +2516,69 @@ function ObservatoryPanel(props: SlotProps) {
   const renderTrend = () => {
     const conv = manifest.convergence || []
     if (conv.length === 0) {
-      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无收敛数据')
+      return React.createElement('div', { className: 'iterate-obs-empty' }, t('暂无收敛数据'))
     }
     const points = conv.map((n, i) => ({ round: i + 1, count: n }))
+    // Gap #13 (step ①): single-session cross-round comparison. One row per
+    // round — findings raised / fixed / severity mix / validation outcome.
+    // Cross-SESSION comparison rides on the #4 pull instruction instead (the
+    // client has no filesystem access, so `iterate_history` aggregates have to
+    // be echoed back into the session first).
+    const report = latestReport(session)
+    const comparison = buildRoundComparison(report, manifest.validations || [])
+    const comparisonTable = comparison.length === 0
+      ? null
+      : React.createElement('table', { className: 'iterate-obs-table' },
+          React.createElement('thead', {},
+            React.createElement('tr', {},
+              React.createElement('th', {}, t('轮次')),
+              React.createElement('th', {}, t('发现')),
+              React.createElement('th', {}, t('已修复')),
+              React.createElement('th', {}, t('严重度分布')),
+              React.createElement('th', {}, t('验证')),
+            ),
+          ),
+          React.createElement('tbody', {},
+            ...comparison.map((row) => {
+              const sevText = Object.entries(row.severities)
+                .map(([k, v]) => `${k}:${v}`)
+                .join(' · ')
+              const anyFailed = row.validations.some((v) => v.allowed !== true)
+              const valText = row.validations.length === 0
+                ? '—'
+                : tf(`{a0}/{a1} 通过{a2}`, { a0: row.validations.filter((v) => v.allowed === true).length, a1: row.validations.length, a2: anyFailed ? t('（含失败）') : '' })
+              return React.createElement('tr', { key: `cmp-${row.round}` },
+                React.createElement('td', {}, `Round ${row.round}`),
+                React.createElement('td', {}, String(row.findings)),
+                React.createElement('td', {}, String(row.fixed)),
+                React.createElement('td', {}, sevText || '—'),
+                React.createElement('td', {
+                  style: anyFailed
+                    ? { color: 'var(--dsw-alias-state-error-primary)', fontWeight: 600 }
+                    : row.validations.length > 0
+                      ? { color: 'var(--dsw-alias-state-success-primary)' }
+                      : undefined,
+                }, valText),
+              )
+            }),
+          ),
+        )
     return React.createElement('div', {},
       React.createElement(TrendChart, { points }),
       React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 6 } },
-        `各轮发现数量：${conv.join(' → ')}${typeof manifest.round === 'number' ? ` · 当前 Round ${manifest.round}` : ''}`,
+        tf(`各轮发现数量：{a0}{a1}`, { a0: conv.join(' → '), a1: typeof manifest.round === 'number' ? tf(` · 当前 Round {a0}`, { a0: manifest.round }) : '' }),
       ),
+      comparisonTable
+        ? React.createElement('div', { className: 'iterate-obs-block', style: { marginTop: 8 } },
+            React.createElement('div', { className: 'iterate-obs-block-head' },
+              React.createElement('span', {}, t('跨轮对比（本会话）')),
+              React.createElement('span', { className: 'iterate-obs-head-meta' },
+                t('跨会话对比：本表只覆盖当前会话；点「拉取磁盘快照」让模型回显 iterate_history，再用「导出 JSON」并排比较两次运行'),
+              ),
+            ),
+            React.createElement('div', { className: 'iterate-obs-block-body' }, comparisonTable),
+          )
+        : null,
     )
   }
 
@@ -2053,7 +2586,7 @@ function ObservatoryPanel(props: SlotProps) {
   const renderFindings = () => {
     const findings = manifest.findings || []
     if (findings.length === 0) {
-      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无发现')
+      return React.createElement('div', { className: 'iterate-obs-empty' }, t('暂无发现'))
     }
     const opts = buildFilterOptions(findings as unknown as Record<string, unknown>[])
     const { filtered } = filterFindingsWithIndices(findings as unknown as Record<string, unknown>[], f3Filter)
@@ -2067,26 +2600,26 @@ function ObservatoryPanel(props: SlotProps) {
       }))
     }
     const filterBar = React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8, flexWrap: 'wrap' } },
-      React.createElement('b', {}, '发现'),
+      React.createElement('b', {}, t('发现')),
       ...opts.severities.map((s) =>
         React.createElement('button', {
           key: `sev-${s.value}`,
           className: 'iterate-filter-chip',
           'data-active': f3Filter.severities.includes(s.value) ? '' : undefined,
-          title: `${s.value}（${s.count} 项）`,
+          title: tf(`{a0}（{a1} 项）`, { a0: s.value, a1: s.count }),
           onClick: () => toggleSeverity(s.value),
         }, `${s.value} ${s.count}`),
       ),
       React.createElement('select', {
         className: 'iterate-filter-select',
         value: f3Filter.dimensions[0] || '',
-        'aria-label': '按维度筛选',
+        'aria-label': t('按维度筛选'),
         onChange: (e: React.ChangeEvent<HTMLSelectElement>) => {
           const v = e.target.value
           setF3Filter((prev) => ({ ...prev, dimensions: v ? [v] : [] }))
         },
       },
-        React.createElement('option', { value: '' }, '全部维度'),
+        React.createElement('option', { value: '' }, t('全部维度')),
         ...opts.dimensions.map((d) =>
           React.createElement('option', { key: d.value, value: d.value }, `${d.value} (${d.count})`),
         ),
@@ -2094,8 +2627,8 @@ function ObservatoryPanel(props: SlotProps) {
       React.createElement('input', {
         className: 'iterate-filter-search',
         type: 'search',
-        placeholder: '搜索发现…',
-        'aria-label': '搜索发现',
+        placeholder: t('搜索发现…'),
+        'aria-label': t('搜索发现'),
         value: f3Filter.search,
         onChange: (e: React.ChangeEvent<HTMLInputElement>) =>
           setF3Filter((prev) => ({ ...prev, search: e.target.value })),
@@ -2104,8 +2637,8 @@ function ObservatoryPanel(props: SlotProps) {
         ? React.createElement('button', {
             className: 'iterate-filter-clear',
             onClick: () => setF3Filter({ severities: [], dimensions: [], search: '' }),
-            title: '清除全部筛选',
-          }, '清除筛选')
+            title: t('清除全部筛选'),
+          }, t('清除筛选'))
         : null,
       React.createElement('span', { className: 'iterate-filter-count' }, `${filtered.length}/${findings.length}`),
     )
@@ -2128,7 +2661,7 @@ function ObservatoryPanel(props: SlotProps) {
           React.createElement('span', { className: 'iterate-obs-file' }, loc),
           React.createElement('span', {}, String(finding.dimension || '')),
           finding.acknowledged === true
-            ? React.createElement('span', { className: 'iterate-obs-chip' }, '已确认')
+            ? React.createElement('span', { className: 'iterate-obs-chip' }, t('已确认'))
             : null,
         ),
         React.createElement('div', { className: 'iterate-obs-block-body' },
@@ -2137,18 +2670,18 @@ function ObservatoryPanel(props: SlotProps) {
             React.createElement('button', {
               className: 'iterate-btn', 'data-copied': copiedKey === `${k}-fix` ? '' : undefined,
               onClick: () => copyInstruction(`${k}-fix`, String(finding.suggested_fix || '')),
-              title: '复制该 finding 的建议修复文本',
-            }, copiedKey === `${k}-fix` ? '已复制' : '复制 suggested_fix'),
+              title: t('复制该 finding 的建议修复文本'),
+            }, copiedKey === `${k}-fix` ? t('已复制') : t('复制 suggested_fix')),
             React.createElement('button', {
               className: 'iterate-btn', 'data-copied': copiedKey === `${k}-known` ? '' : undefined,
               onClick: () => copyInstruction(`${k}-known`, knownInstruction),
-              title: '复制 iterate_triage 指令文本（标记为 known_intentional）',
-            }, copiedKey === `${k}-known` ? '已复制' : 'known_intentional'),
+              title: t('复制 iterate_triage 指令文本（标记为 known_intentional）'),
+            }, copiedKey === `${k}-known` ? t('已复制') : 'known_intentional'),
             React.createElement('button', {
               className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === `${k}-repair` ? '' : undefined,
               onClick: () => copyInstruction(`${k}-repair`, fixInstruction),
-              title: '复制 iterate_fix 指令文本',
-            }, copiedKey === `${k}-repair` ? '已复制' : '复制修复指令'),
+              title: t('复制 iterate_fix 指令文本'),
+            }, copiedKey === `${k}-repair` ? t('已复制') : t('复制修复指令')),
           ),
         ),
       )
@@ -2156,7 +2689,7 @@ function ObservatoryPanel(props: SlotProps) {
     if (filtered.length === 0) {
       return React.createElement('div', {},
         filterBar,
-        React.createElement('div', { className: 'iterate-obs-empty' }, '无匹配的发现'),
+        React.createElement('div', { className: 'iterate-obs-empty' }, t('无匹配的发现')),
       )
     }
     return React.createElement('div', {}, filterBar, ...findingBlocks)
@@ -2166,19 +2699,19 @@ function ObservatoryPanel(props: SlotProps) {
   const renderFixes = () => {
     const fixes = manifest.fixes || []
     if (fixes.length === 0) {
-      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无修复记录')
+      return React.createElement('div', { className: 'iterate-obs-empty' }, t('暂无修复记录'))
     }
     return React.createElement('div', {}, ...fixes.map((f, i) => {
       const k = `f4-${i}`
       const id = String(f.id || `fix#${i + 1}`)
-      const rollbackText = `请调用 \`iterate_rollback\` 回滚以下修复：\n\n\`\`\`json\n${JSON.stringify({ id }, null, 2)}\n\`\`\``
+      const rollbackText = buildRollbackInstruction(id)
       const added = typeof f.linesAdded === 'number' ? f.linesAdded : 0
       const removed = typeof f.linesRemoved === 'number' ? f.linesRemoved : 0
       return React.createElement('div', { key: k, className: 'iterate-obs-block' },
         React.createElement('div', { className: 'iterate-obs-block-head' },
           React.createElement('b', {}, id),
           React.createElement('span', { className: 'iterate-obs-file' }, String(f.file || '?')),
-          React.createElement('span', { className: 'iterate-obs-chip' }, f.success === true ? '成功' : '失败'),
+          React.createElement('span', { className: 'iterate-obs-chip' }, f.success === true ? t('成功') : t('失败')),
           typeof f.round === 'number'
             ? React.createElement('span', { className: 'iterate-obs-head-meta' }, `Round ${f.round}`)
             : null,
@@ -2191,8 +2724,8 @@ function ObservatoryPanel(props: SlotProps) {
             React.createElement('button', {
               className: 'iterate-btn', 'data-danger': '', 'data-copied': copiedKey === `${k}-rb` ? '' : undefined,
               onClick: () => copyInstruction(`${k}-rb`, rollbackText),
-              title: '复制 iterate_rollback 指令文本',
-            }, copiedKey === `${k}-rb` ? '已复制' : '回滚'),
+              title: t('复制 iterate_rollback 指令文本'),
+            }, copiedKey === `${k}-rb` ? t('已复制') : t('回滚')),
           ),
         ),
       )
@@ -2203,23 +2736,24 @@ function ObservatoryPanel(props: SlotProps) {
   const renderCheckpoint = () => {
     const cp = manifest.checkpoint
     if (!cp) {
-      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无断点')
+      return React.createElement('div', { className: 'iterate-obs-empty' },
+        diskEmptyStateText(toolCalledInSession(session, 'iterate_transcript'), t('断点'), getLang()),
+      )
     }
-    const resumeText = `请调用 \`iterate_checkpoint\` 从断点恢复迭代：\n\n\`\`\`json\n${JSON.stringify({
-      operation: 'resume',
-      mode: String(cp.mode || 'normal'),
-      maxRounds: typeof cp.maxRounds === 'number' ? cp.maxRounds : null,
-    }, null, 2)}\n\`\`\``
+    // Gap #10: `resume` accepts ONLY `operation` — `mode` / `round` /
+    // `maxRounds` are save-side inputs and `maxRounds: null` was an
+    // invalid-integer field on a positive-integer schema.
+    const resumeText = buildCheckpointResumeInstruction()
     // Clearing a stale checkpoint after an interrupted run — iterate_checkpoint
     // exposes `clear`, but before this button it was only reachable by typing
     // the command manually (an interrupted run otherwise shows a permanent
     // "可恢复" chip with no companion reset action).
-    const clearText = `请调用 \`iterate_checkpoint\` 清除当前断点：\n\n\`\`\`json\n${JSON.stringify({ operation: 'clear' }, null, 2)}\n\`\`\``
+    const clearText = buildCheckpointClearInstruction()
     const item = (label: string, value: unknown) =>
       React.createElement('span', { className: 'iterate-obs-chip' }, `${label} ${String(value ?? '?')}`)
     return React.createElement('div', { className: 'iterate-obs-block' },
       React.createElement('div', { className: 'iterate-obs-block-head' },
-        React.createElement('b', {}, '断点'),
+        React.createElement('b', {}, t('断点')),
         React.createElement('span', { className: 'iterate-obs-head-meta' }, String(cp.updatedAt || '')),
       ),
       React.createElement('div', { className: 'iterate-obs-block-body' },
@@ -2234,13 +2768,13 @@ function ObservatoryPanel(props: SlotProps) {
           React.createElement('button', {
             className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === 'cp-resume' ? '' : undefined,
             onClick: () => copyInstruction('cp-resume', resumeText),
-            title: '复制 iterate_checkpoint resume 指令文本（加载断点并计数一次恢复）',
-          }, copiedKey === 'cp-resume' ? '已复制' : '复制恢复指令'),
+            title: t('复制 iterate_checkpoint resume 指令文本（加载断点并计数一次恢复）'),
+          }, copiedKey === 'cp-resume' ? t('已复制') : t('复制恢复指令')),
           React.createElement('button', {
             className: 'iterate-btn', 'data-danger': '', 'data-copied': copiedKey === 'cp-clear' ? '' : undefined,
             onClick: () => copyInstruction('cp-clear', clearText),
-            title: '复制 iterate_checkpoint clear 指令文本（清除当前断点，供重新开始）',
-          }, copiedKey === 'cp-clear' ? '已复制' : '清除断点'),
+            title: t('复制 iterate_checkpoint clear 指令文本（清除当前断点，供重新开始）'),
+          }, copiedKey === 'cp-clear' ? t('已复制') : t('清除断点')),
         ),
       ),
     )
@@ -2249,40 +2783,84 @@ function ObservatoryPanel(props: SlotProps) {
   // ── F6: run console (status / approval / nudge draft) ──────────────────
   const renderConsole = () => {
     const approval = manifest.approval || { policy: 'ask' }
-    const policyLabelMap: Record<string, string> = { ask: '询问用户', deny: '拒绝', allow: '直接执行' }
+    const policyLabelMap: Record<string, string> = { ask: t('询问用户'), deny: t('拒绝'), allow: t('直接执行') }
     const policyLabel = policyLabelMap[String(approval.policy || 'ask')] || String(approval.policy || 'ask')
     const nudge = manifest.nudge || null
     const present = Boolean(nudge && nudge.text)
     const activeNudgeText = nudge && nudge.text ? nudge.text : ''
-    const nudgeInstruction = `请调用 \`iterate_transcript\` 写入 nudge 指令：\n\n\`\`\`json\n${JSON.stringify({ operation: 'nudge', text: nudgeText }, null, 2)}\n\`\`\``
+    const nudgeInstruction = tf(`请调用 \`iterate_transcript\` 写入 nudge 指令：\n\n\`\`\`json\n{a0}\n\`\`\``, { a0: JSON.stringify({ operation: 'nudge', text: nudgeText }, null, 2) })
     // Clearing the PERSISTED nudge (as opposed to the draft) requires
     // text:null. Copied as a paste-able instruction, mirroring the panel's
     // copy-to-command pattern — it cannot be cleared from the client directly.
-    const activeClearInstruction = `请调用 \`iterate_transcript\` 清除当前 nudge：\n\n\`\`\`json\n${JSON.stringify({ operation: 'nudge', text: null }, null, 2)}\n\`\`\``
+    const activeClearInstruction = tf(`请调用 \`iterate_transcript\` 清除当前 nudge：\n\n\`\`\`json\n{a0}\n\`\`\``, { a0: JSON.stringify({ operation: 'nudge', text: null }, null, 2) })
+    // Gap #6: per-round validation rows (command / exitCode / allowed) live on
+    // the manifest; when the run stopped on a validation failure the failing
+    // command is called out explicitly instead of being buried in a list.
+    const validations = Array.isArray(manifest.validations) ? manifest.validations : []
+    const abortedByValidation = String(manifest.stoppedReason || '') === 'aborted_by_validation'
+    const validationRows = validations.map((v, i) => {
+      const allowed = v.allowed === true
+      const failed = !allowed
+      const highlight = failed && abortedByValidation
+      const exit = typeof v.exitCode === 'number' ? `exit ${v.exitCode}` : 'exit —'
+      return React.createElement('div', {
+        key: `val-${i}`,
+        className: 'iterate-obs-row',
+        'data-status': allowed ? 'pass' : 'fail',
+        'data-highlight': highlight ? '' : undefined,
+        title: v.rejectReason ? String(v.rejectReason) : undefined,
+      },
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, `Round ${typeof v.round === 'number' ? v.round : '?'}`),
+        React.createElement('code', { className: 'iterate-obs-mono' }, String(v.command || '')),
+        React.createElement('span', { className: 'iterate-obs-chip', 'data-status': allowed ? 'pass' : 'fail' },
+          allowed ? t('通过') : t('失败'),
+        ),
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, exit),
+        highlight ? React.createElement('span', { className: 'iterate-obs-chip', 'data-status': 'fail' }, t('导致中止')) : null,
+      )
+    })
+    const validationsBlock = React.createElement('div', { className: 'iterate-obs-block', style: { marginTop: 8 } },
+      React.createElement('div', { className: 'iterate-obs-block-head' },
+        React.createElement('span', {}, t('验证结果')),
+        validations.length === 0
+          ? React.createElement('span', { className: 'iterate-obs-head-meta' }, t('本轮尚无验证记录'))
+          : React.createElement('span', { className: 'iterate-obs-head-meta' }, tf(`{a0} 条命令`, { a0: validations.length })),
+        abortedByValidation
+          ? React.createElement('span', { className: 'iterate-obs-badge', 'data-status': 'fail' }, t('因验证失败中止'))
+          : null,
+      ),
+      React.createElement('div', { className: 'iterate-obs-block-body' },
+        validations.length === 0
+          ? React.createElement('div', { className: 'iterate-obs-empty' },
+              t('尚未拉取验证结果：数据在磁盘 transcript 里，点「拉取磁盘快照」复制指令发回会话即可回填。'),
+            )
+          : React.createElement(React.Fragment, null, ...validationRows),
+      ),
+    )
     return React.createElement('div', { className: 'iterate-obs-block' },
       React.createElement('div', { className: 'iterate-obs-block-head' },
-        React.createElement('span', {}, '运行控制台'),
+        React.createElement('span', {}, t('运行控制台')),
         React.createElement('span', { className: 'iterate-obs-badge', 'data-live': live ? '' : undefined }, runStatusText(live, manifest)),
-        React.createElement('span', { className: 'iterate-obs-head-meta' }, `批准策略：${policyLabel}`),
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, tf(`批准策略：{a0}`, { a0: policyLabel })),
       ),
       React.createElement('div', { className: 'iterate-obs-block-body' },
         present
           ? React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 6 } },
-              React.createElement('b', {}, '当前 nudge'),
+              React.createElement('b', {}, t('当前 nudge')),
               React.createElement('span', { className: 'iterate-obs-msg' }, activeNudgeText),
               React.createElement('button', {
                 className: 'iterate-btn', 'data-copied': copiedKey === 'nudge-clear' ? '' : undefined,
                 onClick: () => copyInstruction('nudge-clear', activeClearInstruction),
-                title: '复制清除 nudge 指令（写 text:null），在运行控制台提示清除已持久化的 nudge',
-              }, copiedKey === 'nudge-clear' ? '已复制清除指令' : '复制清除指令'),
+                title: t('复制清除 nudge 指令（写 text:null），在运行控制台提示清除已持久化的 nudge'),
+              }, copiedKey === 'nudge-clear' ? t('已复制清除指令') : t('复制清除指令')),
             )
           : null,
         React.createElement('textarea', {
           className: 'iterate-obs-input iterate-obs-mono',
           rows: 3,
-          placeholder: '起草一条 nudge 方向指令…',
+          placeholder: t('起草一条 nudge 方向指令…'),
           value: nudgeText,
-          'aria-label': 'nudge 草稿',
+          'aria-label': t('nudge 草稿'),
           onChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => setNudgeText(e.target.value),
         }),
         React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 6 } },
@@ -2290,9 +2868,10 @@ function ObservatoryPanel(props: SlotProps) {
             className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === 'nudge' ? '' : undefined,
             disabled: !nudgeText,
             onClick: () => copyInstruction('nudge', nudgeInstruction),
-            title: '复制 iterate_transcript nudge 指令文本',
-          }, copiedKey === 'nudge' ? '已复制' : '复制 nudge 指令'),
+            title: t('复制 iterate_transcript nudge 指令文本'),
+          }, copiedKey === 'nudge' ? t('已复制') : t('复制 nudge 指令')),
         ),
+        validationsBlock,
       ),
     )
   }
@@ -2301,7 +2880,7 @@ function ObservatoryPanel(props: SlotProps) {
   const renderTimeline = () => {
     const entries = manifest.timeline || []
     if (entries.length === 0) {
-      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无时间线条目')
+      return React.createElement('div', { className: 'iterate-obs-empty' }, t('暂无时间线条目'))
     }
     const types = Array.from(new Set(entries.map((t) => String(t.type || 'unknown')).filter(Boolean))).sort()
     const rounds = Array.from(
@@ -2337,30 +2916,30 @@ function ObservatoryPanel(props: SlotProps) {
       )
     })
     const filterBar = React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
-      React.createElement('b', {}, '时间线'),
+      React.createElement('b', {}, t('时间线')),
       React.createElement('select', {
         className: 'iterate-filter-select',
         value: timelineType,
-        'aria-label': '按时间线类型筛选',
+        'aria-label': t('按时间线类型筛选'),
         onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setTimelineType(e.target.value),
       },
-        React.createElement('option', { value: '' }, '全部类型'),
+        React.createElement('option', { value: '' }, t('全部类型')),
         ...types.map((t) => React.createElement('option', { key: t, value: t }, t)),
       ),
       React.createElement('select', {
         className: 'iterate-filter-select',
         value: timelineRound,
-        'aria-label': '按轮次筛选',
+        'aria-label': t('按轮次筛选'),
         onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setTimelineRound(e.target.value),
       },
-        React.createElement('option', { value: '' }, '全部轮次'),
+        React.createElement('option', { value: '' }, t('全部轮次')),
         ...rounds.map((r) => React.createElement('option', { key: r, value: r }, `Round ${r}`)),
       ),
       React.createElement('input', {
         className: 'iterate-filter-search',
         type: 'search',
-        placeholder: '搜索时间线…',
-        'aria-label': '搜索时间线',
+        placeholder: t('搜索时间线…'),
+        'aria-label': t('搜索时间线'),
         value: timelineSearch,
         onChange: (e: React.ChangeEvent<HTMLInputElement>) => setTimelineSearch(e.target.value),
       }),
@@ -2368,15 +2947,15 @@ function ObservatoryPanel(props: SlotProps) {
         ? React.createElement('button', {
             className: 'iterate-filter-clear',
             onClick: clearTimelineFilter,
-            title: '清除全部筛选',
-          }, '清除')
+            title: t('清除全部筛选'),
+          }, t('清除'))
         : null,
       React.createElement('span', { className: 'iterate-filter-count' }, `${filtered.length}/${entries.length}`),
     )
     if (rows.length === 0) {
       return React.createElement('div', {},
         filterBar,
-        React.createElement('div', { className: 'iterate-obs-empty' }, '无匹配的时间线条目'),
+        React.createElement('div', { className: 'iterate-obs-empty' }, t('无匹配的时间线条目')),
       )
     }
     return React.createElement('div', {}, filterBar, ...rows)
@@ -2387,29 +2966,40 @@ function ObservatoryPanel(props: SlotProps) {
   // session (dimension convergence, verification pass rate, overall PASS/FAIL);
   // falls back to copy-able query instructions when no snapshot exists yet.
   const renderQualityGate = () => {
-    const gateInstruction = '请调用 `iterate_quality_gate` 查询当前质量门禁状态'
+    // Gap #10: the query instruction now carries explicit JSON args, matching
+    // the rest of the panel's copy-to-command payloads (the model no longer
+    // has to infer `operation`).
+    const gateInstruction = buildQualityGateQueryInstruction()
     // Reset a stale FAIL certificate before a fresh iteration — the tool's
     // `clear` operation existed since v3.5.1 but had no client entry point.
-    const gateClearInstruction = `请调用 \`iterate_quality_gate\` 清除当前质量门禁证书：\n\n\`\`\`json\n${JSON.stringify({ operation: 'clear' }, null, 2)}\n\`\`\``
+    const gateClearInstruction = buildQualityGateClearInstruction()
     const gate = qualityGate
     const dims = gate && gate.dimensions ? gate.dimensions : []
     const hasGate = gate !== null && Boolean(gate.overallStatus || gate.overallScore != null || dims.length > 0)
     const status = gate && gate.overallStatus ? String(gate.overallStatus) : 'pending'
     const statusLabel = status === 'pass' ? 'PASS' : status === 'fail' ? 'FAIL' : 'PENDING'
     const num = (v: number | undefined) => Number(v != null ? v : 0)
+    const pulled = toolCalledInSession(session, 'iterate_quality_gate')
 
     const headerBar = React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
-      React.createElement('b', {}, '质量门禁'),
+      React.createElement('b', {}, t('质量门禁')),
       React.createElement('button', {
         className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === 'qgate' ? '' : undefined,
         onClick: () => copyInstruction('qgate', gateInstruction),
-        title: '复制 iterate_quality_gate 查询指令',
-      }, copiedKey === 'qgate' ? '已复制' : '查询门禁'),
+        title: t('复制 iterate_quality_gate 查询指令（含 JSON 参数）'),
+      }, copiedKey === 'qgate' ? t('已复制') : t('查询门禁')),
       React.createElement('button', {
         className: 'iterate-btn', 'data-danger': '', 'data-copied': copiedKey === 'qgate-clear' ? '' : undefined,
         onClick: () => copyInstruction('qgate-clear', gateClearInstruction),
-        title: '复制 iterate_quality_gate clear 指令文本（重置陈旧的 FAIL 证书）',
-      }, copiedKey === 'qgate-clear' ? '已复制' : '清除门禁'),
+        title: t('复制 iterate_quality_gate clear 指令文本（重置陈旧的 FAIL 证书）'),
+      }, copiedKey === 'qgate-clear' ? t('已复制') : t('清除门禁')),
+      // Gap #4: the browser cannot read `.iterate/` directly — one click
+      // copies the pull instruction that makes the model echo it into the stream.
+      React.createElement('button', {
+        className: 'iterate-btn', 'data-copied': copiedKey === 'disk-snapshot' ? '' : undefined,
+        onClick: () => copyInstruction('disk-snapshot', pullInstruction),
+        title: t('复制拉取磁盘快照指令：让模型回显 .iterate/ 下的门禁、经验、防御事件与 transcript'),
+      }, copiedKey === 'disk-snapshot' ? t('已复制') : t('拉取磁盘快照')),
     )
 
     if (!hasGate) {
@@ -2417,17 +3007,29 @@ function ObservatoryPanel(props: SlotProps) {
         headerBar,
         React.createElement('div', { className: 'iterate-obs-block' },
           React.createElement('div', { className: 'iterate-obs-block-head' },
-            React.createElement('span', {}, '质量门禁视图'),
+            React.createElement('span', {}, t('质量门禁视图')),
             React.createElement('span', { className: 'iterate-obs-badge' }, 'v3.0'),
           ),
           React.createElement('div', { className: 'iterate-obs-block-body' },
-            React.createElement('div', { className: 'iterate-obs-msg' }, '质量门禁显示各维度收敛度、验证通过率和整体 PASS/FAIL 状态。'),
+            React.createElement('div', { className: 'iterate-obs-msg' },
+              // Gap #4: distinguish "we pulled it and it is empty" from "we
+              // never asked the model to read the disk".
+              diskEmptyStateText(pulled, t('质量门禁证书'), getLang()),
+            ),
+            React.createElement('div', { className: 'iterate-obs-msg', style: { marginTop: 6 } },
+              t('质量门禁显示各维度收敛度、验证通过率和整体 PASS/FAIL 状态。'),
+            ),
             React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 8 } },
               React.createElement('button', {
                 className: 'iterate-btn', 'data-copied': copiedKey === 'qgate-instr' ? '' : undefined,
                 onClick: () => copyInstruction('qgate-instr', gateInstruction),
-                title: '复制查询指令',
-              }, copiedKey === 'qgate-instr' ? '已复制' : '复制查询指令'),
+                title: t('复制查询指令'),
+              }, copiedKey === 'qgate-instr' ? t('已复制') : t('复制查询指令')),
+              React.createElement('button', {
+                className: 'iterate-btn', 'data-copied': copiedKey === 'disk-snapshot-2' ? '' : undefined,
+                onClick: () => copyInstruction('disk-snapshot-2', pullInstruction),
+                title: t('复制拉取磁盘快照指令'),
+              }, copiedKey === 'disk-snapshot-2' ? t('已复制') : t('拉取磁盘快照')),
             ),
           ),
         ),
@@ -2440,7 +3042,7 @@ function ObservatoryPanel(props: SlotProps) {
         React.createElement('div', { className: 'iterate-obs-block-head' },
           React.createElement('span', { className: 'iterate-gate', 'data-status': status }, statusLabel),
           React.createElement('span', { className: 'iterate-obs-head-meta' },
-            `整体评分 ${num(gate && gate.overallScore)} · 验证 ${num(gate && gate.passedChecks)}/${num(gate && gate.totalChecks)} · 通过率 ${num(gate && gate.verificationPassRate)}%`,
+            tf(`整体评分 {a0} · 验证 {a1}/{a2} · 通过率 {a3}%`, { a0: num(gate && gate.overallScore), a1: num(gate && gate.passedChecks), a2: num(gate && gate.totalChecks), a3: num(gate && gate.verificationPassRate) }),
           ),
         ),
         React.createElement('div', { className: 'iterate-obs-block-body' },
@@ -2448,7 +3050,7 @@ function ObservatoryPanel(props: SlotProps) {
             ? React.createElement('div', { className: 'iterate-obs-bar', style: { flexWrap: 'wrap', gap: 6 } },
                 ...dims.map((d, i) =>
                   React.createElement('span', { key: `gdim-${i}`, className: 'iterate-obs-chip' },
-                    `${String(d.dimension || '?')} · 收敛 ${num(d.convergenceRate)}% · 评分 ${num(d.score)}`,
+                    tf(`{a0} · 收敛 {a1}% · 评分 {a2}`, { a0: String(d.dimension || '?'), a1: num(d.convergenceRate), a2: num(d.score) }),
                   ),
                 ),
               )
@@ -2465,12 +3067,12 @@ function ObservatoryPanel(props: SlotProps) {
                     style: { width: `${fill}%` },
                   }),
                 ),
-                React.createElement('span', {}, `评分 ${num(d.score)} · 发现 ${num(d.findingsCount)} · 已修复 ${num(d.fixedCount)}`),
+                React.createElement('span', {}, tf(`评分 {a0} · 发现 {a1} · 已修复 {a2}`, { a0: num(d.score), a1: num(d.findingsCount), a2: num(d.fixedCount) })),
               )
             }),
           ),
           gate && gate.failReason
-            ? React.createElement('div', { className: 'iterate-obs-msg', style: { marginTop: 6 } }, `失败原因：${String(gate.failReason)}`)
+            ? React.createElement('div', { className: 'iterate-obs-msg', style: { marginTop: 6 } }, tf(`失败原因：{a0}`, { a0: String(gate.failReason) }))
             : null,
         ),
       ),
@@ -2483,8 +3085,8 @@ function ObservatoryPanel(props: SlotProps) {
   // (list all / search / adopt one entry).
   const renderExperienceBank = () => {
     const expInstruction = expSearch
-      ? `请调用 \`iterate_experience\` 搜索经验：\n\n\`\`\`json\n${JSON.stringify({ operation: 'search', query: expSearch }, null, 2)}\n\`\`\``
-      : '请调用 `iterate_experience` 列出所有经验'
+      ? tf(`请调用 \`iterate_experience\` 搜索经验：\n\n\`\`\`json\n{a0}\n\`\`\``, { a0: JSON.stringify({ operation: 'search', query: expSearch }, null, 2) })
+      : buildExperienceListInstruction()
 
     const expEntries = experienceBank && experienceBank.entries ? experienceBank.entries : []
     const query = expSearch.trim().toLowerCase()
@@ -2495,14 +3097,15 @@ function ObservatoryPanel(props: SlotProps) {
             .some((t) => String(t).toLowerCase().includes(query)),
         )
       : expEntries
+    const pulled = toolCalledInSession(session, 'iterate_experience')
 
     const resultRows = visible.map((e, i) => {
-      const adoptInstruction = `请调用 \`iterate_experience\` 采纳经验并应用已验证修法：\n\n\`\`\`json\n${JSON.stringify({ operation: 'get', id: e.id }, null, 2)}\n\`\`\``
+      const adoptInstruction = tf(`请调用 \`iterate_experience\` 采纳经验并应用已验证修法：\n\n\`\`\`json\n{a0}\n\`\`\``, { a0: JSON.stringify({ operation: 'get', id: e.id }, null, 2) })
       return React.createElement('div', { key: `exp-${i}`, className: 'iterate-obs-block' },
         React.createElement('div', { className: 'iterate-obs-block-head' },
           React.createElement('span', { className: 'iterate-obs-chip' }, String(e.dimension || '')),
           React.createElement('span', {}, String(e.pattern || '?')),
-          React.createElement('span', { className: 'iterate-exp-hit' }, `命中 ${e.hitCount ?? 0} 次`),
+          React.createElement('span', { className: 'iterate-exp-hit' }, tf(`命中 {a0} 次`, { a0: e.hitCount ?? 0 })),
         ),
         React.createElement('div', { className: 'iterate-obs-block-body' },
           React.createElement('div', { className: 'iterate-obs-msg' }, String(e.description || '')),
@@ -2511,8 +3114,8 @@ function ObservatoryPanel(props: SlotProps) {
               ? React.createElement('button', {
                   className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === `exp-adopt-${i}` ? '' : undefined,
                   onClick: () => copyInstruction(`exp-adopt-${i}`, adoptInstruction),
-                  title: '复制采纳指令（查询该经验并应用到当前上下文）',
-                }, copiedKey === `exp-adopt-${i}` ? '已复制' : '采纳')
+                  title: t('复制采纳指令（查询该经验并应用到当前上下文）'),
+                }, copiedKey === `exp-adopt-${i}` ? t('已复制') : t('采纳'))
               : null,
           ),
         ),
@@ -2521,20 +3124,25 @@ function ObservatoryPanel(props: SlotProps) {
 
     return React.createElement('div', {},
       React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
-        React.createElement('b', {}, '经验银行'),
-        React.createElement('span', { className: 'iterate-obs-head-meta' }, `会话内 ${expEntries.length} 条`),
+        React.createElement('b', {}, t('经验银行')),
+        React.createElement('span', { className: 'iterate-obs-head-meta' }, tf(`会话内 {a0} 条`, { a0: expEntries.length })),
         React.createElement('button', {
           className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === 'exp-list' ? '' : undefined,
-          onClick: () => copyInstruction('exp-list', '请调用 `iterate_experience` 列出所有经验'),
-          title: '复制列出经验指令',
-        }, copiedKey === 'exp-list' ? '已复制' : '列出经验'),
+          onClick: () => copyInstruction('exp-list', buildExperienceListInstruction()),
+          title: t('复制列出经验指令（含 JSON 参数）'),
+        }, copiedKey === 'exp-list' ? t('已复制') : t('列出经验')),
+        React.createElement('button', {
+          className: 'iterate-btn', 'data-copied': copiedKey === 'exp-snapshot' ? '' : undefined,
+          onClick: () => copyInstruction('exp-snapshot', pullInstruction),
+          title: t('复制拉取磁盘快照指令：把 .iterate/ 下的经验银行等产物回显进会话'),
+        }, copiedKey === 'exp-snapshot' ? t('已复制') : t('拉取磁盘快照')),
       ),
       React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
         React.createElement('input', {
           className: 'iterate-filter-search',
           type: 'search',
-          placeholder: '搜索经验模式…',
-          'aria-label': '搜索经验',
+          placeholder: t('搜索经验模式…'),
+          'aria-label': t('搜索经验'),
           value: expSearch,
           onChange: (e: React.ChangeEvent<HTMLInputElement>) => setExpSearch(e.target.value),
         }),
@@ -2542,14 +3150,18 @@ function ObservatoryPanel(props: SlotProps) {
           className: 'iterate-btn', 'data-copied': copiedKey === 'exp-search' ? '' : undefined,
           disabled: !expSearch,
           onClick: () => copyInstruction('exp-search', expInstruction),
-          title: '复制搜索指令',
-        }, copiedKey === 'exp-search' ? '已复制' : '搜索'),
+          title: t('复制搜索指令'),
+        }, copiedKey === 'exp-search' ? t('已复制') : t('搜索')),
       ),
       resultRows.length > 0
         ? React.createElement('div', {}, ...resultRows)
         : expEntries.length > 0
-          ? React.createElement('div', { className: 'iterate-obs-empty' }, '没有匹配「' + expSearch + '」的经验')
-          : React.createElement('div', { className: 'iterate-obs-empty' }, '本次会话暂无经验记录，可点击「列出经验」查询历史经验'),
+          ? React.createElement('div', { className: 'iterate-obs-empty' }, t('没有匹配「') + expSearch + t('」的经验'))
+          : React.createElement('div', {},
+              // Gap #4: separate "pulled and empty" from "never pulled".
+              React.createElement('div', { className: 'iterate-obs-empty' }, diskEmptyStateText(pulled, t('经验银行'), getLang())),
+              React.createElement('div', { className: 'iterate-obs-empty' }, t('也可点「列出经验」查询磁盘上的全部历史经验。')),
+            ),
     )
   }
 
@@ -2559,21 +3171,21 @@ function ObservatoryPanel(props: SlotProps) {
   // falsifications); copy buttons reach the back end for the full history.
   const renderDefenseEvents = () => {
     const defenseInstruction = defenseFilter
-      ? `请调用 \`iterate_defense_events\` 查询防御事件：\n\n\`\`\`json\n${JSON.stringify({ operation: 'list', type: defenseFilter || undefined }, null, 2)}\n\`\`\``
-      : '请调用 `iterate_defense_events` 列出所有防御事件'
+      ? tf(`请调用 \`iterate_defense_events\` 查询防御事件：\n\n\`\`\`json\n{a0}\n\`\`\``, { a0: JSON.stringify({ operation: 'list', type: defenseFilter || undefined }, null, 2) })
+      : buildDefenseEventsListInstruction()
 
     const typeOptions = [
-      { value: '', label: '全部类型' },
-      { value: 'precondition_failed', label: '前置校验失败' },
-      { value: 'rollback', label: '回滚' },
-      { value: 'invariant_violated', label: '不变量违反' },
-      { value: 'assumption_falsified', label: '假设被证伪' },
+      { value: '', label: t('全部类型') },
+      { value: 'precondition_failed', label: t('前置校验失败') },
+      { value: 'rollback', label: t('回滚') },
+      { value: 'invariant_violated', label: t('不变量违反') },
+      { value: 'assumption_falsified', label: t('假设被证伪') },
     ]
     const TYPE_LABEL: Record<string, string> = {
-      precondition_failed: '前置校验失败',
-      rollback: '回滚',
-      invariant_violated: '不变量违反',
-      assumption_falsified: '假设被证伪',
+      precondition_failed: t('前置校验失败'),
+      rollback: t('回滚'),
+      invariant_violated: t('不变量违反'),
+      assumption_falsified: t('假设被证伪'),
     }
 
     const counts = (defenseEvents && defenseEvents.counts) || {}
@@ -2584,23 +3196,28 @@ function ObservatoryPanel(props: SlotProps) {
       : allEvents
 
     const headerBar = React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
-      React.createElement('b', {}, '防御事件'),
-      React.createElement('span', { className: 'iterate-obs-head-meta' }, `会话内 ${allEvents.length} 条 / 累计 ${totalCount}`),
+      React.createElement('b', {}, t('防御事件')),
+      React.createElement('span', { className: 'iterate-obs-head-meta' }, tf(`会话内 {a0} 条 / 累计 {a1}`, { a0: allEvents.length, a1: totalCount })),
       React.createElement('button', {
         className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === 'defense-list' ? '' : undefined,
-        onClick: () => copyInstruction('defense-list', '请调用 `iterate_defense_events` 列出所有防御事件'),
-        title: '复制列出防御事件指令',
-      }, copiedKey === 'defense-list' ? '已复制' : '列出事件'),
+        onClick: () => copyInstruction('defense-list', buildDefenseEventsListInstruction()),
+        title: t('复制列出防御事件指令（含 JSON 参数）'),
+      }, copiedKey === 'defense-list' ? t('已复制') : t('列出事件')),
+      React.createElement('button', {
+        className: 'iterate-btn', 'data-copied': copiedKey === 'defense-snapshot' ? '' : undefined,
+        onClick: () => copyInstruction('defense-snapshot', pullInstruction),
+        title: t('复制拉取磁盘快照指令：把 .iterate/ 下的防御事件流回显进会话'),
+      }, copiedKey === 'defense-snapshot' ? t('已复制') : t('拉取磁盘快照')),
       React.createElement('button', {
         className: 'iterate-btn', 'data-copied': copiedKey === 'defense-counts' ? '' : undefined,
-        onClick: () => copyInstruction('defense-counts', '请调用 `iterate_defense_events` 查询事件统计'),
-        title: '复制统计指令',
-      }, copiedKey === 'defense-counts' ? '已复制' : '统计'),
+        onClick: () => copyInstruction('defense-counts', tf(`请调用 \`iterate_defense_events\` 查询事件统计：\n\n\`\`\`json\n{a0}\n\`\`\``, { a0: JSON.stringify({ operation: 'counts' }, null, 2) })),
+        title: t('复制统计指令（含 JSON 参数）'),
+      }, copiedKey === 'defense-counts' ? t('已复制') : t('统计')),
       React.createElement('button', {
         className: 'iterate-btn', 'data-danger': '', 'data-copied': copiedKey === 'defense-clear' ? '' : undefined,
-        onClick: () => copyInstruction('defense-clear', `请调用 \`iterate_defense_events\` 清除防御事件流：\n\n\`\`\`json\n${JSON.stringify({ operation: 'clear' }, null, 2)}\n\`\`\``),
-        title: '复制 iterate_defense_events clear 指令文本（重置陈旧事件流）',
-      }, copiedKey === 'defense-clear' ? '已复制' : '清除事件'),
+        onClick: () => copyInstruction('defense-clear', tf(`请调用 \`iterate_defense_events\` 清除防御事件流：\n\n\`\`\`json\n{a0}\n\`\`\``, { a0: JSON.stringify({ operation: 'clear' }, null, 2) })),
+        title: t('复制 iterate_defense_events clear 指令文本（重置陈旧事件流）'),
+      }, copiedKey === 'defense-clear' ? t('已复制') : t('清除事件')),
     )
 
     if (allEvents.length === 0 && totalCount === 0) {
@@ -2608,17 +3225,22 @@ function ObservatoryPanel(props: SlotProps) {
         headerBar,
         React.createElement('div', { className: 'iterate-obs-block' },
           React.createElement('div', { className: 'iterate-obs-block-head' },
-            React.createElement('span', {}, '防御事件流'),
+            React.createElement('span', {}, t('防御事件流')),
             React.createElement('span', { className: 'iterate-obs-badge' }, 'v3.0'),
           ),
           React.createElement('div', { className: 'iterate-obs-block-body' },
-            React.createElement('div', { className: 'iterate-obs-msg' }, '防御事件包括：前置校验失败、回滚、不变量违反、假设被证伪。'),
+            React.createElement('div', { className: 'iterate-obs-msg' },
+              diskEmptyStateText(toolCalledInSession(session, 'iterate_defense_events'), t('防御事件流'), getLang()),
+            ),
+            React.createElement('div', { className: 'iterate-obs-msg', style: { marginTop: 6 } },
+              t('防御事件包括：前置校验失败、回滚、不变量违反、假设被证伪。'),
+            ),
             React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 8 } },
               React.createElement('button', {
                 className: 'iterate-btn', 'data-copied': copiedKey === 'defense-instr' ? '' : undefined,
                 onClick: () => copyInstruction('defense-instr', defenseInstruction),
-                title: '复制查询指令',
-              }, copiedKey === 'defense-instr' ? '已复制' : '复制查询指令'),
+                title: t('复制查询指令'),
+              }, copiedKey === 'defense-instr' ? t('已复制') : t('复制查询指令')),
             ),
           ),
         ),
@@ -2629,7 +3251,7 @@ function ObservatoryPanel(props: SlotProps) {
       React.createElement('select', {
         className: 'iterate-filter-select',
         value: defenseFilter,
-        'aria-label': '按事件类型筛选',
+        'aria-label': t('按事件类型筛选'),
         onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setDefenseFilter(e.target.value),
       },
         ...typeOptions.map((opt) => React.createElement('option', { key: opt.value, value: opt.value }, opt.label)),
@@ -2638,8 +3260,8 @@ function ObservatoryPanel(props: SlotProps) {
         ? React.createElement('button', {
             className: 'iterate-filter-clear',
             onClick: () => setDefenseFilter(''),
-            title: '清除类型筛选',
-          }, '清除')
+            title: t('清除类型筛选'),
+          }, t('清除'))
         : null,
     )
 
@@ -2659,7 +3281,7 @@ function ObservatoryPanel(props: SlotProps) {
           React.createElement('div', { className: 'iterate-obs-block-body' },
             React.createElement('div', { className: 'iterate-obs-msg' }, String(e.description || '')),
             e.defense
-              ? React.createElement('div', { className: 'iterate-obs-msg', style: { marginTop: 4 } }, `防线：${String(e.defense)}`)
+              ? React.createElement('div', { className: 'iterate-obs-msg', style: { marginTop: 4 } }, tf(`防线：{a0}`, { a0: String(e.defense) }))
               : null,
           ),
         )
@@ -2678,7 +3300,7 @@ function ObservatoryPanel(props: SlotProps) {
       ),
       eventRows.length > 0
         ? React.createElement('div', {}, ...eventRows)
-        : React.createElement('div', { className: 'iterate-obs-empty' }, '没有匹配该类型的防御事件'),
+        : React.createElement('div', { className: 'iterate-obs-empty' }, t('没有匹配该类型的防御事件')),
     )
   }
 
@@ -2693,25 +3315,29 @@ function ObservatoryPanel(props: SlotProps) {
       const hasFindings = (manifest.findings || []).length > 0
       if (hasThreads || hasFindings) {
         return React.createElement('div', { className: 'iterate-obs-empty' },
-          React.createElement('div', {}, '实时活动流仅在运行期间记录，当前已完成。'),
+          React.createElement('div', {}, t('实时活动流仅在运行期间记录，当前已完成。')),
           React.createElement('div', { className: 'iterate-obs-bar', style: { marginTop: 8 } },
-            React.createElement('button', { className: 'iterate-btn', onClick: () => setTab('f1') }, '查看审查线程'),
-            React.createElement('button', { className: 'iterate-btn', onClick: () => setTab('f3') }, '查看发现'),
+            React.createElement('button', { className: 'iterate-btn', onClick: () => setTab('f1') }, t('查看审查线程')),
+            React.createElement('button', { className: 'iterate-btn', onClick: () => setTab('f3') }, t('查看发现')),
           ),
         )
       }
-      return React.createElement('div', { className: 'iterate-obs-empty' }, '暂无实时活动')
+      return React.createElement('div', { className: 'iterate-obs-empty' }, t('暂无实时活动'))
     }
     const types = Array.from(new Set(liveEntries.map((e) => String(e.type || 'unknown')).filter(Boolean))).sort()
     const filtered = filterLiveEntries(liveEntries, liveType)
     const rows = filtered.map((e, i) => {
       const type = String(e.type || 'unknown')
-      const meta = OBS_LIVE_META[type] || { label: String(e.type || '?'), color: OBS_LIVE_FALLBACK_COLOR }
+      // Module constants carry BOTH languages; resolve at render time so a
+      // language switch repaints the badges.
+      const meta = OBS_LIVE_META[type]
+      const typeLabel = meta ? meta.label[getLang()] : String(e.type || '?')
+      const typeColor = meta ? meta.color : OBS_LIVE_FALLBACK_COLOR
       const tool = String(e.tool || '')
       const target = String(e.target || '')
       const time = formatObsLiveTime(String(e.ts || ''))
       return React.createElement('div', { key: `live-${i}`, className: 'iterate-obs-row' },
-        React.createElement('span', { className: 'iterate-obs-livebadge', style: { color: meta.color } }, meta.label),
+        React.createElement('span', { className: 'iterate-obs-livebadge', style: { color: typeColor } }, typeLabel),
         tool
           ? React.createElement('span', { className: 'iterate-obs-chip' }, tool)
           : null,
@@ -2720,29 +3346,29 @@ function ObservatoryPanel(props: SlotProps) {
       )
     })
     const filterBar = React.createElement('div', { className: 'iterate-obs-bar', style: { marginBottom: 8 } },
-      React.createElement('b', {}, '实时活动'),
+      React.createElement('b', {}, t('实时活动')),
       React.createElement('select', {
         className: 'iterate-filter-select',
         value: liveType,
-        'aria-label': '按活动类型筛选',
+        'aria-label': t('按活动类型筛选'),
         onChange: (e: React.ChangeEvent<HTMLSelectElement>) => setLiveType(e.target.value),
       },
-        React.createElement('option', { value: '' }, '全部活动'),
+        React.createElement('option', { value: '' }, t('全部活动')),
         ...types.map((t) => React.createElement('option', { key: t, value: t }, t)),
       ),
       liveType
         ? React.createElement('button', {
             className: 'iterate-filter-clear',
             onClick: () => setLiveType(''),
-            title: '清除类型筛选',
-          }, '清除')
+            title: t('清除类型筛选'),
+          }, t('清除'))
         : null,
       React.createElement('span', { className: 'iterate-filter-count' }, `${filtered.length}/${liveEntries.length}`),
     )
     if (rows.length === 0) {
       return React.createElement('div', {},
         filterBar,
-        React.createElement('div', { className: 'iterate-obs-empty' }, '无匹配的实时活动'),
+        React.createElement('div', { className: 'iterate-obs-empty' }, t('无匹配的实时活动')),
       )
     }
     return React.createElement('div', {}, filterBar, ...rows)
@@ -2768,25 +3394,30 @@ function ObservatoryPanel(props: SlotProps) {
 
   return React.createElement('div', { 'data-iterate-root': '', 'data-iterate': 'obs', className: 'iterate-obs' },
     React.createElement('div', { className: 'iterate-obs-head', 'data-closed': open ? undefined : '', onClick: () => setOpen((v) => !v) },
-      React.createElement('span', { className: 'iterate-obs-title' }, 'iterate 观测台'),
+      React.createElement('span', { className: 'iterate-obs-title' }, t('iterate 观测台')),
       React.createElement('span', { className: 'iterate-obs-badge', 'data-live': live ? '' : undefined }, runStatusText(live, manifest)),
       React.createElement('span', { className: 'iterate-obs-head-meta' }, headMeta || 'runtime'),
+      // Gap #14: make the tab system discoverable without expanding it.
+      React.createElement('span', {
+        className: 'iterate-obs-head-meta',
+        title: obsHotkeyHint(),
+      }, obsHotkeyHint()),
       React.createElement('button', {
         className: 'iterate-btn', 'data-ghost': '',
         onClick: (e: React.MouseEvent<HTMLButtonElement>) => { e.stopPropagation(); setOpen((v) => !v) },
-      }, open ? '收起' : '展开'),
+      }, open ? t('收起') : t('展开')),
     ),
     open
       ? React.createElement('div', {},
           copyFailText
             ? React.createElement('div', { className: 'iterate-obs-block' },
                 React.createElement('div', { className: 'iterate-obs-block-head' },
-                  React.createElement('b', {}, '复制未成功'),
-                  React.createElement('span', { className: 'iterate-obs-head-meta' }, '剪贴板写入被拒绝，请手动选中下方指令复制'),
+                  React.createElement('b', {}, t('复制未成功')),
+                  React.createElement('span', { className: 'iterate-obs-head-meta' }, t('剪贴板写入被拒绝，请手动选中下方指令复制')),
                   React.createElement('button', {
-                    className: 'iterate-btn', 'data-ghost': '', 'aria-label': '关闭复制失败提示',
+                    className: 'iterate-btn', 'data-ghost': '', 'aria-label': t('关闭复制失败提示'),
                     onClick: () => setCopyFailText(null),
-                  }, '关闭'),
+                  }, t('关闭')),
                 ),
                 React.createElement('div', { className: 'iterate-obs-code' }, copyFailText),
               )
@@ -2798,17 +3429,28 @@ function ObservatoryPanel(props: SlotProps) {
             React.createElement('button', {
               className: 'iterate-btn', 'data-primary': '', 'data-copied': copiedKey === 'export' ? '' : undefined,
               onClick: exportObservatory,
-              title: '将观测台全部数据导出为 JSON（优先下载，失败则复制）',
-            }, copiedKey === 'export' ? '已导出' : '导出 JSON'),
+              title: t('将观测台全部数据导出为 JSON（优先下载，失败则复制）'),
+            }, copiedKey === 'export' ? t('已导出') : t('导出 JSON')),
+            // Gap #4: `.iterate/` artifacts are unreachable from the browser;
+            // this copies the one instruction that makes the model echo them
+            // into the session stream (which is what every panel scans).
+            React.createElement('button', {
+              className: 'iterate-btn', 'data-copied': copiedKey === 'pull-snapshot' ? '' : undefined,
+              onClick: () => copyInstruction('pull-snapshot', pullInstruction),
+              title: pullTitle,
+            }, copiedKey === 'pull-snapshot' ? t('已复制') : t('拉取磁盘快照')),
           ),
-          React.createElement('div', { className: 'iterate-obs-tabs' },
+          React.createElement('div', { className: 'iterate-obs-tabs', role: 'tablist', 'aria-label': t('观测台页签（快捷键 1-9 / 0 / -）') },
             ...OBS_TABS.map((t) =>
               React.createElement('button', {
                 key: t.key,
                 className: 'iterate-obs-tab',
+                role: 'tab',
+                'aria-selected': tab === t.key,
                 'data-active': tab === t.key ? '' : undefined,
                 onClick: () => setTab(t.key),
-              }, t.label),
+                title: t.hotkey ? tf(`{a0}（按 {a1} 切换）`, { a0: obsTabLabel(t), a1: t.hotkey }) : tf(`{a0}（按 - 切换）`, { a0: obsTabLabel(t) }),
+              }, obsTabLabel(t)),
             ),
           ),
           React.createElement('div', { className: 'iterate-obs-body' }, renderBody()),
@@ -2830,6 +3472,17 @@ function selectTurnTail(owner: SlotProps): { matched: boolean } | null {
   return null
 }
 
+/**
+ * Slot components wrapped once at module scope so the wrapper identity is
+ * stable — creating the wrapper inside the render callback would remount the
+ * subtree (and wipe triage verdicts, expanded tabs …) on every render.
+ */
+const LangDashboard = withLang(ConvergenceDashboard)
+const LangObservatory = withLang(ObservatoryPanel)
+const LangTurnTail = withLang(TurnTailEntry)
+const LangProgress = withLang(ProgressCapsule)
+const LangSettings = withLang(SettingsPanel)
+
 /**
  * Plugin client entry. Called by the dsh client runtime with its context.
  */
@@ -2839,6 +3492,15 @@ export function apply(ctx: ClientContext): void {
   themeSvc = readTheme(ctx)
   storage = createStorage()
 
+  // 1b. Language: an explicit stored choice wins, then the browser locale.
+  //     Deliberately NOT persisted here (see setLang's `persist` flag) — an
+  //     auto-detected language must not shadow a choice the user never made.
+  configureLangStorage(storage)
+  setLang(
+    detectLang(storage.get(LANG_STORAGE_KEY), typeof navigator !== 'undefined' ? navigator.language : ''),
+    false,
+  )
+
   // 2. Theme preference bootstrap.
   const savedTheme = storage.get(THEME_STORAGE_KEY)
   themeEnabled = savedTheme === null ? true : savedTheme === '1'
@@ -2873,7 +3535,7 @@ export function apply(ctx: ClientContext): void {
     slotsSvc.inject('conversation.input.dock', () =>
       slotsSvc?.register(
         { name: 'conversation.input.dock', id: 'iterate-dashboard', order: 90 },
-        (props) => React.createElement(ConvergenceDashboard, props),
+        (props) => React.createElement(LangDashboard, props),
       ),
     )
 
@@ -2882,7 +3544,7 @@ export function apply(ctx: ClientContext): void {
     slotsSvc.inject('conversation.input.dock', () =>
       slotsSvc?.register(
         { name: 'conversation.input.dock', id: 'iterate-observatory', order: 91 },
-        (props) => React.createElement(ObservatoryPanel, props),
+        (props) => React.createElement(LangObservatory, props),
       ),
     )
 
@@ -2890,7 +3552,7 @@ export function apply(ctx: ClientContext): void {
     slotsSvc.inject('conversation.chat.turnTail', () =>
       slotsSvc?.register(
         { name: 'conversation.chat.turnTail', id: 'iterate-turn-tail', select: selectTurnTail },
-        (props) => React.createElement(TurnTailEntry, props),
+        (props) => React.createElement(LangTurnTail, props),
       ),
     )
 
@@ -2898,7 +3560,7 @@ export function apply(ctx: ClientContext): void {
     slotsSvc.inject('shell.overlay', () =>
       slotsSvc?.register(
         { name: 'shell.overlay', id: 'iterate-progress', order: 0 },
-        (props) => React.createElement(ProgressCapsule, props),
+        (props) => React.createElement(LangProgress, props),
       ),
     )
 
@@ -2906,7 +3568,7 @@ export function apply(ctx: ClientContext): void {
     slotsSvc.inject('settings.section', () =>
       slotsSvc?.register(
         { name: 'settings.section', id: 'iterate-settings', order: 30, label: () => 'iterate' },
-        (props) => React.createElement(SettingsPanel, props),
+        (props) => React.createElement(LangSettings, props),
       ),
     )
   }