@fanchao8609/agent_brain_sync 1.28.6 → 1.29.0

package/skill/abs-agent-brain-sync/SKILL.md

@@ -1,107 +1,107 @@
 ---
 name: abs-agent-brain-sync
-description: "USE FOR abs / agent-brain-sync 跨会话记忆与任务续接。触发词：用户直接输入 abs（单独一个词或 abs + 命令，如 'abs 开工'、'abs 沉淀'），以及「开工续接状态」「沉淀会话收获」「任务登记不丢」「经验落成知识页」「图谱体检」等任务。"
+description: "USE FOR abs / agent-brain-sync cross-session memory and task handoff. Triggers: the user types `abs` alone or `abs` + a command (e.g. 'abs 开工', 'abs 沉淀'), or asks to 开工续接状态 / 沉淀会话收获 / 任务登记不丢 / 经验落成知识页 / 图谱体检."
 ---
 
-# abs — 跨会话记忆 (agent-brain-sync)
+# abs — cross-session memory
 
-`.brain/` 是**你自己的跨会话记忆库**：踩过的坑、做过的决定、验证过的做法都在里面。
+`.brain/` is your memory across sessions: bugs, decisions, verified fixes.
 
-**查它是你的决定，不是别人提醒你才做。** 干活中一旦心里形成关键词、对某件事有疑问
-（这个坑以前踩过吗？这个约定是谁定的？），那一刻就主动查 —— 不要等报错、不要等用户提醒。
+**Querying it is your decision, not something you wait to be reminded of.** The moment a
+keyword forms or a question appears ("was this bug solved before?", "who decided this?"),
+search — do not wait for an error or for the user to prompt you.
 
-## 开工：跑一句就够
+## Startup: one command
 
 ```bash
 abs load
 ```
 
-它给：Rules（铁律，最先读）+ 图谱计数 + 任务板 + 最近流水 + 未填会话页提醒。
-顶部若有 `⏳ 上会话滞留`，先对账再开工 —— 做完的 `abs todo done <id>`，
-没做完的 `abs todo note <id> --note "接到哪"`。
+Returns: unfinished todos + usage + last 3 log lines. If the top shows `⏳ 上会话滞留`,
+reconcile first — finished items get `abs todo done <id> --as 落地|否决|仅方案 "结语"`,
+unfinished ones get `abs todo note <id> --note "where it stopped"`.
 
-**绝不 `cat .brain/` 通读**。要主题用检索，要单页用 `abs resolve` 后只读那一页。
+**Never `cat .brain/` end-to-end.** Search by topic; `abs resolve <page>` then read that one page.
 
-## 找东西：三档，按精确度选
+## Format gates (reject, do not guess)
 
-| 你在干什么 | 用哪个 |
-|---|---|
-| 不知道找什么，卡住了 | `abs recall [词…]` —— 按当前处境推（不给词也行） |
-| 知道关键词，要最准 | `abs search <词>` —— 亮度排序 + 邻居扩散 + 跨项目 |
-| 要字面精确、输出短 | `abs query <词…>` —— 多词 OR 命中 |
+- `todo start/add` without `--note "what"` → rejected. One sentence, verb-first, ≤40 chars.
+- `todo done` without a conclusion → rejected. Every Done line must say what happened.
+- `abs log` without a one-line conclusion → rejected.
+- index rows without a real description (date-template only) → rejected by lint.
+- Sub-items are one sentence each. Reports go to `abs log` / `sources/`, not the board.
 
-`abs search` 与 `abs query` 是**详略两档，不是重复**：前者带亮度和扩散更准，
-后者只给页名+摘要更省 token。MCP 侧分别对应 `abs_search` / `abs_query`。
+## Find knowledge: three tiers
 
-拿到页名后 `abs resolve <页名>` 反查路径，只读命中的那几页。答时用 `[[页面名]]` 标来源。
+| Situation | Command |
+|---|---|
+| Stuck, no keywords | `abs recall [词…]` — infers from current work |
+| Have keywords, want best recall | `abs search <词>` — luminance + neighbor spread, cross-project |
+| Want exact literal, short output | `abs query <词…>` — multi-word OR |
 
-## 写知识：三个落点，别混
+`search` and `query` are detailed vs short, not duplicates. MCP: `abs_search` / `abs_query`.
+Got a page name? `abs resolve <页名>` → read only that page. Cite sources as `[[页面名]]`.
 
-| 你手上的东西 | 落点 | 命令 |
-|---|---|---|
-| 一句经验，还没想清 | `sources/` 待提炼 | `abs note "一句话"` |
-| 要成页（有骨架好填） | `concepts/` | `abs concept <slug> --title "…"` |
-| 一句话记下，日期即时间线 | `concepts/` | `abs capture --layer 2/3/4 "…"` |
-| 违反就必须停下的硬约束 | index 的 `## Rules` | `abs rule add "≤42 字"` |
+## Write knowledge: three sinks, do not mix
 
-`concept` 与 `capture` 都写 `concepts/`，但产出不同：前者带四段骨架（触发场景/表现/解法/验证），
-后者只落一句话 + 日期前缀。要「写细」用 concept，要「快记」用 capture。
+| What you have | Sink | Command |
+|---|---|---|
+| One experience, not yet clear | `sources/` | `abs note "一句话"` |
+| A real page (4-section skeleton) | `concepts/` | `abs concept <slug> --title "…"` |
+| One line, date as timeline | `concepts/` | `abs capture --layer 2/3/4 "…"` |
+| Hard rule that must stop the agent | index `## Rules` | `abs rule add "≤42 字"` |
 
-**写完跑 `abs lint`**，它报死链、超限、无尾（`NO-TAIL`：页要有「做完怎么确认」那段）。
+`concept` = four sections (trigger / symptom / fix / verify). `capture` = one line + date.
+Then run `abs lint` (dead links, over-size, NO-TAIL).
 
-## 写任务：todo 是活看板
+## Tasks: the board is alive
 
 ```bash
-abs todo add <id> --note "做什么"        # 登记
-abs todo note <id> --note "到哪一步"      # 追加子项（一句话）
+abs todo start <id> --note "做什么"      # register (note required)
+abs todo note <id> --note "到哪一步"      # append child (one sentence)
 abs todo done <id> --as 落地|否决|仅方案 "结语"
 abs todo state <id> --note 进行中|讨论中|滞留中|搁置
-abs todo remove <id>                     # 删除（连子项，不可恢复）
+abs todo remove <id>                     # delete incl. children, no undo
 ```
 
-- **开工前先登记**：要动文件/跑命令就先 `start`，名字粗糙没关系（事后可 `rename`）。
-- **一段活干完立刻 done**：别攒着等大需求收尾。
-- `搁置` = 先不做、还留在看板上；`remove` = 当作没登记过。**两者别混**。
-- 随手记多句发现用 `abs todo memo <id> "…"`，不占看板。
-
-## 触发器：意图，不是关键词
+- Register before touching files. A rough id is fine (`rename` later).
+- `done` immediately when a unit of work finishes; do not batch at session end.
+- One `[进行中]` at a time. `搁置` = parked on the board; `remove` = never existed.
+- `memo` for extra notes; it does not occupy the board.
 
-句子里出现 todo / 沉淀 / load / note 这些词，若是**谈论、提问、定规则**，只回应不执行。
+## Triggers are intent, not keywords
 
-唯一例外：用户直接输入 `abs`（单独一个词或 `abs` + 命令，如 `abs 开工`）—— 明确要用 abs，
-直接执行；无子命令时走开工流程。
+`todo` / `沉淀` / `load` / `note` in a sentence that is discussion, a question, or
+rule-making → respond only, do not execute.
 
-## 文档精简（写 todo / 知识库文档必须遵守）
+Exception: the user types `abs` alone or `abs` + command → execute; no subcommand = startup.
 
-1. 所有内容服务于主题目标，无关的直接去掉。
-2. 不写没验证过的经验和总结。
-3. 层次分明，按前因后果组织，不用自造词。
-4. 禁止反问、猜测。
-5. 拒绝重复，已有文档写过的优先引用。
-6. 禁令直接了当，不唠叨。
+## Document diet (todo / knowledge pages)
 
-## ⛔ 禁止做
+1. Everything serves the topic; cut the rest.
+2. No unverified summaries. Only what was done, run, tested.
+3. Ordered, layered, plain declarative sentences. No coined words.
+4. No rhetorical questions, no guessing.
+5. No duplication — cite the other page instead.
+6. Bans are direct, not chatty.
 
-1. 禁止手工建骨架 / 手工登记任务 —— 用 `abs init` / `abs todo add`。
-2. 禁止通读 `.brain/` —— 要状态用 `abs load`，要主题用检索，要单页用 `abs resolve`。
-3. 禁止删知识页表达"已失效" —— 用 `abs supersede <页> --by <新页>`。
-4. 禁止直写 Rules —— 先提 `[Rules 提议]` 问用户，确认后 `abs rule add`。
-5. 禁止用宿主原生 todo 承载跨会话任务 —— 用 `abs todo`。
-6. 禁止编造没跑过的验证结论。
+## ⛔ Never
 
-## 需要时再查的细节
+1. Hand-build skeletons or hand-register tasks — `abs init` / `abs todo start`.
+2. Read `.brain/` end-to-end — `abs load` for state, search for topics, resolve for one page.
+3. Delete a knowledge page to mark it obsolete — `abs supersede <页> --by <新页>`.
+4. Write Rules directly — propose `[Rules 提议]`, wait for the user, then `abs rule add`.
+5. Host-native todo for cross-session work — use `abs todo`.
+6. Invent verification results that were not run.
 
-以下内容已移到图谱页，**不要凭记忆猜**，用到时读它：
+## Details live in the graph, not in memory
 
-| 要做什么 | 读哪页 |
+| Need | Read |
 |---|---|
-| 七层怎么判、`--kind` 怎么选、收尾深提炼全流程 | `abs resolve abs-skill-details` |
-| 会话页怎么落、三种骨架、与会话的挂钩 | `abs resolve session-digest-design` |
-| 新需求受理协议（先方案→登记→问开工） | `abs resolve abs-skill-details` |
-| `.brain/` 目录结构、知识页 frontmatter 格式 | `abs resolve abs-skill-details` |
-| 体检报错码含义（NO-INBOUND / NO-TAIL / …） | `abs resolve abs-skill-details` |
-
-## 自我约束
+| Seven layers, `--kind`, deep wrap-up | `abs resolve abs-skill-details` |
+| Session page shapes, ingest hooks | `abs resolve session-digest-design` |
+| New-request protocol (plan → register → start) | `abs resolve abs-skill-details` |
+| `.brain/` layout, frontmatter | `abs resolve abs-skill-details` |
+| Lint codes (NO-INBOUND / NO-TAIL / …) | `abs resolve abs-skill-details` |
 
-只读写 `.brain/` 与目标代码，不动全局配置（一次性接入除外）；
-双链、frontmatter、index 必须自洽 —— 坏链等于掰断接力棒。
+Only read/write `.brain/` and target code. Broken dual-links = broken handoff.

package/src/brain/ingest.js

@@ -12,11 +12,17 @@
 //   判断仍是 agent 的 —— 这里不猜语义，只把会话里**已经存在的**事实整理成页。
 //
 // 双向挂钩（用户 2026-11-05 要求「资料要与 pi 的会话挂钩」）：
-//   页 → 会话：frontmatter 记 session / session-file / project
-//   会话 → 页：页文件名带会话 id 前 8 位（`log-<日期>-s<8位>.md`），
-//             拿会话文件就能反查有没有被总结过（summon 的 md5 账本同理）。
+//   页 → 会话：段内的 `挂钩: session=… session-file=… project=…` 一行
+//   会话 → 页：段标题 `## 会话 <会话 id 前 8 位>`，拿会话文件就能在当天页里反查
+//             有没有被总结过（summon 的 md5 账本同理）。
 //   为什么不把「页路径」回写进 jsonl：pi 的会话文件是宿主的产物，
 //   往里加字段既越界又会让 md5 变化，导致账本把已总结的会话又当成「有更新」。
+//
+// 落点为何是「当天的 log-<日期>.md」而不是「一场一张 session-<日期>-s<id8>.md」
+// （2026-11-08 用户定）：同一天多场会话会散成多个文件，而且 todo.md 的归档行用
+//   `[[log-<日期>]]`、这里用 `[[session-…]]`，同一个东西两套名字。
+//   用户原话：「生成的文件标签要一致」「这些乱名称 不标准的名称……以后绝对不允许出现」。
+//   现约定：sessions/ 只收 `log-<日期>[-<slug>].md`，lint 的 SESSIONS-NAMING 强制。
 
 import { promises as fs } from 'node:fs';
 import { join, basename } from 'node:path';
@@ -26,6 +32,8 @@ import { requireUser, atTag } from '../userconfig.js';
 import { today } from '../todo.js';
 import { registerInIndex } from '../note.js';
 import { clip } from '../text.js';
+import { editFile, SKIP } from '../lock.js';
+import { DIR_LAYER } from './layers.js';
 import { digestSession, sessionsRoot, projectDirName, updateLedger, markSummarized, ledgerPath, md5Of } from './summon.js';
 
 /** 会话页的三种形状。形状由「改了什么东西」机械判定，不让模型猜。 */
@@ -155,39 +163,103 @@ function usableHeadline(u) {
   return true;
 }
 
-/** 会话页的 markdown 正文。值留空位 —— 内容由 agent 读会话后填。 */
-export function renderPage({ shape, digest, ids, who }) {
-  const sh = SHAPES[shape];
-  const files = [...digest.filesEdited.keys()];
-  const head = headlineOf(digest);
-  const body = [
+/** 会话段的标题：`## 会话 <会话 id 前 8 位>`。
+ *  这就是「会话 → 段」的反查凭据 —— 拿会话文件在当天页里搜这行即可。 */
+export function digestSectionOf(short) {
+  return `## 会话 ${short || 'unknown'}`;
+}
+
+/** 当天页的骨架。会话摘要并进来后，一页就是「这一天的一切」：
+ *  多个 `## 会话 <id8>` 段 + `## 📦 任务归档` 段（后者由 abs todo archive 追写）。 */
+export function renderDayPage({ ids, who, section }) {
+  const day = ids.day || today();
+  return [
     '---',
-    `title: ${head || '会话 ' + (ids.short || ids.day)}`,
-    'tags: [session-digest, 会话]',
-    'layer: 5',
-    `kind: session-digest`,
+    'tags: [session-log, session-digest, 会话]',
+    `layer: ${DIR_LAYER.sessions}`,
+    'kind: session-digest',
     `author: ${who}`,
-    `updated: ${ids.day || today()}`,
+    `updated: ${day}`,
     'status: draft',
-    // ── 与 pi 会话的挂钩（三行缺一不可）──
-    // session: pi 的会话 id（首行 type:session 的 id 字段），唯一且不随文件名变
-    // session-file: 会话 jsonl 的文件名，能直接定位到文件
-    // project: 会话发生时的 cwd，跨项目时靠它知道上下文属于哪
-    `session: ${ids.id}`,
-    `session-file: ${ids.name}`,
-    `project: ${digest.cwd || ''}`,
     '---',
     '',
-    `# 会话：${head || ids.day}`,
+    `# ${day} 记录`,
+    '',
+    '> 本页 = 该日的一切：会话摘要（一场一段 `## 会话 <id8>`）+ 从 `todo.md` Done 区迁出的任务明细。',
+    '',
+    section.replace(/\s*$/, ''),
+    '',
+  ].join('\n');
+}
+
+/** 已有当天页被并入会话摘要时，补上「这页含会话摘要」的 frontmatter 标记。
+ *
+ * 为何必须补（2026-11-05 实测的检索保护）：空骨架会话段有高词频、正文又短，
+ *   bm25 天然占优 —— 实测 20 张空骨架把真知识页全挤出结果。保护靠两条，
+ *   两条都只认 `kind: session-digest`：db 的 unfilled 列（整页排除出检索）
+ *   与 0.5 亮度折扣。缺 kind 就等于这层保护失效。
+ * 已存在的 tags/status/updated 一律不动 —— 那是那天的记录，机器不替它改。 */
+export function ensureDigestFrontmatter(body) {
+  const t = String(body || '');
+  if (!t.startsWith('---\n')) return t;
+  const end = t.indexOf('\n---', 3);
+  if (end === -1) return t;
+  const fm = t.slice(4, end);
+  const add = [];
+  if (!/^kind:\s/m.test(fm)) add.push('kind: session-digest');
+  if (!/^layer:\s/m.test(fm)) add.push(`layer: ${DIR_LAYER.sessions}`);
+  if (!add.length) return t;
+  return `---\n${fm.replace(/\s*$/, '')}\n${add.join('\n')}${t.slice(end)}`;
+}
+
+/** 把会话段并进当天页。位置：`## 📦 任务归档` 之前（会话在前、归档在后）；
+ *  没有归档段就放到 `## 关联连接` 之前；都没有就追加到末尾。 */
+export function insertDigestSection(body, section) {
+  const t = String(body || '');
+  const lines = t.split('\n');
+  const at = ['## 📦 任务归档', '## 关联连接']
+    .map((h) => lines.findIndex((l) => l.trim() === h))
+    .filter((i) => i !== -1)
+    .sort((a, b) => a - b)[0];
+  const block = section.replace(/\s*$/, '');
+  if (at === undefined) return `${t.replace(/\s*$/, '')}\n\n${block}\n`;
+  const head = lines.slice(0, at).join('\n').replace(/\s*$/, '');
+  const tail = lines.slice(at).join('\n').replace(/\s*$/, '');
+  return `${head}\n\n${block}\n\n${tail}\n`;
+}
+
+/** `--force`：把已有那一段重建回空骨架（段内已填的结论会被覆盖，调用方要先警告）。 */
+export function replaceDigestSection(body, section, short) {
+  const t = String(body || '');
+  const lines = t.split('\n');
+  const i = lines.findIndex((l) => l.trim() === digestSectionOf(short));
+  if (i === -1) return insertDigestSection(t, section);
+  let j = i + 1;
+  while (j < lines.length && !/^#{1,2}\s/.test(lines[j].trim())) j++;
+  return [...lines.slice(0, i), ...section.replace(/\s*$/, '').split('\n'), '', ...lines.slice(j)]
+    .join('\n');
+}
+
+/** 会话段的 markdown。值留空位 —— 内容由 agent 读会话后填。
+ *  段标题层级从 `##` 降为 `###`：外面套了一层 `## 会话 <id8>`，一天多场不会撞标题。 */
+export function renderDigestSection({ shape, digest, ids, who }) {
+  const sh = SHAPES[shape];
+  const files = [...digest.filesEdited.keys()];
+  const head = headlineOf(digest);
+  const body = [
+    digestSectionOf(ids.short),
     '',
     `> ${ids.day} · ${sh.label} · 用户发言 ${digest.users.length} 句 · 工具调用 ${digest.toolCalls} 次`,
+    `> 会话：${head || ids.day}`,
+    `> 挂钩: session=${ids.id} · session-file=${ids.name} · project=${digest.cwd || ''}`,
+    `> 沉淀者: ${who}`,
     '',
   ];
   for (const [title, hint] of sh.sections) {
-    body.push(`## ${title}`, `<!-- ${hint} -->`, '');
+    body.push(`### ${title}`, `<!-- ${hint} -->`, '');
   }
   if (files.length) {
-    body.push('## 改过的文件');
+    body.push('### 改过的文件');
     for (const f of files.slice(0, 40)) {
       body.push(`- \`${f}\` ×${digest.filesEdited.get(f)}`);
     }
@@ -195,7 +267,7 @@ export function renderPage({ shape, digest, ids, who }) {
     body.push('');
   }
   body.push(
-    '## 用户原话',
+    '### 用户原话',
     '<!-- 从会话文件提取的原始诉求，按发生顺序。写上面几段时以这里为依据 -->',
   );
   for (const u of digest.users.slice(0, 20)) {
@@ -204,8 +276,8 @@ export function renderPage({ shape, digest, ids, who }) {
   if (digest.users.length > 20) body.push(`- …另有 ${digest.users.length - 20} 句`);
   body.push(
     '',
-    '## 关联连接',
-    `- ${atTag(who)} — 本页沉淀者`,
+    '### 关联连接',
+    `- ${atTag(who)} — 本场沉淀者`,
     '（把本场会话改到的知识页挂在这里，双向可回溯）',
     '',
   );
@@ -295,40 +367,46 @@ export async function cmdIngest({ dir, file, force = false, mark = false, last =
   const sessOut = brainPath(root, 'sessions');
   await fs.mkdir(sessOut, { recursive: true });
 
-  // 文件名带会话 id 前 8 位 —— 这是「会话 → 页」的反查凭据（用户 2026-11-05 要求）。
-  // 不带 id 只按日期命名会和当天的 log-<日期>.md 撞，且无法区分同日多场会话。
-  const slug = `session-${ids.day || today()}-s${ids.short || 'unknown'}`;
+  // 落页位置 = 当天的 `log-<日期>.md`（2026-11-08 用户定「一天一文件」）。
+  // 会话 → 段的凭据是段标题 `## 会话 <id8>`：拿会话文件能在当天页里搜到它。
+  const short = ids.short || 'unknown';
+  const slug = `log-${ids.day || today()}`;
   const dst = join(sessOut, `${slug}.md`);
 
-  try {
-    await fs.access(dst);
-    if (!force) {
-      // 提示写得直白（2026-11-05 实测）：开发时自己就误用 --force 覆盖掉填好的页。
-      // 会丢的是「三段结论 + 关联连接」—— 重建回来的只是空骨架 + 素材，
-      // 那些结论要重读整场会话才能写回来。这不是一个小损失，所以文案要点明。
-      return [
-        `• 已有会话页，不覆盖 → .brain/sessions/${slug}.md`,
-        '  --force 会把它重建回空骨架：三段结论与关联连接全部丢失，只剩素材。',
-        '  只想要素材、保留结论 → 直接读那张页；确定要重填再用 --force。',
-      ].join('\n');
-    }
-  } catch { /* 不存在，正常写入 */ }
+  // 幂等判据从「文件存在吗」改成「这一天页里已有这场会话的段吗」——
+  // 一天一文件后，同一天多场会话挂在同一个文件里，文件粒度不区分场次。
+  // 读-改-写必须走 editFile 锁：abs todo archive 也在写同一个文件，
+  // 裸 readFile+rename 会让两边互相覆盖（archive.js 的同一坑，已修）。
+  let existed = false;
+  await editFile(dst, (cur) => {
+    const has = String(cur || '').split('\n').some((l) => l.trim() === digestSectionOf(short));
+    if (has && !force) { existed = true; return SKIP; }
+    const section = renderDigestSection({ shape, digest, ids, who });
+    let text;
+    if (cur == null) text = renderDayPage({ ids, who, section });
+    else if (has) text = replaceDigestSection(cur, section, short);   // --force：只重建这一段
+    else text = insertDigestSection(ensureDigestFrontmatter(cur), section);
+    return { text };
+  });
+  if (existed) {
+    // 提示写得直白（2026-11-05 实测的收益要保住）：开发时自己就误用 --force
+    // 覆盖掉填好的段。会丢的是「三段结论 + 关联连接」—— 重建回来的只是空骨架 + 素材。
+    return [
+      `• 这一天页已有本场会话段，不覆盖 → .brain/sessions/${slug}.md（## 会话 ${short}）`,
+      '  --force 会把这一段重建回空骨架：三段结论与关联连接全部丢失，只剩素材。',
+      '  只想要素材、保留结论 → 直接读那一段；确定要重填再用 --force。',
+    ].join('\n');
+  }
 
-  const body = renderPage({ shape, digest, ids, who });
   // 骨架段里的 <!-- 提示 --> 占位**故意保留**：它告诉填页的人每段该写什么。
   // 它不会干扰「填没填」的判定 —— load 的 digestFilled 与 lint 的 hasTail
   // 都把占位注释当空内容（2026-11-05 审查：原注释声称「去掉注释」但代码没做，
-  // 注释与实现不符已改正）。
-  // tmp + rename 原子落盘（并发读不会读到半写文件）
-  const tmp = join(sessOut, `.${slug}.md.tmp-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`);
-  await fs.writeFile(tmp, body, 'utf8');
-  await fs.rename(tmp, dst);
-
+  // 注释与实现不符已改正）。写盘由 editFile 锁内完成，并发读不会读到半写文件。
   await registerInIndex(root, 'Sessions', slug, `会话：${headlineOf(digest) || ids.day}`);
 
   // 不写 log.md（2026-11-05，沿用 abs concept 的既有判据）：
-  // 「新建了会话页 X」是**命令的副作用**，不是工作成果 —— 零信息量，
-  // 而「该页存在」已由 registerInIndex 落在 index 的 Sessions 区。
+  // 「并入了一场会话摘要」是**命令的副作用**，不是工作成果 —— 零信息量，
+  // 而「这一天页存在」已由 registerInIndex 落在 index 的 Sessions 区。
   // 更要紧的是：--auto 在每次关会话时跑，一天开 10 次就刷 10 行流水，
   // 靠事后清理治不了（abs concept 当初正是因为「建 10 页 = 10 行噪声」才删掉这次调用的）。
 
@@ -366,11 +444,11 @@ export async function cmdIngest({ dir, file, force = false, mark = false, last =
 
   const sh = SHAPES[shape];
   return [
-    `✓ 会话页 → .brain/sessions/${slug}.md`,
+    `✓ 会话摘要 → .brain/sessions/${slug}.md（${digestSectionOf(short)}）`,
     `  ${ids.day} · ${sh.label}（判据: ${sh.when}）`,
     `  用户 ${digest.users.length} 句 · 工具 ${digest.toolCalls} 次 · 改过 ${digest.filesEdited.size} 个文件`,
     `  挂钩: session=${ids.id} file=${hit}`,
-    '  骨架已给好，三段内容要读会话后填；填完 status 改 active。',
+    '  骨架已给好，三段内容要读会话后填；填完段内写实、别再留 <!-- 提示 -->。',
   ].join('\n') + markNote;
 }
 

package/src/brain/layers.js

@@ -131,7 +131,7 @@ export function layerConflict(body, dirName) {
 export const DIGEST_SECTIONS = ['出了什么问题', '怎么解决的', '验证什么命令',
   '做了什么操作', '结果怎样', '下次注意事项', '谈成了什么', '没结论的地方'];
 
-/** 会话页的三段骨架里有没有任何一段写了真内容。
+/** 会话摘要的骨架段里有没有任何一段写了真内容。
  *
  * 为何要这个判据（2026-11-05 实测）：`ingest --auto` 每次关会话都落一张空骨架，
  *   而空骨架的「用户原话」段有高词频、正文又短 —— bm25 天然占优。
@@ -141,15 +141,21 @@ export const DIGEST_SECTIONS = ['出了什么问题', '怎么解决的', '验证
  *
  * 判据：骨架段内除占位注释与空行外还有没有真内容。
  * 不看 status —— 人可能填完忘了改 active，用 status 会漏判。
- * 只看骨架段，不数「用户原话/改过的文件」—— 那两段是素材，不是填写成果。 */
+ * 只看骨架段，不数「用户原话/改过的文件」—— 那两段是素材，不是填写成果。
+ *
+ * 段标题层级不写死（2026-11-08）：摘要现在并进当天的 `log-<日期>.md`，
+ *   骨架段降为 `###`（`## 会话 <id8>` 是容器）。同一段名叫 `##` 或 `###` 都算，
+ *   段的结束判据改成「遇到同级或更高级的标题」。 */
 export function digestFilled(body) {
   const lines = String(body || '').split('\n');
   for (let i = 0; i < lines.length; i++) {
-    const h = lines[i].match(/^##\s+(.+?)\s*$/);
-    if (!h || !DIGEST_SECTIONS.includes(h[1].trim())) continue;
+    const h = lines[i].match(/^(#{2,4})\s+(.+?)\s*$/);
+    if (!h || !DIGEST_SECTIONS.includes(h[2].trim())) continue;
+    const lvl = h[1].length;
     for (let j = i + 1; j < lines.length; j++) {
       const t = lines[j].trim();
-      if (/^##\s/.test(t)) break;                            // 下一段开始
+      const hh = t.match(/^(#+)\s/);
+      if (hh && hh[1].length <= lvl) break;                  // 同级/更高级标题 = 本段结束
       if (!t) continue;
       if (t.startsWith('<!--') || t === '-->') continue;      // 占位注释不算填
       return true;