pi-coding-master 0.2.7

package/core/individual.bio.organs/blood.runtime/messages.ts

@@ -0,0 +1,236 @@
+// blood.runtime/messages.ts — 统一消息注册表
+// 所有 messageType 消息的 schema + 发送函数集中在同一处，
+// 不许各器官各自调 pi.sendMessage() 注册。
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+// ── 消息类型定义 ──────────────────────────────────────────────────────────
+export interface messageTypeDef {
+  messageType: string;
+  isDisplayedInTUI: boolean;// 是否在 TUI 显示
+  deliverAs: "followUp" | "steer" | "nextTurn";  // 投递方式 
+  isTriggerNewTurn: boolean;  // 是否触发新 turn
+  messageDescription: string; // 内容
+}
+
+// ── 全量注册表 ─────────────────────────────────────────────────────────────
+export const MESSAGE_TYPES: Record<string, messageTypeDef> = {
+  "continuous-next": {
+    messageType: "continuous-next",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: true,
+    messageDescription: "自动续命：模型结束 turn 后触发下一轮",
+  },
+  "continuous-resume": {
+    messageType: "continuous-resume",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: true,
+    messageDescription: "wait 倒计时结束后的唤醒消息",
+  },
+  "continuous-date": {
+    messageType: "continuous-date",
+    isDisplayedInTUI: true,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "日期变更通知",
+  },
+  "continuous-timeout": {
+    messageType: "continuous-timeout",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: false,
+    messageDescription: "超时通知",
+  },
+  "continuous-cmd-done": {
+    messageType: "continuous-cmd-done",
+    isDisplayedInTUI: false,
+    deliverAs: "steer",
+    isTriggerNewTurn: false,
+    messageDescription: "命令执行完成（打断式）",
+  },
+  "continuous-error-retry": {
+    messageType: "continuous-error-retry",
+    isDisplayedInTUI: true,
+    deliverAs: "followUp",
+    isTriggerNewTurn: true,
+    messageDescription: "API 错误后自动重试通知",
+  },
+  "continuous-retry": {
+    messageType: "continuous-retry",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: true,
+    messageDescription: "模型漏调 next() 后的自动重试",
+  },
+  "conscious-aware": {
+    messageType: "conscious-aware",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: false,
+    messageDescription: "潜意识觉察消息（aware）",
+  },
+  "hippocampus-error": {
+    messageType: "hippocampus-error",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "海马体启动异常通知",
+  },
+  "memory-capacity": {
+    messageType: "memory-capacity",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "上下文容量警告",
+  },
+  "memory-reminder": {
+    messageType: "memory-reminder",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "记忆提醒（闹钟/通知）",
+  },
+  "memory-snapshot": {
+    messageType: "memory-snapshot",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "记忆快照通知",
+  },
+  "memory-frozen-delta": {
+    messageType: "memory-frozen-delta",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "冻结 delta 通知",
+  },
+  "memory-hippocampus-disabled": {
+    messageType: "memory-hippocampus-disabled",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "海马体被禁用通知",
+  },
+  "memory-subconscious-disabled": {
+    messageType: "memory-subconscious-disabled",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "潜意识被禁用通知",
+  },
+  "ubi-paid": {
+    messageType: "ubi-paid",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "UBI 发钱通知",
+  },
+  "phone-notification": {
+    messageType: "phone-notification",
+    isDisplayedInTUI: true,
+    deliverAs: "steer",
+    isTriggerNewTurn: true,
+    messageDescription: "手机通知推送（打断式）",
+  },
+  "reminder-check": {
+    messageType: "reminder-check",
+    isDisplayedInTUI: true,
+    deliverAs: "followUp",
+    isTriggerNewTurn: false,
+    messageDescription: "闹钟/提醒检查",
+  },
+  "sleep-done": {
+    messageType: "sleep-done",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: false,
+    messageDescription: "睡眠完成通知",
+  },
+  "sleep-wake-resume": {
+    messageType: "sleep-wake-resume",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: true,
+    messageDescription: "睡眠唤醒后的恢复消息",
+  },
+  "subconscious-heartbeat": {
+    messageType: "subconscious-heartbeat",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: true,
+    messageDescription: "潜意识心跳信号",
+  },
+  "tool-result-debug": {
+    messageType: "tool-result-debug",
+    isDisplayedInTUI: true,
+    deliverAs: "followUp",
+    isTriggerNewTurn: true,
+    messageDescription: "工具结果调试信息",
+  },
+  "system-error": {
+    messageType: "system-error",
+    isDisplayedInTUI: false,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "系统错误通知",
+  },
+  "syntax-error": {
+    messageType: "syntax-error",
+    isDisplayedInTUI: true,
+    deliverAs: "followUp",
+    isTriggerNewTurn: true,
+    messageDescription: "语法错误通知",
+  },
+  "budget-trip": {
+    messageType: "budget-trip",
+    isDisplayedInTUI: true,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: true,
+    messageDescription: "预算超限告警",
+  },
+  "auto-deploy": {
+    messageType: "auto-deploy",
+    isDisplayedInTUI: true,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "自动部署完成通知",
+  },
+  "watcher-deploy": {
+    messageType: "watcher-deploy",
+    isDisplayedInTUI: true,
+    deliverAs: "nextTurn",
+    isTriggerNewTurn: false,
+    messageDescription: "文件变更触发部署通知",
+  },
+  "always-think-pause": {
+    messageType: "always-think-pause",
+    isDisplayedInTUI: false,
+    deliverAs: "followUp",
+    isTriggerNewTurn: false,
+    messageDescription: "always-think 暂停信号",
+  },
+};
+
+// ── 统一发送函数 ──────────────────────────────────────────────────────────
+// 替代各器官各自调 pi.sendMessage()。
+// 使用前必须在 MESSAGE_TYPES 注册，否则 throw。
+export function sendCustomMessage(
+  pi: ExtensionAPI,
+  messageType: string,
+  content: string,
+  details?: unknown,
+) {
+  const def = MESSAGE_TYPES[messageType];
+  if (!def) {
+    throw new Error(
+      `消息类型 "${messageType}" 未在 MESSAGE_TYPES 注册。` +
+      `所有 messageType 消息必须先在 messages.ts 里声明才能发送。`
+    );
+  }
+  pi.sendMessage(
+    { customType: messageType, content, display: def.isDisplayedInTUI, details },
+    { deliverAs: def.deliverAs, triggerTurn: def.isTriggerNewTurn }
+  );
+}

package/core/individual.bio.organs/blood.runtime/runtime.ts

@@ -0,0 +1,173 @@
+// blood.runtime/runtime.ts
+// ── 核糖体侧 ─────────────────────────────────────────────────────────────────
+// 读取 RNA 转录本（individual.bio.gene/rna/rna.json），把 prompt 交给各个 func（蛋白质）。
+// 这是机器，不是基因。func 不再硬编码 prompt 文本，而是向这里取：
+//   getPrompt("heart.continuous")              —— func 级 prompt（按 coded:name）
+//   getDuty("brain.hippocampus", "sleep.night") —— 某 mode 下的职责 prompt（按 in/duty 的 coded:）
+//
+// rna.json 由 dna.transpiler/transpiler.ts 生成。改了 .dna 要重新转录。
+// 路径解析：默认相对本文件 ../../individual.bio.gene/rna/rna.json；可用环境变量 PI_ALIVE_RNA 覆盖（部署用）。
+
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+
+const RUNTIME_DIR = dirname(new URL(import.meta.url).pathname);
+const RNA_PATH = process.env.PI_ALIVE_RNA || resolve(RUNTIME_DIR, "../../individual.bio.gene/rna/rna.json");
+const PROMPTS_PATH = process.env.PI_ALIVE_PROMPTS || resolve(RUNTIME_DIR, "../../prompts/prompts.json");
+
+// ── RNA 类型（与 transpiler 输出对应，宽松定义）──
+interface Duty { name: string; desc: string | null; coded: string | null; prompt: string | null }
+interface RnaFunc {
+  name: string;
+  path: string | null;
+  future: boolean;
+  session: string[];
+  modes: Record<string, "abled" | "disabled">;
+  alias: string[];
+  modules: string[];
+  belong: string[];
+  tags: string[];
+  promptRefs: string[];
+  prompts: Record<string, string>;
+  duties: Record<string, Duty[]>;
+}
+interface Rna {
+  sessions: string[];
+  modes: Record<string, { name: string; alias: string[] }>;
+  tags: Record<string, any>;
+  funcs: Record<string, RnaFunc>;
+  coded: Record<string, string>;
+  aliasToReal: Record<string, string>;
+  errors: string[];
+  warnings: string[];
+}
+
+// ── 懒加载 + 校验 ──
+let _rna: Rna | null = null;
+export function rna(): Rna {
+  if (_rna) return _rna;
+  // 1. 加载 RNA（从 coded.dna 编译的转录本）
+  let raw: Rna;
+  try {
+    raw = JSON.parse(readFileSync(RNA_PATH, "utf8"));
+  } catch (e: any) {
+    throw new Error(`[pi-coding-master] 读不到 RNA: ${RNA_PATH}\n先转录：bun individual.bio.gene/dna.transpiler/transpiler.ts\n${e?.message ?? e}`);
+  }
+  if (raw.errors?.length) {
+    throw new Error(`[pi-coding-master] RNA 含 ${raw.errors.length} 个错误，拒绝运行：\n  ` + raw.errors.join("\n  "));
+  }
+  // 2. 覆盖 prompts.json 中的统一提示词（优先级高于 coded.dna）
+  //    prompots.json 是唯一真相源，coded.dna 中的对应块已弃用。
+  try {
+    const promptsRaw = JSON.parse(readFileSync(PROMPTS_PATH, "utf8"));
+    const dna = promptsRaw?.dna;
+    if (dna && typeof dna === "object") {
+      for (const [name, text] of Object.entries(dna)) {
+        if (typeof text === "string" && text.length > 0) {
+          raw.coded[name] = text;
+          // 更新 func 级 prompts 映射（让 getFuncPrompts 也能取到）
+          for (const f of Object.values(raw.funcs)) {
+            for (const ref of f.promptRefs) {
+              if (ref === name) {
+                f.prompts[ref] = text;
+              }
+            }
+          }
+        }
+      }
+    }
+  } catch {
+    // prompts.json 不存在或格式不对时不阻塞，继续用 RNA 的数据
+  }
+  _rna = raw;
+  return raw;
+}
+
+// ── 运行期状态：当前 mode / session 角色 ──
+let _mode: string = process.env.PI_ALIVE_MODE || "DWN";
+let _sessionRole: string = "main";
+
+// ── prompt 取用 ──────────────────────────────────────────────────────────────
+
+/** 按名取 coded prompt 正文；取不到直接抛错（fail loud）。
+ *  支持 import：prompt 里写 `import xxx` 会被递归替换成对应 coded 块的内容。 */
+export function getPrompt(name: string): string {
+  const p = rna().coded[name];
+  if (p === undefined) {
+    throw new Error(`[pi-coding-master] coded prompt 不存在: "${name}"（检查 coded.dna 是否有 \`coded ${name}\`，promotor.dna 是否 coded:${name}）`);
+  }
+  return resolveImports(p);
+}
+
+/** 递归解析 prompt 中的 `import xxx` 行 */
+function resolveImports(text: string, seen: Set<string> = new Set()): string {
+  return text.replace(/^import\s+(\S+)\s*$/gm, (_, name) => {
+    if (seen.has(name)) return `[circular import: ${name}]`;
+    seen.add(name);
+    const imported = rna().coded[name];
+    if (imported === undefined) return `[import not found: ${name}]`;
+    return resolveImports(imported, seen);
+  });
+}
+
+/** 取某 func 在某 mode 下的职责列表（含已解析的 prompt）。无则空数组。 */
+export function getDuty(funcName: string, mode: string = _mode): Duty[] {
+  return rna().funcs[funcName]?.duties[mode] ?? [];
+}
+
+/** 取某 func 在某 mode 下「第一个」职责的 prompt（最常见用法）。无则 null。 */
+export function getDutyPrompt(funcName: string, mode: string = _mode): string | null {
+  const d = getDuty(funcName, mode);
+  return d.length ? d[0].prompt : null;
+}
+
+/** 取某 func 声明的所有 func 级 coded prompt（已解析）。 */
+export function getFuncPrompts(funcName: string): string[] {
+  const f = rna().funcs[funcName];
+  if (!f) return [];
+  return f.promptRefs.map((r) => f.prompts[r]).filter((x): x is string => !!x);
+}
+
+// ── func / mode / session 查询 ───────────────────────────────────────────────
+
+export function getFunc(funcName: string): RnaFunc | undefined {
+  // 支持 alias
+  const real = rna().funcs[funcName] ? funcName : rna().aliasToReal[funcName];
+  return real ? rna().funcs[real] : undefined;
+}
+
+export function listFuncs(opts?: { includeFuture?: boolean }): RnaFunc[] {
+  const all = Object.values(rna().funcs);
+  return opts?.includeFuture ? all : all.filter((f) => !f.future);
+}
+
+/** func 是否在某 mode 下启用。 */
+export function isAbled(funcName: string, mode: string = _mode): boolean {
+  return getFunc(funcName)?.modes[mode] === "abled";
+}
+
+/** func 是否该在某 session 角色里加载（session 含 "all" 或包含该角色即是）。 */
+export function runsInSession(funcName: string, role: string = _sessionRole): boolean {
+  const s = getFunc(funcName)?.session ?? [];
+  return s.includes("all") || s.includes(role);
+}
+
+// ── mode 状态 ────────────────────────────────────────────────────────────────
+
+export function getMode(): string { return _mode; }
+export function listModes(): string[] { return Object.keys(rna().modes); }
+export function setMode(mode: string): void {
+  // 支持 alias（wake→DWN, sleep→sleep.night）
+  const real = rna().modes[mode]
+    ? mode
+    : Object.values(rna().modes).find((m) => m.alias.includes(mode))?.name;
+  if (!real) throw new Error(`[pi-coding-master] 未知 mode: "${mode}"，可用: ${listModes().join(", ")}`);
+  _mode = real;
+}
+
+// ── session 角色（由 kernel 在 session_start 时设置）──
+export function getSessionRole(): string { return _sessionRole; }
+export function setSessionRole(role: string): void { _sessionRole = role; }
+
+// ── 调试：原始 RNA ──
+export function rnaRaw(): Rna { return rna(); }

package/core/individual.bio.organs/blood.runtime/runtime.ts.CHANGELOG

@@ -0,0 +1,5 @@
+[2026-06-15] created, by Claude Code
+- 核糖体侧：读 bios/dnas/rna.json，向各 func 提供 getPrompt / getDuty / getDutyPrompt / getFuncPrompts /
+  isAbled / getMode·setMode / SessionRole 等。
+- RNA 含错误时拒绝运行（fail loud）；支持 mode 别名(wake→DWN, sleep→sleep.night) 与 func 别名解析。
+- 路径默认相对本文件 ../bios/dnas/rna.json，可用 env PI_ALIVE_RNA 覆盖（部署用）。

package/core/individual.bio.organs/blood.runtime/runtime.ts.SPEC

@@ -0,0 +1,32 @@
+source: runtime.ts @ 6a7a0fc7
+
+# runtime.ts — RNA reader: provides getPrompt/getDuty/getMode etc.
+
+## 职责
+Lazy-loads the transpiled RNA (rna.json) and exposes accessor functions for prompts, duties, modes, sessions, and func metadata. All other organs fetch their prompt text and mode/session state through this module instead of hardcoding. Refuses to run if RNA contains errors (fail loud).
+
+## 接口
+- `rna(): Rna` — lazy-load + validate RNA, cache singleton
+- `getPrompt(name: string): string` — coded prompt by name (throws if missing)
+- `getDuty(funcName, mode?): Duty[]` — duties for a func in a mode
+- `getDutyPrompt(funcName, mode?): string | null` — first duty's prompt
+- `getFuncPrompts(funcName): string[]` — all func-level coded prompts
+- `getFunc(funcName): RnaFunc | undefined` — lookup by name or alias
+- `listFuncs(opts?): RnaFunc[]` — all funcs (optionally include future)
+- `isAbled(funcName, mode?): boolean` — enabled in current mode?
+- `runsInSession(funcName, role?): boolean` — should load in this session role?
+- `getMode() / setMode(mode) / listModes()` — mode state (supports alias)
+- `getSessionRole() / setSessionRole(role)` — session role state
+- `rnaRaw(): Rna` — raw RNA for kernel introspection
+
+## 依赖
+- `node:fs` (readFileSync), `node:path`
+- RNA path: `../../individual.bio.gene/rna/rna.json` or env `PI_ALIVE_RNA`
+
+## 行为要点
+- Singleton lazy load: reads JSON once, caches in `_rna`
+- Throws on read failure with actionable message ("先转录")
+- Throws if `rna.errors` is non-empty (refuses to run with broken RNA)
+- `setMode` resolves aliases (e.g. "wake" -> "DWN", "sleep" -> "sleep.night")
+- Default mode from `PI_ALIVE_MODE` env or "DWN"; default session role "main"
+- `getPrompt` throws on missing name (fail loud, not silent null)

package/core/individual.bio.organs/brain.amygdala/amygdala.ts

@@ -0,0 +1,25 @@
+// brain.amygdala — 杏仁核 / 急停反射
+// 不是 LLM、没有提示词，是【代码反射】：用户喊"停"，立刻 abort 当前生成/工具执行，不给模型投票权。
+//
+// 为什么必须在模型之外（代码层）：模型靠不住——它会无视"停"继续干工具、往沙箱外写
+// （gut-research 实测：用户连喊 10+ 次"停"/"滚"全程被无视）。急停是【反射】，不是判断，
+// 所以放在杏仁核这层代码里，绕过模型。和心脏的 Esc（按键硬停）互补：Esc 是按键，这个是说"停"。
+//
+// 只接管 abort（掐断当前动作）——这是安全核心。要不要顺带永久 halt continuous 是后续细化。
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+function isStopIntent(text: string | undefined): boolean {
+  const t = (text || "").trim();
+  if (!t || t.length > 16) return false;        // 长句不算急停，避免误伤正常对话
+  if (/别停|不停|继续/.test(t)) return false;     // 否定/反向（"别停"其实是"继续"），不刹
+  return /^(停|住手|打住|别动|别写|闭嘴|stop|cancel)/i.test(t);
+}
+
+export default function (pi: ExtensionAPI) {
+  pi.on("input", async (event: any, ctx: any) => {
+    if (!isStopIntent(event?.text)) return;
+    try { ctx.abort?.(); } catch {}   // 立刻掐断当前生成/工具，不等模型反应
+    try { ctx.ui?.notify?.("Emergency stop", "warning"); } catch {}
+  });
+}

package/core/individual.bio.organs/brain.amygdala/amygdala.ts.COMMENT

@@ -0,0 +1,3 @@
+2026/06/20 00:07
+说实话这模块写的就和屎一样，没有任何作用，逻辑也垃圾透顶，强烈建议后续重做。
+

package/core/individual.bio.organs/brain.amygdala/amygdala.ts.SPEC

@@ -0,0 +1,9 @@
+source: amygdala.ts @ 8384c4dd
+
+brain.amygdala — 杏仁核 / 急停反射。纯代码、无 LLM、无提示词。
+
+机制：pi.on("input") 监听用户输入；isStopIntent 判定是"停"意图（短句 ≤16 字，以 停/住手/打住/别动/别写/闭嘴/stop/cancel 开头，排除"别停/不停/继续"反向词）→ 立刻 ctx.abort() 掐断当前生成/工具执行。不调模型、不靠模型自觉。
+
+为什么要它（用户原话场景）：模型会无视"停"继续干——gut-research 实测用户连喊 10+ 次"停""滚"全被无视，agent 还在调工具、往沙箱外写文件。急停是【反射】不是判断，所以必须在模型之外的代码层。
+
+边界：v1 只做 abort（掐断当前动作，安全核心）。是否顺带永久 halt continuous（让它停下不自动续）是后续细化。与心脏 body.heart 的 Esc 互补：Esc=按键硬停，杏仁核=听到"停"。session main（只有主意识收用户输入），belong infra，永远 abled。

package/core/individual.bio.organs/brain.hippocampus/hippocampus-launcher.sh.template

@@ -0,0 +1,108 @@
+#!/bin/bash
+export NODE_OPTIONS="${NODE_OPTIONS:+$NODE_OPTIONS }--experimental-transform-types"
+# 自愈型海马体 launcher（自动生成）。带 offset：每轮只编码 context.md 自上次以来的【增量】，
+# 绝不从第 1 行重读整个文件 —— 这是根治"反复编码同样内容→work_mem 膨胀→快照变大→写回 context→
+# 下轮读到更多"指数自激死循环的关键。没有新内容就不启动编码，避免空轮烧钱+刷 session。
+SESSION_DIR={{SESSION_DIR}}
+dataDir={{DATA_DIR}}
+CTX="$dataDir/context.md"
+WM="$dataDir/work_memory.md"
+OFFSET_FILE="$dataDir/.hc-offset"
+NEW_SLICE="$dataDir/.hc-new-slice.md"
+MAIN_PID={{MAIN_PID}}
+# 级联看门狗：主意识进程一退出，就连本 tmux 一起关掉（防孤儿常驻烧钱）。
+( while kill -0 "$MAIN_PID" 2>/dev/null; do sleep 5; done; echo "[hc] 主意识已退出，自动关闭本实例。"; tmux kill-session -t {{TMUX_NAME}} 2>/dev/null ) &
+# 首次启动：把 offset 设到 context.md 当前末尾——从"现在"往后编码，不去啃已有历史（避免一上来就读爆窗口）。
+if [ ! -f "$OFFSET_FILE" ]; then stat -f%z "$CTX" 2>/dev/null > "$OFFSET_FILE" || echo 0 > "$OFFSET_FILE"; fi
+BACKOFF=15
+FAIL=0
+ERRLOG="$dataDir/hippocampus-err.log"
+while true; do
+  kill -0 "$MAIN_PID" 2>/dev/null || { echo "[hc] 主意识没了，退出。"; break; }
+  OFFSET=$(cat "$OFFSET_FILE" 2>/dev/null || echo 0)
+  SIZE=$(stat -f%z "$CTX" 2>/dev/null || echo 0)
+  # context.md 被重置/变短（如重启清理臃肿）→ offset 归零重来。
+  [ "$OFFSET" -gt "$SIZE" ] && OFFSET=0
+  NEW=$(( SIZE - OFFSET ))
+  if [ "$NEW" -lt 200 ]; then
+    # 没有（够多）新对话 → 不启动编码、不烧钱，歇 30s 再看。打断"空轮自激"的闸。
+    sleep 30
+    continue
+  fi
+  # 【封顶】每轮最多嚼 200KB。增量再大(如 offset 卡住攒到 1.4MB)，也只切一小段——
+  # 否则海马体一口吞这么大自己就崩、offset 永远不前进 → 越滚越大的死循环(就是反复崩溃的根)。
+  # 封顶后永远是可消化的一段，offset 按【实际处理量】稳步前进，增量大就分几轮快速追上。
+  CAP=200000
+  TAKE=$NEW; [ "$TAKE" -gt "$CAP" ] && TAKE=$CAP
+  tail -c +$(( OFFSET + 1 )) "$CTX" 2>/dev/null | head -c "$TAKE" > "$NEW_SLICE"
+  NEXT=$(( OFFSET + TAKE ))
+  # 【空切片闸】如果切片里全是空内容JSON（主意识崩溃时的心跳消息），跳过编码直接推进offset。
+  # 检测：过滤掉空内容/空文本行后，还有没有实质性内容。
+  EMPTY_SLICE=0
+  if [ -s "$NEW_SLICE" ]; then
+    # 去掉所有 content="" 或 text="" 的行，看还剩下什么
+    HAS_REAL=$(grep -v '"content":""' "$NEW_SLICE" 2>/dev/null | grep -v '"text":""' | grep -v '^{}$' | grep -v '^[[:space:]]*$' | head -1)
+    if [ -z "$HAS_REAL" ]; then
+      EMPTY_SLICE=1
+    fi
+  fi
+  if [ "$EMPTY_SLICE" -eq 1 ]; then
+    echo "$(date '+%F %T') hippocampus 跳过空切片（全是空内容消息），offset $OFFSET→$SIZE" >> "$ERRLOG"
+    echo "$SIZE" > "$OFFSET_FILE"
+    sleep 30
+    continue
+  fi
+  START=$(date +%s)
+  LOCKDIR="$dataDir/.memory-lock"
+  # 文件级互斥锁（mkdir 原子操作）：防 hc/sc/sl 并发写共享文件
+  LOCK_WAIT=0
+  while [ "$LOCK_WAIT" -lt 300 ]; do
+    if mkdir "$LOCKDIR" 2>/dev/null; then
+      # 拿到锁 → 写时间戳（供过期检测）
+      echo "{\"owner\":\"hc\",\"ts\":$(date +%s)000}" > "$LOCKDIR/stamp" 2>/dev/null
+      break
+    fi
+    # 锁被占用。检查是否过期（60s）。
+    if [ -f "$LOCKDIR/stamp" ]; then
+      LOCK_TS=$(cat "$LOCKDIR/stamp" 2>/dev/null | grep -o '"ts":[0-9]*' | grep -o '[0-9]*')
+      NOW_MS=$(date +%s)000
+      if [ -n "$LOCK_TS" ] && [ $(( NOW_MS - LOCK_TS )) -gt 60000 ]; then
+        # 过期锁 → 强拆
+        rm -f "$LOCKDIR/stamp" 2>/dev/null
+        rmdir "$LOCKDIR" 2>/dev/null
+        continue
+      fi
+    fi
+    LOCK_WAIT=$(( LOCK_WAIT + 1 ))
+    sleep 0.2
+  done
+  if [ "$LOCK_WAIT" -ge 300 ]; then
+    echo "[$(date '+%F %T')] hippocampus 无法获取文件锁（60s 超时），跳过本轮" >> "$ERRLOG"
+    sleep 30
+    continue
+  fi
+  echo "主意识自上次编码以来新产生的对话，已截出一段放在 $NEW_SLICE（增量的一段，封顶 $CAP 字节，不是全部）。读这个文件，消化、再反思，把有价值的结构化追加进 $WM。只处理这一段，绝对不要去读整个 context.md——那会重复编码、把记忆撑爆。完成后 wait(seconds=30)。" | /opt/homebrew/bin/pi --session-dir "$SESSION_DIR" 2>>"$ERRLOG"
+  CODE=$?;  # release lock (don't overwrite CODE)
+  rm -f "$LOCKDIR/stamp" 2>/dev/null
+  rmdir "$LOCKDIR" 2>/dev/null
+  # 编码成功 → offset 只推进【本轮实际处理的那段】(OFFSET+TAKE)，绝不直接跳到末尾。
+  if [ "$CODE" -eq 0 ]; then
+    echo "$NEXT" > "$OFFSET_FILE"
+    FAIL=0
+  else
+    FAIL=$(( FAIL + 1 ))
+    echo "[$(date '+%F %T')] hippocampus 编码失败 (code=$CODE, fail#$FAIL, offset=$OFFSET)" >> "$ERRLOG"
+    # 连续失败 5 次 → force 跳过这段坏内容（可能是 nap 归档后 offset 指向了无效区域）
+    if [ "$FAIL" -ge 5 ]; then
+      echo "[$(date '+%F %T')] hippocampus 连续失败5次，跳过坏段，offset $OFFSET→$SIZE" >> "$ERRLOG"
+      echo "$SIZE" > "$OFFSET_FILE"
+      FAIL=0
+    fi
+  fi
+  RAN=$(( $(date +%s) - START ))
+  if [ "$RAN" -ge 120 ]; then BACKOFF=15; else BACKOFF=$(( BACKOFF * 2 )); [ "$BACKOFF" -gt 300 ] && BACKOFF=300; fi
+  # 还有没追上的增量 → 不退避，马上接着嚼下一段，尽快追上。
+  [ "$CODE" -eq 0 ] && [ "$NEXT" -lt "$SIZE" ] && BACKOFF=1
+  echo "[$(date '+%F %T')] hippocampus 编码一段 (code=$CODE, ran $RAN s, offset $OFFSET→$NEXT / $SIZE) — 下轮 $BACKOFF s 后"
+  sleep "$BACKOFF"
+done