repowiki-agent 0.1.0

package/dist/commands/config.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const configCommand: Command;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,aAAa,SACW,CAAC"}

package/dist/commands/config.js

@@ -0,0 +1,71 @@
+import { Command } from 'commander';
+import { loadLLMConfig, saveGlobalConfig } from 'repowiki-core';
+import chalk from 'chalk';
+export const configCommand = new Command('config')
+    .description('管理全局 LLM API 鉴权配置');
+// 配置键名映射转换
+function normalizeKey(key) {
+    const k = key.toLowerCase();
+    if (k === 'endpoint' || k === 'apiendpoint')
+        return 'apiEndpoint';
+    if (k === 'model' || k === 'modelname')
+        return 'modelName';
+    if (k === 'key' || k === 'apikey')
+        return 'apiKey';
+    return null;
+}
+configCommand
+    .command('set')
+    .arguments('<key> <value>')
+    .description('设置全局配置（例如：endpoint, model, key）')
+    .action(async (key, value) => {
+    const field = normalizeKey(key);
+    if (!field) {
+        console.error(chalk.red(`❌ 无效的配置项: "${key}"。可选：endpoint, model, key`));
+        process.exit(1);
+    }
+    try {
+        await saveGlobalConfig({ [field]: value });
+        console.log(chalk.green(`✓ 成功将全局配置 [${field}] 设置为: "${value}"`));
+    }
+    catch (err) {
+        console.error(chalk.red('❌ 保存配置失败:'), err?.message || err);
+        process.exit(1);
+    }
+});
+configCommand
+    .command('get')
+    .arguments('[key]')
+    .description('查看全局配置')
+    .action(async (key) => {
+    try {
+        const config = await loadLLMConfig();
+        if (key) {
+            const field = normalizeKey(key);
+            if (!field) {
+                console.error(chalk.red(`❌ 无效的配置项: "${key}"。可选：endpoint, model, key`));
+                process.exit(1);
+            }
+            let value = config[field];
+            if (field === 'apiKey' && value) {
+                // 脱敏显示
+                value = value.slice(0, 6) + '...' + value.slice(-4);
+            }
+            console.log(`${field}: ${value || chalk.gray('(未设置)')}`);
+        }
+        else {
+            console.log(chalk.bold('\n⚙️ 全局配置预览:'));
+            console.log(`  apiEndpoint: ${config.apiEndpoint}`);
+            console.log(`  modelName:   ${config.modelName}`);
+            const maskedKey = config.apiKey
+                ? config.apiKey.slice(0, 6) + '...' + config.apiKey.slice(-4)
+                : chalk.gray('(未设置)');
+            console.log(`  apiKey:      ${maskedKey}\n`);
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('❌ 获取配置失败:'), err?.message || err);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAkB,MAAM,eAAe,CAAC;AAChF,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC7C,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAEtC,WAAW;AACX,SAAS,YAAY,CAAC,GAAW;IAC7B,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IAClE,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IAC3D,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACnD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,aAAa;KACR,OAAO,CAAC,KAAK,CAAC;KACd,SAAS,CAAC,eAAe,CAAC;KAC1B,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IACzB,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,GAAG,2BAA2B,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,gBAAgB,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,KAAK,WAAW,KAAK,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC,CAAC,CAAC;AAEP,aAAa;KACR,OAAO,CAAC,KAAK,CAAC;KACd,SAAS,CAAC,OAAO,CAAC;KAClB,WAAW,CAAC,QAAQ,CAAC;KACrB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAClB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;QAErC,IAAI,GAAG,EAAE,CAAC;YACN,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,GAAG,2BAA2B,CAAC,CAAC,CAAC;gBACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YAED,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC;gBAC9B,OAAO;gBACP,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAClD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM;gBAC3B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC7D,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,kBAAkB,SAAS,IAAI,CAAC,CAAC;QACjD,CAAC;IACL,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/generate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const generateCommand: Command;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,eAAe,SAoEtB,CAAC"}

package/dist/commands/generate.js

@@ -0,0 +1,76 @@
+import { Command } from 'commander';
+import { runPipeline } from 'repowiki-core';
+import chalk from 'chalk';
+import ora from 'ora';
+import * as path from 'node:path';
+export const generateCommand = new Command('generate')
+    .arguments('[path]')
+    .description('为指定的项目目录生成 Wiki 文档')
+    .option('-o, --output <dir>', 'Wiki 输出目录（默认: <path>/docs/wiki）')
+    .option('-m, --model <model>', '使用的大语言模型名称')
+    .option('-c, --concurrency <number>', '并发大模型请求数', (val) => parseInt(val, 10), 3)
+    .option('--skip-llm', '免大模型，仅基于本地模板快速生成文档结构')
+    .option('--json-stdout', '以 JSON Lines 格式流式输出执行进度（适用于集成 IDE 插件）')
+    .action(async (targetPath, options) => {
+    const workspacePath = path.resolve(targetPath || '.');
+    const outputDir = options.output ? path.resolve(options.output) : undefined;
+    const jsonStdout = !!options.jsonStdout;
+    let spinner = null;
+    if (!jsonStdout) {
+        console.log(chalk.bold.cyan('\n🚀 开始运行 RepoWiki 文档生成引擎...\n'));
+        spinner = ora('初始化环境中...').start();
+    }
+    const handleProgress = (event) => {
+        if (jsonStdout) {
+            // 流式输出 JSONL
+            console.log(JSON.stringify(event));
+            return;
+        }
+        if (!spinner)
+            return;
+        if (event.type === 'PROGRESS') {
+            spinner.text = chalk.dim(`[${event.stage}] `) + event.message;
+            // 根据阶段定制颜色或特定显示
+            if (event.stage === 'Scanning') {
+                spinner.color = 'blue';
+            }
+            else if (event.stage === 'Analysis') {
+                spinner.color = 'magenta';
+            }
+            else if (event.stage === 'LLM Inference') {
+                spinner.color = 'yellow';
+            }
+            else {
+                spinner.color = 'cyan';
+            }
+        }
+        else if (event.type === 'DONE') {
+            spinner.succeed(chalk.green('文档生成完成！'));
+            console.log('\n' + chalk.bold.green('✨ 生成结果详情:'));
+            console.log(chalk.gray('  - 输出目录: ') + chalk.underline.cyan(event.payload.docsPath));
+            console.log(chalk.gray('  - 生成文件数: ') + chalk.bold(event.payload.pagesCount) + ' 个\n');
+        }
+        else if (event.type === 'ERROR') {
+            spinner.fail(chalk.red('文档生成失败！'));
+            console.error('\n' + chalk.red(`❌ [错误码 ${event.code}] `) + event.message + '\n');
+        }
+    };
+    try {
+        await runPipeline({
+            workspacePath,
+            outputDir,
+            modelName: options.model,
+            concurrency: options.concurrency,
+            skipLlm: !!options.skipLlm,
+            onProgress: handleProgress,
+        });
+    }
+    catch (err) {
+        if (jsonStdout) {
+            // runPipeline 内部已经输出了 ERROR 事件，这里捕获只作为最终异常退出
+            process.exit(1);
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/login.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const loginCommand: Command;
+//# sourceMappingURL=login.d.ts.map

package/dist/commands/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,YAAY,SAoDnB,CAAC"}

package/dist/commands/login.js

@@ -0,0 +1,52 @@
+import { Command } from 'commander';
+import { loadLLMConfig, saveGlobalConfig } from 'repowiki-core';
+import chalk from 'chalk';
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+export const loginCommand = new Command('login')
+    .description('交互式配置大语言模型（LLM）API 鉴权凭证')
+    .action(async () => {
+    console.log(chalk.bold.cyan('\n🗝️  RepoWiki 鉴权登录向导\n'));
+    const rl = readline.createInterface({ input, output });
+    try {
+        const currentConfig = await loadLLMConfig();
+        // 1. 获取 API Endpoint
+        const endpointPrompt = `请输入 API 端点地址 ${chalk.gray(`[默认: ${currentConfig.apiEndpoint || 'https://api.openai.com/v1'}]: `)}`;
+        const endpointInput = await rl.question(endpointPrompt);
+        const apiEndpoint = endpointInput.trim() || currentConfig.apiEndpoint || 'https://api.openai.com/v1';
+        // 2. 获取 Model Name
+        const modelPrompt = `请输入默认模型名称 ${chalk.gray(`[默认: ${currentConfig.modelName || 'gpt-4o'}]: `)}`;
+        const modelInput = await rl.question(modelPrompt);
+        const modelName = modelInput.trim() || currentConfig.modelName || 'gpt-4o';
+        // 3. 获取 API Key
+        const hasExistingKey = !!currentConfig.apiKey;
+        const keyPromptStr = hasExistingKey
+            ? `请输入 API 密钥 (API Key) ${chalk.gray(`[留空保留已有密钥: ${currentConfig.apiKey.slice(0, 6)}...${currentConfig.apiKey.slice(-4)}]: `)}`
+            : '请输入 API 密钥 (API Key): ';
+        const keyInput = await rl.question(keyPromptStr);
+        let apiKey = keyInput.trim();
+        if (!apiKey && hasExistingKey) {
+            apiKey = currentConfig.apiKey;
+        }
+        if (!apiKey) {
+            console.error(chalk.red('\n❌ 错误: API 密钥不能为空。'));
+            rl.close();
+            process.exit(1);
+        }
+        // 保存配置
+        await saveGlobalConfig({
+            apiEndpoint,
+            modelName,
+            apiKey,
+        });
+        console.log(chalk.green('\n✓ 凭证保存成功！配置文件路径: ~/.repowiki/config.json\n'));
+    }
+    catch (err) {
+        console.error(chalk.red('\n❌ 配置失败:'), err?.message || err);
+        process.exit(1);
+    }
+    finally {
+        rl.close();
+    }
+});
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

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

package/dist/commands/scan.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const scanCommand: Command;
+//# sourceMappingURL=scan.d.ts.map

package/dist/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,eAAO,MAAM,WAAW,SAkDlB,CAAC"}

package/dist/commands/scan.js

@@ -0,0 +1,53 @@
+import { Command } from 'commander';
+import { scanDirectory, buildTreeString, detectTechStack, detectEntrypoints, buildDependencyGraph, analyzeModules, analyzeApiRoutes, analyzeDatabaseModels, analyzeConfigs, analyzeWorkflows, } from 'repowiki-core';
+import * as path from 'node:path';
+import chalk from 'chalk';
+export const scanCommand = new Command('scan')
+    .arguments('[path]')
+    .description('对指定目录运行 AST 扫描和静态分析，并输出原始 JSON 数据')
+    .option('--pretty', '格式化输出的 JSON 文本')
+    .action(async (targetPath, options) => {
+    const workspacePath = path.resolve(targetPath || '.');
+    const pretty = !!options.pretty;
+    try {
+        const files = await scanDirectory(workspacePath);
+        const treeStr = buildTreeString(files, workspacePath);
+        const techStackResult = await detectTechStack(workspacePath, files);
+        const entrypoints = await detectEntrypoints(workspacePath, files);
+        const dependencyGraph = await buildDependencyGraph(workspacePath, files);
+        const modules = await analyzeModules(workspacePath, files, null); // 不使用 LLM
+        const apiRoutes = await analyzeApiRoutes(workspacePath, files);
+        const databaseModels = await analyzeDatabaseModels(workspacePath, files);
+        const configInfos = await analyzeConfigs(workspacePath, files);
+        const workflowInfos = await analyzeWorkflows(workspacePath, files);
+        const result = {
+            project: {
+                name: path.basename(workspacePath) || 'unnamed-project',
+                rootPath: workspacePath,
+                languages: techStackResult.languages,
+                frameworks: techStackResult.frameworks,
+                packageManagers: techStackResult.packageManagers,
+                databases: techStackResult.databases,
+                services: techStackResult.services,
+                entrypoints,
+                configFiles: techStackResult.configFiles,
+            },
+            tree: treeStr,
+            modules,
+            dependencies: dependencyGraph,
+            apiRoutes,
+            databaseModels,
+            configs: configInfos,
+            workflows: workflowInfos,
+        };
+        const jsonOutput = pretty
+            ? JSON.stringify(result, null, 2)
+            : JSON.stringify(result);
+        console.log(jsonOutput);
+    }
+    catch (err) {
+        console.error(chalk.red('❌ 扫描失败:'), err?.message || err);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { generateCommand } from './commands/generate.js';
+import { scanCommand } from './commands/scan.js';
+import { configCommand } from './commands/config.js';
+import { loginCommand } from './commands/login.js';
+const program = new Command();
+program
+    .name('repowiki')
+    .description('RepoWiki: 本地化代码库 Wiki 知识库生成工具')
+    .version('0.1.0');
+// 注册子命令
+program.addCommand(generateCommand);
+program.addCommand(scanCommand);
+program.addCommand(configCommand);
+program.addCommand(loginCommand);
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,+BAA+B,CAAC;KAC5C,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,QAAQ;AACR,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAEjC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "repowiki-agent",
+  "version": "0.1.0",
+  "description": "RepoWiki 命令行工具",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "repowiki": "dist/index.js"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "repowiki-core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "rimraf": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "start": "node dist/index.js"
+  }
+}

package/src/commands/config.ts

@@ -0,0 +1,71 @@
+import { Command } from 'commander';
+import { loadLLMConfig, saveGlobalConfig, type LLMConfig } from 'repowiki-core';
+import chalk from 'chalk';
+
+export const configCommand = new Command('config')
+    .description('管理全局 LLM API 鉴权配置');
+
+// 配置键名映射转换
+function normalizeKey(key: string): keyof LLMConfig | null {
+    const k = key.toLowerCase();
+    if (k === 'endpoint' || k === 'apiendpoint') return 'apiEndpoint';
+    if (k === 'model' || k === 'modelname') return 'modelName';
+    if (k === 'key' || k === 'apikey') return 'apiKey';
+    return null;
+}
+
+configCommand
+    .command('set')
+    .arguments('<key> <value>')
+    .description('设置全局配置（例如：endpoint, model, key）')
+    .action(async (key, value) => {
+        const field = normalizeKey(key);
+        if (!field) {
+            console.error(chalk.red(`❌ 无效的配置项: "${key}"。可选：endpoint, model, key`));
+            process.exit(1);
+        }
+
+        try {
+            await saveGlobalConfig({ [field]: value });
+            console.log(chalk.green(`✓ 成功将全局配置 [${field}] 设置为: "${value}"`));
+        } catch (err: any) {
+            console.error(chalk.red('❌ 保存配置失败:'), err?.message || err);
+            process.exit(1);
+        }
+    });
+
+configCommand
+    .command('get')
+    .arguments('[key]')
+    .description('查看全局配置')
+    .action(async (key) => {
+        try {
+            const config = await loadLLMConfig();
+
+            if (key) {
+                const field = normalizeKey(key);
+                if (!field) {
+                    console.error(chalk.red(`❌ 无效的配置项: "${key}"。可选：endpoint, model, key`));
+                    process.exit(1);
+                }
+
+                let value = config[field];
+                if (field === 'apiKey' && value) {
+                    // 脱敏显示
+                    value = value.slice(0, 6) + '...' + value.slice(-4);
+                }
+                console.log(`${field}: ${value || chalk.gray('(未设置)')}`);
+            } else {
+                console.log(chalk.bold('\n⚙️ 全局配置预览:'));
+                console.log(`  apiEndpoint: ${config.apiEndpoint}`);
+                console.log(`  modelName:   ${config.modelName}`);
+                const maskedKey = config.apiKey
+                    ? config.apiKey.slice(0, 6) + '...' + config.apiKey.slice(-4)
+                    : chalk.gray('(未设置)');
+                console.log(`  apiKey:      ${maskedKey}\n`);
+            }
+        } catch (err: any) {
+            console.error(chalk.red('❌ 获取配置失败:'), err?.message || err);
+            process.exit(1);
+        }
+    });

package/src/commands/generate.ts

@@ -0,0 +1,75 @@
+import { Command } from 'commander';
+import { runPipeline, type PipelineEvent } from 'repowiki-core';
+import chalk from 'chalk';
+import ora from 'ora';
+import * as path from 'node:path';
+
+export const generateCommand = new Command('generate')
+    .arguments('[path]')
+    .description('为指定的项目目录生成 Wiki 文档')
+    .option('-o, --output <dir>', 'Wiki 输出目录（默认: <path>/docs/wiki）')
+    .option('-m, --model <model>', '使用的大语言模型名称')
+    .option('-c, --concurrency <number>', '并发大模型请求数', (val) => parseInt(val, 10), 3)
+    .option('--skip-llm', '免大模型，仅基于本地模板快速生成文档结构')
+    .option('--json-stdout', '以 JSON Lines 格式流式输出执行进度（适用于集成 IDE 插件）')
+    .action(async (targetPath, options) => {
+        const workspacePath = path.resolve(targetPath || '.');
+        const outputDir = options.output ? path.resolve(options.output) : undefined;
+        const jsonStdout = !!options.jsonStdout;
+
+        let spinner: ReturnType<typeof ora> | null = null;
+
+        if (!jsonStdout) {
+            console.log(chalk.bold.cyan('\n🚀 开始运行 RepoWiki 文档生成引擎...\n'));
+            spinner = ora('初始化环境中...').start();
+        }
+
+        const handleProgress = (event: PipelineEvent) => {
+            if (jsonStdout) {
+                // 流式输出 JSONL
+                console.log(JSON.stringify(event));
+                return;
+            }
+
+            if (!spinner) return;
+
+            if (event.type === 'PROGRESS') {
+                spinner.text = chalk.dim(`[${event.stage}] `) + event.message;
+                // 根据阶段定制颜色或特定显示
+                if (event.stage === 'Scanning') {
+                    spinner.color = 'blue';
+                } else if (event.stage === 'Analysis') {
+                    spinner.color = 'magenta';
+                } else if (event.stage === 'LLM Inference') {
+                    spinner.color = 'yellow';
+                } else {
+                    spinner.color = 'cyan';
+                }
+            } else if (event.type === 'DONE') {
+                spinner.succeed(chalk.green('文档生成完成！'));
+                console.log('\n' + chalk.bold.green('✨ 生成结果详情:'));
+                console.log(chalk.gray('  - 输出目录: ') + chalk.underline.cyan(event.payload.docsPath));
+                console.log(chalk.gray('  - 生成文件数: ') + chalk.bold(event.payload.pagesCount) + ' 个\n');
+            } else if (event.type === 'ERROR') {
+                spinner.fail(chalk.red('文档生成失败！'));
+                console.error('\n' + chalk.red(`❌ [错误码 ${event.code}] `) + event.message + '\n');
+            }
+        };
+
+        try {
+            await runPipeline({
+                workspacePath,
+                outputDir,
+                modelName: options.model,
+                concurrency: options.concurrency,
+                skipLlm: !!options.skipLlm,
+                onProgress: handleProgress,
+            });
+        } catch (err: any) {
+            if (jsonStdout) {
+                // runPipeline 内部已经输出了 ERROR 事件，这里捕获只作为最终异常退出
+                process.exit(1);
+            }
+            process.exit(1);
+        }
+    });

package/src/commands/login.ts

@@ -0,0 +1,59 @@
+import { Command } from 'commander';
+import { loadLLMConfig, saveGlobalConfig } from 'repowiki-core';
+import chalk from 'chalk';
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+
+export const loginCommand = new Command('login')
+    .description('交互式配置大语言模型（LLM）API 鉴权凭证')
+    .action(async () => {
+        console.log(chalk.bold.cyan('\n🗝️  RepoWiki 鉴权登录向导\n'));
+
+        const rl = readline.createInterface({ input, output });
+
+        try {
+            const currentConfig = await loadLLMConfig();
+
+            // 1. 获取 API Endpoint
+            const endpointPrompt = `请输入 API 端点地址 ${chalk.gray(`[默认: ${currentConfig.apiEndpoint || 'https://api.openai.com/v1'}]: `)}`;
+            const endpointInput = await rl.question(endpointPrompt);
+            const apiEndpoint = endpointInput.trim() || currentConfig.apiEndpoint || 'https://api.openai.com/v1';
+
+            // 2. 获取 Model Name
+            const modelPrompt = `请输入默认模型名称 ${chalk.gray(`[默认: ${currentConfig.modelName || 'gpt-4o'}]: `)}`;
+            const modelInput = await rl.question(modelPrompt);
+            const modelName = modelInput.trim() || currentConfig.modelName || 'gpt-4o';
+
+            // 3. 获取 API Key
+            const hasExistingKey = !!currentConfig.apiKey;
+            const keyPromptStr = hasExistingKey
+                ? `请输入 API 密钥 (API Key) ${chalk.gray(`[留空保留已有密钥: ${currentConfig.apiKey.slice(0, 6)}...${currentConfig.apiKey.slice(-4)}]: `)}`
+                : '请输入 API 密钥 (API Key): ';
+            const keyInput = await rl.question(keyPromptStr);
+            let apiKey = keyInput.trim();
+
+            if (!apiKey && hasExistingKey) {
+                apiKey = currentConfig.apiKey;
+            }
+
+            if (!apiKey) {
+                console.error(chalk.red('\n❌ 错误: API 密钥不能为空。'));
+                rl.close();
+                process.exit(1);
+            }
+
+            // 保存配置
+            await saveGlobalConfig({
+                apiEndpoint,
+                modelName,
+                apiKey,
+            });
+
+            console.log(chalk.green('\n✓ 凭证保存成功！配置文件路径: ~/.repowiki/config.json\n'));
+        } catch (err: any) {
+            console.error(chalk.red('\n❌ 配置失败:'), err?.message || err);
+            process.exit(1);
+        } finally {
+            rl.close();
+        }
+    });

package/src/commands/scan.ts

@@ -0,0 +1,67 @@
+import { Command } from 'commander';
+import {
+    scanDirectory,
+    buildTreeString,
+    detectTechStack,
+    detectEntrypoints,
+    buildDependencyGraph,
+    analyzeModules,
+    analyzeApiRoutes,
+    analyzeDatabaseModels,
+    analyzeConfigs,
+    analyzeWorkflows,
+} from 'repowiki-core';
+import * as path from 'node:path';
+import chalk from 'chalk';
+
+export const scanCommand = new Command('scan')
+    .arguments('[path]')
+    .description('对指定目录运行 AST 扫描和静态分析，并输出原始 JSON 数据')
+    .option('--pretty', '格式化输出的 JSON 文本')
+    .action(async (targetPath, options) => {
+        const workspacePath = path.resolve(targetPath || '.');
+        const pretty = !!options.pretty;
+
+        try {
+            const files = await scanDirectory(workspacePath);
+            const treeStr = buildTreeString(files, workspacePath);
+            const techStackResult = await detectTechStack(workspacePath, files);
+            const entrypoints = await detectEntrypoints(workspacePath, files);
+            const dependencyGraph = await buildDependencyGraph(workspacePath, files);
+            const modules = await analyzeModules(workspacePath, files, null); // 不使用 LLM
+            const apiRoutes = await analyzeApiRoutes(workspacePath, files);
+            const databaseModels = await analyzeDatabaseModels(workspacePath, files);
+            const configInfos = await analyzeConfigs(workspacePath, files);
+            const workflowInfos = await analyzeWorkflows(workspacePath, files);
+
+            const result = {
+                project: {
+                    name: path.basename(workspacePath) || 'unnamed-project',
+                    rootPath: workspacePath,
+                    languages: techStackResult.languages,
+                    frameworks: techStackResult.frameworks,
+                    packageManagers: techStackResult.packageManagers,
+                    databases: techStackResult.databases,
+                    services: techStackResult.services,
+                    entrypoints,
+                    configFiles: techStackResult.configFiles,
+                },
+                tree: treeStr,
+                modules,
+                dependencies: dependencyGraph,
+                apiRoutes,
+                databaseModels,
+                configs: configInfos,
+                workflows: workflowInfos,
+            };
+
+            const jsonOutput = pretty
+                ? JSON.stringify(result, null, 2)
+                : JSON.stringify(result);
+
+            console.log(jsonOutput);
+        } catch (err: any) {
+            console.error(chalk.red('❌ 扫描失败:'), err?.message || err);
+            process.exit(1);
+        }
+    });

package/src/index.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { generateCommand } from './commands/generate.js';
+import { scanCommand } from './commands/scan.js';
+import { configCommand } from './commands/config.js';
+import { loginCommand } from './commands/login.js';
+
+const program = new Command();
+
+program
+    .name('repowiki')
+    .description('RepoWiki: 本地化代码库 Wiki 知识库生成工具')
+    .version('0.1.0');
+
+// 注册子命令
+program.addCommand(generateCommand);
+program.addCommand(scanCommand);
+program.addCommand(configCommand);
+program.addCommand(loginCommand);
+
+program.parse(process.argv);

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"]
+}