@gird/ccli 1.0.2 → 2.0.0

package/dist/tools/filesystem.js

@@ -1,215 +0,0 @@
-/**
- * 文件系统工具：read_file / write_file / edit_file / list_dir。
- * 复刻 Claude Code 通过 fs 模块操作文件的本地能力。
- */
-import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync, } from 'node:fs';
-import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
-import { c, brand } from '../ui/theme.js';
-import { renderDiff, diffStat } from '../ui/diff.js';
-function resolvePath(p, ctx) {
-    return isAbsolute(p) ? p : resolve(ctx.cwd, p);
-}
-function rel(p, ctx) {
-    const r = relative(ctx.cwd, p);
-    return r.startsWith('..') ? p : r || '.';
-}
-export const readFileTool = {
-    name: 'read_file',
-    description: '读取文件内容。返回带行号的内容。可指定 offset/limit 读取大文件的部分。优先用此工具而非 cat/head。',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            path: { type: 'string', description: '文件路径（相对或绝对）' },
-            offset: { type: 'number', description: '起始行号（从 1 开始，可选）' },
-            limit: { type: 'number', description: '读取行数（可选，默认 2000）' },
-        },
-        required: ['path'],
-    },
-    preview(input, ctx) {
-        return `读取 ${brand.accent(rel(resolvePath(input.path, ctx), ctx))}`;
-    },
-    async run(input, ctx) {
-        const full = resolvePath(input.path, ctx);
-        if (!existsSync(full)) {
-            return { content: `错误：文件不存在 ${input.path}`, isError: true };
-        }
-        const st = statSync(full);
-        if (st.isDirectory()) {
-            return { content: `错误：${input.path} 是目录，请用 list_dir`, isError: true };
-        }
-        let text;
-        try {
-            text = readFileSync(full, 'utf8');
-        }
-        catch (e) {
-            return { content: `读取失败：${e.message}`, isError: true };
-        }
-        const lines = text.split('\n');
-        const offset = Math.max(1, input.offset ?? 1);
-        const limit = input.limit ?? 2000;
-        const slice = lines.slice(offset - 1, offset - 1 + limit);
-        const numbered = slice
-            .map((l, i) => `${String(offset + i).padStart(6)}\t${l}`)
-            .join('\n');
-        const more = lines.length > offset - 1 + limit
-            ? `\n…（共 ${lines.length} 行，已显示 ${offset}-${offset + slice.length - 1}）`
-            : '';
-        return {
-            content: numbered + more || '（空文件）',
-            display: `${c.dim('读取')} ${rel(full, ctx)} ${c.dim(`(${slice.length} 行)`)}`,
-        };
-    },
-};
-export const writeFileTool = {
-    name: 'write_file',
-    description: '写入文件（覆盖已存在的内容，自动创建父目录）。用于创建新文件或完整重写文件。部分修改请用 edit_file。',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            path: { type: 'string', description: '文件路径' },
-            content: { type: 'string', description: '完整文件内容' },
-        },
-        required: ['path', 'content'],
-    },
-    permission(input, ctx) {
-        const r = rel(resolvePath(input.path, ctx), ctx);
-        return {
-            tool: 'write_file',
-            rule: `Write(${r})`,
-            description: `写入文件 ${r}`,
-            dangerous: false,
-        };
-    },
-    preview(input, ctx) {
-        const r = rel(resolvePath(input.path, ctx), ctx);
-        const exists = existsSync(resolvePath(input.path, ctx));
-        const lines = String(input.content ?? '').split('\n').length;
-        return `${exists ? '覆盖' : '创建'} ${brand.accent(r)} ${c.dim(`(${lines} 行)`)}`;
-    },
-    async run(input, ctx) {
-        const full = resolvePath(input.path, ctx);
-        const existed = existsSync(full);
-        const before = existed ? readFileSync(full, 'utf8') : '';
-        try {
-            const dir = dirname(full);
-            if (!existsSync(dir))
-                mkdirSync(dir, { recursive: true });
-            writeFileSync(full, input.content, 'utf8');
-        }
-        catch (e) {
-            return { content: `写入失败：${e.message}`, isError: true };
-        }
-        const lines = String(input.content).split('\n').length;
-        let display = `${existed ? c.yellow('覆盖') : brand.ok('创建')} ${rel(full, ctx)} ${c.dim(`(${lines} 行)`)}`;
-        if (existed && before !== input.content) {
-            const stat = diffStat(before, input.content);
-            display += ` ${c.dim(`(+${stat.add} -${stat.del})`)}\n${renderDiff(before, input.content)}`;
-        }
-        return {
-            content: `${existed ? '已覆盖' : '已创建'} ${rel(full, ctx)}（${lines} 行）`,
-            display,
-        };
-    },
-};
-export const editFileTool = {
-    name: 'edit_file',
-    description: '对文件做精确替换。old_text 必须在文件中唯一且精确匹配（含缩进/空白）。用于局部修改。如需替换全部出现，设 replace_all=true。',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            path: { type: 'string', description: '文件路径' },
-            old_text: { type: 'string', description: '要替换的原文（精确匹配）' },
-            new_text: { type: 'string', description: '替换后的新文本' },
-            replace_all: {
-                type: 'boolean',
-                description: '是否替换所有出现（默认 false）',
-            },
-        },
-        required: ['path', 'old_text', 'new_text'],
-    },
-    permission(input, ctx) {
-        const r = rel(resolvePath(input.path, ctx), ctx);
-        return {
-            tool: 'edit_file',
-            rule: `Edit(${r})`,
-            description: `编辑文件 ${r}`,
-            dangerous: false,
-        };
-    },
-    preview(input, ctx) {
-        const r = rel(resolvePath(input.path, ctx), ctx);
-        return `编辑 ${brand.accent(r)}`;
-    },
-    async run(input, ctx) {
-        const full = resolvePath(input.path, ctx);
-        if (!existsSync(full)) {
-            return { content: `错误：文件不存在 ${input.path}`, isError: true };
-        }
-        let text = readFileSync(full, 'utf8');
-        const before = text;
-        const { old_text, new_text, replace_all } = input;
-        if (old_text === new_text) {
-            return { content: '错误：old_text 与 new_text 相同', isError: true };
-        }
-        const count = text.split(old_text).length - 1;
-        if (count === 0) {
-            return {
-                content: `错误：在文件中未找到 old_text。请先 read_file 确认精确内容（含缩进）。`,
-                isError: true,
-            };
-        }
-        if (count > 1 && !replace_all) {
-            return {
-                content: `错误：old_text 出现了 ${count} 次，不唯一。请提供更多上下文，或设 replace_all=true。`,
-                isError: true,
-            };
-        }
-        text = replace_all
-            ? text.split(old_text).join(new_text)
-            : text.replace(old_text, new_text);
-        writeFileSync(full, text, 'utf8');
-        const stat = diffStat(before, text);
-        const diff = renderDiff(before, text);
-        return {
-            content: `已编辑 ${rel(full, ctx)}（替换 ${replace_all ? count : 1} 处）`,
-            display: `${brand.ok('编辑')} ${rel(full, ctx)} ${c.dim(`(+${stat.add} -${stat.del})`)}\n${diff}`,
-        };
-    },
-};
-export const listDirTool = {
-    name: 'list_dir',
-    description: '列出目录内容（文件与子目录）。优先用此工具而非 ls。',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            path: { type: 'string', description: '目录路径（默认当前工作目录）' },
-        },
-    },
-    preview(input, ctx) {
-        return `列出 ${brand.accent(input.path || '.')}`;
-    },
-    async run(input, ctx) {
-        const full = resolvePath(input.path || '.', ctx);
-        if (!existsSync(full)) {
-            return { content: `错误：路径不存在 ${input.path}`, isError: true };
-        }
-        let entries;
-        try {
-            entries = readdirSync(full);
-        }
-        catch (e) {
-            return { content: `列目录失败：${e.message}`, isError: true };
-        }
-        const rows = entries
-            .filter((e) => e !== 'node_modules' && e !== '.git')
-            .sort()
-            .map((e) => {
-            const st = statSync(join(full, e));
-            return st.isDirectory() ? `${e}/` : e;
-        });
-        return {
-            content: rows.length ? rows.join('\n') : '（空目录）',
-            display: `${c.dim('列目录')} ${rel(full, ctx)} ${c.dim(`(${rows.length} 项)`)}`,
-        };
-    },
-};

package/dist/tools/index.js

@@ -1,45 +0,0 @@
-import { readFileTool, writeFileTool, editFileTool, listDirTool, } from './filesystem.js';
-import { grepTool, globTool } from './search.js';
-import { bashTool } from './bash.js';
-import { todoWriteTool } from './todo.js';
-import { webFetchTool } from './web.js';
-export class ToolRegistry {
-    tools = new Map();
-    register(tool) {
-        this.tools.set(tool.name, tool);
-    }
-    get(name) {
-        return this.tools.get(name);
-    }
-    list() {
-        return [...this.tools.values()];
-    }
-}
-/** 完整工具集(主 Agent 使用)。 */
-export function createDefaultRegistry() {
-    const reg = new ToolRegistry();
-    // 感知类
-    reg.register(readFileTool);
-    reg.register(listDirTool);
-    reg.register(grepTool);
-    reg.register(globTool);
-    reg.register(webFetchTool);
-    // 行动类
-    reg.register(writeFileTool);
-    reg.register(editFileTool);
-    reg.register(bashTool);
-    // 协调类
-    reg.register(todoWriteTool);
-    return reg;
-}
-/** 只读工具集(子代理 / Task 使用,防止破坏与递归)。 */
-export function createReadOnlyRegistry() {
-    const reg = new ToolRegistry();
-    reg.register(readFileTool);
-    reg.register(listDirTool);
-    reg.register(grepTool);
-    reg.register(globTool);
-    reg.register(webFetchTool);
-    return reg;
-}
-export * from './types.js';

package/dist/tools/task.js

@@ -1,35 +0,0 @@
-import { brand, c } from '../ui/theme.js';
-export const SUBAGENT_SYSTEM = `你是一个被主 Agent 派生的调研子代理。
-你只拥有只读工具(read_file / list_dir / grep / glob / web_fetch)。
-请自主、彻底地完成被交付的调研任务,然后用简洁的中文输出**最终结论**:
-- 直接给出发现的事实、相关文件路径(用 路径:行号)与结论。
-- 不要返回中间过程的啰嗦叙述,主 Agent 只需要你的结论。`;
-export function createTaskTool(runner) {
-    return {
-        name: 'task',
-        description: '派生一个只读子代理来完成聚焦的调研类任务(如「在整个代码库中找出所有使用 X 的位置并总结」)。适合需要多步搜索/阅读但你不想让中间过程占满上下文的场景。子代理只能读,不能修改文件或执行命令。返回子代理的最终结论。',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                description: { type: 'string', description: '任务简短标题(3-6 字)' },
-                prompt: {
-                    type: 'string',
-                    description: '交给子代理的完整、自洽的任务说明',
-                },
-            },
-            required: ['description', 'prompt'],
-        },
-        preview(input) {
-            return `${brand.accent('task')}: ${input.description}`;
-        },
-        async run(input, ctx) {
-            const { description, prompt } = input;
-            const res = await runner(String(description ?? '子任务'), String(prompt ?? ''), ctx.cwd);
-            return {
-                content: res.text || '(子代理无输出)',
-                isError: res.isError,
-                display: `${brand.ok('✓')} 子代理「${description}」完成 ${c.dim(`(${res.text.length} 字结论)`)}`,
-            };
-        },
-    };
-}

package/dist/tools/todo.js

@@ -1,68 +0,0 @@
-import { c, brand } from '../ui/theme.js';
-/** 会话级 todo 状态(整表覆盖式更新)。 */
-export class TodoStore {
-    items = [];
-    listeners = [];
-    set(items) {
-        this.items = items;
-        for (const l of this.listeners)
-            l(items);
-    }
-    onChange(fn) {
-        this.listeners.push(fn);
-    }
-}
-export function renderTodos(items) {
-    if (!items.length)
-        return c.dim('（清单为空）');
-    const done = items.filter((t) => t.status === 'completed').length;
-    const lines = items.map((t) => {
-        if (t.status === 'completed')
-            return `  ${brand.ok('✔')} ${c.dim(c.strike(t.content))}`;
-        if (t.status === 'in_progress')
-            return `  ${brand.accent('▸')} ${c.bold(t.content)}`;
-        return `  ${c.dim('○')} ${t.content}`;
-    });
-    return (`${brand.primary('任务清单')} ${c.dim(`(${done}/${items.length})`)}\n` +
-        lines.join('\n'));
-}
-export const todoWriteTool = {
-    name: 'todo_write',
-    description: '维护任务清单以追踪多步骤工作的进度。每次传入完整的清单(整表覆盖)。对于包含 3 步以上的复杂任务,应在开始时创建清单,并随进展把每项标记为 in_progress / completed。同一时刻只应有一项 in_progress。',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            todos: {
-                type: 'array',
-                description: '完整的任务清单',
-                items: {
-                    type: 'object',
-                    properties: {
-                        content: { type: 'string', description: '任务描述(祈使式)' },
-                        status: {
-                            type: 'string',
-                            enum: ['pending', 'in_progress', 'completed'],
-                        },
-                        activeForm: { type: 'string', description: '进行时描述(可选)' },
-                    },
-                    required: ['content', 'status'],
-                },
-            },
-        },
-        required: ['todos'],
-    },
-    async run(input, ctx) {
-        const todos = Array.isArray(input.todos) ? input.todos : [];
-        const inProgress = todos.filter((t) => t.status === 'in_progress').length;
-        ctx.todos?.set(todos);
-        const warn = inProgress > 1
-            ? '\n（提醒：同一时刻应只有一项 in_progress）'
-            : '';
-        const summary = `已更新任务清单：共 ${todos.length} 项，` +
-            `完成 ${todos.filter((t) => t.status === 'completed').length} 项。${warn}`;
-        return {
-            content: summary,
-            display: renderTodos(todos),
-        };
-    },
-};

package/dist/tools/types.js

@@ -1,8 +0,0 @@
-/** 转成 Anthropic SDK 的 tool 定义。 */
-export function toAnthropicTool(t) {
-    return {
-        name: t.name,
-        description: t.description,
-        input_schema: t.inputSchema,
-    };
-}

package/dist/tools/web.js

@@ -1,108 +0,0 @@
-import { c, brand } from '../ui/theme.js';
-const MAX_CHARS = 12_000;
-const TIMEOUT = 15_000;
-/** 极简 HTML → 文本:去脚本/样式/标签,解码常见实体,折叠空白。 */
-export function htmlToText(html) {
-    let s = html;
-    s = s.replace(/<script[\s\S]*?<\/script>/gi, ' ');
-    s = s.replace(/<style[\s\S]*?<\/style>/gi, ' ');
-    s = s.replace(/<!--[\s\S]*?-->/g, ' ');
-    // 块级标签转换行
-    s = s.replace(/<\/(p|div|section|article|h[1-6]|li|tr|br)>/gi, '\n');
-    s = s.replace(/<br\s*\/?>/gi, '\n');
-    // 去掉剩余标签
-    s = s.replace(/<[^>]+>/g, ' ');
-    // 实体
-    const entities = {
-        '&nbsp;': ' ',
-        '&amp;': '&',
-        '&lt;': '<',
-        '&gt;': '>',
-        '&quot;': '"',
-        '&#39;': "'",
-        '&apos;': "'",
-    };
-    s = s.replace(/&[a-z#0-9]+;/gi, (m) => entities[m.toLowerCase()] ?? m);
-    // 折叠空白
-    s = s
-        .split('\n')
-        .map((l) => l.replace(/[ \t]+/g, ' ').trim())
-        .filter((l) => l.length > 0)
-        .join('\n');
-    return s;
-}
-export const webFetchTool = {
-    name: 'web_fetch',
-    description: '抓取一个 http/https 网址的内容并转为精简文本,用于查阅在线文档或网页。返回正文文本(已截断)。',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            url: { type: 'string', description: 'http/https 网址' },
-            prompt: {
-                type: 'string',
-                description: '你关注的问题(可选,会附在内容前作为提示)',
-            },
-        },
-        required: ['url'],
-    },
-    permission(input) {
-        return {
-            tool: 'web_fetch',
-            rule: `WebFetch(${safeHost(input.url)})`,
-            description: `抓取网页 ${input.url}`,
-            dangerous: false,
-        };
-    },
-    preview(input) {
-        return `抓取 ${brand.accent(input.url)}`;
-    },
-    async run(input, _ctx) {
-        const url = String(input.url || '');
-        if (!/^https?:\/\//i.test(url)) {
-            return { content: '错误：仅支持 http/https 协议。', isError: true };
-        }
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), TIMEOUT);
-        try {
-            const res = await fetch(url, {
-                signal: controller.signal,
-                headers: { 'User-Agent': 'CCLI/1.0 (+web_fetch)' },
-                redirect: 'follow',
-            });
-            clearTimeout(timer);
-            if (!res.ok) {
-                return { content: `请求失败:HTTP ${res.status}`, isError: true };
-            }
-            const ctype = res.headers.get('content-type') || '';
-            const raw = await res.text();
-            let text;
-            if (ctype.includes('html'))
-                text = htmlToText(raw);
-            else if (ctype.includes('json'))
-                text = raw;
-            else
-                text = raw;
-            if (text.length > MAX_CHARS) {
-                text = text.slice(0, MAX_CHARS) + '\n…（内容已截断）';
-            }
-            const header = input.prompt ? `[关注点] ${input.prompt}\n\n` : '';
-            return {
-                content: `${header}来源:${url}\n\n${text}`,
-                display: `${brand.ok('✓')} 抓取 ${url} ${c.dim(`(${text.length} 字)`)}`,
-            };
-        }
-        catch (e) {
-            clearTimeout(timer);
-            const msg = e?.name === 'AbortError' ? '请求超时' : e?.message ?? String(e);
-            return { content: `抓取失败:${msg}`, isError: true };
-        }
-    },
-};
-function safeHost(url) {
-    try {
-        return new URL(url).host;
-    }
-    catch {
-        return url;
-    }
-}

package/dist/ui/diff.js

@@ -1,105 +0,0 @@
-/**
- * 行级 diff —— 基于最长公共子序列(LCS)。
- * 用于 edit_file / write_file 后展示真正的变更。
- */
-import { c, brand } from './theme.js';
-/** 计算两段文本的行级 diff 操作序列。 */
-export function diffLines(oldText, newText) {
-    const a = oldText.split('\n');
-    const b = newText.split('\n');
-    const n = a.length;
-    const m = b.length;
-    // LCS 动态规划表
-    const dp = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
-    for (let i = n - 1; i >= 0; i--) {
-        for (let j = m - 1; j >= 0; j--) {
-            dp[i][j] =
-                a[i] === b[j]
-                    ? dp[i + 1][j + 1] + 1
-                    : Math.max(dp[i + 1][j], dp[i][j + 1]);
-        }
-    }
-    const ops = [];
-    let i = 0;
-    let j = 0;
-    while (i < n && j < m) {
-        if (a[i] === b[j]) {
-            ops.push({ type: 'eq', line: a[i] });
-            i++;
-            j++;
-        }
-        else if (dp[i + 1][j] >= dp[i][j + 1]) {
-            ops.push({ type: 'del', line: a[i] });
-            i++;
-        }
-        else {
-            ops.push({ type: 'add', line: b[j] });
-            j++;
-        }
-    }
-    while (i < n)
-        ops.push({ type: 'del', line: a[i++] });
-    while (j < m)
-        ops.push({ type: 'add', line: b[j++] });
-    return ops;
-}
-/**
- * 渲染 diff,带行号,折叠大段未变更上下文(只在变更附近保留 context 行)。
- */
-export function renderDiff(oldText, newText, context = 2) {
-    const ops = diffLines(oldText, newText);
-    // 标记需要显示的行(变更行及其上下文)
-    const show = new Array(ops.length).fill(false);
-    for (let k = 0; k < ops.length; k++) {
-        if (ops[k].type !== 'eq') {
-            for (let d = -context; d <= context; d++) {
-                const idx = k + d;
-                if (idx >= 0 && idx < ops.length)
-                    show[idx] = true;
-            }
-        }
-    }
-    const out = [];
-    let oldLn = 0;
-    let newLn = 0;
-    let gapPrinted = false;
-    for (let k = 0; k < ops.length; k++) {
-        const op = ops[k];
-        if (op.type === 'eq') {
-            oldLn++;
-            newLn++;
-        }
-        else if (op.type === 'del') {
-            oldLn++;
-        }
-        else {
-            newLn++;
-        }
-        if (!show[k]) {
-            if (!gapPrinted && out.length > 0) {
-                out.push(c.dim('    ⋮'));
-                gapPrinted = true;
-            }
-            continue;
-        }
-        gapPrinted = false;
-        if (op.type === 'eq') {
-            out.push(c.dim(`${String(newLn).padStart(4)}   ${op.line}`));
-        }
-        else if (op.type === 'del') {
-            out.push(c.red(`${String(oldLn).padStart(4)} - ${op.line}`));
-        }
-        else {
-            out.push(brand.ok(`${String(newLn).padStart(4)} + ${op.line}`));
-        }
-    }
-    return out.join('\n');
-}
-/** 统计 +/- 行数。 */
-export function diffStat(oldText, newText) {
-    const ops = diffLines(oldText, newText);
-    return {
-        add: ops.filter((o) => o.type === 'add').length,
-        del: ops.filter((o) => o.type === 'del').length,
-    };
-}