@gird/ccli 2.15.0 → 2.18.0

package/dist/agent/providers/anthropic.js

@@ -0,0 +1,258 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { toolDefs } from '../../tools/index.js';
+import { projectToolPairedMessages } from '../tool-projection.js';
+export class AnthropicClient {
+    client;
+    model;
+    /** 保存 Anthropic SDK 实例；baseURL 仅在用户配置代理或兼容网关时生效。 */
+    constructor(config) {
+        this.client = new Anthropic({
+            apiKey: config.apiKey,
+            baseURL: config.baseURL,
+        });
+        this.model = config.model;
+    }
+    /** 返回当前 Claude 模型名，保持与 OpenAIClient 的统一接口。 */
+    getModel() {
+        return this.model;
+    }
+    /** 只更新后续请求使用的模型名，不影响已存在的历史消息。 */
+    setModel(model) {
+        this.model = model;
+    }
+    /** Claude 3 及以后全系支持图像；老的 claude-2 / instant 不支持。 */
+    supportsVision() {
+        return !/claude-2|claude-instant/i.test(this.model);
+    }
+    /**
+     * Anthropic SDK 没有稳定的模型列表接口，返回常用模型。
+     * 用户仍可用 /model <完整名> 切换到列表外的模型。
+     */
+    async listModels() {
+        return [
+            'claude-opus-4-5-20251101',
+            'claude-sonnet-4-5-20251101',
+            'claude-sonnet-4-5-20241022',
+            'claude-3-5-sonnet-20241022',
+            'claude-3-opus-20240229',
+            'claude-3-sonnet-20240229',
+            'claude-3-haiku-20240307',
+        ].sort();
+    }
+    /**
+     * 发送 Anthropic Messages 流式请求。
+     *
+     * 这里会先把 OpenAI 风格历史转换成 Anthropic 的 system/messages/tool_use 结构，
+     * 再把流式事件重新聚合成 CCLI 内部统一的 AssistantTurn。
+     */
+    async chat(messages, onDelta, options, onReasoning, onToolArgumentDelta) {
+        const { system, messages: anthropicMessages } = toAnthropicMessages(messages);
+        const tools = toAnthropicTools(options?.allowedTools);
+        const stream = await this.client.messages.create({
+            model: this.model,
+            max_tokens: 4096,
+            system,
+            messages: anthropicMessages,
+            stream: true,
+            ...(options?.disableTools
+                ? {}
+                : {
+                    tools,
+                    ...(options?.requireTools
+                        ? { tool_choice: { type: 'any' } }
+                        : {}),
+                }),
+        });
+        let content = '';
+        const acc = {};
+        let usage;
+        // Anthropic 流式协议：input_tokens 只出现在 message_start 事件，
+        // message_delta 只带 output_tokens——两处都要读才能拼出完整 usage。
+        let inputTokens = 0;
+        for await (const event of stream) {
+            if (event.type === 'message_start') {
+                const u = event.message?.usage;
+                if (u)
+                    inputTokens = u.input_tokens ?? 0;
+            }
+            else if (event.type === 'content_block_delta') {
+                if (event.delta.type === 'text_delta') {
+                    content += event.delta.text;
+                    onDelta(event.delta.text);
+                }
+                else if (event.delta.type === 'thinking_delta') {
+                    onReasoning?.(event.delta.thinking);
+                }
+                else if (event.delta.type === 'input_json_delta') {
+                    const tc = acc[event.index];
+                    if (tc) {
+                        tc.arguments += event.delta.partial_json;
+                        if (tc.name) {
+                            onToolArgumentDelta?.(event.index, tc.name, tc.arguments);
+                        }
+                    }
+                }
+            }
+            else if (event.type === 'content_block_start') {
+                if (event.content_block.type === 'tool_use') {
+                    acc[event.index] = {
+                        id: event.content_block.id,
+                        name: event.content_block.name,
+                        arguments: '',
+                    };
+                }
+            }
+            else if (event.type === 'message_delta') {
+                const u = event.usage;
+                if (u) {
+                    const promptTokens = inputTokens || (u.input_tokens ?? 0);
+                    const completionTokens = u.output_tokens ?? 0;
+                    usage = {
+                        promptTokens,
+                        completionTokens,
+                        totalTokens: promptTokens + completionTokens,
+                    };
+                }
+            }
+        }
+        const toolCalls = Object.keys(acc)
+            .map(Number)
+            .sort((a, b) => a - b)
+            .map((i) => acc[i]);
+        return { content, toolCalls, usage };
+    }
+}
+/**
+ * 把 OpenAI 风格的消息列表转成 Anthropic 的 system + messages。
+ *
+ * Anthropic 不接受 `role:"system"` 混在 messages 里，也要求 tool_result 作为 user
+ * 内容块出现，所以这里集中做一次协议投影，避免业务层到处写 provider 分支。
+ */
+export function toAnthropicMessages(messages) {
+    const projectedMessages = projectToolPairedMessages(messages);
+    const systemParts = [];
+    const anthropicMessages = [];
+    const pendingToolUseIds = [];
+    for (const m of projectedMessages) {
+        if (m.role === 'system') {
+            if (typeof m.content === 'string') {
+                systemParts.push(m.content);
+            }
+            continue;
+        }
+        if (m.role === 'tool') {
+            // Anthropic 的 tool_result 必须放在 user 消息里
+            const toolCallId = m.tool_call_id ?? '';
+            if (!pendingToolUseIds.includes(toolCallId)) {
+                continue;
+            }
+            const resultText = typeof m.content === 'string' ? m.content : JSON.stringify(m.content);
+            anthropicMessages.push({
+                role: 'user',
+                content: [
+                    {
+                        type: 'tool_result',
+                        tool_use_id: toolCallId,
+                        content: resultText,
+                    },
+                ],
+            });
+            pendingToolUseIds.splice(pendingToolUseIds.indexOf(toolCallId), 1);
+            continue;
+        }
+        if (m.role === 'assistant') {
+            const content = [];
+            if (typeof m.content === 'string' && m.content) {
+                content.push({ type: 'text', text: m.content });
+            }
+            const toolCalls = m.tool_calls;
+            if (Array.isArray(toolCalls)) {
+                for (const tc of toolCalls) {
+                    if (!tc?.id || !tc?.function?.name) {
+                        continue;
+                    }
+                    content.push({
+                        type: 'tool_use',
+                        id: tc.id,
+                        name: tc.function?.name ?? '',
+                        input: safeParse(tc.function?.arguments ?? '{}'),
+                    });
+                    pendingToolUseIds.push(tc.id);
+                }
+            }
+            anthropicMessages.push({ role: 'assistant', content });
+            continue;
+        }
+        if (m.role === 'user') {
+            if (typeof m.content === 'string') {
+                anthropicMessages.push({ role: 'user', content: m.content });
+            }
+            else if (Array.isArray(m.content)) {
+                // 多模态：把 OpenAI 风格的 text / image_url 片段翻译成 Anthropic block
+                const blocks = [];
+                for (const part of m.content) {
+                    if (part?.type === 'text') {
+                        blocks.push({ type: 'text', text: part.text });
+                    }
+                    else if (part?.type === 'image_url') {
+                        const img = dataUrlToImageBlock(part.image_url?.url);
+                        if (img)
+                            blocks.push(img);
+                    }
+                }
+                anthropicMessages.push({
+                    role: 'user',
+                    content: blocks.length > 0 ? blocks : '',
+                });
+            }
+            else {
+                anthropicMessages.push({
+                    role: 'user',
+                    content: JSON.stringify(m.content),
+                });
+            }
+        }
+    }
+    return { system: systemParts.join('\n\n'), messages: anthropicMessages };
+}
+/** 把内部工具定义转成 Anthropic 的 tool 格式。
+ *  传 allowedNames 时只转换这些工具（与 OpenAI 路径一致）。 */
+export function toAnthropicTools(allowedNames) {
+    return toolDefs(allowedNames).map((t) => ({
+        name: t.function.name,
+        description: t.function.description,
+        input_schema: {
+            type: 'object',
+            ...t.function.parameters,
+        },
+    }));
+}
+/**
+ * 把 `data:<mime>;base64,<data>` 解析成 Anthropic 的 base64 image block。
+ * 非 data URL 或格式不符时返回 null（跳过该图，不阻断整段请求）。
+ */
+function dataUrlToImageBlock(url) {
+    if (typeof url !== 'string')
+        return null;
+    const m = /^data:([^;]+);base64,(.+)$/s.exec(url);
+    if (!m)
+        return null;
+    return {
+        type: 'image',
+        source: {
+            type: 'base64',
+            media_type: m[1],
+            data: m[2],
+        },
+    };
+}
+/** 解析模型给出的工具参数；失败时回落为空对象，避免坏 JSON 破坏整段 Anthropic 请求。 */
+function safeParse(json) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/agent/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/agent/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAShD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,OAAO,eAAe;IAChB,MAAM,CAAY;IAClB,KAAK,CAAS;IAEtB,oDAAoD;IACpD,YAAY,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC;YACxB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,8CAA8C;IAC9C,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,iCAAiC;IACjC,QAAQ,CAAC,KAAa;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,oDAAoD;IACpD,cAAc;QACV,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACZ,OAAO;YACH,0BAA0B;YAC1B,4BAA4B;YAC5B,4BAA4B;YAC5B,4BAA4B;YAC5B,wBAAwB;YACxB,0BAA0B;YAC1B,yBAAyB;SAC5B,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CACN,QAAuB,EACvB,OAA+B,EAC/B,OAAqB,EACrB,WAAoC,EACpC,mBAIS;QAET,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI;YAChB,MAAM;YACN,QAAQ,EAAE,iBAAiB;YAC3B,MAAM,EAAE,IAAI;YACZ,GAAG,CAAC,OAAO,EAAE,YAAY;gBACrB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACI,KAAK;oBACL,GAAG,CAAC,OAAO,EAAE,YAAY;wBACrB,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAW,EAAE;wBAC3C,CAAC,CAAC,EAAE,CAAC;iBACZ,CAAC;SACX,CAAC,CAAC;QAEH,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,MAAM,GAAG,GAA6B,EAAE,CAAC;QACzC,IAAI,KAAwB,CAAC;QAC7B,qDAAqD;QACrD,qDAAqD;QACrD,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACjC,MAAM,CAAC,GAAI,KAAa,CAAC,OAAO,EAAE,KAAK,CAAC;gBACxC,IAAI,CAAC;oBAAE,WAAW,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;YAC7C,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAC9C,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACpC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;oBAC5B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9B,CAAC;qBAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;oBAC/C,WAAW,EAAE,CAAE,KAAK,CAAC,KAAa,CAAC,QAAQ,CAAC,CAAC;gBACjD,CAAC;qBAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;oBACjD,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC5B,IAAI,EAAE,EAAE,CAAC;wBACL,EAAE,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC;wBACzC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;4BACV,mBAAmB,EAAE,CACjB,KAAK,CAAC,KAAK,EACX,EAAE,CAAC,IAAI,EACP,EAAE,CAAC,SAAS,CACf,CAAC;wBACN,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAC9C,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC1C,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG;wBACf,EAAE,EAAE,KAAK,CAAC,aAAa,CAAC,EAAE;wBAC1B,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI;wBAC9B,SAAS,EAAE,EAAE;qBAChB,CAAC;gBACN,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACxC,MAAM,CAAC,GAAI,KAAa,CAAC,KAAK,CAAC;gBAC/B,IAAI,CAAC,EAAE,CAAC;oBACJ,MAAM,YAAY,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;oBAC1D,MAAM,gBAAgB,GAAG,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC;oBAC9C,KAAK,GAAG;wBACJ,YAAY;wBACZ,gBAAgB;wBAChB,WAAW,EAAE,YAAY,GAAG,gBAAgB;qBAC/C,CAAC;gBACN,CAAC;YACL,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aAC7B,GAAG,CAAC,MAAM,CAAC;aACX,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;aACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAuB;IAIvD,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,iBAAiB,GAAsC,EAAE,CAAC;IAChE,MAAM,iBAAiB,GAAa,EAAE,CAAC;IAEvC,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;YACD,SAAS;QACb,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,wCAAwC;YACxC,MAAM,UAAU,GAAI,CAAS,CAAC,YAAY,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC1C,SAAS;YACb,CAAC;YACD,MAAM,UAAU,GACZ,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC1E,iBAAiB,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,aAAa;wBACnB,WAAW,EAAE,UAAU;wBACvB,OAAO,EAAE,UAAU;qBACqB;iBAC/C;aACJ,CAAC,CAAC;YACH,iBAAiB,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;YACnE,SAAS;QACb,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,MAAM,OAAO,GAA2C,EAAE,CAAC;YAC3D,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;YAED,MAAM,SAAS,GAAI,CAAS,CAAC,UAAU,CAAC;YACxC,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;oBACzB,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;wBACjC,SAAS;oBACb,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,UAAU;wBAChB,EAAE,EAAE,EAAE,CAAC,EAAE;wBACT,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE;wBAC7B,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,IAAI,IAAI,CAAC;qBACX,CAAC,CAAC;oBAC3C,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAClC,CAAC;YACL,CAAC;YAED,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,SAAS;QACb,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,0DAA0D;gBAC1D,MAAM,MAAM,GAA2C,EAAE,CAAC;gBAC1D,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,OAAgB,EAAE,CAAC;oBACpC,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;wBACxB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;oBACnD,CAAC;yBAAM,IAAI,IAAI,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;wBACpC,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;wBACrD,IAAI,GAAG;4BAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC9B,CAAC;gBACL,CAAC;gBACD,iBAAiB,CAAC,IAAI,CAAC;oBACnB,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;iBAC3C,CAAC,CAAC;YACP,CAAC;iBAAM,CAAC;gBACJ,iBAAiB,CAAC,IAAI,CAAC;oBACnB,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;iBACrC,CAAC,CAAC;YACP,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;AAC7E,CAAC;AAED;8CAC8C;AAC9C,MAAM,UAAU,gBAAgB,CAC5B,YAAuB;IAEvB,OAAO,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;QACrB,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW;QACnC,YAAY,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU;SAC3B;KACJ,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CACxB,GAAY;IAEZ,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO;QACH,IAAI,EAAE,OAAO;QACb,MAAM,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,CAAC,CAAC,CAAC,CAAuD;YACtE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SACb;KACJ,CAAC;AACN,CAAC;AAED,wDAAwD;AACxD,SAAS,SAAS,CAAC,IAAY;IAC3B,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC"}

package/dist/agent/providers/gemini.js

@@ -0,0 +1,14 @@
+import { OpenAIClient } from './openai.js';
+/** Gemini 的 OpenAI 兼容端点（config.baseURL 未配置时的默认指向）。 */
+export const DEFAULT_GEMINI_BASE_URL = 'https://generativelanguage.googleapis.com/v1beta/openai/';
+/**
+ * Gemini 后端：走 Google 的 OpenAI 兼容协议，请求/流式聚合逻辑与
+ * OpenAIClient 完全一致，因此直接继承，只改默认 baseURL。
+ * （此前是 70 行逐字复制的 chat 循环，两处分叉风险已被继承结构消除。）
+ */
+export class GeminiClient extends OpenAIClient {
+    constructor(config) {
+        super({ ...config, baseURL: config.baseURL || DEFAULT_GEMINI_BASE_URL });
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/agent/providers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../src/agent/providers/gemini.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,sDAAsD;AACtD,MAAM,CAAC,MAAM,uBAAuB,GAChC,0DAA0D,CAAC;AAE/D;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,YAAY;IAC1C,YAAY,MAAc;QACtB,KAAK,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,uBAAuB,EAAE,CAAC,CAAC;IAC7E,CAAC;CACJ"}

package/dist/agent/providers/openai.js

@@ -0,0 +1,110 @@
+import OpenAI from 'openai';
+import { toolDefs } from '../../tools/index.js';
+import { projectToolPairedMessages } from '../tool-projection.js';
+export class OpenAIClient {
+    client;
+    model;
+    /** 保存 OpenAI 兼容 SDK 实例；baseURL 可指向 Qwen / DeepSeek / GLM 等兼容服务。 */
+    constructor(config) {
+        this.client = new OpenAI({
+            apiKey: config.apiKey,
+            baseURL: config.baseURL,
+        });
+        this.model = config.model;
+    }
+    /** 当前模型名只存在本地，真正请求时才写入 body.model。 */
+    getModel() {
+        return this.model;
+    }
+    /** 切换模型时不清空模型列表缓存，因为同一后端的模型列表不随选择变化。 */
+    setModel(model) {
+        this.model = model;
+    }
+    /**
+     * 按模型名启发式判断是否支持图像输入。OpenAI 兼容后端型号繁杂，没有统一的
+     * capability 接口，只能靠常见命名规律匹配（qwen-vl / *-vision / gpt-4o /
+     * gemini / *-4v / omni 等）。宁可漏判降级为文字，也不误判导致后端报错。
+     */
+    supportsVision() {
+        return /vl|vision|4o|omni|4v|gemini|internvl|llava|pixtral|claude/i.test(this.model);
+    }
+    /** 拉取后端可用模型列表（结果缓存，避免重复请求）。 */
+    modelCache;
+    async listModels() {
+        if (!this.modelCache) {
+            const list = await this.client.models.list();
+            this.modelCache = list.data.map((m) => m.id).sort();
+        }
+        return this.modelCache;
+    }
+    /**
+     * 发送整段对话历史，流式接收助手回复。
+     * @param messages 完整历史（含本轮 user 消息、以及可能的工具结果）
+     * @param onDelta 每收到一小段文本就回调（用于实时打印）
+     * @returns 助手本回合的文本 + 它想调用的工具
+     */
+    async chat(messages, onDelta, options, onReasoning, onToolArgumentDelta) {
+        const body = {
+            model: this.model,
+            messages: projectToolPairedMessages(messages),
+            stream: true,
+            stream_options: { include_usage: true },
+        };
+        if (!options?.disableTools) {
+            body.tools = toolDefs(options?.allowedTools);
+            if (options?.requireTools) {
+                body.tool_choice = 'required';
+            }
+        }
+        const stream = (await this.client.chat.completions.create(body));
+        let content = '';
+        // 工具调用在流里是分片到达的，按 index 累加拼回完整的 id/name/arguments
+        const acc = {};
+        let usage;
+        for await (const chunk of stream) {
+            const delta = chunk.choices[0]?.delta;
+            if (!delta) {
+                // OpenAI 流式 usage 通常在 choices 为空的最终 chunk 里
+                const u = chunk.usage;
+                if (u) {
+                    usage = {
+                        promptTokens: u.prompt_tokens ?? 0,
+                        completionTokens: u.completion_tokens ?? 0,
+                        totalTokens: u.total_tokens ?? 0,
+                    };
+                }
+                continue;
+            }
+            const reasoning = delta.reasoning_content;
+            if (reasoning)
+                onReasoning?.(reasoning);
+            if (delta.content) {
+                content += delta.content;
+                onDelta(delta.content);
+            }
+            for (const tc of delta.tool_calls ?? []) {
+                const cur = (acc[tc.index] ??= {
+                    id: '',
+                    name: '',
+                    arguments: '',
+                });
+                if (tc.id)
+                    cur.id = tc.id;
+                if (tc.function?.name)
+                    cur.name = tc.function.name;
+                if (tc.function?.arguments) {
+                    cur.arguments += tc.function.arguments;
+                    if (cur.name) {
+                        onToolArgumentDelta?.(tc.index, cur.name, cur.arguments);
+                    }
+                }
+            }
+        }
+        const toolCalls = Object.keys(acc)
+            .map(Number)
+            .sort((a, b) => a - b)
+            .map((i) => acc[i]);
+        return { content, toolCalls, usage };
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/agent/providers/openai.js.map

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

package/dist/agent/tool-projection.js

@@ -0,0 +1,57 @@
+/**
+ * 严格投影工具消息：只保留「assistant.tool_calls 后紧跟对应 tool 结果」
+ * 的完整配对，丢弃孤儿 tool 结果与未完成的 tool_calls，避免 provider
+ * 因 tool_use / tool_result 不配对拒绝整段上下文。
+ */
+export function projectToolPairedMessages(messages) {
+    const projected = [];
+    const pendingToolCallIds = [];
+    for (let i = 0; i < messages.length; i++) {
+        const m = messages[i];
+        if (m.role === 'tool') {
+            const toolCallId = m.tool_call_id;
+            const pendingIndex = pendingToolCallIds.indexOf(toolCallId);
+            if (pendingIndex < 0)
+                continue;
+            projected.push(m);
+            pendingToolCallIds.splice(pendingIndex, 1);
+            continue;
+        }
+        if (m.role === 'assistant') {
+            const toolCalls = m.tool_calls;
+            if (Array.isArray(toolCalls) && toolCalls.length > 0) {
+                const validToolCallIds = toolCalls
+                    .map((tc) => tc?.id)
+                    .filter((id) => typeof id === 'string' && id.length > 0);
+                const resultIds = collectFollowingToolResultIds(messages, i);
+                if (validToolCallIds.length !== toolCalls.length ||
+                    !validToolCallIds.every((id) => resultIds.has(id))) {
+                    continue;
+                }
+                projected.push(m);
+                pendingToolCallIds.push(...validToolCallIds);
+                continue;
+            }
+        }
+        projected.push(m);
+    }
+    return projected;
+}
+/**
+ * 从某条 assistant.tool_calls 后面连续的 tool 消息里收集结果 id。
+ *
+ * 一旦遇到非 tool 消息就停止，因为 provider 语义要求 tool_result 紧跟对应 tool_use。
+ */
+function collectFollowingToolResultIds(messages, assistantIndex) {
+    const ids = new Set();
+    for (let i = assistantIndex + 1; i < messages.length; i++) {
+        const m = messages[i];
+        if (m.role !== 'tool')
+            break;
+        const id = m.tool_call_id;
+        if (id)
+            ids.add(id);
+    }
+    return ids;
+}
+//# sourceMappingURL=tool-projection.js.map

package/dist/agent/tool-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-projection.js","sourceRoot":"","sources":["../../src/agent/tool-projection.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAuB;IAC7D,MAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IAExC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,UAAU,GAAI,CAAS,CAAC,YAAY,CAAC;YAC3C,MAAM,YAAY,GAAG,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5D,IAAI,YAAY,GAAG,CAAC;gBAAE,SAAS;YAC/B,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,kBAAkB,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;YAC3C,SAAS;QACb,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,MAAM,SAAS,GAAI,CAAS,CAAC,UAAU,CAAC;YACxC,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnD,MAAM,gBAAgB,GAAG,SAAS;qBAC7B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;qBACnB,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC3E,MAAM,SAAS,GAAG,6BAA6B,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBAC7D,IACI,gBAAgB,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;oBAC5C,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EACpD,CAAC;oBACC,SAAS;gBACb,CAAC;gBACD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,kBAAkB,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC;gBAC7C,SAAS;YACb,CAAC;QACL,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,SAAS,6BAA6B,CAClC,QAAuB,EACvB,cAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,cAAc,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM;QAC7B,MAAM,EAAE,GAAI,CAAS,CAAC,YAAY,CAAC;QACnC,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/cli/args/index.js

@@ -10,6 +10,7 @@ export function parseArgs(argv) {
         help: false,
         yes: false,
         noHooks: false,
+        project: false,
         unknown: [],
         positionals: [],
     };
@@ -31,6 +32,9 @@ export function parseArgs(argv) {
             case '--no-hooks':
                 result.noHooks = true;
                 break;
+            case '--project':
+                result.project = true;
+                break;
             case '-r':
             case '--role': {
                 const next = argv[i + 1];

package/dist/cli/args/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/args/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,MAAM,UAAU,SAAS,CAAC,IAAc;IACpC,MAAM,MAAM,GAAe;QACvB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,KAAK;QACX,GAAG,EAAE,KAAK;QACV,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;KAClB,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,QAAQ,GAAG,EAAE,CAAC;YACV,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACZ,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,OAAO;gBACR,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;gBAClB,MAAM;YACV,KAAK,YAAY;gBACb,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACZ,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzB,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;oBACnB,CAAC,EAAE,CAAC;gBACR,CAAC;qBAAM,CAAC;oBACJ,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;gBACD,MAAM;YACV,CAAC;YACD;gBACI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACJ,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjC,CAAC;QACT,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/args/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,MAAM,UAAU,SAAS,CAAC,IAAc;IACpC,MAAM,MAAM,GAAe;QACvB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,KAAK;QACX,GAAG,EAAE,KAAK;QACV,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;KAClB,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,QAAQ,GAAG,EAAE,CAAC;YACV,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACZ,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,OAAO;gBACR,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;gBAClB,MAAM;YACV,KAAK,YAAY;gBACb,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YACV,KAAK,WAAW;gBACZ,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACZ,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzB,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;oBACnB,CAAC,EAAE,CAAC;gBACR,CAAC;qBAAM,CAAC;oBACJ,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;gBACD,MAAM;YACV,CAAC;YACD;gBACI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACJ,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjC,CAAC;QACT,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/cli/clipboard-image.js

@@ -0,0 +1,51 @@
+/**
+ * 从系统剪贴板取图片（Ctrl-V 粘贴图片用）。
+ *
+ * 参考 Kimi Code：终端里 Cmd-V 会被终端 App 截走（程序收不到），所以走
+ * **Ctrl-V**——它能真正传到程序里。这里负责把剪贴板里的图像位图落成一个临时
+ * PNG 文件，交给已有的图片引用管线（`@路径`）发送。
+ *
+ * 目前仅实现 macOS（osascript，系统自带、无需装东西）。其它平台返回不支持，
+ * 后续可补 Linux（wl-paste / xclip）与 Windows（PowerShell）。
+ */
+import { execFileSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { existsSync, statSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+/** osascript：把剪贴板内容按 PNG 写到 outPath；剪贴板无图会非零退出。 */
+function readViaOsascript(outPath) {
+    execFileSync('osascript', [
+        '-e',
+        'set png to (the clipboard as «class PNGf»)',
+        '-e',
+        `set f to open for access POSIX file "${outPath}" with write permission`,
+        '-e',
+        'set eof f to 0',
+        '-e',
+        'write png to f',
+        '-e',
+        'close access f',
+    ], { stdio: ['ignore', 'ignore', 'ignore'], timeout: 5000 });
+}
+/**
+ * 取剪贴板图片，成功时返回落地的临时 PNG 路径。
+ * 剪贴板没有图片、平台不支持或提取失败都返回 `{ ok:false, reason }`。
+ */
+export function readClipboardImage() {
+    if (process.platform !== 'darwin') {
+        return { ok: false, reason: '当前平台暂不支持剪贴板取图（仅 macOS）' };
+    }
+    const outPath = join(tmpdir(), `ccli-paste-${randomUUID()}.png`);
+    try {
+        readViaOsascript(outPath);
+    }
+    catch {
+        return { ok: false, reason: '剪贴板里没有图片' };
+    }
+    if (!existsSync(outPath) || statSync(outPath).size === 0) {
+        return { ok: false, reason: '剪贴板里没有图片' };
+    }
+    return { ok: true, path: outPath };
+}
+//# sourceMappingURL=clipboard-image.js.map

package/dist/cli/clipboard-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-image.js","sourceRoot":"","sources":["../../src/cli/clipboard-image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMjC,mDAAmD;AACnD,SAAS,gBAAgB,CAAC,OAAe;IACrC,YAAY,CACR,WAAW,EACX;QACI,IAAI;QACJ,4CAA4C;QAC5C,IAAI;QACJ,wCAAwC,OAAO,yBAAyB;QACxE,IAAI;QACJ,gBAAgB;QAChB,IAAI;QACJ,gBAAgB;QAChB,IAAI;QACJ,gBAAgB;KACnB,EACD,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAC3D,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAC9B,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IAC3D,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,UAAU,EAAE,MAAM,CAAC,CAAC;IACjE,IAAI,CAAC;QACD,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC"}

package/dist/cli/image-compress.js

@@ -0,0 +1,62 @@
+/**
+ * 发送前给过大的图片降分辨率，省 token / 请求体。
+ *
+ * 背景（实测 qwen-vl-plus）：图片 token 按分辨率算，且服务端对超大图有封顶
+ * （~1M 像素 ≈ 1280 token）。把最长边压到 1024，一张全屏截图能从 ~1259 token
+ * 降到 ~684（省 ~46%），文字基本仍可读；对按面积计费的 Claude/GPT-4o 省得更多。
+ *
+ * 实现走 macOS 自带的 `sips`（零依赖，剪贴板取图本就靠 macOS）。非 macOS 或任何
+ * 失败都**原样透传**——压缩只是优化，绝不能挡住发送。只在最长边超过上限时才降，
+ * 小图一律不动（`sips -Z` 会放大小图，必须先判断）。
+ */
+import { execFileSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { existsSync, statSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+/** 默认最长边上限（px）；超过才降，小图不动。 */
+export const MAX_IMAGE_EDGE = 1024;
+/** 用 sips 读像素宽高；失败返回 null。 */
+function sipsDimensions(path) {
+    try {
+        const out = execFileSync('sips', ['-g', 'pixelWidth', '-g', 'pixelHeight', path], { encoding: 'utf8', timeout: 5000 });
+        const w = /pixelWidth:\s*(\d+)/.exec(out);
+        const h = /pixelHeight:\s*(\d+)/.exec(out);
+        if (!w || !h)
+            return null;
+        return { width: Number(w[1]), height: Number(h[1]) };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 若图片最长边超过 maxEdge，用 sips 等比降到 maxEdge 并输出临时 PNG；
+ * 否则（含非 macOS、读尺寸失败、压缩失败）原样透传。
+ */
+export function compressImageForModel(path, maxEdge = MAX_IMAGE_EDGE) {
+    if (process.platform !== 'darwin')
+        return { path, changed: false };
+    const from = sipsDimensions(path);
+    if (!from)
+        return { path, changed: false };
+    if (Math.max(from.width, from.height) <= maxEdge) {
+        return { path, changed: false };
+    }
+    const out = join(tmpdir(), `ccli-shrink-${randomUUID()}.png`);
+    try {
+        execFileSync('sips', ['-Z', String(maxEdge), path, '--out', out], {
+            stdio: ['ignore', 'ignore', 'ignore'],
+            timeout: 10000,
+        });
+        if (!existsSync(out) || statSync(out).size === 0) {
+            return { path, changed: false };
+        }
+    }
+    catch {
+        return { path, changed: false };
+    }
+    const to = sipsDimensions(out) ?? undefined;
+    return { path: out, changed: true, from, to };
+}
+//# sourceMappingURL=image-compress.js.map

package/dist/cli/image-compress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-compress.js","sourceRoot":"","sources":["../../src/cli/image-compress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAWnC,8BAA8B;AAC9B,SAAS,cAAc,CACnB,IAAY;IAEZ,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CACpB,MAAM,EACN,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,EAC/C,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CACtC,CAAC;QACF,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACjC,IAAY,EACZ,UAAkB,cAAc;IAEhC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACnE,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,IAAI,CAAC;QACD,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;YAC9D,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;YACrC,OAAO,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IAC5C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAClD,CAAC"}