zencode-cli 0.1.0 → 0.2.1

package/dist/bin/zencode.js

@@ -446,6 +446,10 @@ var init_write_file = __esm({
           content: {
             type: "string",
             description: "\u8981\u5199\u5165\u7684\u6587\u4EF6\u5185\u5BB9"
+          },
+          overwrite: {
+            type: "boolean",
+            description: "\u6587\u4EF6\u5DF2\u5B58\u5728\u65F6\u662F\u5426\u786E\u8BA4\u8986\u76D6\uFF0C\u9ED8\u8BA4 false"
           }
         },
         required: ["path", "content"]
@@ -564,7 +568,7 @@ var init_bash = __esm({
       async execute(params) {
         const command = params["command"];
         const timeout = params["timeout"] || DEFAULT_TIMEOUT;
-        return new Promise((resolve7) => {
+        return new Promise((resolve8) => {
           exec(
             command,
             {
@@ -585,7 +589,7 @@ ${stderr}`;
               } else if (error && !stdout && !stderr) {
                 output = `\u547D\u4EE4\u6267\u884C\u5931\u8D25\uFF1A${error.message}`;
               }
-              resolve7({ content: output || "\uFF08\u65E0\u8F93\u51FA\uFF09" });
+              resolve8({ content: output || "\uFF08\u65E0\u8F93\u51FA\uFF09" });
             }
           );
         });
@@ -929,6 +933,108 @@ var init_conversation = __esm({
   }
 });
 
+// src/core/auto-memo.ts
+function extractExports(code) {
+  const names = [];
+  for (const m of code.matchAll(/export\s+(?:default\s+)?(?:function|class|const|let|var)\s+(\w+)/g)) {
+    names.push(m[1]);
+  }
+  for (const m of code.matchAll(/^(?:async\s+)?function\s+(\w+)/gm)) {
+    if (!names.includes(m[1])) names.push(m[1]);
+  }
+  for (const m of code.matchAll(/(?:^|\n)\s{0,4}(?:async\s+)?function\s+(\w+)/g)) {
+    if (!names.includes(m[1])) names.push(m[1]);
+  }
+  return [...new Set(names)].slice(0, 8).join(", ");
+}
+function autoMemoForTool(memoStore, toolName, params, result) {
+  if (!memoStore) return;
+  if (toolName === "write-file") {
+    const path8 = params["path"];
+    const content = params["content"] || "";
+    const lines = content.split("\n").length;
+    const exports = extractExports(content);
+    memoStore.write(
+      `file:${path8}`,
+      content,
+      "auto",
+      `\u65B0\u5EFA ${lines}\u884C${exports ? " | \u5BFC\u51FA: " + exports : ""}`
+    );
+  }
+  if (toolName === "edit-file") {
+    const path8 = params["path"];
+    const newStr = params["new_string"] || "";
+    const oldStr = params["old_string"] || "";
+    const changeLines = newStr.split("\n").length;
+    memoStore.write(
+      `file:${path8}`,
+      `--- \u65E7 ---
+${oldStr}
+--- \u65B0 ---
+${newStr}`,
+      "auto",
+      `\u7F16\u8F91 ${changeLines}\u884C\u53D8\u66F4`
+    );
+  }
+  if (toolName === "read-file") {
+    const path8 = params["path"];
+    const lines = result.split("\n").length;
+    const exports = extractExports(result);
+    memoStore.write(
+      `file:${path8}`,
+      result,
+      "auto",
+      `\u5DF2\u8BFB ${lines}\u884C${exports ? " | \u5BFC\u51FA: " + exports : ""}`
+    );
+  }
+}
+var init_auto_memo = __esm({
+  "src/core/auto-memo.ts"() {
+    "use strict";
+  }
+});
+
+// src/core/read-tracker.ts
+import * as fs6 from "fs";
+import * as path6 from "path";
+var ReadTracker;
+var init_read_tracker = __esm({
+  "src/core/read-tracker.ts"() {
+    "use strict";
+    ReadTracker = class {
+      files = /* @__PURE__ */ new Set();
+      /** 标记文件已被读取 */
+      markRead(filePath) {
+        this.files.add(this.normalize(filePath));
+      }
+      /** 标记文件已被写入（新建/重写，agent 已知内容） */
+      markWritten(filePath) {
+        this.files.add(this.normalize(filePath));
+      }
+      /** 检查文件是否已读取 */
+      hasRead(filePath) {
+        return this.files.has(this.normalize(filePath));
+      }
+      /**
+       * 检查 write-file 是否会覆盖已有文件
+       * @returns 警告消息（需要拦截），或 null（可以继续执行）
+       */
+      checkWriteOverwrite(filePath, overwrite) {
+        const resolved = path6.resolve(filePath);
+        if (!overwrite && fs6.existsSync(resolved)) {
+          return `\u26A0 \u6587\u4EF6\u5DF2\u5B58\u5728\uFF1A${filePath}
+\u4FEE\u6539\u5DF2\u6709\u6587\u4EF6\u8BF7\u7528 read-file + edit-file\uFF08\u66F4\u7CBE\u786E\u5B89\u5168\uFF09\u3002
+\u5982\u786E\u9700\u5B8C\u6574\u91CD\u5199\uFF0C\u8BF7\u91CD\u65B0\u8C03\u7528 write-file \u5E76\u8BBE\u7F6E overwrite: true\u3002`;
+        }
+        return null;
+      }
+      normalize(filePath) {
+        return filePath.replace(/\\/g, "/").replace(/^\.\//, "");
+      }
+    };
+  }
+});
+
 // src/core/agent.ts
 var Agent;
 var init_agent = __esm({
@@ -936,19 +1042,24 @@ var init_agent = __esm({
     "use strict";
     init_permission();
     init_conversation();
+    init_auto_memo();
+    init_read_tracker();
     Agent = class {
       conversation;
       client;
       registry;
       config;
       fixedTools;
-      constructor(client, registry, config, systemPrompt, tools) {
+      memoStore;
+      readTracker = new ReadTracker();
+      constructor(client, registry, config, systemPrompt, tools, memoStore) {
         this.client = client;
         this.registry = registry;
         this.config = config;
         this.conversation = new Conversation();
         this.conversation.setSystemPrompt(systemPrompt);
         this.fixedTools = tools;
+        this.memoStore = memoStore;
       }
       /**
        * 执行一轮完整的 agent 循环
@@ -978,6 +1089,26 @@ var init_agent = __esm({
               continue;
             }
             try {
+              if (toolName === "edit-file") {
+                const editPath = params["path"];
+                if (!this.readTracker.hasRead(editPath)) {
+                  this.conversation.addToolResult(
+                    toolCall.id,
+                    `\u26A0 \u7981\u6B62\u7F16\u8F91\u672A\u8BFB\u53D6\u7684\u6587\u4EF6\u3002\u8BF7\u5148 read-file "${editPath}" \u4E86\u89E3\u5F53\u524D\u5185\u5BB9\uFF0C\u518D edit-file\u3002`
+                  );
+                  continue;
+                }
+              }
+              if (toolName === "write-file") {
+                const warn = this.readTracker.checkWriteOverwrite(
+                  params["path"],
+                  params["overwrite"]
+                );
+                if (warn) {
+                  this.conversation.addToolResult(toolCall.id, warn);
+                  continue;
+                }
+              }
               const permLevel = this.registry.getPermissionLevel(toolName);
               if (permLevel === "deny") {
                 callbacks.onDenied?.(toolName);
@@ -998,6 +1129,12 @@ var init_agent = __esm({
               }
               const result = await this.registry.execute(toolName, params, this.config.max_tool_output);
               callbacks.onToolResult?.(toolName, result.content, result.truncated ?? false);
+              autoMemoForTool(this.memoStore, toolName, params, result.content);
+              if (toolName === "read-file") {
+                this.readTracker.markRead(params["path"]);
+              } else if (toolName === "write-file") {
+                this.readTracker.markWritten(params["path"]);
+              }
               this.conversation.addToolResult(toolCall.id, result.content);
             } catch (err) {
               const msg = err instanceof Error ? err.message : String(err);
@@ -1027,18 +1164,22 @@ var init_coder = __esm({
     "use strict";
     init_conversation();
     init_permission();
+    init_auto_memo();
+    init_read_tracker();
     Coder = class {
       client;
       registry;
       config;
       systemPrompt;
       tools;
-      constructor(client, registry, config, systemPrompt, tools) {
+      memoStore;
+      constructor(client, registry, config, systemPrompt, tools, memoStore) {
         this.client = client;
         this.registry = registry;
         this.config = config;
         this.systemPrompt = systemPrompt;
         this.tools = tools;
+        this.memoStore = memoStore;
       }
       /**
        * 执行编码任务（短生命周期，每次新建会话）
@@ -1051,6 +1192,7 @@ var init_coder = __esm({
         const conversation = new Conversation();
         conversation.setSystemPrompt(this.systemPrompt);
         conversation.addUserMessage(taskMessage);
+        const readTracker = new ReadTracker();
         let lastContent = "";
         while (true) {
           const assistantMsg = await this.client.chatStream(
@@ -1073,6 +1215,26 @@ var init_coder = __esm({
               continue;
             }
             try {
+              if (toolName === "edit-file") {
+                const editPath = params["path"];
+                if (!readTracker.hasRead(editPath)) {
+                  conversation.addToolResult(
+                    toolCall.id,
+                    `\u26A0 \u7981\u6B62\u7F16\u8F91\u672A\u8BFB\u53D6\u7684\u6587\u4EF6\u3002\u8BF7\u5148 read-file "${editPath}" \u4E86\u89E3\u5F53\u524D\u5185\u5BB9\uFF0C\u518D edit-file\u3002`
+                  );
+                  continue;
+                }
+              }
+              if (toolName === "write-file") {
+                const warn = readTracker.checkWriteOverwrite(
+                  params["path"],
+                  params["overwrite"]
+                );
+                if (warn) {
+                  conversation.addToolResult(toolCall.id, warn);
+                  continue;
+                }
+              }
               const permLevel = this.registry.getPermissionLevel(toolName);
               if (permLevel === "deny") {
                 callbacks.onDenied?.(toolName);
@@ -1093,6 +1255,12 @@ var init_coder = __esm({
               }
               const result = await this.registry.execute(toolName, params, this.config.max_tool_output);
               callbacks.onToolResult?.(toolName, result.content, result.truncated ?? false);
+              autoMemoForTool(this.memoStore, toolName, params, result.content);
+              if (toolName === "read-file") {
+                readTracker.markRead(params["path"]);
+              } else if (toolName === "write-file") {
+                readTracker.markWritten(params["path"]);
+              }
               conversation.addToolResult(toolCall.id, result.content);
             } catch (err) {
               const msg = err instanceof Error ? err.message : String(err);
@@ -1126,21 +1294,34 @@ var CODER_IDENTITY, DELEGATED_MODE, AUTONOMOUS_MODE, CONTROLLED_MODE;
 var init_modes = __esm({
   "src/core/dual-agent/modes.ts"() {
     "use strict";
-    CODER_IDENTITY = `\u4F60\u662F\u7F16\u7801\u5B50 Agent\u3002\u6309\u4EE5\u4E0B\u987A\u5E8F\u5DE5\u4F5C\uFF1A
+    CODER_IDENTITY = `\u4F60\u662F\u7F16\u7801\u5B50 Agent\u3002
 
-1. **\u8BFB memo**\uFF1A\u5982\u679C\u4EFB\u52A1\u63D0\u5230\u4E86 memo key\uFF0C\u5148 memo read \u83B7\u53D6\u8C03\u5EA6\u8005\u8BB0\u5F55\u7684\u4E0A\u4E0B\u6587
-2. **\u7F16\u7801**\uFF1A
-   - \u65B0\u5EFA\u6587\u4EF6 \u2192 \u76F4\u63A5 write-file
-   - \u4FEE\u6539\u6587\u4EF6 \u2192 read-file \u9605\u8BFB\u8981\u6539\u7684\u6587\u4EF6 \u2192 edit-file \u4FEE\u6539
-3. **\u5199 memo**\uFF1A\u5B8C\u6210\u540E memo write \u8BB0\u5F55\u6539\u52A8\u6458\u8981\uFF08key \u5982 "done-xxx"\uFF09\uFF0C\u4FBF\u4E8E\u8C03\u5EA6\u8005\u4E86\u89E3\u8FDB\u5C55
-4. **\u56DE\u590D**\uFF1A\u4E00\u53E5\u8BDD\u8BF4\u660E\u7ED3\u679C
+## \u5DE5\u4F5C\u6D41\u7A0B
+1. \u67E5\u770B\u4EFB\u52A1\u672B\u5C3E\u7684 [\u5171\u4EAB\u5907\u5FD8\u5F55] \u4E86\u89E3\u5DF2\u6709\u6587\u4EF6\u548C\u51FD\u6570
+   - \u6BCF\u884C\u683C\u5F0F\uFF1A[file:\u8DEF\u5F84] \u6458\u8981 | \u5BFC\u51FA: \u51FD\u6570\u540D\u5217\u8868
+   - \u9700\u8981\u5B8C\u6574\u6587\u4EF6\u5185\u5BB9\u6216 diff \u8BE6\u60C5 \u2192 memo read <key>
+2. \u7F16\u7801\uFF1A
+   - \u65B0\u5EFA\u6587\u4EF6 \u2192 write-file
+   - \u4FEE\u6539\u6587\u4EF6 \u2192 \u5FC5\u987B\u5148 read-file \u9605\u8BFB \u2192 \u518D edit-file \u4FEE\u6539
+   - \u26A0\uFE0F \u7CFB\u7EDF\u5F3A\u5236\uFF1A\u672A read-file \u7684\u6587\u4EF6\u65E0\u6CD5 edit-file\uFF0C\u4F1A\u88AB\u62E6\u622A
+   - \u5F15\u7528\u5DF2\u6709\u6587\u4EF6\u7684\u51FD\u6570\u65F6\uFF0C\u52A1\u5FC5\u4F7F\u7528 memo \u4E2D\u5217\u51FA\u7684\u51C6\u786E\u540D\u79F0
+3. \u4E00\u53E5\u8BDD\u8BF4\u660E\u7ED3\u679C
+
+\u6CE8\u610F\uFF1A\u6587\u4EF6\u64CD\u4F5C\uFF08write-file\u3001edit-file\uFF09\u4F1A\u81EA\u52A8\u8BB0\u5F55\u5230 memo\uFF0C\u4E0D\u9700\u8981\u624B\u52A8 memo write \u6587\u4EF6\u4FE1\u606F\u3002
+\u5982\u6709\u9700\u8981\uFF0C\u4ECD\u53EF memo write \u8BB0\u5F55\u975E\u6587\u4EF6\u7C7B\u4FE1\u606F\uFF08\u67B6\u6784\u51B3\u7B56\u3001\u6CE8\u610F\u4E8B\u9879\u7B49\uFF09\u3002
+
+## edit-file \u51C6\u786E\u6027\u89C4\u5219
+- old_string \u5FC5\u987B\u4ECE read-file \u8FD4\u56DE\u7684\u5185\u5BB9\u4E2D**\u7CBE\u786E\u590D\u5236**\uFF0C\u4E0D\u80FD\u51ED\u8BB0\u5FC6\u624B\u5199
+- old_string \u5305\u542B\u8DB3\u591F\u4E0A\u4E0B\u6587\u884C\uFF083-5 \u884C\uFF09\u786E\u4FDD\u552F\u4E00\u5339\u914D
+- \u7F29\u8FDB\u3001\u7A7A\u683C\u3001\u6362\u884C\u7B26\u5FC5\u987B\u5B8C\u5168\u4E00\u81F4
+- \u5982\u679C\u4E0D\u786E\u5B9A\u6587\u4EF6\u5185\u5BB9\uFF0C\u5148 read-file \u518D\u64CD\u4F5C
 
 ## \u7981\u6B62
-- \u274C \u7F16\u7801\u524D\u505A\u63A2\u7D22\uFF08bash ls/dir/pwd\u3001glob\u3001grep\uFF09\u2014 \u8C03\u5EA6\u8005\u5DF2\u7ECF\u505A\u8FC7\u4E86\uFF0C\u7ED3\u679C\u5728 memo \u4E2D
+- \u274C \u7F16\u7801\u524D\u505A\u63A2\u7D22\uFF08bash ls/dir/pwd\u3001glob\u3001grep\uFF09\u2014 \u4E0A\u4E0B\u6587\u5DF2\u5728 memo \u4E2D
 - \u274C \u8F93\u51FA\u8BA1\u5212\u3001\u5206\u6790\u3001\u601D\u8DEF\u8BF4\u660E \u2014 \u76F4\u63A5\u52A8\u624B
 - \u274C \u505A\u4EFB\u52A1\u8303\u56F4\u5916\u7684\u6539\u52A8
-- \u274C \u6DFB\u52A0\u672A\u8981\u6C42\u7684\u6CE8\u91CA\u3001\u6587\u6863\u3001\u9519\u8BEF\u5904\u7406
-- \u274C \u8FC7\u5EA6\u5DE5\u7A0B\u5316`;
+- \u274C \u8FC7\u5EA6\u5DE5\u7A0B\u5316
+- \u274C \u51ED\u8BB0\u5FC6\u731C\u6D4B\u6587\u4EF6\u5185\u5BB9\u7528\u4E8E edit-file \u7684 old_string`;
     DELEGATED_MODE = {
       name: "delegated",
       description: "A\u6536\u96C6\u4E0A\u4E0B\u6587\u5E76\u59D4\u6D3E\uFF0CB\u62E5\u6709\u5B8C\u6574\u5DE5\u5177\u72EC\u7ACB\u6267\u884C",
@@ -1175,6 +1356,8 @@ var init_orchestrator = __esm({
     init_permission();
     init_coder();
     init_modes();
+    init_auto_memo();
+    init_read_tracker();
     SEND_TO_CODER_TOOL = {
       type: "function",
       function: {
@@ -1201,6 +1384,7 @@ var init_orchestrator = __esm({
       mode;
       baseSystemPrompt;
       memoStore;
+      readTracker = new ReadTracker();
       constructor(registry, config, systemPrompt, memoStore) {
         this.registry = registry;
         this.config = config;
@@ -1246,31 +1430,29 @@ var init_orchestrator = __esm({
 
 \u534F\u4F5C\u6A21\u5F0F\uFF1A${modeInfo.name} - ${modeInfo.description}
 
-\u4F60\u662F\u4FA6\u5BDF\u5175 + \u6307\u6325\u5B98\u3002\u4F60\u81EA\u5DF1\u4E0D\u5199\u4EE3\u7801\uFF0C\u4F60\u7684\u804C\u8D23\u662F\uFF1A\u6536\u96C6\u60C5\u62A5 \u2192 \u8BB0\u5165 memo \u2192 \u59D4\u6D3E\u7F16\u7801 Agent\u3002
+\u4F60\u662F\u4FA6\u5BDF\u5175 + \u6307\u6325\u5B98\u3002\u4F60\u81EA\u5DF1\u4E0D\u5199\u4EE3\u7801\uFF0C\u4F60\u7684\u804C\u8D23\u662F\uFF1A\u6536\u96C6\u60C5\u62A5 \u2192 \u59D4\u6D3E\u7F16\u7801 Agent\u3002
 
 ## \u6838\u5FC3\u6D41\u7A0B
 
 1. **\u8BC4\u4F30**\uFF1A\u4EFB\u52A1\u662F\u5426\u9700\u8981\u4E86\u89E3\u73B0\u6709\u4EE3\u7801\uFF1F
-   - \u9700\u8981\u4FEE\u6539\u73B0\u6709\u6587\u4EF6\u3001\u9700\u8981\u4E0E\u73B0\u6709\u4EE3\u7801\u98CE\u683C\u4E00\u81F4\u3001\u9700\u8981\u7406\u89E3\u4F9D\u8D56\u5173\u7CFB \u2192 \u5148\u6536\u96C6
-   - \u9700\u6C42\u5B8C\u5168\u81EA\u5305\u542B\u3001\u76EE\u6807\u8DEF\u5F84\u5DF2\u660E\u786E \u2192 \u8DF3\u5230\u7B2C 3 \u6B65
+   - \u9700\u8981\u4FEE\u6539\u73B0\u6709\u6587\u4EF6\u3001\u9700\u8981\u7406\u89E3\u4F9D\u8D56\u5173\u7CFB \u2192 \u5148\u6536\u96C6
+   - \u9700\u6C42\u81EA\u5305\u542B\u3001\u76EE\u6807\u8DEF\u5F84\u660E\u786E \u2192 \u8DF3\u5230\u7B2C 3 \u6B65
 
 2. **\u6536\u96C6\u4E0A\u4E0B\u6587**\uFF08\u9AD8\u6548\uFF0C\u4E0D\u91CD\u590D\uFF09
-   - \u7528 glob/grep \u5B9A\u4F4D\uFF08\u4E00\u6B21\u5C31\u591F\uFF0C\u4E0D\u8981\u540C\u4E00\u76EE\u6807\u67E5\u591A\u6B21\uFF09
-   - \u7528 read-file \u6216 spawn-agents \u5E76\u884C\u8BFB\u53D6\u5173\u952E\u6587\u4EF6
-   - **\u5FC5\u987B memo write \u8BB0\u5F55\u53D1\u73B0**\uFF0Ckey \u7528\u6709\u610F\u4E49\u7684\u540D\u79F0
-     \u4F8B\uFF1Amemo write key="demo-structure" value="demo/ \u4E0B\u6709 weather.html\uFF08\u5929\u6C14\u7EC4\u4EF6\u793A\u4F8B\uFF09\uFF0C\u4F7F\u7528\u7EAF HTML+CSS+JS \u5355\u6587\u4EF6\u7ED3\u6784"
-   - \u7CBE\u70BC\u6458\u8981\uFF0C\u4E0D\u8981\u590D\u5236\u6574\u4E2A\u6587\u4EF6\u5185\u5BB9
+   - \u7528 glob/grep \u5B9A\u4F4D + read-file \u6216 spawn-agents \u5E76\u884C\u8BFB\u53D6
+   - \u6587\u4EF6\u64CD\u4F5C\uFF08read-file \u7B49\uFF09\u4F1A\u81EA\u52A8\u8BB0\u5F55\u5230 memo\uFF0C\u4E0D\u9700\u8981\u624B\u52A8 memo write \u6587\u4EF6\u5185\u5BB9
+   - \u4ECD\u53EF memo write \u8BB0\u5F55\u5206\u6790\u7ED3\u8BBA\u3001\u67B6\u6784\u51B3\u7B56\u7B49\u975E\u6587\u4EF6\u4FE1\u606F
 
 3. **\u59D4\u6D3E\u7F16\u7801**\uFF1Asend-to-coder
-   - task \u4E2D\u5199\u6E05\uFF1A\u505A\u4EC0\u4E48 + \u76EE\u6807\u8DEF\u5F84 + \u5F15\u7528 memo key
-     \u4F8B\uFF1Atask="\u5728 demo/newyear.html \u521B\u5EFA\u9A6C\u5E74\u6625\u8282\u795D\u798F\u7F51\u9875\u3002\u9879\u76EE\u73B0\u6709\u7ED3\u6784\u89C1 memo key 'demo-structure'\u3002\u8981\u6C42\uFF1A\u5355\u6587\u4EF6 HTML\uFF0C\u5305\u542B\u5185\u8054 CSS \u548C JS\uFF0C\u4E2D\u6587\u5185\u5BB9\u3002"
+   - task \u4E2D\u5199\u6E05\uFF1A\u505A\u4EC0\u4E48 + \u76EE\u6807\u8DEF\u5F84
+   - \u7F16\u7801 Agent \u4F1A\u81EA\u52A8\u770B\u5230 memo \u4E2D\u7684\u6587\u4EF6\u7D22\u5F15\uFF08\u5305\u62EC\u5DF2\u521B\u5EFA\u7684\u6587\u4EF6\u548C\u5BFC\u51FA\u7684\u51FD\u6570\u540D\uFF09
    - \u6BCF\u6B21\u53EA\u53D1\u4E00\u4E2A\u5177\u4F53\u6B65\u9AA4
 
 4. **\u8FED\u4EE3/\u9A8C\u8BC1**\uFF1A\u9700\u8981\u65F6\u7EE7\u7EED\u59D4\u6D3E\u6216\u7528 bash \u8FD0\u884C\u9A8C\u8BC1
 
 ## \u91CD\u8981
 
-- memo \u662F\u4F60\u4E0E\u7F16\u7801 Agent \u7684\u5171\u4EAB\u8BB0\u5FC6\uFF0C\u662F\u534F\u4F5C\u7684\u6838\u5FC3\u6865\u6881
+- memo \u7D22\u5F15\u4F1A\u81EA\u52A8\u6CE8\u5165\u7ED9\u7F16\u7801 Agent\uFF0C\u5305\u542B\u6240\u6709\u5DF2\u64CD\u4F5C\u6587\u4EF6\u7684\u6458\u8981\u548C\u5BFC\u51FA\u51FD\u6570\u540D
 - \u4E0D\u8981\u91CD\u590D\u63A2\u7D22\uFF08glob \u67E5\u8FC7\u5C31\u4E0D\u8981\u518D bash ls \u540C\u4E00\u76EE\u5F55\uFF09
 - bash \u7528\u4E8E\u6267\u884C\u547D\u4EE4\uFF08\u6784\u5EFA\u3001\u6D4B\u8BD5\uFF09\uFF0C\u4E0D\u9700\u8981\u59D4\u6D3E
 - \u5B8C\u6210\u6240\u6709\u6B65\u9AA4\u540E\u7B80\u8981\u544A\u77E5\u7528\u6237\u7ED3\u679C`;
@@ -1317,6 +1499,26 @@ var init_orchestrator = __esm({
                 this.conversation.addToolResult(toolCall.id, coderResponse);
                 continue;
               }
+              if (toolName === "edit-file") {
+                const editPath = params["path"];
+                if (!this.readTracker.hasRead(editPath)) {
+                  this.conversation.addToolResult(
+                    toolCall.id,
+                    `\u26A0 \u7981\u6B62\u7F16\u8F91\u672A\u8BFB\u53D6\u7684\u6587\u4EF6\u3002\u8BF7\u5148 read-file "${editPath}" \u4E86\u89E3\u5F53\u524D\u5185\u5BB9\uFF0C\u518D edit-file\u3002`
+                  );
+                  continue;
+                }
+              }
+              if (toolName === "write-file") {
+                const warn = this.readTracker.checkWriteOverwrite(
+                  params["path"],
+                  params["overwrite"]
+                );
+                if (warn) {
+                  this.conversation.addToolResult(toolCall.id, warn);
+                  continue;
+                }
+              }
               const permLevel = this.registry.getPermissionLevel(toolName);
               if (permLevel === "deny") {
                 callbacks.onDenied?.(toolName);
@@ -1337,6 +1539,12 @@ var init_orchestrator = __esm({
               }
               const result = await this.registry.execute(toolName, params, this.config.max_tool_output);
               callbacks.onToolResult?.(toolName, result.content, result.truncated ?? false);
+              autoMemoForTool(this.memoStore, toolName, params, result.content);
+              if (toolName === "read-file") {
+                this.readTracker.markRead(params["path"]);
+              } else if (toolName === "write-file") {
+                this.readTracker.markWritten(params["path"]);
+              }
               this.conversation.addToolResult(toolCall.id, result.content);
             } catch (err) {
               const msg = err instanceof Error ? err.message : String(err);
@@ -1375,7 +1583,8 @@ ${index}`;
           this.registry,
           this.config,
           modeInfo.coderSystemPrompt,
-          coderTools
+          coderTools,
+          this.memoStore
         );
         const response = await coder.execute(taskWithMemo, {
           onContent: callbacks.onContent,
@@ -1410,14 +1619,19 @@ function buildCorePrompt() {
 \u4F60\u6709\u4EE5\u4E0B\u5DE5\u5177\u53EF\u7528\uFF0C\u8BF7\u6839\u636E\u4EFB\u52A1\u9009\u62E9\u6700\u5408\u9002\u7684\u5DE5\u5177\uFF1A
 
 - **read-file**\uFF1A\u8BFB\u53D6\u6587\u4EF6\u5185\u5BB9\u3002\u4FEE\u6539\u4EE3\u7801\u524D\u5FC5\u987B\u5148\u8BFB\u53D6\u76EE\u6807\u6587\u4EF6\u3002\u652F\u6301 offset/limit \u8BFB\u53D6\u5927\u6587\u4EF6\u7684\u7279\u5B9A\u90E8\u5206\u3002
-- **edit-file**\uFF1A\u901A\u8FC7\u5B57\u7B26\u4E32\u66FF\u6362\u7F16\u8F91\u6587\u4EF6\u3002\u4F18\u5148\u4F7F\u7528 edit-file \u800C\u975E write-file \u4FEE\u6539\u5DF2\u6709\u6587\u4EF6\u2014\u2014\u5B83\u66F4\u7CBE\u786E\u3001\u66F4\u5B89\u5168\u3002old_string \u5FC5\u987B\u552F\u4E00\u5339\u914D\uFF0C\u5339\u914D\u5931\u8D25\u65F6\u63D0\u4F9B\u66F4\u591A\u4E0A\u4E0B\u6587\u4F7F\u5176\u552F\u4E00\u3002
+- **edit-file**\uFF1A\u901A\u8FC7\u5B57\u7B26\u4E32\u66FF\u6362\u7F16\u8F91\u6587\u4EF6\u3002\u4F18\u5148\u4F7F\u7528 edit-file \u800C\u975E write-file \u4FEE\u6539\u5DF2\u6709\u6587\u4EF6\u2014\u2014\u5B83\u66F4\u7CBE\u786E\u3001\u66F4\u5B89\u5168\u3002
+  - \u26A0\uFE0F \u7CFB\u7EDF\u5F3A\u5236\uFF1A\u672A\u7528 read-file \u8BFB\u53D6\u8FC7\u7684\u6587\u4EF6\u65E0\u6CD5 edit-file\uFF0C\u4F1A\u88AB\u62E6\u622A
+  - old_string \u5FC5\u987B\u4E0E\u6587\u4EF6\u4E2D\u7684\u5185\u5BB9**\u5B8C\u5168\u4E00\u81F4**\uFF08\u5305\u62EC\u7F29\u8FDB\u3001\u7A7A\u683C\u3001\u6362\u884C\u7B26\uFF09
+  - old_string \u4E0D\u552F\u4E00\u65F6\uFF0C\u5305\u542B\u66F4\u591A\u4E0A\u4E0B\u6587\u884C\uFF08\u5EFA\u8BAE 3-5 \u884C\uFF09\u4F7F\u5176\u552F\u4E00
+  - \u4E0D\u8981\u51ED\u8BB0\u5FC6\u731C\u6D4B\u6587\u4EF6\u5185\u5BB9\uFF0C\u5FC5\u987B\u57FA\u4E8E read-file \u7684\u5B9E\u9645\u8FD4\u56DE\u503C
 - **write-file**\uFF1A\u521B\u5EFA\u65B0\u6587\u4EF6\u6216\u5B8C\u6574\u91CD\u5199\u6587\u4EF6\u3002\u4EC5\u5728\u521B\u5EFA\u65B0\u6587\u4EF6\u6216\u9700\u8981\u5927\u5E45\u91CD\u5199\u65F6\u4F7F\u7528\u3002
 - **glob**\uFF1A\u6309\u6A21\u5F0F\u641C\u7D22\u6587\u4EF6\u8DEF\u5F84\u3002\u7528\u4E8E\u67E5\u627E\u6587\u4EF6\u4F4D\u7F6E\uFF08\u5982 \`**/*.ts\`\u3001\`src/**/config.*\`\uFF09\u3002
 - **grep**\uFF1A\u5728\u6587\u4EF6\u5185\u5BB9\u4E2D\u641C\u7D22\u6B63\u5219\u8868\u8FBE\u5F0F\u3002\u7528\u4E8E\u67E5\u627E\u51FD\u6570\u5B9A\u4E49\u3001\u5F15\u7528\u3001\u7279\u5B9A\u4EE3\u7801\u6A21\u5F0F\u3002
 - **bash**\uFF1A\u6267\u884C shell \u547D\u4EE4\u3002\u7528\u4E8E\u8FD0\u884C\u6784\u5EFA\u3001\u6D4B\u8BD5\u3001git \u64CD\u4F5C\u7B49\u3002\u4E0D\u8981\u7528 bash \u505A\u80FD\u7528\u4E0A\u8FF0\u5DE5\u5177\u5B8C\u6210\u7684\u4E8B\uFF08\u5982\u4E0D\u8981\u7528 cat \u8BFB\u6587\u4EF6\u3001\u4E0D\u8981\u7528 sed \u7F16\u8F91\u6587\u4EF6\u3001\u4E0D\u8981\u7528 find \u641C\u7D22\u6587\u4EF6\uFF09\u3002
 
 \u5173\u952E\u89C4\u5219\uFF1A
-- \u4FEE\u6539\u4EE3\u7801\u524D\u5148\u7528 read-file \u9605\u8BFB\u76F8\u5173\u6587\u4EF6\uFF0C\u7406\u89E3\u73B0\u6709\u903B\u8F91
+- **\u5148\u8BFB\u540E\u6539**\uFF1A\u4FEE\u6539\u6587\u4EF6\u524D\u5FC5\u987B read-file \u8BFB\u53D6\u8BE5\u6587\u4EF6\uFF08\u7CFB\u7EDF\u4F1A\u62E6\u622A\u672A\u8BFB\u53D6\u5C31 edit \u7684\u64CD\u4F5C\uFF09
+- edit-file \u7684 old_string \u5FC5\u987B\u4ECE read-file \u8FD4\u56DE\u7684\u5185\u5BB9\u4E2D\u7CBE\u786E\u590D\u5236\uFF0C\u4E0D\u8981\u624B\u52A8\u8F93\u5165\u6216\u51ED\u8BB0\u5FC6
 - \u4F18\u5148 edit-file \u7F16\u8F91\u5DF2\u6709\u6587\u4EF6\uFF0C\u800C\u975E write-file \u91CD\u5199
 - \u4E0D\u8981\u521B\u5EFA\u4E0D\u5FC5\u8981\u7684\u65B0\u6587\u4EF6\uFF0C\u4F18\u5148\u5728\u73B0\u6709\u6587\u4EF6\u4E2D\u4FEE\u6539
 - \u53EA\u505A\u5FC5\u8981\u7684\u6700\u5C0F\u6539\u52A8\uFF0C\u4E0D\u505A\u989D\u5916"\u6539\u8FDB"
@@ -1515,11 +1729,11 @@ var init_git = __esm({
 });
 
 // src/core/prompt/layers/project.ts
-import * as fs6 from "fs/promises";
-import * as path6 from "path";
+import * as fs7 from "fs/promises";
+import * as path7 from "path";
 async function buildProjectPrompt() {
   try {
-    const content = await fs6.readFile(path6.resolve("ZENCODE.md"), "utf-8");
+    const content = await fs7.readFile(path7.resolve("ZENCODE.md"), "utf-8");
     return content.trim() || null;
   } catch {
     return null;
@@ -1529,8 +1743,8 @@ async function loadUserPrompts(paths) {
   const prompts = [];
   for (const p of paths) {
     try {
-      const resolved = p.startsWith("~") ? path6.join(process.env["HOME"] || process.env["USERPROFILE"] || "", p.slice(1)) : path6.resolve(p);
-      const content = await fs6.readFile(resolved, "utf-8");
+      const resolved = p.startsWith("~") ? path7.join(process.env["HOME"] || process.env["USERPROFILE"] || "", p.slice(1)) : path7.resolve(p);
+      const content = await fs7.readFile(resolved, "utf-8");
       if (content.trim()) {
         prompts.push(content.trim());
       }
@@ -1546,10 +1760,10 @@ var init_project = __esm({
 });
 
 // src/core/prompt/builder.ts
-import * as fs7 from "fs";
+import * as fs8 from "fs";
 function isGitRepo() {
   try {
-    fs7.statSync(".git");
+    fs8.statSync(".git");
     return true;
   } catch {
     return false;
@@ -1649,9 +1863,15 @@ var init_memo_store = __esm({
     MAX_CONTENT_LENGTH = 3e3;
     MemoStore = class {
       entries = /* @__PURE__ */ new Map();
-      write(key, content, author = "agent") {
+      write(key, content, author = "agent", summary) {
         const trimmed = content.slice(0, MAX_CONTENT_LENGTH);
-        const entry = { key, content: trimmed, author, updatedAt: Date.now() };
+        const entry = {
+          key,
+          summary: summary || content.slice(0, 80).replace(/\n/g, " "),
+          content: trimmed,
+          author,
+          updatedAt: Date.now()
+        };
         if (!this.entries.has(key) && this.entries.size >= MAX_ENTRIES) {
           let oldest = null;
           let oldestTime = Infinity;
@@ -1673,7 +1893,7 @@ var init_memo_store = __esm({
         return [...this.entries.values()].map((e) => ({
           key: e.key,
           author: e.author,
-          preview: e.content.slice(0, 80)
+          summary: e.summary
         }));
       }
       delete(key) {
@@ -1683,15 +1903,13 @@ var init_memo_store = __esm({
         this.entries.clear();
       }
       /**
-       * 生成简短的备忘录索引（用于注入 Agent 系统提示词）
-       * 仅包含 key 列表和简短预览，占用极少 token
+       * 生成备忘录索引（注入 Coder 任务中）
+       * 只输出 key + summary，清爽紧凑
+       * Coder 需要详情时用 memo read <key> 获取完整内容
        */
       buildIndex() {
         if (this.entries.size === 0) return null;
-        const lines = [...this.entries.values()].map(
-          (e) => `- ${e.key}: ${e.content.slice(0, 50)}`
-        );
-        return lines.join("\n");
+        return [...this.entries.values()].map((e) => `[${e.key}] ${e.summary}`).join("\n");
       }
     };
   }
@@ -1703,6 +1921,8 @@ var init_sub_agent = __esm({
   "src/core/sub-agent.ts"() {
     "use strict";
     init_conversation();
+    init_auto_memo();
+    init_read_tracker();
     DEFAULT_TIMEOUT_MS = 12e4;
     SubAgent = class {
       client;
@@ -1739,6 +1959,7 @@ var init_sub_agent = __esm({
       }
       async execute() {
         const conversation = new Conversation();
+        const readTracker = new ReadTracker();
         let systemPrompt = `\u4F60\u662F ZenCode \u5B50 Agent\u3002\u4F60\u7684\u4EFB\u52A1\uFF1A${this.task}
 \u5B8C\u6210\u540E\u76F4\u63A5\u8FD4\u56DE\u7ED3\u679C\uFF0C\u4E0D\u8981\u591A\u4F59\u89E3\u91CA\u3002`;
         if (this.memoStore) {
@@ -1781,11 +2002,37 @@ ${index}`;
               continue;
             }
             try {
+              if (toolName === "edit-file") {
+                const editPath = params["path"];
+                if (!readTracker.hasRead(editPath)) {
+                  conversation.addToolResult(
+                    toolCall.id,
+                    `\u26A0 \u7981\u6B62\u7F16\u8F91\u672A\u8BFB\u53D6\u7684\u6587\u4EF6\u3002\u8BF7\u5148 read-file "${editPath}" \u4E86\u89E3\u5F53\u524D\u5185\u5BB9\uFF0C\u518D edit-file\u3002`
+                  );
+                  continue;
+                }
+              }
+              if (toolName === "write-file") {
+                const warn = readTracker.checkWriteOverwrite(
+                  params["path"],
+                  params["overwrite"]
+                );
+                if (warn) {
+                  conversation.addToolResult(toolCall.id, warn);
+                  continue;
+                }
+              }
               const result = await this.registry.execute(
                 toolName,
                 params,
                 this.config.max_tool_output
               );
+              autoMemoForTool(this.memoStore, toolName, params, result.content);
+              if (toolName === "read-file") {
+                readTracker.markRead(params["path"]);
+              } else if (toolName === "write-file") {
+                readTracker.markWritten(params["path"]);
+              }
               conversation.addToolResult(toolCall.id, result.content);
             } catch (err) {
               const msg = err instanceof Error ? err.message : String(err);
@@ -2031,7 +2278,11 @@ function createMemoTool(store) {
         },
         content: {
           type: "string",
-          description: "write \u65F6\u5FC5\u586B\uFF1A\u8981\u5199\u5165\u7684\u5185\u5BB9\uFF08\u5EFA\u8BAE\u7B80\u6D01\u6458\u8981\uFF0C\u6700\u591A 3000 \u5B57\u7B26\uFF09"
+          description: "write \u65F6\u5FC5\u586B\uFF1A\u8981\u5199\u5165\u7684\u5185\u5BB9\uFF08\u6700\u591A 3000 \u5B57\u7B26\uFF09"
+        },
+        summary: {
+          type: "string",
+          description: "write \u65F6\u53EF\u9009\uFF1A\u4E00\u884C\u6458\u8981\uFF08\u4E0D\u586B\u5219\u81EA\u52A8\u622A\u53D6 content \u524D 80 \u5B57\u7B26\uFF09"
         }
       },
       required: ["action"]
@@ -2043,10 +2294,11 @@ function createMemoTool(store) {
         case "write": {
           const key = params["key"];
           const content = params["content"];
+          const summary = params["summary"];
           if (!key || !content) {
             return { content: "\u9519\u8BEF\uFF1Awrite \u9700\u8981\u63D0\u4F9B key \u548C content" };
           }
-          const entry = store.write(key, content);
+          const entry = store.write(key, content, "agent", summary);
           return { content: `\u5DF2\u5199\u5165 memo [${entry.key}]\uFF08${entry.content.length} \u5B57\u7B26\uFF09` };
         }
         case "read": {
@@ -2067,7 +2319,7 @@ ${entry.content}` };
             return { content: "\u5907\u5FD8\u5F55\u4E3A\u7A7A" };
           }
           const lines = items.map(
-            (item) => `[${item.key}] (${item.author}) ${item.preview}`
+            (item) => `[${item.key}] (${item.author}) ${item.summary}`
           );
           return { content: `\u5171 ${items.length} \u6761\u5907\u5FD8\u5F55\uFF1A
 ${lines.join("\n")}` };
@@ -3420,7 +3672,7 @@ function App({ config, client, agent, orchestrator, registry, todoStore, memoSto
   );
   useEffect(() => {
     setStructuredConfirmHandler((toolName, params) => {
-      return new Promise((resolve7) => {
+      return new Promise((resolve8) => {
         const id = `confirm-${Date.now()}`;
         registerConfirmToolId(toolName, id);
         dispatch({
@@ -3431,13 +3683,13 @@ function App({ config, client, agent, orchestrator, registry, todoStore, memoSto
           resolve: (result) => {
             if (result === "always") {
               registry.addAutoApprove(toolName);
-              resolve7({ approved: true });
+              resolve8({ approved: true });
             } else if (result === "allow") {
-              resolve7({ approved: true });
+              resolve8({ approved: true });
             } else if (result === "deny") {
-              resolve7({ approved: false });
+              resolve8({ approved: false });
             } else {
-              resolve7({ approved: false, feedback: result.feedback });
+              resolve8({ approved: false, feedback: result.feedback });
             }
           }
         });
@@ -3707,7 +3959,7 @@ async function startTui(options) {
     registry.register(createTodoTool(todoStore));
   }
   registry.register(createMemoTool(memoStore));
-  const agent = new Agent(client, registry, config, systemPrompt);
+  const agent = new Agent(client, registry, config, systemPrompt, void 0, memoStore);
   const orchestrator = new Orchestrator(registry, config, systemPrompt, memoStore);
   const { waitUntilExit } = render(
     /* @__PURE__ */ jsx9(
@@ -3959,13 +4211,13 @@ async function startRepl(options) {
     historySize: 100
   });
   setConfirmHandler(async (promptText) => {
-    return new Promise((resolve7) => {
+    return new Promise((resolve8) => {
       process.stdout.write(promptText);
       const onData = (data) => {
         process.stdin.removeListener("data", onData);
         process.stdin.pause();
         const answer = data.toString().trim().toLowerCase();
-        resolve7(answer === "y");
+        resolve8(answer === "y");
       };
       process.stdin.resume();
       process.stdin.once("data", onData);
@@ -4131,7 +4383,7 @@ async function runOnce(prompt, config) {
   };
   try {
     if (config.agent_mode === "single") {
-      const agent = new Agent(client, registry, config, systemPrompt);
+      const agent = new Agent(client, registry, config, systemPrompt, void 0, memoStore);
       await agent.run(prompt, callbacks);
     } else {
       const orchestrator = new Orchestrator(registry, config, systemPrompt, memoStore);
@@ -4148,7 +4400,7 @@ async function runOnce(prompt, config) {
 }
 function createCli() {
   const program2 = new Command();
-  program2.name("zencode").description("\u6781\u7B80 CLI AI \u7F16\u7A0B\u5DE5\u5177").version("0.1.0").option("-m, --model <model>", "\u6307\u5B9A\u6A21\u578B\u540D\u79F0").option("-k, --api-key <key>", "API \u5BC6\u94A5").option("-u, --base-url <url>", "API \u57FA\u7840 URL").option("--single", "\u4F7F\u7528\u5355 Agent \u6A21\u5F0F").option("--dual", "\u4F7F\u7528\u53CC Agent \u6A21\u5F0F").option("--mode <mode>", "\u534F\u4F5C\u6A21\u5F0F (delegated/autonomous/controlled)").option("--simple", "\u4F7F\u7528\u7B80\u5355 REPL \u6A21\u5F0F\uFF08\u975E\u5168\u5C4F TUI\uFF09").argument("[prompt...]", "\u76F4\u63A5\u6267\u884C\u7684\u63D0\u793A\u8BCD\uFF08\u975E\u4EA4\u4E92\u5F0F\uFF09").action(async (promptParts, opts) => {
+  program2.name("zencode").description("\u6781\u7B80 CLI AI \u7F16\u7A0B\u5DE5\u5177").version("0.2.1").option("-m, --model <model>", "\u6307\u5B9A\u6A21\u578B\u540D\u79F0").option("-k, --api-key <key>", "API \u5BC6\u94A5").option("-u, --base-url <url>", "API \u57FA\u7840 URL").option("--single", "\u4F7F\u7528\u5355 Agent \u6A21\u5F0F").option("--dual", "\u4F7F\u7528\u53CC Agent \u6A21\u5F0F").option("--mode <mode>", "\u534F\u4F5C\u6A21\u5F0F (delegated/autonomous/controlled)").option("--simple", "\u4F7F\u7528\u7B80\u5355 REPL \u6A21\u5F0F\uFF08\u975E\u5168\u5C4F TUI\uFF09").argument("[prompt...]", "\u76F4\u63A5\u6267\u884C\u7684\u63D0\u793A\u8BCD\uFF08\u975E\u4EA4\u4E92\u5F0F\uFF09").action(async (promptParts, opts) => {
     const config = loadConfig(opts);
     if (!config.api_key) {
       printError("\u672A\u8BBE\u7F6E API \u5BC6\u94A5\u3002\u8BF7\u901A\u8FC7\u4EE5\u4E0B\u65B9\u5F0F\u4E4B\u4E00\u8BBE\u7F6E\uFF1A");