autosnippet 3.2.15 → 3.2.17

package/dist/lib/service/wiki/WikiGenerator.d.ts

@@ -162,22 +162,11 @@ export declare class WikiGenerator {
     options: WikiOptions;
     projectGraph: WikiProjectGraph | null;
     /**
-     * @param {object} deps
-     * @param {string} deps.projectRoot
-     * @param {import('../../service/module/ModuleService.js').ModuleService} [deps.moduleService]
-     * @param {import('../../platform/ios/spm/SpmHelper.js').SpmHelper} [deps.spmService] 向后兼容
-     * @param {import('../../service/knowledge/KnowledgeService.js').KnowledgeService} [deps.knowledgeService]
-     * @param {import('../../core/ast/ProjectGraph.js').default} [deps.projectGraph]
-     * @param {import('../../service/knowledge/CodeEntityGraph.js').CodeEntityGraph} [deps.codeEntityGraph]
-     * @param {import('../../external/ai/AiProvider.js').AiProvider} [deps.aiProvider]
-     * @param {Function} [deps.onProgress] - (phase, progress, message) => void
-     * @param {object} [deps.options]
+     * @param [deps.spmService] 向后兼容
+     * @param [deps.onProgress] (phase, progress, message) => void
      */
     constructor(deps: WikiDeps);
-    /**
-     * 全量生成 Wiki
-     * @returns {Promise<WikiResult>}
-     */
+    /** 全量生成 Wiki */
     generate(): Promise<{
         success: boolean;
         error: string;
@@ -214,10 +203,7 @@ export declare class WikiGenerator {
             sourceHash: string;
         };
     }>;
-    /**
-     * 增量更新 — 仅重新生成变更的部分
-     * @returns {Promise<WikiResult>}
-     */
+    /** 增量更新 — 仅重新生成变更的部分 */
     update(): Promise<{
         success: boolean;
         error: string;
@@ -259,13 +245,9 @@ export declare class WikiGenerator {
         duration: number;
         upToDate: boolean;
     }>;
-    /**
-     * 中止当前生成
-     */
+    /** 中止当前生成 */
     abort(): void;
-    /**
-     * 获取当前 Wiki 状态
-     */
+    /** 获取当前 Wiki 状态 */
     getStatus(): {
         exists: boolean;
         generatedAt?: undefined;
@@ -279,13 +261,9 @@ export declare class WikiGenerator {
         version: any;
         hasChanges: boolean;
     };
-    /**
-     * 扫描项目基本信息
-     */
+    /** 扫描项目基本信息 */
     _scanProject(): Promise<ProjectScanInfo>;
-    /**
-     * AST 分析 — 利用已有 ProjectGraph 或重新构建
-     */
+    /** AST 分析 — 利用已有 ProjectGraph 或重新构建 */
     _analyzeAST(): Promise<{
         overview: Record<string, unknown>;
         classes: string[];
@@ -312,9 +290,7 @@ export declare class WikiGenerator {
         depGraph: unknown;
         projectInfo: Record<string, unknown>;
     }>;
-    /**
-     * 整合已有知识库 Recipes
-     */
+    /** 整合已有知识库 Recipes */
     _integrateKnowledge(): Promise<{
         recipes: Record<string, unknown>[];
         stats: Record<string, unknown> | null;
@@ -327,7 +303,7 @@ export declare class WikiGenerator {
      *   - 跳过数据不足的主题（避免空文档）
      *   - 不同的项目产出不同数量/类型的文章
      *
-     * @returns {Array<{id: string, path: string, title: string, type: string, priority: number}>}
+     * @returns >}
      */
     _discoverTopics(projectInfo: ProjectScanInfo, astInfo: Record<string, unknown>, moduleInfo: {
         targets: WikiModuleTarget[];
@@ -345,9 +321,9 @@ export declare class WikiGenerator {
      *   2. AI 不可用时使用丰富的模板内容
      *   3. 质量关卡: 最终内容不足 MIN_ARTICLE_CHARS 则跳过
      *
-     * @param {Array} topics - _discoverTopics() 的输出
-     * @param {object} structuredData - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
-     * @returns {Promise<Array<{path: string, hash: string, size: number}>>}
+     * @param topics _discoverTopics() 的输出
+     * @param structuredData { projectInfo, astInfo, moduleInfo, knowledgeInfo }
+     * @returns >>}
      */
     _composeArticles(topics: WikiTopic[], structuredData: WikiData): Promise<WikiFileResult[]>;
     /**
@@ -356,12 +332,10 @@ export declare class WikiGenerator {
      * 同步源:
      *   1. .cursor/skills/autosnippet-devdocs/references/ (*.md)  → wiki/documents/
      *
-     * @returns {Array<{path: string, hash: string, size: number, source: string}>}
+     * @returns >}
      */
     _syncCursorDocs(): WikiFileResult[];
-    /**
-     * 为同步目录生成索引页
-     */
+    /** 为同步目录生成索引页 */
     _generateSyncIndex(synced: WikiFileResult[], isZh: boolean): void;
     _emit(phase: string, progress: number, message: string): void;
     _ensureDir(dir: string): void;
@@ -404,4 +378,3 @@ export declare class WikiGenerator {
     };
 }
 export default WikiGenerator;
-//# sourceMappingURL=WikiGenerator.d.ts.map

package/dist/lib/service/wiki/WikiGenerator.js

@@ -74,16 +74,8 @@ export class WikiGenerator {
     options;
     projectGraph;
     /**
-     * @param {object} deps
-     * @param {string} deps.projectRoot
-     * @param {import('../../service/module/ModuleService.js').ModuleService} [deps.moduleService]
-     * @param {import('../../platform/ios/spm/SpmHelper.js').SpmHelper} [deps.spmService] 向后兼容
-     * @param {import('../../service/knowledge/KnowledgeService.js').KnowledgeService} [deps.knowledgeService]
-     * @param {import('../../core/ast/ProjectGraph.js').default} [deps.projectGraph]
-     * @param {import('../../service/knowledge/CodeEntityGraph.js').CodeEntityGraph} [deps.codeEntityGraph]
-     * @param {import('../../external/ai/AiProvider.js').AiProvider} [deps.aiProvider]
-     * @param {Function} [deps.onProgress] - (phase, progress, message) => void
-     * @param {object} [deps.options]
+     * @param [deps.spmService] 向后兼容
+     * @param [deps.onProgress] (phase, progress, message) => void
      */
     constructor(deps) {
         this.projectRoot = deps.projectRoot;
@@ -99,10 +91,7 @@ export class WikiGenerator {
         this._aborted = false;
     }
     // ═══ 公有 API ══════════════════════════════════════════════
-    /**
-     * 全量生成 Wiki
-     * @returns {Promise<WikiResult>}
-     */
+    /** 全量生成 Wiki */
     async generate() {
         const startTime = Date.now();
         this._aborted = false;
@@ -184,10 +173,7 @@ export class WikiGenerator {
             return { success: false, error: err.message, duration: Date.now() - startTime };
         }
     }
-    /**
-     * 增量更新 — 仅重新生成变更的部分
-     * @returns {Promise<WikiResult>}
-     */
+    /** 增量更新 — 仅重新生成变更的部分 */
     async update() {
         const meta = this._readMeta();
         if (!meta) {
@@ -202,15 +188,11 @@ export class WikiGenerator {
         }
         return this.generate();
     }
-    /**
-     * 中止当前生成
-     */
+    /** 中止当前生成 */
     abort() {
         this._aborted = true;
     }
-    /**
-     * 获取当前 Wiki 状态
-     */
+    /** 获取当前 Wiki 状态 */
     getStatus() {
         const meta = this._readMeta();
         if (!meta) {
@@ -225,9 +207,7 @@ export class WikiGenerator {
         };
     }
     // ═══ 阶段实现 ══════════════════════════════════════════════
-    /**
-     * 扫描项目基本信息
-     */
+    /** 扫描项目基本信息 */
     async _scanProject() {
         const info = {
             name: path.basename(this.projectRoot),
@@ -308,9 +288,7 @@ export class WikiGenerator {
         this._emit(WikiPhase.SCAN, 12, `发现 ${info.sourceFiles.length} 个源文件 (${LanguageService.displayName(info.primaryLanguage)})`);
         return info;
     }
-    /**
-     * AST 分析 — 利用已有 ProjectGraph 或重新构建
-     */
+    /** AST 分析 — 利用已有 ProjectGraph 或重新构建 */
     async _analyzeAST() {
         if (this.projectGraph) {
             const overview = this.projectGraph.getOverview();
@@ -390,9 +368,7 @@ export class WikiGenerator {
             return { targets: [], depGraph: null };
         }
     }
-    /**
-     * 整合已有知识库 Recipes
-     */
+    /** 整合已有知识库 Recipes */
     async _integrateKnowledge() {
         if (!this.knowledgeService || !this.options.includeRecipes) {
             return { recipes: [], stats: null };
@@ -423,7 +399,7 @@ export class WikiGenerator {
      *   - 跳过数据不足的主题（避免空文档）
      *   - 不同的项目产出不同数量/类型的文章
      *
-     * @returns {Array<{id: string, path: string, title: string, type: string, priority: number}>}
+     * @returns >}
      */
     _discoverTopics(projectInfo, astInfo, moduleInfo, knowledgeInfo) {
         const topics = [];
@@ -673,9 +649,9 @@ export class WikiGenerator {
      *   2. AI 不可用时使用丰富的模板内容
      *   3. 质量关卡: 最终内容不足 MIN_ARTICLE_CHARS 则跳过
      *
-     * @param {Array} topics - _discoverTopics() 的输出
-     * @param {object} structuredData - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
-     * @returns {Promise<Array<{path: string, hash: string, size: number}>>}
+     * @param topics _discoverTopics() 的输出
+     * @param structuredData { projectInfo, astInfo, moduleInfo, knowledgeInfo }
+     * @returns >>}
      */
     async _composeArticles(topics, structuredData) {
         const files = [];
@@ -773,7 +749,7 @@ export class WikiGenerator {
      * 同步源:
      *   1. .cursor/skills/autosnippet-devdocs/references/ (*.md)  → wiki/documents/
      *
-     * @returns {Array<{path: string, hash: string, size: number, source: string}>}
+     * @returns >}
      */
     _syncCursorDocs() {
         const synced = [];
@@ -802,9 +778,7 @@ export class WikiGenerator {
         this._emit(WikiPhase.SYNC_DOCS, 88, `同步完成: ${synced.length} 个文档`);
         return synced;
     }
-    /**
-     * 为同步目录生成索引页
-     */
+    /** 为同步目录生成索引页 */
     _generateSyncIndex(synced, isZh) {
         const docFiles = synced.filter((f) => f.path.startsWith('documents/'));
         if (docFiles.length > 0) {
@@ -910,4 +884,3 @@ export class WikiGenerator {
     }
 }
 export default WikiGenerator;
-//# sourceMappingURL=WikiGenerator.js.map

package/dist/lib/service/wiki/WikiRenderers.d.ts

@@ -15,81 +15,36 @@ export type { WikiData } from './WikiTypes.js';
  *
  * 关键区别: 不是润色骨架，而是提供丰富数据让 AI 写完整文章
  *
- * @param {object} topic
- * @param {object} data - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- * @returns {string}
+ * @param data { projectInfo, astInfo, moduleInfo, knowledgeInfo }
  */
 export declare function buildArticlePrompt(topic: WikiTopic, data: WikiData, isZh: boolean, codeEntityGraph: WikiCodeEntityGraph | null): string;
 /**
  * 构建非 AI 降级的丰富模板内容
  * 即使没有 AI，也要产出有意义的内容 (不是只有列表罗列)
  *
- * @param {object} topic
- * @param {object} data - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- * @returns {string}
+ * @param data { projectInfo, astInfo, moduleInfo, knowledgeInfo }
  */
 export declare function buildFallbackArticle(topic: WikiTopic, data: WikiData, isZh: boolean, codeEntityGraph: WikiCodeEntityGraph | null): string;
-/**
- * 渲染项目概述页 (index.md)
- */
+/** 渲染项目概述页 (index.md) */
 export declare function renderIndex(project: WikiProjectInfo, ast: WikiAstInfo, modules: WikiModuleInfo, knowledge: WikiKnowledgeInfo, isZh: boolean, allTopics: WikiTopic[]): string;
-/**
- * 渲染架构总览文档 (architecture.md)
- *
- * @param {object} project
- * @param {object} ast
- * @param {object} modules
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- */
+/** 渲染架构总览文档 (architecture.md) */
 export declare function renderArchitecture(project: WikiProjectInfo, ast: WikiAstInfo, modules: WikiModuleInfo, isZh: boolean, codeEntityGraph: WikiCodeEntityGraph | null): string;
-/**
- * 渲染模块详情文档 (modules/{name}.md)
- */
+/** 渲染模块详情文档 (modules/{name}.md) */
 export declare function renderModule(target: WikiTarget, ast: WikiAstInfo, knowledge: WikiKnowledgeInfo, isZh: boolean, projectInfo: WikiProjectInfo): string;
-/**
- * 渲染代码模式文档 (patterns.md)
- */
+/** 渲染代码模式文档 (patterns.md) */
 export declare function renderPatterns(knowledge: WikiKnowledgeInfo, isZh: boolean): string;
-/**
- * 快速上手指南 (非 AI 降级模板)
- */
+/** 快速上手指南 (非 AI 降级模板) */
 export declare function renderGettingStarted(project: WikiProjectInfo, modules: WikiModuleInfo, ast: WikiAstInfo, isZh: boolean): string;
-/**
- * 按分类拆分的代码模式文档
- */
+/** 按分类拆分的代码模式文档 */
 export declare function renderPatternCategory(patternData: {
     category: string;
     recipes: WikiRecipeJson[];
 }, isZh: boolean): string;
-/**
- * 协议参考文档
- */
+/** 协议参考文档 */
 export declare function renderProtocolReference(ast: WikiAstInfo, isZh: boolean, projectInfo: WikiProjectInfo): string;
-/**
- * 渲染文件夹结构总览 (folder-structure.md)
- *
- * @param {import('./WikiUtils.js').FolderProfile[]} profiles
- * @param {object} projectInfo
- * @param {boolean} isZh
- * @returns {string}
- */
+/** 渲染文件夹结构总览 (folder-structure.md) */
 export declare function renderFolderOverview(profiles: WikiFolderProfile[], projectInfo: WikiProjectInfo, isZh: boolean): string;
-/**
- * 渲染单个文件夹的深度画像文档 (folders/{name}.md)
- *
- * @param {import('./WikiUtils.js').FolderProfile} fp
- * @param {object} projectInfo
- * @param {boolean} isZh
- * @returns {string}
- */
+/** 渲染单个文件夹的深度画像文档 (folders/{name}.md) */
 export declare function renderFolderProfile(fp: WikiFolderProfile, projectInfo: WikiProjectInfo, isZh: boolean): string;
-/**
- * 构建 AI 系统 Prompt (V3 — 撰写完整文章，非润色骨架)
- */
+/** 构建 AI 系统 Prompt (V3 — 撰写完整文章，非润色骨架) */
 export declare function buildAiSystemPrompt(isZh: boolean): string;
-//# sourceMappingURL=WikiRenderers.d.ts.map

package/dist/lib/service/wiki/WikiRenderers.js

@@ -17,11 +17,7 @@ import { getInheritanceRoots, getLangTerms, getModuleSourceFiles, inferModulePur
  *
  * 关键区别: 不是润色骨架，而是提供丰富数据让 AI 写完整文章
  *
- * @param {object} topic
- * @param {object} data - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- * @returns {string}
+ * @param data { projectInfo, astInfo, moduleInfo, knowledgeInfo }
  */
 export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
     const { projectInfo, astInfo, moduleInfo, knowledgeInfo } = data;
@@ -406,11 +402,7 @@ export function buildArticlePrompt(topic, data, isZh, codeEntityGraph) {
  * 构建非 AI 降级的丰富模板内容
  * 即使没有 AI，也要产出有意义的内容 (不是只有列表罗列)
  *
- * @param {object} topic
- * @param {object} data - { projectInfo, astInfo, moduleInfo, knowledgeInfo }
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- * @returns {string}
+ * @param data { projectInfo, astInfo, moduleInfo, knowledgeInfo }
  */
 export function buildFallbackArticle(topic, data, isZh, codeEntityGraph) {
     const { projectInfo, astInfo, moduleInfo, knowledgeInfo } = data;
@@ -438,9 +430,7 @@ export function buildFallbackArticle(topic, data, isZh, codeEntityGraph) {
     }
 }
 // ═══ Markdown 渲染器 ═══════════════════════════════════════
-/**
- * 渲染项目概述页 (index.md)
- */
+/** 渲染项目概述页 (index.md) */
 export function renderIndex(project, ast, modules, knowledge, isZh, allTopics) {
     const title = isZh ? '项目概述' : 'Project Overview';
     const langTerms = getLangTerms(project.primaryLanguage || 'unknown');
@@ -592,15 +582,7 @@ export function renderIndex(project, ast, modules, knowledge, isZh, allTopics) {
     }
     return lines.join('\n');
 }
-/**
- * 渲染架构总览文档 (architecture.md)
- *
- * @param {object} project
- * @param {object} ast
- * @param {object} modules
- * @param {boolean} isZh
- * @param {object|null} codeEntityGraph
- */
+/** 渲染架构总览文档 (architecture.md) */
 export function renderArchitecture(project, ast, modules, isZh, codeEntityGraph) {
     const lines = [
         `# ${isZh ? '架构总览' : 'Architecture Overview'}`,
@@ -721,9 +703,7 @@ export function renderArchitecture(project, ast, modules, isZh, codeEntityGraph)
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 渲染模块详情文档 (modules/{name}.md)
- */
+/** 渲染模块详情文档 (modules/{name}.md) */
 export function renderModule(target, ast, knowledge, isZh, projectInfo) {
     const langTerms = getLangTerms(projectInfo?.primaryLanguage || 'unknown');
     const tl = isZh ? langTerms.typeLabel.zh : langTerms.typeLabel.en;
@@ -879,9 +859,7 @@ export function renderModule(target, ast, knowledge, isZh, projectInfo) {
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 渲染代码模式文档 (patterns.md)
- */
+/** 渲染代码模式文档 (patterns.md) */
 export function renderPatterns(knowledge, isZh) {
     const lines = [
         `# ${isZh ? '代码模式与最佳实践' : 'Code Patterns & Best Practices'}`,
@@ -946,9 +924,7 @@ export function renderPatterns(knowledge, isZh) {
     return lines.join('\n');
 }
 // ═══ V3 新增渲染器 ════════════════════════════════════════
-/**
- * 快速上手指南 (非 AI 降级模板)
- */
+/** 快速上手指南 (非 AI 降级模板) */
 export function renderGettingStarted(project, modules, ast, isZh) {
     const lines = [
         `# ${isZh ? '快速上手' : 'Getting Started'}`,
@@ -1229,9 +1205,7 @@ function _pushBuildSteps(lines, buildSys, projectName, isZh) {
     lines.push('```');
     lines.push('');
 }
-/**
- * 按分类拆分的代码模式文档
- */
+/** 按分类拆分的代码模式文档 */
 export function renderPatternCategory(patternData, isZh) {
     const { category, recipes } = patternData;
     const lines = [
@@ -1275,9 +1249,7 @@ export function renderPatternCategory(patternData, isZh) {
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 协议参考文档
- */
+/** 协议参考文档 */
 export function renderProtocolReference(ast, isZh, projectInfo) {
     const langTerms = getLangTerms(projectInfo?.primaryLanguage || 'unknown');
     const il = isZh ? langTerms.interfaceLabel.zh : langTerms.interfaceLabel.en;
@@ -1325,14 +1297,7 @@ export function renderProtocolReference(ast, isZh, projectInfo) {
     return lines.join('\n');
 }
 // ═══ Folder Profile 渲染器 (AST 不可用时的降级策略) ═══════
-/**
- * 渲染文件夹结构总览 (folder-structure.md)
- *
- * @param {import('./WikiUtils.js').FolderProfile[]} profiles
- * @param {object} projectInfo
- * @param {boolean} isZh
- * @returns {string}
- */
+/** 渲染文件夹结构总览 (folder-structure.md) */
 export function renderFolderOverview(profiles, projectInfo, isZh) {
     const lines = [
         `# ${isZh ? '项目结构分析' : 'Project Structure Analysis'}`,
@@ -1438,14 +1403,7 @@ export function renderFolderOverview(profiles, projectInfo, isZh) {
     lines.push('');
     return lines.join('\n');
 }
-/**
- * 渲染单个文件夹的深度画像文档 (folders/{name}.md)
- *
- * @param {import('./WikiUtils.js').FolderProfile} fp
- * @param {object} projectInfo
- * @param {boolean} isZh
- * @returns {string}
- */
+/** 渲染单个文件夹的深度画像文档 (folders/{name}.md) */
 export function renderFolderProfile(fp, projectInfo, isZh) {
     const lines = [
         `# ${fp.name}`,
@@ -1585,9 +1543,7 @@ export function renderFolderProfile(fp, projectInfo, isZh) {
     return lines.join('\n');
 }
 // ═══ V3 AI 系统 Prompt ═══════════════════════════════════
-/**
- * 构建 AI 系统 Prompt (V3 — 撰写完整文章，非润色骨架)
- */
+/** 构建 AI 系统 Prompt (V3 — 撰写完整文章，非润色骨架) */
 export function buildAiSystemPrompt(isZh) {
     if (isZh) {
         return [
@@ -1626,4 +1582,3 @@ export function buildAiSystemPrompt(isZh) {
         '10. End with a back link: [← Back to Overview](index.md) or [← Back to Overview](../index.md)',
     ].join('\n');
 }
-//# sourceMappingURL=WikiRenderers.js.map

package/dist/lib/service/wiki/WikiTypes.d.ts

@@ -143,4 +143,3 @@ export interface WikiData {
     moduleInfo: WikiModuleInfo;
     knowledgeInfo: WikiKnowledgeInfo;
 }
-//# sourceMappingURL=WikiTypes.d.ts.map

package/dist/lib/service/wiki/WikiTypes.js

@@ -7,4 +7,3 @@
  * @module WikiTypes
  */
 export {};
-//# sourceMappingURL=WikiTypes.js.map

package/dist/lib/service/wiki/WikiUtils.d.ts

@@ -5,17 +5,11 @@
  *
  * @module WikiUtils
  */
-/**
- * 文本 slug 化
- */
+/** 文本 slug 化 */
 export declare function slug(name: string): string;
-/**
- * Mermaid 安全 ID
- */
+/** Mermaid 安全 ID */
 export declare function mermaidId(name: string): string;
-/**
- * 遍历目录（排除 build/Pods/DerivedData 等）
- */
+/** 遍历目录（排除 build/Pods/DerivedData 等） */
 export declare function walkDir(dir: string, callback: (filePath: string) => void, maxFiles?: number): void;
 /**
  * 从文件相对路径推断所属模块名
@@ -56,8 +50,7 @@ export declare function inferModulePurpose(name: string, classes: string[], prot
 } | null;
 /**
  * 从 CodeEntityGraph 提取继承根节点
- * @param {object|null} codeEntityGraph
- * @returns {Array<{name: string, children: string[]}>}
+ * @returns >}
  */
 export declare function getInheritanceRoots(codeEntityGraph: {
     queryEntities?: (filter: Record<string, unknown>) => Array<{
@@ -79,10 +72,7 @@ export declare function getInheritanceRoots(codeEntityGraph: {
  * Layer 1: Title slug 碰撞 — 同名文件不同目录 → hash 相同则删除副本
  * Layer 2: Content hash    — 跨文件内容完全相同 → 仅保留第一个
  *
- * @param {Array} files
- * @param {string} wikiDir
- * @param {(phase: string, progress: number, message: string) => void} emit
- * @returns {{ removed: string[], kept: number }}
+ * @returns }
  */
 export declare function dedup(files: {
     path: string;
@@ -96,8 +86,8 @@ export declare function dedup(files: {
  *
  * 不同语言对"类"和"接口"有不同称谓，Wiki 文档应使用合适的措辞。
  *
- * @param {string} langId - LanguageService langId，如 'swift', 'python', 'go'
- * @returns {{ typeLabel: {zh: string, en: string}, interfaceLabel: {zh: string, en: string}, moduleMetric: {zh: string, en: string} }}
+ * @param langId LanguageService langId，如 'swift', 'python', 'go'
+ * @returns , interfaceLabel: {zh: string, en: string}, moduleMetric: {zh: string, en: string} }}
  */
 export declare function getLangTerms(langId: string): {
     typeLabel: {
@@ -117,7 +107,6 @@ export declare function getLangTerms(langId: string): {
  * 已知的构建系统标志文件 → 生态类型映射
  *
  * @deprecated 请使用 LanguageService.buildSystemMarkers。此处保留为只读引用以保持向后兼容。
- * @type {ReadonlyArray<{file: string, eco: string, buildTool: string}>}
  */
 export declare const BUILD_SYSTEM_MARKERS: readonly {
     file: string;
@@ -131,9 +120,9 @@ export declare const BUILD_SYSTEM_MARKERS: readonly {
  *   1. 先检查根目录的一级文件
  *   2. 如果根目录未找到，检查一级子目录（支持 monorepo 如 AppFlowy/frontend/...）
  *
- * @param {string[]} rootEntryNames 项目根目录一级文件/目录名列表
- * @param {string} [projectRoot] 可选的项目根路径，用于二级检测
- * @returns {Array<{eco: string, buildTool: string}>} 匹配到的构建系统
+ * @param rootEntryNames 项目根目录一级文件/目录名列表
+ * @param [projectRoot] 可选的项目根路径，用于二级检测
+ * @returns >} 匹配到的构建系统
  */
 export declare function detectBuildSystems(rootEntryNames: string[], projectRoot?: string): {
     eco: string;
@@ -145,12 +134,10 @@ export declare function detectBuildSystems(rootEntryNames: string[], projectRoot
  * 适用场景: AST 无法提取 target（类/函数/协议）的语言，
  * 通过文件夹结构、文件命名、轻量 import 分析来产出有意义的 wiki 内容。
  *
- * @param {object} projectInfo - WikiGenerator._scanProject() 的输出
- * @param {object} [options]
- * @param {number} [options.minFiles=3]      文件夹最少文件数阈值
- * @param {number} [options.maxFolders=20]   最多分析的文件夹数
- * @param {number} [options.sampleLines=40]  每个文件采样行数 (用于 import 提取)
- * @returns {FolderProfile[]}
+ * @param projectInfo WikiGenerator._scanProject() 的输出
+ * @param [options.minFiles=3] 文件夹最少文件数阈值
+ * @param [options.maxFolders=20] 最多分析的文件夹数
+ * @param [options.sampleLines=40] 每个文件采样行数 (用于 import 提取)
  */
 export declare function profileFolders(projectInfo: {
     root: string;
@@ -161,4 +148,3 @@ export declare function profileFolders(projectInfo: {
     maxFolders?: number;
     sampleLines?: number;
 }): Record<string, unknown>[];
-//# sourceMappingURL=WikiUtils.d.ts.map