autosnippet 3.2.15 → 3.2.17

package/dist/lib/{service/agent → agent}/ConversationStore.d.ts

@@ -31,16 +31,13 @@ interface AiProvider {
 }
 export declare class ConversationStore {
     #private;
-    /**
-     * @param {string} projectRoot 用户项目根目录
-     */
+    /** @param projectRoot 用户项目根目录 */
     constructor(projectRoot: string);
     /**
      * 创建新对话
-     * @param {object} opts
-     * @param {'user'|'system'|'lark'} opts.category 对话类别
-     * @param {string} [opts.title] 对话标题
-     * @returns {string} conversationId
+     * @param opts.category 对话类别
+     * @param [opts.title] 对话标题
+     * @returns conversationId
      */
     create({ category, title }?: {
         category?: string | undefined;
@@ -48,7 +45,6 @@ export declare class ConversationStore {
     }): `${string}-${string}-${string}-${string}-${string}`;
     /**
      * 追加消息到对话
-     * @param {string} conversationId
      * @param {{ role: string, content: string }} message
      */
     append(conversationId: string, message: ConversationMessage): void;
@@ -60,48 +56,37 @@ export declare class ConversationStore {
      *   - 截断中间的旧消息
      *   - 保留最新的消息
      *
-     * @param {string} conversationId
-     * @param {object} [opts]
-     * @param {number} [opts.tokenBudget] - token 预算
-     * @returns {{ role: string, content: string }[]}
+     * @param [opts.tokenBudget] token 预算
+     * @returns []}
      */
     load(conversationId: string, { tokenBudget }?: {
         tokenBudget?: number | undefined;
     }): ConversationMessage[];
     /**
      * 对话列表
-     * @param {object} [opts]
-     * @param {'user'|'system'|'lark'} [opts.category] 按类别过滤
-     * @param {number} [opts.limit=20]
-     * @returns {Array}
+     * @param [opts.category] 按类别过滤
      */
     list({ category, limit }?: {
         category?: 'user' | 'system' | 'lark';
         limit?: number;
     }): any;
-    /**
-     * 删除对话
-     * @param {string} conversationId
-     */
+    /** 删除对话 */
     delete(conversationId: string): void;
     /**
      * 为对话生成压缩摘要（需要 AI）
      * 将旧消息替换为一条 system 摘要消息
      *
-     * @param {string} conversationId
-     * @param {object} opts
-     * @param {object} opts.aiProvider - AI Provider 实例
-     * @returns {Promise<boolean>} 是否成功压缩
+     * @param opts.aiProvider AI Provider 实例
+     * @returns 是否成功压缩
      */
     summarize(conversationId: string, { aiProvider }: {
         aiProvider: AiProvider;
     }): Promise<boolean>;
     /**
      * 清理过期对话
-     * @param {object} [opts]
-     * @param {number} [opts.maxAgeDays=30] 超过此天数的对话将被删除
-     * @param {'user'|'system'} [opts.category] 只清理特定类别
-     * @returns {{ deleted: number }}
+     * @param [opts.maxAgeDays=30] 超过此天数的对话将被删除
+     * @param [opts.category] 只清理特定类别
+     * @returns }
      */
     cleanup({ maxAgeDays, category, }?: {
         maxAgeDays?: number;
@@ -109,12 +94,7 @@ export declare class ConversationStore {
     }): {
         deleted: number;
     };
-    /**
-     * 估算 token 数 — 委托给共享 token-utils（CJK 感知）
-     * @param {string} text
-     * @returns {number}
-     */
+    /** 估算 token 数 — 委托给共享 token-utils（CJK 感知） */
     estimateTokens(text: string): number;
 }
 export default ConversationStore;
-//# sourceMappingURL=ConversationStore.d.ts.map

package/dist/lib/{service/agent → agent}/ConversationStore.js

@@ -20,9 +20,9 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
-import Logger from '../../infrastructure/logging/Logger.js';
-import pathGuard from '../../shared/PathGuard.js';
-import { estimateTokens as _estimateTokens } from '../../shared/token-utils.js';
+import Logger from '#infra/logging/Logger.js';
+import pathGuard from '#shared/PathGuard.js';
+import { estimateTokens as _estimateTokens } from '#shared/token-utils.js';
 const DEFAULT_TOKEN_BUDGET = 12000; // ~12K tokens 留给历史, 其余给系统提示词和当前消息
 const MAX_CONVERSATIONS = 100; // 索引最多保留 100 个对话
 const _SUMMARY_TARGET_TOKENS = 500; // 压缩后的摘要目标 token 数
@@ -30,9 +30,7 @@ export class ConversationStore {
     #dir;
     #indexPath;
     #logger;
-    /**
-     * @param {string} projectRoot 用户项目根目录
-     */
+    /** @param projectRoot 用户项目根目录 */
     constructor(projectRoot) {
         this.#dir = path.join(projectRoot, '.autosnippet', 'conversations');
         this.#indexPath = path.join(this.#dir, 'index.json');
@@ -45,10 +43,9 @@ export class ConversationStore {
     // ═══════════════════════════════════════════════════════
     /**
      * 创建新对话
-     * @param {object} opts
-     * @param {'user'|'system'|'lark'} opts.category 对话类别
-     * @param {string} [opts.title] 对话标题
-     * @returns {string} conversationId
+     * @param opts.category 对话类别
+     * @param [opts.title] 对话标题
+     * @returns conversationId
      */
     create({ category = 'user', title = '' } = {}) {
         const id = crypto.randomUUID();
@@ -76,7 +73,6 @@ export class ConversationStore {
     }
     /**
      * 追加消息到对话
-     * @param {string} conversationId
      * @param {{ role: string, content: string }} message
      */
     append(conversationId, message) {
@@ -114,10 +110,8 @@ export class ConversationStore {
      *   - 截断中间的旧消息
      *   - 保留最新的消息
      *
-     * @param {string} conversationId
-     * @param {object} [opts]
-     * @param {number} [opts.tokenBudget] - token 预算
-     * @returns {{ role: string, content: string }[]}
+     * @param [opts.tokenBudget] token 预算
+     * @returns []}
      */
     load(conversationId, { tokenBudget = DEFAULT_TOKEN_BUDGET } = {}) {
         try {
@@ -150,10 +144,7 @@ export class ConversationStore {
     }
     /**
      * 对话列表
-     * @param {object} [opts]
-     * @param {'user'|'system'|'lark'} [opts.category] 按类别过滤
-     * @param {number} [opts.limit=20]
-     * @returns {Array}
+     * @param [opts.category] 按类别过滤
      */
     list({ category, limit = 20 } = {}) {
         const index = this.#loadIndex();
@@ -163,10 +154,7 @@ export class ConversationStore {
         }
         return results.slice(0, limit);
     }
-    /**
-     * 删除对话
-     * @param {string} conversationId
-     */
+    /** 删除对话 */
     delete(conversationId) {
         this.#deleteConversationFile(conversationId);
         const index = this.#loadIndex();
@@ -177,10 +165,8 @@ export class ConversationStore {
      * 为对话生成压缩摘要（需要 AI）
      * 将旧消息替换为一条 system 摘要消息
      *
-     * @param {string} conversationId
-     * @param {object} opts
-     * @param {object} opts.aiProvider - AI Provider 实例
-     * @returns {Promise<boolean>} 是否成功压缩
+     * @param opts.aiProvider AI Provider 实例
+     * @returns 是否成功压缩
      */
     async summarize(conversationId, { aiProvider }) {
         if (!aiProvider) {
@@ -248,10 +234,9 @@ export class ConversationStore {
     }
     /**
      * 清理过期对话
-     * @param {object} [opts]
-     * @param {number} [opts.maxAgeDays=30] 超过此天数的对话将被删除
-     * @param {'user'|'system'} [opts.category] 只清理特定类别
-     * @returns {{ deleted: number }}
+     * @param [opts.maxAgeDays=30] 超过此天数的对话将被删除
+     * @param [opts.category] 只清理特定类别
+     * @returns }
      */
     cleanup({ maxAgeDays = 30, category, } = {}) {
         const index = this.#loadIndex();
@@ -275,11 +260,7 @@ export class ConversationStore {
         }
         return { deleted };
     }
-    /**
-     * 估算 token 数 — 委托给共享 token-utils（CJK 感知）
-     * @param {string} text
-     * @returns {number}
-     */
+    /** 估算 token 数 — 委托给共享 token-utils（CJK 感知） */
     estimateTokens(text) {
         return _estimateTokens(text);
     }
@@ -370,4 +351,3 @@ export class ConversationStore {
     }
 }
 export default ConversationStore;
-//# sourceMappingURL=ConversationStore.js.map

package/dist/lib/{service/agent → agent}/IntentClassifier.d.ts

@@ -26,9 +26,7 @@
  *
  * @module IntentClassifier
  */
-/**
- * 意图类型
- */
+/** 意图类型 */
 export declare const Intent: Readonly<{
     /** 知识管理任务 — 搜索/创建/分析知识，由服务端 AgentRuntime 处理 */
     BOT_AGENT: "bot_agent";
@@ -47,19 +45,14 @@ export declare class IntentClassifier {
      * "修复 bug" → "修复 bug" (无包装，原样返回)
      */
     static extractCommand(text: string): string;
-    /**
-     * @param {Object} opts
-     * @param {import('../../external/ai/AiProvider.js').AiProvider} [opts.aiProvider]
-     */
     constructor({ aiProvider }?: {
         aiProvider?: null | undefined;
     });
     /**
      * 分类用户消息意图
      *
-     * @param {string} text 用户原始消息文本
-     * @param {Object} [context] 额外上下文 (如对话历史、最近操作)
-     * @returns {Promise<ClassificationResult>}
+     * @param text 用户原始消息文本
+     * @param [context] 额外上下文 (如对话历史、最近操作)
      */
     classify(text: string, context?: Record<string, unknown>): Promise<{
         intent: "system";
@@ -81,4 +74,3 @@ export declare class IntentClassifier {
     }>;
 }
 export default IntentClassifier;
-//# sourceMappingURL=IntentClassifier.d.ts.map

package/dist/lib/{service/agent → agent}/IntentClassifier.js

@@ -26,10 +26,8 @@
  *
  * @module IntentClassifier
  */
-import Logger from '../../infrastructure/logging/Logger.js';
-/**
- * 意图类型
- */
+import Logger from '#infra/logging/Logger.js';
+/** 意图类型 */
 export const Intent = Object.freeze({
     /** 知识管理任务 — 搜索/创建/分析知识，由服务端 AgentRuntime 处理 */
     BOT_AGENT: 'bot_agent',
@@ -38,15 +36,7 @@ export const Intent = Object.freeze({
     /** 系统操作 — 状态查询/截图/连接管理，本地直接处理 */
     SYSTEM: 'system',
 });
-/**
- * 分类结果
- * @typedef {Object} ClassificationResult
- * @property {string} intent - Intent 枚举值
- * @property {number} confidence - 0-1 置信度
- * @property {string} reasoning 分类理由 (用于日志/调试)
- * @property {string} method - 'rule' | 'llm' 分类方法
- * @property {string} [extractedCommand] - 提取的核心指令 (去除 meta 包装)
- */
+/** 分类结果 */
 // ─── 规则匹配表 ─────────────────────────────────
 // ── 自然语言 meta 包装模式 ──
 // 用户说"在编辑器内输入X"、"让 Copilot 帮我X"，实际指令是 X
@@ -93,9 +83,7 @@ const IDE_STRONG_SIGNALS = [
     // 代码审查
     /review.*代码|看看.*写得|检查.*实现/i,
 ];
-/**
- * Bot Agent 意图 — 知识管理相关关键词
- */
+/** Bot Agent 意图 — 知识管理相关关键词 */
 const BOT_STRONG_SIGNALS = [
     // 知识库操作
     /知识库|knowledge.*base|搜索知识|查[找询].*知识/i,
@@ -171,7 +159,6 @@ const CLASSIFY_SYSTEM_PROMPT = `你是一个意图分类器。用户通过飞书
 去掉"在编辑器/IDE/Copilot 里"、"帮我输入"、"请执行"等 meta 包装，保留核心意图。`;
 // ─── IntentClassifier 实现 ──────────────────────
 export class IntentClassifier {
-    /** @type {import('../../external/ai/AiProvider.js').AiProvider|null} */
     #aiProvider;
     #logger;
     /**
@@ -192,10 +179,6 @@ export class IntentClassifier {
         }
         return result || text; // 防止提取为空
     }
-    /**
-     * @param {Object} opts
-     * @param {import('../../external/ai/AiProvider.js').AiProvider} [opts.aiProvider]
-     */
     constructor({ aiProvider = null } = {}) {
         this.#aiProvider = aiProvider;
         this.#logger = Logger.getInstance();
@@ -203,9 +186,8 @@ export class IntentClassifier {
     /**
      * 分类用户消息意图
      *
-     * @param {string} text 用户原始消息文本
-     * @param {Object} [context] 额外上下文 (如对话历史、最近操作)
-     * @returns {Promise<ClassificationResult>}
+     * @param text 用户原始消息文本
+     * @param [context] 额外上下文 (如对话历史、最近操作)
      */
     async classify(text, context = {}) {
         if (!text?.trim()) {
@@ -257,9 +239,7 @@ export class IntentClassifier {
         };
     }
     // ─── 私有方法 ────────────────────────────────
-    /**
-     * 系统操作匹配 (优先级最高)
-     */
+    /** 系统操作匹配 (优先级最高) */
     #matchSystem(text) {
         for (const rule of SYSTEM_RULES) {
             if (rule.pattern.test(text)) {
@@ -274,9 +254,7 @@ export class IntentClassifier {
         }
         return null;
     }
-    /**
-     * 强信号关键词匹配
-     */
+    /** 强信号关键词匹配 */
     #matchRules(text) {
         let ideScore = 0;
         let botScore = 0;
@@ -324,9 +302,7 @@ export class IntentClassifier {
             method: 'rule',
         };
     }
-    /**
-     * LLM 分类
-     */
+    /** LLM 分类 */
     async #classifyWithLLM(text, context = {}) {
         try {
             const recentHistory = context.recentHistory;
@@ -359,4 +335,3 @@ export class IntentClassifier {
     }
 }
 export default IntentClassifier;
-//# sourceMappingURL=IntentClassifier.js.map

package/dist/lib/{service/agent → agent}/PipelineStrategy.d.ts

@@ -111,4 +111,3 @@ export declare class PipelineStrategy extends Strategy {
     }>;
 }
 export {};
-//# sourceMappingURL=PipelineStrategy.d.ts.map

package/dist/lib/{service/agent → agent}/PipelineStrategy.js

@@ -16,13 +16,12 @@
  *
  * @module PipelineStrategy
  */
-import Logger from '../../infrastructure/logging/Logger.js';
+import Logger from '#infra/logging/Logger.js';
 import { AgentEventBus, AgentEvents } from './AgentEventBus.js';
 import { ExplorationTracker } from './context/ExplorationTracker.js';
 import { Strategy, StrategyRegistry } from './strategies.js';
 const _pipelineLogger = Logger.getInstance();
 export class PipelineStrategy extends Strategy {
-    /** @type {Array<Object>} */
     #stages;
     /** @type {number} 最大重试次数 (Gate 失败时全局兜底) */
     #maxRetries;
@@ -92,7 +91,7 @@ export class PipelineStrategy extends Strategy {
     /**
      * 处理 Quality Gate 阶段
      *
-     * @returns {'break'|'continue'|number} - break/continue 或 retry 回退索引 (i-1)
+     * @returns break/continue 或 retry 回退索引 (i-1)
      */
     #processGate(stage, stageIndex, ctx, bus) {
         const { phaseResults, strategyContext } = ctx;
@@ -175,9 +174,7 @@ export class PipelineStrategy extends Strategy {
     // ═══════════════════════════════════════════════════════════
     // Private: Stage 执行
     // ═══════════════════════════════════════════════════════════
-    /**
-     * 执行单个 Pipeline 阶段
-     */
+    /** 执行单个 Pipeline 阶段 */
     async #executeStage(runtime, message, stage, ctx, bus) {
         const { phaseResults, strategyContext } = ctx;
         bus.publish(AgentEvents.PROGRESS, {
@@ -232,9 +229,7 @@ export class PipelineStrategy extends Strategy {
     // ═══════════════════════════════════════════════════════════
     // Private: Helpers
     // ═══════════════════════════════════════════════════════════
-    /**
-     * 构建阶段 prompt (优先级: retryPromptBuilder > promptBuilder > promptTransform > 原始)
-     */
+    /** 构建阶段 prompt (优先级: retryPromptBuilder > promptBuilder > promptTransform > 原始) */
     async #buildStagePrompt(stage, message, phaseResults, strategyContext, ctx) {
         let prompt;
         if (phaseResults._retryContext && stage.retryPromptBuilder) {
@@ -262,9 +257,7 @@ export class PipelineStrategy extends Strategy {
         }
         return prompt;
     }
-    /**
-     * 为阶段解析 ExplorationTracker
-     */
+    /** 为阶段解析 ExplorationTracker */
     #resolveStageTracker(stage, ctx, strategyContext, effectiveBudget) {
         let stageTracker = (strategyContext.tracker || null);
         const submitToolName = (stage.submitToolName || strategyContext.submitToolName || undefined);
@@ -288,9 +281,7 @@ export class PipelineStrategy extends Strategy {
         }
         return stageTracker;
     }
-    /**
-     * 执行 reactLoop 并添加硬超时保护
-     */
+    /** 执行 reactLoop 并添加硬超时保护 */
     async #runWithTimeout(runtime, stagePrompt, message, stage, effectiveBudget, ctxWin, stageTracker, strategyContext, phaseResults, bus) {
         const reactPromise = runtime.reactLoop(stagePrompt, {
             history: message.history,
@@ -343,9 +334,7 @@ export class PipelineStrategy extends Strategy {
         })
             .finally(() => clearTimeout(hardTimer));
     }
-    /**
-     * 质量门控评估 (向后兼容: 阈值模式)
-     */
+    /** 质量门控评估 (向后兼容: 阈值模式) */
     #evaluateGate(gateConfig, phaseResults, sourceName) {
         const source = phaseResults[sourceName];
         if (!source?.reply) {
@@ -376,9 +365,7 @@ export class PipelineStrategy extends Strategy {
         }
         return reasons.length === 0 ? { pass: true } : { pass: false, reason: reasons.join('; ') };
     }
-    /**
-     * 找到当前 gate 之前最近的执行阶段索引 (用于 retry 回退)
-     */
+    /** 找到当前 gate 之前最近的执行阶段索引 (用于 retry 回退) */
     #findPrevExecStageIdx(currentIdx) {
         for (let j = currentIdx - 1; j >= 0; j--) {
             if (!this.#stages[j].gate) {
@@ -399,4 +386,3 @@ export class PipelineStrategy extends Strategy {
 }
 // 自注册: 避免 strategies.js ↔ PipelineStrategy.js 循环依赖
 StrategyRegistry.register('pipeline', PipelineStrategy);
-//# sourceMappingURL=PipelineStrategy.js.map

package/dist/lib/{service/agent → agent}/capabilities.d.ts

@@ -49,9 +49,7 @@ interface ConversationOpts {
 interface SystemInteractionOpts {
     projectRoot?: string;
 }
-/**
- * Capability 基类 — 所有技能模块的抽象接口
- */
+/** Capability 基类 — 所有技能模块的抽象接口 */
 export declare class Capability {
     /** 能力名称 */
     get name(): string;
@@ -59,17 +57,11 @@ export declare class Capability {
     get promptFragment(): string;
     /** 工具白名单 */
     get tools(): string[];
-    /**
-     * 构建 prompt 时调用，可注入动态上下文
-     */
+    /** 构建 prompt 时调用，可注入动态上下文 */
     buildContext(_context: unknown): string | null;
-    /**
-     * 每轮 ReAct 步骤前的钩子
-     */
+    /** 每轮 ReAct 步骤前的钩子 */
     onBeforeStep(_stepState: unknown): void;
-    /**
-     * 每轮 ReAct 步骤后的钩子
-     */
+    /** 每轮 ReAct 步骤后的钩子 */
     onAfterStep(_stepResult: unknown): void;
 }
 /**
@@ -81,10 +73,9 @@ export declare class Capability {
 export declare class Conversation extends Capability {
     #private;
     /**
-     * @param {Object} [opts]
-     * @param {Object} [opts.memoryCoordinator] - MemoryCoordinator 实例
-     * @param {string} [opts.soulPath] - SOUL.md 路径
-     * @param {string} [opts.projectBriefing] 项目概况文本
+     * @param [opts.memoryCoordinator] MemoryCoordinator 实例
+     * @param [opts.soulPath] SOUL.md 路径
+     * @param [opts.projectBriefing] 项目概况文本
      */
     constructor(opts?: ConversationOpts);
     get name(): string;
@@ -130,10 +121,7 @@ export declare class KnowledgeProduction extends Capability {
  */
 export declare class SystemInteraction extends Capability {
     #private;
-    /**
-     * @param {Object} [opts]
-     * @param {string} [opts.projectRoot] 项目根目录 (限制操作范围)
-     */
+    /** @param [opts.projectRoot] 项目根目录 (限制操作范围) */
     constructor(opts?: SystemInteractionOpts);
     get name(): string;
     get promptFragment(): string;
@@ -162,18 +150,9 @@ export declare class ScanProduction extends Capability {
  */
 export declare const CapabilityRegistry: {
     _registry: Map<string, typeof Capability>;
-    /**
-     * 按名称创建 Capability 实例
-     * @param {string} name
-     * @param {Object} [opts]
-     * @returns {Capability}
-     */
+    /** 按名称创建 Capability 实例 */
     create(name: string, opts?: Record<string, unknown>): Capability;
-    /**
-     * 注册自定义 Capability
-     * @param {string} name
-     * @param {typeof Capability} cls
-     */
+    /** 注册自定义 Capability */
     register(name: string, cls: typeof Capability): void;
     /** 所有注册名 */
     readonly names: string[];
@@ -186,22 +165,12 @@ declare const _default: {
     SystemInteraction: typeof SystemInteraction;
     CapabilityRegistry: {
         _registry: Map<string, typeof Capability>;
-        /**
-         * 按名称创建 Capability 实例
-         * @param {string} name
-         * @param {Object} [opts]
-         * @returns {Capability}
-         */
+        /** 按名称创建 Capability 实例 */
         create(name: string, opts?: Record<string, unknown>): Capability;
-        /**
-         * 注册自定义 Capability
-         * @param {string} name
-         * @param {typeof Capability} cls
-         */
+        /** 注册自定义 Capability */
         register(name: string, cls: typeof Capability): void;
         /** 所有注册名 */
         readonly names: string[];
     };
 };
 export default _default;
-//# sourceMappingURL=capabilities.d.ts.map

package/dist/lib/{service/agent → agent}/capabilities.js

@@ -21,11 +21,9 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
-import { PACKAGE_ROOT } from '../../shared/package-root.js';
+import { PACKAGE_ROOT } from '#shared/package-root.js';
 // ─── Base Capability ─────────────────────────────────────
-/**
- * Capability 基类 — 所有技能模块的抽象接口
- */
+/** Capability 基类 — 所有技能模块的抽象接口 */
 export class Capability {
     /** 能力名称 */
     get name() {
@@ -39,19 +37,13 @@ export class Capability {
     get tools() {
         return [];
     }
-    /**
-     * 构建 prompt 时调用，可注入动态上下文
-     */
+    /** 构建 prompt 时调用，可注入动态上下文 */
     buildContext(_context) {
         return null;
     }
-    /**
-     * 每轮 ReAct 步骤前的钩子
-     */
+    /** 每轮 ReAct 步骤前的钩子 */
     onBeforeStep(_stepState) { }
-    /**
-     * 每轮 ReAct 步骤后的钩子
-     */
+    /** 每轮 ReAct 步骤后的钩子 */
     onAfterStep(_stepResult) { }
 }
 // ─── Conversation — 对话能力 ─────────────────────
@@ -66,10 +58,9 @@ export class Conversation extends Capability {
     #soulContent;
     #projectBriefing;
     /**
-     * @param {Object} [opts]
-     * @param {Object} [opts.memoryCoordinator] - MemoryCoordinator 实例
-     * @param {string} [opts.soulPath] - SOUL.md 路径
-     * @param {string} [opts.projectBriefing] 项目概况文本
+     * @param [opts.memoryCoordinator] MemoryCoordinator 实例
+     * @param [opts.soulPath] SOUL.md 路径
+     * @param [opts.projectBriefing] 项目概况文本
      */
     constructor(opts = {}) {
         super();
@@ -262,10 +253,7 @@ export class KnowledgeProduction extends Capability {
  */
 export class SystemInteraction extends Capability {
     #projectRoot;
-    /**
-     * @param {Object} [opts]
-     * @param {string} [opts.projectRoot] 项目根目录 (限制操作范围)
-     */
+    /** @param [opts.projectRoot] 项目根目录 (限制操作范围) */
     constructor(opts = {}) {
         super();
         this.#projectRoot = opts.projectRoot || process.cwd();
@@ -368,12 +356,7 @@ export const CapabilityRegistry = {
         ['scan_production', ScanProduction],
         ['system_interaction', SystemInteraction],
     ]),
-    /**
-     * 按名称创建 Capability 实例
-     * @param {string} name
-     * @param {Object} [opts]
-     * @returns {Capability}
-     */
+    /** 按名称创建 Capability 实例 */
     create(name, opts = {}) {
         const Cls = this._registry.get(name);
         if (!Cls) {
@@ -381,11 +364,7 @@ export const CapabilityRegistry = {
         }
         return new Cls(opts);
     },
-    /**
-     * 注册自定义 Capability
-     * @param {string} name
-     * @param {typeof Capability} cls
-     */
+    /** 注册自定义 Capability */
     register(name, cls) {
         this._registry.set(name, cls);
     },
@@ -402,4 +381,3 @@ export default {
     SystemInteraction,
     CapabilityRegistry,
 };
-//# sourceMappingURL=capabilities.js.map