@stardustlc/dsh-dream 0.5.1 → 0.6.0

package/lib/client.js

@@ -2,12 +2,14 @@
 // 仓库里没有 src/client.ts，pnpm run build 也不会重写它。改面板请直接改这里，
 // 改完用 node --check lib/client.js 自检（CI 里也会跑这一步）。
 //
-// 面板做两件事：把梦境日记（dreams.jsonl）画成人能看懂的样子 —— 概览、心境方块、
-// 教训榜、按时间倒序的梦卡片；再只读展示 M1 的技术经验（<journalDir>/knowledge/）。
-// 数据来自插件自己的同源只读路由 GET /_dsh/dsh-dream/journal 与
-// GET /_dsh/dsh-dream/knowledge（由 src/index.ts 挂载）；前端不缓存业务数据，刷新即见。
+// 面板做四件事：把梦境日记（dreams.jsonl）画成人能看懂的样子 —— 概览、心境方块、
+// 教训榜、按时间倒序的梦卡片；只读展示技术经验（<journalDir>/knowledge/）；
+// 只读展示「待核实」（candidate/disputed/stale + 被扣下的原因）与「写入记录」
+//（<journalDir>/bridge/ 的桥接应用记录）。
+// 数据来自插件自己的同源只读路由 GET /_dsh/dsh-dream/journal、/_dsh/dsh-dream/knowledge
+// 与 /_dsh/dsh-dream/bridge（由 src/index.ts 挂载）；前端不缓存业务数据，刷新即见。
 // 经验区块只展示状态 / 条件 / 范围 / 适用与例外 / 证据摘要 / 最近核验；日志截断或坏行会明确提示，
-// 不展示权重、向量或原始 JSON。
+// 不展示权重、向量或原始 JSON。经验行只提供「复制审阅 / 预览命令」，写操作仍在对话工具里执行。
 // 隐私纪律：面板只读，不写文件、不上传；「隐私模式」只做显示层模糊，DOM 仍是明文。
 window.__ModuleLoader__.load({ id: "@stardustlc/dsh-dream", factory: (require) => {
 var module = { exports: {} }; var exports = module.exports;
@@ -20,8 +22,11 @@ const h = React.createElement;
 // 相对路径按 document.baseURI 解析：反代挂在 /tools/dsh/ 这类前缀下也不会打偏。
 const ROUTE = "_dsh/dsh-dream/journal";
 const KNOWLEDGE_ROUTE = "_dsh/dsh-dream/knowledge";
+const BRIDGE_ROUTE = "_dsh/dsh-dream/bridge";
 const KNOWLEDGE_LIMIT = 50;
+const BRIDGE_LIMIT = 50;
 const KNOWLEDGE_STATES = ["candidate", "usable", "disputed", "stale", "rejected"];
+const HELD_STATES = ["candidate", "disputed", "stale"];
 const DEFAULT_LIMIT = 50;
 const MORE_LIMIT = 500;
 const FETCH_TIMEOUT_MS = 15000;
@@ -121,6 +126,40 @@ async function fetchKnowledge() {
   };
 }
 
+/** GET /_dsh/dsh-dream/bridge：只读契约体 { records, stats }，无查询参数。 */
+async function fetchBridgeRecords() {
+  const init = { credentials: "same-origin" };
+  if (typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function") init.signal = AbortSignal.timeout(FETCH_TIMEOUT_MS);
+  const res = await fetch(routeUrlFor(BRIDGE_ROUTE, ""), init);
+  let body = null;
+  try { body = await res.json(); } catch (error) { body = null; }
+  if (body === null || typeof body !== "object") throw new Error("服务器返回的不是 JSON（HTTP " + String(res.status) + "）");
+  if (res.ok !== true || body.ok === false) {
+    const failure = new Error(errorMessageOf(body, res.status));
+    failure.status = res.status;
+    failure.code = body.error !== null && typeof body.error === "object" ? body.error.code : undefined;
+    throw failure;
+  }
+  const data = body.value !== null && typeof body.value === "object" ? body.value : body;
+  return {
+    records: Array.isArray(data.records) ? data.records : [],
+    stats: data.stats !== null && typeof data.stats === "object" ? data.stats : null,
+  };
+}
+
+/** 复制命令到剪贴板；没有 clipboard / 被拒绝时返回 false，调用方回退为可选中文本。 */
+async function copyText(text) {
+  const value = String(text);
+  if (value === "") return false;
+  try {
+    if (typeof navigator !== "undefined" && navigator !== null && navigator.clipboard !== undefined && navigator.clipboard !== null && typeof navigator.clipboard.writeText === "function") {
+      await navigator.clipboard.writeText(value);
+      return true;
+    }
+  } catch (error) { /* 权限被拒 / 非安全上下文：回退展示可选中文本 */ }
+  return false;
+}
+
 function normalizeDreams(value, limit) {
   if (!Array.isArray(value) || limit <= 0) return [];
   const out = [];
@@ -247,13 +286,20 @@ function applicabilityTextOf(value) {
 
 /**
  * 经验视图模型：只投影展示所需字段（title / when / applicability / exceptions /
- * state / scopeLabel / evidenceSummary / lastValidatedAt），不碰权重、向量、原始 JSON。
+ * state / scopeLabel / evidenceSummary / lastValidatedAt），并派生 revision / 扣留原因 /
+ * 可桥接标记与复制命令所需的稳定字段；不碰权重、向量、原始 JSON。
  * limit 只截断渲染行数，byState 仍按全量统计；truncated / badLines 原样带给提示行。
  */
 function normalizeKnowledge(value, now, limit) {
   const source = value !== null && typeof value === "object" ? value : {};
   const cap = typeof limit === "number" && limit > 0 ? limit : KNOWLEDGE_LIMIT;
   const rawLessons = Array.isArray(source.lessons) ? source.lessons : [];
+  const lessonTitles = new Map();
+  for (const raw of rawLessons) {
+    if (raw !== null && typeof raw === "object" && trimmedText(raw.id) !== "") {
+      lessonTitles.set(trimmedText(raw.id), trimmedText(raw.title) || trimmedText(raw.action));
+    }
+  }
   const statsSource = source.stats !== null && typeof source.stats === "object" ? source.stats : {};
   const byState = {};
   const rows = [];
@@ -269,6 +315,7 @@ function normalizeKnowledge(value, now, limit) {
     rows.push({
       id: trimmedText(raw.id),
       title: title !== "" ? title : action,
+      action: action,
       when: trimmedText(raw.when),
       applicability: applicabilityTextOf(raw.applicability),
       exceptions: Array.isArray(raw.exceptions)
@@ -282,6 +329,15 @@ function normalizeKnowledge(value, now, limit) {
       lastValidatedAt: lastValidatedAt,
       lastText: lastValidatedAt === "" ? "尚未核验" : relativeTime(lastValidatedAt, now),
       lastTitle: lastValidatedAt === "" ? "没有 lastValidatedAt（从未核验）" : formatDate(lastValidatedAt) + (formatTime(lastValidatedAt) === "" ? "" : " " + formatTime(lastValidatedAt)),
+      revision: typeof raw.revision === "number" && Number.isFinite(raw.revision) && raw.revision >= 0 ? Math.floor(raw.revision) : 0,
+      independentSupportCount: typeof raw.independentSupportCount === "number" && raw.independentSupportCount > 0 ? Math.floor(raw.independentSupportCount) : 0,
+      projectId: typeof raw.scope === "object" && raw.scope !== null ? trimmedText(raw.scope.projectId) : "",
+      workspaceRoot: typeof raw.scope === "object" && raw.scope !== null ? trimmedText(raw.scope.workspaceRoot) : "",
+      conflictIds: Array.isArray(raw.conflictIds) ? raw.conflictIds.filter(function (id) { return typeof id === "string" && id.trim() !== ""; }) : [],
+      conflicts: Array.isArray(raw.conflictIds) ? raw.conflictIds.filter(function (id) { return typeof id === "string" && id.trim() !== ""; }).map(function (id) { return { id: id, title: lessonTitles.get(id) || "未加载的经验（" + id + "）" }; }) : [],
+      holdReason: trimmedText(raw.holdReason) !== "" ? trimmedText(raw.holdReason) : holdReasonOf(raw),
+      holdReasonLabel: trimmedText(raw.holdReasonLabel) !== "" ? trimmedText(raw.holdReasonLabel) : skippedReasonLabel(holdReasonOf(raw)),
+      bridgeable: bridgeableOf(raw.state) && trimmedText(raw.id) !== "",
       candidate: state === "candidate",
       disputed: state === "disputed",
     });
@@ -335,6 +391,180 @@ function knowledgeEmptyState() {
   };
 }
 
+/** 检索层 skipped reason 的中文映射（面板扣留原因文案；与 retrieval.ts 的 reason 常量同名）。 */
+function skippedReasonLabel(reason) {
+  switch (trimmedText(reason)) {
+    case "state:rejected": return "已驳回：不参与默认检索与注入";
+    case "state:stale": return "待复核：条件或依赖可能已过期，默认不注入";
+    case "state:disputed": return "冲突未解决：默认不注入，先 resolve-conflict";
+    case "candidate-hold": return "候选：可被检索到，但默认不作为任务建议注入";
+    case "no-evidence": return "证据不足：没有独立证据，默认不注入";
+    case "version-mismatch": return "版本不匹配：当前依赖版本不满足适用范围";
+    case "limit": return "超出条数预算，本次未取回";
+    case "budget-stop": return "超出字符预算：按排名整条装入，遇到第一条放不下即停";
+    case "budget": return "超出字符预算，本次未取回";
+    default: return "";
+  }
+}
+
+/** 浏览态的确定性扣留原因；version-mismatch 需要 query / 包名上下文，不在此列。 */
+function holdReasonOf(lesson) {
+  const source = lesson !== null && typeof lesson === "object" ? lesson : {};
+  const state = normalizeLessonState(source.state);
+  if (state === "disputed") return "state:disputed";
+  if (state === "stale") return "state:stale";
+  if (state === "rejected") return "state:rejected";
+  if (state === "candidate") {
+    const support = typeof source.independentSupportCount === "number" && source.independentSupportCount > 0 ? source.independentSupportCount : 0;
+    return support === 0 ? "no-evidence" : "candidate-hold";
+  }
+  return "";
+}
+
+/** 面板上的「可桥接」只按契约状态判断：usable；scope / 用户采纳等资格由 dream_bridge 执行时校验。 */
+function bridgeableOf(state) {
+  return normalizeLessonState(state) === "usable";
+}
+
+/** 复制命令里的默认 action：按状态给最常用的一步，用户可在对话里再改。 */
+function reviewActionFor(state) {
+  switch (normalizeLessonState(state)) {
+    case "candidate": return "accept";
+    case "disputed": return "resolve-conflict";
+    case "stale": return "accept";
+    case "usable": return "mark-stale";
+    case "rejected": return "reopen";
+    default: return "";
+  }
+}
+
+/** 派生 dream_review 复制命令；缺 id 时给 ""（面板不展示不可执行命令）。 */
+function reviewCommandOf(lesson, options) {
+  const source = lesson !== null && typeof lesson === "object" ? lesson : {};
+  const id = trimmedText(source.id);
+  if (id === "" || !Number.isInteger(source.revision) || source.revision < 1) return "";
+  const opts = options || {};
+  const action = opts.action || reviewActionFor(source.state);
+  if (action === "") return "";
+  const args = { action: action, lessonId: id, expectedRevision: source.revision };
+  if (action === "resolve-conflict") {
+    if (!["prefer", "drop", "merge"].includes(opts.resolution) || trimmedText(opts.note) === "" || !Array.isArray(opts.affectedIds) || opts.affectedIds.length === 0) return "";
+    args.resolution = opts.resolution;
+    args.note = opts.note.trim();
+    args.affectedIds = opts.affectedIds;
+  }
+  return "dream_review " + JSON.stringify(args);
+}
+
+/** 派生 dream_bridge preview 复制命令（单条经验）；projectId 来自 payload，scopeLabel 只展示。 */
+function bridgePreviewCommandOf(lessonId, projectId, workspaceRoot) {
+  const id = trimmedText(lessonId);
+  if (id === "") return "";
+  const project = trimmedText(projectId);
+  const args = { mode: "preview", lessonIds: [id] };
+  if (project !== "") args.projectId = project;
+  const root = trimmedText(workspaceRoot);
+  if (root !== "") args.path = root.replace(/[\\/]+$/, "") + "/AGENTS.md";
+  return "dream_bridge " + JSON.stringify(args);
+}
+
+function bridgeRollbackCommandOf(row) {
+  if (!row || row.rollbackable !== true || trimmedText(row.target) === "") return "";
+  const backupId = trimmedText(row.id) || trimmedText(row.backupId);
+  if (backupId === "") return "";
+  return "dream_bridge " + JSON.stringify({ mode: "rollback", backupId: backupId, path: row.target });
+}
+
+/** 哈希只展示前 12 位；空值给 ""。 */
+function shortHash(value) {
+  const text = trimmedText(value);
+  if (text === "") return "";
+  return text.length > 12 ? text.slice(0, 12) + "…" : text;
+}
+
+function bridgeActionLabel(action) {
+  switch (trimmedText(action)) {
+    case "create": return "新建";
+    case "replace": return "替换管理块";
+    case "append": return "追加管理块";
+    case "unchanged": return "未改动";
+    case "rollback": return "回滚";
+    default: return trimmedText(action) || "未知动作";
+  }
+}
+
+/** 写入记录视图模型：只投影展示字段，不展示原始 JSON / 管理块正文。 */
+function normalizeBridgeRecords(value, now, limit) {
+  const source = value !== null && typeof value === "object" ? value : {};
+  const cap = typeof limit === "number" && limit > 0 ? limit : BRIDGE_LIMIT;
+  const rawRecords = Array.isArray(source.records) ? source.records : [];
+  const statsSource = source.stats !== null && typeof source.stats === "object" ? source.stats : {};
+  const rows = [];
+  let rollbackableCount = 0;
+  for (const raw of rawRecords) {
+    if (raw === null || typeof raw !== "object") continue;
+    const id = trimmedText(raw.backupId);
+    const target = trimmedText(raw.target);
+    if (id === "" && target === "") continue;
+    const rollbackable = raw.rollbackable === true;
+    if (rollbackable) rollbackableCount += 1;
+    if (rows.length >= cap) continue;
+    const at = trimmedText(raw.at);
+    const lessonRefs = [];
+    if (Array.isArray(raw.lessons)) {
+      for (const item of raw.lessons) {
+        if (item !== null && typeof item === "object") {
+          const lessonId = trimmedText(item.lessonId);
+          if (lessonId === "") continue;
+          const revision = typeof item.revision === "number" && Number.isFinite(item.revision) && item.revision >= 0 ? Math.floor(item.revision) : 0;
+          lessonRefs.push(lessonId + "@" + String(revision));
+        } else if (typeof item === "string" && item.trim() !== "") {
+          lessonRefs.push(item.trim());
+        }
+      }
+    }
+    const rollbackReason = trimmedText(raw.rollbackReason);
+    rows.push({
+      id: id,
+      at: at,
+      atText: at === "" ? "时间未知" : relativeTime(at, now),
+      atTitle: at === "" ? "没有记录时间" : formatDate(at) + (formatTime(at) === "" ? "" : " " + formatTime(at)),
+      target: target || "目标未记录",
+      action: trimmedText(raw.action),
+      actionLabel: bridgeActionLabel(raw.action),
+      lessons: lessonRefs,
+      lessonsText: lessonRefs.length === 0 ? "没有经验引用" : lessonRefs.join("、"),
+      beforeShort: shortHash(raw.beforeSha256),
+      afterShort: shortHash(raw.afterSha256),
+      rollbackable: rollbackable,
+      rollbackText: rollbackable ? "可回滚" : ("不可回滚" + (rollbackReason !== "" ? "：" + rollbackReason : "")),
+      rollbackReason: rollbackReason,
+    });
+  }
+  const total = typeof statsSource.total === "number" && statsSource.total >= 0 ? statsSource.total : rawRecords.length;
+  const statsRollback = typeof statsSource.rollbackable === "number" && statsSource.rollbackable >= 0 ? statsSource.rollbackable : rollbackableCount;
+  return {
+    rows: rows,
+    total: total,
+    shown: rows.length,
+    rollbackable: statsRollback,
+  };
+}
+
+/** 「写入记录」的独立空态。 */
+function bridgeEmptyState() {
+  return {
+    title: "还没有写入记录",
+    body: "写入记录来自 dream_bridge 的 preview → apply；面板只读展示目标、时间、经验 revision 与前后哈希，不会写文件。",
+    hint: "在可桥接经验行点「复制预览命令」，回到对话里执行；写操作只在工具中完成。",
+  };
+}
+
+/** 「待核实」的独立空态。 */
+function reviewQueueEmptyState() {
+  return "没有待核实的经验 —— 候选、有冲突、待复核的经验会出现在这里，并写明被扣下的原因。";
+}
+
 function spanOf(dreams) {
   let min = null;
   let max = null;
@@ -605,6 +835,7 @@ function Btn(props) {
     onClick: props.onClick,
     disabled: props.disabled === true,
     title: props.title,
+    "aria-expanded": props["aria-expanded"],
     "aria-pressed": props.pressed === undefined ? undefined : props.pressed,
   }, props.children);
 }
@@ -654,10 +885,69 @@ function LessonCard(props) {
           h("span", { className: "dshd-lesson-meta", key: "m" }, [
             h("span", { className: "dshd-times", key: "c" }, "×", h("b", { key: "n" }, String(row.count))),
             row.lastText === "" ? null : h("span", { className: "dshd-last", key: "l", title: row.lastTitle }, row.lastText),
-            row.candidate ? h("span", { className: "dshd-badge", key: "badge" }, "桥接候选") : null,
+            row.candidate ? h("span", { className: "dshd-badge", key: "badge" }, "常见教训") : null,
           ]),
         ]))),
-    h("div", { className: "dshd-note", key: "note" }, "次数 = 日记里出现过的次数，不代表重要度；出现 ≥3 次标为「桥接候选」。是否写入 AGENTS.md 由 dream_bridge 决定。最近时间取自 stats.lastAt；统计缺失时按本页已加载的梦现算。"),
+    h("div", { className: "dshd-note", key: "note" }, "次数仅表示日记里的出现频率；出现 ≥3 次标为「常见教训」。写入项目规则前仍需核验来源并审阅经验。最近时间取自 stats.lastAt；统计缺失时按本页已加载的梦现算。"),
+  ]);
+}
+
+/** 复制命令按钮：成功给「已复制」，剪贴板不可用时回退为可选中文本。 */
+function CopyCommand(props) {
+  const command = typeof props.command === "string" ? props.command : "";
+  const [copied, setCopied] = useState(false);
+  const [failed, setFailed] = useState(false);
+  if (command === "") return null;
+  const onCopy = function () {
+    copyText(command).then(function (ok) {
+      setCopied(ok === true);
+      setFailed(ok !== true);
+    });
+  };
+  const label = props.label === undefined ? "复制命令" : props.label;
+  return h("span", { className: "dshd-copywrap" }, [
+    h(Btn, { key: "b", onClick: onCopy, disabled: props.disabled === true, title: props.title === undefined ? command : props.title }, copied === true ? "已复制" : label),
+    failed === true ? h("code", { key: "cmd", className: "dshd-cmd", tabIndex: 0 }, command) : null,
+    failed === true ? h("span", { key: "hint", className: "dshd-note" }, "剪贴板不可用：请手动选中上面的命令复制。") : null,
+  ]);
+}
+
+/** 面板保持只读：先让人看清决策，再生成可直接粘贴进对话的完整命令。 */
+function ReviewControls(props) {
+  const row = props.row;
+  const [open, setOpen] = useState(false);
+  const [action, setAction] = useState(function () { return reviewActionFor(row.state); });
+  const [resolution, setResolution] = useState("prefer");
+  const [note, setNote] = useState("");
+  const [affected, setAffected] = useState(function () { return row.conflictIds[0] || ""; });
+  const commands = row.state === "rejected" ? [["reopen", "重新送审"]]
+    : row.state === "disputed" ? [["resolve-conflict", "处理冲突"], ["reject", "驳回这条"]]
+    : [["accept", "采纳"], ["reject", "驳回"], ["mark-stale", "标记待复核"]];
+  const command = reviewCommandOf(row, { action: action, resolution: resolution, note: note, affectedIds: affected === "" ? [] : [affected] });
+  return h("div", { className: "dshd-review", onClick: function (event) { event.stopPropagation(); } }, [
+    h("div", { className: "dshd-kcmd", key: "buttons" }, [
+      h(Btn, { key: "review", onClick: function () { setOpen(!open); }, "aria-expanded": open }, open ? "收起审阅" : "审阅"),
+      row.bridgeable === true ? h(CopyCommand, { key: "preview", command: bridgePreviewCommandOf(row.id, row.projectId, row.workspaceRoot), label: "复制预览命令", title: "粘贴到对应项目对话，先查看写入差异" }) : null,
+    ]),
+    open ? h("div", { className: "dshd-reviewform", key: "form", onKeyDown: function (event) {
+      if (event.key === "Escape") { event.preventDefault(); event.stopPropagation(); setOpen(false); }
+    } }, [
+      h("label", { key: "action" }, ["审阅动作", h("select", { "aria-label": "审阅动作", value: action, onChange: function (event) { setAction(event.target.value); } }, commands.map(function (item) { return h("option", { value: item[0], key: item[0] }, item[1]); }))]),
+      action === "resolve-conflict" ? h("div", { key: "conflict" }, [
+        h("label", { key: "against" }, ["冲突经验", h("select", { "aria-label": "冲突经验", value: affected, onChange: function (event) { setAffected(event.target.value); } }, row.conflicts.map(function (item) { return h("option", { key: item.id, value: item.id, title: item.title }, item.title); }))]),
+        h("label", { key: "resolution" }, ["处理方式", h("select", { "aria-label": "处理方式", value: resolution, onChange: function (event) { setResolution(event.target.value); } }, [
+          h("option", { key: "prefer", value: "prefer" }, "采用这条，驳回对方"),
+          h("option", { key: "drop", value: "drop" }, "放弃这条，保留对方"),
+          h("option", { key: "merge", value: "merge" }, "合并到这条，对方留作历史"),
+        ])]),
+        h("label", { key: "note" }, ["处理依据", h("textarea", { "aria-label": "处理依据", rows: 2, value: note, placeholder: "说明哪个来源支持这次决定…", onChange: function (event) { setNote(event.target.value); } })]),
+      ]) : null,
+      command === "" ? h("div", { className: "dshd-note", key: "incomplete" }, row.revision < 1 ? "记录缺少版本，请刷新后重试。" : "选择冲突经验并填写处理依据后，才能生成命令。") : h("div", { key: "command" }, [
+        h("code", { className: "dshd-cmd", tabIndex: 0, key: "text" }, command),
+        h(CopyCommand, { key: "copy", command: command, label: "复制审阅命令" }),
+      ]),
+      h("div", { className: "dshd-note", key: "help" }, "复制后粘贴到 DSH 对话，请助手执行；完成后刷新。命令带版本校验，记录变化时会拒绝旧命令。"),
+    ]) : null,
   ]);
 }
 
@@ -676,25 +966,34 @@ function KnowledgeRow(props) {
       h("span", { className: "dshd-ktitle", key: "t", title: row.title }, row.title),
     ]),
     h("div", { className: "dshd-kmeta", key: "m" }, [
-      h("span", { className: "dshd-kscope", key: "s", title: "适用范围" }, row.scopeLabel),
       h("span", { className: "dshd-klast", key: "l", title: row.lastTitle }, "最近核验：" + row.lastText),
     ]),
     h("div", { className: "dshd-kbody", key: "body" }, [
       h("div", { key: "when" }, "何时用：" + (row.when !== "" ? row.when : "未标注适用条件")),
-      row.applicability !== "" ? h("div", { key: "applicability", title: row.applicability }, "适用：" + row.applicability) : null,
-      row.exceptions.length > 0 ? h("div", { key: "exceptions", title: row.exceptions.join("；") }, "例外：" + row.exceptions.join("；")) : null,
-      h("div", { key: "evidence" }, "证据：" + row.evidenceSummary),
+      h("div", { key: "action", className: "dshd-action" }, "怎么做：" + (row.action || "未标注具体动作")),
+      h("details", { key: "details", onClick: function (event) { event.stopPropagation(); } }, [
+        h("summary", { key: "summary" }, "适用范围与证据"),
+        h("div", { key: "scope" }, "范围：" + row.scopeLabel),
+        row.applicability !== "" ? h("div", { key: "applicability" }, "适用：" + row.applicability) : null,
+        row.exceptions.length > 0 ? h("div", { key: "exceptions" }, "例外：" + row.exceptions.join("；")) : null,
+        h("div", { key: "evidence" }, "证据：" + row.evidenceSummary),
+      ]),
+      props.showHoldReason === true && row.holdReasonLabel !== "" ? h("div", { key: "hold", className: "dshd-holdreason" }, "为什么被扣下：" + row.holdReasonLabel) : null,
     ]),
+    h(ReviewControls, { row: row, key: row.id + "@" + row.revision }),
   ]);
 }
 
 function KnowledgeCard(props) {
   const vm = props.vm;
+  const [stateFilter, setStateFilter] = useState("usable");
+  const [pageSize, setPageSize] = useState(5);
+  const reviewed = vm.rows.filter(function (row) { return row.state === stateFilter; });
   const notice = knowledgeNoticeText(vm === null || vm === undefined ? null : vm.stats);
   const noticeNode = notice === "" ? null : h("div", { className: "dshd-knotice", key: "notice", role: "status" }, notice);
   const head = function (extra) {
     return h("div", { className: "dshd-khead", key: "head" }, [
-      h("h4", { key: "t" }, "经验"),
+      h("h4", { key: "t" }, "已审阅经验"),
       h("span", { className: "dshd-spacer", key: "s" }),
       extra,
     ]);
@@ -723,13 +1022,119 @@ function KnowledgeCard(props) {
       ? h("span", { className: "dshd-hint", key: "loading" }, "加载中…")
       : h("span", { className: "dshd-hint", key: "count" }, knowledgeCountText(vm.stats))),
     noticeNode,
-    h("div", { className: "dshd-krows", key: "rows" }, vm.rows.map(function (row, index) {
+    h("label", { className: "dshd-note", key: "filter" }, ["查看 ", h("select", { "aria-label": "经验状态", value: stateFilter, onChange: function (event) { setStateFilter(event.target.value); setPageSize(5); } }, [
+      h("option", { key: "usable", value: "usable" }, "可用经验"), h("option", { key: "rejected", value: "rejected" }, "已驳回历史"),
+    ])]),
+    reviewed.length === 0 ? h("div", { className: "dshd-hint", key: "none" }, stateFilter === "usable" ? "暂无可用经验；待核实的记录在下方。" : "没有已驳回记录。") : null,
+    h("div", { className: "dshd-krows", key: "rows" }, reviewed.slice(0, pageSize).map(function (row, index) {
       return h(KnowledgeRow, { key: row.id !== "" ? row.id : "k" + String(index), row: row, privacy: props.privacy === true });
     })),
+    reviewed.length > pageSize ? h(Btn, { key: "next", onClick: function () { setPageSize(pageSize + 5); } }, "显示更多经验") : null,
     vm.shown < vm.total
       ? h("div", { className: "dshd-note", key: "more" }, "只显示最近 " + String(vm.shown) + " / " + String(vm.total) + " 条经验。")
       : null,
-    h("div", { className: "dshd-note", key: "note" }, "只读展示：候选可被检索到，但默认不注入任务建议、且排在可用经验之后；未经审阅不得当作已证实结论。采纳、驳回或标记冲突请用 dream_review。"),
+    h("div", { className: "dshd-note", key: "note" }, "采纳记录仍需满足当前任务的平台、版本与项目条件；来源已读不代表结论永远适用。"),
+  ]);
+}
+
+/** 「待核实」只读区块：candidate / disputed / stale + 被扣下的原因（复用 KnowledgeRow）。 */
+function ReviewQueueCard(props) {
+  const vm = props.vm;
+  const [pageSize, setPageSize] = useState(5);
+  const rows = vm !== null && vm !== undefined && Array.isArray(vm.rows)
+    ? vm.rows.filter(function (row) { return HELD_STATES.indexOf(row.state) !== -1; })
+    : [];
+  const head = function (extra) {
+    return h("div", { className: "dshd-khead", key: "head" }, [
+      h("h4", { key: "t" }, "待核实"),
+      h("span", { className: "dshd-spacer", key: "s" }),
+      extra,
+    ]);
+  };
+  if (props.error !== null && props.error !== undefined) {
+    return h("section", { className: "dshd-card dshd-kcard" }, [
+      head(h(Btn, { key: "retry", onClick: props.onRetry, disabled: props.loading === true }, "重试")),
+      h("div", { className: "dshd-hint", key: "e", role: "alert" }, "读取经验失败：" + (props.error.message === "" ? String(props.error) : props.error.message)),
+    ]);
+  }
+  if (props.loading === true) {
+    return h("section", { className: "dshd-card dshd-kcard" }, [
+      head(h("span", { className: "dshd-hint", key: "l" }, "加载中…")),
+    ]);
+  }
+  return h("section", { className: "dshd-card dshd-kcard" }, [
+    head(rows.length === 0 ? null : h("span", { className: "dshd-hint", key: "c" }, String(rows.length) + " 条待核实")),
+    rows.length === 0
+      ? h("div", { className: "dshd-kempty", key: "empty" }, [
+          h("div", { className: "dshd-kempty-title", key: "t" }, "没有待核实的经验"),
+          h("p", { className: "dshd-kempty-body", key: "b" }, reviewQueueEmptyState()),
+        ])
+      : h("div", { className: "dshd-krows", key: "rows" }, rows.slice(0, pageSize).map(function (row, index) {
+          return h(KnowledgeRow, { key: row.id !== "" ? row.id : "held-" + String(index), row: row, privacy: props.privacy === true, showHoldReason: true });
+        })),
+    rows.length > pageSize ? h(Btn, { key: "more", onClick: function () { setPageSize(pageSize + 5); } }, "显示更多待核实经验") : null,
+    h("div", { className: "dshd-note", key: "note" }, "这些经验默认不会作为任务建议注入；扣留原因来自检索层的 skipped reason。复制审阅命令后到对话里执行，面板不会写文件。"),
+  ]);
+}
+
+/** 「写入记录」只读区块：<journalDir>/bridge/ 的桥接应用记录。 */
+function BridgeLogCard(props) {
+  const vm = props.vm;
+  const head = function (extra) {
+    return h("div", { className: "dshd-khead", key: "head" }, [
+      h("h4", { key: "t" }, "写入记录"),
+      h("span", { className: "dshd-spacer", key: "s" }),
+      extra,
+    ]);
+  };
+  if (props.error !== null && props.error !== undefined) {
+    return h("section", { className: "dshd-card dshd-kcard" }, [
+      head(h(Btn, { key: "retry", onClick: props.onRetry, disabled: props.loading === true }, "重试")),
+      h("div", { className: "dshd-hint", key: "e", role: "alert" }, "读取写入记录失败：" + (props.error.message === "" ? String(props.error) : props.error.message)),
+    ]);
+  }
+  if (props.loading === true) {
+    return h("section", { className: "dshd-card dshd-kcard" }, [
+      head(h("span", { className: "dshd-hint", key: "l" }, "加载中…")),
+    ]);
+  }
+  if (vm.rows.length === 0) {
+    const empty = bridgeEmptyState();
+    return h("section", { className: "dshd-card dshd-kcard" }, [
+      h("h4", { key: "t" }, "写入记录"),
+      h("div", { className: "dshd-kempty", key: "empty" }, [
+        h("div", { className: "dshd-kempty-title", key: "t2" }, empty.title),
+        h("p", { className: "dshd-kempty-body", key: "b" }, empty.body),
+        h("p", { className: "dshd-note", key: "h" }, empty.hint),
+      ]),
+    ]);
+  }
+  return h("section", { className: "dshd-card dshd-kcard" }, [
+    head(h("span", { className: "dshd-hint", key: "c" }, String(vm.total) + " 次写入 · " + String(vm.rollbackable) + " 次可回滚")),
+    h("div", { className: "dshd-krows", key: "rows" }, vm.rows.map(function (row, index) {
+      return h("div", { className: "dshd-bridge", key: row.id !== "" ? row.id : "bridge-" + String(index) }, [
+        h("div", { className: "dshd-bridge-head", key: "h" }, [
+          h("span", { className: "dshd-kbadge", key: "a" }, row.actionLabel),
+          h("span", { className: "dshd-bridge-target", key: "t", title: row.target }, row.target),
+          h("span", { className: "dshd-spacer", key: "s" }),
+          h("span", { className: "dshd-klast", key: "at", title: row.atTitle }, row.atText),
+        ]),
+        h("div", { className: "dshd-bridge-meta", key: "m" }, [
+          h("span", { key: "lessons", title: row.lessonsText }, "经验：" + row.lessonsText),
+          row.beforeShort === "" ? null : h("span", { key: "before" }, "前哈希：" + row.beforeShort),
+          row.afterShort === "" ? null : h("span", { key: "after" }, "后哈希：" + row.afterShort),
+          h("span", { key: "rb", className: row.rollbackable === true ? "dshd-rollback-ok" : "dshd-rollback-no" }, row.rollbackText),
+        ]),
+        h("details", { key: "backup" }, [
+          h("summary", { key: "summary" }, "备份标识与回滚命令"),
+          h("code", { key: "id", className: "dshd-cmd" }, row.id),
+          row.rollbackable === true ? h("code", { key: "command", className: "dshd-cmd", tabIndex: 0 }, bridgeRollbackCommandOf(row)) : null,
+        ]),
+        row.rollbackable === true ? h(CopyCommand, { key: "rollback", label: "复制回滚命令", command: bridgeRollbackCommandOf(row), title: "粘贴到对应项目对话执行；只恢复管理块，保留块外人工内容" }) : null,
+      ]);
+    })),
+    vm.shown < vm.total ? h("div", { className: "dshd-note", key: "more" }, "只显示最近 " + String(vm.shown) + " / " + String(vm.total) + " 条记录。") : null,
+    h("div", { className: "dshd-note", key: "note" }, "只读展示：记录来自 dream_bridge 的 apply；回滚请按 dream_bridge 返回的备份标识在对话里执行，面板不会写文件。"),
   ]);
 }
 
@@ -799,6 +1204,7 @@ function Skeleton() {
 // ───────────────────────── 主面板 ─────────────────────────
 
 function DreamPanel() {
+  const [activeTab, setActiveTab] = useState("journal");
   const [dreams, setDreams] = useState([]);
   const [stats, setStats] = useState(null);
   const [loading, setLoading] = useState(true);
@@ -814,6 +1220,9 @@ function DreamPanel() {
   const [knowledge, setKnowledge] = useState(null);
   const [knowledgeLoading, setKnowledgeLoading] = useState(true);
   const [knowledgeError, setKnowledgeError] = useState(null);
+  const [bridge, setBridge] = useState(null);
+  const [bridgeLoading, setBridgeLoading] = useState(true);
+  const [bridgeError, setBridgeError] = useState(null);
 
   // 搜索防抖：连续打字只发一次请求；回车立即生效。
   useEffect(function () {
@@ -858,8 +1267,27 @@ function DreamPanel() {
     return function () { alive = false; };
   }, [reloadToken]);
 
+  // 写入记录独立取数：桥接目录不存在时返回空，不影响其余区块。
+  useEffect(function () {
+    let alive = true;
+    setBridgeLoading(true);
+    setBridgeError(null);
+    fetchBridgeRecords().then(function (payload) {
+      if (alive !== true) return;
+      setBridge(normalizeBridgeRecords(payload, new Date()));
+      setBridgeLoading(false);
+    }).catch(function (failure) {
+      if (alive !== true) return;
+      setBridgeError(failure instanceof Error ? failure : new Error(String(failure)));
+      setBridgeLoading(false);
+      setBridge(null);
+    });
+    return function () { alive = false; };
+  }, [reloadToken]);
+
   const vm = viewModelOf(dreams, stats, now);
   const knowledgeVm = knowledge === null ? { rows: [], total: 0, shown: 0, stats: null } : knowledge;
+  const bridgeVm = bridge === null ? { rows: [], total: 0, shown: 0, rollbackable: 0 } : bridge;
   const pristine = vm.count === 0 && query === "";
   const filterCount = filterCountOf(filters);
   const visibleDreams = applyFilters(dreams, filters);
@@ -894,6 +1322,22 @@ function DreamPanel() {
     privacy: privacy === true,
     onRetry: showKnowledge,
   });
+  const reviewQueueCard = h(ReviewQueueCard, {
+    key: "review-queue",
+    vm: knowledgeVm,
+    loading: knowledgeLoading === true,
+    error: knowledgeError,
+    privacy: privacy === true,
+    onRetry: showKnowledge,
+  });
+  const showBridge = function () { if (bridgeLoading !== true) setReloadToken(function (value) { return value + 1; }); };
+  const bridgeLogCard = h(BridgeLogCard, {
+    key: "bridge-log",
+    vm: bridgeVm,
+    loading: bridgeLoading === true,
+    error: bridgeError,
+    onRetry: showBridge,
+  });
 
   // 筛选 popover：点面板外任意处收起；纯 node 冒烟没有事件系统就跳过。
   useEffect(function () {
@@ -904,8 +1348,18 @@ function DreamPanel() {
       if (pop !== null && typeof pop.contains === "function" && pop.contains(event.target) === true) return;
       setFilterOpen(false);
     };
+    const onKey = function (event) {
+      if (event.key !== "Escape") return;
+      event.preventDefault();
+      event.stopPropagation();
+      event.stopImmediatePropagation();
+      setFilterOpen(false);
+      const trigger = document.querySelector(".dshd-filter button");
+      if (trigger && typeof trigger.focus === "function") trigger.focus();
+    };
     document.addEventListener("mousedown", onDown);
-    return function () { document.removeEventListener("mousedown", onDown); };
+    document.addEventListener("keydown", onKey, true);
+    return function () { document.removeEventListener("mousedown", onDown); document.removeEventListener("keydown", onKey, true); };
   }, [filterOpen]);
 
   const searchIcon = h("svg", { width: 14, height: 14, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 1.8, strokeLinecap: "round", key: "i" }, [
@@ -914,7 +1368,7 @@ function DreamPanel() {
   ]);
 
   const toolbar = h("div", { className: "dshd-toolbar", key: "toolbar" }, [
-    pristine ? null : h("div", { className: "dshd-search", key: "search" }, [
+    pristine || activeTab !== "journal" ? null : h("div", { className: "dshd-search", key: "search" }, [
       searchIcon,
       h("input", {
         key: "search-input",
@@ -935,10 +1389,10 @@ function DreamPanel() {
       }, "×"),
     ]),
     h("span", { className: "dshd-spacer", key: "spacer" }),
-    pristine ? null : h("span", { className: "dshd-hint", key: "count" }, loading === true
+    pristine || activeTab !== "journal" ? null : h("span", { className: "dshd-hint", key: "count" }, loading === true
       ? "加载中…"
       : countTextOf(query, vm.total, vm.count, filterCount, visibleDreams.length)),
-    showFilterButton === true ? h("div", { className: "dshd-filter", key: "filter" }, [
+    showFilterButton === true && activeTab === "journal" ? h("div", { className: "dshd-filter", key: "filter" }, [
       h(Btn, {
         key: "btn",
         on: filterCount > 0,
@@ -987,16 +1441,17 @@ function DreamPanel() {
   ]);
 
   const body = function () {
-    if (loading === true && vm.count === 0) return h("div", { key: "boot" }, [h(Skeleton, { key: "skeleton" }), knowledgeCard]);
+    if (activeTab === "knowledge") return h("div", { key: "knowledge-tab" }, [knowledgeCard, reviewQueueCard]);
+    if (activeTab === "bridge") return bridgeLogCard;
+    if (loading === true && vm.count === 0) return h(Skeleton, { key: "skeleton" });
     if (vm.count === 0) {
       if (error !== null) return h("div", { key: "failed-wrap" }, [
         h("div", { className: "dshd-empty", key: "failed" }, [
           h("h3", { key: "t" }, "暂时读不到梦境日记"),
           h("p", { key: "p" }, "等宿主路由就绪后点上面的「重试」；如果一直失败，看一眼 DSH 日志里有没有 [dsh-dream] 告警。"),
         ]),
-        knowledgeCard,
       ]);
-      return h("div", { key: "empty-wrap" }, [h(EmptyState, { key: "empty", query: query, onClear: query === "" ? null : clearSearch }), knowledgeCard]);
+      return h(EmptyState, { key: "empty", query: query, onClear: query === "" ? null : clearSearch });
     }
     return h("div", { key: "content" }, [
       vm.showTiles
@@ -1011,7 +1466,6 @@ function DreamPanel() {
         h(MoodCard, { key: "mood", vm: vm }),
         h(LessonCard, { key: "lessons", vm: vm }),
       ]),
-      knowledgeCard,
       h("div", { className: "dshd-listhead", key: "listhead" }, [
         h("h4", { key: "t" }, query === "" && filterCount === 0 ? "梦境时间线" : (query === "" ? "筛选结果" : "搜索结果")),
         h("span", { className: "dshd-hint", key: "n" }, listHintOf(query, vm.count, filterCount, visibleDreams.length)),
@@ -1031,10 +1485,13 @@ function DreamPanel() {
   return h("div", { className: "dshd-root" + (privacy === true ? " dshd-privacy" : ""), key: "root" }, [
     h("div", { className: "dshd-shell", key: "shell" }, [
       errorBox,
+      h("nav", { className: "dshd-tabs", key: "tabs", "aria-label": "梦境面板视图" }, [["journal", "日记"], ["knowledge", "经验"], ["bridge", "写入记录"]].map(function (item) {
+        return h("button", { key: item[0], type: "button", className: "dshd-chipbtn" + (activeTab === item[0] ? " on" : ""), "aria-pressed": activeTab === item[0], onClick: function () { setFilterOpen(false); setActiveTab(item[0]); } }, item[1]);
+      })),
       toolbar,
       privacy === true ? h("div", { className: "dshd-note", key: "privacynote", role: "status" }, "隐私模式：显示层模糊；DOM 仍为明文，不改文件、不加密。点击卡片可临时查看。") : null,
       body(),
-      h("div", { className: "dshd-footer", key: "footer" }, [
+      activeTab !== "journal" ? null : h("div", { className: "dshd-footer", key: "footer" }, [
         h("span", { key: "l" }, footerTextOf(query, limit, vm.total, vm.count)),
         h("span", { className: "dshd-spacer", key: "sp" }),
         canLoadMore === true ? h(Btn, { key: "more", onClick: showMore, disabled: loading === true }, loading === true ? "加载中…" : "显示更早的梦") : null,
@@ -1057,7 +1514,6 @@ const CSS = [
   ".dshd-root{color:var(--dsw-alias-label-primary,#111);font-size:13px;line-height:1.6}",
   ".dshd-shell{background:var(--dsw-alias-bg-layer-1,#fff);border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.08));border-radius:14px;padding:14px 16px;container-type:inline-size}",
   ".dshd-sub{color:var(--dsw-alias-label-tertiary,#6b7280);font-size:12px;margin:4px 0 12px}",
-  "@container (max-width:620px){.dshd-two{grid-template-columns:1fr}.dshd-toolbar .dshd-hint{display:none}}",
   ".dshd-toolbar{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-bottom:12px}",
   ".dshd-search{position:relative;display:flex;align-items:center;flex:1;min-width:180px}",
   ".dshd-search svg{position:absolute;left:9px;color:var(--dsw-alias-label-tertiary,#6b7280);pointer-events:none}",
@@ -1165,7 +1621,24 @@ const CSS = [
   ".dshd-kempty-body{margin:0 auto 5px;max-width:460px;font-size:12px}",
   ".dshd-knotice{font-size:11px;color:var(--dsw-alias-label-primary,#111);background:color-mix(in srgb,var(--dsw-alias-state-warn-primary,#f59e0b) 14%,transparent);border-radius:8px;padding:5px 8px;margin-bottom:7px}",
   ".dshd-privacy .dshd-kbody{filter:blur(4px)}",
-  ".dshd-privacy .dshd-knowledge.dshd-peek .dshd-kbody{filter:none}"
+  ".dshd-privacy .dshd-knowledge.dshd-peek .dshd-kbody{filter:none}",
+  ".dshd-kcmd{display:flex;gap:6px;flex-wrap:wrap;margin-top:6px}",
+  ".dshd-tabs{display:flex;gap:4px;margin-bottom:8px;flex-wrap:wrap}",
+  ".dshd-action{font-weight:500;white-space:pre-wrap}",
+  ".dshd-kbody details summary,.dshd-bridge-row details summary{cursor:pointer;color:var(--dsw-alias-label-tertiary,#6b7280);font-size:11px}",
+  ".dshd-reviewform{margin-top:8px;padding:9px;border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.12));border-radius:8px}",
+  ".dshd-reviewform label{display:flex;flex-direction:column;gap:3px;margin-bottom:6px;font-size:12px}",
+  ".dshd-reviewform select,.dshd-reviewform textarea,.dshd-kcard select{background:var(--dsw-alias-bg-layer-1,#fff);color:inherit;border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.12));border-radius:6px;max-width:100%;padding:4px;font:inherit;box-sizing:border-box}",
+  ".dshd-copywrap{display:inline-flex;flex-direction:column;gap:3px;max-width:100%;align-items:flex-start}",
+  ".dshd-cmd{display:block;font-family:ui-monospace,Consolas,monospace;font-size:11px;white-space:pre-wrap;word-break:break-all;background:var(--dsw-alias-bg-layer-2,rgba(0,0,0,.04));border-radius:6px;padding:4px 7px;user-select:text;cursor:text;color:inherit;max-width:100%}",
+  ".dshd-holdreason{font-size:11px;color:var(--dsw-alias-state-warn-primary,#f59e0b);margin-top:4px}",
+  ".dshd-bridge{background:var(--dsw-alias-bg-layer-1,#fff);border-radius:9px;padding:8px 10px;border-left:3px solid var(--dsw-alias-border-l2,rgba(0,0,0,.12));min-width:0}",
+  ".dshd-bridge-head{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap}",
+  ".dshd-bridge-target{font-size:12px;font-weight:600;word-break:break-all;min-width:0}",
+  ".dshd-bridge-meta{display:flex;gap:10px;flex-wrap:wrap;font-size:11px;color:var(--dsw-alias-label-tertiary,#6b7280);margin-top:3px}",
+  ".dshd-rollback-ok{color:var(--dsw-alias-state-success-primary,#16a34a)}",
+  ".dshd-rollback-no{color:var(--dsw-alias-label-tertiary,#6b7280)}",
+  "@container (max-width:620px){.dshd-two{grid-template-columns:1fr}.dshd-toolbar .dshd-hint{display:none}}"
 ].join("");
 /* @ui-css-end */
 
@@ -1209,6 +1682,22 @@ exports.__internals = {
   KNOWLEDGE_ROUTE: KNOWLEDGE_ROUTE,
   KNOWLEDGE_LIMIT: KNOWLEDGE_LIMIT,
   fetchKnowledge: fetchKnowledge,
+  fetchBridgeRecords: fetchBridgeRecords,
+  copyText: copyText,
+  normalizeBridgeRecords: normalizeBridgeRecords,
+  skippedReasonLabel: skippedReasonLabel,
+  holdReasonOf: holdReasonOf,
+  bridgeableOf: bridgeableOf,
+  reviewActionFor: reviewActionFor,
+  reviewCommandOf: reviewCommandOf,
+  bridgePreviewCommandOf: bridgePreviewCommandOf,
+  bridgeRollbackCommandOf: bridgeRollbackCommandOf,
+  shortHash: shortHash,
+  bridgeActionLabel: bridgeActionLabel,
+  bridgeEmptyState: bridgeEmptyState,
+  reviewQueueEmptyState: reviewQueueEmptyState,
+  BRIDGE_ROUTE: BRIDGE_ROUTE,
+  BRIDGE_LIMIT: BRIDGE_LIMIT,
   normalizeKnowledge: normalizeKnowledge,
   normalizeLessonState: normalizeLessonState,
   applicabilityTextOf: applicabilityTextOf,