autosnippet 3.2.18 → 3.2.20

package/dist/lib/agent/PipelineStrategy.js

@@ -23,7 +23,7 @@ import { Strategy, StrategyRegistry } from './strategies.js';
 const _pipelineLogger = Logger.getInstance();
 export class PipelineStrategy extends Strategy {
     #stages;
-    /** @type {number} 最大重试次数 (Gate 失败时全局兜底) */
+    /** 最大重试次数 (Gate 失败时全局兜底) */
     #maxRetries;
     constructor({ stages = [], maxRetries = 1, } = {}) {
         super();

package/dist/lib/agent/context/ContextWindow.d.ts

@@ -62,7 +62,7 @@ export declare class ContextWindow {
      *   - 微窗口 (<16k):  预算 = 窗口 × 0.7（留 30% 给 prompt/tool schema）
      *
      * @param modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-4o-mini'
-     * @param {{ isSystem?: boolean }} [opts] - isSystem 为 true 时给予更高预算
+     * @param [opts] - isSystem 为 true 时给予更高预算
      * @returns 建议的 token 预算
      */
     static resolveTokenBudget(modelName: string, opts?: {
@@ -147,7 +147,7 @@ export declare class ContextWindow {
  *
  * @param toolName 工具名
  * @param result 工具原始返回
- * @param {{ maxChars: number, maxMatches: number }} quota 动态配额
+ * @param quota 动态配额
  * @returns 压缩后的结果字符串
  */
 export declare function limitToolResult(toolName: string, result: unknown, quota: ToolResultQuota): string;

package/dist/lib/agent/context/ContextWindow.js

@@ -28,15 +28,15 @@ import { estimateTokensFast } from '#shared/token-utils.js';
  * - 或单独的 user/assistant 文本消息
  */
 export class ContextWindow {
-    /** @type {Array<ContextMessage>} 统一格式消息 */
+    /** 统一格式消息 */
     #messages = [];
-    /** @type {number} token 预算（默认 24000，约对应 Gemini 的安全阈值） */
+    /** token 预算（默认 24000，约对应 Gemini 的安全阈值） */
     #tokenBudget;
-    /** @type {Array<string>} 被压缩掉的轮次摘要（用于 digest 生成） */
+    /** 被压缩掉的轮次摘要（用于 digest 生成） */
     #compactionLog = [];
-    /** @type {Set<string>} 被压缩前提取的已提交候选标题 */
+    /** 被压缩前提取的已提交候选标题 */
     #compactedSubmits = new Set();
-    /** @type {Object} 日志器 */
+    /** 日志器 */
     #logger;
     /**
      * 模型名 → 上下文窗口大小映射（token 数）。
@@ -87,7 +87,7 @@ export class ContextWindow {
      *   - 微窗口 (<16k):  预算 = 窗口 × 0.7（留 30% 给 prompt/tool schema）
      *
      * @param modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-4o-mini'
-     * @param {{ isSystem?: boolean }} [opts] - isSystem 为 true 时给予更高预算
+     * @param [opts] - isSystem 为 true 时给予更高预算
      * @returns 建议的 token 预算
      */
     static resolveTokenBudget(modelName, opts = {}) {
@@ -420,7 +420,7 @@ export class ContextWindow {
  *
  * @param toolName 工具名
  * @param result 工具原始返回
- * @param {{ maxChars: number, maxMatches: number }} quota 动态配额
+ * @param quota 动态配额
  * @returns 压缩后的结果字符串
  */
 export function limitToolResult(toolName, result, quota) {

package/dist/lib/agent/context/ExplorationTracker.js

@@ -28,13 +28,13 @@ import { PlanTracker } from './exploration/PlanTracker.js';
 import { SEARCH_TOOLS, SignalDetector } from './exploration/SignalDetector.js';
 // ─── ExplorationTracker 主类 ─────────────────────────────
 export class ExplorationTracker {
-    /** @type {object} 策略配置 */
+    /** 策略配置 */
     #strategy;
-    /** @type {object} 预算配置 */
+    /** 预算配置 */
     #budget;
-    /** @type {string} 当前阶段 */
+    /** 当前阶段 */
     #phase;
-    /** @type {object} 日志器 */
+    /** 日志器 */
     #logger;
     // ── 子模块 ──
     #signalDetector;
@@ -54,16 +54,16 @@ export class ExplorationTracker {
         phaseRounds: 0,
     };
     // ── 阶段控制 ──
-    /** @type {boolean} 是否刚完成阶段转换（用于 pending nudge） */
+    /** 是否刚完成阶段转换（用于 pending nudge） */
     #justTransitioned = false;
-    /** @type {string|null} 转换前的旧阶段 */
+    /** 转换前的旧阶段 */
     #transitionFromPhase = null;
     // ── Graceful exit 控制 ──
-    /** @type {number|null} 进入 graceful exit 的轮次 */
+    /** 进入 graceful exit 的轮次 */
     #gracefulExitRound = null;
-    /** @type {boolean} tick 是否已调用（用于 rollback） */
+    /** tick 是否已调用（用于 rollback） */
     #ticked = false;
-    /** @type {string} 提交工具名（用于 nudge 文本生成） */
+    /** 提交工具名（用于 nudge 文本生成） */
     #submitToolName = 'submit_knowledge';
     /** 管线类型标识 — 统一场景判别（替代 submitToolName / strategy.name 字符串比较） */
     #pipelineType;

package/dist/lib/agent/context/exploration/PlanTracker.js

@@ -13,9 +13,9 @@ const DEFAULT_DEVIATION_THRESHOLD = 0.6;
 /** 最少经过 N 轮后才允许再次触发 replan（防止 replan 风暴） */
 const MIN_REPLAN_GAP = 3;
 export class PlanTracker {
-    /** @type {boolean} 等待 AI 输出 replan */
+    /** 等待 AI 输出 replan */
     #pendingReplan = false;
-    /** @type {object} 计划进度 */
+    /** 计划进度 */
     #planProgress = {
         coveredSteps: 0,
         totalSteps: 0,

package/dist/lib/agent/context/exploration/SignalDetector.d.ts

@@ -21,7 +21,7 @@ interface SignalMetrics {
 export declare class SignalDetector {
     #private;
     /**
-     * @param {{ uniqueFiles: Set<string>, uniquePatterns: Set<string>, uniqueQueries: Set<string> }} metrics
+     * @param metrics
      */
     constructor(metrics: SignalMetrics);
     /**

package/dist/lib/agent/context/exploration/SignalDetector.js

@@ -30,7 +30,7 @@ export class SignalDetector {
     /** 共享引用 — 指向 ExplorationTracker 的 metrics 中的三个 Set */
     #metrics;
     /**
-     * @param {{ uniqueFiles: Set<string>, uniquePatterns: Set<string>, uniqueQueries: Set<string> }} metrics
+     * @param metrics
      */
     constructor(metrics) {
         this.#metrics = metrics;

package/dist/lib/agent/core/LoopContext.d.ts

@@ -63,51 +63,51 @@ interface LoopContextConfig {
     toolChoiceOverride?: string | null;
 }
 export declare class LoopContext {
-    /** @type {import('./MessageAdapter.js').MessageAdapter} 统一消息适配器 */
+    /** 统一消息适配器 */
     messages: MessageAdapter;
-    /** @type {Object|null} ExplorationTracker 实例 */
+    /** ExplorationTracker 实例 */
     tracker: ExplorationTracker | null;
-    /** @type {Object|null} ActiveContext 实例 */
+    /** ActiveContext 实例 */
     trace: ActiveContext | null;
-    /** @type {Object|null} MemoryCoordinator 实例 */
+    /** MemoryCoordinator 实例 */
     memoryCoordinator: MemoryCoordinator | null;
-    /** @type {Object|null} 共享状态 */
+    /** 共享状态 */
     sharedState: SharedState | null;
-    /** @type {number} 当前迭代次数 */
+    /** 当前迭代次数 */
     iteration: number;
-    /** @type {string} 最终回复文本 */
+    /** 最终回复文本 */
     lastReply: string;
-    /** @type {Array} 本轮工具调用记录 */
+    /** 本轮工具调用记录 */
     toolCalls: any[];
-    /** @type {{input: number, output: number}} 本轮 token 用量 */
+    /** } 本轮 token 用量 */
     tokenUsage: {
         input: number;
         output: number;
     };
-    /** @type {number} 循环开始时间戳 */
+    /** 循环开始时间戳 */
     loopStartTime: number;
-    /** @type {number} 连续 AI 错误计数 (2-strike 策略) */
+    /** 连续 AI 错误计数 (2-strike 策略) */
     consecutiveAiErrors: number;
-    /** @type {number} 连续空响应计数 */
+    /** 连续空响应计数 */
     consecutiveEmptyResponses: number;
-    /** @type {string} 来源 'user' | 'system' */
+    /** 来源 'user' | 'system' */
     source: string;
-    /** @type {Object} 预算配置 */
+    /** 预算配置 */
     budget: BudgetConfig;
     capabilities: Capability[];
-    /** @type {string} 基础系统提示词 */
+    /** 基础系统提示词 */
     baseSystemPrompt: string;
-    /** @type {Array} 工具 schemas */
+    /** 工具 schemas */
     toolSchemas: Array<Record<string, unknown>>;
-    /** @type {string} 原始用户提示 */
+    /** 原始用户提示 */
     prompt: string;
-    /** @type {Function|null} 工具调用钩子 */
+    /** 工具调用钩子 */
     onToolCall: ToolCallHook | null;
-    /** @type {Object} 额外上下文 */
+    /** 额外上下文 */
     context: Record<string, unknown>;
-    /** @type {import('../context/ContextWindow.js').ContextWindow|null} 原始 ContextWindow 引用 */
+    /** 原始 ContextWindow 引用 */
     contextWindow: ContextWindow | null;
-    /** @type {string|null} 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
+    /** 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
     toolChoiceOverride: string | null;
     constructor(config: LoopContextConfig);
     /** 是否为 system 场景 */

package/dist/lib/agent/core/LoopContext.js

@@ -13,52 +13,52 @@
  */
 export class LoopContext {
     // ─── 注入依赖 ───
-    /** @type {import('./MessageAdapter.js').MessageAdapter} 统一消息适配器 */
+    /** 统一消息适配器 */
     messages;
-    /** @type {Object|null} ExplorationTracker 实例 */
+    /** ExplorationTracker 实例 */
     tracker;
-    /** @type {Object|null} ActiveContext 实例 */
+    /** ActiveContext 实例 */
     trace;
-    /** @type {Object|null} MemoryCoordinator 实例 */
+    /** MemoryCoordinator 实例 */
     memoryCoordinator;
-    /** @type {Object|null} 共享状态 */
+    /** 共享状态 */
     sharedState;
     // ─── 循环状态 ───
-    /** @type {number} 当前迭代次数 */
+    /** 当前迭代次数 */
     iteration = 0;
-    /** @type {string} 最终回复文本 */
+    /** 最终回复文本 */
     lastReply = '';
-    /** @type {Array} 本轮工具调用记录 */
+    /** 本轮工具调用记录 */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any -- tool call entries have varying shapes (ToolCallEntry, ToolCallRecord, etc.) across callers; no common structural type satisfies all consumers
     toolCalls = [];
-    /** @type {{input: number, output: number}} 本轮 token 用量 */
+    /** } 本轮 token 用量 */
     tokenUsage = { input: 0, output: 0 };
-    /** @type {number} 循环开始时间戳 */
+    /** 循环开始时间戳 */
     loopStartTime = 0;
     // ─── 错误恢复 ───
-    /** @type {number} 连续 AI 错误计数 (2-strike 策略) */
+    /** 连续 AI 错误计数 (2-strike 策略) */
     consecutiveAiErrors = 0;
-    /** @type {number} 连续空响应计数 */
+    /** 连续空响应计数 */
     consecutiveEmptyResponses = 0;
     // ─── 配置 (只读) ───
-    /** @type {string} 来源 'user' | 'system' */
+    /** 来源 'user' | 'system' */
     source;
-    /** @type {Object} 预算配置 */
+    /** 预算配置 */
     budget;
     capabilities;
-    /** @type {string} 基础系统提示词 */
+    /** 基础系统提示词 */
     baseSystemPrompt;
-    /** @type {Array} 工具 schemas */
+    /** 工具 schemas */
     toolSchemas;
-    /** @type {string} 原始用户提示 */
+    /** 原始用户提示 */
     prompt;
-    /** @type {Function|null} 工具调用钩子 */
+    /** 工具调用钩子 */
     onToolCall;
-    /** @type {Object} 额外上下文 */
+    /** 额外上下文 */
     context;
-    /** @type {import('../context/ContextWindow.js').ContextWindow|null} 原始 ContextWindow 引用 */
+    /** 原始 ContextWindow 引用 */
     contextWindow;
-    /** @type {string|null} 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
+    /** 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
     toolChoiceOverride;
     constructor(config) {
         this.messages = config.messages;

package/dist/lib/agent/core/SystemPromptBuilder.js

@@ -12,13 +12,13 @@
  * @module SystemPromptBuilder
  */
 export class SystemPromptBuilder {
-    /** @type {Persona|null} persona 配置 */
+    /** persona 配置 */
     #persona;
-    /** @type {FileCacheEntry[]|null} 文件缓存 */
+    /** 文件缓存 */
     #fileCache;
-    /** @type {string|null} 语言偏好 */
+    /** 语言偏好 */
     #lang;
-    /** @type {MemoryConfig|null} 记忆配置 */
+    /** 记忆配置 */
     #memoryConfig;
     constructor({ persona, fileCache, lang, memoryConfig } = {}) {
         this.#persona = persona || null;

package/dist/lib/agent/domain/EvidenceCollector.js

@@ -25,15 +25,15 @@ const MAX_SEARCH_MATCHES = 5;
 const DEFAULT_SNIPPET_BUDGET = 32_000;
 // ── 主类 ──────────────────────────────────────────────────────────
 export class EvidenceCollector {
-    /** @type {Map<string, EvidenceEntry>} 文件 → 证据条目 */
+    /** 文件 → 证据条目 */
     #evidenceMap = new Map();
-    /** @type {ExplorationEntry[]} 探索日志 */
+    /** 探索日志 */
     #explorationLog = [];
-    /** @type {NegativeSignal[]} 负空间信号 */
+    /** 负空间信号 */
     #negativeSignals = [];
-    /** @type {number} 代码片段总字符预算 */
+    /** 代码片段总字符预算 */
     #snippetBudget;
-    /** @type {number} 当前已使用的片段字符数 */
+    /** 当前已使用的片段字符数 */
     #snippetCharsUsed = 0;
     /** @param [options.snippetBudget=32000] 代码片段总字符预算 */
     constructor(options = {}) {

package/dist/lib/agent/memory/ActiveContext.js

@@ -669,7 +669,7 @@ export class ActiveContext {
     // ═══════════════════════════════════════════════════════
     /**
      * 工具结果压缩 — 使用特化策略 (从 WorkingMemory 迁入)
-     * @param {{toolName: string, result: unknown, round: number}} observation
+     * @param observation
      * @returns }
      */
     #compressObservation(observation) {

package/dist/lib/agent/memory/MemoryRetriever.js

@@ -23,7 +23,7 @@ const RECENCY_HALF_LIFE_DAYS = 7;
 const SIMILARITY_UPDATE = 0.85;
 export class MemoryRetriever {
     #store;
-    /** @type {EmbeddingFn|null} 向量嵌入函数 */
+    /** 向量嵌入函数 */
     #embeddingFn;
     /** @param [opts.embeddingFn] 向量嵌入函数 (异步) */
     constructor(store, opts = {}) {

package/dist/lib/agent/memory/MemoryStore.js

@@ -29,9 +29,9 @@ const ARCHIVE_DAYS = 30;
 const FORGET_DAYS = 90;
 export class MemoryStore {
     #db;
-    /** @type {object} 预编译 SQL Statements */
+    /** 预编译 SQL Statements */
     #stmts = null;
-    /** @type {Map<string, SqliteStatement>} 动态 update SQL 缓存 */
+    /** 动态 update SQL 缓存 */
     #updateStmtCache = new Map();
     /** @param db better-sqlite3 实例 (raw) */
     constructor(db) {

package/dist/lib/agent/memory/SessionStore.js

@@ -43,17 +43,17 @@ const DEFAULT_TTL_MS = CACHE.DEFAULT_TTL_MS;
 export class SessionStore {
     // ── 子系统 1: DimensionReports (from EpisodicMemory) ──
     #dimensionReports = new Map();
-    /** @type {Map<string, Finding[]>} filePath → Evidence[] */
+    /** filePath → Evidence[] */
     #evidenceStore = new Map();
     #crossReferences = [];
     #tierReflections = [];
-    /** @type {Map<string, CandidateSummary[]>} dimId → candidates */
+    /** dimId → candidates */
     #submittedCandidates = new Map();
     #projectContext;
     // ── 子系统 2: ReadOnlyCache (from ToolResultCache) ──
     #searchCache = new Map();
     #fileCache = new Map();
-    /** @type {{hits: number, misses: number, evictions: number}} */
+    /** } */
     #cacheStats = { hits: 0, misses: 0, evictions: 0 };
     #ttlMs;
     #cleanupTimer = null;

package/dist/lib/agent/policies.d.ts

@@ -55,7 +55,7 @@ export interface QualityGatePolicyOptions {
 }
 /** Policy 基类 — 所有约束的抽象接口 */
 export declare class Policy {
-    /** @type {string} 策略名称 */
+    /** 策略名称 */
     get name(): string;
     /** 执行前校验 — 拒绝不满足条件的请求 */
     validateBefore(_context: PolicyContext): {

package/dist/lib/agent/policies.js

@@ -19,7 +19,7 @@ import _path from 'node:path';
 // ─── Base Policy ──────────────────────────────
 /** Policy 基类 — 所有约束的抽象接口 */
 export class Policy {
-    /** @type {string} 策略名称 */
+    /** 策略名称 */
     get name() {
         throw new Error('Subclass must implement name');
     }

package/dist/lib/agent/strategies.d.ts

@@ -140,7 +140,7 @@ export declare class FanOutStrategy extends Strategy {
     constructor({ itemStrategy, tiers, merge }?: FanOutOpts);
     get name(): string;
     /**
-     * @param {Array<{id: string, label: string, tier?: number, prompt?: string, guide?: string}>} opts.items 子任务列表
+     * @param opts.items 子任务列表
      */
     execute(runtime: StrategyRuntime, message: AgentMessage, opts?: FanOutExecuteOpts): Promise<StrategyResult>;
 }

package/dist/lib/agent/strategies.js

@@ -86,11 +86,11 @@ export class SingleStrategy extends Strategy {
  * })
  */
 export class FanOutStrategy extends Strategy {
-    /** @type {Strategy} 每个子任务的执行策略 */
+    /** 每个子任务的执行策略 */
     #itemStrategy;
-    /** @type {Record<string, { concurrency: number }>} 分层并发配置 */
+    /** >} 分层并发配置 */
     #tiers;
-    /** @type {(results: ItemResult[]) => StrategyResult} 结果合并函数 */
+    /** 结果合并函数 */
     #merge;
     /**
      * @param opts.itemStrategy 每个子任务使用的策略
@@ -107,7 +107,7 @@ export class FanOutStrategy extends Strategy {
         return 'fan_out';
     }
     /**
-     * @param {Array<{id: string, label: string, tier?: number, prompt?: string, guide?: string}>} opts.items 子任务列表
+     * @param opts.items 子任务列表
      */
     async execute(runtime, message, opts = {}) {
         const { items = [] } = opts;

package/dist/lib/agent/tools/_shared.d.ts

@@ -18,7 +18,7 @@ export declare const DIMENSION_DISPLAY_GROUP: {
 };
 /**
  * 基于维度元数据 (dimensionMeta) 检查提交是否合法
- * @param {{ id: string, outputType: 'candidate'|'skill'|'dual', allowedKnowledgeTypes: string[] }} dimensionMeta
+ * @param dimensionMeta
  * @param params submit_knowledge 的参数
  * @returns | null} 不合法返回 rejected，合法返回 null
  */

package/dist/lib/agent/tools/_shared.js

@@ -20,7 +20,7 @@ export const DIMENSION_DISPLAY_GROUP = {
 };
 /**
  * 基于维度元数据 (dimensionMeta) 检查提交是否合法
- * @param {{ id: string, outputType: 'candidate'|'skill'|'dual', allowedKnowledgeTypes: string[] }} dimensionMeta
+ * @param dimensionMeta
  * @param params submit_knowledge 的参数
  * @returns | null} 不合法返回 rejected，合法返回 null
  */

package/dist/lib/agent/tools/infrastructure.js

@@ -85,13 +85,13 @@ export const queryAuditLog = {
 // ────────────────────────────────────────────────────────────
 export const loadSkill = {
     name: 'load_skill',
-    description: '加载指定的 Agent Skill 文档，获取领域操作指南和最佳实践参考。可用于冷启动指南 (autosnippet-coldstart)、候选管理 (autosnippet-candidates)、规范审计 (autosnippet-guard) 等。',
+    description: '加载指定的 Agent Skill 文档，获取领域操作指南和最佳实践参考。如知识提交 (autosnippet-create)、规范审计 (autosnippet-guard)、项目标准 (autosnippet-recipes) 等。',
     parameters: {
         type: 'object',
         properties: {
             skillName: {
                 type: 'string',
-                description: 'Skill 目录名（如 autosnippet-coldstart, autosnippet-candidates, autosnippet-guard 等）',
+                description: 'Skill 目录名（如 autosnippet-create, autosnippet-guard, autosnippet-recipes 等）',
             },
         },
         required: ['skillName'],

package/dist/lib/cli/SetupService.d.ts

@@ -67,7 +67,7 @@ export declare class SetupService {
     /** 子仓库远程仓库 URL（为空则 recipes/ 作为普通目录随主仓库提交） */
     subRepoUrl: string | undefined;
     /**
-     * @param {{ projectRoot: string, force?: boolean, seed?: boolean, subRepoDir?: string, subRepoUrl?: string }} options
+     * @param options
      */
     constructor(options: {
         projectRoot: string;
@@ -106,8 +106,8 @@ export declare class SetupService {
         ok: boolean;
         error?: string;
     }[]>;
-    /** @private 格式化步骤结果的简要信息 */
-    _formatStepDetail(r: Record<string, unknown> | undefined): string;
+    /** 格式化步骤结果的简要信息 */
+    private _formatStepDetail;
     printSummary(): void;
     stepRuntime(): {
         created: string;
@@ -118,16 +118,16 @@ export declare class SetupService {
         subRepoPath: string;
         hasUrl: boolean;
     };
-    /** @private 写入 constitution.yaml（优先从模板复制） */
-    _writeConstitution(): void;
-    /** @private 写入 boxspec.json */
-    _writeBoxspec(): void;
-    /** @private 复制 _template.md 到 recipes/ */
-    _copyRecipeTemplate(): void;
-    /** @private 复制示例 Recipe（冷启动推荐） */
-    _copySeedRecipes(): void;
-    /** @private 写入核心目录 README */
-    _writeCoreReadme(): void;
+    /** 写入 constitution.yaml（优先从模板复制） */
+    private _writeConstitution;
+    /** 写入 boxspec.json */
+    private _writeBoxspec;
+    /** 复制 _template.md 到 recipes/ */
+    private _copyRecipeTemplate;
+    /** 复制示例 Recipe（冷启动推荐） */
+    private _copySeedRecipes;
+    /** 写入核心目录 README */
+    private _writeCoreReadme;
     stepIDE(): {
         configured: string[];
     };
@@ -135,27 +135,27 @@ export declare class SetupService {
         dbPath: string;
     }>;
     /**
-     * @private 从 AutoSnippet/recipes/*.md + candidates/*.md 同步到 DB 缓存
+     * 从 AutoSnippet/recipes/*.md + candidates/*.md 同步到 DB 缓存
      * 委托 KnowledgeSyncService 执行全字段同步（setup 场景跳过违规记录）
      */
-    _syncRecipesToDB(db: unknown): Promise<void>;
+    private _syncRecipesToDB;
     stepPlatform(): Promise<any>;
     /**
-     * @private 在项目根目录创建 .env 文件（从 .env.example 复制）
+     * 在项目根目录创建 .env 文件（从 .env.example 复制）
      * 如果 .env 已存在则跳过并提示用户手动配置。
      */
-    _ensureEnvFile(): void;
-    /** @private 在指定目录执行 git 命令 */
-    _git(args: string[], cwd: string): string;
-    /** @private 检查目录中是否有文件（排除 . 和 ..） */
-    _hasFiles(dirPath: string): boolean;
-    /** @private 确保子仓库的 remote origin 与给定 URL 一致 */
-    _ensureRemote(url: string): void;
+    private _ensureEnvFile;
+    /** 在指定目录执行 git 命令 */
+    private _git;
+    /** 检查目录中是否有文件（排除 . 和 ..） */
+    private _hasFiles;
+    /** 确保子仓库的 remote origin 与给定 URL 一致 */
+    private _ensureRemote;
     /**
-     * @private 备份已有文件 → clone → 合并回来（不覆盖远端文件）
+     * 备份已有文件 → clone → 合并回来（不覆盖远端文件）
      * 适用于 recipes/ 有模板文件但还不是 git 仓库的场景
      */
-    _cloneWithMerge(url: string): void;
+    private _cloneWithMerge;
     /**
      * 尝试初始化向量索引: 检查 embedding provider 可用性，
      * 若可用则自动构建初始索引；否则提示用户手动运行 asd embed。