repowiki-core 0.1.0

package/dist/generator/sidebar-generator.js

@@ -0,0 +1,120 @@
+import * as path from 'node:path';
+/**
+ * 提取页面所在的分组名称（即它所在的相对目录）
+ */
+function getPageGroup(page) {
+    const dir = path.dirname(page.filename);
+    if (dir === '.' || dir === '/' || !dir) {
+        return '根目录';
+    }
+    // 返回最上层或次上层的目录名作为分组名
+    return dir.replace(/\\/g, '/');
+}
+/**
+ * 清理文件名，去除 .md 后缀
+ */
+function stripMarkdownExtension(filePath) {
+    if (filePath.endsWith('.md')) {
+        return filePath.slice(0, -3);
+    }
+    return filePath;
+}
+/**
+ * 生成符合 GitHub Wiki 扁平或路径兼容的 Wiki 链接
+ * 格式：[[显示名称|路径（无后缀）]]
+ */
+function formatWikiLink(page) {
+    const cleanPath = stripMarkdownExtension(page.filename).replace(/\\/g, '/');
+    return `[[${page.title}|${cleanPath}]]`;
+}
+/**
+ * 生成 _Sidebar.md 内容，按目录分组展示
+ */
+export function generateSidebar(pages) {
+    const groups = {};
+    for (const page of pages) {
+        // 跳过 Home.md 和 _Sidebar.md 本身以避免循环链接
+        const basename = path.basename(page.filename).toLowerCase();
+        if (basename === 'home.md' || basename === '_sidebar.md') {
+            continue;
+        }
+        const group = getPageGroup(page);
+        if (!groups[group]) {
+            groups[group] = [];
+        }
+        groups[group].push(page);
+    }
+    const lines = ['# 项目文档导航', ''];
+    // 定义常见分组的优先级排序，未定义的排在后面
+    const groupOrder = [
+        '项目概述',
+        '架构设计',
+        '核心功能模块',
+        '前端应用架构',
+        '后端服务架构',
+        '数据库设计',
+        'API 参考文档',
+        'AI 集成与提示词设计',
+        '安全与认证',
+        '开发者指南',
+        '部署与运维',
+        '故障排除与常见问题',
+        '根目录',
+    ];
+    const sortedGroups = Object.keys(groups).sort((a, b) => {
+        const indexA = groupOrder.indexOf(a);
+        const indexB = groupOrder.indexOf(b);
+        if (indexA !== -1 && indexB !== -1)
+            return indexA - indexB;
+        if (indexA !== -1)
+            return -1;
+        if (indexB !== -1)
+            return 1;
+        return a.localeCompare(b);
+    });
+    for (const group of sortedGroups) {
+        const groupPages = groups[group];
+        if (group === '根目录') {
+            lines.push('### 其他文档');
+        }
+        else {
+            lines.push(`### ${group}`);
+        }
+        for (const page of groupPages) {
+            lines.push(`- ${formatWikiLink(page)}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trim() + '\n';
+}
+/**
+ * 生成 Home.md 内容，为 Wiki 主页提供项目概览及索引导航
+ */
+export function generateHome(pages, projectProfile) {
+    const lines = [];
+    lines.push(`# 欢迎使用 ${projectProfile.name} 项目 Wiki`);
+    lines.push('');
+    lines.push('这是一个由 RepoWiki 自动生成的本地代码库知识库。');
+    lines.push('');
+    // 项目基本信息卡片
+    lines.push('## 项目概要');
+    lines.push('');
+    lines.push(`- **项目名称**: \`${projectProfile.name}\``);
+    lines.push(`- **主力语言**: ${projectProfile.languages.join(', ') || '未知'}`);
+    if (projectProfile.frameworks.length > 0) {
+        lines.push(`- **使用框架**: ${projectProfile.frameworks.join(', ')}`);
+    }
+    if (projectProfile.databases.length > 0) {
+        lines.push(`- **数据库**: ${projectProfile.databases.join(', ')}`);
+    }
+    lines.push('');
+    // 全量 Wiki 导航索引
+    lines.push('## 知识库目录索引');
+    lines.push('');
+    const sidebarContent = generateSidebar(pages);
+    // 移除侧边栏标题以融合到 Home.md 中
+    const bodyContent = sidebarContent.replace('# 项目文档导航\n\n', '');
+    lines.push(bodyContent);
+    return lines.join('\n').trim() + '\n';
+}
+//# sourceMappingURL=sidebar-generator.js.map

package/dist/generator/sidebar-generator.js.map

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

package/dist/generator/wiki-generator.d.ts

@@ -0,0 +1,45 @@
+import type { AnalysisResult, WikiPage } from '../models/index.js';
+import type { LLMClient } from '../llm/index.js';
+export interface WikiGeneratorConfig {
+    outputDir: string;
+    concurrency?: number;
+}
+export interface PlannedPage {
+    title: string;
+    filename: string;
+    summary: string;
+    requiredModules: string[];
+}
+/**
+ * 核心 Wiki 生成器
+ */
+export declare class WikiGenerator {
+    private config;
+    private llmClient;
+    constructor(llmClient: LLMClient | null, config: WikiGeneratorConfig);
+    /**
+     * 规划 Wiki 页面列表
+     */
+    planPages(analysisResult: AnalysisResult): Promise<PlannedPage[]>;
+    /**
+     * 默认的 Wiki 页面规划（无 LLM 或 LLM 规划失败时使用）
+     */
+    private getDefaultPagePlan;
+    /**
+     * 对文件列表进行摘要压缩（如文件太大，先使用 LLM 摘要以节省 Context 空间）
+     */
+    private prepareSourceSummaries;
+    /**
+     * 生成单个页面内容
+     */
+    generatePage(rootPath: string, page: PlannedPage, analysisResult: AnalysisResult, existingPagesSummary?: string): Promise<WikiPage>;
+    /**
+     * 无大模型回退页面生成逻辑
+     */
+    private assembleFallbackPage;
+    /**
+     * 保存 Wiki 页面文件到 docs/wiki 目录
+     */
+    savePage(page: WikiPage): Promise<string>;
+}
+//# sourceMappingURL=wiki-generator.d.ts.map

package/dist/generator/wiki-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-generator.d.ts","sourceRoot":"","sources":["../../src/generator/wiki-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAA8B,MAAM,oBAAoB,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAUjD,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,SAAS,CAAmB;gBAExB,SAAS,EAAE,SAAS,GAAG,IAAI,EAAE,MAAM,EAAE,mBAAmB;IAQpE;;OAEG;IACU,SAAS,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA+B9E;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0C1B;;OAEG;YACW,sBAAsB;IAoDpC;;OAEG;IACU,YAAY,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,cAAc,EAAE,cAAc,EAC9B,oBAAoB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,QAAQ,CAAC;IA8BpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqD5B;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;CASzD"}

package/dist/generator/wiki-generator.js

@@ -0,0 +1,217 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { buildWikiPlanPrompt, buildWikiPagePrompt, buildSourceSummaryPrompt } from '../llm/index.js';
+import { assembleWikiPage, formatTroubleshootingTable } from './markdown-generator.js';
+import { generateArchitectureDiagram, generateERDiagram, generateDependencyDiagram, generateApiDiagram, } from './mermaid-generator.js';
+/**
+ * 核心 Wiki 生成器
+ */
+export class WikiGenerator {
+    config;
+    llmClient;
+    constructor(llmClient, config) {
+        this.llmClient = llmClient;
+        this.config = {
+            outputDir: config.outputDir,
+            concurrency: config.concurrency ?? 3,
+        };
+    }
+    /**
+     * 规划 Wiki 页面列表
+     */
+    async planPages(analysisResult) {
+        if (!this.llmClient) {
+            return this.getDefaultPagePlan(analysisResult);
+        }
+        try {
+            const modulesStr = JSON.stringify(analysisResult.modules.map((m) => ({
+                moduleName: m.moduleName,
+                directory: m.directory,
+                summary: m.summary,
+                filesCount: m.files.length,
+            })), null, 2);
+            const techStackStr = JSON.stringify(analysisResult.project, null, 2);
+            const prompt = buildWikiPlanPrompt(analysisResult.tree, techStackStr, modulesStr);
+            const planned = await this.llmClient.chatJSON(prompt);
+            if (Array.isArray(planned) && planned.length > 0) {
+                return planned;
+            }
+        }
+        catch {
+            // 回退到默认规划
+        }
+        return this.getDefaultPagePlan(analysisResult);
+    }
+    /**
+     * 默认的 Wiki 页面规划（无 LLM 或 LLM 规划失败时使用）
+     */
+    getDefaultPagePlan(analysisResult) {
+        const plan = [
+            {
+                title: '项目概述',
+                filename: '项目概述/项目概述.md',
+                summary: '项目概要介绍与基本结构',
+                requiredModules: ['.'],
+            },
+        ];
+        // 为每个主要逻辑模块分别规划一个文档页面
+        for (const mod of analysisResult.modules) {
+            if (mod.directory === '.')
+                continue;
+            plan.push({
+                title: `${mod.moduleName} 模块分析`,
+                filename: `核心功能模块/${mod.moduleName}.md`,
+                summary: `${mod.moduleName} 模块的设计与实现细节`,
+                requiredModules: [mod.directory],
+            });
+        }
+        if (analysisResult.databaseModels.length > 0) {
+            plan.push({
+                title: '数据库设计',
+                filename: '数据库设计/数据库设计.md',
+                summary: '项目数据库结构及实体模型定义',
+                requiredModules: [],
+            });
+        }
+        if (analysisResult.apiRoutes.length > 0) {
+            plan.push({
+                title: 'API 参考文档',
+                filename: 'API参考文档/API参考文档.md',
+                summary: '项目公开的 HTTP 接口路由规范',
+                requiredModules: [],
+            });
+        }
+        return plan;
+    }
+    /**
+     * 对文件列表进行摘要压缩（如文件太大，先使用 LLM 摘要以节省 Context 空间）
+     */
+    async prepareSourceSummaries(rootPath, plannedPage, analysisResult) {
+        const summaries = [];
+        // 收集所有关联模块内的文件
+        const relatedFiles = [];
+        for (const modDir of plannedPage.requiredModules) {
+            const mod = analysisResult.modules.find((m) => m.directory === modDir);
+            if (mod) {
+                relatedFiles.push(...mod.files);
+            }
+        }
+        // 如果没有关联模块，则提取根目录附近的重要源文件
+        if (relatedFiles.length === 0) {
+            relatedFiles.push(...analysisResult.modules
+                .filter((m) => m.directory !== '.')
+                .slice(0, 3)
+                .flatMap((m) => m.files.slice(0, 2)));
+        }
+        // 限制最多分析前 8 个文件，防止 Context 溢出
+        const targetFiles = relatedFiles.slice(0, 8);
+        for (const relPath of targetFiles) {
+            try {
+                const absPath = path.resolve(rootPath, relPath);
+                const content = await fs.readFile(absPath, 'utf-8');
+                // 超过 4KB 的文件进行 LLM 摘要，小文件直接使用首部几行
+                if (content.length > 4000 && this.llmClient) {
+                    const prompt = buildSourceSummaryPrompt(relPath, content.slice(0, 20000));
+                    const summaryResult = await this.llmClient.chat(prompt);
+                    summaries.push(`### 文件: ${relPath} (代码摘要)\n${summaryResult.content}`);
+                }
+                else {
+                    const lines = content.split('\n');
+                    const truncated = lines.slice(0, 100).join('\n');
+                    summaries.push(`### 文件: ${relPath}\n\`\`\`\n${truncated}\n\`\`\``);
+                }
+            }
+            catch {
+                // 忽略单个文件读取错误
+            }
+        }
+        return summaries.join('\n\n');
+    }
+    /**
+     * 生成单个页面内容
+     */
+    async generatePage(rootPath, page, analysisResult, existingPagesSummary) {
+        if (this.llmClient) {
+            try {
+                const sourceSummaries = await this.prepareSourceSummaries(rootPath, page, analysisResult);
+                const prompt = buildWikiPagePrompt(page.title, analysisResult.tree, sourceSummaries, existingPagesSummary);
+                const response = await this.llmClient.chat(prompt);
+                const content = response.content;
+                return {
+                    title: page.title,
+                    filename: page.filename,
+                    summary: page.summary,
+                    content,
+                    sourceRefs: [], // 稍后在后置处理中补充或由 LLM 直接写在 Markdown 中
+                };
+            }
+            catch {
+                // LLM 生成失败时回退到模板组装
+            }
+        }
+        // 本地模板组装（免 LLM 回退逻辑）
+        return this.assembleFallbackPage(page, analysisResult);
+    }
+    /**
+     * 无大模型回退页面生成逻辑
+     */
+    assembleFallbackPage(page, analysisResult) {
+        // 构建默认的图表
+        let archDiagram;
+        let erDiagram;
+        let depDiagram;
+        let apiDiagram;
+        if (page.title.includes('架构') || page.title.includes('概述')) {
+            archDiagram = generateArchitectureDiagram(analysisResult.modules, analysisResult.dependencies.edges || []);
+        }
+        if (page.title.includes('数据') || page.title.includes('DB') || page.filename.includes('database')) {
+            erDiagram = generateERDiagram(analysisResult.databaseModels);
+        }
+        if (page.title.includes('依赖') || page.filename.includes('dependency')) {
+            depDiagram = generateDependencyDiagram(analysisResult.modules, analysisResult.dependencies.edges || []);
+        }
+        if (page.title.includes('API') || page.filename.includes('api')) {
+            apiDiagram = generateApiDiagram(analysisResult.apiRoutes);
+        }
+        const projectRoot = analysisResult.project.rootPath;
+        const content = assembleWikiPage({
+            title: page.title,
+            citeRefs: [],
+            projectRoot,
+            introduction: `该文档是针对 "${page.title}" 模块的自动生成概要文档。\n${page.summary}`,
+            projectStructure: '项目整体目录结构树状视图如下。',
+            projectStructureDiagram: 'flowchart TD\n    Root["项目根目录"]', // 简易树
+            coreComponents: '以下是该页面对应模块的核心类与组件列表。',
+            architectureOverview: archDiagram ? '项目整体模块架构设计及数据交互图如下。' : undefined,
+            architectureDiagram: archDiagram,
+            detailedAnalysis: erDiagram ? '数据表关系 (ER) 设计图如下。' : undefined,
+            troubleshooting: formatTroubleshootingTable([
+                {
+                    problem: '模块无法加载/包缺失',
+                    cause: '依赖未正确安装',
+                    resolution: '在根目录下运行 `pnpm install` 或对应的依赖安装指令。',
+                },
+            ]),
+            conclusion: '文档自动构建完毕，详细系统设计请参考内部核心组件代码。',
+            appendix: `技术栈详情: ${analysisResult.project.languages.join(', ')}`,
+        });
+        return {
+            title: page.title,
+            filename: page.filename,
+            summary: page.summary,
+            content,
+            sourceRefs: [],
+        };
+    }
+    /**
+     * 保存 Wiki 页面文件到 docs/wiki 目录
+     */
+    async savePage(page) {
+        const destPath = path.join(this.config.outputDir, page.filename);
+        const destDir = path.dirname(destPath);
+        await fs.mkdir(destDir, { recursive: true });
+        await fs.writeFile(destPath, page.content, 'utf-8');
+        return destPath;
+    }
+}
+//# sourceMappingURL=wiki-generator.js.map

package/dist/generator/wiki-generator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * RepoWiki Core API
+ * 包含代码库扫描、技术栈检测、静态代码分析、LLM 集成及 Markdown Wiki 生成的完整流程。
+ */
+export * from './models/index.js';
+export * from './scanner/index.js';
+export * from './detector/index.js';
+export * from './analyzer/index.js';
+export * from './llm/index.js';
+export * from './generator/index.js';
+export * from './pipeline.js';
+//# 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":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * RepoWiki Core API
+ * 包含代码库扫描、技术栈检测、静态代码分析、LLM 集成及 Markdown Wiki 生成的完整流程。
+ */
+export * from './models/index.js';
+export * from './scanner/index.js';
+export * from './detector/index.js';
+export * from './analyzer/index.js';
+export * from './llm/index.js';
+export * from './generator/index.js';
+export * from './pipeline.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/llm/auth-manager.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @module auth-manager
+ * @description 管理 LLM API 凭证，支持多来源优先级链解析配置。
+ *
+ * 优先级链（按优先级从高到低）：
+ * 1. 环境变量: REPOWIKI_API_KEY, REPOWIKI_BASE_URL, REPOWIKI_MODEL
+ * 2. 环境变量 (OpenAI 兼容): OPENAI_API_KEY, OPENAI_BASE_URL
+ * 3. 全局配置文件: ~/.repowiki/config.json
+ * 4. 工作区 .env 文件（使用 dotenv 解析）
+ */
+/** LLM 服务配置 */
+export interface LLMConfig {
+    /** API 端点地址 */
+    apiEndpoint: string;
+    /** 模型名称 */
+    modelName: string;
+    /** API 密钥 */
+    apiKey: string;
+}
+/**
+ * 按优先级链加载 LLM 配置。
+ *
+ * 解析顺序：
+ * 1. 进程环境变量（REPOWIKI_* 优先，其次 OPENAI_*）
+ * 2. 全局配置文件 ~/.repowiki/config.json
+ * 3. 工作区 .env 文件
+ *
+ * 对于每个字段，取优先级最高的非空值；若全部为空则使用默认值或空字符串。
+ *
+ * @param workspacePath - 可选的工作区路径，用于读取 .env 文件
+ * @returns 解析后的 LLM 配置
+ */
+export declare function loadLLMConfig(workspacePath?: string): Promise<LLMConfig>;
+/**
+ * 将配置保存到全局配置文件 ~/.repowiki/config.json。
+ *
+ * 如果文件已存在，则与现有配置合并（新值覆盖旧值）。
+ * 如果目录不存在，则自动创建。
+ *
+ * @param config - 要保存的部分配置
+ */
+export declare function saveGlobalConfig(config: Partial<LLMConfig>): Promise<void>;
+/**
+ * 验证 LLM 配置的完整性。
+ *
+ * @param config - 待验证的配置
+ * @returns 错误消息数组。若为空数组，则配置有效。
+ */
+export declare function validateConfig(config: LLMConfig): string[];
+//# sourceMappingURL=auth-manager.d.ts.map

package/dist/llm/auth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../src/llm/auth-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,eAAe;AACf,MAAM,WAAW,SAAS;IACtB,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AA4ED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA6B9E;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CAyB1D"}