autosnippet 3.2.16 → 3.2.18

package/dist/lib/injection/ServiceMap.d.ts

@@ -6,6 +6,8 @@
  *
  * @module ServiceMap
  */
+import type { AgentFactory } from '../agent/AgentFactory.js';
+import type { ToolRegistry } from '../agent/tools/ToolRegistry.js';
 import type { KnowledgeSyncService } from '../cli/KnowledgeSyncService.js';
 import type ProjectGraph from '../core/ast/ProjectGraph.js';
 import type Constitution from '../core/constitution/Constitution.js';
@@ -23,12 +25,10 @@ import type { SpmHelper } from '../platform/ios/spm/SpmHelper.js';
 import type { KnowledgeRepositoryImpl } from '../repository/knowledge/KnowledgeRepository.impl.js';
 import type { TaskRepositoryImpl } from '../repository/task/TaskRepository.impl.js';
 import type { TokenUsageStore } from '../repository/token/TokenUsageStore.js';
-import type { AgentFactory } from '../service/agent/AgentFactory.js';
-import type { ToolRegistry } from '../service/agent/tools/ToolRegistry.js';
 import type { AutomationOrchestrator } from '../service/automation/AutomationOrchestrator.js';
 import type { BootstrapTaskManager } from '../service/bootstrap/BootstrapTaskManager.js';
-import type { RecipeExtractor } from '../service/context/RecipeExtractor.js';
-import type { CursorDeliveryPipeline } from '../service/cursor/CursorDeliveryPipeline.js';
+import type DimensionCopy from '../service/bootstrap/DimensionCopyRegistry.js';
+import type { CursorDeliveryPipeline } from '../service/delivery/CursorDeliveryPipeline.js';
 import type { ComplianceReporter } from '../service/guard/ComplianceReporter.js';
 import type { ExclusionManager } from '../service/guard/ExclusionManager.js';
 import type { GuardCheckEngine } from '../service/guard/GuardCheckEngine.js';
@@ -41,6 +41,7 @@ import type { ConfidenceRouter } from '../service/knowledge/ConfidenceRouter.js'
 import type { KnowledgeFileWriter } from '../service/knowledge/KnowledgeFileWriter.js';
 import type { KnowledgeGraphService } from '../service/knowledge/KnowledgeGraphService.js';
 import type { KnowledgeService } from '../service/knowledge/KnowledgeService.js';
+import type { RecipeExtractor } from '../service/knowledge/RecipeExtractor.js';
 import type { ModuleService } from '../service/module/ModuleService.js';
 import type { FeedbackCollector } from '../service/quality/FeedbackCollector.js';
 import type { QualityScorer } from '../service/quality/QualityScorer.js';
@@ -56,7 +57,6 @@ import type { TaskKnowledgeBridge } from '../service/task/TaskKnowledgeBridge.js
 import type { TaskReadyEngine } from '../service/task/TaskReadyEngine.js';
 import type { ContextualEnricher } from '../service/vector/ContextualEnricher.js';
 import type { VectorService } from '../service/vector/VectorService.js';
-import type DimensionCopy from '../shared/DimensionCopyRegistry.js';
 import type { LanguageService } from '../shared/LanguageService.js';
 /**
  * 类型安全的服务映射表
@@ -121,4 +121,3 @@ export interface ServiceMap {
     agentFactory: AgentFactory;
     skillHooks: SkillHooks;
 }
-//# sourceMappingURL=ServiceMap.d.ts.map

package/dist/lib/injection/ServiceMap.js

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

package/dist/lib/injection/modules/AgentModule.d.ts

@@ -4,9 +4,6 @@
  * 负责注册:
  *   - agentFactory, toolRegistry, skillHooks
  *   - feedbackStore, recommendationPipeline, recommendationMetrics
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import type { ServiceContainer } from '../ServiceContainer.js';
 export declare function register(c: ServiceContainer): void;
-//# sourceMappingURL=AgentModule.d.ts.map

package/dist/lib/injection/modules/AgentModule.js

@@ -4,13 +4,11 @@
  * 负责注册:
  *   - agentFactory, toolRegistry, skillHooks
  *   - feedbackStore, recommendationPipeline, recommendationMetrics
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
-import { AgentFactory } from '../../service/agent/AgentFactory.js';
-import { ALL_TOOLS } from '../../service/agent/tools/index.js';
-import { ToolRegistry } from '../../service/agent/tools/ToolRegistry.js';
+import { AgentFactory } from '../../agent/AgentFactory.js';
+import { ALL_TOOLS } from '../../agent/tools/index.js';
+import { ToolRegistry } from '../../agent/tools/ToolRegistry.js';
 import { AIRecallStrategy } from '../../service/skills/AIRecallStrategy.js';
 import { FeedbackStore } from '../../service/skills/FeedbackStore.js';
 import { RecommendationMetrics } from '../../service/skills/RecommendationMetrics.js';
@@ -59,4 +57,3 @@ export function register(c) {
         return new RecommendationMetrics(feedbackStore);
     });
 }
-//# sourceMappingURL=AgentModule.js.map

package/dist/lib/injection/modules/AiModule.d.ts

@@ -33,4 +33,3 @@ export declare function initEmbeddingFallback(c: ServiceContainer): void;
  * 此方法注册便于其他模块通过 container.get() 获取的快捷服务。
  */
 export declare function register(c: ServiceContainer): void;
-//# sourceMappingURL=AiModule.d.ts.map

package/dist/lib/injection/modules/AiModule.js

@@ -96,4 +96,3 @@ export function register(c) {
     // 此处仅标记 AI 模块已就绪
     c.singletons._aiModuleReady = true;
 }
-//# sourceMappingURL=AiModule.js.map

package/dist/lib/injection/modules/AppModule.d.ts

@@ -7,14 +7,8 @@
  *   - spmService, automationOrchestrator, moduleService
  *   - cursorDeliveryPipeline
  *   - taskIdGenerator, taskReadyEngine, taskKnowledgeBridge, taskGraphService
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import type { ServiceContainer } from '../ServiceContainer.js';
 export declare function register(c: ServiceContainer): void;
-/**
- * 初始化 RecipeExtractor 实例 (在 initialize 期间调用)
- * @param {import('../ServiceContainer.js').ServiceContainer} c
- */
+/** 初始化 RecipeExtractor 实例 (在 initialize 期间调用) */
 export declare function initRecipeExtractor(c: ServiceContainer): void;
-//# sourceMappingURL=AppModule.d.ts.map

package/dist/lib/injection/modules/AppModule.js

@@ -7,8 +7,6 @@
  *   - spmService, automationOrchestrator, moduleService
  *   - cursorDeliveryPipeline
  *   - taskIdGenerator, taskReadyEngine, taskKnowledgeBridge, taskGraphService
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
 import { TaskIdGenerator } from '../../domain/task/TaskIdGenerator.js';
@@ -16,8 +14,8 @@ import { XcodeCodec } from '../../platform/ios/snippet/XcodeCodec.js';
 import { SpmHelper } from '../../platform/ios/spm/SpmHelper.js';
 import { TokenUsageStore } from '../../repository/token/TokenUsageStore.js';
 import { AutomationOrchestrator } from '../../service/automation/AutomationOrchestrator.js';
-import { RecipeExtractor } from '../../service/context/RecipeExtractor.js';
-import { CursorDeliveryPipeline } from '../../service/cursor/CursorDeliveryPipeline.js';
+import { CursorDeliveryPipeline } from '../../service/delivery/CursorDeliveryPipeline.js';
+import { RecipeExtractor } from '../../service/knowledge/RecipeExtractor.js';
 import { ModuleService } from '../../service/module/ModuleService.js';
 import { FeedbackCollector } from '../../service/quality/FeedbackCollector.js';
 import { QualityScorer } from '../../service/quality/QualityScorer.js';
@@ -90,11 +88,7 @@ export function register(c) {
     c.singleton('taskKnowledgeBridge', (ct) => new TaskKnowledgeBridge(ct.get('searchEngine')));
     c.singleton('taskGraphService', (ct) => new TaskGraphService(ct.get('taskRepository'), ct.get('taskReadyEngine'), ct.get('taskKnowledgeBridge'), ct.get('auditLogger'), ct.get('taskIdGenerator')));
 }
-/**
- * 初始化 RecipeExtractor 实例 (在 initialize 期间调用)
- * @param {import('../ServiceContainer.js').ServiceContainer} c
- */
+/** 初始化 RecipeExtractor 实例 (在 initialize 期间调用) */
 export function initRecipeExtractor(c) {
     c.singletons._recipeExtractor = new RecipeExtractor();
 }
-//# sourceMappingURL=AppModule.js.map

package/dist/lib/injection/modules/GuardModule.d.ts

@@ -5,9 +5,6 @@
  *   - guardService, guardCheckEngine
  *   - exclusionManager, ruleLearner, violationsStore
  *   - complianceReporter, guardFeedbackLoop
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import type { ServiceContainer } from '../ServiceContainer.js';
 export declare function register(c: ServiceContainer): void;
-//# sourceMappingURL=GuardModule.d.ts.map

package/dist/lib/injection/modules/GuardModule.js

@@ -5,8 +5,6 @@
  *   - guardService, guardCheckEngine
  *   - exclusionManager, ruleLearner, violationsStore
  *   - complianceReporter, guardFeedbackLoop
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
 import { ComplianceReporter } from '../../service/guard/ComplianceReporter.js';
@@ -53,4 +51,3 @@ export function register(c) {
         guardCheckEngine: ct.get('guardCheckEngine'),
     }));
 }
-//# sourceMappingURL=GuardModule.js.map

package/dist/lib/injection/modules/InfraModule.d.ts

@@ -6,9 +6,6 @@
  *   - gateway, eventBus, bootstrapTaskManager
  *   - knowledgeRepository, knowledgeFileWriter, knowledgeSyncService
  *   - taskRepository
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import type { ServiceContainer } from '../ServiceContainer.js';
 export declare function register(c: ServiceContainer): void;
-//# sourceMappingURL=InfraModule.d.ts.map

package/dist/lib/injection/modules/InfraModule.js

@@ -6,8 +6,6 @@
  *   - gateway, eventBus, bootstrapTaskManager
  *   - knowledgeRepository, knowledgeFileWriter, knowledgeSyncService
  *   - taskRepository
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
 import { KnowledgeSyncService } from '../../cli/KnowledgeSyncService.js';
@@ -73,4 +71,3 @@ export function register(c) {
         return new TaskRepositoryImpl(db, drizzle);
     });
 }
-//# sourceMappingURL=InfraModule.js.map

package/dist/lib/injection/modules/KnowledgeModule.d.ts

@@ -6,9 +6,6 @@
  *   - searchEngine, vectorStore, indexingPipeline
  *   - discovererRegistry, enhancementRegistry, languageService, dimensionCopy
  *   - constitution, aiProvider, projectGraph
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import type { ServiceContainer } from '../ServiceContainer.js';
 export declare function register(c: ServiceContainer): void;
-//# sourceMappingURL=KnowledgeModule.d.ts.map

package/dist/lib/injection/modules/KnowledgeModule.js

@@ -6,8 +6,6 @@
  *   - searchEngine, vectorStore, indexingPipeline
  *   - discovererRegistry, enhancementRegistry, languageService, dimensionCopy
  *   - constitution, aiProvider, projectGraph
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
 import { getDiscovererRegistry } from '../../core/discovery/index.js';
@@ -15,6 +13,7 @@ import { getEnhancementRegistry } from '../../core/enhancement/index.js';
 import { HnswVectorAdapter } from '../../infrastructure/vector/HnswVectorAdapter.js';
 import { IndexingPipeline } from '../../infrastructure/vector/IndexingPipeline.js';
 import { JsonVectorAdapter } from '../../infrastructure/vector/JsonVectorAdapter.js';
+import { DimensionCopy } from '../../service/bootstrap/DimensionCopyRegistry.js';
 import { CodeEntityGraph } from '../../service/knowledge/CodeEntityGraph.js';
 import { ConfidenceRouter } from '../../service/knowledge/ConfidenceRouter.js';
 import { KnowledgeGraphService } from '../../service/knowledge/KnowledgeGraphService.js';
@@ -22,7 +21,6 @@ import { KnowledgeService } from '../../service/knowledge/KnowledgeService.js';
 import { CrossEncoderReranker } from '../../service/search/CrossEncoderReranker.js';
 import { HybridRetriever } from '../../service/search/HybridRetriever.js';
 import { SearchEngine } from '../../service/search/SearchEngine.js';
-import { DimensionCopy } from '../../shared/DimensionCopyRegistry.js';
 import { LanguageService } from '../../shared/LanguageService.js';
 export function register(c) {
     // ═══ Knowledge ═══
@@ -124,4 +122,3 @@ export function register(c) {
     c.register('aiProvider', () => c.singletons.aiProvider || null);
     c.register('projectGraph', () => c.singletons.projectGraph || null);
 }
-//# sourceMappingURL=KnowledgeModule.js.map

package/dist/lib/injection/modules/VectorModule.d.ts

@@ -7,8 +7,6 @@
  *
  * 依赖 KnowledgeModule 先注册: vectorStore, indexingPipeline, hybridRetriever
  * 依赖 InfraModule 先注册: eventBus, database
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import type { ServiceContainer } from '../ServiceContainer.js';
 export declare function register(c: ServiceContainer): void;
@@ -17,4 +15,3 @@ export declare function register(c: ServiceContainer): void;
  * 用于绑定 EventBus 监听等异步初始化操作，同时将 ContextualEnricher 注入 IndexingPipeline
  */
 export declare function initializeVectorService(c: ServiceContainer): Promise<void>;
-//# sourceMappingURL=VectorModule.d.ts.map

package/dist/lib/injection/modules/VectorModule.js

@@ -7,8 +7,6 @@
  *
  * 依赖 KnowledgeModule 先注册: vectorStore, indexingPipeline, hybridRetriever
  * 依赖 InfraModule 先注册: eventBus, database
- *
- * @param {import('../ServiceContainer.js').ServiceContainer} c
  */
 import { ContextualEnricher } from '../../service/vector/ContextualEnricher.js';
 import { VectorService } from '../../service/vector/VectorService.js';
@@ -71,4 +69,3 @@ export async function initializeVectorService(c) {
         }
     }
 }
-//# sourceMappingURL=VectorModule.js.map

package/dist/lib/{infrastructure/external → platform}/ClipboardManager.d.ts

@@ -10,20 +10,15 @@
  */
 /**
  * 读取剪贴板内容
- * @returns {string} 剪贴板文本，失败返回空字符串
+ * @returns 剪贴板文本，失败返回空字符串
  */
 export declare function read(): string;
-/**
- * 写入内容到剪贴板
- * @param {string} text
- * @returns {boolean}
- */
+/** 写入内容到剪贴板 */
 export declare function write(text: string): boolean;
 /**
  * 保存当前剪贴板 → 执行回调 → 恢复剪贴板
  *
- * @param {Function} fn 在剪贴板保存期间执行的函数
- * @returns {Promise<*>} fn 的返回值
+ * @param fn 在剪贴板保存期间执行的函数
+ * @returns fn 的返回值
  */
 export declare function withClipboardSave(fn: () => Promise<unknown>): Promise<unknown>;
-//# sourceMappingURL=ClipboardManager.d.ts.map

package/dist/lib/{infrastructure/external → platform}/ClipboardManager.js

@@ -10,12 +10,8 @@
  */
 import { execSync } from 'node:child_process';
 const TIMEOUT = 3000;
-/** @type {'darwin'|'win32'|'linux'|string} */
 const PLATFORM = process.platform;
-/**
- * 检测 Linux 剪贴板后端
- * @returns {'xclip'|'xsel'|'wl'|null}
- */
+/** 检测 Linux 剪贴板后端 */
 function _linuxBackend() {
     // Wayland
     if (process.env.WAYLAND_DISPLAY) {
@@ -54,7 +50,7 @@ function getLinuxBackend() {
 }
 /**
  * 读取剪贴板内容
- * @returns {string} 剪贴板文本，失败返回空字符串
+ * @returns 剪贴板文本，失败返回空字符串
  */
 export function read() {
     try {
@@ -84,11 +80,7 @@ export function read() {
         return '';
     }
 }
-/**
- * 写入内容到剪贴板
- * @param {string} text
- * @returns {boolean}
- */
+/** 写入内容到剪贴板 */
 export function write(text) {
     try {
         if (PLATFORM === 'darwin') {
@@ -134,8 +126,8 @@ export function write(text) {
 /**
  * 保存当前剪贴板 → 执行回调 → 恢复剪贴板
  *
- * @param {Function} fn 在剪贴板保存期间执行的函数
- * @returns {Promise<*>} fn 的返回值
+ * @param fn 在剪贴板保存期间执行的函数
+ * @returns fn 的返回值
  */
 export async function withClipboardSave(fn) {
     const saved = read();
@@ -148,4 +140,3 @@ export async function withClipboardSave(fn) {
         }
     }
 }
-//# sourceMappingURL=ClipboardManager.js.map

package/dist/lib/{infrastructure/external → platform}/NativeUi.d.ts

@@ -8,16 +8,14 @@
  *
  * V2 ESM 版本，对应 V1 NativeUi.js
  */
-/**
- * 检查 Swift Helper 是否可用
- */
+/** 检查 Swift Helper 是否可用 */
 export declare function isNativeUiAvailable(): boolean;
 /**
  * 用组合窗口展示搜索结果（列表 + 预览）
  *
  * @param {Array<{title: string, code: string, explanation?: string, groupSize?: number}>} items
- * @param {string} keyword 搜索关键词
- * @returns {number} 选中的索引（0-based），-1 表示取消
+ * @param keyword 搜索关键词
+ * @returns 选中的索引（0-based），-1 表示取消
  */
 export declare function showCombinedWindow(items: Array<{
     title: string;
@@ -28,32 +26,28 @@ export declare function showCombinedWindow(items: Array<{
 /**
  * 简单列表选择弹窗
  *
- * @param {string[]} items 选项列表
- * @param {string} title 窗口标题
- * @param {string} prompt 提示文本
- * @returns {number} 选中索引（0-based），-1 取消
+ * @param items 选项列表
+ * @param title 窗口标题
+ * @param prompt 提示文本
+ * @returns 选中索引（0-based），-1 取消
  */
 export declare function showListSelection(items: string[], title?: string, prompt?: string): number;
 /**
  * 代码预览确认弹窗
  *
- * @param {string} title 标题
- * @param {string} code 代码内容
- * @returns {boolean} 用户是否确认
+ * @param title 标题
+ * @param code 代码内容
+ * @returns 用户是否确认
  */
 export declare function showPreviewConfirm(title: string, code: string): boolean;
 /**
  * macOS / Linux / Windows 系统通知
- * @param {string} message 通知内容
- * @param {string} [title='AutoSnippet']
+ * @param message 通知内容
  */
 export declare function notify(message: string, title?: string): void;
 /**
  * macOS 带按钮的对话框
- * @param {string} message
- * @param {string[]} buttons 按钮列表（从右到左排列）
- * @param {string} [title='AutoSnippet']
- * @returns {string|null} 点击的按钮名，或 null 表示取消
+ * @param buttons 按钮列表（从右到左排列）
+ * @returns 点击的按钮名，或 null 表示取消
  */
 export declare function promptWithButtons(message: string, buttons?: string[], title?: string): string | null;
-//# sourceMappingURL=NativeUi.d.ts.map

package/dist/lib/{infrastructure/external → platform}/NativeUi.js

@@ -11,7 +11,7 @@
 import { execFileSync, execSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { RESOURCES_DIR } from '../../shared/package-root.js';
+import { RESOURCES_DIR } from '#shared/package-root.js';
 const NATIVE_UI_PATH = join(RESOURCES_DIR, 'native-ui/native-ui');
 const NATIVE_UI_SRC = join(RESOURCES_DIR, 'native-ui/main.swift');
 const NATIVE_UI_COMBINED = join(RESOURCES_DIR, 'native-ui/combined-window.swift');
@@ -45,9 +45,7 @@ function _tryLazyBuild() {
         // 编译失败 — 静默降级
     }
 }
-/**
- * 检查 Swift Helper 是否可用
- */
+/** 检查 Swift Helper 是否可用 */
 export function isNativeUiAvailable() {
     if (process.platform !== 'darwin') {
         return false;
@@ -68,8 +66,8 @@ export function isNativeUiAvailable() {
  * 用组合窗口展示搜索结果（列表 + 预览）
  *
  * @param {Array<{title: string, code: string, explanation?: string, groupSize?: number}>} items
- * @param {string} keyword 搜索关键词
- * @returns {number} 选中的索引（0-based），-1 表示取消
+ * @param keyword 搜索关键词
+ * @returns 选中的索引（0-based），-1 表示取消
  */
 export function showCombinedWindow(items, keyword = '') {
     if (!items || items.length === 0) {
@@ -111,10 +109,10 @@ export function showCombinedWindow(items, keyword = '') {
 /**
  * 简单列表选择弹窗
  *
- * @param {string[]} items 选项列表
- * @param {string} title 窗口标题
- * @param {string} prompt 提示文本
- * @returns {number} 选中索引（0-based），-1 取消
+ * @param items 选项列表
+ * @param title 窗口标题
+ * @param prompt 提示文本
+ * @returns 选中索引（0-based），-1 取消
  */
 export function showListSelection(items, title = 'AutoSnippet', prompt = '请选择：') {
     if (!items || items.length === 0) {
@@ -162,9 +160,9 @@ export function showListSelection(items, title = 'AutoSnippet', prompt = '请选
 /**
  * 代码预览确认弹窗
  *
- * @param {string} title 标题
- * @param {string} code 代码内容
- * @returns {boolean} 用户是否确认
+ * @param title 标题
+ * @param code 代码内容
+ * @returns 用户是否确认
  */
 export function showPreviewConfirm(title, code) {
     // 1. Swift Helper
@@ -196,8 +194,7 @@ export function showPreviewConfirm(title, code) {
 }
 /**
  * macOS / Linux / Windows 系统通知
- * @param {string} message 通知内容
- * @param {string} [title='AutoSnippet']
+ * @param message 通知内容
  */
 export function notify(message, title = 'AutoSnippet') {
     try {
@@ -245,10 +242,8 @@ export function notify(message, title = 'AutoSnippet') {
 }
 /**
  * macOS 带按钮的对话框
- * @param {string} message
- * @param {string[]} buttons 按钮列表（从右到左排列）
- * @param {string} [title='AutoSnippet']
- * @returns {string|null} 点击的按钮名，或 null 表示取消
+ * @param buttons 按钮列表（从右到左排列）
+ * @returns 点击的按钮名，或 null 表示取消
  */
 export function promptWithButtons(message, buttons = ['确认', '取消'], title = 'AutoSnippet') {
     if (process.platform !== 'darwin') {
@@ -287,4 +282,3 @@ function _consoleFallback(items, _keyword) {
     items.forEach((_item, _i) => { });
     return -1;
 }
-//# sourceMappingURL=NativeUi.js.map

package/dist/lib/{infrastructure/external → platform}/OpenBrowser.d.ts

@@ -6,15 +6,12 @@
  *
  * V2 ESM 版本，对应 V1 OpenBrowser.js
  */
-/**
- * 检测当前进程是否已有控制 Chromium 系浏览器的权限 (macOS only)
- */
+/** 检测当前进程是否已有控制 Chromium 系浏览器的权限 (macOS only) */
 export declare function hasMacOSBrowserControlGranted(): boolean;
 /**
  * macOS 上尝试复用已打开的同 URL 标签，失败则用 open 新开
  *
- * @param {string} url 要打开的地址
- * @param {string} [baseUrlForLookup] 可选 base URL，按 base 查找标签后导航到 url
+ * @param url 要打开的地址
+ * @param [baseUrlForLookup] 可选 base URL，按 base 查找标签后导航到 url
  */
 export declare function openBrowserReuseTab(url: string, baseUrlForLookup?: string): void;
-//# sourceMappingURL=OpenBrowser.d.ts.map

package/dist/lib/{infrastructure/external → platform}/OpenBrowser.js

@@ -10,7 +10,7 @@ import { execFileSync, execSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
-import { RESOURCES_DIR } from '../../shared/package-root.js';
+import { RESOURCES_DIR } from '#shared/package-root.js';
 const IS_MAC = process.platform === 'darwin';
 function isAppInstalled(appName) {
     if (!IS_MAC) {
@@ -23,9 +23,7 @@ function isAppInstalled(appName) {
     ];
     return candidates.some((p) => existsSync(p));
 }
-/**
- * 检测当前进程是否已有控制 Chromium 系浏览器的权限 (macOS only)
- */
+/** 检测当前进程是否已有控制 Chromium 系浏览器的权限 (macOS only) */
 export function hasMacOSBrowserControlGranted() {
     if (!IS_MAC) {
         return false;
@@ -57,8 +55,8 @@ export function hasMacOSBrowserControlGranted() {
 /**
  * macOS 上尝试复用已打开的同 URL 标签，失败则用 open 新开
  *
- * @param {string} url 要打开的地址
- * @param {string} [baseUrlForLookup] 可选 base URL，按 base 查找标签后导航到 url
+ * @param url 要打开的地址
+ * @param [baseUrlForLookup] 可选 base URL，按 base 查找标签后导航到 url
  */
 export function openBrowserReuseTab(url, baseUrlForLookup) {
     const skipReuse = process.env.ASD_UI_NO_REUSE_TAB === '1' || process.env.ASD_UI_OPEN_REUSE === '0';
@@ -105,9 +103,7 @@ export function openBrowserReuseTab(url, baseUrlForLookup) {
     // 所有 AppleScript 尝试失败或非 macOS
     _fallbackOpen(url);
 }
-/**
- * 回退 open 方式
- */
+/** 回退 open 方式 */
 async function _fallbackOpen(url) {
     try {
         const open = (await import('open')).default;
@@ -119,4 +115,3 @@ async function _fallbackOpen(url) {
         console.error(`⚠️ 打开浏览器失败: ${err.message}`);
     }
 }
-//# sourceMappingURL=OpenBrowser.js.map

package/dist/lib/platform/ScreenCaptureService.d.ts

@@ -25,12 +25,11 @@ interface ScreenshotToolResult {
 /**
  * 截取屏幕或窗口画面（核心功能 — 息屏可用）
  *
- * @param {object} opts
- * @param {string} [opts.windowTitle] 窗口标题关键词（模糊匹配），默认截整屏
- * @param {string} [opts.format] - 'jpeg' | 'png'
- * @param {number} [opts.scale] 缩放因子 (0.25-2.0)
- * @param {string} [opts.outputPath] 输出路径，默认临时目录
- * @returns {Promise<{success: boolean, path?: string, width?: number, height?: number, error?: string}>}
+ * @param [opts.windowTitle] 窗口标题关键词（模糊匹配），默认截整屏
+ * @param [opts.format] 'jpeg' | 'png'
+ * @param [opts.scale] 缩放因子 (0.25-2.0)
+ * @param [opts.outputPath] 输出路径，默认临时目录
+ * @returns >}
  */
 export declare function screenshot(opts?: ScreenshotOptions): Promise<{
     success: boolean;
@@ -51,7 +50,7 @@ export declare function screenshot(opts?: ScreenshotOptions): Promise<{
 }>;
 /**
  * 列出所有可截取的窗口
- * @returns {Promise<{success: boolean, windows?: Array, error?: string}>}
+ * @returns >}
  */
 export declare function listWindows(): Promise<{
     success: boolean;
@@ -64,11 +63,10 @@ export declare function listWindows(): Promise<{
 }>;
 /**
  * 检查截图服务是否可用
- * @returns {{available: boolean, error?: string}}
+ * @returns }
  */
 export declare function isScreenCaptureAvailable(): {
     available: boolean;
     error: string | undefined;
 };
 export {};
-//# sourceMappingURL=ScreenCaptureService.d.ts.map