@ai-zen/cli 1.0.0-alpha.20 → 1.0.0-alpha.22

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/conversation-commands/registry.d.ts

@@ -13,12 +13,130 @@ export interface CommandMeta {
     /** 主命令名（不含 `/` 前缀），同时是处理函数表的键 */
     name: string;
     /** 等价别名（不含 `/` 前缀） */
-    aliases?: string[];
-    /** 一句话说明 */
-    description: string;
+    aliases?: readonly string[];
+    /**
+     * 一句话说明的 i18n key。
+     *
+     * 这里存 **key 而不是文案**：本模块是纯数据，加载时机靠前（甚至早于语言初始化），
+     * 存成文案就定死了「加载那一刻的语言」。渲染时由 `getCommandHints()` 用 `t()` 现取。
+     */
+    descriptionKey: string;
+    /**
+     * 执行期间会调用模型（较慢，几十秒）。
+     *
+     * 宿主据此**拦住输入框**：否则用户以为没反应、继续打字，按键会被静默吞进隐藏的
+     * 输入缓冲，等命令结束后才突然冒出来（迁移过程中出现过这个 bug）。
+     * 这是命令的属性而不是宿主的白名单 —— 新增命令只改本文件，宿主自动跟上。
+     */
+    blocksInput?: boolean;
 }
-/** 命令元数据表（数组顺序即展示顺序） */
+/**
+ * 命令元数据表（数组顺序即展示顺序）。
+ *
+ * 用 `as const` 声明以保留命令名的字面量类型，从而派生出 `CommandName`：
+ * 命令处理器表以 `Record<CommandName, …>` 声明，于是「新增命令但忘了写处理器」是
+ * **编译错误**，而不是运行时静默落到「未知命令」。
+ *
+ * 但 `as const` 的代价是联合类型里**没有别名的条目压根没有 `aliases` 字段**，
+ * 遍历时访问会报错。所以这里只把它作为内部字面量，对外导出的
+ * {@link COMMAND_REGISTRY} 放宽成 `readonly CommandMeta[]` —— 类型保护一分不少，
+ * 而所有遍历点都能直接读 `command.aliases`，不需要额外的取值 helper。
+ */
+declare const REGISTRY_ENTRIES: readonly [{
+    readonly name: "save";
+    readonly descriptionKey: "cmd.save.desc";
+}, {
+    readonly name: "load";
+    readonly descriptionKey: "cmd.load.desc";
+}, {
+    readonly name: "new";
+    readonly descriptionKey: "cmd.new.desc";
+}, {
+    readonly name: "back";
+    readonly descriptionKey: "cmd.back.desc";
+}, {
+    readonly name: "editor";
+    readonly descriptionKey: "cmd.editor.desc";
+}, {
+    readonly name: "clear";
+    readonly descriptionKey: "cmd.clear.desc";
+}, {
+    readonly name: "config";
+    readonly descriptionKey: "cmd.config.desc";
+}, {
+    readonly name: "model";
+    readonly descriptionKey: "cmd.model.desc";
+}, {
+    readonly name: "agent";
+    readonly descriptionKey: "cmd.agent.desc";
+}, {
+    readonly name: "reload";
+    readonly descriptionKey: "cmd.reload.desc";
+}, {
+    readonly name: "mcp";
+    readonly descriptionKey: "cmd.mcp.desc";
+}, {
+    readonly name: "lang";
+    readonly descriptionKey: "cmd.lang.desc";
+}, {
+    readonly name: "think";
+    readonly aliases: readonly ["effort"];
+    readonly descriptionKey: "cmd.think.desc";
+}, {
+    readonly name: "key";
+    readonly descriptionKey: "cmd.key.desc";
+}, {
+    readonly name: "handoff";
+    readonly descriptionKey: "cmd.handoff.desc";
+    readonly blocksInput: true;
+}, {
+    readonly name: "migrate";
+    readonly descriptionKey: "cmd.migrate.desc";
+    readonly blocksInput: true;
+}, {
+    readonly name: "help";
+    readonly descriptionKey: "cmd.help.desc";
+}, {
+    readonly name: "exit";
+    readonly aliases: readonly ["quit"];
+    readonly descriptionKey: "cmd.exit.desc";
+}];
+/** 命令主名的字面量联合（别名已归一到主名） */
+export type CommandName = (typeof REGISTRY_ENTRIES)[number]["name"];
+/** 命令元数据表：值来自上面的字面量，类型放宽到 `readonly CommandMeta[]` 便于遍历 */
 export declare const COMMAND_REGISTRY: readonly CommandMeta[];
+/**
+ * 把命令名（含别名）归一到主名；未知命令返回 `undefined`。
+ *
+ * `/think` 与 `/effort` 是同一条命令的两种写法，处理器只按主名注册一份。
+ */
+export declare function canonicalCommandName(name: string): CommandName | undefined;
+/** 命中命令的元数据（别名可查） */
+export declare function findCommand(name: string): CommandMeta | undefined;
+/** 该命令执行期间是否应拦住输入框（见 {@link CommandMeta.blocksInput}） */
+export declare function commandBlocksInput(name: string): boolean;
+/**
+ * 从原始输入里取命令参数（首个 token 之后的全部 token）。
+ *
+ * 与 {@link parseCommandInput} 共用 {@link splitCommandInput}，保证「命令名边界」与
+ * 「参数边界」用的是同一把尺子。
+ */
+export declare function parseCommandArgs(text: string): string[];
+/**
+ * 解析斜杠输入：`/migrate summary` → `{ name: "migrate", args: ["summary"] }`。
+ *
+ * 命令名的解析**只有这一处**：此前宿主自己也 `slice(1).split(/\s+/)[0]` 了一遍，
+ * 于是「命令名怎么算」在命令层与宿主层各有一份实现。
+ *
+ * 注意「只打了个 `/`」也算命令（`name` 为空串）：宿主按斜杠前缀分流，空命令名
+ * 落到「未知命令」——与拆出本函数之前的行为一致。
+ *
+ * @returns 非斜杠输入返回 `null`
+ */
+export declare function parseCommandInput(text: string): {
+    name: string;
+    args: string[];
+} | null;
 /** 命令展示条目：等价写法（如 `/exit` `/quit`）折叠为一条 */
 export interface CommandHint {
     /** 全部等价写法（不含 `/` 前缀），首个为主命令名 */
@@ -42,4 +160,5 @@ export declare const COMMAND_LABEL_WIDTH: number;
 export declare function matchCommandHints(keyword: string): CommandHint[];
 /** 全部命令名（含别名，升序），供启动横幅等场景展示 */
 export declare function getCommandNames(): string[];
+export {};
 //# sourceMappingURL=registry.d.ts.map

package/dist/conversation-commands/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAgBlD,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAS/C;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QACqC,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAOhE;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAM1C"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBqB,CAAC;AAE5C,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAAqB,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAO1E;AAED,qBAAqB;AACrB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGjE;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAcD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAIvF;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAS/C;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QACqC,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAOhE;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAM1C"}

package/dist/conversation-commands/registry.js

@@ -8,24 +8,99 @@
  * 新增、改名或调整说明只需改动本文件。本模块为纯数据与纯函数，
  * 不依赖 chalk / React 等 UI 依赖，可直接单测。
  */
-/** 命令元数据表（数组顺序即展示顺序） */
-export const COMMAND_REGISTRY = [
-    { name: "save", description: "保存当前对话" },
-    { name: "load", description: "加载已保存的对话（替换当前会话）" },
-    { name: "new", description: "重置会话（清空历史）" },
-    { name: "back", description: "撤回消息（可修改后重发）" },
-    { name: "editor", description: "使用系统编辑器输入长消息" },
-    { name: "clear", description: "清屏" },
-    { name: "config", description: "打开配置中心（默认模型 / 端点管理）" },
-    { name: "model", description: "切换当前会话使用的模型（写入配置）" },
-    { name: "think", aliases: ["effort"], description: "切换思考强度（写入模型配置）" },
-    { name: "key", description: "设置当前端点的 API Key" },
-    { name: "handoff", description: "编写任务交接文档（不切换会话）" },
-    { name: "migrate", aliases: ["migration"], description: "交接并开启新会话（生成交接文档）" },
-    { name: "help", description: "显示此帮助" },
+import { t } from "../i18n/index.js";
+/**
+ * 命令元数据表（数组顺序即展示顺序）。
+ *
+ * 用 `as const` 声明以保留命令名的字面量类型，从而派生出 `CommandName`：
+ * 命令处理器表以 `Record<CommandName, …>` 声明，于是「新增命令但忘了写处理器」是
+ * **编译错误**，而不是运行时静默落到「未知命令」。
+ *
+ * 但 `as const` 的代价是联合类型里**没有别名的条目压根没有 `aliases` 字段**，
+ * 遍历时访问会报错。所以这里只把它作为内部字面量，对外导出的
+ * {@link COMMAND_REGISTRY} 放宽成 `readonly CommandMeta[]` —— 类型保护一分不少，
+ * 而所有遍历点都能直接读 `command.aliases`，不需要额外的取值 helper。
+ */
+const REGISTRY_ENTRIES = [
+    { name: "save", descriptionKey: "cmd.save.desc" },
+    { name: "load", descriptionKey: "cmd.load.desc" },
+    { name: "new", descriptionKey: "cmd.new.desc" },
+    { name: "back", descriptionKey: "cmd.back.desc" },
+    { name: "editor", descriptionKey: "cmd.editor.desc" },
+    { name: "clear", descriptionKey: "cmd.clear.desc" },
+    { name: "config", descriptionKey: "cmd.config.desc" },
+    { name: "model", descriptionKey: "cmd.model.desc" },
+    { name: "agent", descriptionKey: "cmd.agent.desc" },
+    { name: "reload", descriptionKey: "cmd.reload.desc" },
+    { name: "mcp", descriptionKey: "cmd.mcp.desc" },
+    { name: "lang", descriptionKey: "cmd.lang.desc" },
+    { name: "think", aliases: ["effort"], descriptionKey: "cmd.think.desc" },
+    { name: "key", descriptionKey: "cmd.key.desc" },
+    { name: "handoff", descriptionKey: "cmd.handoff.desc", blocksInput: true },
+    { name: "migrate", descriptionKey: "cmd.migrate.desc", blocksInput: true },
+    { name: "help", descriptionKey: "cmd.help.desc" },
     // exit 置于末尾：斜杠菜单回车执行高亮项，避免「只输入 / 就回车」直接退出
-    { name: "exit", aliases: ["quit"], description: "退出对话（会提示是否保存）" },
+    { name: "exit", aliases: ["quit"], descriptionKey: "cmd.exit.desc" },
 ];
+/** 命令元数据表：值来自上面的字面量，类型放宽到 `readonly CommandMeta[]` 便于遍历 */
+export const COMMAND_REGISTRY = REGISTRY_ENTRIES;
+/**
+ * 把命令名（含别名）归一到主名；未知命令返回 `undefined`。
+ *
+ * `/think` 与 `/effort` 是同一条命令的两种写法，处理器只按主名注册一份。
+ */
+export function canonicalCommandName(name) {
+    const normalized = name.trim().toLowerCase();
+    // 在放宽类型的表上匹配（可直接读 `aliases`），再用同一下标取回字面量类型
+    const index = COMMAND_REGISTRY.findIndex((command) => command.name === normalized || command.aliases?.includes(normalized));
+    return index < 0 ? undefined : REGISTRY_ENTRIES[index].name;
+}
+/** 命中命令的元数据（别名可查） */
+export function findCommand(name) {
+    const canonical = canonicalCommandName(name);
+    return COMMAND_REGISTRY.find((command) => command.name === canonical);
+}
+/** 该命令执行期间是否应拦住输入框（见 {@link CommandMeta.blocksInput}） */
+export function commandBlocksInput(name) {
+    return findCommand(name)?.blocksInput ?? false;
+}
+/**
+ * 把原始斜杠输入切成「命令名 + 参数」。
+ *
+ * 两种返回形状共用同一个切分规则（`/migrate  self ` → `migrate` + `["self"]`）：
+ * 命令名由 {@link parseCommandInput} 取，参数由 {@link parseCommandArgs} 取。
+ * 以前命令层自己又 `raw.trim().split(/\s+/).slice(1)` 了一遍 —— 命令名收敛了，
+ * 参数没有，于是「参数怎么切」仍然有两份实现。
+ */
+function splitCommandInput(text) {
+    return text.trim().replace(/^\//, "").split(/\s+/);
+}
+/**
+ * 从原始输入里取命令参数（首个 token 之后的全部 token）。
+ *
+ * 与 {@link parseCommandInput} 共用 {@link splitCommandInput}，保证「命令名边界」与
+ * 「参数边界」用的是同一把尺子。
+ */
+export function parseCommandArgs(text) {
+    return splitCommandInput(text).slice(1);
+}
+/**
+ * 解析斜杠输入：`/migrate summary` → `{ name: "migrate", args: ["summary"] }`。
+ *
+ * 命令名的解析**只有这一处**：此前宿主自己也 `slice(1).split(/\s+/)[0]` 了一遍，
+ * 于是「命令名怎么算」在命令层与宿主层各有一份实现。
+ *
+ * 注意「只打了个 `/`」也算命令（`name` 为空串）：宿主按斜杠前缀分流，空命令名
+ * 落到「未知命令」——与拆出本函数之前的行为一致。
+ *
+ * @returns 非斜杠输入返回 `null`
+ */
+export function parseCommandInput(text) {
+    if (!text.trim().startsWith("/"))
+        return null;
+    const [name, ...args] = splitCommandInput(text);
+    return { name: name.toLowerCase(), args };
+}
 /** 展开全部命令为展示条目（别名折叠） */
 export function getCommandHints() {
     return COMMAND_REGISTRY.map((command) => {
@@ -33,7 +108,7 @@ export function getCommandHints() {
         return {
             names,
             label: names.map((name) => `/${name}`).join(" "),
-            description: command.description,
+            description: t(command.descriptionKey),
         };
     });
 }

package/dist/conversation-commands/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"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"}

package/dist/conversation-persist-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-persist-plugin.d.ts","sourceRoot":"","sources":["../src/conversation-persist-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKnE,MAAM,WAAW,gCAAgC;IAC/C,+BAA+B;IAC/B,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,yBAA0B,YAAW,WAAW;IAC/C,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,gCAAgC;IAEvD,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAwBtD"}
+{"version":3,"file":"conversation-persist-plugin.d.ts","sourceRoot":"","sources":["../src/conversation-persist-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKnE,MAAM,WAAW,gCAAgC;IAC/C,+BAA+B;IAC/B,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,yBAA0B,YAAW,WAAW;IAC/C,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,gCAAgC;IAEvD,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBtD"}

package/dist/conversation-persist-plugin.js

@@ -8,8 +8,8 @@
  * 会话 id 通过 `getId()` 动态获取，以便任务迁移切换新会话后依然落盘到正确的文件。
  */
 import { AgentNS } from "@ai-zen/agents-core";
-import { conversationRepository } from "./conversation-repository.js";
-import { writeLastSession } from "./session-pointer.js";
+import { persistConversation } from "./conversation-repository.js";
+import { t } from "./i18n/index.js";
 export class ConversationPersistPlugin {
     options;
     constructor(options) {
@@ -23,20 +23,12 @@ export class ConversationPersistPlugin {
             return;
         const id = getId();
         try {
-            const existing = await conversationRepository.read(id);
-            const now = new Date().toISOString();
-            await conversationRepository.write({
-                id,
-                agentId,
-                messages,
-                cwd,
-                createdAt: existing?.createdAt ?? now,
-                updatedAt: now,
-            });
-            await writeLastSession(cwd ?? process.cwd(), id);
+            // 每轮自动落盘也算「本目录的上一轮会话」—— 下次在该目录启动时续接它。
+            // `SendContext.cwd` 是 SDK 的可选字段，这里（调用点）是**唯一**需要兜底的地方。
+            await persistConversation({ id, agentId, messages, cwd: cwd ?? process.cwd() });
         }
         catch (err) {
-            onError?.(`⚠️ 会话落盘失败：${err?.message ?? err}`);
+            onError?.(t("chat.persistFailed", { error: err?.message ?? err }));
         }
     }
 }

package/dist/conversation-persist-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-persist-plugin.js","sourceRoot":"","sources":["../src/conversation-persist-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAWxD,MAAM,OAAO,yBAAyB;IAChB;IAApB,YAAoB,OAAyC;QAAzC,YAAO,GAAP,OAAO,CAAkC;IAAG,CAAC;IAEjE,KAAK,CAAC,cAAc,CAAC,GAAgB;QACnC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACtD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAEpC,+BAA+B;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAEhE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,sBAAsB,CAAC,KAAK,CAAC;gBACjC,EAAE;gBACF,OAAO;gBACP,QAAQ;gBACR,GAAG;gBACH,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,GAAG;gBACrC,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,MAAM,gBAAgB,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"conversation-persist-plugin.js","sourceRoot":"","sources":["../src/conversation-persist-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAWpC,MAAM,OAAO,yBAAyB;IAChB;IAApB,YAAoB,OAAyC;QAAzC,YAAO,GAAP,OAAO,CAAkC;IAAG,CAAC;IAEjE,KAAK,CAAC,cAAc,CAAC,GAAgB;QACnC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACtD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAEpC,+BAA+B;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAEhE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,sCAAsC;YACtC,uDAAuD;YACvD,MAAM,mBAAmB,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC,CAAC,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF"}

package/dist/conversation-repository.d.ts

@@ -7,14 +7,14 @@
  * 「上一轮会话 id」指针（session-pointer.ts）随每次落盘更新，供下次启动续接。
  */
 import { EntityRepository } from "@ai-zen/agents-sdk";
-import type { AgentNS } from "@ai-zen/agents-core";
+import { AgentNS } from "@ai-zen/agents-core";
 import type { ConversationContext } from "./types.js";
 export interface Conversation {
     id: string;
     agentId: string;
     /**
-     * @deprecated 已不再读写。模型真相源是 `AgentDefinition.modelId`。
-     * 保留字段仅为了不破坏旧存档的反序列化，读取时一律忽略。
+     * @deprecated 已不再读**也不写**（收敛前 stdio 的 `--save` 曾写入它）。
+     * 模型真相源是 `AgentDefinition.modelId`；保留字段仅为兼容旧存档的反序列化。
      */
     modelId?: string;
     messages: AgentNS.Message[];
@@ -23,26 +23,80 @@ export interface Conversation {
     createdAt: string;
     updatedAt: string;
 }
-/** 会话仓储：每个会话一个 JSON 文件（${conversationsDir}/${id}.json） */
-export declare const conversationRepository: EntityRepository<Conversation>;
 /**
- * 生成文件名安全的会话 id（语义化中文时间戳，天然不含非法字符）。
- * 形如 `对话_2025年07月01日14时30分00秒`。
+ * 会话仓储：每个会话一个 JSON 文件（${conversationsDir}/${id}.json），**写盘是原子的**。
+ *
+ * 为什么要覆写 `write()`：SDK 的实现是直接 `fs.writeFile`，进程在写一半时被杀
+ * （Ctrl+C、OOM、断电）就留下半截 JSON，`read()` 解析失败返回 null —— 整段历史
+ * 就此丢失。会话文件可达数 MB，写入窗口并不小。这里改成「写临时文件 → rename」：
+ * 同一文件系统内 rename 是原子操作，任何时刻读到的要么是旧文件、要么是完整新文件。
+ *
+ * 临时文件名为 `<id>.json.tmp`：`list()` 按 `.json` 后缀过滤，不会把它当成会话。
+ */
+declare class AtomicConversationRepository extends EntityRepository<Conversation> {
+    write(entity: Conversation): Promise<void>;
+}
+export declare const conversationRepository: AtomicConversationRepository;
+/**
+ * 生成文件名安全的会话 id：英文前缀 + 全下划线时间戳，中英一致。
+ * 形如 `chat_2026_10_28_00_56_34`。
  */
 export declare function generateConversationId(date?: Date): string;
+/** 落盘一份会话所需的全部输入 */
+export interface PersistConversationInput {
+    id: string;
+    agentId?: string;
+    messages: AgentNS.Message[];
+    /**
+     * 会话所属工作目录。**必填**：调用点都知道自己属于哪个目录，
+     * 留成可选只会在入口处多一层 `?? process.cwd()`，与调用点自己的兜底重复。
+     */
+    cwd: string;
+    /**
+     * 是否同时把「本目录上一轮会话」指针指向它（默认 true）。
+     *
+     * stdio 的 `--save` 传 false：那是一次性管道调用的归档，不该让下次 `ai` 续接到它
+     * （否则连着跑几条 `cat … | ai --save` 之后，`ai` 会续接到最后一条管道结果上）。
+     */
+    setAsLastSession?: boolean;
+}
 /**
- * 保存当前对话到 conversations 目录，并更新「上一轮会话 id」指针。
- * 迁移前落盘旧会话（onBeforeMigrate）、手动 /save 等场景共同调用，保证 id 计算一致。
+ * 落盘一份会话 —— **唯一的写入入口**。
+ *
+ * 此前「读旧记录拿 createdAt → 写 → 更新指针」这段在 5 个地方各写了一遍，并且已经
+ * 漂移：`saveConversation()` 漏写 `cwd`、stdio 的 `--save` 不更新指针、还写了一个已
+ * 废弃的 `modelId`。收敛到这里后，各处差异只剩「是否更新指针」一个显式开关。
  */
-export declare function saveConversation(ctx: ConversationContext): Promise<string>;
+export declare function persistConversation(input: PersistConversationInput): Promise<string>;
 /**
- * 列出已保存的会话（仅读文件名与 mtime，不解析 JSON 内容，快），按更新时间倒序。
- * 供对话内 `/load` 选择器使用。
+ * 保存当前对话（交接前落盘旧会话时用）：以 `ctx` 为真相源，走统一的写入入口。
  */
-export declare function listConversations(): Promise<Array<{
+export declare function saveConversation(ctx: ConversationContext): Promise<string>;
+/** `/load` 选择器的一行 */
+export interface ConversationSummary {
     id: string;
+    /** 文件名（= id），无摘要时的回退显示 */
     name: string;
+    /** 首条用户消息的第一行（截断）；读不到时为空串 */
+    preview: string;
     updatedAt: string;
     size: number;
-}>>;
+}
+/**
+ * 会话摘要：首条用户消息的第一行。
+ *
+ * 会话 id 是时间戳（`chat_2026_10_28_00_56_34`），直接当标签列出来完全分不清哪条是哪条。
+ * 取首行而不是整段：`CwdTrackerPlugin` 会在消息末尾追加工作目录注记，末尾对辨认无意义。
+ */
+export declare function conversationPreview(conversation: Conversation | null): string;
+/**
+ * 列出已保存的会话，按更新时间倒序。供对话内 `/load` 选择器使用。
+ *
+ * 先只 stat（快），排序后**只为将要显示的那几条**解析内容取摘要 —— 会话攒到上百条时，
+ * 逐个 `JSON.parse` 会明显拖慢 `/load`。
+ */
+export declare function listConversations(options: {
+    previewLimit: number;
+}): Promise<ConversationSummary[]>;
+export {};
 //# sourceMappingURL=conversation-repository.d.ts.map

package/dist/conversation-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-repository.d.ts","sourceRoot":"","sources":["../src/conversation-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,gCAAwD,CAAC;AAE5F;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAahF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAChD,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CACrE,CAmBA"}
+{"version":3,"file":"conversation-repository.d.ts","sourceRoot":"","sources":["../src/conversation-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAI9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,cAAM,4BAA6B,SAAQ,gBAAgB,CAAC,YAAY,CAAC;IACxD,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAO1D;AAED,eAAO,MAAM,sBAAsB,8BAAsD,CAAC;AAE1F;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAEtE;AAED,oBAAoB;AACpB,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa1F;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhF;AAED,qBAAqB;AACrB,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAK7E;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA6BzG"}

package/dist/conversation-repository.js

@@ -7,43 +7,93 @@
  * 「上一轮会话 id」指针（session-pointer.ts）随每次落盘更新，供下次启动续接。
  */
 import { promises as fs } from "node:fs";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { EntityRepository } from "@ai-zen/agents-sdk";
+import { AgentNS } from "@ai-zen/agents-core";
 import { CONVERSATIONS_DIR } from "./config.js";
-import { formatShortTime } from "./format-time.js";
+import { formatFileStamp } from "./format-time.js";
 import { writeLastSession } from "./session-pointer.js";
-/** 会话仓储：每个会话一个 JSON 文件（${conversationsDir}/${id}.json） */
-export const conversationRepository = new EntityRepository(CONVERSATIONS_DIR);
 /**
- * 生成文件名安全的会话 id（语义化中文时间戳，天然不含非法字符）。
- * 形如 `对话_2025年07月01日14时30分00秒`。
+ * 会话仓储：每个会话一个 JSON 文件（${conversationsDir}/${id}.json），**写盘是原子的**。
+ *
+ * 为什么要覆写 `write()`：SDK 的实现是直接 `fs.writeFile`，进程在写一半时被杀
+ * （Ctrl+C、OOM、断电）就留下半截 JSON，`read()` 解析失败返回 null —— 整段历史
+ * 就此丢失。会话文件可达数 MB，写入窗口并不小。这里改成「写临时文件 → rename」：
+ * 同一文件系统内 rename 是原子操作，任何时刻读到的要么是旧文件、要么是完整新文件。
+ *
+ * 临时文件名为 `<id>.json.tmp`：`list()` 按 `.json` 后缀过滤，不会把它当成会话。
+ */
+class AtomicConversationRepository extends EntityRepository {
+    async write(entity) {
+        const target = this.path(entity.id);
+        const tmp = `${target}.tmp`;
+        await fs.mkdir(dirname(target), { recursive: true });
+        await fs.writeFile(tmp, JSON.stringify(entity, null, 2), "utf-8");
+        await fs.rename(tmp, target);
+    }
+}
+export const conversationRepository = new AtomicConversationRepository(CONVERSATIONS_DIR);
+/**
+ * 生成文件名安全的会话 id：英文前缀 + 全下划线时间戳，中英一致。
+ * 形如 `chat_2026_10_28_00_56_34`。
  */
 export function generateConversationId(date = new Date()) {
-    return `对话_${formatShortTime(date.toISOString())}`.replace(/[\\/:*?"<>|]/g, "_");
+    return `chat_${formatFileStamp(date.toISOString())}`;
 }
 /**
- * 保存当前对话到 conversations 目录，并更新「上一轮会话 id」指针。
- * 迁移前落盘旧会话（onBeforeMigrate）、手动 /save 等场景共同调用，保证 id 计算一致。
+ * 落盘一份会话 —— **唯一的写入入口**。
+ *
+ * 此前「读旧记录拿 createdAt → 写 → 更新指针」这段在 5 个地方各写了一遍，并且已经
+ * 漂移：`saveConversation()` 漏写 `cwd`、stdio 的 `--save` 不更新指针、还写了一个已
+ * 废弃的 `modelId`。收敛到这里后，各处差异只剩「是否更新指针」一个显式开关。
  */
-export async function saveConversation(ctx) {
-    const id = ctx.currentId || generateConversationId();
-    const existing = await conversationRepository.read(id);
+export async function persistConversation(input) {
+    const existing = await conversationRepository.read(input.id);
     const now = new Date().toISOString();
     await conversationRepository.write({
-        id,
-        agentId: ctx.agentId || "default",
-        messages: ctx.agent.messages,
+        id: input.id,
+        agentId: input.agentId || "default",
+        messages: input.messages,
+        cwd: input.cwd,
         createdAt: existing?.createdAt ?? now,
         updatedAt: now,
     });
-    await writeLastSession(process.cwd(), id);
-    return id;
+    if (input.setAsLastSession !== false)
+        await writeLastSession(input.cwd, input.id);
+    return input.id;
+}
+/**
+ * 保存当前对话（交接前落盘旧会话时用）：以 `ctx` 为真相源，走统一的写入入口。
+ */
+export async function saveConversation(ctx) {
+    return persistConversation({
+        id: ctx.currentId || generateConversationId(),
+        agentId: ctx.agentId,
+        messages: ctx.agent.messages,
+        cwd: process.cwd(),
+    });
 }
+/** 摘要最大字符数（渲染侧还会按终端宽度再裁一次） */
+const PREVIEW_MAX = 80;
 /**
- * 列出已保存的会话（仅读文件名与 mtime，不解析 JSON 内容，快），按更新时间倒序。
- * 供对话内 `/load` 选择器使用。
+ * 会话摘要：首条用户消息的第一行。
+ *
+ * 会话 id 是时间戳（`chat_2026_10_28_00_56_34`），直接当标签列出来完全分不清哪条是哪条。
+ * 取首行而不是整段：`CwdTrackerPlugin` 会在消息末尾追加工作目录注记，末尾对辨认无意义。
+ */
+export function conversationPreview(conversation) {
+    const first = conversation?.messages?.find((m) => m.role === AgentNS.Role.User);
+    const content = typeof first?.content === "string" ? first.content : "";
+    const line = content.split("\n").find((part) => part.trim()) ?? "";
+    return line.trim().slice(0, PREVIEW_MAX);
+}
+/**
+ * 列出已保存的会话，按更新时间倒序。供对话内 `/load` 选择器使用。
+ *
+ * 先只 stat（快），排序后**只为将要显示的那几条**解析内容取摘要 —— 会话攒到上百条时，
+ * 逐个 `JSON.parse` 会明显拖慢 `/load`。
  */
-export async function listConversations() {
+export async function listConversations(options) {
     try {
         await fs.access(CONVERSATIONS_DIR);
     }
@@ -51,19 +101,27 @@ export async function listConversations() {
         return [];
     }
     const files = await fs.readdir(CONVERSATIONS_DIR);
-    const result = [];
+    const stats = [];
     for (const file of files) {
         if (!file.endsWith(".json"))
             continue;
         const id = file.replace(/\.json$/, "");
         try {
             const st = await fs.stat(join(CONVERSATIONS_DIR, file));
-            result.push({ id, name: id, updatedAt: st.mtime.toISOString(), size: st.size });
+            stats.push({ id, name: id, updatedAt: st.mtime.toISOString(), size: st.size });
         }
         catch {
             /* 跳过读取失败的条目 */
         }
     }
-    return result.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    stats.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    // `previewLimit` 必填：默认 0（=全部无摘要）是个静默陷阱 —— 漏传不会报错，
+    // 只会让列表变成一堆谁也分不清的时间戳 id。
+    const withPreview = await Promise.all(stats.map(async (item, index) => {
+        if (index >= options.previewLimit)
+            return { ...item, preview: "" };
+        return { ...item, preview: conversationPreview(await conversationRepository.read(item.id)) };
+    }));
+    return withPreview;
 }
 //# sourceMappingURL=conversation-repository.js.map