shennian 0.2.72 → 0.2.73

package/dist/src/channels/wecom.js

@@ -111,6 +111,8 @@ export class WeComChannelAdapter {
                 lastChatReqIds: new Map(),
                 dedup: new Set(),
                 dedupQueue: [],
+                seenContextLineKeys: new Set(),
+                seenContextLineQueue: [],
             };
             this.connections.set(config.id, conn);
         }
@@ -229,7 +231,7 @@ export class WeComChannelAdapter {
             return;
         if (reqId)
             conn.lastChatReqIds.set(conversationId, reqId);
-        const text = this.extractText(body).trim();
+        const text = this.filterContextText(conn, conversationId, this.extractText(body).trim());
         if (!text)
             return;
         this.onMessage?.({
@@ -282,6 +284,46 @@ export class WeComChannelAdapter {
             return String(this.asRecord(body.appmsg)?.title || '').trim();
         return '';
     }
+    filterContextText(conn, conversationId, text) {
+        if (!text.includes('外部企业微信群消息上下文'))
+            return text;
+        const lines = text.split(/\r?\n/);
+        const headerLines = [];
+        const newMessageLines = [];
+        let sawContextLine = false;
+        for (const line of lines) {
+            const normalized = this.normalizeContextLine(line);
+            if (!normalized) {
+                if (!sawContextLine)
+                    headerLines.push(line);
+                continue;
+            }
+            sawContextLine = true;
+            const key = `${conversationId}\n${normalized}`;
+            if (conn.seenContextLineKeys.has(key))
+                continue;
+            this.rememberContextLine(conn, key);
+            newMessageLines.push(line);
+        }
+        if (!sawContextLine)
+            return text;
+        if (!newMessageLines.length)
+            return '';
+        return [...headerLines, ...newMessageLines].filter((line) => line.trim()).join('\n').trim();
+    }
+    normalizeContextLine(line) {
+        const trimmed = line.trim().replace(/^=>\s*/, '');
+        return /^\d{2}-\d{2}\s+\d{2}:\d{2}:\d{2}\s+.+/.test(trimmed) ? trimmed : null;
+    }
+    rememberContextLine(conn, key) {
+        conn.seenContextLineKeys.add(key);
+        conn.seenContextLineQueue.push(key);
+        while (conn.seenContextLineQueue.length > 2_000) {
+            const removed = conn.seenContextLineQueue.shift();
+            if (removed)
+                conn.seenContextLineKeys.delete(removed);
+        }
+    }
     raiseForWeComError(payload, operation) {
         const errcode = typeof payload.errcode === 'number' ? payload.errcode : Number(payload.errcode || 0);
         if (!Number.isFinite(errcode) || errcode === 0)

package/dist/src/manager/prompt.d.ts

@@ -1,2 +1,2 @@
-export declare const MANAGER_SYSTEM_PROMPT = "\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002\n\n\u4F60\u7684\u804C\u8D23\uFF1A\n- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002\n- \u62C6\u89E3\u4EFB\u52A1\u3002\n- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002\n- \u6C47\u603B worker \u7ED3\u679C\u3002\n- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002\n- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002\n\n\u4F60\u7684\u8FB9\u754C\uFF1A\n- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002\n- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002\n- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002\n- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u6BCF\u6B21\u6536\u5230\u65B0\u4EFB\u52A1\u3001\u8865\u5145\u8981\u6C42\u3001\u7EA0\u504F\u6216\u5916\u90E8\u6D88\u606F\u65F6\uFF0C\u5148\u7528 sessions list \u67E5\u770B\u5F53\u524D\u540C\u9879\u76EE worker\uFF1B\u5982\u679C\u53EF\u80FD\u76F8\u5173\uFF0C\u518D\u7528 sessions read \u8BFB\u53D6\u5FC5\u8981\u6458\u8981\u540E\u5224\u65AD\u662F\u5426\u590D\u7528\u3002\n- \u5982\u679C\u5DF2\u6709 worker \u6B63\u5728\u5904\u7406\u540C\u4E00\u76EE\u6807\u3001\u540C\u4E00\u529F\u80FD\u533A\u3001\u540C\u4E00\u6587\u4EF6\u8303\u56F4\u6216\u540C\u4E00\u95EE\u9898\u94FE\u8DEF\uFF0C\u4F18\u5148\u7528 sessions send \u628A\u65B0\u8981\u6C42\u53D1\u7ED9\u8FD9\u4E2A worker\uFF1B\u5373\u4F7F worker \u6B63\u5FD9\u4E5F\u53EF\u4EE5\u53D1\u9001\uFF0C\u9ED8\u8BA4\u4F1A\u8FDB\u5165\u672C\u673A\u961F\u5217\uFF0C\u4E0D\u8981\u56E0\u4E3A\u5B83\u5FD9\u5C31\u65B0\u5EFA worker\u3002\n- \u53EA\u6709\u6CA1\u6709\u76F8\u5173 worker\u3001\u73B0\u6709 worker \u5DF2\u660E\u663E\u4E0D\u9002\u5408\u7EE7\u7EED\u63A8\u8FDB\u3001\u6216\u4EFB\u52A1\u9700\u8981\u5E76\u884C\u62C6\u5206\u7ED9\u4E0D\u540C\u4E13\u957F\u65F6\uFF0C\u624D\u521B\u5EFA\u65B0\u7684 worker\u3002\n- \u521B\u5EFA\u6216\u6307\u6D3E worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002\n- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002\n- \u53EA\u80FD\u7BA1\u7406\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u3001\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684\u4F1A\u8BDD\uFF1B\u4E0D\u8981\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002\n- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002\n- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002\n- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u7C7B\u4F3C\u201C\u5916\u90E8\u6D88\u606F / \u53D1\u9001\u4EBA\u201D\u540E\u8DDF\u6D88\u606F\u5185\u5BB9\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002\n- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002\n- \u5BF9\u5916\u56DE\u590D\u5FC5\u987B\u50CF\u771F\u4EBA\u804A\u5929\uFF1A\u77ED\u56DE\u590D\u4E00\u6761\u53D1\u5B8C\uFF1B\u5185\u5BB9\u8F83\u591A\u65F6\u6309\u81EA\u7136\u6BB5\u62C6\u6210 2-4 \u6761\u8FDE\u7EED\u6D88\u606F\uFF0C\u6BCF\u6761\u53EA\u8BB2\u4E00\u4E2A\u5B8C\u6574\u4E3B\u9898\u3002\n- \u907F\u514D\u628A\u8D85\u8FC7 300-500 \u5B57\u7684\u5185\u5BB9\u585E\u8FDB\u5355\u6761\u6D88\u606F\uFF1B\u4E0D\u8981\u4F7F\u7528 Markdown\u3001\u7F16\u53F7\u5217\u8868\u3001\u9879\u76EE\u7B26\u53F7\u6216\u5B57\u9762 \\n\u3002\n- \u5916\u90E8\u6D88\u606F\u4E0E\u5F53\u524D\u9879\u76EE\u65E0\u5173\u65F6\u53EF\u4EE5\u5FFD\u7565\uFF1B\u9700\u8981\u8F83\u957F\u5904\u7406\u65F6\uFF0C\u5148\u7B80\u77ED\u56DE\u590D\u201C\u6536\u5230\uFF0C\u6211\u5148\u5904\u7406/\u5B89\u6392\u4E00\u4E0B\u201D\uFF0C\u518D\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u5411\u5916\u90E8\u7FA4\u53D1\u6587\u5B57\u4E00\u5F8B\u8C03\u7528 shennian manager external send --text \"<\u6D88\u606F\u5185\u5BB9>\"\n- \u5411\u5916\u90E8\u7FA4\u53D1\u56FE\u7247\u8C03\u7528 shennian manager external send-image --path \"<\u56FE\u7247\u7EDD\u5BF9\u8DEF\u5F84>\" --caption \"<\u53EF\u9009\u8BF4\u660E>\"\n- \u5411\u5916\u90E8\u7FA4\u53D1\u89C6\u9891\u8C03\u7528 shennian manager external send-video --path \"<\u89C6\u9891\u7EDD\u5BF9\u8DEF\u5F84>\" --caption \"<\u53EF\u9009\u8BF4\u660E>\"\n- \u5411\u5916\u90E8\u7FA4\u53D1\u6587\u4EF6\u8C03\u7528 shennian manager external send-file --path \"<\u6587\u4EF6\u7EDD\u5BF9\u8DEF\u5F84>\" --caption \"<\u53EF\u9009\u8BF4\u660E>\"\n- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002\n\n\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A\n- shennian manager sessions list --json\n- shennian manager sessions start --agent <codex|claude|gemini|cursor|opencode|pi|custom:name> --workdir <path> --message <text>\n- shennian manager sessions send --session-id <id> --message <text>\n- shennian manager sessions send --session-id <id> --message <text> --direct\n- shennian manager sessions queue list --session-id <id> --json\n- shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>\n- shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>\n- shennian manager sessions stop --session-id <id>\uFF08\u7EC8\u6B62\u6B63\u5728\u8FD0\u884C\u7684 worker\uFF1B\u4E5F\u53EF\u7528 terminate/kill \u522B\u540D\uFF09\n- shennian manager sessions read --session-id <id> --limit 200 --json\n- shennian manager memory path\n- shennian manager external send --text <text>\n- shennian manager external send-image --path <path> --caption <text>\n- shennian manager external send-video --path <path> --caption <text>\n- shennian manager external send-file --path <path> --caption <text>\n\n\u53EF\u521B\u5EFA\u7684 worker Agent \u5305\u62EC Codex\u3001Claude Code\u3001Gemini\u3001Cursor\u3001opencode\u3001Nian\uFF0C\u4EE5\u53CA\u672C\u673A custom agent\uFF08custom:<name>\uFF09\u3002\u9ED8\u8BA4\u7528 sessions send \u6392\u961F\u53D1\u9001 worker \u6D88\u606F\uFF1Aworker \u6B63\u5FD9\u65F6\u6D88\u606F\u4F1A\u5728\u672C\u673A daemon \u961F\u5217\u91CC\u7B49\u5F85\uFF0Cworker \u7A7A\u95F2\u65F6\u81EA\u52A8\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\u53EA\u6709\u660E\u786E\u9700\u8981\u6253\u65AD\u987A\u5E8F\u65F6\u624D\u4F7F\u7528 --direct\u3002\n\n\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002";
+export declare const MANAGER_SYSTEM_PROMPT = "\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002\n\n\u4F60\u7684\u804C\u8D23\uFF1A\n- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002\n- \u62C6\u89E3\u4EFB\u52A1\u3002\n- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002\n- \u6C47\u603B worker \u7ED3\u679C\u3002\n- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002\n- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002\n\n\u4F60\u7684\u8FB9\u754C\uFF1A\n- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002\n- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002\n- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002\n- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u6BCF\u6B21\u6536\u5230\u65B0\u4EFB\u52A1\u3001\u8865\u5145\u8981\u6C42\u3001\u7EA0\u504F\u6216\u5916\u90E8\u6D88\u606F\u65F6\uFF0C\u5148\u7528 sessions list \u67E5\u770B\u5F53\u524D\u540C\u9879\u76EE worker\uFF1B\u5982\u679C\u53EF\u80FD\u76F8\u5173\uFF0C\u518D\u7528 sessions read \u8BFB\u53D6\u5FC5\u8981\u6458\u8981\u540E\u5224\u65AD\u662F\u5426\u590D\u7528\u3002\n- \u5982\u679C\u5DF2\u6709 worker \u6B63\u5728\u5904\u7406\u540C\u4E00\u76EE\u6807\u3001\u540C\u4E00\u529F\u80FD\u533A\u3001\u540C\u4E00\u6587\u4EF6\u8303\u56F4\u6216\u540C\u4E00\u95EE\u9898\u94FE\u8DEF\uFF0C\u4F18\u5148\u7528 sessions send \u628A\u65B0\u8981\u6C42\u53D1\u7ED9\u8FD9\u4E2A worker\uFF1B\u5373\u4F7F worker \u6B63\u5FD9\u4E5F\u53EF\u4EE5\u53D1\u9001\uFF0C\u9ED8\u8BA4\u4F1A\u8FDB\u5165\u672C\u673A\u961F\u5217\uFF0C\u4E0D\u8981\u56E0\u4E3A\u5B83\u5FD9\u5C31\u65B0\u5EFA worker\u3002\n- \u53EA\u6709\u6CA1\u6709\u76F8\u5173 worker\u3001\u73B0\u6709 worker \u5DF2\u660E\u663E\u4E0D\u9002\u5408\u7EE7\u7EED\u63A8\u8FDB\u3001\u6216\u4EFB\u52A1\u9700\u8981\u5E76\u884C\u62C6\u5206\u7ED9\u4E0D\u540C\u4E13\u957F\u65F6\uFF0C\u624D\u521B\u5EFA\u65B0\u7684 worker\u3002\n- \u521B\u5EFA\u6216\u6307\u6D3E worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002\n- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002\n- \u53EA\u80FD\u7BA1\u7406\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u3001\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684\u4F1A\u8BDD\uFF1B\u4E0D\u8981\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002\n- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002\n- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002\n- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u7C7B\u4F3C\u201C\u5916\u90E8\u6D88\u606F / \u53D1\u9001\u4EBA\u201D\u540E\u8DDF\u6D88\u606F\u5185\u5BB9\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002\n- \u5916\u90E8\u6D88\u606F\u662F\u5426\u9700\u8981\u56DE\u590D\u3001\u8FFD\u95EE\u3001\u5FFD\u7565\u3001\u8F6C\u4EA4\u5185\u90E8\u8D1F\u8D23\u4EBA\uFF0C\u6216\u521B\u5EFA/\u6307\u6D3E worker\uFF0C\u7531\u4F60\u6839\u636E\u9879\u76EE\u4E0A\u4E0B\u6587\u663E\u5F0F\u5224\u65AD\u3002\n- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002\n- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002\n\n\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A\n- shennian manager sessions list --json\n- shennian manager sessions start --agent <codex|claude|gemini|cursor|opencode|pi|custom:name> --workdir <path> --message <text>\n- shennian manager sessions send --session-id <id> --message <text>\n- shennian manager sessions send --session-id <id> --message <text> --direct\n- shennian manager sessions queue list --session-id <id> --json\n- shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>\n- shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>\n- shennian manager sessions stop --session-id <id>\uFF08\u7EC8\u6B62\u6B63\u5728\u8FD0\u884C\u7684 worker\uFF1B\u4E5F\u53EF\u7528 terminate/kill \u522B\u540D\uFF09\n- shennian manager sessions read --session-id <id> --limit 200 --json\n- shennian manager memory path\n\n\u53EF\u521B\u5EFA\u7684 worker Agent \u5305\u62EC Codex\u3001Claude Code\u3001Gemini\u3001Cursor\u3001opencode\u3001Nian\uFF0C\u4EE5\u53CA\u672C\u673A custom agent\uFF08custom:<name>\uFF09\u3002\u9ED8\u8BA4\u7528 sessions send \u6392\u961F\u53D1\u9001 worker \u6D88\u606F\uFF1Aworker \u6B63\u5FD9\u65F6\u6D88\u606F\u4F1A\u5728\u672C\u673A daemon \u961F\u5217\u91CC\u7B49\u5F85\uFF0Cworker \u7A7A\u95F2\u65F6\u81EA\u52A8\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\u53EA\u6709\u660E\u786E\u9700\u8981\u6253\u65AD\u987A\u5E8F\u65F6\u624D\u4F7F\u7528 --direct\u3002\n\n\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002";
 export declare function buildManagerPrompt(userText: string): string;

package/dist/src/manager/prompt.js

@@ -24,14 +24,8 @@ export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管
 - 不要无限循环；没有明确下一步时询问用户或结束当前 turn 等待系统事件。
 - 不要自己设置定时唤醒；神念会在用户消息、worker 终态或 worker 长运行健康摘要到来时唤醒你。
 - 外部消息通道事件会像普通用户消息一样送达，格式类似“外部消息 / 发送人”后跟消息内容，可能是合并消息，也可能包含图片、视频或文件 URL。
+- 外部消息是否需要回复、追问、忽略、转交内部负责人，或创建/指派 worker，由你根据项目上下文显式判断。
 - 对外你是当前项目的项目经理，不要自称神念、Manager Agent 或 worker，也不要解释内部调度机制；只在需要时用“我这边/我们这边”沟通。
-- 对外回复必须像真人聊天：短回复一条发完；内容较多时按自然段拆成 2-4 条连续消息，每条只讲一个完整主题。
-- 避免把超过 300-500 字的内容塞进单条消息；不要使用 Markdown、编号列表、项目符号或字面 \\n。
-- 外部消息与当前项目无关时可以忽略；需要较长处理时，先简短回复“收到，我先处理/安排一下”，再创建或指派 worker。
-- 向外部群发文字一律调用 shennian manager external send --text "<消息内容>"
-- 向外部群发图片调用 shennian manager external send-image --path "<图片绝对路径>" --caption "<可选说明>"
-- 向外部群发视频调用 shennian manager external send-video --path "<视频绝对路径>" --caption "<可选说明>"
-- 向外部群发文件调用 shennian manager external send-file --path "<文件绝对路径>" --caption "<可选说明>"
 - 不要把所有细节塞进对话上下文；需要长期保存的信息写到项目 .shennian/ 下。
 
 需要管理 worker 或外部通道时，使用本地命令：
@@ -45,10 +39,6 @@ export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管
 - shennian manager sessions stop --session-id <id>（终止正在运行的 worker；也可用 terminate/kill 别名）
 - shennian manager sessions read --session-id <id> --limit 200 --json
 - shennian manager memory path
-- shennian manager external send --text <text>
-- shennian manager external send-image --path <path> --caption <text>
-- shennian manager external send-video --path <path> --caption <text>
-- shennian manager external send-file --path <path> --caption <text>
 
 可创建的 worker Agent 包括 Codex、Claude Code、Gemini、Cursor、opencode、Nian，以及本机 custom agent（custom:<name>）。默认用 sessions send 排队发送 worker 消息：worker 正忙时消息会在本机 daemon 队列里等待，worker 空闲时自动执行。队列里的未执行消息可以 list/edit/delete；已经开始执行的消息不能编辑或删除，只能 stop 后重新发送。只有明确需要打断顺序时才使用 --direct。
 

package/dist/src/manager/runtime.js

@@ -11,6 +11,7 @@ import { readMessages } from '../session/store.js';
 import { ChannelRuntime } from '../channels/runtime.js';
 import { splitExternalReplyText } from '../channels/reply-split.js';
 import { resolveShennianPath } from '../config/index.js';
+import { buildExternalChannelInstructions } from '../agents/external-channel-instructions.js';
 let singleton = null;
 export function setManagerRuntimeService(service) {
     singleton = service;
@@ -793,7 +794,8 @@ ${message || worker.summary || '(无可见摘要)'}
     }
     getManagerExternalChannelSystemPrompt(managerSessionId) {
         return this.channelRuntime
-            .listManagerChannelSystemPrompts(managerSessionId)
+            .listManagerExternalChannels(managerSessionId)
+            .map((channel) => buildExternalChannelInstructions(channel, undefined, managerSessionId, 'manager'))
             .join('\n\n')
             .trim();
     }

package/dist/src/session/archive-zip.d.ts

@@ -0,0 +1,10 @@
+export type ZipArchiveOptions = {
+    maxFiles?: number;
+    maxTotalSize?: number;
+};
+export type ZipArchiveResult = {
+    outputPath: string;
+    fileCount: number;
+    totalSize: number;
+};
+export declare function createZipArchive(sourceDir: string, outputPath: string, options?: ZipArchiveOptions): ZipArchiveResult;

package/dist/src/session/archive-zip.js

@@ -0,0 +1,220 @@
+// @arch docs/features/file-management-enhancements.md#文件夹打包下载
+// @test src/__tests__/archive-zip.test.ts
+import fs from 'node:fs';
+import path from 'node:path';
+const DEFAULT_MAX_FILES = 5000;
+const DEFAULT_MAX_TOTAL_SIZE = 1024 * 1024 * 1024;
+const ZIP_VERSION_NEEDED = 20;
+const ZIP_UTF8_FLAG = 0x0800;
+const ZIP_STORE_METHOD = 0;
+const CHUNK_SIZE = 1024 * 1024;
+const crcTable = new Uint32Array(256);
+for (let index = 0; index < 256; index += 1) {
+    let value = index;
+    for (let bit = 0; bit < 8; bit += 1) {
+        value = value & 1 ? 0xedb88320 ^ (value >>> 1) : value >>> 1;
+    }
+    crcTable[index] = value >>> 0;
+}
+function updateCrc32(crc, buffer) {
+    let next = crc;
+    for (let index = 0; index < buffer.length; index += 1) {
+        next = crcTable[(next ^ buffer[index]) & 0xff] ^ (next >>> 8);
+    }
+    return next >>> 0;
+}
+function dosDateTime(mtimeMs) {
+    const date = new Date(mtimeMs || Date.now());
+    const year = Math.max(1980, Math.min(2107, date.getFullYear()));
+    return {
+        date: ((year - 1980) << 9) | ((date.getMonth() + 1) << 5) | date.getDate(),
+        time: (date.getHours() << 11) | (date.getMinutes() << 5) | Math.floor(date.getSeconds() / 2),
+    };
+}
+function writeUInt32(buffer, value, offset) {
+    buffer.writeUInt32LE(value >>> 0, offset);
+}
+function writeLocalHeader(fd, entry) {
+    const name = Buffer.from(entry.name, 'utf8');
+    const { date, time } = dosDateTime(entry.mtimeMs);
+    const header = Buffer.alloc(30);
+    writeUInt32(header, 0x04034b50, 0);
+    header.writeUInt16LE(ZIP_VERSION_NEEDED, 4);
+    header.writeUInt16LE(ZIP_UTF8_FLAG, 6);
+    header.writeUInt16LE(ZIP_STORE_METHOD, 8);
+    header.writeUInt16LE(time, 10);
+    header.writeUInt16LE(date, 12);
+    writeUInt32(header, entry.crc32, 14);
+    writeUInt32(header, entry.size, 18);
+    writeUInt32(header, entry.size, 22);
+    header.writeUInt16LE(name.length, 26);
+    header.writeUInt16LE(0, 28);
+    fs.writeSync(fd, header);
+    fs.writeSync(fd, name);
+}
+function writeCentralDirectoryHeader(fd, entry) {
+    const name = Buffer.from(entry.name, 'utf8');
+    const { date, time } = dosDateTime(entry.mtimeMs);
+    const header = Buffer.alloc(46);
+    writeUInt32(header, 0x02014b50, 0);
+    header.writeUInt16LE(0x031e, 4);
+    header.writeUInt16LE(ZIP_VERSION_NEEDED, 6);
+    header.writeUInt16LE(ZIP_UTF8_FLAG, 8);
+    header.writeUInt16LE(ZIP_STORE_METHOD, 10);
+    header.writeUInt16LE(time, 12);
+    header.writeUInt16LE(date, 14);
+    writeUInt32(header, entry.crc32, 16);
+    writeUInt32(header, entry.size, 20);
+    writeUInt32(header, entry.size, 24);
+    header.writeUInt16LE(name.length, 28);
+    header.writeUInt16LE(0, 30);
+    header.writeUInt16LE(0, 32);
+    header.writeUInt16LE(0, 34);
+    header.writeUInt16LE(0, 36);
+    writeUInt32(header, entry.isDir ? 0x10 : 0, 38);
+    writeUInt32(header, entry.offset, 42);
+    fs.writeSync(fd, header);
+    fs.writeSync(fd, name);
+}
+function writeEndOfCentralDirectory(fd, entryCount, centralSize, centralOffset) {
+    const header = Buffer.alloc(22);
+    writeUInt32(header, 0x06054b50, 0);
+    header.writeUInt16LE(0, 4);
+    header.writeUInt16LE(0, 6);
+    header.writeUInt16LE(entryCount, 8);
+    header.writeUInt16LE(entryCount, 10);
+    writeUInt32(header, centralSize, 12);
+    writeUInt32(header, centralOffset, 16);
+    header.writeUInt16LE(0, 20);
+    fs.writeSync(fd, header);
+}
+function normalizeZipName(relativePath, isDir) {
+    const normalized = relativePath.split(path.sep).join('/');
+    return isDir && !normalized.endsWith('/') ? `${normalized}/` : normalized;
+}
+function collectEntries(sourceDir, options) {
+    const sourceStat = fs.statSync(sourceDir);
+    const rootName = normalizeZipName(path.basename(sourceDir) || 'folder', true);
+    const entries = [{
+            name: rootName,
+            sourcePath: null,
+            crc32: 0,
+            size: 0,
+            isDir: true,
+            mtimeMs: sourceStat.mtimeMs,
+        }];
+    let fileCount = 0;
+    let totalSize = 0;
+    const visit = (dirPath) => {
+        const raw = fs.readdirSync(dirPath, { withFileTypes: true });
+        for (const dirent of raw) {
+            const fullPath = path.join(dirPath, dirent.name);
+            const relative = path.relative(sourceDir, fullPath);
+            if (!relative || relative.startsWith('..') || path.isAbsolute(relative))
+                continue;
+            const stat = fs.lstatSync(fullPath);
+            if (stat.isSymbolicLink())
+                continue;
+            if (stat.isDirectory()) {
+                entries.push({
+                    name: path.posix.join(rootName, normalizeZipName(relative, true)),
+                    sourcePath: null,
+                    crc32: 0,
+                    size: 0,
+                    isDir: true,
+                    mtimeMs: stat.mtimeMs,
+                });
+                visit(fullPath);
+                continue;
+            }
+            if (!stat.isFile())
+                continue;
+            fileCount += 1;
+            if (fileCount > options.maxFiles)
+                throw new Error(`Too many files: ${fileCount}`);
+            totalSize += stat.size;
+            if (totalSize > options.maxTotalSize) {
+                throw new Error(`Folder too large: ${totalSize} bytes`);
+            }
+            entries.push({
+                name: path.posix.join(rootName, normalizeZipName(relative, false)),
+                sourcePath: fullPath,
+                crc32: computeFileCrc32(fullPath),
+                size: stat.size,
+                isDir: false,
+                mtimeMs: stat.mtimeMs,
+            });
+        }
+    };
+    visit(sourceDir);
+    return entries;
+}
+function computeFileCrc32(filePath) {
+    const fd = fs.openSync(filePath, 'r');
+    const buffer = Buffer.alloc(CHUNK_SIZE);
+    let crc = 0xffffffff;
+    try {
+        while (true) {
+            const bytesRead = fs.readSync(fd, buffer, 0, buffer.length, null);
+            if (bytesRead <= 0)
+                break;
+            crc = updateCrc32(crc, buffer.subarray(0, bytesRead));
+        }
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+function writeFileData(fd, filePath) {
+    const sourceFd = fs.openSync(filePath, 'r');
+    const buffer = Buffer.alloc(CHUNK_SIZE);
+    try {
+        while (true) {
+            const bytesRead = fs.readSync(sourceFd, buffer, 0, buffer.length, null);
+            if (bytesRead <= 0)
+                break;
+            fs.writeSync(fd, buffer.subarray(0, bytesRead));
+        }
+    }
+    finally {
+        fs.closeSync(sourceFd);
+    }
+}
+export function createZipArchive(sourceDir, outputPath, options = {}) {
+    const sourceStat = fs.statSync(sourceDir);
+    if (!sourceStat.isDirectory())
+        throw new Error('Not a directory');
+    const limits = {
+        maxFiles: options.maxFiles ?? DEFAULT_MAX_FILES,
+        maxTotalSize: options.maxTotalSize ?? DEFAULT_MAX_TOTAL_SIZE,
+    };
+    const scanned = collectEntries(sourceDir, limits);
+    const zipEntries = [];
+    let fileCount = 0;
+    let totalSize = 0;
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    const fd = fs.openSync(outputPath, 'w');
+    try {
+        for (const entry of scanned) {
+            const offset = fs.fstatSync(fd).size;
+            const nextEntry = { ...entry, offset };
+            writeLocalHeader(fd, nextEntry);
+            if (nextEntry.sourcePath) {
+                writeFileData(fd, nextEntry.sourcePath);
+                fileCount += 1;
+                totalSize += nextEntry.size;
+            }
+            zipEntries.push(nextEntry);
+        }
+        const centralOffset = fs.fstatSync(fd).size;
+        for (const entry of zipEntries)
+            writeCentralDirectoryHeader(fd, entry);
+        const centralSize = fs.fstatSync(fd).size - centralOffset;
+        writeEndOfCentralDirectory(fd, zipEntries.length, centralSize, centralOffset);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return { outputPath, fileCount, totalSize };
+}

package/dist/src/session/handlers/agent-config.js

@@ -1,7 +1,14 @@
 // @arch docs/features/agent-provider-config.md
 // @test src/__tests__/agent-config-status.test.ts
+// @test src/__tests__/agent-config-handler.test.ts
+import { mkdir } from 'node:fs/promises';
+import { createAgent } from '../../agents/adapter.js';
 import { buildManagedAgentEnv, deleteManagedAgentProviderConfig, getAgentConfigSummary, upsertManagedAgentProviderConfig, } from '../../agents/config-status.js';
+import { resolveShennianPath } from '../../config/index.js';
 import { handleAgentsRefresh } from './agents.js';
+const AGENT_TEST_TIMEOUT_MS = 30_000;
+const AGENT_TEST_PROMPT = '这是一次神念连接测试。请只回复 OK，不要解释。';
+const AGENT_TEST_WORK_DIR = resolveShennianPath('tmp', 'agent-config-test');
 function normalizeAgent(value) {
     if (value === 'codex' || value === 'claude' || value === 'pi')
         return value;
@@ -45,13 +52,85 @@ export async function handleAgentConfigClear(runtime, req) {
 export async function handleAgentConfigTest(runtime, req) {
     const agent = normalizeAgent(req.params.agent);
     const summary = getAgentConfigSummary(agent);
-    runtime.client.sendRes({
-        type: 'res',
-        id: req.id,
-        ok: !!summary?.tokenPresent,
-        payload: { agent, config: summary },
-        ...(!summary?.tokenPresent ? { error: 'Token is missing on this machine' } : {}),
+    try {
+        const result = await runAgentConfigTest(agent);
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: true,
+            payload: { agent, config: getAgentConfigSummary(agent), test: result },
+        });
+    }
+    catch (err) {
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: false,
+            payload: { agent, config: summary },
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+async function runAgentConfigTest(agent) {
+    const adapter = createAgent(agent);
+    if (!adapter)
+        throw new Error(`Unsupported agent: ${agent}`);
+    const sessionId = `agent-test-${agent}-${Date.now()}`;
+    await mkdir(AGENT_TEST_WORK_DIR, { recursive: true });
+    let settled = false;
+    let failWait = () => { };
+    const waitForReply = new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            reject(new Error('Agent test timed out after 30 seconds'));
+        }, AGENT_TEST_TIMEOUT_MS);
+        function finish(result) {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            resolve(result);
+        }
+        function fail(error) {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            reject(error);
+        }
+        failWait = fail;
+        adapter.on('agentEvent', (event) => {
+            if (event.state === 'delta' && event.text && !event.thinking) {
+                finish({ mode: 'agent-run', reply: event.text.slice(0, 120) });
+                return;
+            }
+            if (event.state === 'final') {
+                finish({ mode: 'agent-run' });
+                return;
+            }
+            if (event.state === 'error') {
+                fail(new Error(event.message || 'Agent test failed'));
+            }
+        });
+        adapter.on('error', fail);
     });
+    try {
+        adapter.configure?.({
+            sessionId,
+            env: getManagedEnvForAgent(agent),
+        });
+        await adapter.start(sessionId, AGENT_TEST_WORK_DIR, null);
+        const sendPromise = adapter.send(AGENT_TEST_PROMPT).catch((err) => {
+            failWait(err instanceof Error ? err : new Error(String(err)));
+        });
+        return await Promise.race([waitForReply, sendPromise.then(() => waitForReply)]);
+    }
+    finally {
+        adapter.removeAllListeners();
+        await adapter.stop().catch(() => { });
+    }
 }
 async function broadcastAgents(runtime) {
     const req = {

package/dist/src/session/handlers/chat.js

@@ -34,6 +34,16 @@ function extractSummary(text) {
     const end = newline > 0 ? Math.min(newline, 80) : Math.min(text.length, 80);
     return text.slice(0, end);
 }
+function formatAgentSendFailure(agentType, err) {
+    const raw = err instanceof Error ? err.message : String(err);
+    if (agentType === 'pi' &&
+        (raw.includes('429') || raw.includes('daily_quota_exceeded') || raw.includes('nian_quota_exceeded'))) {
+        return raw.includes('too quickly') || raw.includes('per minute')
+            ? 'Nian 请求过于频繁，请稍后再试。'
+            : 'Nian 今日额度已用完，次日自动恢复。';
+    }
+    return `Agent send failed: ${raw}`;
+}
 function getNativeSourceAgentType(agentType, modelId) {
     if (agentType !== 'manager')
         return agentType;
@@ -500,7 +510,7 @@ export async function handleChatSend(runtime, req) {
         });
     };
     const handleSendFailure = async (err, respondToReq) => {
-        const message = `Agent send failed: ${err instanceof Error ? err.message : String(err)}`;
+        const message = formatAgentSendFailure(requestedAgentType, err);
         console.error(`[chat.send] send failed reqId=${req.id} sessionId=${sessionId} agentType=${agentType} workDir=${resolvedWorkDir} agentSessionId=${session.agentSessionId ?? incomingAgentSid ?? ''}: ${message}`);
         runtime.sessions.delete(sessionId);
         try {
@@ -518,6 +528,22 @@ export async function handleChatSend(runtime, req) {
                 seq: 0,
             },
         });
+        if (!respondToReq) {
+            const errorEnvelope = {
+                id: `agent-error-${req.id}-${Date.now()}`,
+                sessionId,
+                role: 'agent',
+                ts: Date.now(),
+                payload: message,
+            };
+            appendMessage(sessionId, errorEnvelope);
+            sendSessionMessageEvent(runtime, errorEnvelope, {
+                agentType: requestedAgentType,
+                workDir: displayWorkDir,
+                agentSessionId: session.agentSessionId ?? incomingAgentSid ?? null,
+                modelId,
+            });
+        }
         if (respondToReq) {
             runtime.processedReqIds.delete(req.id);
             runtime.client.sendRes({

package/dist/src/session/handlers/fs.d.ts

@@ -5,6 +5,7 @@ export declare function handleFsRead(runtime: SessionManagerRuntime, req: ReqFra
 export declare function handleFsWrite(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
 export declare function handleFsRename(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
 export declare function handleFsExportMarkdownPdf(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
+export declare function handleFsArchiveZip(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
 export declare function handleFsTransfer(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
 export declare function handleFsTransferStart(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;
 export declare function handleFsTransferChunk(runtime: SessionManagerRuntime, req: ReqFrame): Promise<void>;

package/dist/src/session/handlers/fs.js

@@ -4,9 +4,12 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { convertMarkdownToPdf, defaultPdfOutputPath, MarkdownPdfBrowserMissingError, } from '../../tools/markdown-to-pdf.js';
+import { createZipArchive } from '../archive-zip.js';
 const FILE_SYSTEM_ROOTS_PATH = '__roots__';
 const MAX_FOLDER_UPLOAD_FILES = 2000;
 const MAX_FOLDER_UPLOAD_TOTAL_SIZE = 1024 * 1024 * 1024;
+const MAX_ARCHIVE_FILES = 5000;
+const MAX_ARCHIVE_TOTAL_SIZE = 1024 * 1024 * 1024;
 function isWindowsAbsolutePath(pathValue) {
     return /^[A-Za-z]:([\\/]|$)/.test(pathValue) || /^\\\\[^\\]+\\[^\\]+/.test(pathValue);
 }
@@ -263,7 +266,6 @@ export async function handleFsWrite(runtime, req) {
 export async function handleFsRename(runtime, req) {
     const requestedPath = req.params.path;
     const newName = req.params.newName;
-    const rootPath = req.params.rootPath || requestedPath;
     if (!requestedPath || !newName) {
         runtime.client.sendRes({
             type: 'res',
@@ -277,6 +279,8 @@ export async function handleFsRename(runtime, req) {
         runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Invalid newName' });
         return;
     }
+    const api = pathApiForPath(requestedPath);
+    const rootPath = req.params.rootPath || api.dirname(requestedPath);
     const resolved = runtime.resolveAuthorizedPath(requestedPath, rootPath);
     if (!resolved.ok) {
         runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
@@ -373,6 +377,58 @@ export async function handleFsExportMarkdownPdf(runtime, req) {
         });
     }
 }
+function safeArchiveBaseName(name) {
+    const trimmed = name.trim().replace(/[<>:"/\\|?*\u0000-\u001f]+/g, '-').replace(/[. ]+$/g, '');
+    return trimmed || 'folder';
+}
+export async function handleFsArchiveZip(runtime, req) {
+    const requestedPath = req.params.path;
+    const rootPath = req.params.rootPath || requestedPath;
+    if (!requestedPath) {
+        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'path is required' });
+        return;
+    }
+    const resolved = runtime.resolveAuthorizedPath(requestedPath, rootPath);
+    if (!resolved.ok) {
+        runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: resolved.error });
+        return;
+    }
+    try {
+        const stat = fs.statSync(resolved.path);
+        if (!stat.isDirectory()) {
+            runtime.client.sendRes({ type: 'res', id: req.id, ok: false, error: 'Not a directory' });
+            return;
+        }
+        const api = pathApiForPath(resolved.path);
+        const baseName = safeArchiveBaseName(api.basename(resolved.path));
+        const archiveDir = path.join(os.tmpdir(), 'shennian-archives');
+        const outputPath = path.join(archiveDir, `${baseName}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.zip`);
+        const result = createZipArchive(resolved.path, outputPath, {
+            maxFiles: MAX_ARCHIVE_FILES,
+            maxTotalSize: MAX_ARCHIVE_TOTAL_SIZE,
+        });
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: true,
+            payload: {
+                sourcePath: resolved.path,
+                outputPath: result.outputPath,
+                entry: makeFsEntry(result.outputPath),
+                fileCount: result.fileCount,
+                totalSize: result.totalSize,
+            },
+        });
+    }
+    catch (err) {
+        runtime.client.sendRes({
+            type: 'res',
+            id: req.id,
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
 export async function handleFsTransfer(runtime, req) {
     const { name, targetPath, data, direct } = req.params;
     if (!name || !data) {

package/dist/src/session/manager.js

@@ -9,7 +9,7 @@ import { handleAgentConfigClear, handleAgentConfigGet, handleAgentConfigTest, ha
 import { handleChatAbort, handleChatSend } from './handlers/chat.js';
 import { handleSessionRefresh } from './handlers/session-refresh.js';
 import { handleSessionTitleSet } from './handlers/title.js';
-import { cleanupPendingTransfers, handleFsLs, handleFsRead, handleFsRename, handleFsWrite, handleFsTransfer, handleFsTransferAbort, handleFsTransferChunk, handleFsTransferFinish, handleFsTransferStart, handleFsExportMarkdownPdf, } from './handlers/fs.js';
+import { cleanupPendingTransfers, handleFsLs, handleFsRead, handleFsRename, handleFsWrite, handleFsTransfer, handleFsTransferAbort, handleFsTransferChunk, handleFsTransferFinish, handleFsTransferStart, handleFsExportMarkdownPdf, handleFsArchiveZip, } from './handlers/fs.js';
 import { handleSkillDoctor, handleSkillInstall, handleSkillList, handleSkillSetup, handleSkillUse, } from './handlers/skills.js';
 import { handleRegionProbe, handleRegionSwitch, handleUpgradeSetPolicy, } from './handlers/control.js';
 import { ManagerRuntimeService, setManagerRuntimeService } from '../manager/runtime.js';
@@ -124,6 +124,9 @@ export class SessionManager {
                 case 'fs.export.markdown-pdf':
                     await handleFsExportMarkdownPdf(runtime, req);
                     break;
+                case 'fs.archive.zip':
+                    await handleFsArchiveZip(runtime, req);
+                    break;
                 case 'fs.rename':
                     await handleFsRename(runtime, req);
                     break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shennian",
-  "version": "0.2.72",
+  "version": "0.2.73",
   "description": "Shennian — AI Agent Control Plane CLI",
   "type": "module",
   "bin": {