@gird/ccli 2.19.0 → 2.21.0

package/README.md

@@ -26,6 +26,8 @@ ccli --yes "在当前目录创建 test.txt"   # 自动确认破坏性工具调
 ccli --role coder "review 这段代码"    # 使用 coding 角色单次调用
 ccli serve                            # 启动本地 HTTP server + Web UI（默认 127.0.0.1:4000）
 ccli plugin                           # 列出已安装的插件包
+ccli --docker my-sandbox              # 使用指定的 Docker 容器作为隔离运行沙箱
+ccli --remote ssh://user@host         # 使用指定的 SSH 远程连接进行开发
 ```
 
 > ⚠️ `--yes` 会自动批准本次调用内**所有**需确认的工具调用（写文件、编辑文件、bash、MCP 工具），包括 `rm`、`git push` 这类高风险操作。请只在任务范围明确、且目录可丢弃或改动已提交时使用；拿不准就不加，逐项确认。
@@ -38,6 +40,8 @@ ccli plugin                           # 列出已安装的插件包
 
 对话里输入以 `#` 开头的一行，可把内容**追加进项目 `CCLI.md` 并立即生效**（不发给 AI），下次启动自动带上，例如 `# 本项目用 pnpm`。输入 `/memories` 可查看当前会话实际注入了哪些记忆（按层级列出）。
 
+**项目目录结构**：CCLI 构造 system prompt 时，会自动附带当前工作目录的紧凑 2 级目录树（隐藏目录折叠、跳过 `node_modules/.git/dist/.ccli`）。这让模型在回答「分析这个项目」时，先看到全局结构而不是只钻进某个隐藏配置目录。
+
 **技能（自定义提示词模板）**：在 `.ccli/skills/`（项目）或 `~/.ccli/skills/`（用户）放置 `*.md` 文件即可定义一个「技能」——一段可复用的提示词，支持 `$ARGUMENTS` 参数占位。用 `/skills` 列出、`/skill <名称> [参数]` 调用（会展开成一条消息交给 AI）。md 可带 `name` / `description` 的 YAML frontmatter；同名时项目技能覆盖用户技能。技能也可以是**目录技能包** `<名>/SKILL.md` + 附属文件（脚本/模板/资料，调用时告知模型路径供 `read_file`），嵌套 `SKILL.md` 成为**子技能**。除了手动 `/skill`，**模型也会在意图匹配时自动调用技能**（frontmatter 加 `disableModelInvocation: true` 可只保留手动调用）。
 
 除了手动 `/skill`，**模型也会在意图匹配时自动调用技能**（frontmatter 加 `disableModelInvocation: true` 可只保留手动调用）。

package/dist/agent/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/agent/ai.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAyErD,sBAAsB;AACtB,MAAM,UAAU,cAAc,CAAC,MAAc;IACzC,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAID;;;;;;;GAOG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/agent/ai.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA6ErD,sBAAsB;AACtB,MAAM,UAAU,cAAc,CAAC,MAAc;IACzC,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAID;;;;;;;GAOG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/agent/model-catalog.js

@@ -0,0 +1,100 @@
+/**
+ * 模型目录缓存。
+ *
+ * 把当前 provider 的可用模型列表缓存到 `~/.ccli/model-cache.json`，
+ * 避免每次 `/model` / `/models` 都联网拉取。
+ *
+ * 缓存键为 `${provider}:${baseURL}`，区分同一个 provider 的不同兼容端点。
+ * 默认 TTL 24 小时；缓存缺失/过期/损坏时自动降级为实时拉取。
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** 缓存文件路径：~/.ccli/model-cache.json（懒计算，方便测试注入 HOME）。 */
+function cacheFile() {
+    return join(homedir(), '.ccli', 'model-cache.json');
+}
+/** 默认缓存有效期：24 小时。 */
+export const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+/**
+ * 计算缓存键。
+ * 同一个 provider 不同 baseURL（如 OpenAI 兼容服务）会分成不同桶，避免互相污染。
+ */
+export function cacheKey(provider, baseURL) {
+    return baseURL ? `${provider}:${baseURL}` : provider;
+}
+/** 读取缓存文件；不存在或损坏返回空对象。 */
+function readCache() {
+    const path = cacheFile();
+    if (!existsSync(path))
+        return {};
+    try {
+        const raw = readFileSync(path, 'utf8');
+        if (!raw.trim())
+            return {};
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** 写入缓存文件；失败静默（不阻断会话）。 */
+function writeCache(cache) {
+    try {
+        mkdirSync(join(homedir(), '.ccli'), { recursive: true });
+        writeFileSync(cacheFile(), JSON.stringify(cache, null, 2) + '\n', 'utf8');
+    }
+    catch {
+        // 缓存写入失败不抛错，下次直接联网拉取即可
+    }
+}
+/** 判断缓存条目是否在有效期内。 */
+function isFresh(entry, ttlMs) {
+    if (!entry || !entry.cachedAt || !Array.isArray(entry.models)) {
+        return false;
+    }
+    try {
+        const cachedAt = new Date(entry.cachedAt).getTime();
+        return Number.isFinite(cachedAt) && Date.now() - cachedAt <= ttlMs;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 获取模型列表：优先读缓存，未命中/过期/刷新时调 AIClient.listModels() 并落盘。
+ *
+ * @param ai 当前 AI 客户端
+ * @param config provider 与 baseURL（来自 config）
+ * @param options refresh 强制刷新；ttlMs 自定义有效期
+ * @returns 模型 ID 列表
+ */
+export async function getCachedModels(ai, config, options = {}) {
+    const key = cacheKey(config.provider, config.baseURL);
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    const cache = readCache();
+    const entry = cache[key];
+    if (!options.refresh && isFresh(entry, ttlMs)) {
+        return entry.models;
+    }
+    const models = await ai.listModels();
+    cache[key] = { cachedAt: new Date().toISOString(), models };
+    writeCache(cache);
+    return models;
+}
+/**
+ * 强制清空模型缓存。
+ * - 不传参数：清空全部 provider。
+ * - 传 provider（和可选 baseURL）：只清空对应桶。
+ */
+export function clearModelCache(provider, baseURL) {
+    if (!provider) {
+        writeCache({});
+        return;
+    }
+    const cache = readCache();
+    delete cache[cacheKey(provider, baseURL)];
+    writeCache(cache);
+}
+//# sourceMappingURL=model-catalog.js.map

package/dist/agent/model-catalog.js.map

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

package/dist/agent/os.js

@@ -1,4 +1,4 @@
-import { spawn as childSpawn } from 'node:child_process';
+import childProcess from 'node:child_process';
 import { promises as fsPromises, existsSync } from 'node:fs';
 import { resolve as pathResolve, dirname as pathDirname, relative as pathRelative, join as pathJoin, sep as pathSep } from 'node:path';
 export class LocalOS {
@@ -59,11 +59,300 @@ export class LocalOS {
         return process.env.SHELL || '/bin/bash';
     }
     async spawn(command, args, options) {
-        const proc = childSpawn(command, args, {
+        const proc = childProcess.spawn(command, args, {
             cwd: options?.cwd,
             env: options?.env ?? process.env
         });
         return proc;
     }
 }
+import { posix } from 'node:path';
+function runDockerCmd(args, stdinInput) {
+    return new Promise((resolve) => {
+        const proc = childProcess.spawn('docker', ['exec', ...args]);
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (data) => {
+            stdout += data.toString('utf8');
+        });
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString('utf8');
+        });
+        proc.on('close', (code) => {
+            resolve({ stdout, stderr, code: code ?? 0 });
+        });
+        proc.on('error', (err) => {
+            resolve({ stdout, stderr: stderr + err.message, code: -1 });
+        });
+        if (stdinInput !== undefined) {
+            proc.stdin.write(stdinInput);
+            proc.stdin.end();
+        }
+    });
+}
+export class DockerOS {
+    container;
+    constructor(container) {
+        this.container = container;
+    }
+    async exists(path) {
+        const { code } = await runDockerCmd([this.container, 'test', '-e', path]);
+        return code === 0;
+    }
+    async isDirectory(path) {
+        const { code } = await runDockerCmd([this.container, 'test', '-d', path]);
+        return code === 0;
+    }
+    async readFile(path, _encoding = 'utf8') {
+        const { stdout, code, stderr } = await runDockerCmd([this.container, 'cat', path]);
+        if (code !== 0) {
+            throw new Error(`Failed to read file ${path} inside docker: ${stderr}`);
+        }
+        return stdout;
+    }
+    async writeFile(path, content, _encoding = 'utf8') {
+        const { code, stderr } = await runDockerCmd(['-i', this.container, 'dd', `of=${path}`], content);
+        if (code !== 0) {
+            throw new Error(`Failed to write file ${path} inside docker: ${stderr}`);
+        }
+    }
+    async mkdir(path, options) {
+        const args = [this.container, 'mkdir'];
+        if (options?.recursive ?? true) {
+            args.push('-p');
+        }
+        args.push(path);
+        const { code, stderr } = await runDockerCmd(args);
+        if (code !== 0) {
+            throw new Error(`Failed to mkdir ${path} inside docker: ${stderr}`);
+        }
+    }
+    async readdir(path) {
+        const { stdout, code, stderr } = await runDockerCmd([this.container, 'ls', '-A', '-1', '-p', path]);
+        if (code !== 0) {
+            throw new Error(`Failed to readdir ${path} inside docker: ${stderr}`);
+        }
+        const lines = stdout.split('\n').map(l => l.trim()).filter(Boolean);
+        return lines.map(line => {
+            const isDir = line.endsWith('/');
+            const name = isDir ? line.slice(0, -1) : line;
+            return {
+                name,
+                isDirectory: () => isDir
+            };
+        });
+    }
+    async stat(path) {
+        const sizeRes = await runDockerCmd([this.container, 'stat', '-c', '%s', path]);
+        if (sizeRes.code !== 0) {
+            throw new Error(`Failed to stat ${path} inside docker: ${sizeRes.stderr}`);
+        }
+        const size = parseInt(sizeRes.stdout.trim(), 10);
+        const isDir = await this.isDirectory(path);
+        return {
+            size: isNaN(size) ? 0 : size,
+            isDirectory: () => isDir
+        };
+    }
+    async unlink(path) {
+        const { code, stderr } = await runDockerCmd([this.container, 'rm', '-f', path]);
+        if (code !== 0) {
+            throw new Error(`Failed to unlink ${path} inside docker: ${stderr}`);
+        }
+    }
+    resolve(...paths) {
+        return posix.resolve(...paths);
+    }
+    dirname(path) {
+        return posix.dirname(path);
+    }
+    relative(from, to) {
+        return posix.relative(from, to);
+    }
+    join(...paths) {
+        return posix.join(...paths);
+    }
+    get sep() {
+        return '/';
+    }
+    get defaultShell() {
+        return '/bin/sh';
+    }
+    async spawn(command, args, options) {
+        const dockerArgs = ['exec'];
+        if (options?.cwd) {
+            dockerArgs.push('-w', options.cwd);
+        }
+        if (options?.env) {
+            for (const [k, v] of Object.entries(options.env)) {
+                if (v !== undefined) {
+                    dockerArgs.push('-e', `${k}=${v}`);
+                }
+            }
+        }
+        dockerArgs.push(this.container, command, ...args);
+        const proc = childProcess.spawn('docker', dockerArgs);
+        return proc;
+    }
+}
+export function parseSshUrl(url) {
+    const cleaned = url.startsWith('ssh://') ? url.slice(6) : url;
+    const atIdx = cleaned.indexOf('@');
+    if (atIdx === -1) {
+        throw new Error(`Invalid SSH URL: ${url}. Missing 'user@host' format.`);
+    }
+    const user = cleaned.slice(0, atIdx);
+    const remaining = cleaned.slice(atIdx + 1);
+    const colonIdx = remaining.lastIndexOf(':');
+    if (colonIdx === -1) {
+        return { user, host: remaining };
+    }
+    const host = remaining.slice(0, colonIdx);
+    const portStr = remaining.slice(colonIdx + 1);
+    const port = parseInt(portStr, 10);
+    if (isNaN(port)) {
+        return { user, host };
+    }
+    return { user, host, port };
+}
+function escapeShellArg(arg) {
+    return `'` + arg.replace(/'/g, `'"'"`) + `'`;
+}
+function runSshCmd(sshConfig, remoteCmd, stdinInput) {
+    return new Promise((resolve) => {
+        const sshArgs = [];
+        if (sshConfig.port !== undefined) {
+            sshArgs.push('-p', String(sshConfig.port));
+        }
+        sshArgs.push('-T', `${sshConfig.user}@${sshConfig.host}`, remoteCmd);
+        const proc = childProcess.spawn('ssh', sshArgs);
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (data) => {
+            stdout += data.toString('utf8');
+        });
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString('utf8');
+        });
+        proc.on('close', (code) => {
+            resolve({ stdout, stderr, code: code ?? 0 });
+        });
+        proc.on('error', (err) => {
+            resolve({ stdout, stderr: stderr + err.message, code: -1 });
+        });
+        if (stdinInput !== undefined) {
+            proc.stdin.write(stdinInput);
+            proc.stdin.end();
+        }
+    });
+}
+export class SshOS {
+    url;
+    sshConfig;
+    constructor(url) {
+        this.url = url;
+        this.sshConfig = parseSshUrl(url);
+    }
+    async exists(path) {
+        const { code } = await runSshCmd(this.sshConfig, `test -e ${escapeShellArg(path)}`);
+        return code === 0;
+    }
+    async isDirectory(path) {
+        const { code } = await runSshCmd(this.sshConfig, `test -d ${escapeShellArg(path)}`);
+        return code === 0;
+    }
+    async readFile(path, _encoding = 'utf8') {
+        const { stdout, code, stderr } = await runSshCmd(this.sshConfig, `cat ${escapeShellArg(path)}`);
+        if (code !== 0) {
+            throw new Error(`Failed to read file ${path} via SSH: ${stderr}`);
+        }
+        return stdout;
+    }
+    async writeFile(path, content, _encoding = 'utf8') {
+        const { code, stderr } = await runSshCmd(this.sshConfig, `dd of=${escapeShellArg(path)}`, content);
+        if (code !== 0) {
+            throw new Error(`Failed to write file ${path} via SSH: ${stderr}`);
+        }
+    }
+    async mkdir(path, options) {
+        const { code, stderr } = await runSshCmd(this.sshConfig, `mkdir ${options?.recursive ?? true ? '-p' : ''} ${escapeShellArg(path)}`);
+        if (code !== 0) {
+            throw new Error(`Failed to mkdir ${path} via SSH: ${stderr}`);
+        }
+    }
+    async readdir(path) {
+        const { stdout, code, stderr } = await runSshCmd(this.sshConfig, `ls -A -1 -p ${escapeShellArg(path)}`);
+        if (code !== 0) {
+            throw new Error(`Failed to readdir ${path} via SSH: ${stderr}`);
+        }
+        const lines = stdout.split('\n').map(l => l.trim()).filter(Boolean);
+        return lines.map(line => {
+            const isDir = line.endsWith('/');
+            const name = isDir ? line.slice(0, -1) : line;
+            return {
+                name,
+                isDirectory: () => isDir
+            };
+        });
+    }
+    async stat(path) {
+        const sizeRes = await runSshCmd(this.sshConfig, `stat -c "%s" ${escapeShellArg(path)}`);
+        if (sizeRes.code !== 0) {
+            throw new Error(`Failed to stat ${path} via SSH: ${sizeRes.stderr}`);
+        }
+        const size = parseInt(sizeRes.stdout.trim(), 10);
+        const isDir = await this.isDirectory(path);
+        return {
+            size: isNaN(size) ? 0 : size,
+            isDirectory: () => isDir
+        };
+    }
+    async unlink(path) {
+        const { code, stderr } = await runSshCmd(this.sshConfig, `rm -f ${escapeShellArg(path)}`);
+        if (code !== 0) {
+            throw new Error(`Failed to unlink ${path} via SSH: ${stderr}`);
+        }
+    }
+    resolve(...paths) {
+        return posix.resolve(...paths);
+    }
+    dirname(path) {
+        return posix.dirname(path);
+    }
+    relative(from, to) {
+        return posix.relative(from, to);
+    }
+    join(...paths) {
+        return posix.join(...paths);
+    }
+    get sep() {
+        return '/';
+    }
+    get defaultShell() {
+        return '/bin/sh';
+    }
+    async spawn(command, args, options) {
+        const sshArgs = [];
+        if (this.sshConfig.port !== undefined) {
+            sshArgs.push('-p', String(this.sshConfig.port));
+        }
+        sshArgs.push('-t', `${this.sshConfig.user}@${this.sshConfig.host}`);
+        let envPrefix = '';
+        if (options?.env) {
+            for (const [k, v] of Object.entries(options.env)) {
+                if (v !== undefined) {
+                    envPrefix += `export ${k}=${escapeShellArg(v)} && `;
+                }
+            }
+        }
+        let remoteCmd = '';
+        if (options?.cwd) {
+            remoteCmd += `cd ${escapeShellArg(options.cwd)} && `;
+        }
+        remoteCmd += `${command} ${args.map(escapeShellArg).join(' ')}`;
+        sshArgs.push(envPrefix + remoteCmd);
+        const proc = childProcess.spawn('ssh', sshArgs);
+        return proc;
+    }
+}
 //# sourceMappingURL=os.js.map

package/dist/agent/os.js.map

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

package/dist/agent/providers/anthropic.js

@@ -4,6 +4,7 @@ import { projectToolPairedMessages } from '../tool-projection.js';
 export class AnthropicClient {
     client;
     model;
+    promptCache;
     /** 保存 Anthropic SDK 实例；baseURL 仅在用户配置代理或兼容网关时生效。 */
     constructor(config) {
         this.client = new Anthropic({
@@ -11,6 +12,9 @@ export class AnthropicClient {
             baseURL: config.baseURL,
         });
         this.model = config.model;
+        // Anthropic Prompt Cache 默认开启；Claude 2 / instant 等老模型不支持，关闭
+        this.promptCache =
+            config.promptCache ?? !/claude-2|claude-instant/i.test(config.model);
     }
     /** 返回当前 Claude 模型名，保持与 OpenAIClient 的统一接口。 */
     getModel() {
@@ -46,7 +50,7 @@ export class AnthropicClient {
      * 再把流式事件重新聚合成 CCLI 内部统一的 AssistantTurn。
      */
     async chat(messages, onDelta, options, onReasoning, onToolArgumentDelta) {
-        const { system, messages: anthropicMessages } = toAnthropicMessages(messages);
+        const { system, messages: anthropicMessages } = toAnthropicMessages(messages, this.promptCache);
         const tools = toAnthropicTools(options?.allowedTools);
         const stream = await this.client.messages.create({
             model: this.model,
@@ -69,11 +73,16 @@ export class AnthropicClient {
         // Anthropic 流式协议：input_tokens 只出现在 message_start 事件，
         // message_delta 只带 output_tokens——两处都要读才能拼出完整 usage。
         let inputTokens = 0;
+        let cacheCreationTokens = 0;
+        let cacheReadTokens = 0;
         for await (const event of stream) {
             if (event.type === 'message_start') {
                 const u = event.message?.usage;
-                if (u)
+                if (u) {
                     inputTokens = u.input_tokens ?? 0;
+                    cacheCreationTokens = u.cache_creation_input_tokens ?? 0;
+                    cacheReadTokens = u.cache_read_input_tokens ?? 0;
+                }
             }
             else if (event.type === 'content_block_delta') {
                 if (event.delta.type === 'text_delta') {
@@ -112,6 +121,12 @@ export class AnthropicClient {
                         completionTokens,
                         totalTokens: promptTokens + completionTokens,
                     };
+                    if (cacheCreationTokens > 0) {
+                        usage.cacheCreationTokens = cacheCreationTokens;
+                    }
+                    if (cacheReadTokens > 0) {
+                        usage.cacheReadTokens = cacheReadTokens;
+                    }
                 }
             }
         }
@@ -128,7 +143,7 @@ export class AnthropicClient {
  * Anthropic 不接受 `role:"system"` 混在 messages 里，也要求 tool_result 作为 user
  * 内容块出现，所以这里集中做一次协议投影，避免业务层到处写 provider 分支。
  */
-export function toAnthropicMessages(messages) {
+export function toAnthropicMessages(messages, promptCache = false) {
     const projectedMessages = projectToolPairedMessages(messages);
     const systemParts = [];
     const anthropicMessages = [];
@@ -213,7 +228,100 @@ export function toAnthropicMessages(messages) {
             }
         }
     }
-    return { system: systemParts.join('\n\n'), messages: anthropicMessages };
+    // system prompt：开启缓存时转成 block 数组并在最后一个 block 上标记 cache_control
+    const joinedSystem = systemParts.join('\n\n');
+    const system = promptCache && systemParts.length > 0
+        ? systemParts.map((text, i) => ({
+            type: 'text',
+            text,
+            ...(i === systemParts.length - 1
+                ? { cache_control: { type: 'ephemeral' } }
+                : {}),
+        }))
+        : joinedSystem;
+    // 给历史上下文里较长且非最后的 user 消息加 cache_control。
+    // Anthropic 限制整段请求最多 4 个 cache_control 标记；system 已用 1 个，
+    // 剩余预算留给长 user 消息（通常是最划算的回退点）。
+    const userIndices = [];
+    for (let i = 0; i < anthropicMessages.length; i++) {
+        if (anthropicMessages[i].role === 'user') {
+            userIndices.push(i);
+        }
+    }
+    const systemCacheCount = promptCache && systemParts.length > 0 ? 1 : 0;
+    const remainingCacheBudget = 4 - systemCacheCount;
+    let applied = 0;
+    for (let ui = 0; ui < userIndices.length && applied < remainingCacheBudget; ui++) {
+        // 当前用户输入是最后一条 user 消息，不需要缓存
+        if (ui === userIndices.length - 1)
+            continue;
+        const idx = userIndices[ui];
+        const msg = anthropicMessages[idx];
+        const textLength = estimateUserMessageTextLength(msg.content);
+        if (textLength <= 1024)
+            continue;
+        const content = msg.content;
+        if (typeof content === 'string') {
+            anthropicMessages[idx] = {
+                role: 'user',
+                content: [
+                    {
+                        type: 'text',
+                        text: content,
+                        cache_control: { type: 'ephemeral' },
+                    },
+                ],
+            };
+        }
+        else if (Array.isArray(content)) {
+            const lastTextIdx = content.findLastIndex((b) => b.type === 'text');
+            if (lastTextIdx >= 0) {
+                const newContent = content.slice();
+                const block = content[lastTextIdx];
+                newContent[lastTextIdx] = {
+                    type: 'text',
+                    text: block.text,
+                    cache_control: { type: 'ephemeral' },
+                };
+                anthropicMessages[idx] = {
+                    role: 'user',
+                    content: newContent,
+                };
+            }
+        }
+        applied++;
+    }
+    return { system, messages: anthropicMessages };
+}
+/** 估算 user 消息里的文本长度，用于决定是否值得加 cache_control。 */
+function estimateUserMessageTextLength(content) {
+    if (typeof content === 'string')
+        return content.length;
+    let length = 0;
+    for (const block of content) {
+        if (block.type === 'text') {
+            length += block.text.length;
+        }
+        else if (block.type === 'tool_result') {
+            const c = block.content;
+            if (typeof c === 'string') {
+                length += c.length;
+            }
+            else if (Array.isArray(c)) {
+                for (const inner of c) {
+                    if (typeof inner === 'object' &&
+                        inner &&
+                        inner.type === 'text') {
+                        length += inner.text?.length ?? 0;
+                    }
+                    else if (typeof inner === 'string') {
+                        length += inner.length;
+                    }
+                }
+            }
+        }
+    }
+    return length;
 }
 /** 把内部工具定义转成 Anthropic 的 tool 格式。
  *  传 allowedNames 时只转换这些工具（与 OpenAI 路径一致）。 */