@gird/ccli 1.0.0

package/dist/agent/prompt.js

@@ -0,0 +1,43 @@
+/**
+ * 系统提示词 —— 定义 Agent 的人格、工作流与约束。
+ * 复刻 Claude Code 「AI 软件工程师」的代理型行为。
+ */
+import { renderEnvironment } from '../context/project.js';
+const BASE_PROMPT = `你是 CCLI，一个运行在用户终端中的 AI 软件工程师，是 Claude Code 的开源复刻。
+你不仅能编写代码，更能理解整个代码库的架构与逻辑，并自主完成多步骤的开发任务。
+
+# 工作方式（代理循环 Agentic Loop）
+你的每一次响应都遵循「感知 → 推理 → 行动 → 验证」的循环：
+1. 感知：通过工具读取文件、运行命令、检索代码来收集事实，而不是猜测。
+2. 推理：基于事实规划要做的步骤。
+3. 行动：调用工具执行——读写文件、运行命令、修改代码。
+4. 验证：运行测试 / 类型检查 / 构建命令来确认改动正确，必要时修复。
+循环持续进行，直到用户的目标真正完成。
+
+# 行为准则
+- 务实、直接、简洁。这是 CLI 终端环境，避免冗长的寒暄和不必要的总结。
+- 默认用中文与用户交流（除非用户使用其他语言）。
+- 动手之前先用工具了解现状：阅读相关文件、搜索相关代码，理解现有约定（命名、风格、依赖）后再修改。
+- 修改代码时严格匹配周边代码的风格与缩进。不要主动添加未被要求的注释。
+- 不要假设某个库存在或可用——先检查（package.json、import 语句、已有用法）。
+- 一次只做用户要求的事，不擅自扩大范围。完成后简要说明做了什么。
+- 编辑文件后，主动运行可用的验证手段（测试、lint、typecheck、build），并修复发现的问题。
+- 涉及破坏性操作（删除文件、git push、覆盖重要文件）时保持谨慎，遵循权限机制。
+
+# 工具使用
+- 优先使用专用工具（read_file / edit_file / write_file / grep / glob / list_dir）而非 shell 等价命令。
+- 需要并行且互相独立的工具调用时，可在一次响应中同时发起。
+- bash 工具用于运行测试、构建、git 等命令；不要用它来读写文件（用专用工具更安全）。
+- 不要在没有读取文件内容的情况下编辑它。edit_file 要求 old_text 精确匹配（含缩进）。
+
+# 输出格式
+- 输出会以 GitHub 风格 Markdown 在终端渲染。可使用代码块、列表、粗体。
+- 引用代码位置时使用 \`文件路径:行号\` 格式，便于用户跳转。
+- 不要用表情包堆砌，保持专业。
+
+# 安全
+- 协助授权范围内的安全测试、防御性安全与教学场景。
+- 拒绝明显恶意的破坏性请求。`;
+export function buildSystemPrompt(ctx) {
+    return `${BASE_PROMPT}\n\n# 当前环境\n${renderEnvironment(ctx)}`;
+}

package/dist/agent/provider.js

@@ -0,0 +1,18 @@
+import { AnthropicClient } from './client.js';
+import { OpenAICompatClient } from './client-openai.js';
+export function createClient(config) {
+    const common = {
+        apiKey: config.apiKey,
+        model: config.model,
+        maxTokens: config.data.maxTokens,
+        temperature: config.data.temperature,
+    };
+    if (config.provider === 'openai') {
+        return new OpenAICompatClient({
+            ...common,
+            baseURL: config.data.baseURL ||
+                'https://dashscope.aliyuncs.com/compatible-mode/v1',
+        });
+    }
+    return new AnthropicClient({ ...common, baseURL: config.data.baseURL });
+}

package/dist/cli/headless.js

@@ -0,0 +1,50 @@
+/**
+ * 一次性（非交互）模式 —— 对应 `ccli -p "..."`。
+ * 适合脚本与管道：自动批准只读工具，写操作默认按配置（可 -y 全自动）。
+ */
+import { stdout } from 'node:process';
+import { createClient } from '../agent/provider.js';
+import { buildAgent } from '../agent/factory.js';
+import { PermissionManager, } from '../permissions/permissions.js';
+import { c, brand } from '../ui/theme.js';
+import { renderTodos } from '../tools/todo.js';
+import { expandMentions } from './mentions.js';
+export async function runHeadless(config, cwd, prompt) {
+    const client = createClient(config);
+    // 非交互：无法询问用户。未开启 autoApprove 时，对写操作拒绝并提示。
+    const asker = {
+        async ask(req) {
+            if (config.data.autoApprove)
+                return 'allow';
+            stdout.write(c.dim(`  [跳过未授权操作：${req.description}（非交互模式，加 -y 可自动批准）]\n`));
+            return 'deny';
+        },
+    };
+    const permissions = new PermissionManager(config, asker);
+    const { agent, todos } = buildAgent({ client, cwd, permissions });
+    const isTTY = stdout.isTTY ?? false;
+    if (isTTY) {
+        todos.onChange((items) => stdout.write('\n' + renderTodos(items) + '\n'));
+    }
+    const events = {
+        onTurnStart: () => { },
+        onTurnEnd: () => { },
+        onAssistantText: (d) => stdout.write(d),
+        onToolStart: (_t, _i, preview) => {
+            if (isTTY)
+                stdout.write('\n' + brand.accent('⚒ ') + preview + '\n');
+        },
+        onToolResult: (_t, display, isError) => {
+            if (isTTY)
+                stdout.write('  ' + display + '\n');
+        },
+    };
+    try {
+        await agent.run(expandMentions(prompt, cwd), events);
+        stdout.write('\n');
+    }
+    catch (e) {
+        stdout.write(brand.err('错误：') + (e?.message ?? String(e)) + '\n');
+        process.exit(1);
+    }
+}

package/dist/cli/mentions.js

@@ -0,0 +1,60 @@
+/**
+ * @文件引用展开 —— 把用户输入中的 @path 自动并入文件内容。
+ */
+import { existsSync, readFileSync, statSync, readdirSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+const MAX_PER_FILE = 4000;
+/**
+ * 扫描输入中的 @path,对存在的文件/目录追加内容块。
+ * 返回展开后的消息文本(原文 + 附加块)。
+ */
+export function expandMentions(input, cwd) {
+    const re = /@([\w./_-]+)/g;
+    const seen = new Set();
+    const blocks = [];
+    let match;
+    while ((match = re.exec(input))) {
+        const p = match[1];
+        if (seen.has(p))
+            continue;
+        seen.add(p);
+        const full = isAbsolute(p) ? p : resolve(cwd, p);
+        if (!existsSync(full))
+            continue; // 不存在则当普通文字
+        try {
+            const st = statSync(full);
+            if (st.isDirectory()) {
+                const list = readdirSync(full)
+                    .filter((e) => e !== 'node_modules' && e !== '.git')
+                    .slice(0, 100)
+                    .join('\n');
+                blocks.push(`<directory path="${p}">\n${list}\n</directory>`);
+            }
+            else {
+                let text = readFileSync(full, 'utf8');
+                if (text.length > MAX_PER_FILE) {
+                    text = text.slice(0, MAX_PER_FILE) + '\n…（已截断）';
+                }
+                blocks.push(`<file path="${p}">\n${text}\n</file>`);
+            }
+        }
+        catch {
+            /* 读失败则忽略 */
+        }
+    }
+    if (!blocks.length)
+        return input;
+    return `${input}\n\n${blocks.join('\n\n')}`;
+}
+/** 返回输入中实际命中的引用路径(用于 UI 提示)。 */
+export function foundMentions(input, cwd) {
+    const re = /@([\w./_-]+)/g;
+    const out = [];
+    let m;
+    while ((m = re.exec(input))) {
+        const full = isAbsolute(m[1]) ? m[1] : resolve(cwd, m[1]);
+        if (existsSync(full))
+            out.push(m[1]);
+    }
+    return out;
+}

package/dist/cli/session.js

@@ -0,0 +1,432 @@
+/**
+ * 交互式会话（REPL）—— 自定义终端 UI，串联输入、流式输出、权限确认与斜杠命令。
+ */
+import * as readline from 'node:readline';
+import { stdin, stdout } from 'node:process';
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createClient } from '../agent/provider.js';
+import { Agent } from '../agent/loop.js';
+import { buildAgent } from '../agent/factory.js';
+import { PermissionManager, } from '../permissions/permissions.js';
+import { c, brand } from '../ui/theme.js';
+import { renderMarkdown, box, MarkdownStream } from '../ui/markdown.js';
+import { renderTodos } from '../tools/todo.js';
+import { Spinner } from '../ui/spinner.js';
+import { findCommand } from '../commands/slash.js';
+import { loadCustomCommands, expandTemplate, } from '../commands/custom.js';
+import { expandMentions, foundMentions } from './mentions.js';
+import { SessionStore } from '../session/store.js';
+import { createReadOnlyRegistry } from '../tools/index.js';
+const INIT_PROMPT = `请分析当前项目并生成一份 CCLI.md(供 AI 助手阅读的项目说明)。
+步骤:
+1. 用 list_dir / glob / read_file 了解项目结构、技术栈、关键约定(构建/测试/lint 命令、代码风格、目录职责)。
+2. 阅读 package.json / README / 配置文件等以提取真实信息,不要臆测。
+3. 用 write_file 写入 CCLI.md,内容简洁实用:项目概述、常用命令、关键约定、目录结构要点。
+如果已存在 CCLI.md 或 CLAUDE.md,请先读取并在其基础上补充完善,而非覆盖有用内容。`;
+function commitPrompt(extra) {
+    return `请帮我创建一个 git 提交:
+1. 用 bash 运行 \`git status\` 和 \`git diff --staged\`(以及必要时 \`git diff\`)了解改动。
+2. 若没有已暂存的改动,先 \`git add -A\` 暂存相关文件。
+3. 依据改动总结一个清晰的提交信息(中文,首行简明,必要时附要点)。
+4. 用 \`git commit\` 提交。不要包含 Co-Authored-By 行。
+${extra ? `\n补充要求:${extra}` : ''}`;
+}
+export class Session {
+    config;
+    client;
+    agent;
+    permissions;
+    rl;
+    spinner = new Spinner();
+    cwd;
+    exiting = false;
+    currentAbort = null;
+    streaming = false;
+    streamedAny = false;
+    todos;
+    customCommands;
+    store;
+    constructor(config, cwd, resumeFrom) {
+        this.config = config;
+        this.cwd = cwd;
+        this.client = createClient(config);
+        const asker = {
+            ask: (req) => this.askPermission(req),
+        };
+        this.permissions = new PermissionManager(config, asker);
+        const built = buildAgent({
+            client: this.client,
+            cwd,
+            permissions: this.permissions,
+        });
+        this.agent = built.agent;
+        this.todos = built.todos;
+        // 渲染 todo 变更
+        this.todos.onChange((items) => {
+            stdout.write('\n' + this.indent(renderTodos(items)) + '\n');
+        });
+        // 自定义命令
+        this.customCommands = loadCustomCommands(cwd);
+        // 会话持久化
+        if (resumeFrom) {
+            this.agent.history = resumeFrom.messages;
+            this.store = SessionStore.resume(resumeFrom);
+        }
+        else {
+            this.store = new SessionStore(cwd);
+        }
+        this.rl = readline.createInterface({
+            input: stdin,
+            output: stdout,
+            prompt: this.promptStr(),
+            historySize: 200,
+        });
+    }
+    promptStr() {
+        return brand.primary('❯ ');
+    }
+    print(s) {
+        stdout.write(s + '\n');
+    }
+    // ---------- 启动 ----------
+    async start() {
+        this.printBanner();
+        this.setupSignals();
+        this.rl.prompt();
+        this.rl.on('line', async (line) => {
+            const input = line.trim();
+            if (this.streaming)
+                return; // 流式中忽略
+            await this.handleLine(input);
+            if (!this.exiting) {
+                this.rl.setPrompt(this.promptStr());
+                this.rl.prompt();
+            }
+        });
+        this.rl.on('close', () => {
+            if (!this.exiting) {
+                this.print('\n' + c.dim('再见 👋'));
+            }
+            process.exit(0);
+        });
+    }
+    printBanner() {
+        const lines = [
+            brand.primary(c.bold('✶ CCLI')) + c.dim('  —— AI 软件工程师（Claude Code 复刻）'),
+            '',
+            `${c.dim('模型')}  ${brand.accent(this.config.model)}`,
+            `${c.dim('目录')}  ${this.cwd}`,
+            '',
+            c.dim('输入你的目标，我会自主规划并完成。/help 查看命令。'),
+        ];
+        this.print(box(lines));
+        this.print('');
+    }
+    setupSignals() {
+        let lastSigint = 0;
+        process.on('SIGINT', () => {
+            const now = Date.now();
+            if (this.streaming && this.currentAbort) {
+                // 中断当前生成
+                this.currentAbort.abort();
+                this.spinner.stop();
+                this.streaming = false;
+                this.print('\n' + c.yellow('⏹ 已中断。'));
+                this.rl.prompt();
+                return;
+            }
+            if (now - lastSigint < 1000) {
+                this.exiting = true;
+                this.print('\n' + c.dim('再见 👋'));
+                process.exit(0);
+            }
+            lastSigint = now;
+            this.print('\n' + c.dim('(再次按 Ctrl+C 退出)'));
+            this.rl.prompt();
+        });
+    }
+    // ---------- 输入分发 ----------
+    async handleLine(input) {
+        if (!input)
+            return;
+        // shell 直通
+        if (input.startsWith('!')) {
+            this.runShell(input.slice(1).trim());
+            return;
+        }
+        // # 写记忆:追加到 CCLI.md
+        if (input.startsWith('#')) {
+            this.appendMemory(input.slice(1).trim());
+            return;
+        }
+        // 斜杠命令
+        if (input.startsWith('/')) {
+            await this.runSlash(input.slice(1));
+            return;
+        }
+        // 普通对话 —— 进入代理循环
+        await this.converse(input);
+    }
+    /**
+     * 把一行规则追加到项目记忆文件(# 写记忆)。
+     * 默认写入 CCLI.md;若项目已有 CLAUDE.md 而无 CCLI.md,则尊重现状写入 CLAUDE.md。
+     */
+    appendMemory(text) {
+        if (!text) {
+            this.print(c.dim('用法：# 你想让我长期记住的规则'));
+            return;
+        }
+        const ccli = join(this.cwd, 'CCLI.md');
+        const claude = join(this.cwd, 'CLAUDE.md');
+        const path = !existsSync(ccli) && existsSync(claude) ? claude : ccli;
+        const name = path === claude ? 'CLAUDE.md' : 'CCLI.md';
+        try {
+            let content = existsSync(path) ? readFileSync(path, 'utf8') : '';
+            if (content && !content.endsWith('\n'))
+                content += '\n';
+            if (!content.includes('## 用户记忆')) {
+                content += (content ? '\n' : '') + '## 用户记忆\n';
+            }
+            content += `- ${text}\n`;
+            writeFileSync(path, content, 'utf8');
+            this.print(brand.ok(`✓ 已记入 ${name}：`) + ' ' + c.dim(text));
+        }
+        catch (e) {
+            this.print(brand.err('写入失败：' + e.message));
+        }
+    }
+    runShell(cmd) {
+        if (!cmd)
+            return;
+        this.print(c.dim(`$ ${cmd}`));
+        const res = spawnSync(process.env.SHELL || '/bin/bash', ['-c', cmd], {
+            cwd: this.cwd,
+            stdio: 'inherit',
+        });
+        if (res.status !== 0) {
+            this.print(c.dim(`[退出码 ${res.status}]`));
+        }
+    }
+    async runSlash(raw) {
+        const [name, ...rest] = raw.split(/\s+/);
+        // /resume:列出会话
+        if (name === 'resume') {
+            this.listSessions();
+            return;
+        }
+        // /init:让 agent 分析项目并生成 CCLI.md
+        if (name === 'init') {
+            await this.converse(INIT_PROMPT);
+            return;
+        }
+        // /commit:让 agent 生成提交信息并提交
+        if (name === 'commit') {
+            await this.converse(commitPrompt(rest.join(' ')));
+            return;
+        }
+        const cmd = findCommand(name);
+        if (!cmd) {
+            // 自定义命令兜底
+            const custom = this.customCommands.get(name);
+            if (custom) {
+                const msg = expandTemplate(custom.template, rest.join(' '));
+                this.print(c.dim(`（自定义命令 /${name}）`));
+                await this.converse(msg);
+                return;
+            }
+            this.print(c.yellow(`未知命令 /${name}，输入 /help 查看可用命令。`));
+            return;
+        }
+        const sctx = {
+            print: (s) => this.print(s),
+            clearHistory: () => this.agent.clear(),
+            setModel: (m) => {
+                this.config.model = m;
+                this.client.setModel(m);
+                this.config.saveProject();
+            },
+            getModel: () => this.client.getModel(),
+            getUsage: () => this.agent.totalUsage,
+            toggleAutoApprove: () => {
+                this.config.data.autoApprove = !this.config.data.autoApprove;
+                return this.config.data.autoApprove;
+            },
+            listAllowed: () => this.config.data.allowedTools,
+            cwd: this.cwd,
+            requestExit: () => {
+                this.exiting = true;
+                this.print(c.dim('再见 👋'));
+                process.exit(0);
+            },
+            requestCompact: () => this.compact(),
+            getHistoryLength: () => this.agent.history.length,
+        };
+        await cmd.run(rest.join(' '), sctx);
+    }
+    listSessions() {
+        const all = SessionStore.list(this.cwd);
+        if (!all.length) {
+            this.print(c.dim('（该目录暂无历史会话）'));
+            return;
+        }
+        const lines = all.slice(0, 10).map((s, i) => {
+            const when = s.updatedAt.replace('T', ' ').slice(0, 16);
+            const turns = s.messages.length;
+            return `  ${brand.accent(s.id)}  ${c.dim(when)}  ${c.dim(`${turns} 条`)}`;
+        });
+        this.print([
+            brand.primary('该目录的历史会话'),
+            ...lines,
+            '',
+            c.dim('用 ccli --resume <id> 恢复某次会话。'),
+        ].join('\n'));
+    }
+    // ---------- 对话（代理循环）----------
+    async converse(rawInput) {
+        // @文件引用展开
+        const mentioned = foundMentions(rawInput, this.cwd);
+        if (mentioned.length) {
+            this.print(c.dim(`  ↳ 已引用：${mentioned.join('、')}`));
+        }
+        const input = expandMentions(rawInput, this.cwd);
+        this.streaming = true;
+        this.streamedAny = false;
+        this.currentAbort = new AbortController();
+        const signal = this.currentAbort.signal;
+        // 流式 Markdown 渲染器(每个 assistant 文本段一个)
+        let md = null;
+        const endTextSegment = () => {
+            if (md) {
+                md.flush();
+                md = null;
+            }
+        };
+        const events = {
+            onTurnStart: () => this.spinner.start(),
+            onTurnEnd: () => this.spinner.stop(),
+            onAssistantText: (delta) => {
+                if (!md) {
+                    this.spinner.stop();
+                    stdout.write('\n' + brand.primary('●') + '\n');
+                    md = new MarkdownStream((s) => stdout.write(s));
+                    this.streamedAny = true;
+                }
+                md.feed(delta);
+            },
+            onThinking: (delta) => {
+                // 思考内容以暗色显示
+                this.spinner.stop();
+                stdout.write(c.dim(delta));
+            },
+            onToolStart: (tool, _input, preview) => {
+                endTextSegment();
+                this.spinner.stop();
+                stdout.write('\n' + brand.accent('  ⚒ ') + preview + '\n');
+            },
+            onToolResult: (_tool, display, isError) => {
+                stdout.write('  ' + this.indent(display) + '\n');
+            },
+            onToolDenied: (_tool, reason) => {
+                stdout.write('  ' + c.yellow('✗ ' + reason) + '\n');
+            },
+        };
+        try {
+            await this.agent.run(input, events, signal);
+            endTextSegment();
+            this.store.save(this.client.getModel(), this.agent.history);
+        }
+        catch (e) {
+            endTextSegment();
+            this.spinner.stop();
+            if (!signal.aborted) {
+                this.print('\n' + brand.err('✗ 出错：') + (e?.message ?? String(e)));
+                if (e?.status === 401) {
+                    this.print(c.dim('  API Key 无效，请检查 ANTHROPIC_API_KEY。'));
+                }
+            }
+        }
+        finally {
+            this.streaming = false;
+            this.currentAbort = null;
+        }
+    }
+    indent(s) {
+        return s.split('\n').join('\n  ');
+    }
+    // ---------- 权限确认 UI ----------
+    askPermission(req) {
+        this.spinner.stop();
+        return new Promise((resolvePromise) => {
+            const title = req.dangerous
+                ? brand.err('⚠ 高危操作需要确认')
+                : brand.warn('需要你的授权');
+            const lines = [
+                '',
+                box([
+                    title,
+                    '',
+                    `${c.dim('操作')}  ${req.description}`,
+                    req.dangerous ? c.red('  这是一个可能造成破坏的命令，请谨慎。') : '',
+                ].filter(Boolean), { color: req.dangerous ? c.red : brand.warn }),
+                '',
+                `  ${brand.ok('[y]')} 允许一次   ${brand.accent('[a]')} 始终允许（加入白名单）   ${c.red('[n]')} 拒绝`,
+                '',
+            ];
+            this.print(lines.join('\n'));
+            // 复用主 readline 的 question —— Node 会在此期间抑制 'line' 事件，
+            // 避免双重消费按键。递归直到得到合法答案。
+            const askOnce = () => {
+                this.rl.question(brand.primary('  > '), (raw) => {
+                    const key = raw.trim().toLowerCase();
+                    let answer = null;
+                    if (key === 'y' || key === '' || key === 'yes')
+                        answer = 'allow';
+                    else if (key === 'a' || key === 'always')
+                        answer = 'always';
+                    else if (key === 'n' || key === 'no')
+                        answer = 'deny';
+                    if (!answer) {
+                        stdout.write(c.dim('  请输入 y / a / n。\n'));
+                        askOnce();
+                        return;
+                    }
+                    resolvePromise(answer);
+                });
+            };
+            askOnce();
+        });
+    }
+    // ---------- compact ----------
+    async compact() {
+        if (this.agent.history.length === 0) {
+            this.print(c.dim('（无可压缩的历史）'));
+            return;
+        }
+        this.print(c.dim('正在压缩对话历史…'));
+        this.spinner.start('压缩中');
+        try {
+            const summaryAgent = this.agent;
+            // 用一个轻量请求生成摘要
+            const tmp = new Agent(this.client, createReadOnlyRegistry(), this.permissions, '你是一个对话摘要助手。请用简洁中文总结此前对话的关键事实、已完成的改动和待办，供后续继续工作使用。', { cwd: this.cwd });
+            tmp.history = [...summaryAgent.history];
+            let summary = '';
+            await tmp.run('请总结以上对话，输出一段供继续工作的上下文摘要。', {
+                onAssistantText: (d) => {
+                    summary += d;
+                },
+                onTurnStart: () => { },
+                onTurnEnd: () => { },
+            });
+            this.spinner.stop();
+            this.agent.compactSummary(summary.trim());
+            this.print(brand.ok('✓ 已压缩历史。'));
+            this.print(c.dim(renderMarkdown(summary.trim()).split('\n').slice(0, 8).join('\n')));
+        }
+        catch (e) {
+            this.spinner.stop();
+            this.print(brand.err('压缩失败：' + e.message));
+        }
+    }
+}

package/dist/commands/custom.js

@@ -0,0 +1,46 @@
+/**
+ * 自定义斜杠命令 —— 从 .ccli/commands/*.md 加载用户定义的提示词模板。
+ * 文件名即命令名,$ARGUMENTS 会被替换为调用参数。
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { homedir } from 'node:os';
+function scanDir(dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const f of readdirSync(dir)) {
+        if (!f.endsWith('.md'))
+            continue;
+        try {
+            const template = readFileSync(join(dir, f), 'utf8');
+            out.push({
+                name: basename(f, '.md'),
+                template,
+                source: join(dir, f),
+            });
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return out;
+}
+/** 加载项目级 + 全局自定义命令(项目级优先)。 */
+export function loadCustomCommands(cwd) {
+    const map = new Map();
+    for (const cmd of scanDir(join(homedir(), '.ccli', 'commands'))) {
+        map.set(cmd.name, cmd);
+    }
+    for (const cmd of scanDir(join(cwd, '.ccli', 'commands'))) {
+        map.set(cmd.name, cmd); // 项目级覆盖全局
+    }
+    return map;
+}
+/** 把模板里的 $ARGUMENTS 展开为参数文本。 */
+export function expandTemplate(template, args) {
+    if (template.includes('$ARGUMENTS')) {
+        return template.split('$ARGUMENTS').join(args);
+    }
+    return args ? `${template}\n\n${args}` : template;
+}