@ai-zen/cli 0.9.0 → 1.0.0-alpha.1

package/dist/config.js

@@ -15,7 +15,7 @@
  *   ├── mcp-oauth/                ← MCP OAuth token（共享）
  *   └── cli/                      ← CLI 运行时数据
  *       ├── conversations/        ← 对话记录
- *       └── drafts/               ← 草稿
+ *       └── last-session.json     ← 「上一轮会话 id」指针
  *
  *   ~/.agents/                    ← 业界通用规范（如 Cursor、Windsurf、Cline）
  *   ├── skills/                   ← 用户级 Skill
@@ -39,8 +39,7 @@
  *     4. ~/.agents/skills/
  */
 import { promises as fs } from "fs";
-import { join } from "path";
-import chalk from "chalk";
+import { dirname, join } from "path";
 import { ConfigManager as SdkConfigManager } from "@ai-zen/agents-sdk";
 // ==================== 根目录 ====================
 export const AI_ZEN_DIR = process.env.AI_ZEN_DIR || join(process.env.HOME || process.env.USERPROFILE || "", ".ai-zen");
@@ -48,7 +47,6 @@ export const AI_ZEN_DIR = process.env.AI_ZEN_DIR || join(process.env.HOME || pro
 export const CLI_DIR = join(AI_ZEN_DIR, "cli");
 export const CONFIG_FILE = join(AI_ZEN_DIR, "config.json");
 export const CONVERSATIONS_DIR = join(CLI_DIR, "conversations");
-export const DRAFTS_DIR = join(CLI_DIR, "drafts");
 // ==================== 共享目录 ====================
 export const AGENTS_DIR = join(AI_ZEN_DIR, "agents");
 export const SUB_AGENTS_DIR = join(AI_ZEN_DIR, "sub-agents");
@@ -77,14 +75,14 @@ const sdkConfigMgr = new SdkConfigManager(CONFIG_FILE);
  * 确保配置目录和默认文件存在。
  *
  * 共享实体（Agent、SubAgent、Skill 目录等）委托给 SDK 的 ConfigManager.bootstrap()。
- * CLI 自身的运行时目录（conversations/、drafts/）由本函数额外创建。
+ * CLI 自身的运行时目录（conversations/）由本函数额外创建。
  * SDK 的出厂默认配置会自动写入 config.json（如果不存在）。
  */
 export async function ensureConfigDir() {
     // SDK bootstrap：目录 + config.json + default Agent + default SubAgent
     await sdkConfigMgr.bootstrap();
     // CLI 运行时目录
-    const cliDirs = [CLI_DIR, CONVERSATIONS_DIR, DRAFTS_DIR];
+    const cliDirs = [CLI_DIR, CONVERSATIONS_DIR];
     for (const dir of cliDirs) {
         try {
             await fs.access(dir);
@@ -94,7 +92,7 @@ export async function ensureConfigDir() {
                 await fs.mkdir(dir, { recursive: true });
             }
             catch {
-                console.warn(chalk.yellow(`⚠️  无法创建目录: ${dir}`));
+                console.warn(`⚠️  无法创建目录: ${dir}`);
             }
         }
     }
@@ -108,19 +106,23 @@ export async function saveConfig(config) {
     await ensureConfigDir();
     await sdkConfigMgr.write(config);
 }
+/** 作用域对应的 mcp.json 路径 */
+export function mcpConfigPath(scope) {
+    return scope === "project" ? PROJECT_MCP_CONFIG_FILE : MCP_CONFIG_FILE;
+}
 /**
- * 读取全局 ~/.ai-zen/mcp.json，不存在时返回空结构。
+ * 读取指定路径的 mcp.json，不存在 / 解析失败时返回空结构。
  * 采用业界标准 `mcpServers` 顶层字段（与 SDK discoverMcpServers 一致）。
  */
-export async function readMcpConfig() {
+export async function readMcpConfigAt(path) {
     try {
-        await fs.access(MCP_CONFIG_FILE);
+        await fs.access(path);
     }
     catch {
         return { mcpServers: {} };
     }
     try {
-        const raw = JSON.parse(await fs.readFile(MCP_CONFIG_FILE, "utf-8"));
+        const raw = JSON.parse(await fs.readFile(path, "utf-8"));
         // 兼容并归一：以 mcpServers 为准，缺失时回退到空的 mcpServers
         return { mcpServers: raw.mcpServers ?? {} };
     }
@@ -129,27 +131,28 @@ export async function readMcpConfig() {
     }
 }
 /**
- * 原子写入全局 ~/.ai-zen/mcp.json。
+ * 原子写入指定路径的 mcp.json（必要时创建父目录）。
  */
-export async function writeMcpConfig(mcpConfig) {
-    const tmp = MCP_CONFIG_FILE + ".tmp";
+export async function writeMcpConfigAt(path, mcpConfig) {
+    await fs.mkdir(dirname(path), { recursive: true });
+    const tmp = path + ".tmp";
     await fs.writeFile(tmp, JSON.stringify(mcpConfig, null, 2), "utf-8");
-    await fs.rename(tmp, MCP_CONFIG_FILE);
+    await fs.rename(tmp, path);
+}
+/**
+ * 读取某个作用域的 mcp.json（默认全局 ~/.ai-zen/mcp.json）。
+ */
+export async function readMcpConfig(scope = "global") {
+    return readMcpConfigAt(mcpConfigPath(scope));
 }
+/**
+ * 原子写入某个作用域的 mcp.json（默认全局 ~/.ai-zen/mcp.json）。
+ */
+export async function writeMcpConfig(mcpConfig, scope = "global") {
+    await writeMcpConfigAt(mcpConfigPath(scope), mcpConfig);
+}
+/** 读取项目级 <cwd>/.ai-zen/mcp.json（等价于 readMcpConfig("project")） */
 export async function readProjectMcpConfig() {
-    const path = PROJECT_MCP_CONFIG_FILE;
-    try {
-        await fs.access(path);
-    }
-    catch {
-        return { mcpServers: {} };
-    }
-    try {
-        const raw = JSON.parse(await fs.readFile(path, "utf-8"));
-        return { mcpServers: raw.mcpServers ?? {} };
-    }
-    catch {
-        return { mcpServers: {} };
-    }
+    return readMcpConfigAt(PROJECT_MCP_CONFIG_FILE);
 }
 //# sourceMappingURL=config.js.map

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

@@ -1,13 +1,12 @@
 /**
  * 对话命令元数据 — 对话命令清单的唯一来源
  *
- * 命令名、别名与说明集中声明于此，由三类消费方共用：
- *   - 分发：`./index.ts` 按主命令名装配处理函数表，并按别名自动展开
- *   - 帮助：`./help.ts` 渲染 `/help` 输出
- *   - 提示：`../slash-hint-prompt.ts` 渲染输入 `/` 时的实时候选提示
+ * 命令名、别名与说明集中声明于此，由 TUI 层复用：
+ *   - 提示/补全：`src/tui/screens.tsx` 渲染输入 `/` 时的实时候选菜单
+ *   - 帮助：`/help` 命令按本清单渲染
  *
  * 新增、改名或调整说明只需改动本文件。本模块为纯数据与纯函数，
- * 不依赖 inquirer / chalk，可直接单测。
+ * 不依赖 chalk / React 等 UI 依赖，可直接单测。
  */
 /** 单个对话命令的元数据 */
 export interface CommandMeta {

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;;;;;;;;;;GAUG;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,EASlD,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;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,EAalD,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"}

package/dist/conversation-commands/registry.js

@@ -1,24 +1,27 @@
 /**
  * 对话命令元数据 — 对话命令清单的唯一来源
  *
- * 命令名、别名与说明集中声明于此，由三类消费方共用：
- *   - 分发：`./index.ts` 按主命令名装配处理函数表，并按别名自动展开
- *   - 帮助：`./help.ts` 渲染 `/help` 输出
- *   - 提示：`../slash-hint-prompt.ts` 渲染输入 `/` 时的实时候选提示
+ * 命令名、别名与说明集中声明于此，由 TUI 层复用：
+ *   - 提示/补全：`src/tui/screens.tsx` 渲染输入 `/` 时的实时候选菜单
+ *   - 帮助：`/help` 命令按本清单渲染
  *
  * 新增、改名或调整说明只需改动本文件。本模块为纯数据与纯函数，
- * 不依赖 inquirer / chalk，可直接单测。
+ * 不依赖 chalk / React 等 UI 依赖，可直接单测。
  */
 /** 命令元数据表（数组顺序即展示顺序） */
 export const COMMAND_REGISTRY = [
-    { name: "exit", aliases: ["quit"], description: "退出对话（会提示是否保存）" },
     { name: "save", description: "保存当前对话" },
+    { name: "load", description: "加载已保存的对话（替换当前会话）" },
     { name: "new", description: "重置会话（清空历史）" },
     { name: "back", description: "撤回消息（可修改后重发）" },
     { name: "editor", description: "使用系统编辑器输入长消息" },
     { name: "clear", description: "清屏" },
+    { name: "config", description: "打开配置中心（默认模型 / 端点管理）" },
+    { name: "key", description: "设置当前端点的 API Key" },
     { name: "migrate", description: "手动任务迁移（生成交接文档并开启新会话）" },
     { name: "help", description: "显示此帮助" },
+    // exit 置于末尾：斜杠菜单回车执行高亮项，避免「只输入 / 就回车」直接退出
+    { name: "exit", aliases: ["quit"], description: "退出对话（会提示是否保存）" },
 ];
 /** 展开全部命令为展示条目（别名折叠） */
 export function getCommandHints() {

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

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,wBAAwB;AACxB,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE;IACjE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE;IACvC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE;IAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE;IAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;IAC/C,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;IACpC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE;IACxD,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE;CACvC,CAAC;AAYF,wBAAwB;AACxB,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAChD,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,UAAU;QAAE,OAAO,eAAe,EAAE,CAAC;IAE1C,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/conversation-commands/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,wBAAwB;AACxB,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE;IACvC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACjD,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE;IAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE;IAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;IAC/C,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;IACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;IACtD,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE;IAC/C,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE;IACxD,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE;IACtC,0CAA0C;IAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE;CAClE,CAAC;AAYF,wBAAwB;AACxB,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAChD,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,UAAU;QAAE,OAAO,eAAe,EAAE,CAAC;IAE1C,OAAO,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * ConversationPersistPlugin — 会话自动落盘插件。
+ *
+ * 取代原 `DraftPlugin`：不再写单文件草稿，而是每轮内循环结束后把当前
+ * 消息写入该会话文件（`conversations/<id>.json`），并更新「上一轮会话 id」指针。
+ *
+ * 采用「方案 B」：仅在产生实质内容（至少一条用户消息）时落盘，避免留下空会话。
+ * 会话 id 通过 `getId()` 动态获取，以便任务迁移切换新会话后依然落盘到正确的文件。
+ */
+import type { AgentPlugin, SendContext } from "@ai-zen/agents-sdk";
+export interface ConversationPersistPluginOptions {
+    /** 动态返回当前会话 id（迁移切换会话后随之变化） */
+    getId: () => string;
+    agentId: string;
+    modelId: string;
+    cwd?: string;
+    /** 落盘失败时的上报（TUI 走 Ink notice）；默认丢弃 */
+    onError?: (text: string) => void;
+}
+export declare class ConversationPersistPlugin implements AgentPlugin {
+    private options;
+    constructor(options: ConversationPersistPluginOptions);
+    onInnerLoopEnd(ctx: SendContext): Promise<void>;
+}
+//# sourceMappingURL=conversation-persist-plugin.d.ts.map

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

@@ -0,0 +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,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;CAyBtD"}

package/dist/conversation-persist-plugin.js

@@ -0,0 +1,44 @@
+/**
+ * ConversationPersistPlugin — 会话自动落盘插件。
+ *
+ * 取代原 `DraftPlugin`：不再写单文件草稿，而是每轮内循环结束后把当前
+ * 消息写入该会话文件（`conversations/<id>.json`），并更新「上一轮会话 id」指针。
+ *
+ * 采用「方案 B」：仅在产生实质内容（至少一条用户消息）时落盘，避免留下空会话。
+ * 会话 id 通过 `getId()` 动态获取，以便任务迁移切换新会话后依然落盘到正确的文件。
+ */
+import { AgentNS } from "@ai-zen/agents-core";
+import { conversationRepository } from "./conversation-repository.js";
+import { writeLastSession } from "./session-pointer.js";
+export class ConversationPersistPlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async onInnerLoopEnd(ctx) {
+        const { getId, agentId, modelId, cwd, onError } = this.options;
+        const messages = ctx.agent.messages;
+        // 尚无实质内容（没有用户消息）时不落盘，避免产生空会话文件
+        if (!messages.some((m) => m.role === AgentNS.Role.User))
+            return;
+        const id = getId();
+        try {
+            const existing = await conversationRepository.read(id);
+            const now = new Date().toISOString();
+            await conversationRepository.write({
+                id,
+                agentId,
+                modelId,
+                messages,
+                cwd,
+                createdAt: existing?.createdAt ?? now,
+                updatedAt: now,
+            });
+            await writeLastSession(id);
+        }
+        catch (err) {
+            onError?.(`⚠️ 会话落盘失败：${err?.message ?? err}`);
+        }
+    }
+}
+//# sourceMappingURL=conversation-persist-plugin.js.map

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

@@ -0,0 +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;AAYxD,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,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/D,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,OAAO;gBACP,QAAQ;gBACR,GAAG;gBACH,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,GAAG;gBACrC,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,MAAM,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF"}

package/dist/conversation-repository.d.ts

@@ -3,6 +3,8 @@
  *
  * 会话是 CLI 的产品数据，由 CLI 自己维护（SDK 只负责驱动与能力）。
  * 复用 SDK 的 EntityRepository，按 id 一个 JSON 文件（${conversationsDir}/${id}.json）。
+ *
+ * 「上一轮会话 id」指针（session-pointer.ts）随每次落盘更新，供下次启动续接。
  */
 import { EntityRepository } from "@ai-zen/agents-sdk";
 import type { AgentNS } from "@ai-zen/agents-core";
@@ -20,8 +22,23 @@ export interface Conversation {
 /** 会话仓储：每个会话一个 JSON 文件（${conversationsDir}/${id}.json） */
 export declare const conversationRepository: EntityRepository<Conversation>;
 /**
- * 保存当前对话到 conversations 目录。
- * 迁移前落盘旧会话（onBeforeMigrate）、错误时自动保存等场景共同调用，保证 id 计算一致。
+ * 生成文件名安全的会话 id（语义化中文时间戳，天然不含非法字符）。
+ * 形如 `对话_2025年07月01日14时30分00秒`。
+ */
+export declare function generateConversationId(date?: Date): string;
+/**
+ * 保存当前对话到 conversations 目录，并更新「上一轮会话 id」指针。
+ * 迁移前落盘旧会话（onBeforeMigrate）、手动 /save 等场景共同调用，保证 id 计算一致。
  */
 export declare function saveConversation(ctx: ConversationContext): Promise<string>;
+/**
+ * 列出已保存的会话（仅读文件名与 mtime，不解析 JSON 内容，快），按更新时间倒序。
+ * 供对话内 `/load` 选择器使用。
+ */
+export declare function listConversations(): Promise<Array<{
+    id: string;
+    name: string;
+    updatedAt: string;
+    size: number;
+}>>;
 //# 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;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,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,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhF"}
+{"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,OAAO,EAAE,MAAM,CAAC;IAChB,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,CAchF;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"}

package/dist/conversation-repository.js

@@ -3,25 +3,68 @@
  *
  * 会话是 CLI 的产品数据，由 CLI 自己维护（SDK 只负责驱动与能力）。
  * 复用 SDK 的 EntityRepository，按 id 一个 JSON 文件（${conversationsDir}/${id}.json）。
+ *
+ * 「上一轮会话 id」指针（session-pointer.ts）随每次落盘更新，供下次启动续接。
  */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
 import { EntityRepository } from "@ai-zen/agents-sdk";
 import { CONVERSATIONS_DIR } from "./config.js";
+import { formatShortTime } from "./format-time.js";
+import { writeLastSession } from "./session-pointer.js";
 /** 会话仓储：每个会话一个 JSON 文件（${conversationsDir}/${id}.json） */
 export const conversationRepository = new EntityRepository(CONVERSATIONS_DIR);
 /**
- * 保存当前对话到 conversations 目录。
- * 迁移前落盘旧会话（onBeforeMigrate）、错误时自动保存等场景共同调用，保证 id 计算一致。
+ * 生成文件名安全的会话 id（语义化中文时间戳，天然不含非法字符）。
+ * 形如 `对话_2025年07月01日14时30分00秒`。
+ */
+export function generateConversationId(date = new Date()) {
+    return `对话_${formatShortTime(date.toISOString())}`.replace(/[\\/:*?"<>|]/g, "_");
+}
+/**
+ * 保存当前对话到 conversations 目录，并更新「上一轮会话 id」指针。
+ * 迁移前落盘旧会话（onBeforeMigrate）、手动 /save 等场景共同调用，保证 id 计算一致。
  */
 export async function saveConversation(ctx) {
-    const id = ctx.currentId || ctx.currentName.replace(/[\\/:*?"<>|]/g, "_");
+    const id = ctx.currentId || generateConversationId();
+    const existing = await conversationRepository.read(id);
+    const now = new Date().toISOString();
     await conversationRepository.write({
         id,
         agentId: ctx.agentId || "default",
         modelId: ctx.modelId,
         messages: ctx.agent.messages,
-        createdAt: new Date().toISOString(),
-        updatedAt: new Date().toISOString(),
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
     });
+    await writeLastSession(id);
     return id;
 }
+/**
+ * 列出已保存的会话（仅读文件名与 mtime，不解析 JSON 内容，快），按更新时间倒序。
+ * 供对话内 `/load` 选择器使用。
+ */
+export async function listConversations() {
+    try {
+        await fs.access(CONVERSATIONS_DIR);
+    }
+    catch {
+        return [];
+    }
+    const files = await fs.readdir(CONVERSATIONS_DIR);
+    const result = [];
+    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 });
+        }
+        catch {
+            /* 跳过读取失败的条目 */
+        }
+    }
+    return result.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+}
 //# sourceMappingURL=conversation-repository.js.map

package/dist/conversation-repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-repository.js","sourceRoot":"","sources":["../src/conversation-repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAchD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,gBAAgB,CAAe,iBAAiB,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAwB;IAC7D,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAC1E,MAAM,sBAAsB,CAAC,KAAK,CAAC;QACjC,EAAE;QACF,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;QACjC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"conversation-repository.js","sourceRoot":"","sources":["../src/conversation-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAcxD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,gBAAgB,CAAe,iBAAiB,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAa,IAAI,IAAI,EAAE;IAC5D,OAAO,MAAM,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAwB;IAC7D,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI,sBAAsB,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,sBAAsB,CAAC,KAAK,CAAC;QACjC,EAAE;QACF,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;QACjC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ;QAC5B,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,GAAG;QACrC,SAAS,EAAE,GAAG;KACf,CAAC,CAAC;IACH,MAAM,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IAGrC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD,MAAM,MAAM,GAAyE,EAAE,CAAC;IACxF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/dist/format-time.d.ts

@@ -2,7 +2,7 @@
  * 统一时间格式化工具
  *
  * 所有用户可见的时间文案统一使用 dayjs + zh-cn locale，
- * 确保各种场景（主菜单、对话列表、Agent 列表、草稿保存等）显示一致。
+ * 确保各种场景（会话列表、会话标签等）显示一致。
  */
 import "dayjs/locale/zh-cn.js";
 /**
@@ -26,7 +26,7 @@ export declare function formatFullTime(isoString: string): string;
  */
 export declare function formatShortTime(isoString: string): string;
 /**
- * 格式化消息数量+时间（用于主菜单草稿提示）
+ * 格式化消息数量+时间（用于会话标签；当前暂无调用点，保留供 P1 主菜单复用）
  * 例：12 条消息, 今天 14:30
  */
 export declare function formatMessageTime(messageCount: number, isoString: string): string;

package/dist/format-time.js

@@ -2,7 +2,7 @@
  * 统一时间格式化工具
  *
  * 所有用户可见的时间文案统一使用 dayjs + zh-cn locale，
- * 确保各种场景（主菜单、对话列表、Agent 列表、草稿保存等）显示一致。
+ * 确保各种场景（会话列表、会话标签等）显示一致。
  */
 import dayjs from "dayjs";
 import "dayjs/locale/zh-cn.js";
@@ -46,7 +46,7 @@ export function formatShortTime(isoString) {
     return dayjs(isoString).format("YYYY年MM月DD日HH时mm分ss秒");
 }
 /**
- * 格式化消息数量+时间（用于主菜单草稿提示）
+ * 格式化消息数量+时间（用于会话标签；当前暂无调用点，保留供 P1 主菜单复用）
  * 例：12 条消息, 今天 14:30
  */
 export function formatMessageTime(messageCount, isoString) {

package/dist/hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AA0CA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBjD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAuCnD"}
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AA8DA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BjD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBnD"}

package/dist/hook.js

@@ -1,8 +1,13 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { promises as fs } from "node:fs";
-const MARKER_START = "# === aiz hook (开始) ===";
-const MARKER_END = "# === aiz hook (结束) ===";
+/** 当前标记（ai hook 时代） */
+const MARKER_START = "# === ai hook (开始) ===";
+const MARKER_END = "# === ai hook (结束) ===";
+/** 历史标记（aiz hook 时代，用于平滑迁移） */
+const LEGACY_BLOCKS = [
+    { start: "# === aiz hook (开始) ===", end: "# === aiz hook (结束) ===" },
+];
 function detectShell() {
     const shell = process.env.SHELL || "";
     const home = homedir();
@@ -15,25 +20,35 @@ function detectShell() {
     return null;
 }
 function hookCode(hookFn) {
-    return [
-        "",
-        MARKER_START,
-        `${hookFn}() {`,
-        '  aiz "$@"',
-        "}",
-        MARKER_END,
-        "",
-    ].join("\n");
+    return ["", MARKER_START, `${hookFn}() {`, '  ai "$@"', "}", MARKER_END, ""].join("\n");
 }
-async function isInstalled(rcFile) {
-    try {
-        await fs.access(rcFile);
-    }
-    catch {
-        return false;
+/**
+ * 移除文件中所有 hook 代码块（含历史 aiz 标记），返回清理后的内容；
+ * `removed` 表示是否确有块被移除。
+ */
+function stripHookBlocks(content) {
+    const blocks = [{ start: MARKER_START, end: MARKER_END }, ...LEGACY_BLOCKS];
+    const lines = content.split("\n");
+    const kept = [];
+    let skipping = false;
+    let removed = false;
+    let matchedAny = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!skipping && blocks.some((b) => b.start === trimmed)) {
+            skipping = true;
+            removed = true;
+            matchedAny = true;
+            continue;
+        }
+        if (skipping && blocks.some((b) => b.end === trimmed)) {
+            skipping = false;
+            continue;
+        }
+        if (!skipping)
+            kept.push(line);
     }
-    const content = await fs.readFile(rcFile, "utf-8");
-    return content.includes(MARKER_START);
+    return { content: kept.join("\n"), removed: matchedAny };
 }
 export async function installHook() {
     const shell = detectShell();
@@ -41,12 +56,24 @@ export async function installHook() {
         console.error("❌ 不支持的 shell（仅支持 bash / zsh）");
         process.exit(1);
     }
-    if (await isInstalled(shell.rcFile)) {
-        console.log("ℹ️  aiz hook 已安装，无需重复操作");
+    let current = "";
+    try {
+        current = await fs.readFile(shell.rcFile, "utf-8");
+    }
+    catch {
+        // 文件不存在：视为空内容
+    }
+    if (current.includes(MARKER_START)) {
+        console.log("ℹ️  ai hook 已安装，无需重复操作");
         return;
     }
-    await fs.appendFile(shell.rcFile, hookCode(shell.hookFn), "utf-8");
-    console.log(`✅ aiz hook 已安装到 ${shell.rcFile}`);
+    // 迁移：先移除历史 aiz 块，再写入新块
+    const { content: cleaned, removed } = stripHookBlocks(current);
+    const base = cleaned.replace(/\n+$/, "");
+    await fs.writeFile(shell.rcFile, base + "\n" + hookCode(shell.hookFn), "utf-8");
+    console.log(`✅ ai hook 已安装到 ${shell.rcFile}`);
+    if (removed)
+        console.log("   （已自动升级旧版 aiz hook）");
     console.log(`   重启终端或执行 source ${shell.rcFile} 即可生效`);
     console.log(`   之后输入不存在的命令会自动转发给 AI 处理`);
 }
@@ -56,35 +83,20 @@ export async function uninstallHook() {
         console.error("❌ 不支持的 shell（仅支持 bash / zsh）");
         process.exit(1);
     }
+    let content;
     try {
-        await fs.access(shell.rcFile);
+        content = await fs.readFile(shell.rcFile, "utf-8");
     }
     catch {
-        console.log("ℹ️  aiz hook 未安装（文件不存在）");
+        console.log("ℹ️  ai hook 未安装（文件不存在）");
         return;
     }
-    const content = await fs.readFile(shell.rcFile, "utf-8");
-    if (!content.includes(MARKER_START)) {
-        console.log("ℹ️  aiz hook 未安装");
+    const { content: cleaned, removed } = stripHookBlocks(content);
+    if (!removed) {
+        console.log("ℹ️  ai hook 未安装");
         return;
     }
-    const lines = content.split("\n");
-    const newLines = [];
-    let skipping = false;
-    for (const line of lines) {
-        if (line.trim() === MARKER_START) {
-            skipping = true;
-            continue;
-        }
-        if (line.trim() === MARKER_END) {
-            skipping = false;
-            continue;
-        }
-        if (!skipping) {
-            newLines.push(line);
-        }
-    }
-    await fs.writeFile(shell.rcFile, newLines.join("\n"), "utf-8");
-    console.log(`✅ aiz hook 已从 ${shell.rcFile} 卸载`);
+    await fs.writeFile(shell.rcFile, cleaned, "utf-8");
+    console.log(`✅ ai hook 已从 ${shell.rcFile} 卸载`);
 }
 //# sourceMappingURL=hook.js.map