@zqagent/core 0.3.13 → 0.3.22

package/dist/tools/explore.js

@@ -314,8 +314,17 @@ var zh = {
 - \u4E0D\u8981\u5C06\u5B8C\u6574\u7684\u6587\u4EF6\u5185\u5BB9\u5F53\u4F5C\u771F\u7406\u3002\u53EA\u8BB0\u5F55\u67D0\u4E2A\u6587\u4EF6\u88AB\u8BFB\u53D6/\u7F16\u8F91\u8FC7\u8FD9\u4E00\u4E8B\u5B9E\uFF1B\u534F\u4F5C\u8005\u5982\u679C\u9700\u8981\u518D\u6B21\u83B7\u53D6\u5185\u5BB9\u4F1A\u91CD\u65B0\u8BFB\u53D6\u3002\u9648\u65E7\u7684\u6587\u4EF6\u8BB0\u5FC6\u6BD4\u6CA1\u6709\u8BB0\u5FC6\u66F4\u7CDF\u7CD5\u3002
 - \u82E5\u63D0\u4F9B\u4E86\u4E0A\u4E00\u7248\u6458\u8981\uFF1A\u53EA\u628A\u5B83\u4ECD\u7136\u6709\u6548\u7684\u7ED3\u8BBA\u5E76\u5165\u5BF9\u5E94\u7AE0\u8282\uFF0C\u4E0D\u8981\u6574\u6BB5\u590D\u8FF0\u6216\u9010\u6761\u8F6C\u6284\u3002
 - \u8981\u5177\u4F53\uFF1A\u8DEF\u5F84\u3001\u540D\u79F0\u3001\u547D\u4EE4\u3001id\u2014\u2014\u800C\u4E0D\u662F\u6A21\u7CCA\u7684\u5F15\u7528\u3002
+- \u7528\u7B80\u4F53\u4E2D\u6587\u64B0\u5199\u6458\u8981\u3002\u6458\u8981\u5728\u540E\u7EED\u6BCF\u4E00\u8F6E\u90FD\u4F1A\u968F\u4E0A\u4E0B\u6587\u91CD\u53D1\uFF0C\u8BED\u8A00\u4E0D\u4E00\u81F4\u4F1A\u8BA9\u534F\u4F5C\u8005\u6539\u7528\u82F1\u6587\u4F5C\u7B54\u3002
 - \u4EC5\u8F93\u51FA\u6458\u8981\u7AE0\u8282\uFF0C\u4E0D\u9644\u52A0\u524D\u8A00\u3002`,
   continuationContract: "\u4ECE\u4F60\u4E4B\u524D\u4E2D\u65AD\u7684\u5730\u65B9\u7EE7\u7EED\uFF1A\u5B8C\u5168\u6309\u7167\u63CF\u8FF0\u63A5\u7EED\u5F53\u524D\u5DE5\u4F5C\u548C\u4E0B\u4E00\u6B65\u3002\u4E0D\u8981\u91CD\u65B0\u8BE2\u95EE\u5DF2\u56DE\u7B54\u7684\u95EE\u9898\uFF0C\u4E0D\u8981\u56DE\u987E\uFF0C\u4E0D\u8981\u63D0\u53CA\u4E0A\u4E0B\u6587\u5DF2\u88AB\u538B\u7F29\u3002\u5982\u679C\u4F60\u9700\u8981\u4E0A\u8FF0\u63D0\u5230\u7684\u6587\u4EF6\u7684\u5185\u5BB9\uFF0C\u8BF7\u91CD\u65B0\u8BFB\u53D6\u5B83\u3002",
+  compactedIntro: "\u672C\u4F1A\u8BDD\u8F83\u65E9\u7684\u8F6E\u6B21\u5DF2\u88AB\u538B\u7F29\u3002\u4E0B\u9762\u7684\u6458\u8981\u5C31\u662F\u4F60\u5BF9\u90A3\u4E9B\u8F6E\u6B21\u7684\u8BB0\u5FC6\u3002",
+  compactedUserMessagesHeader: "## \u538B\u7F29\u533A\u95F4\u5185\u7684\u7528\u6237\u6D88\u606F\uFF08\u539F\u6587\uFF0C\u6309\u65F6\u95F4\u987A\u5E8F\uFF09",
+  compactedOmittedNote: (n) => `\uFF08\u66F4\u65E9\u7684 ${n} \u6761\u7528\u6237\u6D88\u606F\u5DF2\u7701\u7565 \u2014\u2014 \u5176\u610F\u56FE\u5DF2\u5305\u542B\u5728\u4E0A\u9762\u7684\u6458\u8981\u4E2D\uFF09`,
+  compactedTrimmedNote: "\uFF08\u8F83\u65E9\u7684\u8F6E\u6B21\u56E0\u4E0A\u4E0B\u6587\u7A97\u53E3\u9650\u5236\u88AB\u88C1\u526A\uFF0C\u6CA1\u6709\u53EF\u7528\u6458\u8981\u3002\u5982\u679C\u9700\u8981\u65E9\u5148\u7684\u7ED3\u679C\uFF0C\u8BF7\u91CD\u65B0\u8BFB\u53D6\u6587\u4EF6\u6216\u91CD\u65B0\u6267\u884C\u547D\u4EE4\u3002\uFF09",
+  workingStateHeader: "## \u5DE5\u4F5C\u72B6\u6001\uFF08\u4ECE\u5DE5\u5177\u8BB0\u5F55\u4E2D\u673A\u68B0\u63D0\u53D6\uFF09",
+  workingStateFiles: "\u5DF2\u5199\u5165/\u4FEE\u6539\u7684\u6587\u4EF6\uFF08\u6700\u8FD1\u7684\u5728\u524D\uFF09\uFF1A",
+  workingStateCommands: "\u6700\u8FD1\u7684 shell \u547D\u4EE4\uFF1A",
+  workingStateTools: (list) => `\u538B\u7F29\u533A\u95F4\u5185\u4F7F\u7528\u8FC7\u7684\u5DE5\u5177\uFF1A${list}`,
   genCommitMessageInstructions: `\u4F60\u662F Git \u63D0\u4EA4\u8BF4\u660E\u751F\u6210\u52A9\u624B\u3002\u6839\u636E\u7ED9\u5B9A\u7684\u4EE3\u7801\u5DEE\u5F02\uFF0C\u751F\u6210\u4E00\u6761\u51C6\u786E\u3001\u7B80\u6D01\u7684\u63D0\u4EA4\u8BF4\u660E\u3002
 
 \u8981\u6C42\uFF1A
@@ -469,8 +478,17 @@ Rules:
 - Do not treat full file contents as truth. Record only the fact that a file was read/edited; the collaborator will re-read it if it needs the content again. Stale file memory is worse than no memory.
 - If a previous summary is provided: fold only its still-valid conclusions into the matching sections; do not restate it wholesale or copy it entry by entry.
 - Be specific: paths, names, commands, ids \u2014 not vague references.
+- Write the summary in English. It is re-sent with the context on every later turn; a language mismatch makes the collaborator switch to another language.
 - Output only the summary sections, with no preamble.`,
   continuationContract: "Continue from where you left off: pick up the current work and next step exactly as described. Do not re-ask questions that were already answered, do not recap, and do not mention that the context was compacted. If you need the contents of a file mentioned above, read it again.",
+  compactedIntro: "Earlier turns of this session were compacted. The summary below is your memory of them.",
+  compactedUserMessagesHeader: "## User messages in the compacted span (verbatim, chronological)",
+  compactedOmittedNote: (n) => `(${n} earlier user messages omitted \u2014 their intent is covered by the summary above)`,
+  compactedTrimmedNote: "(Older turns were trimmed to fit the context window; no summary is available for them. Re-read files and re-run commands if earlier results are needed.)",
+  workingStateHeader: "## Working state (extracted mechanically from tool records)",
+  workingStateFiles: "Files written/edited (most recent first):",
+  workingStateCommands: "Recent shell commands:",
+  workingStateTools: (list) => `Tools used in the summarized span: ${list}`,
   genCommitMessageInstructions: `You are a Git commit message assistant. Given a code diff, produce an accurate, concise commit message.
 
 Requirements:
@@ -624,8 +642,17 @@ var zhTW = {
 - \u4E0D\u8981\u5C07\u5B8C\u6574\u7684\u6A94\u6848\u5167\u5BB9\u7576\u4F5C\u771F\u7406\u3002\u53EA\u8A18\u9304\u67D0\u500B\u6A94\u6848\u88AB\u8B80\u53D6/\u7DE8\u8F2F\u904E\u9019\u4E00\u4E8B\u5BE6\uFF1B\u5354\u4F5C\u8005\u5982\u679C\u9700\u8981\u518D\u6B21\u7372\u53D6\u5167\u5BB9\u6703\u91CD\u65B0\u8B80\u53D6\u3002\u9673\u820A\u7684\u6A94\u6848\u8A18\u61B6\u6BD4\u6C92\u6709\u8A18\u61B6\u66F4\u7CDF\u7CD5\u3002
 - \u82E5\u63D0\u4F9B\u4E86\u4E0A\u4E00\u7248\u6458\u8981\uFF1A\u53EA\u628A\u5B83\u4ECD\u7136\u6709\u6548\u7684\u7D50\u8AD6\u4F75\u5165\u5C0D\u61C9\u7AE0\u7BC0\uFF0C\u4E0D\u8981\u6574\u6BB5\u8907\u8FF0\u6216\u9010\u689D\u8F49\u6284\u3002
 - \u8981\u5177\u9AD4\uFF1A\u8DEF\u5F91\u3001\u540D\u7A31\u3001\u547D\u4EE4\u3001id\u2014\u2014\u800C\u4E0D\u662F\u6A21\u7CCA\u7684\u5F15\u7528\u3002
+- \u7528\u7E41\u9AD4\u4E2D\u6587\u64B0\u5BEB\u6458\u8981\u3002\u6458\u8981\u5728\u5F8C\u7E8C\u6BCF\u4E00\u8F2A\u90FD\u6703\u96A8\u4E0A\u4E0B\u6587\u91CD\u767C\uFF0C\u8A9E\u8A00\u4E0D\u4E00\u81F4\u6703\u8B93\u5354\u4F5C\u8005\u6539\u7528\u5176\u4ED6\u8A9E\u8A00\u4F5C\u7B54\u3002
 - \u50C5\u8F38\u51FA\u6458\u8981\u7AE0\u7BC0\uFF0C\u4E0D\u9644\u52A0\u524D\u8A00\u3002`,
   continuationContract: "\u5F9E\u4F60\u4E4B\u524D\u4E2D\u65B7\u7684\u5730\u65B9\u7E7C\u7E8C\uFF1A\u5B8C\u5168\u6309\u7167\u63CF\u8FF0\u63A5\u7E8C\u7576\u524D\u5DE5\u4F5C\u548C\u4E0B\u4E00\u6B65\u3002\u4E0D\u8981\u91CD\u65B0\u8A62\u554F\u5DF2\u56DE\u7B54\u7684\u554F\u984C\uFF0C\u4E0D\u8981\u56DE\u9867\uFF0C\u4E0D\u8981\u63D0\u53CA\u4E0A\u4E0B\u6587\u5DF2\u88AB\u58D3\u7E2E\u3002\u5982\u679C\u4F60\u9700\u8981\u4E0A\u8FF0\u63D0\u5230\u7684\u6A94\u6848\u7684\u5167\u5BB9\uFF0C\u8ACB\u91CD\u65B0\u8B80\u53D6\u5B83\u3002",
+  compactedIntro: "\u672C\u6703\u8A71\u8F03\u65E9\u7684\u8F2A\u6B21\u5DF2\u88AB\u58D3\u7E2E\u3002\u4E0B\u9762\u7684\u6458\u8981\u5C31\u662F\u4F60\u5C0D\u90A3\u4E9B\u8F2A\u6B21\u7684\u8A18\u61B6\u3002",
+  compactedUserMessagesHeader: "## \u58D3\u7E2E\u5340\u9593\u5167\u7684\u4F7F\u7528\u8005\u8A0A\u606F\uFF08\u539F\u6587\uFF0C\u6309\u6642\u9593\u9806\u5E8F\uFF09",
+  compactedOmittedNote: (n) => `\uFF08\u66F4\u65E9\u7684 ${n} \u5247\u4F7F\u7528\u8005\u8A0A\u606F\u5DF2\u7701\u7565 \u2014\u2014 \u5176\u610F\u5716\u5DF2\u5305\u542B\u5728\u4E0A\u9762\u7684\u6458\u8981\u4E2D\uFF09`,
+  compactedTrimmedNote: "\uFF08\u8F03\u65E9\u7684\u8F2A\u6B21\u56E0\u4E0A\u4E0B\u6587\u8996\u7A97\u9650\u5236\u88AB\u88C1\u526A\uFF0C\u6C92\u6709\u53EF\u7528\u6458\u8981\u3002\u5982\u679C\u9700\u8981\u65E9\u5148\u7684\u7D50\u679C\uFF0C\u8ACB\u91CD\u65B0\u8B80\u53D6\u6A94\u6848\u6216\u91CD\u65B0\u57F7\u884C\u547D\u4EE4\u3002\uFF09",
+  workingStateHeader: "## \u5DE5\u4F5C\u72C0\u614B\uFF08\u5F9E\u5DE5\u5177\u8A18\u9304\u4E2D\u6A5F\u68B0\u63D0\u53D6\uFF09",
+  workingStateFiles: "\u5DF2\u5BEB\u5165/\u4FEE\u6539\u7684\u6A94\u6848\uFF08\u6700\u8FD1\u7684\u5728\u524D\uFF09\uFF1A",
+  workingStateCommands: "\u6700\u8FD1\u7684 shell \u547D\u4EE4\uFF1A",
+  workingStateTools: (list) => `\u58D3\u7E2E\u5340\u9593\u5167\u4F7F\u7528\u904E\u7684\u5DE5\u5177\uFF1A${list}`,
   genCommitMessageInstructions: `\u4F60\u662F Git \u63D0\u4EA4\u8AAA\u660E\u751F\u6210\u52A9\u624B\u3002\u6839\u64DA\u7D66\u5B9A\u7684\u7A0B\u5F0F\u78BC\u5DEE\u7570\uFF0C\u751F\u6210\u4E00\u689D\u6E96\u78BA\u3001\u7C21\u6F54\u7684\u63D0\u4EA4\u8AAA\u660E\u3002
 
 \u8981\u6C42\uFF1A
@@ -779,8 +806,17 @@ shell \u30B3\u30DE\u30F3\u30C9\u306B\u8907\u6570\u884C\u306E\u30B9\u30AF\u30EA\u
 - \u30D5\u30A1\u30A4\u30EB\u306E\u5185\u5BB9\u5168\u4F53\u3092\u771F\u5B9F\u3068\u3057\u3066\u6271\u308F\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002\u3042\u308B\u30D5\u30A1\u30A4\u30EB\u304C\u8AAD\u307E\u308C\u305F\uFF0F\u7DE8\u96C6\u3055\u308C\u305F\u3068\u3044\u3046\u4E8B\u5B9F\u3060\u3051\u3092\u8A18\u9332\u3057\u307E\u3059\u3002\u5354\u50CD\u8005\u306F\u5185\u5BB9\u304C\u518D\u3073\u5FC5\u8981\u306B\u306A\u308C\u3070\u8AAD\u307F\u76F4\u3057\u307E\u3059\u3002\u53E4\u3044\u30D5\u30A1\u30A4\u30EB\u8A18\u61B6\u306F\u8A18\u61B6\u304C\u306A\u3044\u3088\u308A\u60AA\u3044\u3002
 - \u524D\u56DE\u306E\u8981\u7D04\u304C\u63D0\u4F9B\u3055\u308C\u305F\u5834\u5408\uFF1A\u307E\u3060\u6709\u52B9\u306A\u7D50\u8AD6\u3060\u3051\u3092\u8A72\u5F53\u30BB\u30AF\u30B7\u30E7\u30F3\u306B\u7D71\u5408\u3057\u3001\u5168\u4F53\u3092\u66F8\u304D\u76F4\u3057\u305F\u308A\u9805\u76EE\u3054\u3068\u306B\u8EE2\u8A18\u3057\u305F\u308A\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
 - \u5177\u4F53\u7684\u306B\uFF1A\u30D1\u30B9\u3001\u540D\u524D\u3001\u30B3\u30DE\u30F3\u30C9\u3001id \u3092\u66F8\u304F\u3002\u66D6\u6627\u306A\u53C2\u7167\u306B\u3057\u306A\u3044\u3002
+- \u8981\u7D04\u306F\u65E5\u672C\u8A9E\u3067\u66F8\u3044\u3066\u304F\u3060\u3055\u3044\u3002\u8981\u7D04\u306F\u4EE5\u964D\u306E\u6BCE\u30BF\u30FC\u30F3\u3067\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3068\u3068\u3082\u306B\u518D\u9001\u3055\u308C\u308B\u305F\u3081\u3001\u8A00\u8A9E\u304C\u98DF\u3044\u9055\u3046\u3068\u5354\u50CD\u8005\u304C\u5225\u306E\u8A00\u8A9E\u3067\u7B54\u3048\u308B\u3088\u3046\u306B\u306A\u308A\u307E\u3059\u3002
 - \u8981\u7D04\u30BB\u30AF\u30B7\u30E7\u30F3\u3060\u3051\u3092\u51FA\u529B\u3057\u3001\u524D\u7F6E\u304D\u3092\u4ED8\u3051\u306A\u3044\u3002`,
   continuationContract: "\u524D\u56DE\u4E2D\u65AD\u3057\u305F\u3068\u3053\u308D\u304B\u3089\u7D9A\u3051\u3066\u304F\u3060\u3055\u3044\uFF1A\u8AAC\u660E\u3069\u304A\u308A\u306B\u73FE\u5728\u306E\u4F5C\u696D\u3068\u6B21\u306E\u624B\u9806\u3092\u5F15\u304D\u7D99\u304E\u307E\u3059\u3002\u65E2\u306B\u56DE\u7B54\u6E08\u307F\u306E\u8CEA\u554F\u3092\u7E70\u308A\u8FD4\u3055\u305A\u3001\u632F\u308A\u8FD4\u3089\u305A\u3001\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u5727\u7E2E\u3055\u308C\u305F\u3053\u3068\u306B\u3082\u89E6\u308C\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002\u4E0A\u8A18\u3067\u8A00\u53CA\u3055\u308C\u305F\u30D5\u30A1\u30A4\u30EB\u306E\u5185\u5BB9\u304C\u5FC5\u8981\u306A\u5834\u5408\u306F\u3001\u3082\u3046\u4E00\u5EA6\u8AAD\u3093\u3067\u304F\u3060\u3055\u3044\u3002",
+  compactedIntro: "\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u4EE5\u524D\u306E\u30BF\u30FC\u30F3\u306F\u5727\u7E2E\u3055\u308C\u307E\u3057\u305F\u3002\u4EE5\u4E0B\u306E\u8981\u7D04\u304C\u305D\u308C\u3089\u306E\u30BF\u30FC\u30F3\u306B\u3064\u3044\u3066\u306E\u3042\u306A\u305F\u306E\u8A18\u61B6\u3067\u3059\u3002",
+  compactedUserMessagesHeader: "## \u5727\u7E2E\u533A\u9593\u5185\u306E\u30E6\u30FC\u30B6\u30FC\u30E1\u30C3\u30BB\u30FC\u30B8\uFF08\u539F\u6587\u3001\u6642\u7CFB\u5217\uFF09",
+  compactedOmittedNote: (n) => `\uFF08\u4EE5\u524D\u306E\u30E6\u30FC\u30B6\u30FC\u30E1\u30C3\u30BB\u30FC\u30B8 ${n} \u4EF6\u306F\u7701\u7565\u3055\u308C\u307E\u3057\u305F \u2014 \u305D\u306E\u610F\u56F3\u306F\u4E0A\u8A18\u306E\u8981\u7D04\u306B\u542B\u307E\u308C\u3066\u3044\u307E\u3059\uFF09`,
+  compactedTrimmedNote: "\uFF08\u4EE5\u524D\u306E\u30BF\u30FC\u30F3\u306F\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u30A6\u30A3\u30F3\u30C9\u30A6\u306E\u5236\u9650\u306B\u3088\u308A\u5207\u308A\u8A70\u3081\u3089\u308C\u3001\u8981\u7D04\u306F\u3042\u308A\u307E\u305B\u3093\u3002\u4EE5\u524D\u306E\u7D50\u679C\u304C\u5FC5\u8981\u306A\u5834\u5408\u306F\u3001\u30D5\u30A1\u30A4\u30EB\u3092\u518D\u8AAD\u307F\u8FBC\u307F\u3059\u308B\u304B\u30B3\u30DE\u30F3\u30C9\u3092\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002\uFF09",
+  workingStateHeader: "## \u4F5C\u696D\u72B6\u614B\uFF08\u30C4\u30FC\u30EB\u8A18\u9332\u304B\u3089\u6A5F\u68B0\u7684\u306B\u62BD\u51FA\uFF09",
+  workingStateFiles: "\u66F8\u304D\u8FBC\u307F/\u7DE8\u96C6\u3057\u305F\u30D5\u30A1\u30A4\u30EB\uFF08\u65B0\u3057\u3044\u9806\uFF09\uFF1A",
+  workingStateCommands: "\u6700\u8FD1\u306E\u30B7\u30A7\u30EB\u30B3\u30DE\u30F3\u30C9\uFF1A",
+  workingStateTools: (list) => `\u5727\u7E2E\u533A\u9593\u5185\u3067\u4F7F\u7528\u3057\u305F\u30C4\u30FC\u30EB\uFF1A${list}`,
   genCommitMessageInstructions: `\u3042\u306A\u305F\u306F Git \u30B3\u30DF\u30C3\u30C8\u30E1\u30C3\u30BB\u30FC\u30B8\u751F\u6210\u30A2\u30B7\u30B9\u30BF\u30F3\u30C8\u3067\u3059\u3002\u4E0E\u3048\u3089\u308C\u305F\u30B3\u30FC\u30C9\u5DEE\u5206\u304B\u3089\u3001\u6B63\u78BA\u3067\u7C21\u6F54\u306A\u30B3\u30DF\u30C3\u30C8\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u751F\u6210\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
 \u8981\u4EF6\uFF1A
@@ -934,8 +970,17 @@ shell \uBA85\uB839\uC5D0 \uC5EC\uB7EC \uC904 \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uC7
 - \uD30C\uC77C \uB0B4\uC6A9 \uC804\uCCB4\uB97C \uC9C4\uC2E4\uB85C \uCDE8\uAE09\uD558\uC9C0 \uB9C8\uC138\uC694. \uC5B4\uB5A4 \uD30C\uC77C\uC774 \uC77D\uD788\uAC70\uB098 \uD3B8\uC9D1\uB418\uC5C8\uB2E4\uB294 \uC0AC\uC2E4\uB9CC \uAE30\uB85D\uD569\uB2C8\uB2E4. \uD611\uC5C5\uC790\uB294 \uB0B4\uC6A9\uC774 \uB2E4\uC2DC \uD544\uC694\uD558\uBA74 \uB2E4\uC2DC \uC77D\uC2B5\uB2C8\uB2E4. \uC624\uB798\uB41C \uD30C\uC77C \uAE30\uC5B5\uC740 \uAE30\uC5B5\uC774 \uC5C6\uB294 \uAC83\uBCF4\uB2E4 \uB098\uC069\uB2C8\uB2E4.
 - \uC774\uC804 \uC694\uC57D\uC774 \uC81C\uACF5\uB418\uC5C8\uB2E4\uBA74: \uC5EC\uC804\uD788 \uC720\uD6A8\uD55C \uACB0\uB860\uB9CC \uD574\uB2F9 \uC139\uC158\uC5D0 \uBCD1\uD569\uD558\uACE0, \uC804\uCCB4\uB97C \uB2E4\uC2DC \uC4F0\uAC70\uB098 \uD56D\uBAA9\uBCC4\uB85C \uC62E\uACA8 \uC801\uC9C0 \uB9C8\uC138\uC694.
 - \uAD6C\uCCB4\uC801\uC73C\uB85C: \uACBD\uB85C, \uC774\uB984, \uBA85\uB839, id\uB97C \uC4F8 \uAC83. \uBAA8\uD638\uD55C \uCC38\uC870\uB294 \uAE08\uC9C0.
+- \uC694\uC57D\uC740 \uD55C\uAD6D\uC5B4\uB85C \uC791\uC131\uD558\uC138\uC694. \uC694\uC57D\uC740 \uC774\uD6C4 \uB9E4 \uD134\uB9C8\uB2E4 \uCEE8\uD14D\uC2A4\uD2B8\uC640 \uD568\uAED8 \uB2E4\uC2DC \uC804\uC1A1\uB418\uBBC0\uB85C, \uC5B8\uC5B4\uAC00 \uC5B4\uAE0B\uB098\uBA74 \uD611\uC5C5\uC790\uAC00 \uB2E4\uB978 \uC5B8\uC5B4\uB85C \uB2F5\uD558\uAC8C \uB429\uB2C8\uB2E4.
 - \uC694\uC57D \uC139\uC158\uB9CC \uCD9C\uB825\uD558\uACE0 \uC11C\uB450\uB97C \uBD99\uC774\uC9C0 \uB9C8\uC138\uC694.`,
   continuationContract: "\uC911\uB2E8\uD55C \uC9C0\uC810\uBD80\uD130 \uC774\uC5B4\uAC00\uC138\uC694: \uC124\uBA85\uD55C \uB300\uB85C \uD604\uC7AC \uC791\uC5C5\uACFC \uB2E4\uC74C \uB2E8\uACC4\uB97C \uADF8\uB300\uB85C \uC774\uC5B4\uBC1B\uC2B5\uB2C8\uB2E4. \uC774\uBBF8 \uB2F5\uD55C \uC9C8\uBB38\uC744 \uB2E4\uC2DC \uBB3B\uC9C0 \uB9D0\uACE0, \uB418\uB3CC\uC544\uBCF4\uC9C0 \uB9D0\uACE0, \uCEE8\uD14D\uC2A4\uD2B8\uAC00 \uC555\uCD95\uB418\uC5C8\uB2E4\uB294 \uC0AC\uC2E4\uB3C4 \uC5B8\uAE09\uD558\uC9C0 \uB9C8\uC138\uC694. \uC704\uC5D0\uC11C \uC5B8\uAE09\uD55C \uD30C\uC77C\uC758 \uB0B4\uC6A9\uC774 \uD544\uC694\uD558\uBA74 \uB2E4\uC2DC \uC77D\uC73C\uC138\uC694.",
+  compactedIntro: "\uC774 \uC138\uC158\uC758 \uC774\uC804 \uD134\uC740 \uC555\uCD95\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uC544\uB798 \uC694\uC57D\uC774 \uADF8 \uD134\uB4E4\uC5D0 \uB300\uD55C \uB2F9\uC2E0\uC758 \uAE30\uC5B5\uC785\uB2C8\uB2E4.",
+  compactedUserMessagesHeader: "## \uC555\uCD95 \uAD6C\uAC04\uC758 \uC0AC\uC6A9\uC790 \uBA54\uC2DC\uC9C0 (\uC6D0\uBB38, \uC2DC\uAC04 \uC21C)",
+  compactedOmittedNote: (n) => `(\uC774\uC804 \uC0AC\uC6A9\uC790 \uBA54\uC2DC\uC9C0 ${n}\uAC1C\uB294 \uC0DD\uB7B5\uB428 \u2014 \uADF8 \uC758\uB3C4\uB294 \uC704 \uC694\uC57D\uC5D0 \uD3EC\uD568\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4)`,
+  compactedTrimmedNote: "(\uC774\uC804 \uD134\uC740 \uCEE8\uD14D\uC2A4\uD2B8 \uC708\uB3C4 \uC81C\uD55C\uC73C\uB85C \uC798\uB838\uC73C\uBA70 \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uC694\uC57D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uC774\uC804 \uACB0\uACFC\uAC00 \uD544\uC694\uD558\uBA74 \uD30C\uC77C\uC744 \uB2E4\uC2DC \uC77D\uAC70\uB098 \uBA85\uB839\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.)",
+  workingStateHeader: "## \uC791\uC5C5 \uC0C1\uD0DC (\uB3C4\uAD6C \uAE30\uB85D\uC5D0\uC11C \uAE30\uACC4\uC801\uC73C\uB85C \uCD94\uCD9C)",
+  workingStateFiles: "\uC791\uC131/\uC218\uC815\uD55C \uD30C\uC77C (\uCD5C\uADFC \uC21C):",
+  workingStateCommands: "\uCD5C\uADFC \uC178 \uBA85\uB839:",
+  workingStateTools: (list) => `\uC555\uCD95 \uAD6C\uAC04\uC5D0\uC11C \uC0AC\uC6A9\uD55C \uB3C4\uAD6C: ${list}`,
   genCommitMessageInstructions: `\uB2F9\uC2E0\uC740 Git \uCEE4\uBC0B \uBA54\uC2DC\uC9C0 \uC0DD\uC131 \uC5B4\uC2DC\uC2A4\uD134\uD2B8\uC785\uB2C8\uB2E4. \uC8FC\uC5B4\uC9C4 \uCF54\uB4DC \uCC28\uC774\uB85C \uC815\uD655\uD558\uACE0 \uAC04\uACB0\uD55C \uCEE4\uBC0B \uBA54\uC2DC\uC9C0\uB97C \uC0DD\uC131\uD558\uC138\uC694.
 
 \uC694\uAD6C \uC0AC\uD56D:
@@ -1089,8 +1134,17 @@ Reglas:
 - No trates el contenido completo de un archivo como verdad. Registra solo el hecho de que un archivo se ley\xF3 o edit\xF3; el colaborador volver\xE1 a leerlo si necesita el contenido. Una memoria obsoleta de un archivo es peor que no tener memoria.
 - Si se proporciona un resumen anterior: integra solo sus conclusiones a\xFAn v\xE1lidas en las secciones correspondientes; no lo repitas entero ni lo copies entrada por entrada.
 - S\xE9 concreto: rutas, nombres, comandos, ids, no referencias vagas.
+- Escribe el resumen en espa\xF1ol. Se reenv\xEDa con el contexto en cada turno posterior; una diferencia de idioma hace que el colaborador responda en otro idioma.
 - Devuelve solo las secciones del resumen, sin pre\xE1mbulo.`,
   continuationContract: "Contin\xFAa donde lo dejaste: retoma el trabajo actual y el siguiente paso exactamente como se describe. No vuelvas a preguntar lo que ya se respondi\xF3, no recapitules y no menciones que el contexto se ha compactado. Si necesitas el contenido de alg\xFAn archivo mencionado arriba, vuelve a leerlo.",
+  compactedIntro: "Los turnos anteriores de esta sesi\xF3n se compactaron. El resumen de abajo es tu memoria de ellos.",
+  compactedUserMessagesHeader: "## Mensajes del usuario en el tramo compactado (textual, cronol\xF3gico)",
+  compactedOmittedNote: (n) => `(${n} mensajes anteriores del usuario omitidos \u2014 su intenci\xF3n est\xE1 cubierta por el resumen de arriba)`,
+  compactedTrimmedNote: "(Los turnos anteriores se recortaron para ajustarse a la ventana de contexto; no hay resumen disponible. Vuelve a leer archivos y reejecuta comandos si necesitas resultados previos.)",
+  workingStateHeader: "## Estado de trabajo (extra\xEDdo mec\xE1nicamente de los registros de herramientas)",
+  workingStateFiles: "Archivos escritos/editados (m\xE1s recientes primero):",
+  workingStateCommands: "Comandos de shell recientes:",
+  workingStateTools: (list) => `Herramientas usadas en el tramo resumido: ${list}`,
   genCommitMessageInstructions: `Eres un asistente de mensajes de commit de Git. Dado un diff de c\xF3digo, produce un mensaje de commit preciso y conciso.
 
 Requisitos:
@@ -1347,7 +1401,7 @@ function pickBoundary(messages, keepTokens) {
   return boundary;
 }
 var WRITE_HINTS = ["write", "edit", "append", "save", "create", "patch"];
-function extractWorkingState(span) {
+function extractWorkingState(span, lang) {
   const files = [];
   const commands = [];
   const tools = /* @__PURE__ */ new Set();
@@ -1390,23 +1444,20 @@ function extractWorkingState(span) {
     }
     return seen;
   };
-  const lines = [
-    "## Working state (extracted mechanically from tool records)"
-  ];
+  const p = getPrompts(lang);
+  const lines = [p.workingStateHeader];
   const written = dedupe(files, 20);
   if (written.length) {
-    lines.push("Files written/edited (most recent first):");
+    lines.push(p.workingStateFiles);
     lines.push(...written.map((f) => `- ${f}`));
   }
   const recentCmds = commands.slice(-10);
   if (recentCmds.length) {
-    lines.push("Recent shell commands:");
+    lines.push(p.workingStateCommands);
     lines.push(...recentCmds.map((c) => `- ${c}`));
   }
   if (tools.size) {
-    lines.push(
-      "Tools used in the summarized span: " + [...tools].sort().join(", ")
-    );
+    lines.push(p.workingStateTools([...tools].sort().join(", ")));
   }
   return lines.length > 1 ? lines.join("\n") : "";
 }
@@ -1530,7 +1581,7 @@ async function buildState(messages, provider, model, keepTokens, prior = null, o
   return {
     boundaryIndex: boundary,
     summaryText: summary,
-    workingState: extractWorkingState(span),
+    workingState: extractWorkingState(span, lang),
     userMessages: cappedUsers,
     userMessagesDropped: dropped,
     createdAt: Date.now(),
@@ -1538,7 +1589,7 @@ async function buildState(messages, provider, model, keepTokens, prior = null, o
     trimmed: false
   };
 }
-function trimState(messages, prior = null, fraction = TRIM_FRACTION) {
+function trimState(messages, prior = null, fraction = TRIM_FRACTION, lang) {
   const start = prior?.boundaryIndex ?? 0;
   const remaining = messages.length - start;
   if (remaining <= 2) return null;
@@ -1556,7 +1607,7 @@ function trimState(messages, prior = null, fraction = TRIM_FRACTION) {
   const span = messages.slice(start, boundary);
   const priorUsers = prior?.userMessages ? [...prior.userMessages] : [];
   const priorSummary = prior?.summaryText ?? "";
-  const summary = (priorSummary ? priorSummary + "\n\n" : "") + "(Older turns were trimmed to fit the context window; no summary is available for them. Re-read files and re-run commands if earlier results are needed.)";
+  const summary = (priorSummary ? priorSummary + "\n\n" : "") + getPrompts(lang).compactedTrimmedNote;
   const allUsers = [...priorUsers, ...extractUserMessages(span)];
   const { messages: cappedUsers, dropped } = capUserMessages(
     allUsers,
@@ -1565,7 +1616,7 @@ function trimState(messages, prior = null, fraction = TRIM_FRACTION) {
   return {
     boundaryIndex: boundary,
     summaryText: summary,
-    workingState: extractWorkingState(span),
+    workingState: extractWorkingState(span, lang),
     userMessages: cappedUsers,
     userMessagesDropped: dropped,
     createdAt: Date.now(),
@@ -1576,7 +1627,7 @@ function trimState(messages, prior = null, fraction = TRIM_FRACTION) {
 function compactedBlock(state, lang) {
   const parts = [
     "<compacted-history>",
-    "Earlier turns of this session were compacted. The summary below is your memory of them.",
+    getPrompts(lang).compactedIntro,
     "",
     state.summaryText
   ];
@@ -1586,12 +1637,10 @@ function compactedBlock(state, lang) {
   if (state.userMessages.length > 0) {
     parts.push(
       "",
-      "## User messages in the compacted span (verbatim, chronological)"
+      getPrompts(lang).compactedUserMessagesHeader
     );
     if (state.userMessagesDropped > 0) {
-      parts.push(
-        `(${state.userMessagesDropped} earlier user messages omitted \u2014 their intent is covered by the summary above)`
-      );
+      parts.push(getPrompts(lang).compactedOmittedNote(state.userMessagesDropped));
     }
     parts.push(...state.userMessages.map((u) => `- ${u}`));
   }
@@ -1693,12 +1742,12 @@ var MUTATING_TOOLS = /* @__PURE__ */ new Set([
 ]);
 function parseReadFileSpan(content) {
   const body = content.replace(/^\[tool output truncated:[^\n]*\]\n\n/, "");
-  let path12;
+  let path13;
   let start;
   let end;
   try {
     const obj = JSON.parse(body);
-    path12 = obj.path;
+    path13 = obj.path;
     start = obj.start_line;
     end = obj.end_line;
   } catch {
@@ -1707,14 +1756,14 @@ function parseReadFileSpan(content) {
       const m = new RegExp(`"${key}"\\s*:\\s*(\\d+)`).exec(body);
       return m ? Number(m[1]) : void 0;
     };
-    path12 = str("path");
+    path13 = str("path");
     start = num("start_line");
     end = num("end_line");
   }
-  if (typeof path12 !== "string" || !path12) return null;
+  if (typeof path13 !== "string" || !path13) return null;
   if (typeof start !== "number" || typeof end !== "number") return null;
   if (!Number.isFinite(start) || !Number.isFinite(end)) return null;
-  return { path: path12, start, end };
+  return { path: path13, start, end };
 }
 function addSpan(spans, start, end) {
   spans.push([start, end]);
@@ -1771,16 +1820,45 @@ function applyReadFileDedup(messages) {
 }
 var OVERFLOW_MARKERS = [
   "context_length_exceeded",
-  "maximum context length",
+  "context length",
   "context window",
   "prompt is too long",
   "input is too long",
   "too many tokens",
   "input length and `max_tokens` exceed",
-  "exceeds the maximum number of tokens"
+  "exceeds the maximum number of tokens",
+  "\u8D85\u51FA\u6A21\u578B\u4E0A\u4E0B\u6587",
+  "\u8D85\u8FC7\u6A21\u578B\u4E0A\u4E0B\u6587",
+  "\u8D85\u904E\u6A21\u578B\u4E0A\u4E0B\u6587",
+  "\u4E0A\u4E0B\u6587\u957F\u5EA6\u8D85\u8FC7",
+  "\u8D85\u8FC7\u6700\u5927\u4E0A\u4E0B\u6587",
+  "\u8D85\u904E\u6700\u5927\u4E0A\u4E0B\u6587",
+  "\u4E0A\u4E0B\u6587\u8D85\u9650",
+  "\u8F93\u5165\u8FC7\u957F"
 ];
+function overflowText(exc) {
+  const parts = [];
+  const push = (v) => {
+    if (typeof v === "string" && v) parts.push(v);
+  };
+  push(String(exc));
+  if (exc && typeof exc === "object") {
+    const rec = exc;
+    push(rec["message"]);
+    push(rec["detail"]);
+    const body = rec["error"];
+    if (body && typeof body === "object") {
+      const b = body;
+      push(b["message"]);
+      push(b["code"]);
+    } else {
+      push(body);
+    }
+  }
+  return parts.join(" ").toLowerCase();
+}
 function isContextOverflow(exc) {
-  const text = String(exc).toLowerCase();
+  const text = overflowText(exc);
   return OVERFLOW_MARKERS.some((m) => text.includes(m));
 }
 
@@ -1813,6 +1891,9 @@ var TOOL_MAX_CHARS = {
   web_search: 8e3,
   list_files: 8e3,
   shell_task_output: 8e3,
+  /* repo_map 自带 16K 上限（tools/repoMap.ts 的 MAX_CHARS）。这里显式登记，
+   * 而不是落到 24K 默认值 —— 免得将来工具上限调大时被二次裁剪，口径也保持一致。 */
+  repo_map: 16e3,
   git_log: 6e3,
   git_status: 4e3
 };
@@ -2122,6 +2203,7 @@ var INTERACTIVE_TOOLS = /* @__PURE__ */ new Set([
 var MAX_COMPACT_ROUNDS = 4;
 var OVERFLOW_TARGET_RATIO = 0.5;
 var OVERFLOW_TRIM_FRACTION = 0.5;
+var OVERFLOW_ELIDE_KEEP_FRACTION = 0.02;
 var COMPACT_STALL_RETRY_DELTA = 20;
 var FINALIZE_ON_LIMIT_PROMPT = "\u5DF2\u8FBE\u5230\u672C\u8F6E\u8FED\u4EE3\u4E0A\u9650\uFF0C\u4F60\u4E0D\u80FD\u518D\u8C03\u7528\u4EFB\u4F55\u5DE5\u5177\u3002\u8BF7\u7ACB\u5373\u57FA\u4E8E\u4E0A\u9762\u5DF2\u7ECF\u6536\u96C6\u5230\u7684\u4FE1\u606F\u8F93\u51FA\u6700\u7EC8\u62A5\u544A\uFF1A\u76F4\u63A5\u56DE\u7B54\u4EFB\u52A1\u3001\u7ED9\u51FA\u7ED3\u8BBA\u4E0E path:line \u5F15\u7528\uFF0C\u5E76\u660E\u786E\u8BF4\u660E\u54EA\u4E9B\u90E8\u5206\u5C1A\u672A\u67E5\u8BC1\u3002\u4E0D\u8981\u8BE2\u95EE\u3001\u4E0D\u8981\u7EE7\u7EED\u63A2\u7D22\u3002";
 function toolResultMessage(tc, result, taskId, toolResultDir2) {
@@ -2250,6 +2332,8 @@ var TurnEngine = class _TurnEngine {
   _lastContextTokens = null;
   /** 压缩无进展时的消息条数快照；-1 表示无冷却 */
   _compactStalledAt = -1;
+  /** 溢出兜底：已 400 时无条件淘汰旧工具结果（下一次成功调用后复位） */
+  _overflowElide = false;
   /** 显式配置的上下文窗口大小（token 数），未设置时为 undefined（走自动检测） */
   _contextWindow;
   /** 压缩触发阈值比例（默认 0.8） */
@@ -2388,11 +2472,12 @@ ${notice}` : text,
     };
   }
   /** 排队 steering 消息（下一迭代间隙注入为 user 消息） */
-  queueSteering(text, attachments, attachmentRefs) {
+  queueSteering(text, attachments, attachmentRefs, actor) {
     this._steering.push({
       text,
       ...attachments?.length ? { attachments } : {},
-      ...attachmentRefs?.length ? { attachmentRefs } : {}
+      ...attachmentRefs?.length ? { attachmentRefs } : {},
+      ...actor ? { actor } : {}
     });
   }
   /**
@@ -2417,7 +2502,7 @@ ${notice}` : text,
    * 追加用户输入到历史，产出 TURN_START 事件，然后转发 _loop()
    * 的全部事件。收到中断后仍会消费完剩余事件（保证 TURN_END 产出）。
    */
-  async *run(userInput, taskId, attachments, attachmentRefs) {
+  async *run(userInput, taskId, attachments, attachmentRefs, actor) {
     if (!this.model.trim()) {
       throw new Error(
         "\u672A\u6307\u5B9A\u6A21\u578B\uFF1A\u8BF7\u5148\u9009\u62E9\u6A21\u578B\uFF08CLI \u8FD0\u884C /connect\uFF1B\u63A7\u5236\u53F0\u5728\u300C\u8BBE\u7F6E \u2192 AI \u6A21\u578B\u300D\u4E2D\u6DFB\u52A0\u4F9B\u5E94\u5546\u5E76\u9009\u62E9\u6A21\u578B\uFF09"
@@ -2440,12 +2525,15 @@ ${notice}` : text,
     this._cancel = false;
     this._producedFiles = [];
     this._compactStalledAt = -1;
+    this._overflowElide = false;
     this._emitHook((h) => h.onTurnStart?.(userInput));
     yield {
       type: "turn_start" /* TURN_START */,
       data: {
         taskId: this.taskId,
         input: userInput,
+        // 谁发起的本轮：会话详情据此标注（本地/旧网关没有该字段）
+        ...actor ? { actor } : {},
         // 只报个数：附件字节不进事件流（事件会落盘，base64 会把日志撑爆）
         ...attachments?.length ? { attachmentCount: attachments.length } : {},
         // 落盘引用足够小，随事件带给控制台渲染缩略图 / 详情回看
@@ -2749,6 +2837,12 @@ ${notice}` : text,
             type: "compacting" /* COMPACTING */,
             data: { taskId: this.taskId, ...startInfo }
           };
+          let elided = false;
+          if (this._elisionEnabled) {
+            const before = this._estimateContextTokens();
+            this._overflowElide = true;
+            elided = this._estimateContextTokens() < before;
+          }
           const result = await this._compactNow(overflowReqId, true);
           if (result.notice) {
             const notice = result.notice;
@@ -2787,6 +2881,11 @@ ${notice}` : text,
             }
             continue;
           }
+          if (elided) {
+            this._appendNotice("compacted", "\u4E0A\u4E0B\u6587\u6EA2\u51FA \u2014 \u5DF2\u6DD8\u6C70\u65E7\u5DE5\u5177\u7ED3\u679C\u540E\u91CD\u8BD5");
+            continue;
+          }
+          this._overflowElide = false;
         }
         if (!this._cancel && !streamed && isTransientNetworkError(exc) && netRetries < netMax) {
           netRetries++;
@@ -2857,6 +2956,7 @@ ${notice}` : text,
         return;
       }
       netRetries = 0;
+      this._overflowElide = false;
       if (this._cancel && turn === null) {
         yield* this._finishInterrupted({
           iterations,
@@ -2915,6 +3015,7 @@ ${notice}` : text,
               data: {
                 text: s.text,
                 taskId: this.taskId,
+                ...s.actor ? { actor: s.actor } : {},
                 ...s.attachmentRefs?.length ? { attachments: s.attachmentRefs } : {}
               }
             };
@@ -2979,6 +3080,7 @@ ${notice}` : text,
             data: {
               text: s.text,
               taskId: this.taskId,
+              ...s.actor ? { actor: s.actor } : {},
               ...s.attachmentRefs?.length ? { attachments: s.attachmentRefs } : {}
             }
           };
@@ -3403,13 +3505,14 @@ ${notice}` : text,
     const deduped = this._dedupEnabled ? applyReadFileDedup(base).messages : base;
     let view = this._finalizeOutbound(deduped);
     if (!this._elisionEnabled) return view;
-    if (estimateTokens(view) < this._softTriggerTokens()) {
+    const soft = this._softTriggerTokens();
+    if (!this._overflowElide && estimateTokens(view) < soft) {
       return view;
     }
     const oneShot = applyOneShotElision(deduped);
     if (oneShot.freedChars > 0) {
       view = this._finalizeOutbound(oneShot.messages);
-      if (estimateTokens(view) < this._softTriggerTokens()) {
+      if (!this._overflowElide && estimateTokens(view) < soft) {
         return view;
       }
     }
@@ -3418,7 +3521,8 @@ ${notice}` : text,
         this._getContextWindow(),
         this._thresholdPct,
         this._capTokens
-      )
+      ),
+      this._overflowElide ? OVERFLOW_ELIDE_KEEP_FRACTION : ELIDE_KEEP_FRACTION
     );
     const elided = applyToolResultElision(
       oneShot.messages,
@@ -3617,7 +3721,8 @@ ${notice}` : text,
         const trimmed = trimState(
           this.messages,
           this.compactionState,
-          force ? OVERFLOW_TRIM_FRACTION : 0.25
+          force ? OVERFLOW_TRIM_FRACTION : 0.25,
+          this.lang
         );
         if (!trimmed) break;
         this.compactionState = trimmed;
@@ -3662,9 +3767,9 @@ ${notice}` : text,
       return;
     }
     if (result && typeof result === "object") {
-      const path12 = result.path;
-      if (path12) {
-        this._producedFiles.push(path12);
+      const path13 = result.path;
+      if (path13) {
+        this._producedFiles.push(path13);
         return;
       }
       const changed = result.changed_files;
@@ -4203,62 +4308,196 @@ var PermissionEngine = class {
 };
 
 // src/tools/files.ts
+import * as fs6 from "fs";
+import * as path8 from "path";
+import { createHash } from "crypto";
+import { StringDecoder } from "string_decoder";
+
+// src/tools/ignore.ts
 import * as fs5 from "fs";
 import * as path7 from "path";
+var ALWAYS_SKIP_DIRS = /* @__PURE__ */ new Set([
+  // JS / TS
+  "node_modules",
+  "dist",
+  "build",
+  "out",
+  ".next",
+  ".nuxt",
+  ".cache",
+  // JVM
+  "target",
+  ".gradle",
+  ".mvn",
+  // .NET
+  "bin",
+  "obj",
+  ".vs",
+  "TestResults",
+  // Python / Ruby / PHP
+  "__pycache__",
+  ".venv",
+  "venv",
+  ".pytest_cache",
+  ".mypy_cache",
+  "vendor",
+  // 移动端
+  "Pods",
+  ".dart_tool",
+  "DerivedData",
+  // 覆盖率 / 通用
+  "coverage",
+  // 版本库
+  ".git",
+  ".svn",
+  ".hg"
+]);
+function loadGitignore(dir) {
+  const file = path7.join(dir, ".gitignore");
+  let text;
+  try {
+    const stat = fs5.statSync(file);
+    if (stat.size > 64 * 1024) return [];
+    text = fs5.readFileSync(file, "utf-8");
+  } catch {
+    return [];
+  }
+  const matchers = [];
+  for (const rawLine of text.split("\n")) {
+    let line = rawLine.replace(/\r$/, "").trim();
+    if (!line || line.startsWith("#")) continue;
+    if (line.startsWith("!")) continue;
+    const anchored = rawLine.trim().startsWith("/");
+    const dirOnly = /\/\s*$/.test(rawLine.trim());
+    line = line.replace(/^\/+/, "").replace(/\/+$/, "");
+    if (!line) continue;
+    const pattern = line.split("").map((ch) => {
+      if (ch === "*") return ".*";
+      if (ch === "?") return ".";
+      return ch.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    }).join("");
+    const re = new RegExp(line.includes("/") || anchored ? `^${pattern}$` : `(^|/)${pattern}$`);
+    matchers.push((rel, isDir) => {
+      if (dirOnly && !isDir) return false;
+      return re.test(rel);
+    });
+  }
+  return matchers;
+}
+function makeIgnoreFilter(root) {
+  const matchers = loadGitignore(root);
+  return (rel, isDir) => {
+    const name = rel.slice(rel.lastIndexOf("/") + 1);
+    if (name.startsWith(".")) return true;
+    if (isDir && ALWAYS_SKIP_DIRS.has(name)) return true;
+    return matchers.some((m) => m(rel, isDir));
+  };
+}
+
+// src/tools/files.ts
 var DEFAULT_MAX_LINES = 2e3;
 var MULTI_READ_MAX_TOTAL_LINES = 1500;
 var MAX_LINE_CHARS = 500;
+var READ_CHUNK_BYTES = 64 * 1024;
+var RESULT_META_RESERVE = 800;
 function makeReadFile(workspace, guard) {
-  const root = path7.resolve(workspace);
-  function readOne(filePath, startLine, maxLines) {
+  const root = path8.resolve(workspace);
+  function readWindow(target, startLine, maxLines, charBudget, onDigest) {
+    const fd = fs6.openSync(target, "r");
+    try {
+      const decoder = new StringDecoder("utf-8");
+      const hash = createHash("sha256");
+      const buf = Buffer.allocUnsafe(READ_CHUNK_BYTES);
+      const lines = [];
+      let lineNo = 0;
+      let pending = "";
+      let chars = 0;
+      let capped = false;
+      let pos = 0;
+      const takeLine = (text) => {
+        lineNo += 1;
+        if (capped || lineNo < startLine || lines.length >= maxLines) return;
+        const clipped = text.length > MAX_LINE_CHARS ? text.slice(0, MAX_LINE_CHARS) + "\u2026 (line truncated)" : text;
+        const rendered = `${lineNo}|${clipped}`;
+        if (chars + rendered.length + 1 > charBudget) {
+          capped = true;
+          return;
+        }
+        chars += rendered.length + 1;
+        lines.push(rendered);
+      };
+      for (; ; ) {
+        const n = fs6.readSync(fd, buf, 0, READ_CHUNK_BYTES, pos);
+        if (n <= 0) break;
+        pos += n;
+        const decoded = decoder.write(buf.subarray(0, n));
+        hash.update(decoded, "utf8");
+        const text = pending + decoded;
+        let from = 0;
+        for (; ; ) {
+          const idx = text.indexOf("\n", from);
+          if (idx < 0) break;
+          takeLine(text.slice(from, idx).replace(/\r$/, ""));
+          from = idx + 1;
+        }
+        pending = text.slice(from);
+      }
+      const rest = decoder.end();
+      if (rest) hash.update(rest, "utf8");
+      const tail = pending + rest;
+      if (tail.length > 0) takeLine(tail.replace(/\r$/, ""));
+      onDigest(hash.digest("hex").slice(0, 16));
+      return { lines, totalLines: lineNo, capped };
+    } finally {
+      fs6.closeSync(fd);
+    }
+  }
+  function readOne(filePath, startLine, maxLines, charBudget) {
     const resolved = resolveWithinRoot(root, filePath);
     if (!resolved) {
       return { path: filePath, error: "\u8DEF\u5F84\u5728\u5DE5\u4F5C\u533A\u4E4B\u5916" };
     }
     const target = resolved.real;
-    if (!fs5.existsSync(target) || !fs5.statSync(target).isFile()) {
+    if (!fs6.existsSync(target) || !fs6.statSync(target).isFile()) {
       return { path: filePath, error: `\u4E0D\u662F\u6587\u4EF6: ${filePath}` };
     }
-    const selected = [];
-    let total = 0;
+    let read;
     try {
-      const content = fs5.readFileSync(target, "utf-8");
-      guard?.noteRead(target, content);
-      const lines = content.split("\n");
-      total = lines.length;
-      for (let i = startLine - 1; i < Math.min(startLine - 1 + maxLines, lines.length); i++) {
-        let text = lines[i];
-        if (text.length > MAX_LINE_CHARS) {
-          text = text.slice(0, MAX_LINE_CHARS) + "\u2026 (line truncated)";
-        }
-        selected.push(`${i + 1}|${text}`);
-      }
+      read = readWindow(target, startLine, maxLines, charBudget, (digest) => {
+        guard?.noteReadDigest(target, digest);
+      });
     } catch (exc) {
       return { path: filePath, error: `\u8BFB\u53D6\u5931\u8D25: ${String(exc)}` };
     }
+    const { lines: selected, totalLines: total, capped } = read;
     const end = startLine + selected.length - 1;
     const result = {
-      path: path7.relative(resolved.root, target),
+      path: path8.relative(resolved.root, target),
       start_line: startLine,
       end_line: end,
       total_lines: total,
       content: selected.join("\n")
     };
-    if (end < total) {
+    if (capped) {
+      result.note = `\u5DF2\u8FD4\u56DE\u7B2C ${startLine}-${end} \u884C\uFF08\u672C\u6B21\u5DF2\u8FBE\u5355\u6B21\u8BFB\u53D6\u4E0A\u9650\u7EA6 ${charBudget} \u5B57\u7B26\uFF0C\u5171 ${total} \u884C\uFF09\uFF1B\u8C03\u7528 read_file(start_line=${end + 1}) \u7EE7\u7EED\u9605\u8BFB`;
+    } else if (end < total) {
       result.note = `\u663E\u793A\u7B2C ${startLine}-${end} \u884C\uFF0C\u5171 ${total} \u884C\uFF1B\u8C03\u7528 read_file(start_line=${end + 1}) \u7EE7\u7EED\u9605\u8BFB`;
     }
     return result;
   }
   return function read_file(args) {
     const startLine = Math.max(1, Number(args.start_line ?? 1));
-    const maxLines = Math.min(Number(args.max_lines ?? DEFAULT_MAX_LINES), DEFAULT_MAX_LINES);
+    const requestedLines = Number(args.max_lines ?? DEFAULT_MAX_LINES);
+    const maxLines = Number.isFinite(requestedLines) ? Math.min(Math.max(1, Math.floor(requestedLines)), DEFAULT_MAX_LINES) : DEFAULT_MAX_LINES;
+    const fullBudget = Math.max(1e3, toolResultBudget("read_file") - RESULT_META_RESERVE);
     const paths = Array.isArray(args.paths) ? args.paths.map((p) => String(p ?? "")).filter(Boolean) : [];
     if (paths.length > 0) {
+      const perFileBudget = Math.max(1e3, Math.floor(fullBudget / paths.length));
       const files = [];
       let remainingLines = MULTI_READ_MAX_TOTAL_LINES;
       for (const filePath2 of paths) {
         const perFile = Math.min(maxLines, Math.max(1, remainingLines));
-        const one = readOne(filePath2, startLine, perFile);
+        const one = readOne(filePath2, startLine, perFile, perFileBudget);
         files.push(one);
         if (!one.error) remainingLines -= one.content.split("\n").length;
         if (remainingLines <= 0) break;
@@ -4273,31 +4512,79 @@ function makeReadFile(workspace, guard) {
     if (!filePath) {
       return { error: "\u7F3A\u5C11 path\uFF08\u6216 paths\uFF09\u53C2\u6570" };
     }
-    return readOne(filePath, startLine, maxLines);
+    return readOne(filePath, startLine, maxLines, fullBudget);
   };
 }
+var DEFAULT_LIST_DEPTH = 3;
+var MAX_LIST_DEPTH = 6;
+var DEFAULT_RECURSIVE_LIMIT = 400;
+var MAX_RECURSIVE_LIMIT = 1e3;
 function makeListFiles(workspace) {
-  const root = path7.resolve(workspace);
+  const root = path8.resolve(workspace);
   return function list_files(args) {
     const dirPath = String(args.path ?? ".");
-    const maxResults = Math.min(Number(args.max_results ?? 100), 100);
+    const recursive = args.recursive === true;
+    const requestedMax = Number(args.max_results ?? (recursive ? DEFAULT_RECURSIVE_LIMIT : 100));
+    const hardCap = recursive ? MAX_RECURSIVE_LIMIT : 100;
+    const maxResults = Number.isFinite(requestedMax) ? Math.max(1, Math.min(Math.floor(requestedMax), hardCap)) : hardCap;
+    const requestedDepth = Number(args.max_depth ?? DEFAULT_LIST_DEPTH);
+    const maxDepth = Number.isFinite(requestedDepth) ? Math.max(1, Math.min(Math.floor(requestedDepth), MAX_LIST_DEPTH)) : DEFAULT_LIST_DEPTH;
     const resolved = resolveWithinRoot(root, dirPath);
     if (!resolved) return { error: "\u8DEF\u5F84\u5728\u5DE5\u4F5C\u533A\u4E4B\u5916" };
     const target = resolved.real;
-    if (!fs5.existsSync(target) || !fs5.statSync(target).isDirectory()) {
+    if (!fs6.existsSync(target) || !fs6.statSync(target).isDirectory()) {
       return { error: `\u4E0D\u662F\u76EE\u5F55: ${dirPath}` };
     }
+    const realRoot = resolved.root;
+    const isIgnored = makeIgnoreFilter(realRoot);
     try {
-      const entries = fs5.readdirSync(target, { withFileTypes: true });
+      if (!recursive) {
+        const results2 = [];
+        for (const e of fs6.readdirSync(target, { withFileTypes: true })) {
+          if (results2.length >= maxResults) break;
+          const rel = path8.relative(realRoot, path8.join(target, e.name)).split(path8.sep).join("/");
+          if (isIgnored(rel, e.isDirectory())) continue;
+          results2.push(e.isDirectory() ? `${e.name}/` : e.name);
+        }
+        results2.sort();
+        return { path: path8.relative(realRoot, target), entries: results2.slice(0, maxResults) };
+      }
       const results = [];
-      for (const e of entries) {
-        if (results.length >= maxResults) break;
-        if (e.name.startsWith(".")) continue;
-        if (e.name === "node_modules" || e.name === "__pycache__" || e.name === "dist") continue;
-        results.push(e.isDirectory() ? `${e.name}/` : e.name);
+      let truncated = false;
+      const queue = [{ dir: target, depth: 1 }];
+      while (queue.length > 0) {
+        const { dir, depth } = queue.shift();
+        let entries;
+        try {
+          entries = fs6.readdirSync(dir, { withFileTypes: true });
+        } catch {
+          continue;
+        }
+        entries.sort((a, b) => {
+          if (a.isDirectory() !== b.isDirectory()) return a.isDirectory() ? -1 : 1;
+          return a.name.localeCompare(b.name, "zh");
+        });
+        for (const e of entries) {
+          if (results.length >= maxResults) {
+            truncated = true;
+            break;
+          }
+          const full = path8.join(dir, e.name);
+          const rel = path8.relative(realRoot, full).split(path8.sep).join("/");
+          const isDir = e.isDirectory();
+          if (isIgnored(rel, isDir)) continue;
+          results.push(isDir ? `${rel}/` : rel);
+          if (isDir && depth < maxDepth) queue.push({ dir: full, depth: depth + 1 });
+        }
+        if (truncated) break;
       }
-      results.sort();
-      return { path: path7.relative(resolved.root, target), entries: results.slice(0, maxResults) };
+      return {
+        path: path8.relative(realRoot, target),
+        entries: results,
+        ...truncated ? {
+          note: `\u5DF2\u8FBE\u5230\u6761\u76EE\u4E0A\u9650 ${maxResults}\uFF0C\u7ED3\u679C\u88AB\u622A\u65AD\uFF1B\u8BF7\u7F29\u5C0F path \u5230\u5177\u4F53\u5B50\u76EE\u5F55\uFF0C\u6216\u964D\u4F4E max_depth\uFF08\u5F53\u524D ${maxDepth}\uFF09`
+        } : {}
+      };
     } catch (exc) {
       return { error: `\u5217\u51FA\u6587\u4EF6\u5931\u8D25: ${String(exc)}` };
     }
@@ -4337,12 +4624,23 @@ function registerReadOnlyFileTools(registry, workspace, guard) {
       type: "function",
       function: {
         name: "list_files",
-        description: "\u5217\u51FA\u76EE\u5F55\u4E0B\u7684\u6587\u4EF6\u548C\u5B50\u76EE\u5F55\u3002\u8DF3\u8FC7\u9690\u85CF\u6587\u4EF6\u548C node_modules \u7B49\u76EE\u5F55\u3002",
+        description: "\u5217\u51FA\u76EE\u5F55\u4E0B\u7684\u6587\u4EF6\u548C\u5B50\u76EE\u5F55\u3002\u8DF3\u8FC7\u9690\u85CF\u9879\u3001\u5E38\u89C1\u6784\u5EFA\u4EA7\u7269\u76EE\u5F55\uFF0C\u5E76\u9075\u5B88\u5DE5\u4F5C\u533A\u6839\u76EE\u5F55\u7684 .gitignore\u3002\u4E86\u89E3\u5927\u4ED3\u5E93\u7ED3\u6784\u65F6\u7528 recursive=true \u4E00\u6B21\u62FF\u5230\u6709\u9650\u6DF1\u5EA6\uFF08\u9ED8\u8BA4 3 \u5C42\uFF09\u7684\u6811\uFF0C\u6BD4\u9010\u5C42\u8C03\u7528\u7701\u5F88\u591A\u5F80\u8FD4\uFF1B\u6761\u76EE\u8FC7\u591A\u65F6\u4F1A\u622A\u65AD\u5E76\u63D0\u793A\u3002",
         parameters: {
           type: "object",
           properties: {
             path: { type: "string", description: "\u76EE\u5F55\u8DEF\u5F84 (\u76F8\u5BF9\u4E8E\u5DE5\u4F5C\u533A\uFF0C\u9ED8\u8BA4 '.')" },
-            max_results: { type: "integer", description: "\u6700\u5927\u7ED3\u679C\u6570 (\u9ED8\u8BA4 100)" }
+            recursive: {
+              type: "boolean",
+              description: "\u9012\u5F52\u5217\u51FA\u5B50\u76EE\u5F55\uFF08\u9ED8\u8BA4 false\uFF0C\u53EA\u5217\u4E00\u5C42\uFF09"
+            },
+            max_depth: {
+              type: "integer",
+              description: `\u9012\u5F52\u6DF1\u5EA6 (\u9ED8\u8BA4 ${DEFAULT_LIST_DEPTH}\uFF0C\u4E0A\u9650 ${MAX_LIST_DEPTH}\uFF1B\u4EC5 recursive \u65F6\u751F\u6548)`
+            },
+            max_results: {
+              type: "integer",
+              description: `\u6700\u5927\u7ED3\u679C\u6570\uFF08\u975E\u9012\u5F52\u9ED8\u8BA4 100 / \u4E0A\u9650 100\uFF1B\u9012\u5F52\u9ED8\u8BA4 ${DEFAULT_RECURSIVE_LIMIT} / \u4E0A\u9650 ${MAX_RECURSIVE_LIMIT}\uFF09`
+            }
           }
         }
       }
@@ -4510,10 +4808,10 @@ function execAsync(file, argv, opts = {}) {
 }
 
 // src/tools/shellRuntime.ts
-import * as path8 from "path";
+import * as path9 from "path";
 var WINDOWS_SUFFIXES = [".exe", ".cmd", ".bat", ".com", ""];
 function pathApi(platform) {
-  return platform === "win32" ? path8.win32 : path8.posix;
+  return platform === "win32" ? path9.win32 : path9.posix;
 }
 function joinPath(platform, ...parts) {
   return pathApi(platform).join(...parts);
@@ -4726,8 +5024,8 @@ function decodeOutput(buf) {
 var shellTasks = new ShellTaskManager();
 
 // src/tools/nodeGrep.ts
-import * as fs6 from "fs";
-import * as path9 from "path";
+import * as fs7 from "fs";
+import * as path10 from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set([
   ".git",
   "node_modules",
@@ -4752,27 +5050,27 @@ function nodeGrep(opts) {
   } catch (err) {
     throw new Error(`\u65E0\u6548\u7684\u6B63\u5219\u8868\u8FBE\u5F0F: ${opts.pattern}\uFF08${String(err)}\uFF09`);
   }
-  const target = path9.resolve(opts.workspace, opts.target);
-  if (!fs6.existsSync(target)) {
+  const target = path10.resolve(opts.workspace, opts.target);
+  if (!fs7.existsSync(target)) {
     throw new Error(`\u641C\u7D22\u8DEF\u5F84\u4E0D\u5B58\u5728: ${opts.target}`);
   }
   const matches = [];
   const scanFile = (file) => {
     let stat2;
     try {
-      stat2 = fs6.statSync(file);
+      stat2 = fs7.statSync(file);
     } catch {
       return false;
     }
     if (!stat2.isFile() || stat2.size > maxFileBytes) return false;
     let buf;
     try {
-      buf = fs6.readFileSync(file);
+      buf = fs7.readFileSync(file);
     } catch {
       return false;
     }
     if (looksBinary(buf)) return false;
-    const rel = path9.relative(opts.workspace, file) || path9.basename(file);
+    const rel = path10.relative(opts.workspace, file) || path10.basename(file);
     const lines = buf.toString("utf-8").split("\n");
     for (let i = 0; i < lines.length; i++) {
       const raw = lines[i].replace(/\r$/, "");
@@ -4783,7 +5081,7 @@ function nodeGrep(opts) {
     }
     return false;
   };
-  const stat = fs6.statSync(target);
+  const stat = fs7.statSync(target);
   if (stat.isFile()) {
     scanFile(target);
     return matches;
@@ -4793,12 +5091,12 @@ function nodeGrep(opts) {
     const dir = stack.pop();
     let entries;
     try {
-      entries = fs6.readdirSync(dir, { withFileTypes: true });
+      entries = fs7.readdirSync(dir, { withFileTypes: true });
     } catch {
       continue;
     }
     for (const entry of entries) {
-      const full = path9.join(dir, entry.name);
+      const full = path10.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (!SKIP_DIRS.has(entry.name)) stack.push(full);
       } else if (entry.isFile()) {
@@ -4810,22 +5108,22 @@ function nodeGrep(opts) {
 }
 
 // src/tools/ripgrep.ts
-import * as fs7 from "fs";
+import * as fs8 from "fs";
 import * as os3 from "os";
-import * as path10 from "path";
+import * as path11 from "path";
 import { createRequire } from "module";
 var cached;
 function extractBundledRipgrep() {
   try {
-    const req = typeof __require === "function" ? __require : createRequire(path10.join(process.cwd(), "__zqagent__.js"));
+    const req = typeof __require === "function" ? __require : createRequire(path11.join(process.cwd(), "__zqagent__.js"));
     const sea = req("node:sea");
     if (!sea?.isSea?.() || typeof sea.getAsset !== "function") return null;
     const asset = sea.getAsset("rg");
     if (!asset) return null;
-    const dir = fs7.mkdtempSync(path10.join(os3.tmpdir(), "zqagent-rg-"));
-    const file = path10.join(dir, process.platform === "win32" ? "rg.exe" : "rg");
-    fs7.writeFileSync(file, Buffer.from(asset));
-    fs7.chmodSync(file, 493);
+    const dir = fs8.mkdtempSync(path11.join(os3.tmpdir(), "zqagent-rg-"));
+    const file = path11.join(dir, process.platform === "win32" ? "rg.exe" : "rg");
+    fs8.writeFileSync(file, Buffer.from(asset));
+    fs8.chmodSync(file, 493);
     return file;
   } catch {
     return null;
@@ -4834,7 +5132,7 @@ function extractBundledRipgrep() {
 function resolveRipgrep() {
   if (cached !== void 0) return cached;
   const explicit = (process.env.ZQAGENT_RG ?? "").trim();
-  if (explicit && fs7.existsSync(explicit)) {
+  if (explicit && fs8.existsSync(explicit)) {
     cached = explicit;
     return cached;
   }
@@ -4848,7 +5146,7 @@ function resolveRipgrep() {
     env: process.env,
     fileExists: (p) => {
       try {
-        return fs7.statSync(p).isFile();
+        return fs8.statSync(p).isFile();
       } catch {
         return false;
       }
@@ -4858,12 +5156,61 @@ function resolveRipgrep() {
 }
 
 // src/tools/search.ts
-function parseRgOutput(result) {
-  return result.split("\n").map((l) => l.replace(/\r$/, "")).filter((l) => l.length > 0).slice(0, 50).map((line) => {
-    const m = /^(.+?):(\d+):(.*)$/.exec(line);
-    if (!m) return { file: line.trim(), line: 0, text: "" };
-    return { file: m[1], line: Number(m[2]), text: m[3].trim().slice(0, 200) };
-  });
+var DEFAULT_MAX_RESULTS = 50;
+var MAX_RESULTS_CAP = 200;
+var MAX_TEXT_CHARS = 200;
+var RG_TIMEOUT_MS = 1e4;
+function parseRgOutput(result, limit) {
+  const out = [];
+  for (const raw of result.split("\n")) {
+    if (out.length >= limit) break;
+    const line = raw.replace(/\r$/, "");
+    if (!line) continue;
+    const m = /^(.+?)[:-](\d+)[:-](.*)$/.exec(line);
+    if (!m) continue;
+    out.push({
+      file: m[1],
+      line: Number(m[2]),
+      text: m[3].trim().slice(0, MAX_TEXT_CHARS)
+    });
+  }
+  return out;
+}
+function parseRgFiles(result, limit) {
+  const files = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of result.split("\n")) {
+    if (files.length >= limit) break;
+    const f = raw.replace(/\r$/, "").trim();
+    if (!f || seen.has(f)) continue;
+    seen.add(f);
+    files.push(f);
+  }
+  return files;
+}
+function rgArgs(opts) {
+  const args = [];
+  if (opts.filesOnly) {
+    args.push("--files-with-matches");
+  } else {
+    args.push("--with-filename", "--line-number", "--no-heading");
+    args.push("--max-count", String(Math.max(opts.maxResults, 1)));
+  }
+  if (opts.ignoreCase) args.push("--ignore-case");
+  if (opts.glob) args.push("--glob", opts.glob);
+  if (opts.contextLines > 0 && !opts.filesOnly) {
+    args.push("--context", String(opts.contextLines));
+  }
+  args.push("--", opts.pattern, opts.path);
+  return args;
+}
+function rgFailureHint(res) {
+  if (res.timedOut) {
+    return `\u641C\u7D22\u8D85\u65F6\uFF08${RG_TIMEOUT_MS / 1e3}s\uFF09\u3002\u5927\u4ED3\u5E93\u5168\u91CF\u641C\u7D22\u5F88\u5BB9\u6613\u8D85\u65F6\uFF1A\u8BF7\u7F29\u5C0F path \u5230\u5177\u4F53\u5B50\u76EE\u5F55\uFF0C\u6216\u7528 glob \u53C2\u6570\u9650\u5236\u6587\u4EF6\u7C7B\u578B\uFF08\u5982 "*.ts"\uFF09\u540E\u91CD\u8BD5`;
+  }
+  if (res.aborted) return "\u641C\u7D22\u5DF2\u4E2D\u65AD";
+  const stderr = decodeOutput(res.stderr).trim().slice(0, 300);
+  return `\u641C\u7D22\u5931\u8D25\uFF08rg \u9000\u51FA\u7801 ${String(res.status)}\uFF09${stderr ? `\uFF1A${stderr}` : ""}`;
 }
 function makeGrep(workspace) {
   return async function grep(args) {
@@ -4872,37 +5219,50 @@ function makeGrep(workspace) {
     if (!pattern.trim()) {
       return { error: "\u641C\u7D22\u6A21\u5F0F\u4E0D\u80FD\u4E3A\u7A7A" };
     }
+    const filesOnly = args.files_only === true;
+    const ignoreCase = args.ignore_case === true;
+    const glob = typeof args.glob === "string" && args.glob.trim() ? args.glob.trim() : void 0;
+    const contextLines = Math.max(
+      0,
+      Math.min(Number(args.context_lines ?? 0) || 0, 5)
+    );
+    const maxResults = Math.max(
+      1,
+      Math.min(Number(args.max_results ?? DEFAULT_MAX_RESULTS) || DEFAULT_MAX_RESULTS, MAX_RESULTS_CAP)
+    );
     const rg = resolveRipgrep();
     if (rg) {
       const res = await execAsync(
         rg,
-        [
-          // --with-filename：单文件模式下 rg 默认不输出文件名前缀，会导致
-          // "行号:内容" 被误当成 "文件:行号:内容" 解析而错位；显式要求带文件名。
-          "--with-filename",
-          "--line-number",
-          "--no-heading",
-          "--max-count",
-          "50",
-          pattern,
-          filePath
-        ],
+        rgArgs({ pattern, path: filePath, filesOnly, ignoreCase, glob, contextLines, maxResults }),
         {
           cwd: workspace,
-          timeoutMs: 1e4,
+          timeoutMs: RG_TIMEOUT_MS,
           maxBuffer: 1024 * 1024 * 2
         }
       );
       if (res.status === 0) {
-        const matches = parseRgOutput(decodeOutput(res.stdout));
-        return { query: pattern, engine: "ripgrep", matches, count: matches.length };
+        const out = decodeOutput(res.stdout);
+        return filesOnly ? { query: pattern, engine: "ripgrep", files: parseRgFiles(out, maxResults) } : (() => {
+          const matches = parseRgOutput(out, maxResults);
+          return { query: pattern, engine: "ripgrep", matches, count: matches.length };
+        })();
       }
       if (res.status === 1) {
-        return { query: pattern, engine: "ripgrep", matches: [], count: 0 };
+        return filesOnly ? { query: pattern, engine: "ripgrep", files: [], count: 0 } : { query: pattern, engine: "ripgrep", matches: [], count: 0 };
+      }
+      if (!res.error) {
+        return { query: pattern, error: rgFailureHint(res) };
       }
     }
+    if (filesOnly || glob || ignoreCase || contextLines > 0) {
+      return {
+        query: pattern,
+        error: "\u5F53\u524D\u8282\u70B9\u672A\u5B89\u88C5 ripgrep\uFF0Cfiles_only / glob / ignore_case / context_lines \u9700\u8981 ripgrep \u624D\u80FD\u751F\u6548\uFF1B\u8BF7\u53BB\u6389\u8FD9\u4E9B\u53C2\u6570\u540E\u91CD\u8BD5\uFF0C\u6216\u5148\u5B89\u88C5 ripgrep"
+      };
+    }
     try {
-      const matches = nodeGrep({ pattern, target: filePath, workspace });
+      const matches = nodeGrep({ pattern, target: filePath, workspace, maxMatches: maxResults });
       return { query: pattern, engine: "node", matches, count: matches.length };
     } catch (exc) {
       return { error: `\u641C\u7D22\u5931\u8D25: ${String(exc instanceof Error ? exc.message : exc)}` };
@@ -4918,12 +5278,29 @@ function registerSearchTool(registry, workspace) {
       type: "function",
       function: {
         name: "grep",
-        description: "\u5728\u6587\u4EF6\u4E2D\u641C\u7D22\u6587\u672C\u6A21\u5F0F\uFF08\u652F\u6301\u5B8C\u6574 JS \u6B63\u5219\u8BED\u6CD5\uFF09\u3002\u8FD4\u56DE\u5339\u914D\u7684\u6587\u4EF6\u540D\u3001\u884C\u53F7\u548C\u5185\u5BB9\uFF0C\u6700\u591A 50 \u6761\u3002\u4F18\u5148\u4F7F\u7528 ripgrep (rg) \u4EE5\u83B7\u5F97\u66F4\u597D\u7684\u6027\u80FD\uFF1Brg \u4E0D\u53EF\u7528\u65F6\u81EA\u52A8\u56DE\u9000\u5230\u5185\u7F6E\u626B\u63CF\u5668\u3002",
+        description: "\u5728\u6587\u4EF6\u4E2D\u641C\u7D22\u6587\u672C\u6A21\u5F0F\uFF08\u652F\u6301\u5B8C\u6574 JS \u6B63\u5219\u8BED\u6CD5\uFF09\u3002\u9ED8\u8BA4\u8FD4\u56DE\u5339\u914D\u7684\u6587\u4EF6\u540D\u3001\u884C\u53F7\u548C\u5185\u5BB9\uFF08\u6700\u591A 50 \u6761\uFF09\u3002\u5B9A\u4F4D\u4EE3\u7801\u4F4D\u7F6E\u65F6\u4F18\u5148\u7528 files_only=true \u53EA\u53D6\u6587\u4EF6\u5217\u8868\uFF08\u4F53\u79EF\u5C0F\u4E00\u4E2A\u6570\u91CF\u7EA7\uFF09\uFF0C\u518D\u7528 read_file \u7CBE\u51C6\u8BFB\u53D6\uFF1B\u5927\u4ED3\u5E93\u8BF7\u914D\u5408 path \u7F29\u5C0F\u8303\u56F4\u6216 glob \u9650\u5236\u6587\u4EF6\u7C7B\u578B\uFF0C\u907F\u514D\u5168\u91CF\u626B\u63CF\u8D85\u65F6\u3002",
         parameters: {
           type: "object",
           properties: {
             pattern: { type: "string", description: "\u641C\u7D22\u6A21\u5F0F (\u6587\u672C\u6216\u6B63\u5219\u8868\u8FBE\u5F0F)" },
-            path: { type: "string", description: "\u641C\u7D22\u8DEF\u5F84 (\u6587\u4EF6\u6216\u76EE\u5F55\uFF0C\u9ED8\u8BA4 '.')" }
+            path: { type: "string", description: "\u641C\u7D22\u8DEF\u5F84 (\u6587\u4EF6\u6216\u76EE\u5F55\uFF0C\u9ED8\u8BA4 '.'\uFF1B\u5927\u4ED3\u5E93\u5EFA\u8BAE\u5148\u7F29\u5C0F\u5230\u5B50\u76EE\u5F55)" },
+            files_only: {
+              type: "boolean",
+              description: "\u53EA\u8FD4\u56DE\u5339\u914D\u7684\u6587\u4EF6\u8DEF\u5F84\uFF0C\u4E0D\u8FD4\u56DE\u884C\u5185\u5BB9\uFF08\u63A8\u8350\u7528\u4E8E\u5B9A\u4F4D\uFF0C\u663E\u8457\u8282\u7701\u4E0A\u4E0B\u6587\uFF09"
+            },
+            glob: {
+              type: "string",
+              description: '\u6587\u4EF6\u8FC7\u6EE4\uFF0C\u5982 "*.ts" \u6216 "!*.min.js"\uFF08\u53EF\u591A\u6B21\u6392\u9664\u9700\u81EA\u884C\u7EC4\u5408\u4E3A {a,b} \u5F62\u5F0F\uFF09'
+            },
+            ignore_case: { type: "boolean", description: "\u5FFD\u7565\u5927\u5C0F\u5199" },
+            context_lines: {
+              type: "integer",
+              description: "\u6BCF\u6761\u547D\u4E2D\u9644\u5E26\u7684\u524D\u540E\u4E0A\u4E0B\u6587\u884C\u6570\uFF080-5\uFF0C\u9ED8\u8BA4 0\uFF09"
+            },
+            max_results: {
+              type: "integer",
+              description: `\u6700\u591A\u8FD4\u56DE\u6761\u6570\uFF08\u9ED8\u8BA4 ${DEFAULT_MAX_RESULTS}\uFF0C\u4E0A\u9650 ${MAX_RESULTS_CAP}\uFF09`
+            }
           },
           required: ["pattern"]
         }
@@ -4933,8 +5310,8 @@ function registerSearchTool(registry, workspace) {
 }
 
 // src/tools/git.ts
-import * as fs8 from "fs";
-import * as path11 from "path";
+import * as fs9 from "fs";
+import * as path12 from "path";
 async function runGit(repoDir, args, timeout = 15e3) {
   const res = await execAsync("git", ["-c", "core.quotepath=false", ...args], {
     cwd: repoDir,
@@ -4951,9 +5328,9 @@ async function runGit(repoDir, args, timeout = 15e3) {
 async function resolveRepoRoot(workspace, pathArg) {
   let dir = workspace;
   if (pathArg) {
-    const abs = path11.resolve(workspace, pathArg);
+    const abs = path12.resolve(workspace, pathArg);
     try {
-      dir = fs8.statSync(abs).isDirectory() ? abs : path11.dirname(abs);
+      dir = fs9.statSync(abs).isDirectory() ? abs : path12.dirname(abs);
     } catch {
       dir = abs;
     }
@@ -4966,22 +5343,22 @@ function repoDirArg(workspace, raw) {
   if (typeof raw !== "string") return void 0;
   const v = raw.trim();
   if (!v) return void 0;
-  const base = path11.resolve(workspace);
-  const abs = path11.resolve(base, v);
-  const rel = path11.relative(base, abs);
+  const base = path12.resolve(workspace);
+  const abs = path12.resolve(base, v);
+  const rel = path12.relative(base, abs);
   if (!isInsideRelative(rel)) return void 0;
   return abs;
 }
 function toPathspec(repoRoot, workspace, pathArg) {
   if (!pathArg) return null;
-  const abs = path11.resolve(workspace, pathArg);
-  let rel = path11.relative(repoRoot, abs);
+  const abs = path12.resolve(workspace, pathArg);
+  let rel = path12.relative(repoRoot, abs);
   if (rel === "") return ".";
   if (!isInsideRelative(rel)) {
     try {
-      const realRepo = fs8.realpathSync(repoRoot);
-      const realAbs = fs8.realpathSync(abs);
-      const rel2 = path11.relative(realRepo, realAbs);
+      const realRepo = fs9.realpathSync(repoRoot);
+      const realAbs = fs9.realpathSync(abs);
+      const rel2 = path12.relative(realRepo, realAbs);
       if (rel2 === "") return ".";
       if (isInsideRelative(rel2)) return rel2;
     } catch {