@gird/ccli 1.0.2 → 2.0.1

package/README.md

@@ -4,26 +4,17 @@
 [![license](https://img.shields.io/npm/l/@gird/ccli.svg)](./LICENSE)
 [![node](https://img.shields.io/node/v/@gird/ccli.svg)](https://nodejs.org)
 
-**CCLI** 是一个运行在终端里的**代理型（Agentic）AI 编程助手**。你给出高层目标，它自主地阅读代码、检索、执行命令、修改文件并验证结果，直到任务完成——而不只是回答一个问题。
+**CCLI** —— 一个**从零开始、一步一步**实现的代理型（Agentic）终端 AI 编程助手。
 
-它支持 **Anthropic Claude** 与 **OpenAI 兼容**后端（通义千问 Qwen、DeepSeek、GLM 等），完整的工具调用与多轮代理循环在两类后端上均可用。
+> ⚠️ **重建中（work in progress）**：本项目正在从零逐步重写，力求每一步都简单、可读、可运行。
+> 当前进度见下方「实现进度」。每一步都配有说明文档，放在 [`docs/steps/`](docs/steps/)。
 
-```bash
-npm install -g @gird/ccli
-ccli            # 首次运行会引导你配置模型与密钥
-```
-
----
+## 为什么重写
 
-## 特性
-
-- **代理循环** —— 感知（读文件 / 跑命令 / 检索）→ 推理 → 行动 → 验证，自动多轮直到目标完成。
-- **多后端** —— 一套接口适配 Anthropic Messages API 与 OpenAI Chat Completions（千问 / DeepSeek / GLM…），自动识别。
-- **丰富工具集** —— 读写与精确编辑文件、grep / glob 检索、shell 执行、网页抓取、子代理调研、任务清单。
-- **安全可控** —— 只读操作放行；写文件 / 执行命令前显式授权；高危命令（`rm -rf`、`git push`…）告警；支持钩子拦截。
-- **上下文工程** —— 自动索引项目结构、注入 `CCLI.md` 项目记忆、`/compact` 压缩、`/cost` 成本统计。
-- **顺手的交互** —— 流式 Markdown 渲染、`@文件` 引用、`!` 直通 shell、`#` 写长期记忆、会话恢复、自定义斜杠命令。
-- **零重型依赖** —— 纯 TypeScript 实现，运行时仅依赖官方 SDK。
+上一版实现一次性堆了太多功能，代码复杂到难以通读。现在推倒重来，遵循一个原则：
+**从最小可运行的骨架开始，每次只加一个能独立讲清楚的功能，并为它写一份文档**
+（这一步做什么、怎么做的、遇到什么问题、下一步是什么）。目标是过程可追、代码好懂，
+最终长成一个可发布的工具。
 
 ## 安装
 
@@ -33,18 +24,17 @@ npm install -g @gird/ccli
 
 要求 Node.js ≥ 18。
 
-## 快速开始
+## 用法
 
 ```bash
-ccli                          # 进入交互式会话，首次运行引导配置
-ccli "为这个项目添加单元测试"    # 直接给出目标
-ccli -p "总结 src 的结构"       # 一次性模式（适合脚本 / 管道）
+ccli              # 进入交互式会话
+ccli --version    # 打印版本号
+ccli --help       # 打印帮助
 ```
 
 ## 配置
 
-CCLI 自动识别后端协议。密钥来源优先级：**环境变量 > 项目 `.env` > 全局 `~/.ccli/config.json`**。
-首次运行 `ccli` 会弹出引导菜单帮你完成配置，也可手动设置：
+密钥来源优先级：**环境变量 > 项目 `.env` > 全局 `~/.ccli/config.json`**。
 
 **Anthropic Claude**
 
@@ -58,47 +48,18 @@ export ANTHROPIC_API_KEY=sk-ant-...
 export QWEN_API_KEY=sk-...
 export QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
 export QWEN_MODEL=qwen-plus
-# 或通用：OPENAI_API_KEY / OPENAI_BASE_URL / CCLI_MODEL / CCLI_PROVIDER=openai
+# 或通用：OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_MODEL
 ```
 
-## 命令行用法
-
-```bash
-ccli [目标]            进入交互式会话（可附带初始目标）
-ccli -p, --print <文本>   一次性模式，输出后退出
-ccli -m, --model <id>     指定模型，如 -m qwen-max
-ccli -c, --continue       恢复本目录最近一次会话
-ccli -r, --resume [id]    列出 / 恢复历史会话
-ccli -y, --yes            自动批准所有工具（慎用）
-ccli config               配置密钥
-ccli -h, --help           查看帮助
-```
-
-## 交互
-
-进入会话后，输入框支持：
-
-| 输入 | 作用 |
-| --- | --- |
-| 直接输入 | 与 AI 对话，触发代理循环 |
-| `@<路径>` | 将文件 / 目录内容并入消息 |
-| `!<命令>` | 直接执行 shell 命令 |
-| `#<文字>` | 将一条规则写入 `CCLI.md`（长期记忆） |
-
-常用斜杠命令：`/help` `/model` `/cost` `/init` `/commit` `/resume` `/compact` `/clear` `/auto` `/exit`。
-在 `.ccli/commands/<名>.md` 放置提示词模板即可定义自定义命令 `/<名>`。
-
-## 工具
+## 实现进度
 
-| 工具 | 类型 | 说明 |
+| 步骤 | 内容 | 文档 |
 | --- | --- | --- |
-| `read_file` / `list_dir` | 感知 | 读取文件（带行号）、列目录 |
-| `grep` / `glob` | 感知 | 正则检索内容、按模式匹配文件 |
-| `web_fetch` | 感知 | 抓取网页并转为文本 |
-| `write_file` / `edit_file` | 行动 | 创建 / 覆盖、精确替换编辑（带行级 diff） |
-| `bash` | 行动 | 执行 shell 命令（受权限约束，高危告警） |
-| `todo_write` | 协调 | 维护多步任务清单并实时显示进度 |
-| `task` | 协调 | 派生只读子代理执行聚焦调研 |
+| 01 | 最小可执行入口 | [docs/steps/01-入口.md](docs/steps/01-入口.md) |
+| 02 | 命令行参数解析（`--version` / `--help`） | [docs/steps/02-参数解析.md](docs/steps/02-参数解析.md) |
+| 03 | 交互式会话循环（REPL） | [docs/steps/03-交互循环.md](docs/steps/03-交互循环.md) |
+| 04 | 配置与密钥读取 | [docs/steps/04-配置读取.md](docs/steps/04-配置读取.md) |
+| … | 接入 AI、工具调用、代理循环… | 进行中 |
 
 ## 本地开发
 
@@ -107,7 +68,7 @@ git clone https://github.com/GridGit/ai-cli.git
 cd ai-cli
 npm install
 cp .env.example .env          # 填入密钥
-npm run dev -- "你的目标"      # 用 tsx 直接运行源码
+npm run dev                   # 用 tsx 直接运行源码（免编译）
 npm run build                 # 编译到 dist/
 ```
 

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"}