skill-any-code 1.0.0 → 1.0.1

package/dist/common/config.js

@@ -0,0 +1,213 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configManager = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const zod_1 = require("zod");
+const constants_1 = require("./constants");
+const logger_1 = require("./logger");
+const errors_1 = require("./errors");
+// V2.5：全局黑名单默认值（.gitignore 语法）
+const DEFAULT_BLACKLIST = [
+    '*.yml', '*.yaml', '*.ini', '*.cfg', '*.json', '*.toml',
+    '*.md', '*.txt', '*.rst',
+    'README*', 'LICENSE*', 'CHANGELOG*',
+    '*.lock', 'package-lock.json', 'yarn.lock',
+    '*.env*', 'credentials.*', '*.pem', '*.key',
+    // 图片与图标等常见二进制资源（需求文档 13.3 / 测试文档 16.6）
+    '*.png', '*.jpg', '*.jpeg', '*.gif',
+    '*.bmp', '*.svg', '*.webp', '*.ico',
+    'docs/', 'dist/', 'build/', 'coverage/',
+    'node_modules/', '.git/', '.skill-any-code-result/',
+    '.agents/', '.claude/', '.gitignore'
+];
+const DEFAULT_PROVIDERS = ['opencode', 'cursor', 'claude', 'codex'];
+const ConfigSchema = zod_1.z.object({
+    global: zod_1.z.object({
+        log_level: zod_1.z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+        output_format: zod_1.z.enum(['text', 'json', 'markdown']).default('text'),
+        auto_confirm: zod_1.z.boolean().default(false),
+        output_dir: zod_1.z.string().default(constants_1.DEFAULT_OUTPUT_DIR),
+    }).default({}),
+    analyze: zod_1.z.object({
+        default_mode: zod_1.z.enum(['full', 'incremental', 'auto']).default('auto'),
+        /**
+         * 最大并发数上限：
+         * - 实际默认并发 = CPU核心数 * 2；
+         * - 若 CPU*2 > max_concurrency，则使用 max_concurrency 作为上限。
+         */
+        max_concurrency: zod_1.z.number().default(constants_1.DEFAULT_CONCURRENCY),
+        default_depth: zod_1.z.number().default(-1),
+        blacklist: zod_1.z.array(zod_1.z.string()).default(DEFAULT_BLACKLIST),
+    }).default({}),
+    skills: zod_1.z.object({
+        default_providers: zod_1.z.array(zod_1.z.string()).default(DEFAULT_PROVIDERS),
+    }).default({}),
+    llm: zod_1.z.object({
+        // V2.5：默认配置中不再内置具体远程服务与模型，避免误上传代码（需求文档 13.4.1）
+        base_url: zod_1.z.string().default(''),
+        api_key: zod_1.z.string().default(''),
+        model: zod_1.z.string().default(''),
+        temperature: zod_1.z.number().min(0).max(2).default(0.1),
+        max_tokens: zod_1.z.number().int().min(100).default(4000),
+        timeout: zod_1.z.number().int().min(1000).default(60000),
+        max_retries: zod_1.z.number().int().min(0).default(3),
+        retry_delay: zod_1.z.number().int().min(100).default(1000),
+        context_window_size: zod_1.z.number().int().min(1000).default(128000),
+        cache_enabled: zod_1.z.boolean().default(true),
+        cache_dir: zod_1.z.string().default('~/.cache/skill-any-code/llm'),
+        // V2.5：新增缓存容量上限（MB），0 表示禁用磁盘缓存（需求文档 13.5.2）
+        cache_max_size_mb: zod_1.z.number().int().min(0).default(500),
+    }).default({}),
+});
+class ConfigManager {
+    config = null;
+    configPath = '';
+    getDefaultConfigPath() {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        return path_1.default.join(home, '.config', 'skill-any-code', 'config.yaml');
+    }
+    expandTilde(pathStr) {
+        if (pathStr.startsWith('~') && (pathStr.length === 1 || pathStr[1] === '/' || pathStr[1] === '\\')) {
+            const home = process.env.HOME || process.env.USERPROFILE || os_1.default.homedir();
+            return path_1.default.join(home, pathStr.slice(1));
+        }
+        return pathStr;
+    }
+    /**
+     * 加载配置文件。
+     *
+     * V2.5 起，当目标配置文件不存在时：
+     * - 不再自动创建磁盘文件（由 init 子命令负责）；
+     * - 抛出带有 ErrorCode.CONFIG_NOT_INITIALIZED 的 AppError，表示「配置未初始化」，
+     *   由 CLI 层捕获并提示用户先执行 init（测试文档 16.3 / 16.1.1）。
+     */
+    async load(customPath) {
+        this.configPath = customPath ? this.expandTilde(customPath) : this.getDefaultConfigPath();
+        // 1. 加载默认配置（作为解析/校验基线）
+        let config = ConfigSchema.parse({});
+        // 2. 加载配置文件；不存在时交由上层处理「未初始化」状态
+        if (await fs_extra_1.default.pathExists(this.configPath)) {
+            try {
+                const fileContent = await fs_extra_1.default.readFile(this.configPath, 'utf-8');
+                const fileConfig = js_yaml_1.default.load(fileContent);
+                config = ConfigSchema.parse(fileConfig);
+                logger_1.logger.debug(`Loaded config file: ${this.configPath}`);
+            }
+            catch (error) {
+                logger_1.logger.warn(`Failed to parse config file. Using defaults: ${error.message}`);
+            }
+        }
+        else {
+            // 配置文件不存在：不再隐式创建，由 CLI 的 init 子命令负责初始化
+            const defaultConfig = ConfigSchema.parse({});
+            this.config = defaultConfig;
+            throw new errors_1.AppError(errors_1.ErrorCode.CONFIG_NOT_INITIALIZED, `Config is not initialized: ${this.configPath}`);
+        }
+        // 3. 加载环境变量
+        const envConfig = {};
+        Object.entries(process.env).forEach(([key, value]) => {
+            if (!key.startsWith('SKILL_ANY_CODE_'))
+                return;
+            const configKey = key.replace('SKILL_ANY_CODE_', '').toLowerCase();
+            if (!envConfig.global)
+                envConfig.global = {};
+            if (configKey === 'log_level' && value)
+                envConfig.global.log_level = value;
+            if (configKey === 'output_format' && value)
+                envConfig.global.output_format = value;
+            if (configKey === 'auto_confirm' && value)
+                envConfig.global.auto_confirm = value === 'true';
+            if (configKey === 'output_dir' && value)
+                envConfig.global.output_dir = value;
+            if (!envConfig.analyze)
+                envConfig.analyze = {};
+            if (configKey === 'analyze_default_mode' && value)
+                envConfig.analyze.default_mode = value;
+            if (configKey === 'analyze_max_concurrency' && value)
+                envConfig.analyze.max_concurrency = Number(value);
+            if (configKey === 'analyze_default_depth' && value)
+                envConfig.analyze.default_depth = Number(value);
+            if (!envConfig.skills)
+                envConfig.skills = {};
+            if (configKey === 'skills_default_providers' && value) {
+                envConfig.skills.default_providers = value.split(',').map((s) => s.trim());
+            }
+            if (!envConfig.llm)
+                envConfig.llm = {};
+            if (configKey === 'llm_base_url' && value)
+                envConfig.llm.base_url = value;
+            if (configKey === 'llm_api_key' && value)
+                envConfig.llm.api_key = value;
+            if (configKey === 'llm_model' && value)
+                envConfig.llm.model = value;
+            if (configKey === 'llm_temperature' && value)
+                envConfig.llm.temperature = Number(value);
+            if (configKey === 'llm_max_tokens' && value)
+                envConfig.llm.max_tokens = Number(value);
+            if (configKey === 'llm_timeout' && value)
+                envConfig.llm.timeout = Number(value);
+            if (configKey === 'llm_max_retries' && value)
+                envConfig.llm.max_retries = Number(value);
+            if (configKey === 'llm_retry_delay' && value)
+                envConfig.llm.retry_delay = Number(value);
+            if (configKey === 'llm_context_window_size' && value)
+                envConfig.llm.context_window_size = Number(value);
+            if (configKey === 'llm_cache_enabled' && value)
+                envConfig.llm.cache_enabled = value === 'true';
+            if (configKey === 'llm_cache_dir' && value)
+                envConfig.llm.cache_dir = value;
+            if (configKey === 'llm_cache_max_size_mb' && value)
+                envConfig.llm.cache_max_size_mb = Number(value);
+        });
+        // 注意：配置为嵌套对象，环境变量覆盖需要做“深合并”，否则只设置某个 llm 子字段
+        // 会导致整个 llm 段被浅覆盖成不完整对象（从而触发 LLM_INVALID_CONFIG）。
+        config = ConfigSchema.parse({
+            ...config,
+            global: { ...config.global, ...(envConfig.global ?? {}) },
+            analyze: { ...config.analyze, ...(envConfig.analyze ?? {}) },
+            skills: { ...config.skills, ...(envConfig.skills ?? {}) },
+            llm: { ...config.llm, ...(envConfig.llm ?? {}) },
+        });
+        this.config = config;
+        return config;
+    }
+    getConfig() {
+        if (!this.config) {
+            throw new Error('Config not loaded. Call load() first.');
+        }
+        return this.config;
+    }
+    /**
+     * 显式初始化配置文件内容。
+     *
+     * - 当目标文件不存在时：创建目录并写入默认配置；
+     * - 当目标文件已存在时：直接覆盖为默认配置（是否覆盖由上层 CLI 交互确认）。
+     */
+    async init(customPath) {
+        this.configPath = customPath ? this.expandTilde(customPath) : this.getDefaultConfigPath();
+        const defaultConfig = ConfigSchema.parse({});
+        await fs_extra_1.default.ensureDir(path_1.default.dirname(this.configPath));
+        await fs_extra_1.default.writeFile(this.configPath, js_yaml_1.default.dump(defaultConfig), 'utf-8');
+        this.config = defaultConfig;
+        logger_1.logger.debug(`Initialized config file: ${this.configPath}`);
+    }
+    async save(config) {
+        const currentConfig = this.config || await this.load();
+        const mergedConfig = { ...currentConfig, ...config };
+        const validatedConfig = ConfigSchema.parse(mergedConfig);
+        await fs_extra_1.default.ensureDir(path_1.default.dirname(this.configPath));
+        await fs_extra_1.default.writeFile(this.configPath, js_yaml_1.default.dump(validatedConfig), 'utf-8');
+        this.config = validatedConfig;
+    }
+    async reset() {
+        const defaultConfig = ConfigSchema.parse({});
+        await this.save(defaultConfig);
+    }
+}
+exports.configManager = new ConfigManager();

package/dist/common/constants.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_OUTPUT_DIR = exports.SUPPORTED_EXTENSIONS = exports.DEFAULT_CONCURRENCY = exports.MAX_GIT_COMMITS_HISTORY = exports.SCHEMA_VERSION = exports.ANALYSIS_VERSION = void 0;
+exports.ANALYSIS_VERSION = '1.0.0';
+exports.SCHEMA_VERSION = '1.0';
+exports.MAX_GIT_COMMITS_HISTORY = 50;
+exports.DEFAULT_CONCURRENCY = require('os').cpus().length * 2;
+// 所有文本代码文件都支持，无后缀限制，由LLM自动识别语言
+exports.SUPPORTED_EXTENSIONS = ['*'];
+// V2.3：默认黑名单已迁移至 config.ts 的 DEFAULT_BLACKLIST
+exports.DEFAULT_OUTPUT_DIR = './.skill-any-code-result';

package/dist/common/errors.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppError = exports.ErrorCode = void 0;
+var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode[ErrorCode["SUCCESS"] = 200] = "SUCCESS";
+    ErrorCode[ErrorCode["PARAM_VALIDATION_FAILED"] = 4000] = "PARAM_VALIDATION_FAILED";
+    ErrorCode[ErrorCode["PROJECT_PATH_NOT_EXIST"] = 4001] = "PROJECT_PATH_NOT_EXIST";
+    ErrorCode[ErrorCode["NO_PARSER_AVAILABLE"] = 4002] = "NO_PARSER_AVAILABLE";
+    ErrorCode[ErrorCode["INCREMENTAL_NOT_AVAILABLE"] = 4003] = "INCREMENTAL_NOT_AVAILABLE";
+    ErrorCode[ErrorCode["ANALYSIS_NOT_EXIST"] = 4004] = "ANALYSIS_NOT_EXIST";
+    ErrorCode[ErrorCode["CONFIG_NOT_INITIALIZED"] = 4005] = "CONFIG_NOT_INITIALIZED";
+    ErrorCode[ErrorCode["ANALYSIS_EXCEPTION"] = 5000] = "ANALYSIS_EXCEPTION";
+    ErrorCode[ErrorCode["GIT_OPERATION_FAILED"] = 5001] = "GIT_OPERATION_FAILED";
+    ErrorCode[ErrorCode["STORAGE_WRITE_FAILED"] = 5002] = "STORAGE_WRITE_FAILED";
+    ErrorCode[ErrorCode["WORKER_SCHEDULE_FAILED"] = 5003] = "WORKER_SCHEDULE_FAILED";
+    ErrorCode[ErrorCode["LLM_CALL_FAILED"] = 5010] = "LLM_CALL_FAILED";
+    ErrorCode[ErrorCode["LLM_RESPONSE_PARSE_FAILED"] = 5011] = "LLM_RESPONSE_PARSE_FAILED";
+    ErrorCode[ErrorCode["LLM_RATE_LIMITED"] = 5012] = "LLM_RATE_LIMITED";
+    ErrorCode[ErrorCode["LLM_TIMEOUT"] = 5013] = "LLM_TIMEOUT";
+    ErrorCode[ErrorCode["LLM_INVALID_CONFIG"] = 5014] = "LLM_INVALID_CONFIG";
+    ErrorCode[ErrorCode["FILE_TOO_LARGE"] = 5020] = "FILE_TOO_LARGE";
+    ErrorCode[ErrorCode["FILE_SPLIT_FAILED"] = 5021] = "FILE_SPLIT_FAILED";
+    ErrorCode[ErrorCode["CHUNK_MERGE_FAILED"] = 5022] = "CHUNK_MERGE_FAILED";
+})(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
+class AppError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'AppError';
+        this.code = code;
+        this.details = details;
+        Object.setPrototypeOf(this, AppError.prototype);
+    }
+}
+exports.AppError = AppError;

package/dist/common/logger.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const picocolors_1 = __importDefault(require("picocolors"));
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+class Logger {
+    level = 'info';
+    // 可选的外部日志接收器（例如 CLI 多行渲染器），用于实现“日志固定在进度块下方”。
+    sink;
+    setLevel(level) {
+        this.level = level;
+    }
+    setSink(sink) {
+        this.sink = sink;
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+    }
+    write(line, isError) {
+        if (this.sink) {
+            this.sink(line, isError);
+            return;
+        }
+        if (isError) {
+            // stderr 不做颜色降级，交给调用方控制；这里保留 ANSI 颜色。
+            // eslint-disable-next-line no-console
+            console.error(line);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.log(line);
+        }
+    }
+    debug(message, ...args) {
+        if (!this.shouldLog('debug'))
+            return;
+        const line = picocolors_1.default.gray(`[DEBUG] ${message}${args.length ? ' ' + args.join(' ') : ''}`);
+        this.write(line, false);
+    }
+    info(message, ...args) {
+        if (!this.shouldLog('info'))
+            return;
+        const line = picocolors_1.default.blue(`[INFO] ${message}${args.length ? ' ' + args.join(' ') : ''}`);
+        this.write(line, false);
+    }
+    success(message, ...args) {
+        if (!this.shouldLog('info'))
+            return;
+        const line = picocolors_1.default.green(`[SUCCESS] ${message}${args.length ? ' ' + args.join(' ') : ''}`);
+        this.write(line, false);
+    }
+    warn(message, ...args) {
+        if (!this.shouldLog('warn'))
+            return;
+        const line = picocolors_1.default.yellow(`[WARN] ${message}${args.length ? ' ' + args.join(' ') : ''}`);
+        this.write(line, false);
+    }
+    error(message, error, ...args) {
+        if (!this.shouldLog('error'))
+            return;
+        const base = picocolors_1.default.red(`[ERROR] ${message}${args.length ? ' ' + args.join(' ') : ''}`);
+        this.write(base, true);
+        if (error && this.level === 'debug') {
+            const stackLine = picocolors_1.default.red(error.stack || String(error));
+            this.write(stackLine, true);
+        }
+    }
+}
+exports.logger = new Logger();

package/dist/common/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/common/ui.js

@@ -0,0 +1,201 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cliRenderer = exports.CliMultiSectionRenderer = void 0;
+exports.confirm = confirm;
+exports.select = select;
+exports.input = input;
+const inquirer_1 = __importDefault(require("inquirer"));
+const picocolors_1 = __importDefault(require("picocolors"));
+/**
+ * CLI 多行区域渲染器：统一负责
+ * - 进度行：「解析进度 |████...| 37% | 已处理: x/y 对象」
+ * - 当前对象块：
+ *   当前对象:
+ *     [ foo ]
+ *     [ bar ]
+ * - Tokens 行：「Tokens: in=... out=... total=...」
+ *
+ * 通过 ANSI 光标控制码在同一块区域内重绘，避免产生多份重复的块。
+ */
+class CliMultiSectionRenderer {
+    state = {
+        total: 0,
+        done: 0,
+        currentObjects: [],
+        totalKnown: false,
+    };
+    // 最近一次渲染占用了多少行，用于回退光标和清空
+    renderedLines = 0;
+    isInteractive;
+    constructor() {
+        this.isInteractive = !!process.stdout.isTTY && process.env.TERM !== 'dumb';
+    }
+    setTotal(total) {
+        this.state.total = total;
+        this.state.totalKnown = true;
+        if (this.state.done > total) {
+            this.state.done = total;
+        }
+        this.render();
+    }
+    updateProgress(done, total, currentPathsText, maxLines) {
+        this.state.done = done;
+        // 若 total 尚未通过 onTotalKnown 确认，则不接受外部传入的 total，避免占位魔法数字污染首帧。
+        if (this.state.totalKnown) {
+            this.state.total = total;
+        }
+        if (currentPathsText !== undefined) {
+            let lines = currentPathsText
+                .split('\n')
+                .map((l) => l.trim())
+                .filter((l) => l.length > 0);
+            if (typeof maxLines === 'number' && maxLines > 0 && lines.length > maxLines) {
+                lines = lines.slice(0, maxLines);
+            }
+            this.state.currentObjects = lines;
+        }
+        this.render();
+    }
+    updateTokens(tokens) {
+        this.state.tokens = { ...tokens };
+        this.render();
+    }
+    /**
+     * 扫描阶段：实时更新“已扫描将被解析的文件数”。
+     * 该信息以单独一行展示，并在同一位置覆盖刷新。
+     */
+    updateScanProgress(scannedFiles) {
+        this.state.scannedFiles = scannedFiles;
+        this.render();
+    }
+    /**
+     * 在进度区域下方追加一条日志。
+     * 实现方式：先清空进度区域，将日志打印到 stdout，然后重新渲染进度区域。
+     */
+    logBelow(message) {
+        if (this.isInteractive) {
+            this.clearRenderedArea();
+            process.stdout.write(message + '\n');
+            this.render();
+        }
+        else {
+            // 非交互终端下不做覆盖，仅顺序输出日志与最新快照，避免依赖 ANSI 光标控制。
+            process.stdout.write(message + '\n');
+            const lines = this.buildLines();
+            for (const line of lines) {
+                process.stdout.write(line + '\n');
+            }
+        }
+    }
+    buildLines() {
+        const { total, done, currentObjects, tokens, totalKnown, scannedFiles } = this.state;
+        const safeTotal = totalKnown && total > 0 ? total : 1;
+        const ratio = totalKnown ? Math.max(0, Math.min(1, done / safeTotal)) : 0;
+        const percentage = totalKnown ? Math.floor(ratio * 100) : 0;
+        const barWidth = 40;
+        const completeCount = Math.round(barWidth * ratio);
+        const incompleteCount = barWidth - completeCount;
+        const bar = '█'.repeat(completeCount) +
+            '░'.repeat(Math.max(0, incompleteCount));
+        const lines = [];
+        // 扫描阶段行：仅当有值时展示一行，实时覆盖刷新（对象=文件+目录）
+        if (typeof scannedFiles === 'number') {
+            lines.push(`Scanned objects to analyze: ${scannedFiles}`);
+        }
+        // 进度行（V2.4：将「已处理: x/y」拆为独立行，避免被“当前对象路径提取”误判为路径）
+        const totalLabel = totalKnown ? String(total) : '?';
+        lines.push(`${picocolors_1.default.blue('Progress')} |${picocolors_1.default.cyan(bar)}| ${percentage}%`);
+        lines.push(`Processed: ${done}/${totalLabel}`);
+        // 当前对象块
+        // 需求：仅当存在 worker 正在处理的对象时才展示该块；无对象时整段不输出（不占用任何行）。
+        if (currentObjects.length > 0) {
+            lines.push('Current:');
+            for (const obj of currentObjects) {
+                lines.push(`  [ ${obj} ]`);
+            }
+        }
+        // Tokens 行（即使 tokens 尚未产生也显示 0，避免首帧缺行导致 UI 跳变）
+        const t = tokens ?? { totalPromptTokens: 0, totalCompletionTokens: 0, totalTokens: 0, totalCalls: 0 };
+        lines.push(`Tokens: in=${t.totalPromptTokens} out=${t.totalCompletionTokens} total=${t.totalTokens}`);
+        return lines;
+    }
+    clearRenderedArea() {
+        if (!this.isInteractive || this.renderedLines <= 0)
+            return;
+        // 将光标移动到渲染块的起始行
+        process.stdout.write(`\u001b[${this.renderedLines}F`);
+        for (let i = 0; i < this.renderedLines; i += 1) {
+            // 清除当前行并换行到下一行
+            process.stdout.write('\u001b[2K\r\n');
+        }
+        // 回到块的起始位置
+        process.stdout.write(`\u001b[${this.renderedLines}F`);
+        this.renderedLines = 0;
+    }
+    render() {
+        const lines = this.buildLines();
+        if (this.isInteractive) {
+            // 将光标移到当前块顶部并清空旧内容
+            if (this.renderedLines > 0) {
+                process.stdout.write(`\u001b[${this.renderedLines}F`);
+            }
+            for (let i = 0; i < this.renderedLines; i += 1) {
+                process.stdout.write('\u001b[2K\r\n');
+            }
+            if (this.renderedLines > 0) {
+                process.stdout.write(`\u001b[${this.renderedLines}F`);
+            }
+            // 写入新内容
+            for (const line of lines) {
+                process.stdout.write('\u001b[2K'); // 清当前行
+                process.stdout.write(line + '\n');
+            }
+            this.renderedLines = lines.length;
+        }
+        else {
+            // 非交互终端：不做覆盖，仅输出一次最新快照，避免光标控制符干扰日志采集。
+            for (const line of lines) {
+                process.stdout.write(line + '\n');
+            }
+            this.renderedLines = 0;
+        }
+    }
+}
+exports.CliMultiSectionRenderer = CliMultiSectionRenderer;
+exports.cliRenderer = new CliMultiSectionRenderer();
+async function confirm(message, defaultAnswer = false) {
+    const { answer } = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'answer',
+            message,
+            default: defaultAnswer,
+        },
+    ]);
+    return answer;
+}
+async function select(message, choices) {
+    const { selected } = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'selected',
+            message,
+            choices,
+        },
+    ]);
+    return selected;
+}
+async function input(message, defaultValue) {
+    const { value } = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'value',
+            message,
+            default: defaultValue,
+        },
+    ]);
+    return value;
+}

package/dist/common/utils.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePath = normalizePath;
+exports.generateProjectSlug = generateProjectSlug;
+exports.getStoragePath = getStoragePath;
+exports.getFileOutputPath = getFileOutputPath;
+exports.getDirOutputPath = getDirOutputPath;
+exports.mapLimit = mapLimit;
+exports.getLanguageFromExtension = getLanguageFromExtension;
+const crypto = __importStar(require("crypto"));
+const path = __importStar(require("path"));
+const constants_1 = require("./constants");
+/**
+ * 规范化路径：统一使用正斜杠、移除尾部斜杠
+ * 用于索引文件中的路径标准化和 resolve 查询时的路径匹配
+ */
+function normalizePath(inputPath) {
+    let normalized = inputPath.replace(/\\/g, '/');
+    if (normalized.length > 1 && normalized.endsWith('/')) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+}
+function generateProjectSlug(projectRoot, isGit, gitSlug) {
+    if (isGit && gitSlug) {
+        return gitSlug.replace('/', '-');
+    }
+    const dirName = path.basename(projectRoot);
+    const pathHash = crypto.createHash('md5').update(projectRoot).digest('hex').slice(0, 8);
+    return `${dirName}-${pathHash}`;
+}
+function getStoragePath(projectRoot, customOutputDir) {
+    const outputDir = customOutputDir || constants_1.DEFAULT_OUTPUT_DIR;
+    // 如果是相对路径，相对于项目根目录
+    if (!path.isAbsolute(outputDir)) {
+        return path.resolve(projectRoot, outputDir);
+    }
+    return outputDir;
+}
+function getFileOutputPath(storageRoot, filePath) {
+    const parsed = path.parse(filePath);
+    // 特殊处理 index.xxx：为避免与目录级 index.md 冲突，文件结果命名为 index.xxx.md
+    if (parsed.name === 'index' && parsed.ext) {
+        return path.join(storageRoot, parsed.dir, `index${parsed.ext}.md`);
+    }
+    return path.join(storageRoot, parsed.dir, `${parsed.name}.md`);
+}
+function getDirOutputPath(storageRoot, dirPath) {
+    return path.join(storageRoot, dirPath, 'index.md');
+}
+/**
+ * 受控并发执行：同时最多 limit 个 fn 在运行，所有 items 执行完毕后 resolve。
+ */
+async function mapLimit(items, limit, fn) {
+    const concurrency = Math.max(1, Number(limit) || 1);
+    let nextIndex = 0;
+    const runners = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+        while (true) {
+            const idx = nextIndex++;
+            if (idx >= items.length)
+                return;
+            await fn(items[idx]);
+        }
+    });
+    await Promise.all(runners);
+}
+function getLanguageFromExtension(ext) {
+    const map = {
+        '.js': 'javascript',
+        '.ts': 'typescript',
+        '.jsx': 'javascript',
+        '.tsx': 'typescript',
+        '.py': 'python',
+        '.java': 'java',
+        '.go': 'go',
+        '.cpp': 'cpp',
+        '.c': 'c',
+        '.cs': 'csharp',
+        '.php': 'php',
+        '.rb': 'ruby',
+        '.rs': 'rust'
+    };
+    return map[ext.toLowerCase()] || 'unknown';
+}

package/dist/domain/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./interfaces"), exports);