@fanchao8609/agent_brain_sync 1.24.0 → 1.25.1

package/hooks/abs-rounded-editor/format.ts

@@ -0,0 +1,60 @@
+/**
+ * 圆角输入框的纯格式化函数（无宿主依赖，可单测）。
+ *
+ * 单独成文件的原因：hooks/pi-rounded-editor.ts 要 import `@earendil-works/pi-coding-agent`，
+ * 测试进程里没有这个包；把纯函数抽出来才能直接 import 断言。
+ */
+
+/** 把模型 id 压短：只留最后一段，去掉日期后缀。deepseek/deepseek-v4.1-flash → deepseek-v4.1-flash */
+export function shortenModel(id: string): string {
+  if (!id) return ''
+  const tail = id.split('/').pop() || id
+  return tail.replace(/-\d{8}$/, '')
+}
+
+/** 把 token 数压成 1.0M / 280k 这种短写。 */
+export function shortTokens(n: number | null | undefined): string {
+  if (n == null || !Number.isFinite(n)) return '?'
+  if (n >= 1e6) return `${(n / 1e6).toFixed(1)}M`
+  if (n >= 1e3) return `${Math.round(n / 1e3)}k`
+  return String(n)
+}
+
+/** 拼右上角状态：`8.0%/1.0M 模型名`。缺哪段就省哪段。 */
+export function buildStatus(usage: any, modelId: string): string {
+  const parts: string[] = []
+  if (usage && usage.percent != null) parts.push(`${usage.percent.toFixed(1)}%`)
+  if (usage && usage.contextWindow) parts.push(`/${shortTokens(usage.contextWindow)}`)
+  const model = shortenModel(modelId)
+  return [parts.join(''), model].filter(Boolean).join(' ')
+}
+
+export function stripAnsi(s: string): string {
+  return s.replace(/\x1b\[[0-9;]*m/g, '')
+}
+
+/**
+ * 把一行边框文本换成「左圆角 + 中段 + 右圆角」，可见宽度保持原样。
+ * 边框行内含 ANSI 时直接 slice 会切坏转义序列，所以先剥色、改字、再整行着色。
+ *
+ * label 贴在最右端；放不下就丢掉 label（宁可没有，也不让边框溢出折行）。
+ */
+export function roundBorder(
+  line: string,
+  fg: (s: string) => string,
+  left: string,
+  right: string,
+  label = '',
+): string {
+  // 宽度按字符数算（不是显示宽度）。成立的前提：line 只含 ASCII 的 `─` 与空格
+  // —— pi 的边框行正是如此。若将来边框里出现中日韩宽字符，这里要改用 visibleWidth。
+  const plain = stripAnsi(line)
+  if (plain.length === 0) return line
+  // 原边框行宽 = width-2；两端圆角各占 1 列，合起来正好 width。
+  let mid = plain
+  // label 两侧各留 1 空格；放不下就不要 label。
+  if (label && label.length + 2 < mid.length) {
+    mid = mid.slice(0, mid.length - label.length - 2) + ' ' + label + ' '
+  }
+  return fg(left + mid + right)
+}

package/hooks/abs-rounded-editor/index.ts

@@ -0,0 +1,90 @@
+/**
+ * 圆角四边框输入框 + 右上角状态（pi 扩展）。
+ *
+ * 需求（2026-11-04 用户）：
+ *   ① 输入框左右都有竖线、四角圆角
+ *   ② working 不单独占一行，只在上边框显示运行图标（embedWorkingStatus）
+ *   ③ 上边框最右侧显示「上下文百分比/上限 模型名」，如 `8.0%/1.0M deepseek-v4.1-flash`
+ *   ④ 输入框下方原有 footer 两行全部隐藏
+ *
+ * 为什么要覆写 render()：
+ *   pi 的 Editor.render() 只画上下两条 `─`，每行是「左 padding + 文本 + 右 padding」，
+ *   源码注释明写 `no side borders`。左右竖线逐行拼，没有单独钩子，只能接管整个 render。
+ *
+ * 做法：调 super.render(width - 2) 拿原结果（光标、滚动、自动补全原样保留），
+ *   再给上下边换成圆角、给内容行两端各包一根 `│`。
+ *   不复制 pi 内部逻辑，pi 改光标/滚动时本扩展自动跟住。
+ *
+ * 注意：自动补全菜单行排在底边之下、且自带内容宽度，不套竖线（否则菜单被框住会错位）。
+ */
+import { CustomEditor } from '@earendil-works/pi-coding-agent'
+import { buildStatus, roundBorder, shortenModel } from './format.ts'
+
+const SIDE = '│'
+
+/** 右上角状态文本，如 `8.0%/1.0M deepseek-v4.1-flash`。render() 拿不到 ctx，故由事件回调维护。 */
+let statusLabel = ''
+
+export class RoundedEditor extends CustomEditor {
+  render(width: number): string[] {
+    if (width < 4) return super.render(width)
+    // 内容窄 2 列，给左右竖线让位。
+    const lines = super.render(width - 2)
+    if (lines.length < 2) return lines
+
+    const borderColor = (this as any).borderColor?.bind(this)
+    const wrap = (s: string) => (borderColor ? borderColor(s) : s)
+    const out: string[] = []
+
+    // 上边框：原本是整行 `─`（含 working 图标与滚动提示），两端换圆角，右端贴状态。
+    out.push(roundBorder(lines[0], wrap, '╭', '╮', statusLabel))
+    // 下边框在原结果的倒数第 (1 + 自动补全行数) 位 —— 补全菜单排在它后面。
+    const autocompleteHeight = (this as any).renderedAutocompleteHeight ?? 0
+    const bottomIdx = lines.length - 1 - autocompleteHeight
+
+    for (let i = 1; i < bottomIdx; i++) {
+      out.push(wrap(SIDE) + lines[i] + wrap(SIDE))
+    }
+    out.push(roundBorder(lines[bottomIdx], wrap, '╰', '╯'))
+    // 自动补全行原样透传（不套竖线）。
+    for (let i = bottomIdx + 1; i < lines.length; i++) out.push(lines[i])
+    return out
+  }
+}
+
+/** 刷新右上角状态文本（每次渲染前由事件与定时器调用）。 */
+function refreshStatus(ctx: any): void {
+  try {
+    statusLabel = buildStatus(ctx?.getContextUsage?.(), ctx?.model?.id ?? '')
+  } catch {
+    statusLabel = shortenModel(ctx?.model?.id ?? '')
+  }
+}
+
+export default function piRoundedEditor(pi: any): void {
+  pi.on('session_start', (_event: unknown, ctx: any) => {
+    if (!ctx?.ui?.setEditorComponent) return
+    refreshStatus(ctx)
+    // 第四个参数 embedWorkingStatus: true —— working 状态进上边框，不再单独占一行。
+    ctx.ui.setEditorComponent(
+      (tui: any, theme: any, keybindings: any) =>
+        new RoundedEditor(tui, theme, keybindings, { embedWorkingStatus: true }),
+    )
+    // ④ 隐藏输入框下方的 footer 两行（路径/git/token、MCP/扩展状态），信息并入右上角。
+    ctx.ui.setFooter?.(() => ({ render: () => [], invalidate() {} }))
+  })
+
+  // 切模型时更新右上角名字（/model、Ctrl+P 都走这个事件）。
+  pi.on('model_changed', (_event: any, ctx: any) => {
+    refreshStatus(ctx)
+    ctx?.ui?.requestRender?.()
+  })
+
+  // 上下文占用随每轮对话变化 —— 轮次结束与消息结束时刷新。
+  for (const ev of ['turn_end', 'message_end', 'tool_execution_end']) {
+    pi.on(ev, (_event: any, ctx: any) => {
+      refreshStatus(ctx)
+      ctx?.ui?.requestRender?.()
+    })
+  }
+}

package/hooks/abs.omp.ts

@@ -341,10 +341,16 @@ const USER_NICKNAMES = [
 let sessionNickname = ''
 
 /** 抽一条昵称。传 rnd 便于测试注入；默认 Math.random。关掉：ABS_TODO_NICK=0。 */
+/** 昵称池每条存成「emoji + 空格 + 正文」，展示时剥掉 emoji，只留正文（2026-11-04 用户要求）。 */
+export function stripNicknameEmoji(s: string): string {
+  // 循环剥：🏴‍☠️、😮‍💨 这类 ZWJ 组合 emoji 由多段拼成，只剥一次会剩下后半截。
+  return s.replace(/^(?:\p{Extended_Pictographic}[\uFE0F\u200D\u{1F3FB}-\u{1F3FF}]*)+[\s]*/u, '').trim()
+}
+
 export function pickNickname(rnd: () => number = Math.random): string {
   if (String(process.env.ABS_TODO_NICK || '') === '0') return ''
   const i = Math.min(USER_NICKNAMES.length - 1, Math.floor(rnd() * USER_NICKNAMES.length))
-  return USER_NICKNAMES[Math.max(0, i)]
+  return stripNicknameEmoji(USER_NICKNAMES[Math.max(0, i)])
 }
 
 /** 解析 todo.md 的 ## Todo 区 —— 只收未完成行（- [ ]），Done 区不计。
@@ -516,19 +522,15 @@ export function renderPanelLines(
   // ★ 空看板不返回空数组：面板是「机制在不在」的常驻指示，进去就看不见 = 不知道机制活着。
   const colorOf = (state: string): string => (state === '搁置' ? 'dim' : state === '滞留中' ? 'muted' : state === '讨论中' ? 'dim' : 'accent')
   const lines: string[] = []
-  // 上描边用 `thinkingOff` —— 与输入框描边同一个色（pi 版排查三轮才确认：不能按名字猜主题色）。
-  // 满宽（不 -1）—— 对齐宿主自己的 DynamicBorder.render。
-  lines.push(fg('thinkingOff', '─'.repeat(Math.max(1, width))))
+  // 上描边行已删除（2026-11-04 与 pi 版同步，用户要求「去掉上边框」）。首行现在是标题行。
   const whoPart = who ? who + (nickname ? ` · ${nickname}` : '') : nickname
-  const title = whoPart ? `📋 todo (${data.total}) — ${whoPart}` : `📋 todo (${data.total})`
-  lines.push(clipToWidth(fg('accent', title), width))
+  const title = whoPart ? `Todo (${data.total}) — ${whoPart}` : `Todo (${data.total})`
+  // 前导一格空格：对齐输入框内文本（输入框左右竖线内侧各留一格，见 hooks/pi-rounded-editor.ts）。
+  lines.push(clipToWidth(' ' + fg('accent', title), width))
 
   const lastIdx = data.rows.length - 1
-  // 空看板：标题下摆一行事实。只摆事实、不写劝告。
-  if (data.total === 0) {
-    lines.push(clipToWidth(`  ${fg('dim', '（无未完成任务）')}`, width))
-    return lines
-  }
+  // 空看板只显示标题行（2026-11-04 用户要求去掉「（无未完成任务）」那行）。
+  if (data.total === 0) return lines
   data.rows.forEach((t, i) => {
     // `└─` 只给最后一条 —— 不管它有没有子项（否则末条带子项时全篇没有收尾）。
     const isLast = i === lastIdx
@@ -538,7 +540,7 @@ export function renderPanelLines(
     const box = fg('dim', '[ ]')
     const head = `${fg('dim', branch)} ${box} ${fg(colorOf(t.state), `[${t.state}]`)} ${fg('text', t.id)}${anim}`
     const desc = t.desc ? ` ${fg('dim', '—')} ${fg('muted', t.desc)}` : ''
-    lines.push(clipToWidth(head + desc, width))
+    lines.push(clipToWidth(' ' + head + desc, width))
     if (t.kids && t.kids.length) {
       // 子项：标准 md 嵌套列表 → 画成树
       const stem = isLast ? '  ' : fg('dim', '│ ')
@@ -552,7 +554,7 @@ export function renderPanelLines(
     }
   })
 
-  if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `  +${data.hidden} more`), width))
+  if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `   +${data.hidden} more`), width))
   return lines
 }
 

package/hooks/abs.pi.ts

@@ -713,10 +713,16 @@ const USER_NICKNAMES = [
 let sessionNickname = ''
 
 /** 抽一条昵称。传 rnd 便于测试注入；默认 Math.random。关掉：ABS_TODO_NICK=0。 */
+/** 昵称池每条存成「emoji + 空格 + 正文」，展示时剥掉 emoji，只留正文（2026-11-04 用户要求）。 */
+export function stripNicknameEmoji(s: string): string {
+  // 循环剥：🏴‍☠️、😮‍💨 这类 ZWJ 组合 emoji 由多段拼成，只剥一次会剩下后半截。
+  return s.replace(/^(?:\p{Extended_Pictographic}[\uFE0F\u200D\u{1F3FB}-\u{1F3FF}]*)+[\s]*/u, '').trim()
+}
+
 export function pickNickname(rnd: () => number = Math.random): string {
   if (String(process.env.ABS_TODO_NICK || '') === '0') return ''
   const i = Math.min(USER_NICKNAMES.length - 1, Math.floor(rnd() * USER_NICKNAMES.length))
-  return USER_NICKNAMES[Math.max(0, i)]
+  return stripNicknameEmoji(USER_NICKNAMES[Math.max(0, i)])
 }
 
 /** 解析 todo.md 的 ## Todo 区 —— 只收未完成行（- [ ]），Done 区不计。
@@ -923,30 +929,19 @@ export function renderPanelLines(
   //   下面仍要画框和标题，所以这里只是不再提前 return。
   const colorOf = (state: string): string => (state === '搁置' ? 'dim' : state === '滞留中' ? 'muted' : state === '讨论中' ? 'dim' : 'accent')
   const lines: string[] = []
-  // 上描边：用 `thinkingOff` —— 跟 Pi 输入框描边**完全同一个色**。
-  // 排查过程（2026-10-03 用户两轮反馈）：
-  //   ① 用 dim = okhsl(229 8% 56%) → 用户说“太亮”（比输入框亮 7%）
-  //   ② 改 border = okhsl(231 57% 65%) → 用户说“怎么是蓝色的”（高饱和度蓝紫）
-  //   ③ 真相：输入框的描边是 theme.getThinkingBorderColor(level)，level=off 时
-  //      就是 thinkingOff = okhsl(229 8% 49%)（纯灰低饱和）。
-  // 教训：看到“跟宿主某个 UI 元素一致”的需求，必须去宿主源码查那个元素
-  // **实际**用了哪个主题色，不能按名字猜（border 听着像框线，其实不是输入框那个）。
-  // 满宽（不 -1）—— 对齐 pi 自己的 DynamicBorder.render：`"─".repeat(Math.max(1, width))`。
-  // 曾写 width-1 怕折行，但 pi 自己就满宽画，用户实报“右侧缺一小块”。
-  // 且我们传入的 fg() 包了一层 ANSI，ANSI 不占列宽，不会因此溢出。
-  lines.push(fg('thinkingOff', '─'.repeat(Math.max(1, width))))
+  // 上描边行已删除（2026-11-04 用户要求「去掉上边框」）。
+  // 历史：那行曾用 `thinkingOff` 对齐 pi 输入框描边色（排查三轮才定色）。
+  // 首行现在是标题行。
+  //
   // 昵称附在作者名后（会话内固定，启动时随机抽）。
   const whoPart = who ? who + (nickname ? ` · ${nickname}` : '') : nickname
-  const title = whoPart ? `📋 todo (${data.total}) — ${whoPart}` : `📋 todo (${data.total})`
-  lines.push(clipToWidth(fg('accent', title), width))
+  const title = whoPart ? `Todo (${data.total}) — ${whoPart}` : `Todo (${data.total})`
+  // 前导一格空格：对齐输入框内文本（输入框左右竖线内侧各留一格，见 hooks/pi-rounded-editor.ts）。
+  lines.push(clipToWidth(' ' + fg('accent', title), width))
 
   const lastIdx = data.rows.length - 1
-  // 空看板：标题下摆一行事实（与 system prompt 里的看板段同口径）。
-  // 只摆事实、不写劝告 —— 「记得登记」那类已被 13 次尝试证明无效（见 OPENING_RULES 注解）。
-  if (data.total === 0) {
-    lines.push(clipToWidth(`  ${fg('dim', '（无未完成任务）')}`, width))
-    return lines
-  }
+  // 空看板只显示标题行（2026-11-04 用户要求去掉「（无未完成任务）」那行）。
+  if (data.total === 0) return lines
   data.rows.forEach((t, i) => {
     // `└─` 只给最后一条 —— 不管它有没有子项。
     // （2026-10-03 审查修正：原条件 `i === lastIdx && !t.note` 会让“末条带子项”时
@@ -960,7 +955,7 @@ export function renderPanelLines(
     const box = fg('dim', '[ ]')
     const head = `${fg('dim', branch)} ${box} ${fg(colorOf(t.state), `[${t.state}]`)} ${fg('text', t.id)}${anim}`
     const desc = t.desc ? ` ${fg('dim', '—')} ${fg('muted', t.desc)}` : ''
-    lines.push(clipToWidth(head + desc, width))
+    lines.push(clipToWidth(' ' + head + desc, width))
     if (t.kids && t.kids.length) {
       // 子项：标准 md 嵌套列表 → 画成树
       //   ├─ [ ] 子项一
@@ -978,7 +973,7 @@ export function renderPanelLines(
     }
   })
 
-  if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `  +${data.hidden} more`), width))
+  if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `   +${data.hidden} more`), width))
   return lines
 }
 /** 隐藏面板。**必须主动 requestRender** —— 否则数据清了、屏幕还留着旧画面。
@@ -1002,7 +997,7 @@ async function refreshTodoPanel(ui: any, cwd: string): Promise<void> {
     const md = await readFile(join(cwd, '.brain', 'todo.md'), 'utf8')
     const who = await currentUser()
     const data = parseOpenTasks(md, PANEL_MAX_ROWS, who)
-    // 任务为空**也显示面板**（摆一行「（无未完成任务）」），只有无图谱才隐藏。
+    // 任务为空**也显示面板**（只留标题行），只有无图谱才隐藏。
     // 曾写 data.total === 0 → hidePanel；用户 2026-10-06 要求改掉。
     // factory 形式：render(width) 每帧拿真实宽度 → 按宽度截断，不再断字。
     // 动画：phase 存在模块级，render 时读当前值；定时器只在本帧重绘，不重建 widget。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "1.24.0",
+  "version": "1.25.1",
   "description": "agent-brain-sync: 跨会话 AI 编码记忆 — hook 纯触发 + CLI/MCP 读写 .brain markdown 图谱, 防并发写保护。",
   "type": "module",
   "license": "MIT",

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

@@ -180,6 +180,26 @@ abs todo memo <id>                                                       # 查
 
 经验刚冒出来就 `abs_note` 暂存（幂等去重），宁少勿滥。**跨会话任务只用 abs todo**，别用宿主原生 todo（TodoWrite / `/list`），那些不写 `.brain/todo.md`，下会话接不上。
 
+## 主动提炼（不等人说「收尾」）
+
+提炼是**你的自觉**，不是等用户发指令。两个触发时机，任中一个就主动做：
+
+1. **sources 积压**：`abs load` 顶部出现「♻ 待消化」或 `abs lint` 报 `SOURCES-PILED-UP`（> 10 条）→ 主动收拢。
+2. **一段活收尾**：任务 `done`、或踩坑后刚 `abs_note` 暂存完 → 顺手看这条值不值得提炼成规律。
+
+动作只有一步判断 + 一个落点：
+
+```bash
+abs review                        # 列出待确认的 draft 页（concepts + sources）
+# 值得留 → 用自己的判断提炼成一句话，落到正确层：
+abs capture --layer 3 "某工具怎么用/有什么坑"     # 工具经验
+abs capture "踩坑的根因与解法"                    # 认知（默认 L4）
+# 不值得留 → 否决掉：
+abs review --reject <页名>
+```
+
+**判断力在你（agent），工具只做落点**——`capture` 不替你判「这条值不值得留、归哪一层」。提炼成规律后删原 source、清指向它的引用（防死链，见 Teardown 第 5 步）。
+
 ## 收尾循环（用户明确要求收尾时才走）
 
 1. **读 todo**：`abs load`，看还有哪些没完成。

package/src/install.js

@@ -818,6 +818,18 @@ async function installPi({ withMcp, withSkill }) {
   const p = join(dir, 'abs.ts');
   await atomicWrite(p, piPluginSource()); // Pi 用专用模板, 语法与 OpenCode 不同构
   steps.push(`✓ hook(ts extension) → ${p}`);
+  // 圆角四边框输入框（纯 UI，与记忆功能无关，pi 专属）。
+  // 为什么独立成一个扩展：它是可选样式，不想要时删掉这个目录即可，不必动 abs.ts。
+  // 为什么用「目录 + index.ts」而不是两个平铺的 .ts：
+  //   pi 会把 extensions/ 下**每个顶层 .ts 都当独立扩展**并强制要求默认导出工厂函数 ——
+  //   平铺一个纯函数文件会让 pi 启动直接报错（2026-11-04 实报：
+  //   "Failed to load extension pi-rounded-format.ts: does not export a valid factory function"）。
+  //   子目录只为入口 index.ts 加载，helper 文件不参与扫描（官方多文件扩展写法）。
+  const roundedDir = join(dir, 'abs-rounded-editor');
+  for (const f of ['index.ts', 'format.ts']) {
+    await atomicWrite(join(roundedDir, f), renderPluginTemplate(`abs-rounded-editor/${f}`, {}));
+  }
+  steps.push(`✓ editor(rounded box) → ${join(roundedDir, 'index.ts')}`);
   // MCP → ~/.pi/agent/mcp-adapter.json 的 mcpServers (stdio)
   // 坑（2026-09-30 用户实报）：曾写 mcp.json，但 pi-mcp-adapter 已不再读它
   //   （pi 自有 mcp.json 被 adapter 忽略，adapter 改读 mcp-adapter.json）→ 写了等于没写。
@@ -839,6 +851,11 @@ async function installPi({ withMcp, withSkill }) {
 async function uninstallPi() {
   const steps = [];
   await fs.rm(join(hostConfigRoot('pi'), 'agent', 'extensions', 'abs.ts'), { force: true });
+  // 目录形式：整个删掉。顺带清掉旧版本平铺的两个文件（1.25.0 装过那种布局）。
+  await fs.rm(join(hostConfigRoot('pi'), 'agent', 'extensions', 'abs-rounded-editor'), { recursive: true, force: true });
+  for (const legacy of ['pi-rounded-editor.ts', 'pi-rounded-format.ts']) {
+    await fs.rm(join(hostConfigRoot('pi'), 'agent', 'extensions', legacy), { force: true });
+  }
   steps.push(`✓ extension 已删除`);
   steps.push(...await uninstallSkills('pi'));
   const mcpP = join(hostConfigRoot('pi'), 'agent', 'mcp-adapter.json');

package/src/query.js

@@ -4,6 +4,7 @@ import { join } from 'node:path';
 import { requireBrain, brainPath } from './index.js';
 import { rankPage } from './relevant.js';
 import { statusOfPage, idOfPage, supersededByOf, clip } from './store.js';
+import { DIR_LAYER, decayOf } from './brain/layers.js';
 
 // ---------- query: 检索知识图谱（多词 OR，扫全 .md 页） ----------
 const KNOWN_SLUG_HINT = /模板残留|\[\[slug\]\]/;
@@ -49,7 +50,23 @@ export async function cmdQuery({ dir, terms, includeSuperseded }) {
         // 而不是回答"我上次怎么解決 X"（那会拿到一个已知错误的答案）。
         // 但它不是静默消失：计数里告知还有几条被隐藏（带 --all 能看）。
         if (st === 'superseded' && !includeSuperseded) {
-          hits.push({ hidden: true, slug });
+          hits.push({ hidden: 'superseded', slug });
+          continue;
+        }
+        // 流水页默认不进结果（2026-11-03 修）：sessions/log-* 是「那天做了什么」
+        // 的草稿记录，不是知识页。它正文里碰巧出现检索词不代表它是这条经验所在 ——
+        // 与 db search 对齐（db 里层权重把 L5 会话页压到底，query 扫 md 没有这层，
+        // 只能显式隐藏）。不是静默消失：计数告知 + --all 可看。
+        const isFlow = d === 'sessions' && /^log-/.test(slug);
+        if (isFlow && !includeSuperseded) {
+          hits.push({ hidden: 'flow', slug });
+          continue;
+        }
+        // draft（未核实）默认也隐藏（2026-11-03 修）：主动 recall 要的是「可信的
+        // 知识」，draft 是没核实的草稿，与 db search 对齐（db 里 L7 草稿被层权重
+        // 压到底、L4 draft 骨架亮度低）。与 superseded/flow 同待遇：--all 可看。
+        if (st === 'draft' && !includeSuperseded) {
+          hits.push({ hidden: 'draft', slug });
           continue;
         }
         hits.push({
@@ -63,18 +80,23 @@ export async function cmdQuery({ dir, terms, includeSuperseded }) {
       }
     }
   }
-  const hidden = hits.filter((h) => h.hidden).length;
+  const hiddenSup = hits.filter((h) => h.hidden === 'superseded').length;
+  const hiddenFlow = hits.filter((h) => h.hidden === 'flow').length;
+  const hiddenDraft = hits.filter((h) => h.hidden === 'draft').length;
+  const hidden = hiddenSup + hiddenFlow + hiddenDraft;
   // 分两区：精确命中优先，模糊只作补充。
   // 坑(2026-09-16 实测): 不加区分时查 file-write-locking 返回 26 页（几乎全图）——
   //   连字符词的 2-gram 太通用，模糊命中把无关页也拉进来。
   //   规则：只要有任何精确命中，模糊命中的就不排在前面（但也不丢弃，单列一段）。
-  // 流水页降权（2026-11-02 实测）：查「并发 写 锁」时前 10 位里挤进 4 页
-  // sessions/log-*，内容页被顶下去。流水页只是「那天做了什么」的草稿记录，
-  // 正文里碰巧出现检索词不代表它是这条经验所在。判据沿用 lint.js 的
-  // isTerminal（sources/ 与 sessions/log-*），不另造一套。
-  // 只降权不剔除：真要查某天的流水，它仍在结果里，只是排到内容页之后。
-  const isFlow = (h) => h.dir === 'sources' || (h.dir === 'sessions' && /^log-/.test(h.slug));
-  const rankBy = (h) => h.fuzzyScore - (isFlow(h) ? 20 : 0);
+  // 层权重（2026-11-03 修）：query 之前只按分数排，流水页（sessions/log-*）和
+  // 草稿（sources/）与内容页同分竞争，于是 log 页挤进前 10。db search 干净的本质
+  // 是它按层权重排序 —— sessions=L5(decay 0.75)、sources=L7(decay 0.95)，亮度被
+  // 压到 0.25/0.05，而 concepts/entities/syntheses=L4(decay 0.6) 权重 0.4。
+  // 这里复用同一套 DIR_LAYER + decayOf，与 db search 对齐，不再用笼统的「降 20 分」
+  // （那个修法在命中分数接近时失效，实测「长期记忆 提炼 主动回忆」前 10 仍混 3 个 log 页）。
+  // 权重 = 1 - decay（与 db.js 的 layerWeight 同口径）。
+  const layerWeight = (h) => Math.max(0.05, 1 - decayOf(DIR_LAYER[h.dir] ?? 4));
+  const rankBy = (h) => h.fuzzyScore * layerWeight(h);
   const exactHits = hits.filter((h) => !h.hidden && h.kind === 'exact')
     .map((h) => ({ ...h, score: rankBy(h) }))
     .sort((a, b) => b.score - a.score);
@@ -85,7 +107,7 @@ export async function cmdQuery({ dir, terms, includeSuperseded }) {
   const fuzzySuppressed = exactHits.length > 0 && fuzzyHits.length > 0;
   const shown = exactHits.length ? exactHits : fuzzyHits;
   if (!shown.length) {
-    const extra = hidden ? `（另外 ${hidden} 页已标记 superseded，用 abs query ${words.join(' ')} --all 查看）` : '';
+    const extra = hidden ? `（另外 ${hidden} 页被隐藏，用 abs query ${words.join(' ')} --all 查看）` : '';
     return `query [${words.join(', ')}]: 无命中。${extra}用 abs lint 看图谱健康；首次使用先 abs init。`;
   }
   // 输出条数上限（2026-09-30 补）：落实 read-side-output-must-not-scale 规则。
@@ -114,7 +136,9 @@ export async function cmdQuery({ dir, terms, includeSuperseded }) {
   const tail = [];
   if (words.length > 1 && !anyFull) tail.push('', `（无页同时命中全部 ${words.length} 个词，以下按命中数排序）`);
   if (fuzzySuppressed) tail.push('', `（另有 ${fuzzyHits.length} 页字形相近但字面未命中，已隐藏 —— 它们通常不相关）`);
-  if (hidden) tail.push(``, `（${hidden} 页 superseded 已隐藏；--all 可看）`);
+  if (hiddenSup) tail.push(``, `（${hiddenSup} 页 superseded 已隐藏；--all 可看）`);
+  if (hiddenFlow) tail.push(``, `（${hiddenFlow} 页流水已隐藏；--all 可看）`);
+  if (hiddenDraft) tail.push(``, `（${hiddenDraft} 页 draft 未核实已隐藏；--all 可看）`);
   if (overflow > 0) tail.push(``, `（另有 ${overflow} 页未展示 —— 用更具体的词收窄：abs query <词1> <词2>）`);
   return [`query [${words.join(', ')}] → ${shown.length} 页（展示前 ${displayed.length} 页）:`, '', ...lines, ...tail].join('\n');
 }