autosnippet 3.2.18 → 3.2.21

package/dist/lib/service/delivery/RulesGenerator.d.ts

@@ -42,11 +42,18 @@ export declare class RulesGenerator {
      * 保留静态模板文件（autosnippet-conventions.mdc, autosnippet-skills.mdc）
      */
     cleanDynamicFiles(): void;
-    /** @private */
     _renderChannelA(ruleLines: string[]): string;
-    /** @private */
     _renderChannelB(topic: string, body: string, description: string): string;
-    /** @private */
+    /**
+     * Baseline Rules — 零知识库时写入基础引导文件
+     * 告知 Agent 可用的 MCP 工具和推荐工作流
+     */
+    writeBaselineRules(): {
+        filePath: string;
+        tokensUsed: number;
+        rulesCount: number;
+    };
+    _renderBaseline(): string;
     _ensureDir(): void;
 }
 export default RulesGenerator;

package/dist/lib/service/delivery/RulesGenerator.js

@@ -108,7 +108,6 @@ export class RulesGenerator {
         }
     }
     // ─── 渲染方法 ───────────────────────────────────────
-    /** @private */
     _renderChannelA(ruleLines) {
         const desc = `${this.projectName} mandatory rules — coding constraints that must never be violated. Auto-generated by AutoSnippet.`;
         const lines = [
@@ -127,7 +126,6 @@ export class RulesGenerator {
         ];
         return `${lines.join('\n')}\n`;
     }
-    /** @private */
     _renderChannelB(topic, body, description) {
         const topicLabel = topic.charAt(0).toUpperCase() + topic.slice(1);
         const lines = [
@@ -144,7 +142,49 @@ export class RulesGenerator {
         ];
         return `${lines.join('\n')}\n`;
     }
-    /** @private */
+    /**
+     * Baseline Rules — 零知识库时写入基础引导文件
+     * 告知 Agent 可用的 MCP 工具和推荐工作流
+     */
+    writeBaselineRules() {
+        this._ensureDir();
+        const content = this._renderBaseline();
+        const filePath = path.join(this.rulesDir, 'autosnippet-project-rules.mdc');
+        fs.writeFileSync(filePath, content, 'utf8');
+        return {
+            filePath,
+            tokensUsed: estimateTokens(content),
+            rulesCount: 0,
+        };
+    }
+    _renderBaseline() {
+        const lines = [
+            '---',
+            `description: "${this.projectName} — AutoSnippet baseline guidance. Available MCP tools and recommended workflows."`,
+            'alwaysApply: true',
+            '---',
+            '',
+            `# ${this.projectName} — AutoSnippet Baseline`,
+            '',
+            'This project has AutoSnippet enabled but no knowledge entries yet.',
+            'Use the following MCP tools to build and query the knowledge base:',
+            '',
+            '## Available MCP Tools',
+            '',
+            '- `autosnippet_bootstrap` — Cold-start: analyze the project and generate initial knowledge entries',
+            '- `autosnippet_search({ query })` — Search knowledge base (BM25 + semantic)',
+            '- `autosnippet_create_recipe` — Create a new coding recipe from current context',
+            '- `autosnippet_guard` — Run compliance review on current changes',
+            '- `autosnippet_task_start` / `autosnippet_task_close` — Track coding tasks with automatic knowledge capture',
+            '',
+            '## Recommended First Steps',
+            '',
+            '1. Run `autosnippet_bootstrap` to analyze the codebase and generate initial recipes',
+            '2. Use `autosnippet_search` to query knowledge while coding',
+            '3. Run `autosnippet_guard` before committing to check compliance',
+        ];
+        return `${lines.join('\n')}\n`;
+    }
     _ensureDir() {
         if (!fs.existsSync(this.rulesDir)) {
             fs.mkdirSync(this.rulesDir, { recursive: true });

package/dist/lib/service/delivery/SkillsSyncer.d.ts

@@ -1,10 +1,12 @@
 /**
  * SkillsSyncer — AutoSnippet Skills to .cursor/skills/ 同步器
  *
- * Channel C: 将 AutoSnippet/skills/ 下的项目级 SKILL.md 同步到
- * .cursor/skills/autosnippet-{name}/ 目录，适配 Cursor Agent Skills 标准格式。
+ * Channel C: 将内置 Skills 和项目级 Skills 统一同步到
+ * .cursor/skills/ 目录，适配 Cursor Agent Skills 标准格式。
  *
- * 同时为每个 Skill 生成 references/RECIPES.md（相关 Recipe 摘要）。
+ * - 内置 Skills：从 AutoSnippet 包 skills/ 目录直接复制（autosnippet-create 等）
+ * - 项目级 Skills：从 AutoSnippet/skills/ 转换格式后写入（project-* → autosnippet-*）
+ * - 同时为项目级 Skill 生成 references/RECIPES.md（相关 Recipe 摘要）
  */
 export declare class SkillsSyncer {
     knowledgeService: {
@@ -36,23 +38,35 @@ export declare class SkillsSyncer {
         synced: string[];
         skipped: string[];
         errors: string[];
+        builtinSynced: string[];
     }>;
+    /**
+     * 同步内置 Skills：从 AutoSnippet 包 skills/ 目录直接复制到 .cursor/skills/
+     */
+    _syncBuiltinSkills(result: {
+        builtinSynced: string[];
+        errors: string[];
+    }): void;
+    /**
+     * 同步项目级 Skills：从 AutoSnippet/skills/ 转换格式后写入 .cursor/skills/
+     */
+    _syncProjectSkills(result: {
+        synced: string[];
+        skipped: string[];
+        errors: string[];
+    }): Promise<void>;
     /**
      * 转换 SKILL.md 格式 — 从 AutoSnippet 格式到 Cursor Agent Skills 标准
-     * @private
      */
     _convertSkillMd(source: string, targetName: string, sourceDirName: string): string;
     /**
      * 生成 references/RECIPES.md
-     * @private
      */
     _generateRecipes(targetSkillDir: string, sourceDirName: string): Promise<void>;
     /**
      * 生成使用场景列表
-     * @private
      */
     _generateUseCases(sourceDirName: string): string[];
-    /** @private */
     _capitalizeWords(str: string): string;
 }
 export default SkillsSyncer;

package/dist/lib/service/delivery/SkillsSyncer.js

@@ -1,14 +1,17 @@
 /**
  * SkillsSyncer — AutoSnippet Skills to .cursor/skills/ 同步器
  *
- * Channel C: 将 AutoSnippet/skills/ 下的项目级 SKILL.md 同步到
- * .cursor/skills/autosnippet-{name}/ 目录，适配 Cursor Agent Skills 标准格式。
+ * Channel C: 将内置 Skills 和项目级 Skills 统一同步到
+ * .cursor/skills/ 目录，适配 Cursor Agent Skills 标准格式。
  *
- * 同时为每个 Skill 生成 references/RECIPES.md（相关 Recipe 摘要）。
+ * - 内置 Skills：从 AutoSnippet 包 skills/ 目录直接复制（autosnippet-create 等）
+ * - 项目级 Skills：从 AutoSnippet/skills/ 转换格式后写入（project-* → autosnippet-*）
+ * - 同时为项目级 Skill 生成 references/RECIPES.md（相关 Recipe 摘要）
  */
 import fs from 'node:fs';
 import path from 'node:path';
 import { DEFAULT_KNOWLEDGE_BASE_DIR } from '../../shared/ProjectMarkers.js';
+import { SKILLS_DIR as BUILTIN_SKILLS_DIR } from '../../shared/package-root.js';
 /**
  * 技能名称映射：AutoSnippet/skills/ → .cursor/skills/
  * AutoSnippet/skills/ 下面是 bootstrap 动态生成的项目级 skills，
@@ -70,10 +73,48 @@ export class SkillsSyncer {
      * @returns >}
      */
     async sync() {
-        const result = { synced: [], skipped: [], errors: [] };
+        const result = {
+            synced: [],
+            skipped: [],
+            errors: [],
+            builtinSynced: [],
+        };
+        // ── Phase 1: 同步内置 Skills ──
+        this._syncBuiltinSkills(result);
+        // ── Phase 2: 同步项目级 Skills ──
+        await this._syncProjectSkills(result);
+        return result;
+    }
+    /**
+     * 同步内置 Skills：从 AutoSnippet 包 skills/ 目录直接复制到 .cursor/skills/
+     */
+    _syncBuiltinSkills(result) {
+        if (!fs.existsSync(BUILTIN_SKILLS_DIR)) {
+            return;
+        }
+        const builtinDirs = fs
+            .readdirSync(BUILTIN_SKILLS_DIR, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+        for (const name of builtinDirs) {
+            try {
+                const src = path.join(BUILTIN_SKILLS_DIR, name);
+                const dest = path.join(this.targetDir, name);
+                fs.cpSync(src, dest, { recursive: true, force: true });
+                result.builtinSynced.push(name);
+            }
+            catch (err) {
+                result.errors.push(`builtin/${name}: ${err.message}`);
+            }
+        }
+    }
+    /**
+     * 同步项目级 Skills：从 AutoSnippet/skills/ 转换格式后写入 .cursor/skills/
+     */
+    async _syncProjectSkills(result) {
         // 检查源目录是否存在
         if (!fs.existsSync(this.sourceDir)) {
-            return result;
+            return;
         }
         // 扫描源目录
         const skillDirs = fs
@@ -106,11 +147,9 @@ export class SkillsSyncer {
                 result.errors.push(`${dirName}: ${err.message}`);
             }
         }
-        return result;
     }
     /**
      * 转换 SKILL.md 格式 — 从 AutoSnippet 格式到 Cursor Agent Skills 标准
-     * @private
      */
     _convertSkillMd(source, targetName, sourceDirName) {
         // 提取原始内容（去掉 frontmatter）
@@ -150,7 +189,6 @@ export class SkillsSyncer {
     }
     /**
      * 生成 references/RECIPES.md
-     * @private
      */
     async _generateRecipes(targetSkillDir, sourceDirName) {
         const refsDir = path.join(targetSkillDir, 'references');
@@ -201,7 +239,6 @@ export class SkillsSyncer {
     }
     /**
      * 生成使用场景列表
-     * @private
      */
     _generateUseCases(sourceDirName) {
         const casesMap = {
@@ -275,7 +312,6 @@ export class SkillsSyncer {
             '- Need guidance on project-specific patterns',
         ]);
     }
-    /** @private */
     _capitalizeWords(str) {
         return str.replace(/\b\w/g, (c) => c.toUpperCase());
     }

package/dist/lib/service/delivery/TopicClassifier.d.ts

@@ -25,15 +25,12 @@ export declare class TopicClassifier {
     buildDescription(topic: string, entries: KnowledgeEntryProps[]): string;
     /**
      * 分类单个 entry 到主题 — 直读 AI 预计算的 topicHint
-     * @private
      */
-    _classifyEntry(entry: KnowledgeEntryProps): string | null;
+    private _classifyEntry;
     /**
      * 从 entry 提取关键词
-     * @private
      */
-    _extractKeywords(entry: KnowledgeEntryProps): string[];
-    /** @private */
-    _topicLabel(topic: string): string;
+    private _extractKeywords;
+    private _topicLabel;
 }
 export default TopicClassifier;

package/dist/lib/service/delivery/TopicClassifier.js

@@ -99,14 +99,12 @@ export class TopicClassifier {
     }
     /**
      * 分类单个 entry 到主题 — 直读 AI 预计算的 topicHint
-     * @private
      */
     _classifyEntry(entry) {
         return entry.topicHint || null; // AI 没给 → null → 归入 general
     }
     /**
      * 从 entry 提取关键词
-     * @private
      */
     _extractKeywords(entry) {
         const text = `${entry.title || ''} ${entry.description || ''}`;
@@ -115,7 +113,6 @@ export class TopicClassifier {
         const filtered = words.map((w) => w.toLowerCase()).filter((w) => !STOP_WORDS.has(w));
         return [...new Set(filtered)].slice(0, 5);
     }
-    /** @private */
     _topicLabel(topic) {
         const labels = {
             networking: 'Networking',

package/dist/lib/service/guard/ExclusionManager.d.ts

@@ -47,7 +47,7 @@ export declare class ExclusionManager {
     });
     /**
      * 添加路径排除 (glob 或精确路径)
-     * @param {{ reason?: string }} meta
+     * @param meta
      */
     addPathExclusion(pattern: string, meta?: ExclusionMeta): void;
     /** 检查文件路径是否被排除 */

package/dist/lib/service/guard/ExclusionManager.js

@@ -22,7 +22,7 @@ export class ExclusionManager {
     // ─── Path 排除 ───────────────────────────────────────
     /**
      * 添加路径排除 (glob 或精确路径)
-     * @param {{ reason?: string }} meta
+     * @param meta
      */
     addPathExclusion(pattern, meta = {}) {
         if (!pattern) {

package/dist/lib/service/guard/GuardCheckEngine.d.ts

@@ -113,7 +113,7 @@ export declare class GuardCheckEngine {
     /**
      * 注入 Enhancement Pack 外部规则（支持 RegExp 和 string pattern）
      * 与 BUILT_IN_RULES 合并检查，自动跳过 ruleId 重复的规则
-     * @param {Array<{ruleId: string, pattern: RegExp|string, severity: string, message: string, category?: string, dimension?: string, languages?: string[], fixSuggestion?: string}>} rules
+     * @param rules
      */
     injectExternalRules(rules: ExternalRuleInput[]): void;
     /** EP 注入幂等标记 — 调用者可用此判断是否已完成注入，避免重复加载 EnhancementRegistry */
@@ -159,7 +159,7 @@ export declare class GuardCheckEngine {
     _getAstAnalyzer(): typeof AstAnalyzerModule;
     /**
      * 将 Guard 命中计数回写到对应 Recipe 的 guard_hit_count
-     * @param {Array<{ruleId: string}>} violations
+     * @param violations
      */
     trackGuardHits(violations: GuardViolation[]): void;
     /**
@@ -173,7 +173,7 @@ export declare class GuardCheckEngine {
     }): AuditFileResult;
     /**
      * 批量文件审计
-     * @param {Array<{path: string, content: string}>} files
+     * @param files
      * @param options {scope: 'file'|'target'|'project'}
      * @returns }
      */

package/dist/lib/service/guard/GuardCheckEngine.js

@@ -460,9 +460,9 @@ export class GuardCheckEngine {
         this._astRulesCache = null;
         this._cacheTime = 0;
         this._cacheTTL = options.cacheTTL || 60_000; // 1min
-        /** @type {Map<string, object>} Enhancement Pack 注入的外部规则 */
+        /** Enhancement Pack 注入的外部规则 */
         this._externalRules = new Map();
-        /** @type {boolean} EP 规则是否已注入（幂等标记，避免每次请求重复注入） */
+        /** EP 规则是否已注入（幂等标记，避免每次请求重复注入） */
         this._epInjected = false;
         /** Guard 配置 — 允许禁用特定规则或调整 Code-Level 检查阈值 */
         this._guardConfig = options.guardConfig || {};
@@ -470,7 +470,7 @@ export class GuardCheckEngine {
     /**
      * 注入 Enhancement Pack 外部规则（支持 RegExp 和 string pattern）
      * 与 BUILT_IN_RULES 合并检查，自动跳过 ruleId 重复的规则
-     * @param {Array<{ruleId: string, pattern: RegExp|string, severity: string, message: string, category?: string, dimension?: string, languages?: string[], fixSuggestion?: string}>} rules
+     * @param rules
      */
     injectExternalRules(rules) {
         if (!Array.isArray(rules)) {
@@ -855,7 +855,7 @@ export class GuardCheckEngine {
     }
     /**
      * 将 Guard 命中计数回写到对应 Recipe 的 guard_hit_count
-     * @param {Array<{ruleId: string}>} violations
+     * @param violations
      */
     trackGuardHits(violations) {
         if (!violations?.length || !this.db) {
@@ -915,7 +915,7 @@ export class GuardCheckEngine {
     }
     /**
      * 批量文件审计
-     * @param {Array<{path: string, content: string}>} files
+     * @param files
      * @param options {scope: 'file'|'target'|'project'}
      * @returns }
      */

package/dist/lib/service/guard/GuardCrossFileChecks.d.ts

@@ -14,7 +14,7 @@ export declare function resolveImportPath(fromDir: string, importPath: string):
 export declare function normalizeFilePath(filePath: string): string;
 /**
  * 跨文件检查 — 需要多文件上下文才能发现的问题
- * @param {Array<{path: string, content: string}>} files
+ * @param files
  * @param [options.disabledRules] 禁用的规则 ID 列表
  * @returns >}
  */

package/dist/lib/service/guard/GuardFeedbackLoop.d.ts

@@ -46,20 +46,20 @@ export declare class GuardFeedbackLoop {
     });
     /**
      * 对比当前和历史 violations，检测已修复的违规
-     * @param {{ violations: Array<{ruleId: string}> }} currentResult 本次检查结果
+     * @param currentResult 本次检查结果
      * @param filePath 文件路径
      * @returns >} 已修复且有 Recipe 关联的列表
      */
     detectFixedViolations(currentResult: CheckResult, filePath: string): FixedViolation[];
     /**
      * 对已修复的违规自动确认使用
-     * @param {Array<{ ruleId: string, filePath: string, fixRecipeId: string }>} fixedList
+     * @param fixedList
      */
     autoConfirmUsage(fixedList: FixedViolation[]): void;
     /**
      * 一站式处理：检测修复 + 自动确认
      * 供 MCP handler、GuardHandler、HTTP guard/file 端点集成调用
-     * @param {{ violations: Array }} currentResult
+     * @param currentResult
      */
     processFixDetection(currentResult: CheckResult, filePath: string): FixedViolation[];
     /**

package/dist/lib/service/guard/GuardFeedbackLoop.js

@@ -21,7 +21,7 @@ export class GuardFeedbackLoop {
     }
     /**
      * 对比当前和历史 violations，检测已修复的违规
-     * @param {{ violations: Array<{ruleId: string}> }} currentResult 本次检查结果
+     * @param currentResult 本次检查结果
      * @param filePath 文件路径
      * @returns >} 已修复且有 Recipe 关联的列表
      */
@@ -57,7 +57,7 @@ export class GuardFeedbackLoop {
     }
     /**
      * 对已修复的违规自动确认使用
-     * @param {Array<{ ruleId: string, filePath: string, fixRecipeId: string }>} fixedList
+     * @param fixedList
      */
     autoConfirmUsage(fixedList) {
         if (!this.feedbackCollector || !fixedList?.length) {
@@ -81,7 +81,7 @@ export class GuardFeedbackLoop {
     /**
      * 一站式处理：检测修复 + 自动确认
      * 供 MCP handler、GuardHandler、HTTP guard/file 端点集成调用
-     * @param {{ violations: Array }} currentResult
+     * @param currentResult
      */
     processFixDetection(currentResult, filePath) {
         const fixed = this.detectFixedViolations(currentResult, filePath);

package/dist/lib/service/guard/GuardPatternUtils.js

@@ -9,7 +9,7 @@
  * - detectLanguage: 文件扩展名推断语言
  */
 import { LanguageService } from '../../shared/LanguageService.js';
-/** @type {Map<string, RegExp>} 已编译的正则缓存 (pattern string → RegExp) */
+/** 已编译的正则缓存 (pattern string → RegExp) */
 const _regexCache = new Map();
 /** 编译正则模式（支持 RegExp 对象和 string，带缓存） */
 export function compilePattern(pattern) {

package/dist/lib/service/guard/GuardService.d.ts

@@ -158,22 +158,8 @@ export declare class GuardService {
     }[]>;
     /**
      * 仅 DB 规则的简化检查（降级路径）
-     * @private
      */
-    _checkCodeDbOnly(code: string, options?: {
-        language?: string | null;
-    }): Promise<{
-        ruleId: string;
-        ruleName: string;
-        severity: string;
-        message: string;
-        matches: {
-            match: string;
-            index: number | undefined;
-            line: number;
-        }[];
-        matchCount: number;
-    }[]>;
+    private _checkCodeDbOnly;
     /** 查询规则列表 (kind='rule' + knowledgeType='boundary-constraint') */
     listRules(filters?: Record<string, unknown>, pagination?: {
         page?: number;

package/dist/lib/service/guard/GuardService.js

@@ -184,7 +184,6 @@ export class GuardService {
     }
     /**
      * 仅 DB 规则的简化检查（降级路径）
-     * @private
      */
     async _checkCodeDbOnly(code, options = {}) {
         const { language = null } = options;

package/dist/lib/service/guard/RuleLearner.d.ts

@@ -20,7 +20,7 @@ export declare class RuleLearner {
     });
     /**
      * 记录规则触发
-     * @param {{ filePath?: string, message?: string }} context
+     * @param context
      */
     recordTrigger(ruleId: string, _context?: Record<string, unknown>): void;
     /** 记录用户反馈 */

package/dist/lib/service/guard/RuleLearner.js

@@ -25,7 +25,7 @@ export class RuleLearner {
     }
     /**
      * 记录规则触发
-     * @param {{ filePath?: string, message?: string }} context
+     * @param context
      */
     recordTrigger(ruleId, _context = {}) {
         const stat = this.#ensureStat(ruleId);

package/dist/lib/service/knowledge/CodeEntityGraph.d.ts

@@ -186,7 +186,7 @@ export declare class CodeEntityGraph {
     /**
      * 从候选的 Relations 字段提取边写入图谱 (Phase 5/6)
      *
-     * @param {Array<{title: string, relations: object}>} candidates 扁平关系数组或 Relations 对象
+     * @param candidates 扁平关系数组或 Relations 对象
      */
     populateFromCandidateRelations(candidates: CandidateWithRelations[] | null): GraphPopulateResult;
     /** 获取单个实体信息 */
@@ -273,8 +273,8 @@ export declare class CodeEntityGraph {
     /**
      * 从解析后的调用边填充图谱 (Phase 5)
      *
-     * @param {Array<{ caller: string, callee: string, callType: string, resolveMethod: string, line: number, file: string, isAwait: boolean }>} callEdges
-     * @param {Array<{ from: string, to: string, flowType: string, direction: string }>} dataFlowEdges
+     * @param callEdges
+     * @param dataFlowEdges
      */
     populateCallGraph(callEdges: CallEdge[], dataFlowEdges: DataFlowEdge[]): GraphPopulateResult;
     /**

package/dist/lib/service/knowledge/CodeEntityGraph.js

@@ -182,7 +182,7 @@ export class CodeEntityGraph {
     /**
      * 从候选的 Relations 字段提取边写入图谱 (Phase 5/6)
      *
-     * @param {Array<{title: string, relations: object}>} candidates 扁平关系数组或 Relations 对象
+     * @param candidates 扁平关系数组或 Relations 对象
      */
     populateFromCandidateRelations(candidates) {
         if (!candidates?.length) {
@@ -588,8 +588,8 @@ export class CodeEntityGraph {
     /**
      * 从解析后的调用边填充图谱 (Phase 5)
      *
-     * @param {Array<{ caller: string, callee: string, callType: string, resolveMethod: string, line: number, file: string, isAwait: boolean }>} callEdges
-     * @param {Array<{ from: string, to: string, flowType: string, direction: string }>} dataFlowEdges
+     * @param callEdges
+     * @param dataFlowEdges
      */
     populateCallGraph(callEdges, dataFlowEdges) {
         const t0 = Date.now();

package/dist/lib/service/knowledge/KnowledgeService.d.ts

@@ -101,7 +101,6 @@ export declare class KnowledgeService {
     publish(id: string, context: ServiceContext): Promise<KnowledgeEntry>;
     /**
      * 触发 Cursor Delivery Pipeline（非阻塞、容错）
-     * @private
      */
     _triggerCursorDeliveryAsync(): void;
     /** 弃用 (pending|active → deprecated) */

package/dist/lib/service/knowledge/KnowledgeService.js

@@ -307,7 +307,6 @@ export class KnowledgeService {
     }
     /**
      * 触发 Cursor Delivery Pipeline（非阻塞、容错）
-     * @private
      */
     _triggerCursorDeliveryAsync() {
         import('../../injection/ServiceContainer.js')

package/dist/lib/service/module/ModuleService.d.ts

@@ -30,7 +30,7 @@ export declare class ModuleService {
     }[]>;
     /**
      * 获取依赖关系图
-     * @param {{ level?: 'package'|'target' }} [options]
+     * @param [options]
      * @returns [] }>}
      */
     getDependencyGraph(options?: {

package/dist/lib/service/module/ModuleService.js

@@ -65,7 +65,7 @@ const SOURCE_CODE_EXTS = new Set([
 export class ModuleService {
     #projectRoot;
     #registry;
-    /** @type {Array<{ discoverer: import('../../core/discovery/ProjectDiscoverer.js').ProjectDiscoverer, confidence: number }>} */
+    /** >} */
     #activeDiscoverers = [];
     #loaded = false;
     #logger;
@@ -233,7 +233,7 @@ export class ModuleService {
     }
     /**
      * 获取依赖关系图
-     * @param {{ level?: 'package'|'target' }} [options]
+     * @param [options]
      * @returns [] }>}
      */
     async getDependencyGraph(options = {}) {

package/dist/lib/service/search/HybridRetriever.d.ts

@@ -42,8 +42,8 @@ export declare class HybridRetriever {
      * Dense: vectorStore 向量搜索 (HNSW or brute-force)
      * Sparse: BM25 关键词搜索 (由外部传入结果)
      *
-     * @param {Array<{ id: string, score: number, [key: string]: unknown }>} params.denseResults - 向量搜索结果
-     * @param {Array<{ id: string, score: number, [key: string]: unknown }>} params.sparseResults - 关键词搜索结果
+     * @param params.denseResults - 向量搜索结果
+     * @param params.sparseResults - 关键词搜索结果
      * @param [params.alpha=0.5] Dense 权重
      * @returns >}
      */

package/dist/lib/service/search/HybridRetriever.js

@@ -31,8 +31,8 @@ export class HybridRetriever {
      * Dense: vectorStore 向量搜索 (HNSW or brute-force)
      * Sparse: BM25 关键词搜索 (由外部传入结果)
      *
-     * @param {Array<{ id: string, score: number, [key: string]: unknown }>} params.denseResults - 向量搜索结果
-     * @param {Array<{ id: string, score: number, [key: string]: unknown }>} params.sparseResults - 关键词搜索结果
+     * @param params.denseResults - 向量搜索结果
+     * @param params.sparseResults - 关键词搜索结果
      * @param [params.alpha=0.5] Dense 权重
      * @returns >}
      */

package/dist/lib/service/search/SearchEngine.d.ts

@@ -130,7 +130,7 @@ export declare class SearchEngine {
      *     - 已删除    → scorer.removeDocument()
      *  3. 清空缓存以确保搜索结果刷新
      *
-     * @param {{ force?: boolean }} [opts] - force=true 强制全量重建
+     * @param [opts] - force=true 强制全量重建
      */
     refreshIndex(opts?: {
         force?: boolean;
@@ -141,12 +141,10 @@ export declare class SearchEngine {
      * 使用 BM25F 思想：高价值字段（title, trigger）重复出现以提升 TF 权重
      * — title ×3, trigger ×2, description ×1.5（通过重复 token 实现）
      * 这确保标题匹配的文档获得显著更高的 BM25 分数
-     * @private
      */
     _buildDocText(r: DbRow): string;
     /**
      * 从 DB 行构建文档 meta
-     * @private
      */
     _buildDocMeta(r: DbRow): {
         type: string;