@stardustlc/dsh-dream 0.4.1 → 0.5.1

package/lib/client.js

@@ -2,9 +2,12 @@
 // 仓库里没有 src/client.ts，pnpm run build 也不会重写它。改面板请直接改这里，
 // 改完用 node --check lib/client.js 自检（CI 里也会跑这一步）。
 //
-// 面板只做一件事：把梦境日记（dreams.jsonl）画成人能看懂的样子 —— 概览、心境方块、
-// 教训榜、按时间倒序的梦卡片。数据来自插件自己的同源路由
-// GET /_dsh/dsh-dream/journal（由 src/index.ts 挂载）；前端不缓存业务数据，刷新即见。
+// 面板做两件事：把梦境日记（dreams.jsonl）画成人能看懂的样子 —— 概览、心境方块、
+// 教训榜、按时间倒序的梦卡片；再只读展示 M1 的技术经验（<journalDir>/knowledge/）。
+// 数据来自插件自己的同源只读路由 GET /_dsh/dsh-dream/journal 与
+// GET /_dsh/dsh-dream/knowledge（由 src/index.ts 挂载）；前端不缓存业务数据，刷新即见。
+// 经验区块只展示状态 / 条件 / 范围 / 适用与例外 / 证据摘要 / 最近核验；日志截断或坏行会明确提示，
+// 不展示权重、向量或原始 JSON。
 // 隐私纪律：面板只读，不写文件、不上传；「隐私模式」只做显示层模糊，DOM 仍是明文。
 window.__ModuleLoader__.load({ id: "@stardustlc/dsh-dream", factory: (require) => {
 var module = { exports: {} }; var exports = module.exports;
@@ -16,6 +19,9 @@ const h = React.createElement;
 
 // 相对路径按 document.baseURI 解析：反代挂在 /tools/dsh/ 这类前缀下也不会打偏。
 const ROUTE = "_dsh/dsh-dream/journal";
+const KNOWLEDGE_ROUTE = "_dsh/dsh-dream/knowledge";
+const KNOWLEDGE_LIMIT = 50;
+const KNOWLEDGE_STATES = ["candidate", "usable", "disputed", "stale", "rejected"];
 const DEFAULT_LIMIT = 50;
 const MORE_LIMIT = 500;
 const FETCH_TIMEOUT_MS = 15000;
@@ -35,9 +41,9 @@ function timestampOf(iso) {
 }
 
 /** 路由 URL：按 document.baseURI 解析，兼容反代前缀；环境不齐时退回相对路径。 */
-function routeUrl(query) {
+function routeUrlFor(route, query) {
   const suffix = query === "" || query === undefined || query === null ? "" : "?" + query;
-  const relative = ROUTE + suffix;
+  const relative = route + suffix;
   try {
     let base = null;
     if (typeof document !== "undefined" && document !== null && typeof document.baseURI === "string" && document.baseURI !== "") {
@@ -52,6 +58,11 @@ function routeUrl(query) {
   }
 }
 
+/** 梦境日记路由的快捷方式（保持既有调用语义）。 */
+function routeUrl(query) {
+  return routeUrlFor(ROUTE, query);
+}
+
 function errorMessageOf(body, status) {
   if (body !== null && typeof body === "object") {
     if (body.error !== null && typeof body.error === "object" && typeof body.error.message === "string" && body.error.message !== "") return body.error.message;
@@ -87,6 +98,29 @@ async function fetchJournal(query, limit) {
   };
 }
 
+/** GET /_dsh/dsh-dream/knowledge：只读契约体 { lessons, evidence, stats }，无查询参数。 */
+async function fetchKnowledge() {
+  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(KNOWLEDGE_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;
+  }
+  // 契约体就是 { lessons, evidence, stats }；万一被包进 { ok, value } 信封也认。
+  const data = body.value !== null && typeof body.value === "object" ? body.value : body;
+  return {
+    lessons: Array.isArray(data.lessons) ? data.lessons : [],
+    evidence: Array.isArray(data.evidence) ? data.evidence : [],
+    stats: data.stats !== null && typeof data.stats === "object" ? data.stats : null,
+  };
+}
+
 function normalizeDreams(value, limit) {
   if (!Array.isArray(value) || limit <= 0) return [];
   const out = [];
@@ -157,6 +191,150 @@ function normalizeStats(value, dreams) {
   return { total: total, moods: moods, topLessons: topLessons };
 }
 
+/** 只认契约里的 5 个状态；未知状态不冒充候选。 */
+function normalizeLessonState(value) {
+  return KNOWLEDGE_STATES.indexOf(value) !== -1 ? value : "unknown";
+}
+
+/** 状态 → 中文标签（面板文案集中在这里）。 */
+function lessonStateLabel(state) {
+  switch (state) {
+    case "candidate": return "候选（未采纳）";
+    case "usable": return "可用";
+    case "disputed": return "有冲突";
+    case "stale": return "待复核";
+    case "rejected": return "已驳回";
+    default: return "未知状态";
+  }
+}
+
+/** 状态 → 视觉类名：candidate 与 disputed 必须不同色，其余状态各自可辨。 */
+function lessonStateClass(state) {
+  switch (state) {
+    case "candidate": return "dshd-kstate-candidate";
+    case "usable": return "dshd-kstate-usable";
+    case "disputed": return "dshd-kstate-disputed";
+    case "stale": return "dshd-kstate-stale";
+    case "rejected": return "dshd-kstate-rejected";
+    default: return "dshd-kstate-unknown";
+  }
+}
+
+/** 只取字符串字段并去首尾空白；坏形状降级为 ""，不让面板崩。 */
+function trimmedText(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+/** applicability 数组 → 紧凑适用串（package + versions / platform）；坏形状跳过，空数组给 ""。 */
+function applicabilityTextOf(value) {
+  if (!Array.isArray(value)) return "";
+  const parts = [];
+  for (const raw of value) {
+    if (raw === null || typeof raw !== "object") continue;
+    const pkg = trimmedText(raw.package);
+    const versions = trimmedText(raw.versions);
+    const platform = trimmedText(raw.platform);
+    const main = pkg !== "" ? (versions !== "" ? pkg + " " + versions : pkg) : versions;
+    const bits = [];
+    if (main !== "") bits.push(main);
+    if (platform !== "") bits.push("平台 " + platform);
+    if (bits.length > 0) parts.push(bits.join(" · "));
+  }
+  if (parts.length === 0) return "";
+  if (parts.length > 4) return parts.slice(0, 4).join("；") + "；等 " + String(parts.length) + " 条适用范围";
+  return parts.join("；");
+}
+
+/**
+ * 经验视图模型：只投影展示所需字段（title / when / applicability / exceptions /
+ * state / scopeLabel / evidenceSummary / lastValidatedAt），不碰权重、向量、原始 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 statsSource = source.stats !== null && typeof source.stats === "object" ? source.stats : {};
+  const byState = {};
+  const rows = [];
+  for (const raw of rawLessons) {
+    if (raw === null || typeof raw !== "object") continue;
+    const title = trimmedText(raw.title);
+    const action = trimmedText(raw.action);
+    if (title === "" && action === "") continue;
+    const state = normalizeLessonState(raw.state);
+    byState[state] = (byState[state] || 0) + 1;
+    if (rows.length >= cap) continue;
+    const lastValidatedAt = trimmedText(raw.lastValidatedAt);
+    rows.push({
+      id: trimmedText(raw.id),
+      title: title !== "" ? title : action,
+      when: trimmedText(raw.when),
+      applicability: applicabilityTextOf(raw.applicability),
+      exceptions: Array.isArray(raw.exceptions)
+        ? raw.exceptions.filter((item) => typeof item === "string" && item.trim() !== "").map((item) => item.trim()).slice(0, 10)
+        : [],
+      state: state,
+      stateLabel: lessonStateLabel(state),
+      stateClass: lessonStateClass(state),
+      scopeLabel: trimmedText(raw.scopeLabel) || "范围未标注",
+      evidenceSummary: trimmedText(raw.evidenceSummary) || "暂无可展示的证据摘要",
+      lastValidatedAt: lastValidatedAt,
+      lastText: lastValidatedAt === "" ? "尚未核验" : relativeTime(lastValidatedAt, now),
+      lastTitle: lastValidatedAt === "" ? "没有 lastValidatedAt（从未核验）" : formatDate(lastValidatedAt) + (formatTime(lastValidatedAt) === "" ? "" : " " + formatTime(lastValidatedAt)),
+      candidate: state === "candidate",
+      disputed: state === "disputed",
+    });
+  }
+  const total = typeof statsSource.lessons === "number" && statsSource.lessons >= 0 ? statsSource.lessons : rawLessons.length;
+  const evidenceTotal = typeof statsSource.evidence === "number" && statsSource.evidence >= 0 ? statsSource.evidence : 0;
+  const badLinesRaw = statsSource.badLines;
+  const badLines = typeof badLinesRaw === "number" && Number.isFinite(badLinesRaw) && badLinesRaw > 0 ? Math.floor(badLinesRaw) : 0;
+  return {
+    rows: rows,
+    total: total,
+    shown: rows.length,
+    stats: { lessons: total, evidence: evidenceTotal, byState: byState, truncated: statsSource.truncated === true, badLines: badLines },
+  };
+}
+
+/** 经验区块的统计文案：按状态计数，不包装成可靠度。 */
+function knowledgeCountText(stats) {
+  const source = stats !== null && typeof stats === "object" ? stats : {};
+  const byState = source.byState !== null && typeof source.byState === "object" ? source.byState : {};
+  const parts = [];
+  for (const state of KNOWLEDGE_STATES) {
+    const count = typeof byState[state] === "number" && byState[state] > 0 ? byState[state] : 0;
+    if (count > 0) parts.push(lessonStateLabel(state) + " " + String(count));
+  }
+  if (parts.length === 0) {
+    const total = typeof source.lessons === "number" && source.lessons > 0 ? source.lessons : 0;
+    return total > 0 ? "共 " + String(total) + " 条" : "还没有经验";
+  }
+  return parts.join(" · ");
+}
+
+/** 截断 / 坏行提示：无问题时给 ""；确保面板不静默展示不完整的经验集。 */
+function knowledgeNoticeText(stats) {
+  const source = stats !== null && typeof stats === "object" ? stats : {};
+  const truncated = source.truncated === true;
+  const badLines = typeof source.badLines === "number" && Number.isFinite(source.badLines) && source.badLines > 0 ? Math.floor(source.badLines) : 0;
+  if (truncated !== true && badLines === 0) return "";
+  const parts = [];
+  if (truncated === true) parts.push("日志过大，仅回放最近一段事件");
+  if (badLines > 0) parts.push("有 " + String(badLines) + " 行损坏已跳过");
+  return parts.join("；") + "；events.jsonl 未改动。";
+}
+
+/** 经验区块的独立空态：与「还没有梦境日记」分开，说明经验从哪来。 */
+function knowledgeEmptyState() {
+  return {
+    title: "还没有经验记录",
+    body: "经验是带证据、有适用条件的技术结论：收尾时用 dream_learn 提交候选，证据足够、范围明确的会出现在这里。",
+    hint: "旧日记里的教训不会自动升级为经验；采纳、驳回或标记冲突请用 dream_review。",
+  };
+}
+
 function spanOf(dreams) {
   let min = null;
   let max = null;
@@ -483,6 +661,78 @@ function LessonCard(props) {
   ]);
 }
 
+function KnowledgeRow(props) {
+  const row = props.row;
+  const privacy = props.privacy === true;
+  const [peek, setPeek] = useState(false);
+  const reveal = privacy === true ? function () { setPeek(peek !== true); } : undefined;
+  return h("div", {
+    className: "dshd-knowledge " + row.stateClass + (privacy === true && peek === true ? " dshd-peek" : ""),
+    onClick: reveal,
+    title: privacy === true ? "隐私模式：点击此条临时查看" : undefined,
+  }, [
+    h("div", { className: "dshd-khead", key: "h" }, [
+      h("span", { className: "dshd-kbadge", key: "b" }, row.stateLabel),
+      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),
+    ]),
+  ]);
+}
+
+function KnowledgeCard(props) {
+  const vm = props.vm;
+  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("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)),
+      h("div", { className: "dshd-note", key: "n" }, "旧日记不受影响；修好后点「重试」。"),
+    ]);
+  }
+  if (props.empty === true) {
+    const empty = knowledgeEmptyState();
+    return h("section", { className: "dshd-card dshd-kcard" }, [
+      h("h4", { key: "t" }, "经验"),
+      noticeNode,
+      h("div", { className: "dshd-kempty", key: "e" }, [
+        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(props.loading === true
+      ? 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) {
+      return h(KnowledgeRow, { key: row.id !== "" ? row.id : "k" + String(index), row: row, privacy: props.privacy === true });
+    })),
+    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。"),
+  ]);
+}
+
 function DreamCard(props) {
   const dream = props.dream;
   const privacy = props.privacy === true;
@@ -561,6 +811,9 @@ function DreamPanel() {
   const [filters, setFilters] = useState({ moods: [], withLessons: false });
   const [filterOpen, setFilterOpen] = useState(false);
   const [limit, setLimit] = useState(DEFAULT_LIMIT);
+  const [knowledge, setKnowledge] = useState(null);
+  const [knowledgeLoading, setKnowledgeLoading] = useState(true);
+  const [knowledgeError, setKnowledgeError] = useState(null);
 
   // 搜索防抖：连续打字只发一次请求；回车立即生效。
   useEffect(function () {
@@ -587,7 +840,26 @@ function DreamPanel() {
     return function () { alive = false; };
   }, [query, reloadToken]);
 
+  // 经验区块独立取数：知识路由挂了但日记读不出来时，经验仍能显示（反之亦然）。
+  useEffect(function () {
+    let alive = true;
+    setKnowledgeLoading(true);
+    setKnowledgeError(null);
+    fetchKnowledge().then(function (payload) {
+      if (alive !== true) return;
+      setKnowledge(normalizeKnowledge(payload, new Date()));
+      setKnowledgeLoading(false);
+    }).catch(function (failure) {
+      if (alive !== true) return;
+      setKnowledgeError(failure instanceof Error ? failure : new Error(String(failure)));
+      setKnowledgeLoading(false);
+      setKnowledge(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 pristine = vm.count === 0 && query === "";
   const filterCount = filterCountOf(filters);
   const visibleDreams = applyFilters(dreams, filters);
@@ -612,6 +884,16 @@ function DreamPanel() {
   };
   const clearFilters = function () { setFilters({ moods: [], withLessons: false }); };
   const showMore = function () { if (limit < MORE_LIMIT) setLimit(MORE_LIMIT); };
+  const showKnowledge = function () { if (knowledgeLoading !== true) setReloadToken(function (value) { return value + 1; }); };
+  const knowledgeCard = h(KnowledgeCard, {
+    key: "knowledge",
+    vm: knowledgeVm,
+    loading: knowledgeLoading === true,
+    error: knowledgeError,
+    empty: knowledgeError === null && knowledgeLoading !== true && knowledgeVm.rows.length === 0,
+    privacy: privacy === true,
+    onRetry: showKnowledge,
+  });
 
   // 筛选 popover：点面板外任意处收起；纯 node 冒烟没有事件系统就跳过。
   useEffect(function () {
@@ -705,13 +987,16 @@ function DreamPanel() {
   ]);
 
   const body = function () {
-    if (loading === true && vm.count === 0) return h(Skeleton, { key: "skeleton" });
+    if (loading === true && vm.count === 0) return h("div", { key: "boot" }, [h(Skeleton, { key: "skeleton" }), knowledgeCard]);
     if (vm.count === 0) {
-      if (error !== null) return h("div", { className: "dshd-empty", key: "failed" }, [
-        h("h3", { key: "t" }, "暂时读不到梦境日记"),
-        h("p", { key: "p" }, "等宿主路由就绪后点上面的「重试」；如果一直失败，看一眼 DSH 日志里有没有 [dsh-dream] 告警。"),
+      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(EmptyState, { key: "empty", query: query, onClear: query === "" ? null : clearSearch });
+      return h("div", { key: "empty-wrap" }, [h(EmptyState, { key: "empty", query: query, onClear: query === "" ? null : clearSearch }), knowledgeCard]);
     }
     return h("div", { key: "content" }, [
       vm.showTiles
@@ -726,6 +1011,7 @@ 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)),
@@ -857,7 +1143,29 @@ const CSS = [
   ".dshd-chip{font-family:ui-monospace,Consolas,monospace;font-size:11px;background:var(--dsw-alias-bg-layer-2,rgba(0,0,0,.05));border-radius:999px;padding:2px 9px;color:var(--dsw-alias-label-tertiary,#6b7280)}",
   ".dshd-skel{height:58px;border-radius:12px;margin-bottom:8px;background:linear-gradient(90deg,var(--dsw-alias-bg-layer-2,rgba(0,0,0,.04)) 25%,color-mix(in srgb,var(--dsw-alias-label-primary,#111) 10%,transparent) 37%,var(--dsw-alias-bg-layer-2,rgba(0,0,0,.04)) 63%);background-size:400% 100%;animation:dshd-shimmer 1.4s ease infinite}",
   "@keyframes dshd-shimmer{0%{background-position:100% 0}100%{background-position:0 0}}",
-  ".dshd-footer{margin-top:12px;display:flex;align-items:center;gap:8px;justify-content:space-between;color:var(--dsw-alias-label-tertiary,#6b7280);font-size:11px;flex-wrap:wrap}"
+  ".dshd-footer{margin-top:12px;display:flex;align-items:center;gap:8px;justify-content:space-between;color:var(--dsw-alias-label-tertiary,#6b7280);font-size:11px;flex-wrap:wrap}",
+  ".dshd-kcard{margin:2px 0 14px}",
+  ".dshd-khead{display:flex;align-items:baseline;gap:8px;margin-bottom:8px}",
+  ".dshd-khead h4{margin:0;font-size:13px;font-weight:600}",
+  ".dshd-krows{display:flex;flex-direction:column;gap:7px}",
+  ".dshd-knowledge{border-left:3px solid var(--dsw-alias-label-tertiary,#6b7280);background:var(--dsw-alias-bg-layer-1,#fff);border-radius:9px;padding:8px 10px;min-width:0}",
+  ".dshd-knowledge.dshd-kstate-candidate{border-left-color:var(--dsw-alias-state-warn-primary,#f59e0b)}",
+  ".dshd-knowledge.dshd-kstate-disputed{border-left-color:var(--dsw-alias-state-error-primary,#dc2626);background:color-mix(in srgb,var(--dsw-alias-state-error-primary,#dc2626) 6%,var(--dsw-alias-bg-layer-1,#fff))}",
+  ".dshd-knowledge.dshd-kstate-usable{border-left-color:var(--dsw-alias-state-success-primary,#16a34a)}",
+  ".dshd-knowledge.dshd-kstate-stale,.dshd-knowledge.dshd-kstate-rejected,.dshd-knowledge.dshd-kstate-unknown{border-left-color:var(--dsw-alias-label-tertiary,#6b7280);opacity:.86}",
+  ".dshd-kbadge{flex:0 0 auto;font-size:11px;padding:1px 7px;border-radius:999px;background:color-mix(in srgb,var(--dsw-alias-label-primary,#111) 8%,transparent);white-space:nowrap}",
+  ".dshd-kstate-candidate .dshd-kbadge{background:color-mix(in srgb,var(--dsw-alias-state-warn-primary,#f59e0b) 22%,transparent)}",
+  ".dshd-kstate-disputed .dshd-kbadge{background:color-mix(in srgb,var(--dsw-alias-state-error-primary,#dc2626) 20%,transparent);color:var(--dsw-alias-state-error-primary,#dc2626)}",
+  ".dshd-kstate-usable .dshd-kbadge{background:color-mix(in srgb,var(--dsw-alias-state-success-primary,#16a34a) 18%,transparent)}",
+  ".dshd-ktitle{font-size:12px;font-weight:600;word-break:break-word}",
+  ".dshd-kmeta{display:flex;gap:10px;flex-wrap:wrap;font-size:11px;color:var(--dsw-alias-label-tertiary,#6b7280);margin-top:2px}",
+  ".dshd-kbody{margin-top:5px;display:flex;flex-direction:column;gap:3px;font-size:12px;word-break:break-word}",
+  ".dshd-kempty{padding:14px 10px;text-align:center;color:var(--dsw-alias-label-tertiary,#6b7280)}",
+  ".dshd-kempty-title{color:var(--dsw-alias-label-primary,#111);font-weight:600;font-size:13px;margin-bottom:4px}",
+  ".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}"
 ].join("");
 /* @ui-css-end */
 
@@ -897,6 +1205,18 @@ exports.inject = inject;
 // 纯函数内部件：验证脚本可直接取来测，不必另抄一份算法。
 exports.__internals = {
   routeUrl: routeUrl,
+  routeUrlFor: routeUrlFor,
+  KNOWLEDGE_ROUTE: KNOWLEDGE_ROUTE,
+  KNOWLEDGE_LIMIT: KNOWLEDGE_LIMIT,
+  fetchKnowledge: fetchKnowledge,
+  normalizeKnowledge: normalizeKnowledge,
+  normalizeLessonState: normalizeLessonState,
+  applicabilityTextOf: applicabilityTextOf,
+  knowledgeNoticeText: knowledgeNoticeText,
+  lessonStateLabel: lessonStateLabel,
+  lessonStateClass: lessonStateClass,
+  knowledgeCountText: knowledgeCountText,
+  knowledgeEmptyState: knowledgeEmptyState,
   fetchJournal: fetchJournal,
   normalizeDreams: normalizeDreams,
   normalizeStats: normalizeStats,

package/lib/index.d.ts

@@ -33,3 +33,6 @@ export * from './journal.js';
 export * from './tools.js';
 export * from './mask.js';
 export * from './bridge.js';
+export * from './knowledge.js';
+export * from './knowledge-store.js';
+export * from './retrieval.js';

package/lib/index.js

@@ -71,3 +71,6 @@ export * from './journal.js';
 export * from './tools.js';
 export * from './mask.js';
 export * from './bridge.js';
+export * from './knowledge.js';
+export * from './knowledge-store.js';
+export * from './retrieval.js';

package/lib/journal.d.ts

@@ -9,6 +9,19 @@ export interface DreamEntry {
 export declare function journalFile(journalDir: string): string;
 /** 追加一条梦；返回落盘后的条目。 */
 export declare function saveDream(journalDir: string, reflection: string, lessons: string[], mood: string): DreamEntry;
+/** 读取结果：梦境 + 被跳过的行数（坏 JSON 或不是梦境记录）。 */
+export interface DreamReadResult {
+    dreams: DreamEntry[];
+    skippedLines: number;
+}
+/**
+ * 倒序读取梦境并**报告**跳过了多少行。
+ *
+ * 两个健壮性要求（评审实测发现）：
+ * - 文件开头的 UTF-8 BOM 必须剥离，否则第一行解析失败会让整份日记读空；
+ * - 坏行跳过要可计数，不能静默——调用方（dream_health / 只读路由）可以透出。
+ */
+export declare function readDreamsDetailed(journalDir: string, limit: number): DreamReadResult;
 /** 倒序读取梦境（新梦在前）；损坏行跳过。 */
 export declare function readDreams(journalDir: string, limit: number): DreamEntry[];
 /** 教训榜的一行：次数与最近一次出现时间（lastAt 缺失时是空串，绝不为 null）。 */
@@ -22,6 +35,8 @@ export interface DreamStats {
     total: number;
     moods: Record<string, number>;
     topLessons: LessonStat[];
+    /** 解析时跳过的行数（坏 JSON 或不是梦境记录）；0 表示全部可读。 */
+    skippedLines: number;
 }
 /**
  * 统计梦境（基于全量日记）。

package/lib/journal.js

@@ -26,18 +26,27 @@ export function saveDream(journalDir, reflection, lessons, mood) {
 }
 /** 需要读全量日记时的上限：检索与统计共用，避免两处上限漂移。 */
 const FULL_SCAN_LIMIT = 100000;
-/** 倒序读取梦境（新梦在前）；损坏行跳过。 */
-export function readDreams(journalDir, limit) {
+/**
+ * 倒序读取梦境并**报告**跳过了多少行。
+ *
+ * 两个健壮性要求（评审实测发现）：
+ * - 文件开头的 UTF-8 BOM 必须剥离，否则第一行解析失败会让整份日记读空；
+ * - 坏行跳过要可计数，不能静默——调用方（dream_health / 只读路由）可以透出。
+ */
+export function readDreamsDetailed(journalDir, limit) {
     const file = journalFile(journalDir);
     if (!existsSync(file))
-        return [];
-    const lines = readFileSync(file, 'utf8').split('\n').filter((line) => line.trim() !== '');
-    const out = [];
+        return { dreams: [], skippedLines: 0 };
+    // 开头 BOM 不参与解析（Windows 记事本等工具会写入）。
+    const text = readFileSync(file, 'utf8').replace(/^\uFEFF/, '');
+    const lines = text.split('\n').filter((line) => line.trim() !== '');
+    const dreams = [];
+    let skippedLines = 0;
     for (const line of lines) {
         try {
             const rec = JSON.parse(line);
             if (typeof rec.reflection === 'string') {
-                out.push({
+                dreams.push({
                     id: String(rec.id ?? ''),
                     at: String(rec.at ?? ''),
                     reflection: rec.reflection,
@@ -45,10 +54,18 @@ export function readDreams(journalDir, limit) {
                     mood: typeof rec.mood === 'string' ? rec.mood : '',
                 });
             }
+            else
+                skippedLines += 1;
+        }
+        catch {
+            skippedLines += 1;
         }
-        catch { /* 损坏行跳过 */ }
     }
-    return out.reverse().slice(0, limit);
+    return { dreams: dreams.reverse().slice(0, limit), skippedLines };
+}
+/** 倒序读取梦境（新梦在前）；损坏行跳过。 */
+export function readDreams(journalDir, limit) {
+    return readDreamsDetailed(journalDir, limit).dreams;
 }
 /**
  * 统计梦境（基于全量日记）。
@@ -58,8 +75,10 @@ export function readDreams(journalDir, limit) {
  * 大小写，不再二次 flatMap（否则同一条教训的三个数值会来自不同的扫描）。
  */
 export function dreamStats(journalDir) {
-    const dreams = readDreams(journalDir, FULL_SCAN_LIMIT);
-    const moods = {};
+    const { dreams, skippedLines } = readDreamsDetailed(journalDir, FULL_SCAN_LIMIT);
+    // 无原型对象：心境是用户可控文本，'__proto__' / 'constructor' 这类键
+    // 在普通对象上会被原型吞掉或把计数变成字符串（评审实测）。
+    const moods = Object.create(null);
     const lessons = new Map();
     for (const dream of dreams) {
         const mood = dream.mood !== '' ? dream.mood : '平静';
@@ -78,7 +97,9 @@ export function dreamStats(journalDir) {
     const topLessons = [...lessons.values()]
         .sort((a, b) => b.count - a.count || b.lastAt.localeCompare(a.lastAt))
         .slice(0, 10);
-    return { total: dreams.length, moods, topLessons };
+    // 对外给普通对象副本：内部用无原型对象防键污染，但消费方（deepStrictEqual / 原型判断）
+    // 期望的是普通对象。展开赋值走 CreateDataProperty，不会触发 __proto__ setter。
+    return { total: dreams.length, moods: { ...moods }, topLessons, skippedLines };
 }
 /** 关键词检索梦境（不区分大小写，命中 reflection/lessons；扫描全量，上限见 FULL_SCAN_LIMIT）。 */
 export function searchDreams(journalDir, query, limit) {