dsh-log-slicer 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # 变更记录
 
+## 0.1.4
+
+这一版防的不是"宿主换个界面"，是"宿主换套日志"。不加新功能，只把最容易断的几处改成认表；宿主真改了格式，第一眼能看见报错，而不是切出一节空文。
+
+- **加宽**：日志文件名认 `session[.v<N>].jsonl.zstd` 与 `.zst`，不再写死 `session.v4`；`--list` 与两个工具的输出都带上认到的 schema 号。
+- **加宽**：事件名认一张表（`user/message`、`message/user`、`assistant/message`、`message/assistant`、`user`、`assistant`、`model/message`、`message/model`）；正文位置认 `data.content`、`data.message.content`、`data.message`、`content`、`message`、`text`、`data.text`，以及 `{content:[…]}`/`{parts:[…]}` 两种包装；文本块认 `{text}`、`{text:{value}}`、`input_text`、`output_text`。
+- **改成大声失败**：一条轮次都认不出来时报 `LogSchemaError`，消息里带"读了多少事件、见过的事件类型各几条"——宿主升级之后，这一句就是诊断书。
+- **加宽**：注册口先认 `ctx.tools.register`，认不到试 `ctx.tool()`，都没有才抛；`apply` 照旧吞异常，不带崩应用。
+- **修**：`dsh.plugin.json` 的版本号一直停在 0.1.0，补到与包一致。
+
+## 0.1.3
+
+0.1.2 装进 profile 之后，重启没有任何反应——两个工具都没出现。查下来两处：
+
+- **修**：注册的 definition 少了 `output`。宿主 `register()` 的硬要求是 `output = { schema, render }`，`render` 返回 ContentBlock[]；只有 `name/description/parameters/execute` 会被直接拒。
+- **修**：`@deepseek-ai/dsh-tools` 只是 peerDependency，装进 profile 后未必解析得到（实测 `ERR_MODULE_NOT_FOUND`）。原来解析不到就抛错，而 `apply` 又把异常吞掉了，于是整个插件静默失效。现在解析不到就自己构造一份同形状的 definition：少了参数校验，注册与调用照常。
+
+两条一起解释了"CLI 能跑、装成插件是哑的"。
+
 ## 0.1.2
 
 - **修**：`package.json` 里补上 `dsh.bundle.patch`，指向 `./cordis.patch.yml`。少了这一行，装成插件时宿主既不会读那个 patch，也就不会把两个工具注册进会话——CLI 照样能用，装成插件却是哑的。这是装进 profile 时才发现的问题。

package/bin/log-slicer.mjs

@@ -85,7 +85,7 @@ function main() {
       return `${startNo + i}. [${who}] ${when}  ${body}`;
     });
     process.stdout.write(
-      `# 日志 ${all.log}\n# ${all.frames} 帧（${all.failedFrames} 帧解不开）/ ${all.totalTurns} 轮有效\n\n` +
+      `# 日志 ${all.log}\n# schema ${all.schema ?? '?'} / ${all.frames} 帧（${all.failedFrames} 帧解不开）/ ${all.totalTurns} 轮有效\n\n` +
         lines.join('\n') + '\n',
     );
     return;
@@ -113,7 +113,7 @@ function main() {
 
   const out = [];
   out.push(`# 日志 ${built.log}`);
-  out.push(`# ${(built.logSize / 1048576).toFixed(1)} MB / ${built.frames} 帧（${built.failedFrames} 帧解不开）/ ${built.totalTurns} 轮有效`);
+  out.push(`# schema ${built.schema ?? '?'} / ${(built.logSize / 1048576).toFixed(1)} MB / ${built.frames} 帧（${built.failedFrames} 帧解不开）/ ${built.totalTurns} 轮有效`);
   out.push(`# 切成 ${built.segment.length} 轮，其中你 ${built.counts.you} 轮、我 ${built.counts.me} 轮`);
   if (built.imageCount) {
     out.push(`# 图片 ${built.imageCount} 张：`);

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-log-slicer",
   "description": "Slice one section out of a DSH session log: verbatim turns, catalog row, backup and verification hash.",
-  "version": "0.1.0",
+  "version": "0.1.4",
   "entry": {
     "name": "dsh-log-slicer",
     "inject": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-log-slicer",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Slice one section out of a DeepSeek Harness session log: verbatim turns, images, catalog row, backups and a verification hash — one command, dry-run by default.",
   "keywords": [
     "dsh",
@@ -39,6 +39,9 @@
   "engines": {
     "node": ">=22.15.0"
   },
+  "scripts": {
+    "test": "node --test"
+  },
   "peerDependencies": {
     "@deepseek-ai/dsh-tools": "*"
   },
@@ -51,8 +54,5 @@
     "bundle": {
       "patch": "./cordis.patch.yml"
     }
-  },
-  "scripts": {
-    "test": "node --test"
   }
-}
+}

package/src/clean.js

@@ -3,6 +3,11 @@
  *
  * 只留人和模型真正说的话：宿主注入的环境文本、图片占位行都扔掉。
  * 图片留下 sha256 与媒体类型，供上层落成文件。
+ *
+ * 这一层是"宿主换版本最先崩的地方"：事件名、正文容器的形状都可能变。
+ * 所以这里不认死一个名字，认一张表；表里没见过的形状先跳过，
+ * 最后如果一条轮次都没认出来，就报错并列出见过的事件类型——宁可当场停下，
+ * 也不要静悄悄切出一节空文。
  */
 
 const ENV_PREFIXES = [
@@ -16,6 +21,37 @@ const ENV_PREFIXES = [
 
 const IMAGE_PLACEHOLDER = /^Image "[^"]+" \(sha256:[0-9a-f]{4,}/i;
 
+/** 事件名 → 说话的人。见过的名字都收在这里；宿主改名时往这里加一行就行。 */
+const EVENT_ROLES = {
+  'user/message': 'user',
+  'message/user': 'user',
+  'user': 'user',
+  'assistant/message': 'me',
+  'message/assistant': 'me',
+  'assistant': 'me',
+  'model/message': 'me',
+  'message/model': 'me',
+};
+
+/** 正文可能待在的几个位置，按先后试。 */
+const CONTENT_PATHS = [
+  (ev) => ev.data && ev.data.content,
+  (ev) => ev.data && ev.data.message && ev.data.message.content,
+  (ev) => ev.data && ev.data.message,
+  (ev) => ev.content,
+  (ev) => ev.message,
+  (ev) => ev.text,
+  (ev) => ev.data && ev.data.text,
+];
+
+export class LogSchemaError extends Error {
+  constructor(message, eventTypes = []) {
+    super(message);
+    this.name = 'LogSchemaError';
+    this.eventTypes = eventTypes;
+  }
+}
+
 export function isEnvironmentText(text) {
   if (typeof text !== 'string') return true;
   const t = text.trim();
@@ -24,11 +60,43 @@ export function isEnvironmentText(text) {
   return ENV_PREFIXES.some((p) => t.startsWith(p));
 }
 
+/** 正文块可能是字符串、`{text}`、`{text:{value}}`；都收。 */
+function blockText(x) {
+  if (typeof x === 'string') return x;
+  if (!x || typeof x !== 'object') return '';
+  if (typeof x.text === 'string') return x.text;
+  if (x.text && typeof x.text === 'object' && typeof x.text.value === 'string') return x.text.value;
+  if (typeof x.value === 'string') return x.value;
+  return '';
+}
+
+function itemsOf(ev) {
+  for (const pick of CONTENT_PATHS) {
+    let v;
+    try {
+      v = pick(ev);
+    } catch {
+      continue;
+    }
+    if (v == null) continue;
+    if (typeof v === 'string') return v ? [{ type: 'text', text: v }] : [];
+    if (Array.isArray(v)) return v;
+    if (typeof v === 'object') {
+      // 有些版本把正文包成 {content:[...]} 或 {parts:[...]}
+      if (Array.isArray(v.content)) return v.content;
+      if (Array.isArray(v.parts)) return v.parts;
+      if (typeof v.text === 'string') return [{ type: 'text', text: v.text }];
+    }
+  }
+  return [];
+}
+
 function textOf(items) {
   if (!Array.isArray(items)) return '';
   return items
-    .filter((x) => x && x.type === 'text' && typeof x.text === 'string')
-    .map((x) => x.text)
+    .filter((x) => x && (x.type === 'text' || x.type === 'input_text' || x.type === 'output_text'))
+    .map(blockText)
+    .filter(Boolean)
     .join('\n');
 }
 
@@ -37,19 +105,21 @@ function imagesOf(items) {
   const out = [];
   for (const x of items) {
     if (!x || x.type !== 'image') continue;
-    const a = x.attachment || {};
-    const id = String(a.attachmentId || a.id || '').replace(/^sha256:sha256:/, 'sha256:');
-    out.push({ id, sha256: id.replace(/^sha256:/, ''), mediaType: a.mediaType || '' });
+    const a = x.attachment || x.source || {};
+    const id = String(a.attachmentId || a.id || a.sha256 || '').replace(/^sha256:sha256:/, 'sha256:');
+    out.push({ id, sha256: id.replace(/^sha256:/, ''), mediaType: a.mediaType || a.media_type || '' });
   }
   return out;
 }
 
 /**
  * @param {string} text 解压后的 JSONL 文本
- * @returns {Array<{who: 'user'|'me', ts: number|null, text: string, images: Array}>}
+ * @returns {{turns: Array<{who: 'user'|'me', ts: number|null, text: string, images: Array}>, eventTypes: Record<string, number>}}
  */
-export function turnsFromText(text) {
+export function parseTurnLog(text) {
   const turns = [];
+  const eventTypes = {};
+  let events = 0;
   for (const line of String(text).split('\n')) {
     if (!line.trim()) continue;
     let ev;
@@ -59,19 +129,35 @@ export function turnsFromText(text) {
       continue;
     }
     if (!ev || typeof ev !== 'object') continue;
-    const ts = ev.time ?? ev.timestamp ?? null;
-    if (ev.type === 'user/message') {
-      const items = (ev.data && ev.data.content) || [];
-      const body = textOf(items);
-      const images = imagesOf(items);
-      if (isEnvironmentText(body) && images.length === 0) continue;
-      turns.push({ who: 'user', ts, text: body.trim(), images });
-    } else if (ev.type === 'assistant/message') {
-      const items = (ev.data && ev.data.message && ev.data.message.content) || [];
-      const body = textOf(items);
-      if (isEnvironmentText(body)) continue;
-      turns.push({ who: 'me', ts, text: body.trim(), images: [] });
-    }
+    events++;
+    const type = String(ev.type ?? '');
+    eventTypes[type] = (eventTypes[type] || 0) + 1;
+    const role = EVENT_ROLES[type];
+    if (!role) continue;
+    const ts = ev.time ?? ev.timestamp ?? (ev.data && ev.data.time) ?? null;
+    const items = itemsOf(ev);
+    const body = textOf(items);
+    const images = role === 'user' ? imagesOf(items) : [];
+    if (isEnvironmentText(body) && images.length === 0) continue;
+    turns.push({ who: role, ts, text: body.trim(), images });
+  }
+  if (turns.length === 0 && events > 0) {
+    const top = Object.entries(eventTypes)
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 8)
+      .map(([k, v]) => `${k || '(空)'}×${v}`)
+      .join('、');
+    throw new LogSchemaError(
+      `read ${events} events but recognised no turns (event types: ${top}). ` +
+        'The host log format probably changed — add the new names to EVENT_ROLES in src/clean.js, ' +
+        'or check CONTENT_PATHS if the names are the same but the body moved.',
+      Object.keys(eventTypes),
+    );
   }
-  return turns;
+  return { turns, eventTypes };
+}
+
+/** 兼容旧调用：只要轮次。 */
+export function turnsFromText(text) {
+  return parseTurnLog(text).turns;
 }

package/src/decode.js

@@ -63,8 +63,21 @@ export function decodeFile(filePath, options) {
 }
 
 /**
- * 在 $DSH_HOME/sessions 下找 session.v4.jsonl.zstd，按修改时间倒序。
- * sessions/<workspace>/<sessionId>/session.v4.jsonl.zstd
+ * 日志文件的形状：session.v4.jsonl.zstd、session.v5.jsonl.zstd、session.jsonl.zst……
+ * 版本号只用来排序与记录；不拿它当"认不认这份日志"的门槛——宿主改版本时，
+ * 这里多认一个文件名，比让整条链路失明强。
+ */
+const SESSION_FILE = /^session(?:\.v(\d+))?\.jsonl\.(?:zstd|zst)$/i;
+
+export function schemaOf(fileName) {
+  const m = SESSION_FILE.exec(path.basename(fileName));
+  if (!m) return null;
+  return m[1] ? Number(m[1]) : 0;
+}
+
+/**
+ * 在 $DSH_HOME/sessions 下找会话日志，按修改时间倒序。
+ * sessions/<workspace>/<sessionId>/session.v<N>.jsonl.zstd
  */
 export function findSessionLogs(root = path.join(dshHome(), 'sessions')) {
   const out = [];
@@ -84,12 +97,24 @@ export function findSessionLogs(root = path.join(dshHome(), 'sessions')) {
       continue;
     }
     for (const s of subs) {
-      const file = path.join(wsDir, s.name, 'session.v4.jsonl.zstd');
+      if (!s.isDirectory()) continue;
+      let files;
       try {
-        const st = fs.statSync(file);
-        out.push({ path: file, workspace: ws.name, session: s.name, mtime: st.mtimeMs, size: st.size });
+        files = fs.readdirSync(path.join(wsDir, s.name), { withFileTypes: true });
       } catch {
-        /* 不是会话目录 */
+        continue;
+      }
+      for (const f of files) {
+        if (!f.isFile()) continue;
+        const schema = schemaOf(f.name);
+        if (schema == null) continue;
+        const file = path.join(wsDir, s.name, f.name);
+        try {
+          const st = fs.statSync(file);
+          out.push({ path: file, workspace: ws.name, session: s.name, schema, mtime: st.mtimeMs, size: st.size });
+        } catch {
+          /* 读不到就算了 */
+        }
       }
     }
   }
@@ -99,6 +124,10 @@ export function findSessionLogs(root = path.join(dshHome(), 'sessions')) {
 
 export function latestSessionLog(root) {
   const logs = findSessionLogs(root);
-  if (!logs.length) throw new Error('no session.v4.jsonl.zstd found under ' + (root || path.join(dshHome(), 'sessions')));
+  if (!logs.length) {
+    throw new Error(
+      'no session log found under ' + (root || path.join(dshHome(), 'sessions')) + ' — looked for session[.v<N>].jsonl.zstd/.zst',
+    );
+  }
   return logs[0];
 }

package/src/index.js

@@ -5,10 +5,17 @@
  *   log_probe  看日志里有什么（轮次、时间、可用的锚点），只读、便宜
  *   log_slice  切一节出来；默认 dry-run，写盘要 apply === true
  *
- * 契约（对着 @deepseek-ai/dsh-tools 的用法）：
+ * 契约（对着 @deepseek-ai/dsh-tools 的 README 与 register() 的实现核对过）：
  *   - export const inject = ['tools']
- *   - apply(ctx) 里 ctx.tools.register(defineTool({...spec, execute}))
- *   - apply 的异常一律吞掉：最坏是插件不工作，不能让应用起不来
+ *   - 注册的 definition 必须带 output = { schema, render }，缺了会被 register() 直接拒
+ *   - execute 返回的是"规范值"（JSON），render(args, value) 把它渲染成 ContentBlock[]
+ *
+ * 这里有一个实际的坑：装进 profile 之后，`@deepseek-ai/dsh-tools` 未必能从插件目录
+ * 解析到（它只是 peerDependency，宿主也没有把它放进 profile 的 node_modules）。
+ * 所以这里两手准备：能拿到 defineTool 就用它（带参数校验），拿不到就自己构造一份
+ * 同样形状的 definition —— 少了参数校验，但注册与调用都正常。
+ *
+ * apply 的异常一律吞掉：最坏是插件不工作，不能让应用起不来。
  */
 
 import fs from 'node:fs';
@@ -19,22 +26,6 @@ import { indexRow, insertIndexRow, backupFile, appendSection, sha256Hex16, today
 export const name = 'dsh-log-slicer';
 export const inject = ['tools'];
 
-async function loadDefineTool() {
-  try {
-    const mod = await import('@deepseek-ai/dsh-tools');
-    if (mod?.defineTool) return mod.defineTool;
-  } catch {
-    /* 落到环境变量 */
-  }
-  const override = process.env.DSH_TOOLS_PATH;
-  if (override) {
-    const { pathToFileURL } = await import('node:url');
-    const mod = await import(pathToFileURL(override).href);
-    if (mod?.defineTool) return mod.defineTool;
-  }
-  throw new Error('cannot resolve @deepseek-ai/dsh-tools (set DSH_TOOLS_PATH for local dev)');
-}
-
 export const probeSpec = {
   name: 'log_probe',
   description: [
@@ -88,76 +79,165 @@ export const sliceSpec = {
   },
 };
 
-async function registerAll(ctx) {
-  const defineTool = await loadDefineTool();
+/** 把本文件的简写参数表转成 JSON Schema（defineTool 那条路会自己转，这条路自己转）。 */
+export function toJsonSchema(parameters = {}) {
+  const properties = {};
+  const required = [];
+  for (const [key, raw] of Object.entries(parameters)) {
+    const { required: isRequired, ...rest } = raw;
+    properties[key] = { ...rest };
+    if (isRequired) required.push(key);
+  }
+  const schema = { type: 'object', properties, additionalProperties: false };
+  if (required.length) schema.required = required;
+  return schema;
+}
+
+/** 拿 defineTool；拿不到返回 null（装进 profile 时很可能拿不到）。 */
+async function loadDefineTool() {
+  try {
+    const mod = await import('@deepseek-ai/dsh-tools');
+    if (typeof mod?.defineTool === 'function') return mod.defineTool;
+  } catch {
+    /* 落到下面的自造 */
+  }
+  const override = process.env.DSH_TOOLS_PATH;
+  if (override) {
+    try {
+      const { pathToFileURL } = await import('node:url');
+      const mod = await import(pathToFileURL(override).href);
+      if (typeof mod?.defineTool === 'function') return mod.defineTool;
+    } catch {
+      /* 一样落到自造 */
+    }
+  }
+  return null;
+}
 
-  const probe = defineTool({
-    ...probeSpec,
+/** 与 defineTool 产出同形状的 definition：register() 只要求 output.schema + output.render。 */
+export function plainTool({ name: toolName, description, parameters, execute }) {
+  return {
+    name: toolName,
+    description,
+    parameters: toJsonSchema(parameters),
+    output: {
+      schema: { type: 'string' },
+      render: (_args, value) => [{ type: 'text', text: String(value ?? '') }],
+    },
     async execute(args = {}) {
-      const limit = Math.max(1, Math.min(500, Number(args.limit) || 40));
-      const width = Math.max(10, Math.min(400, Number(args.width) || 60));
-      const built = buildSection({ kind: 'chat', title: 'probe', logPath: args.logPath });
-      const turns = built.segment.length ? built.segment : [];
-      const lines = turns.slice(-limit).map((t, i) => {
-        const who = t.who === 'user' ? 'you' : 'me';
-        const when = t.ts ? new Date(Number(t.ts) || t.ts).toLocaleString() : '';
-        const body = String(t.text || '').replace(/\s+/g, ' ').slice(0, width);
-        return `${turns.length - Math.min(limit, turns.length) + i + 1}. [${who}] ${when} ${body}`;
-      });
-      return {
-        text:
-          `# ${built.log}\n` +
-          `# ${built.frames} frames (${built.failedFrames} failed) / ${built.totalTurns} turns\n\n` +
-          lines.join('\n'),
-      };
+      return execute(args);
     },
-  });
+  };
+}
 
-  const slice = defineTool({
-    ...sliceSpec,
-    async execute(args = {}) {
-      const built = buildSection({
-        kind: args.kind === 'work' ? 'work' : 'chat',
-        title: args.title,
-        from: args.from,
-        to: args.to,
-        logPath: args.logPath,
-      });
-      const head =
-        `# ${built.log}\n` +
-        `# ${built.frames} frames (${built.failedFrames} failed) / ${built.totalTurns} turns\n` +
-        `# sliced ${built.segment.length} turns (you ${built.counts.you} / me ${built.counts.me})\n`;
-      if (args.apply !== true) {
-        return { text: `${head}\n===== markdown (dry-run) =====\n\n${built.markdown}` };
-      }
-      if (!args.file) throw new Error('apply=true requires "file"');
+function define(defineTool, spec, execute) {
+  if (defineTool) {
+    return defineTool({
+      name: spec.name,
+      description: spec.description,
+      parameters: spec.parameters,
+      output: {
+        schema: { type: 'string' },
+        render: (_args, value) => [{ type: 'text', text: String(value ?? '') }],
+      },
+      async execute(args) {
+        return execute(args);
+      },
+    });
+  }
+  return plainTool({ ...spec, execute });
+}
 
-      const target = path.resolve(args.file);
-      const tag = args.tag || '自动整理之前';
-      const backup = fs.existsSync(target) ? backupFile(target, tag) : null;
-      const { after } = appendSection(target, built.markdown);
-      const row = indexRow(args.volume || path.basename(target, '.md'), args.title, built.counts.you);
-      let indexBackup = null;
-      let indexPath = null;
-      if (args.index && fs.existsSync(args.index)) {
-        indexPath = path.resolve(args.index);
-        indexBackup = backupFile(indexPath, tag);
-        const updated = insertIndexRow(fs.readFileSync(indexPath, 'utf8'), row, args.volume || path.basename(target, '.md'));
-        fs.writeFileSync(indexPath, updated, 'utf8');
-      }
-      const line = `| ${today()} | ${path.basename(target)}（+${built.counts.you} 轮） | ${after} | \`${sha256Hex16(target)}\` | 本体＝原件，两处一致 |`;
-      return {
-        text:
-          `${head}\nwritten: ${target}\n` +
-          (backup ? `backup: ${backup}\n` : '') +
-          (indexBackup ? `backup: ${indexBackup}\n` : '') +
-          (indexPath ? `index: ${indexPath}\n` : '') +
-          `bytes: ${after}\nrow: ${row}\nverification: ${line}`,
-      };
-    },
+async function probe({ logPath, limit, width } = {}) {
+  const n = Math.max(1, Math.min(500, Number(limit) || 40));
+  const w = Math.max(10, Math.min(400, Number(width) || 60));
+  const built = buildSection({ kind: 'chat', title: 'probe', logPath });
+  const turns = built.segment.length ? built.segment : [];
+  const start = turns.length - Math.min(n, turns.length);
+  const lines = turns.slice(-n).map((t, i) => {
+    const who = t.who === 'user' ? 'you' : 'me';
+    const when = t.ts ? new Date(Number(t.ts) || t.ts).toLocaleString() : '';
+    const body = String(t.text || '').replace(/\s+/g, ' ').slice(0, w);
+    return `${start + i + 1}. [${who}] ${when} ${body}`;
+  });
+  return [
+    `# ${built.log}`,
+    `# schema ${built.schema ?? '?'} / ${built.frames} frames (${built.failedFrames} failed) / ${built.totalTurns} turns`,
+    '',
+    lines.join('\n'),
+  ].join('\n');
+}
+
+async function slice(args = {}) {
+  const built = buildSection({
+    kind: args.kind === 'work' ? 'work' : 'chat',
+    title: args.title,
+    from: args.from,
+    to: args.to,
+    logPath: args.logPath,
   });
+  const head = [
+    `# ${built.log}`,
+    `# schema ${built.schema ?? '?'} / ${built.frames} frames (${built.failedFrames} failed) / ${built.totalTurns} turns`,
+    `# sliced ${built.segment.length} turns (you ${built.counts.you} / me ${built.counts.me})`,
+  ].join('\n');
+
+  const pointerNote = built.pointerLines?.length
+    ? `\n# note: ${built.pointerLines.length} turn(s) look like pointers to a file, not the words themselves —` +
+      '\n# copy the real paragraphs from that file; if they are grading-3, do not quote them at all.' +
+      '\n#   ' + built.pointerLines.map((l) => l.text).join('\n#   ')
+    : '';
+
+  if (args.apply !== true) {
+    return `${head}${pointerNote}\n\n===== markdown (dry-run) =====\n\n${built.markdown}`;
+  }
+  if (!args.file) throw new Error('apply=true requires "file"');
+
+  const target = path.resolve(args.file);
+  const tag = args.tag || '自动整理之前';
+  const backup = fs.existsSync(target) ? backupFile(target, tag) : null;
+  const { after } = appendSection(target, built.markdown);
+  const volume = args.volume || path.basename(target, '.md');
+  const row = indexRow(volume, args.title, built.counts.you);
+  let indexBackup = null;
+  let indexPath = null;
+  if (args.index && fs.existsSync(args.index)) {
+    indexPath = path.resolve(args.index);
+    indexBackup = backupFile(indexPath, tag);
+    const updated = insertIndexRow(fs.readFileSync(indexPath, 'utf8'), row, volume);
+    fs.writeFileSync(indexPath, updated, 'utf8');
+  }
+  const line = `| ${today()} | ${path.basename(target)}（+${built.counts.you} 轮） | ${after} | \`${sha256Hex16(target)}\` | 本体＝原件，两处一致 |`;
+  return [
+    head,
+    pointerNote,
+    '',
+    `written: ${target}`,
+    backup ? `backup: ${backup}` : '',
+    indexBackup ? `backup: ${indexBackup}` : '',
+    indexPath ? `index: ${indexPath}` : '',
+    `bytes: ${after}`,
+    `row: ${row}`,
+    `verification: ${line}`,
+  ]
+    .filter(Boolean)
+    .join('\n');
+}
 
-  const disposers = [ctx.tools.register(probe), ctx.tools.register(slice)];
+async function registerAll(ctx) {
+  const defineTool = await loadDefineTool();
+  // 宿主的注册口可能在版本间挪位置：先认 ctx.tools.register，认不到就试 ctx.tool()，
+  // 都没有才抛——抛了会在 apply 里被记一行日志，不会带崩应用。
+  const register = typeof ctx?.tools?.register === 'function'
+    ? ctx.tools.register.bind(ctx.tools)
+    : typeof ctx?.tool === 'function'
+      ? ctx.tool.bind(ctx)
+      : null;
+  if (!register) throw new Error('host exposes neither ctx.tools.register nor ctx.tool');
+  const disposers = [
+    register(define(defineTool, probeSpec, probe)),
+    register(define(defineTool, sliceSpec, slice)),
+  ];
   return () => {
     for (const d of disposers.reverse()) d?.();
   };

package/src/pipeline.js

@@ -5,8 +5,9 @@
  */
 
 import fs from 'node:fs';
-import { decodeFile, latestSessionLog } from './decode.js';
-import { turnsFromText } from './clean.js';
+import path from 'node:path';
+import { decodeFile, latestSessionLog, schemaOf } from './decode.js';
+import { parseTurnLog } from './clean.js';
 import { sliceTurns, countTurns } from './slice.js';
 import { renderChat, renderWork, applyImageNotes, findPointerLines } from './render.js';
 
@@ -23,9 +24,9 @@ export function buildSection(options = {}) {
   const { kind = 'chat', title, from, to, logPath, workHeader } = options;
   if (!title) throw new Error('title is required');
 
-  const log = logPath ? { path: logPath, size: fsSize(logPath), mtime: 0 } : latestSessionLog();
+  const log = logPath ? { path: logPath, size: fsSize(logPath), mtime: 0, schema: schemaOf(logPath) } : latestSessionLog();
   const decoded = decodeFile(log.path);
-  const turns = turnsFromText(decoded.text);
+  const { turns, eventTypes } = parseTurnLog(decoded.text);
   const segment = sliceTurns(turns, { from, to });
   const counts = countTurns(segment);
 
@@ -37,9 +38,12 @@ export function buildSection(options = {}) {
 
   return {
     log: log.path,
+    logFile: path.basename(log.path),
+    schema: log.schema ?? null,
     logSize: decoded.frames ? log.size || 0 : 0,
     frames: decoded.frames,
     failedFrames: decoded.failed,
+    eventTypes,
     totalTurns: turns.length,
     segment,
     counts,