autosnippet 3.2.16 → 3.2.18

package/dist/lib/service/vector/SyncCoordinator.js

@@ -32,9 +32,7 @@ export class SyncCoordinator {
         this.#debounceMs = config.debounceMs;
         this.#maxBatchSize = config.maxBatchSize ?? 20;
     }
-    /**
-     * 绑定 EventBus，开始监听知识变更事件
-     */
+    /** 绑定 EventBus，开始监听知识变更事件 */
     bindEventBus(eventBus) {
         this.#eventBus = eventBus;
         this.#boundHandler = (data) => {
@@ -54,9 +52,7 @@ export class SyncCoordinator {
         });
         this.#logger.info('[SyncCoordinator] Bound to EventBus');
     }
-    /**
-     * 手动触发立即刷入（用于测试或 shutdown 前确保数据落盘）
-     */
+    /** 手动触发立即刷入（用于测试或 shutdown 前确保数据落盘） */
     async flush() {
         if (this.#debounceTimer) {
             clearTimeout(this.#debounceTimer);
@@ -130,9 +126,7 @@ export class SyncCoordinator {
         }
         return result;
     }
-    /**
-     * 销毁: 清理定时器和事件监听
-     */
+    /** 销毁: 清理定时器和事件监听 */
     destroy() {
         if (this.#debounceTimer) {
             clearTimeout(this.#debounceTimer);
@@ -287,4 +281,3 @@ export class SyncCoordinator {
         return parts.join('\n\n') || change.entryId;
     }
 }
-//# sourceMappingURL=SyncCoordinator.js.map

package/dist/lib/service/vector/VectorService.d.ts

@@ -63,9 +63,7 @@ export type ProgressFn = (info: ProgressInfo) => void;
 export declare class VectorService {
     #private;
     constructor(config: VectorServiceConfig);
-    /**
-     * 初始化: 绑定 EventBus 事件监听
-     */
+    /** 初始化: 绑定 EventBus 事件监听 */
     initialize(): Promise<void>;
     /**
      * 全量构建向量索引
@@ -84,9 +82,7 @@ export declare class VectorService {
     incrementalUpdate(changedFiles: string[], opts?: {
         onProgress?: ProgressFn;
     }): Promise<BuildResult>;
-    /**
-     * 清空向量索引
-     */
+    /** 清空向量索引 */
     clear(): Promise<void>;
     /**
      * 校验向量索引健康状态
@@ -127,9 +123,7 @@ export declare class VectorService {
         score: number;
         [key: string]: unknown;
     }>>;
-    /**
-     * 通过 ID 查找相似向量
-     */
+    /** 通过 ID 查找相似向量 */
     similarById(id: string, topK?: number): Promise<Array<{
         item: Record<string, unknown>;
         score: number;
@@ -144,22 +138,16 @@ export declare class VectorService {
         content: unknown;
         kind?: string;
     }): Promise<void>;
-    /**
-     * 从向量索引移除一个条目
-     */
+    /** 从向量索引移除一个条目 */
     removeEntry(entryId: string): Promise<void>;
-    /**
-     * 批量同步知识条目
-     */
+    /** 批量同步知识条目 */
     batchSync(entries: Array<{
         id: string;
         title: string;
         content: unknown;
         kind?: string;
     }>): Promise<SyncResult>;
-    /**
-     * 获取向量索引统计信息
-     */
+    /** 获取向量索引统计信息 */
     getStats(): Promise<VectorStats>;
     /**
      * 迁移维度: 清空索引并使用新的 EmbedProvider 重建
@@ -168,9 +156,6 @@ export declare class VectorService {
     migrateDimension(newProvider: EmbedProvider, opts?: {
         onProgress?: ProgressFn;
     }): Promise<BuildResult>;
-    /**
-     * 销毁: 清理 SyncCoordinator 的定时器和事件监听
-     */
+    /** 销毁: 清理 SyncCoordinator 的定时器和事件监听 */
     destroy(): void;
 }
-//# sourceMappingURL=VectorService.d.ts.map

package/dist/lib/service/vector/VectorService.js

@@ -37,9 +37,7 @@ export class VectorService {
         this.#syncDebounceMs = config.syncDebounceMs;
     }
     // ═══ Lifecycle ═══
-    /**
-     * 初始化: 绑定 EventBus 事件监听
-     */
+    /** 初始化: 绑定 EventBus 事件监听 */
     async initialize() {
         if (this.#initialized) {
             return;
@@ -128,9 +126,7 @@ export class VectorService {
             duration: Date.now() - start,
         };
     }
-    /**
-     * 清空向量索引
-     */
+    /** 清空向量索引 */
     async clear() {
         await this.#vectorStore.clear();
         this.#logger.info('[VectorService] Vector index cleared');
@@ -253,9 +249,7 @@ export class VectorService {
             return [];
         }
     }
-    /**
-     * 通过 ID 查找相似向量
-     */
+    /** 通过 ID 查找相似向量 */
     async similarById(id, topK = 10) {
         try {
             const existing = await this.#vectorStore.getById(id);
@@ -313,9 +307,7 @@ export class VectorService {
             });
         }
     }
-    /**
-     * 从向量索引移除一个条目
-     */
+    /** 从向量索引移除一个条目 */
     async removeEntry(entryId) {
         try {
             await this.#vectorStore.remove(`entry_${entryId}`);
@@ -327,9 +319,7 @@ export class VectorService {
             });
         }
     }
-    /**
-     * 批量同步知识条目
-     */
+    /** 批量同步知识条目 */
     async batchSync(entries) {
         const result = { added: 0, updated: 0, removed: 0, errors: [] };
         if (!this.#embedProvider || entries.length === 0) {
@@ -374,9 +364,7 @@ export class VectorService {
         return result;
     }
     // ═══ 维护 ═══
-    /**
-     * 获取向量索引统计信息
-     */
+    /** 获取向量索引统计信息 */
     async getStats() {
         const raw = await this.#vectorStore.getStats();
         const stats = raw;
@@ -415,9 +403,7 @@ export class VectorService {
         return result;
     }
     // ═══ 生命周期 ═══
-    /**
-     * 销毁: 清理 SyncCoordinator 的定时器和事件监听
-     */
+    /** 销毁: 清理 SyncCoordinator 的定时器和事件监听 */
     destroy() {
         if (this.#syncCoordinator) {
             this.#syncCoordinator.destroy();
@@ -426,9 +412,7 @@ export class VectorService {
         this.#initialized = false;
     }
     // ═══ Private ═══
-    /**
-     * 从知识条目中提取可嵌入的文本
-     */
+    /** 从知识条目中提取可嵌入的文本 */
     #extractText(entry) {
         const parts = [];
         if (entry.title) {
@@ -453,4 +437,3 @@ export class VectorService {
         return parts.join('\n\n');
     }
 }
-//# sourceMappingURL=VectorService.js.map

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