@gird/ccli 1.0.1 → 2.0.0

package/README.md

@@ -100,11 +100,6 @@ ccli -h, --help           查看帮助
 | `todo_write` | 协调 | 维护多步任务清单并实时显示进度 |
 | `task` | 协调 | 派生只读子代理执行聚焦调研 |
 
-## 文档
-
-- [使用指南](https://github.com/GridGit/ai-cli/blob/main/docs/使用指南.md) —— 运行方式、交互、斜杠命令、典型工作流、常见问题、发布流程
-- [架构设计](https://github.com/GridGit/ai-cli/blob/main/docs/架构设计.md) —— 设计理念、分层架构、代理循环数据流、扩展指南
-
 ## 本地开发
 
 ```bash

package/dist/args.js

@@ -0,0 +1,35 @@
+/**
+ * 极简命令行参数解析。
+ *
+ * 现在只需要认识几个标志（flag），所以手写解析即可，不引第三方库。
+ * 把「原始 argv」翻译成一个结构化的 ParsedArgs，交给 index.ts 决定做什么。
+ */
+export function parseArgs(argv) {
+    const result = {
+        version: false,
+        help: false,
+        unknown: [],
+        positionals: [],
+    };
+    for (const arg of argv) {
+        switch (arg) {
+            case '-v':
+            case '--version':
+                result.version = true;
+                break;
+            case '-h':
+            case '--help':
+                result.help = true;
+                break;
+            default:
+                if (arg.startsWith('-')) {
+                    result.unknown.push(arg);
+                }
+                else {
+                    result.positionals.push(arg);
+                }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,UAAU,SAAS,CAAC,IAAc;IACpC,MAAM,MAAM,GAAe;QACvB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;KAClB,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,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;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/config.js

@@ -0,0 +1,120 @@
+/**
+ * 配置与密钥解析。
+ *
+ * 优先级（高覆盖低）：
+ *   环境变量  >  项目 .env 文件  >  全局 ~/.ccli/config.json
+ *
+ * 支持的后端：
+ *   - Anthropic (Claude)      —— ANTHROPIC_API_KEY [+ ANTHROPIC_BASE_URL / ANTHROPIC_MODEL]
+ *   - OpenAI 兼容(通义千问等)  —— QWEN_API_KEY / OPENAI_API_KEY [+ *_BASE_URL / *_MODEL]
+ *
+ * 本步只负责「读取并解析成一个清晰的 Config」，不发起任何网络请求。
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { loadEnvFile } from './env.js';
+/** 各后端在未显式指定 model 时的兜底默认值。 */
+const DEFAULT_MODEL = {
+    anthropic: 'claude-sonnet-4-5',
+    openai: 'qwen-plus',
+};
+const GLOBAL_CONFIG_PATH = join(homedir(), '.ccli', 'config.json');
+/** 读取全局 ~/.ccli/config.json（优先级最低）；不存在或损坏则返回空。 */
+function loadGlobalConfig() {
+    try {
+        const raw = JSON.parse(readFileSync(GLOBAL_CONFIG_PATH, 'utf8'));
+        return {
+            provider: raw.provider,
+            apiKey: raw.apiKey,
+            baseURL: raw.baseURL,
+            model: raw.model,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 解析出最终生效的配置。
+ * @param cwd 项目根目录，用于定位 .env
+ */
+export function loadConfig(cwd = process.cwd()) {
+    const dotenv = loadEnvFile(join(cwd, '.env'));
+    const global = loadGlobalConfig();
+    // 按优先级取一个环境风格的键：环境变量 > .env
+    const get = (key) => process.env[key] ?? dotenv[key];
+    // —— 后端识别（按 Key 出现顺序）——
+    // 1) Anthropic
+    const anthropicKey = get('ANTHROPIC_API_KEY');
+    if (anthropicKey) {
+        return {
+            ok: true,
+            config: {
+                provider: 'anthropic',
+                apiKey: anthropicKey,
+                baseURL: get('ANTHROPIC_BASE_URL'),
+                model: get('ANTHROPIC_MODEL') ??
+                    get('CCLI_MODEL') ??
+                    DEFAULT_MODEL.anthropic,
+            },
+        };
+    }
+    // 2) 通义千问 Qwen（OpenAI 兼容的便捷前缀）
+    const qwenKey = get('QWEN_API_KEY');
+    if (qwenKey) {
+        return {
+            ok: true,
+            config: {
+                provider: 'openai',
+                apiKey: qwenKey,
+                baseURL: get('QWEN_BASE_URL'),
+                model: get('QWEN_MODEL') ?? DEFAULT_MODEL.openai,
+            },
+        };
+    }
+    // 3) 通用 OpenAI 兼容后端（DeepSeek / GLM / 自建）
+    const openaiKey = get('OPENAI_API_KEY');
+    if (openaiKey) {
+        return {
+            ok: true,
+            config: {
+                provider: 'openai',
+                apiKey: openaiKey,
+                baseURL: get('OPENAI_BASE_URL'),
+                model: get('OPENAI_MODEL') ??
+                    get('CCLI_MODEL') ??
+                    DEFAULT_MODEL.openai,
+            },
+        };
+    }
+    // 4) 回退到全局配置
+    if (global.apiKey && global.provider) {
+        return {
+            ok: true,
+            config: {
+                provider: global.provider,
+                apiKey: global.apiKey,
+                baseURL: global.baseURL,
+                model: global.model ?? DEFAULT_MODEL[global.provider],
+            },
+        };
+    }
+    // 都没有 —— 给出可操作的提示，而不是抛异常
+    return {
+        ok: false,
+        message: [
+            '未找到可用的 API 配置。请任选其一：',
+            '  • 设置环境变量  ANTHROPIC_API_KEY=sk-ant-...',
+            '  • 或在项目 .env 写入  QWEN_API_KEY / QWEN_BASE_URL / QWEN_MODEL',
+            '  • 或在 ~/.ccli/config.json 配置 { provider, apiKey, baseURL, model }',
+        ].join('\n'),
+    };
+}
+/** 打码显示密钥，用于安全地回显「用了哪个 key」。 */
+export function maskKey(key) {
+    if (key.length <= 8)
+        return '****';
+    return `${key.slice(0, 4)}…${key.slice(-4)}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/env.js

@@ -0,0 +1,39 @@
+/**
+ * 极简 .env 文件解析器（零依赖，不引 dotenv）。
+ *
+ * 只做最常见的事：逐行读 KEY=VALUE，忽略空行和 # 注释，去掉值两侧引号。
+ * 解析结果作为一个普通对象返回，由 config.ts 决定它和真实环境变量谁优先。
+ * 特意「不写回 process.env」，避免隐式副作用——优先级由调用方显式控制。
+ */
+import { readFileSync } from 'node:fs';
+export function parseEnv(text) {
+    const result = {};
+    for (const raw of text.split('\n')) {
+        const line = raw.trim();
+        if (line.length === 0 || line.startsWith('#'))
+            continue;
+        const eq = line.indexOf('=');
+        if (eq === -1)
+            continue; // 没有 = 的行跳过
+        const key = line.slice(0, eq).trim();
+        let value = line.slice(eq + 1).trim();
+        // 去掉成对的首尾引号
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (key)
+            result[key] = value;
+    }
+    return result;
+}
+/** 读取并解析一个 .env 文件；文件不存在则返回空对象。 */
+export function loadEnvFile(path) {
+    try {
+        return parseEnv(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return {}; // 文件不存在等情况：静默当作没有配置
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,UAAU,QAAQ,CAAC,IAAY;IACjC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAExD,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,SAAS,CAAC,YAAY;QAErC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEtC,YAAY;QACZ,IACI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAChD,CAAC;YACC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,GAAG;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACjC,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,IAAI,CAAC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC,CAAC,oBAAoB;IACnC,CAAC;AACL,CAAC"}

package/dist/index.js

@@ -1,237 +1,47 @@
 #!/usr/bin/env node
 /**
- * CCLI 入口 —— 命令行参数解析与启动。
+ * CCLI 入口。
  *
- * 用法：
- *   ccli                      进入交互式会话（REPL）
- *   ccli -p "提示词"           一次性（非交互）模式，输出后退出
- *   ccli --model <id>         指定模型
- *   ccli config               配置 API Key
- *   ccli --version / --help
+ * 第二步：解析命令行参数。
+ *   ccli --version / -v   打印版本号
+ *   ccli --help    / -h   打印帮助
+ *   ccli                  （暂时）打印占位问候，后续接入交互式会话
+ *   ccli --xxx            未知标志 → 报错并给出提示，退出码 1
  */
-import * as readline from 'node:readline/promises';
-import { stdin, stdout } from 'node:process';
-import { Config, DEFAULT_MODEL } from './config/config.js';
-import { Session } from './cli/session.js';
-import { c, brand } from './ui/theme.js';
-import { box } from './ui/markdown.js';
-import { runHeadless } from './cli/headless.js';
-import { SessionStore } from './session/store.js';
-import { loadDotenv } from './config/dotenv.js';
-const VERSION = '1.0.0';
-function parseArgs(argv) {
-    const args = { cwd: process.cwd() };
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        switch (a) {
-            case '-p':
-            case '--print':
-                args.prompt = argv[++i];
-                break;
-            case '--model':
-            case '-m':
-                args.model = argv[++i];
-                break;
-            case '--cwd':
-                args.cwd = argv[++i];
-                break;
-            case '--dangerously-skip-permissions':
-            case '--yes':
-            case '-y':
-                args.autoApprove = true;
-                break;
-            case '--continue':
-            case '-c':
-                args.continueSession = true;
-                break;
-            case '--resume':
-            case '-r': {
-                args.resume = true;
-                const next = argv[i + 1];
-                if (next && !next.startsWith('-')) {
-                    args.resumeId = next;
-                    i++;
-                }
-                break;
-            }
-            case '--version':
-            case '-v':
-                args.command = 'version';
-                break;
-            case '--help':
-            case '-h':
-                args.command = 'help';
-                break;
-            case 'config':
-                args.command = 'config';
-                break;
-            default:
-                // 把裸参数当作 prompt
-                if (!a.startsWith('-') && !args.prompt) {
-                    args.prompt = argv.slice(i).join(' ');
-                    i = argv.length;
-                }
-        }
-    }
-    return args;
-}
-function printHelp() {
-    const lines = [
-        brand.primary(c.bold('CCLI')) + c.dim(`  v${VERSION} —— AI 软件工程师（Claude Code 复刻）`),
-        '',
-        c.bold('用法'),
-        `  ${brand.accent('ccli')}                      进入交互式会话`,
-        `  ${brand.accent('ccli "重构 utils 模块"')}    直接给出目标并进入会话`,
-        `  ${brand.accent('ccli -p "..."')}             一次性模式（输出后退出，适合脚本/管道）`,
-        `  ${brand.accent('ccli config')}               配置 API Key`,
-        '',
-        c.bold('选项'),
-        `  ${c.cyan('-p, --print <文本>')}        非交互模式`,
-        `  ${c.cyan('-m, --model <id>')}          指定模型（默认 claude-opus-4-8）`,
-        `  ${c.cyan('-y, --yes')}                 自动批准所有工具调用`,
-        `  ${c.cyan('-c, --continue')}            恢复本目录最近一次会话`,
-        `  ${c.cyan('-r, --resume [id]')}         列出/恢复历史会话`,
-        `  ${c.cyan('--cwd <目录>')}              指定工作目录`,
-        `  ${c.cyan('-v, --version')}             版本号`,
-        `  ${c.cyan('-h, --help')}                帮助`,
-        '',
-        c.bold('环境变量'),
-        `  ${c.cyan('ANTHROPIC_API_KEY')}        Anthropic API 密钥`,
-        `  ${c.cyan('ANTHROPIC_BASE_URL')}       自定义 API 端点（可选）`,
-    ];
-    stdout.write(box(lines) + '\n');
-}
-async function onboardApiKey(config) {
-    stdout.write(box([
-        brand.primary(c.bold('欢迎使用 CCLI')),
-        '',
-        '首次使用,先配置一个模型后端(将保存到 ~/.ccli/config.json)。',
-        '',
-        `  ${brand.accent('1')}  通义千问 Qwen ${c.dim('(OpenAI 兼容,推荐)')}`,
-        `  ${brand.accent('2')}  Anthropic Claude`,
-        `  ${brand.accent('3')}  其他 OpenAI 兼容后端 ${c.dim('(DeepSeek / GLM / 自建)')}`,
-    ], { color: brand.warn }) + '\n');
-    const rl = readline.createInterface({ input: stdin, output: stdout });
-    try {
-        const choice = (await rl.question(brand.primary('选择后端 [1] ❯ '))).trim() || '1';
-        if (choice === '2') {
-            config.data.provider = 'anthropic';
-            const key = (await rl.question(brand.primary('Anthropic API Key ❯ '))).trim();
-            if (!key)
-                return false;
-            config.data.apiKey = key;
-            config.data.baseURL = undefined;
-            config.data.model = DEFAULT_MODEL;
-        }
-        else if (choice === '3') {
-            config.data.provider = 'openai';
-            const base = (await rl.question(brand.primary('Base URL ❯ '))).trim();
-            const model = (await rl.question(brand.primary('模型 ID ❯ '))).trim();
-            const key = (await rl.question(brand.primary('API Key ❯ '))).trim();
-            if (!key || !base || !model)
-                return false;
-            config.data.apiKey = key;
-            config.data.baseURL = base;
-            config.data.model = model;
-        }
-        else {
-            // 默认:千问
-            config.data.provider = 'openai';
-            const key = (await rl.question(brand.primary('千问 API Key ') + c.dim('(sk-...) ❯ '))).trim();
-            if (!key)
-                return false;
-            config.data.apiKey = key;
-            config.data.baseURL =
-                'https://dashscope.aliyuncs.com/compatible-mode/v1';
-            const model = (await rl.question(brand.primary('模型 ') + c.dim('[qwen-plus] ❯ '))).trim();
-            config.data.model = model || 'qwen-plus';
-        }
-    }
-    finally {
-        rl.close();
-    }
-    config.saveGlobal();
-    stdout.write(brand.ok('✓ 已保存配置。') +
-        c.dim(` 后端 ${config.data.provider} · 模型 ${config.data.model}\n\n`));
-    return true;
-}
-async function main() {
+import { parseArgs } from './args.js';
+import { NAME, VERSION } from './version.js';
+import { startRepl } from './repl.js';
+const HELP = `${NAME} v${VERSION}
+
+用法:
+  ccli [选项]
+
+选项:
+  -v, --version   打印版本号
+  -h, --help      打印本帮助
+
+示例:
+  ccli            启动 CCLI
+  ccli --version  查看版本
+`;
+function main() {
+    // argv 前两个是 node 路径和脚本路径，从第 3 个起才是用户输入
     const args = parseArgs(process.argv.slice(2));
-    // 本地开发:自动加载 .env(不覆盖真实环境变量)
-    loadDotenv(args.cwd);
-    if (args.command === 'version') {
-        stdout.write(`ccli v${VERSION}\n`);
-        return;
+    if (args.unknown.length > 0) {
+        console.error(`未知选项: ${args.unknown.join(', ')}`);
+        console.error(`运行 "ccli --help" 查看可用选项。`);
+        process.exit(1);
     }
-    if (args.command === 'help') {
-        printHelp();
+    if (args.help) {
+        console.log(HELP);
         return;
     }
-    const config = new Config(args.cwd);
-    if (args.model) {
-        config.model = args.model;
-    }
-    if (args.autoApprove) {
-        config.data.autoApprove = true;
-    }
-    if (args.command === 'config') {
-        await onboardApiKey(config);
-        stdout.write([
-            `当前模型：${brand.accent(config.model)}`,
-            `配置文件：~/.ccli/config.json`,
-        ].join('\n') + '\n');
+    if (args.version) {
+        console.log(VERSION);
         return;
     }
-    // 检查 API Key
-    if (!config.apiKey) {
-        if (args.prompt) {
-            stdout.write(brand.err('错误：') +
-                '未设置 API Key。请先运行 ccli(无参数,引导配置),或 export ANTHROPIC_API_KEY / QWEN_API_KEY。\n');
-            process.exit(1);
-        }
-        const ok = await onboardApiKey(config);
-        if (!ok || !config.apiKey) {
-            stdout.write(c.dim('已退出。设置 API Key 后再运行 ccli。\n'));
-            process.exit(0);
-        }
-    }
-    // 一次性模式
-    if (args.prompt) {
-        await runHeadless(config, args.cwd, args.prompt);
-        return;
-    }
-    // 会话恢复
-    let resumeFrom;
-    if (args.resume && !args.resumeId) {
-        // 列出供选择
-        const all = SessionStore.list(args.cwd);
-        if (!all.length) {
-            stdout.write(c.dim('该目录暂无历史会话，将开启新会话。\n'));
-        }
-        else {
-            stdout.write(brand.primary('该目录的历史会话：\n'));
-            for (const s of all.slice(0, 10)) {
-                stdout.write(`  ${brand.accent(s.id)}  ${c.dim(s.updatedAt.replace('T', ' ').slice(0, 16))}  ${c.dim(`${s.messages.length} 条`)}\n`);
-            }
-            stdout.write(c.dim('用 ccli --resume <id> 恢复指定会话。本次将开启新会话。\n\n'));
-        }
-    }
-    else if ((args.continueSession || args.resumeId) && config.apiKey) {
-        const data = SessionStore.load(args.cwd, args.resumeId);
-        if (data) {
-            resumeFrom = data;
-            config.model = data.model;
-            stdout.write(c.dim(`已恢复会话 ${data.id}（${data.messages.length} 条历史）。\n\n`));
-        }
-        else {
-            stdout.write(c.dim('未找到可恢复的会话，将开启新会话。\n\n'));
-        }
-    }
-    // 交互式会话
-    const session = new Session(config, args.cwd, resumeFrom);
-    await session.start();
+    // 无参数：进入交互式会话循环。
+    startRepl();
 }
-main().catch((e) => {
-    stdout.write(brand.err('\n致命错误：') + (e?.stack ?? e?.message ?? String(e)) + '\n');
-    process.exit(1);
-});
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,IAAI,GAAG,GAAG,IAAI,KAAK,OAAO;;;;;;;;;;;;CAY/B,CAAC;AAEF,SAAS,IAAI;IACT,uCAAuC;IACvC,MAAM,IAAI,GACV,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO;IACX,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO;IACX,CAAC;IAED,iBAAiB;IACjB,SAAS,EAAE,CAAC;AAChB,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/repl.js

@@ -0,0 +1,59 @@
+/**
+ * 交互式会话循环（REPL：Read-Eval-Print-Loop）。
+ *
+ * 本步只搭骨架，不接 AI：
+ *   读一行用户输入 → 处理（暂时只回显）→ 打印提示符，再读下一行。
+ * 支持优雅退出：/exit、/quit，或按 Ctrl-D（EOF）、Ctrl-C。
+ *
+ * 用 Node 内置 readline，零依赖。等骨架稳定后，下一步把「处理」那一环
+ * 换成「调用 AI」即可，循环结构不用动。
+ */
+import { createInterface } from 'node:readline';
+import { NAME, VERSION } from './version.js';
+import { loadConfig, maskKey } from './config.js';
+const PROMPT = '› ';
+/** 用户输入这些即退出。 */
+const EXIT_COMMANDS = new Set(['/exit', '/quit']);
+export function startRepl() {
+    // 启动即解析配置：缺失就明确报错退出，不进入循环
+    const result = loadConfig();
+    if (!result.ok) {
+        console.error(result.message);
+        process.exit(1);
+    }
+    const { config } = result;
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: PROMPT,
+    });
+    console.log(`${NAME} v${VERSION}`);
+    console.log(`后端: ${config.provider}  模型: ${config.model}  密钥: ${maskKey(config.apiKey)}`);
+    console.log('进入交互式会话。输入 /exit 退出，或按 Ctrl-C。\n');
+    rl.prompt();
+    rl.on('line', (line) => {
+        const input = line.trim();
+        if (input.length === 0) {
+            // 空行：不处理，直接再次提示
+            rl.prompt();
+            return;
+        }
+        if (EXIT_COMMANDS.has(input)) {
+            rl.close();
+            return;
+        }
+        // 暂时的「处理」：回显。下一步换成调用 AI。
+        console.log(`你说：${input}`);
+        rl.prompt();
+    });
+    // Ctrl-D（EOF）或 rl.close() 触发
+    rl.on('close', () => {
+        console.log('\n再见 👋');
+        process.exit(0);
+    });
+    // Ctrl-C：关闭循环（进而触发 close）
+    rl.on('SIGINT', () => {
+        rl.close();
+    });
+}
+//# sourceMappingURL=repl.js.map

package/dist/repl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.js","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,GAAG,IAAI,CAAC;AAEpB,iBAAiB;AACjB,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAElD,MAAM,UAAU,SAAS;IACrB,0BAA0B;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE1B,MAAM,EAAE,GAAG,eAAe,CAAC;QACvB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,MAAM;KACjB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CACP,OAAO,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,KAAK,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAC/E,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,EAAE,CAAC,MAAM,EAAE,CAAC;IAEZ,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE1B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,gBAAgB;YAChB,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACX,CAAC;QAED,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACX,CAAC;QAED,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;QAE3B,EAAE,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAChB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACjB,EAAE,CAAC,KAAK,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/version.js

@@ -0,0 +1,13 @@
+/**
+ * 读取自身版本号。
+ *
+ * 版本号的唯一真相是 package.json，运行时从那里读，避免手写常量导致不同步。
+ * 编译后 dist/version.js 在 dist/ 下，package.json 在其上一级，故用 ../package.json。
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+export const NAME = pkg.name;
+export const VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAGnD,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;AAC7B,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gird/ccli",
-  "version": "1.0.1",
-  "description": "CCLI —— 代理型（Agentic）终端 AI 编程助手,支持 Anthropic 与 OpenAI 兼容后端(通义千问/DeepSeek/GLM)",
+  "version": "2.0.0",
+  "description": "CCLI —— 一步一步从零实现的代理型（Agentic）终端 AI 编程助手",
   "type": "module",
   "bin": {
     "ccli": "./dist/index.js"
@@ -9,9 +9,7 @@
   "main": "./dist/index.js",
   "files": [
     "dist",
-    "README.md",
-    "CCLI.md",
-    ".env.example"
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
@@ -27,10 +25,7 @@
     "ai",
     "cli",
     "agent",
-    "coding-assistant",
-    "anthropic",
-    "qwen",
-    "openai"
+    "coding-assistant"
   ],
   "repository": {
     "type": "git",
@@ -40,15 +35,10 @@
     "url": "https://github.com/GridGit/ai-cli/issues"
   },
   "homepage": "https://github.com/GridGit/ai-cli#readme",
-  "author": "",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.104.1",
-    "openai": "^6.42.0"
-  },
   "devDependencies": {
     "@types/node": "^25.9.3",
     "tsx": "^4.22.4",

package/.env.example

@@ -1,23 +0,0 @@
-# CCLI 本地开发默认配置
-# 用法:复制本文件为 .env,填入 API Key 即可。
-#   cp .env.example .env
-# .env 已被 .gitignore 忽略,不会提交。启动时自动加载(真实环境变量优先)。
-
-# ───────────────────────────────────────────────
-# 后端二选一(不设 ANTHROPIC_API_KEY 时自动用 OpenAI 兼容后端)
-# ───────────────────────────────────────────────
-
-# 【方式 A】通义千问 Qwen(OpenAI 兼容,推荐用于本地开发)
-QWEN_API_KEY=sk-在这里填入你的千问key
-QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
-QWEN_MODEL=qwen-plus
-
-# 【方式 B】Anthropic 官方(若有 Claude key,取消注释即可,会优先生效)
-# ANTHROPIC_API_KEY=sk-ant-...
-# ANTHROPIC_BASE_URL=https://api.anthropic.com
-
-# 【方式 C】其他 OpenAI 兼容后端(DeepSeek / GLM / 自建)
-# OPENAI_API_KEY=...
-# OPENAI_BASE_URL=https://your-endpoint/v1
-# CCLI_MODEL=your-model
-# CCLI_PROVIDER=openai