autosnippet 3.3.8 → 3.4.0

package/dist/lib/domain/dimension/DimensionRegistry.js

@@ -145,7 +145,7 @@ const D7_NETWORKING_API = {
     weight: 0.7,
     suggestedTopics: ['api-contract', 'retry-strategy', 'request-pattern'],
     relatedRoles: ['networking'],
-    tierHint: 3,
+    tierHint: 2,
     displayGroup: 'data-event-flow',
 };
 const D8_UI_INTERACTION = {
@@ -163,7 +163,7 @@ const D8_UI_INTERACTION = {
     weight: 0.7,
     suggestedTopics: ['component-pattern', 'lifecycle', 'navigation'],
     relatedRoles: ['ui', 'feature'],
-    tierHint: 3,
+    tierHint: 4,
     displayGroup: 'architecture',
 };
 const D9_TESTING_QUALITY = {
@@ -181,7 +181,7 @@ const D9_TESTING_QUALITY = {
     weight: 0.9,
     suggestedTopics: ['unit-test', 'mock-strategy', 'ci-cd'],
     relatedRoles: [],
-    tierHint: 3,
+    tierHint: 4,
     displayGroup: 'best-practice',
 };
 const D10_SECURITY_AUTH = {
@@ -199,7 +199,7 @@ const D10_SECURITY_AUTH = {
     weight: 1.0,
     suggestedTopics: ['authentication', 'authorization', 'encryption'],
     relatedRoles: ['networking', 'service'],
-    tierHint: 3,
+    tierHint: 4,
     displayGroup: 'best-practice',
 };
 const D11_PERFORMANCE_OPTIMIZATION = {
@@ -217,7 +217,7 @@ const D11_PERFORMANCE_OPTIMIZATION = {
     weight: 0.8,
     suggestedTopics: ['memory-management', 'lazy-loading', 'rendering'],
     relatedRoles: ['ui', 'storage'],
-    tierHint: 3,
+    tierHint: 5,
     displayGroup: 'data-event-flow',
 };
 const D12_OBSERVABILITY_LOGGING = {
@@ -235,7 +235,7 @@ const D12_OBSERVABILITY_LOGGING = {
     weight: 0.7,
     suggestedTopics: ['logging-standard', 'event-tracking', 'diagnostics'],
     relatedRoles: ['service', 'core'],
-    tierHint: 3,
+    tierHint: 5,
     displayGroup: 'data-event-flow',
 };
 const D13_AGENT_GUIDELINES = {
@@ -253,7 +253,7 @@ const D13_AGENT_GUIDELINES = {
     weight: 0.6,
     suggestedTopics: ['constraints', 'deprecated-api', 'agent-rules'],
     relatedRoles: [],
-    tierHint: 3,
+    tierHint: 5,
     displayGroup: 'best-practice',
 };
 // ═══════════════════════════════════════════════════════════
@@ -569,28 +569,24 @@ export function resolveActiveDimensions(primaryLang, detectedFrameworks = []) {
 /**
  * 构建 Tier 分层调度计划
  *
- * 基于每个维度的 tierHint 字段将活跃维度分为 3 层:
- * - Tier 1 (tierHint=1): 基础数据层 — architecture + 语言/框架条件维度
- * - Tier 2 (tierHint=2): 规范+设计层 — coding-standards, design-patterns
- * - Tier 3 (tierHint=3): 实践+质量层 — 其余所有维度
+ * 基于每个维度的 tierHint 字段动态分为 N 层 (不再硬编码 3 层):
+ * - tierHint=1: 基础数据层 — architecture + 语言/框架条件维度
+ * - tierHint=2: 规范+设计层 — coding-standards, design-patterns 等
+ * - tierHint=3+: 实践+质量层 — 按声明值自动分桶
+ *
+ * 未声明 tierHint 的维度默认归入最后一层 (tierHint=max 或 3)。
  */
 export function buildTierPlan(activeDims = DIMENSION_REGISTRY) {
-    const tier1 = [];
-    const tier2 = [];
-    const tier3 = [];
+    const tierMap = new Map();
     for (const dim of activeDims) {
         const hint = dim.tierHint ?? 3;
-        if (hint === 1) {
-            tier1.push(dim.id);
-        }
-        else if (hint === 2) {
-            tier2.push(dim.id);
-        }
-        else {
-            tier3.push(dim.id);
+        if (!tierMap.has(hint)) {
+            tierMap.set(hint, []);
         }
+        tierMap.get(hint).push(dim.id);
     }
-    return [tier1, tier2, tier3].filter((t) => t.length > 0);
+    // 按 tier 编号升序排列，过滤空层
+    return [...tierMap.entries()].sort(([a], [b]) => a - b).map(([, dims]) => dims);
 }
 /**
  * 将 Recipe 分类到最匹配的维度

package/dist/lib/external/ai/AiProvider.d.ts

@@ -57,6 +57,8 @@ export interface ChatWithToolsOptions {
     systemPrompt?: string;
     temperature?: number;
     maxTokens?: number;
+    /** 外部中止信号 — hard timeout 时取消进行中的 LLM 请求 */
+    abortSignal?: AbortSignal;
 }
 /** 函数调用结果 */
 export interface FunctionCallResult {

package/dist/lib/external/ai/AiProvider.js

@@ -684,6 +684,10 @@ ${items}`;
             }
             catch (err) {
                 const e = err;
+                // AbortError — 外部主动中止（如 PipelineStrategy hard timeout），不重试直接抛出
+                if (e.name === 'AbortError' || e.cause?.name === 'AbortError') {
+                    throw e;
+                }
                 // ── 综合判断是否为可重试的网络/服务端错误 ──
                 const causeCode = e.cause?.code || '';
                 // 网络级错误：无 HTTP status，底层连接失败

package/dist/lib/external/ai/providers/ClaudeProvider.d.ts

@@ -32,6 +32,6 @@ export declare class ClaudeProvider extends AiProvider {
     summarize(code: string): Promise<{}>;
     embed(_text: string | string[]): Promise<never[]>;
     supportsEmbedding(): boolean;
-    _post(url: string, body: Record<string, unknown>): Promise<ApiResponse>;
+    _post(url: string, body: Record<string, unknown>, externalSignal?: AbortSignal): Promise<ApiResponse>;
 }
 export default ClaudeProvider;

package/dist/lib/external/ai/providers/ClaudeProvider.js

@@ -100,7 +100,7 @@ export class ClaudeProvider extends AiProvider {
                 body.tool_choice = { type: 'auto' };
             }
         }
-        const data = await this._post(`${CLAUDE_BASE}/messages`, body);
+        const data = await this._post(`${CLAUDE_BASE}/messages`, body, opts.abortSignal);
         return this.#parseToolResponse(data);
     }
     // ─── 内部转换方法 ──────────────────────
@@ -241,7 +241,7 @@ export class ClaudeProvider extends AiProvider {
     supportsEmbedding() {
         return false;
     }
-    async _post(url, body) {
+    async _post(url, body, externalSignal) {
         if (!this.apiKey) {
             const err = new Error('Claude API Key 未配置。请在 .env 中设置 ASD_CLAUDE_API_KEY，或运行 asd setup 完成配置。');
             err.code = 'API_KEY_MISSING';
@@ -249,6 +249,9 @@ export class ClaudeProvider extends AiProvider {
         }
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeout);
+        // 外部中止信号 → 联动本地 controller
+        const onExternalAbort = () => controller.abort();
+        externalSignal?.addEventListener('abort', onExternalAbort, { once: true });
         try {
             const res = await this._fetch(url, {
                 method: 'POST',
@@ -269,6 +272,7 @@ export class ClaudeProvider extends AiProvider {
         }
         finally {
             clearTimeout(timer);
+            externalSignal?.removeEventListener('abort', onExternalAbort);
         }
     }
 }

package/dist/lib/external/ai/providers/GoogleGeminiProvider.d.ts

@@ -34,6 +34,6 @@ export declare class GoogleGeminiProvider extends AiProvider {
      */
     chatWithStructuredOutput(prompt: string, opts?: StructuredOutputOptions): Promise<any>;
     embed(text: string | string[]): Promise<number[] | number[][]>;
-    _post(url: string, body: Record<string, unknown>): Promise<ApiResponse>;
+    _post(url: string, body: Record<string, unknown>, externalSignal?: AbortSignal): Promise<ApiResponse>;
 }
 export default GoogleGeminiProvider;

package/dist/lib/external/ai/providers/GoogleGeminiProvider.js

@@ -108,7 +108,7 @@ export class GoogleGeminiProvider extends AiProvider {
                 body.systemInstruction = { parts: [{ text: systemPrompt }] };
             }
             const url = `${GEMINI_BASE}/models/${this.model}:generateContent?key=${this.apiKey}`;
-            const data = await this._post(url, body);
+            const data = await this._post(url, body, opts.abortSignal);
             return this.#parseToolResponse(data);
         });
     }
@@ -356,7 +356,7 @@ export class GoogleGeminiProvider extends AiProvider {
         }
         return Array.isArray(text) ? results : results[0] || [];
     }
-    async _post(url, body) {
+    async _post(url, body, externalSignal) {
         if (!this.apiKey) {
             const err = new Error('Google Gemini API Key 未配置。请在 .env 中设置 ASD_GOOGLE_API_KEY，或运行 asd setup 完成配置。');
             err.code = 'API_KEY_MISSING';
@@ -364,6 +364,9 @@ export class GoogleGeminiProvider extends AiProvider {
         }
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeout);
+        // 外部中止信号 → 联动本地 controller
+        const onExternalAbort = () => controller.abort();
+        externalSignal?.addEventListener('abort', onExternalAbort, { once: true });
         try {
             const res = await this._fetch(url, {
                 method: 'POST',
@@ -401,6 +404,7 @@ export class GoogleGeminiProvider extends AiProvider {
         }
         finally {
             clearTimeout(timer);
+            externalSignal?.removeEventListener('abort', onExternalAbort);
         }
     }
 }

package/dist/lib/external/ai/providers/OpenAiProvider.d.ts

@@ -37,6 +37,6 @@ export declare class OpenAiProvider extends AiProvider {
      */
     chatWithStructuredOutput(prompt: string, opts?: StructuredOutputOptions): Promise<any>;
     embed(text: string | string[]): Promise<any>;
-    _post(url: string, body: Record<string, unknown>): Promise<ApiResponse>;
+    _post(url: string, body: Record<string, unknown>, externalSignal?: AbortSignal): Promise<ApiResponse>;
 }
 export default OpenAiProvider;

package/dist/lib/external/ai/providers/OpenAiProvider.js

@@ -14,7 +14,7 @@ export class OpenAiProvider extends AiProvider {
     constructor(config = {}) {
         super(config);
         this.name = config.name || 'openai';
-        this.model = config.model || 'gpt-4o-mini';
+        this.model = config.model || 'gpt-5.4-mini';
         this.apiKey = config.apiKey || process.env.ASD_OPENAI_API_KEY || '';
         this.baseUrl = config.baseUrl || OPENAI_BASE;
         this.embedModel = config.embedModel || 'text-embedding-3-small';
@@ -129,7 +129,7 @@ export class OpenAiProvider extends AiProvider {
             else {
                 body.tool_choice = 'auto';
             }
-            const data = await this._post(`${this.baseUrl}/chat/completions`, body);
+            const data = await this._post(`${this.baseUrl}/chat/completions`, body, opts.abortSignal);
             return this.#parseToolResponse(data);
         });
     }
@@ -251,7 +251,7 @@ export class OpenAiProvider extends AiProvider {
             return Array.isArray(text) ? texts.map(() => []) : [];
         }
     }
-    async _post(url, body) {
+    async _post(url, body, externalSignal) {
         // Ollama 使用固定 dummy key，不需要校验
         if (!this.apiKey && this.name !== 'ollama') {
             const envKey = this.name === 'deepseek' ? 'ASD_DEEPSEEK_API_KEY' : 'ASD_OPENAI_API_KEY';
@@ -261,6 +261,9 @@ export class OpenAiProvider extends AiProvider {
         }
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeout);
+        // 外部中止信号 → 联动本地 controller
+        const onExternalAbort = () => controller.abort();
+        externalSignal?.addEventListener('abort', onExternalAbort, { once: true });
         try {
             const res = await this._fetch(url, {
                 method: 'POST',
@@ -280,6 +283,7 @@ export class OpenAiProvider extends AiProvider {
         }
         finally {
             clearTimeout(timer);
+            externalSignal?.removeEventListener('abort', onExternalAbort);
         }
     }
 }

package/dist/lib/external/mcp/McpServer.js

@@ -83,8 +83,25 @@ export class McpServer {
     async initialize() {
         if (!this.container) {
             const { default: Bootstrap } = await import('../../bootstrap.js');
-            // 路径安全守卫 — 在任何写操作前配置
-            const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+            // MCP 模式必须显式指定项目目录 — process.cwd() 在多根工作区中不可靠
+            const projectRoot = process.env.ASD_PROJECT_DIR;
+            if (!projectRoot) {
+                const msg = `[MCP] 缺少 ASD_PROJECT_DIR 环境变量。MCP server 拒绝启动。\n` +
+                    `在多根工作区中 process.cwd() 可能指向任意子目录，不能作为项目根目录。\n` +
+                    `请在 .vscode/mcp.json 的 env 中设置 ASD_PROJECT_DIR 为目标项目的绝对路径。`;
+                process.stderr.write(`${msg}\n`);
+                throw new Error(msg);
+            }
+            // ── 排除项目检查 — 防止误配置 ASD_PROJECT_DIR 到不该创建运行时数据的目录 ──
+            const { isExcludedProject } = await import('../../shared/isOwnDevRepo.js');
+            const exclusion = isExcludedProject(projectRoot);
+            if (exclusion.excluded) {
+                const msg = `[MCP] projectRoot "${projectRoot}" 是排除项目（${exclusion.reason}），` +
+                    `MCP server 拒绝在此目录创建运行时数据。\n` +
+                    `提示: 在 .vscode/mcp.json 的 env 中设置正确的 ASD_PROJECT_DIR。`;
+                process.stderr.write(`${msg}\n`);
+                throw new Error(msg);
+            }
             // 切换工作目录到项目根 — 确保 DB 等相对路径正确解析
             if (projectRoot !== process.cwd()) {
                 process.chdir(projectRoot);

package/dist/lib/external/mcp/handlers/bootstrap/MissionBriefingBuilder.js

@@ -760,11 +760,19 @@ function buildExecutionPlan(activeDimensions) {
     const scheduler = new TierScheduler();
     const tiers = scheduler.getTiers();
     const activeDimIds = new Set(activeDimensions.map((d) => d.id));
-    const tierLabels = ['基础数据层', '规范 + 架构 + 模式', '流转 + 实践 + 总结'];
+    const tierLabels = [
+        '基础数据层',
+        '规范 + 设计 + 网络',
+        '核心质量',
+        '领域专项',
+        '终端优化 + 总结',
+    ];
     const tierNotes = [
         '这些维度相互独立，可以任意顺序分析。产出的上下文将帮助后续维度。',
         '建议利用 Tier 1 中了解到的项目结构和代码特征。',
-        'agent-guidelines 应在最后分析 — 综合前序所有维度的发现。',
+        '利用前两层建立的架构和规范上下文深入分析。',
+        '各维度相对独立，可充分利用并行能力。',
+        'agent-guidelines 应综合前序所有维度的发现。',
     ];
     const plan = tiers
         .map((tierDimIds, index) => {

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/mock-pipeline.js

@@ -374,8 +374,7 @@ export async function fillDimensionsMock(view, dimensions) {
         message: '🧪 Mock AI 模式 — 基于代码结构自动生成知识候选（非 AI 深度分析）',
         mockMode: true,
     });
-    const knowledgeService = ctx.container.get('knowledgeService');
-    let totalCreated = 0;
+    let totalGenerated = 0;
     for (const dim of dimensions) {
         const dimStartTime = Date.now();
         const dimLabel = dim.label ?? dim.id;
@@ -385,48 +384,30 @@ export async function fillDimensionsMock(view, dimensions) {
             mockMode: true,
         });
         logger.info(`[MockPipeline] ── Dimension "${dim.id}" (${dimLabel}) ──`);
-        // 生成候选
+        // 生成候选（仅在内存中，不写入数据库）
         const candidates = generateDimensionCandidates(dim.id, dimLabel, allFiles, primaryLang, projectName, astStats, repFiles);
-        const createdIds = [];
+        totalGenerated += candidates.length;
         for (const candidate of candidates) {
-            try {
-                const entry = await knowledgeService.create({
-                    ...candidate,
-                    source: 'mock-bootstrap',
-                }, { userId: 'mock-ai' });
-                createdIds.push(entry.id);
-                totalCreated++;
-                // 尝试自动评分（非关键路径）
-                try {
-                    await knowledgeService.updateQuality?.(entry.id, { userId: 'mock-ai' });
-                }
-                catch {
-                    /* best effort */
-                }
-                logger.info(`[MockPipeline] ✅ Created: "${candidate.title}" → ${entry.id}`);
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                logger.warn(`[MockPipeline] ⚠️ Failed to create "${candidate.title}": ${msg}`);
-            }
+            logger.info(`[MockPipeline] 📝 Generated (not persisted): "${candidate.title}"`);
         }
         const durationMs = Date.now() - dimStartTime;
         emitter.emitDimensionComplete(dim.id, {
             type: 'candidate',
             extracted: candidates.length,
-            created: createdIds.length,
+            created: 0,
             status: 'mock-pipeline-complete',
             degraded: false,
             durationMs,
             toolCallCount: 0,
             source: 'mock-pipeline',
         });
-        logger.info(`[MockPipeline] ✅ "${dim.id}": ${createdIds.length}/${candidates.length} candidates, ${durationMs}ms`);
+        logger.info(`[MockPipeline] ✅ "${dim.id}": ${candidates.length} candidates generated (mock-only, not persisted), ${durationMs}ms`);
     }
     emitter.emitProgress('bootstrap:mock-complete', {
-        message: `🧪 Mock Bootstrap 完成: ${totalCreated} 个候选知识已生成`,
-        totalCreated,
+        message: `🧪 Mock Bootstrap 完成: ${totalGenerated} 个候选知识已生成（仅预览，未写入数据库）`,
+        totalCreated: 0,
+        totalGenerated,
         mockMode: true,
     });
-    logger.info(`[MockPipeline] ═══ Mock bootstrap complete — ${totalCreated} candidates from ${dimensions.length} dimensions`);
+    logger.info(`[MockPipeline] ═══ Mock bootstrap complete — ${totalGenerated} candidates generated (not persisted) from ${dimensions.length} dimensions`);
 }

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/orchestrator.js

@@ -18,7 +18,7 @@ import path from 'node:path';
 import { AgentMessage } from '#agent/AgentMessage.js';
 import { ExplorationTracker } from '#agent/context/ExplorationTracker.js';
 import { EpisodicConsolidator } from '#agent/domain/EpisodicConsolidator.js';
-import { ANALYST_BUDGET } from '#agent/domain/insight-analyst.js';
+import { computeAnalystBudget } from '#agent/domain/insight-analyst.js';
 import { MemoryCoordinator } from '#agent/memory/MemoryCoordinator.js';
 import { MemoryEmbeddingStore } from '#agent/memory/MemoryEmbeddingStore.js';
 import { PersistentMemory } from '#agent/memory/PersistentMemory.js';
@@ -600,9 +600,9 @@ export async function fillDimensionsV3(view, dimensions) {
                 // ── 引擎增强参数 (PipelineStrategy → reactLoop 透传) ──
                 contextWindow: agentFactory?.createContextWindow({ isSystem: true }),
                 // B1 fix: 分析阶段使用 analyst 策略 (SCAN→EXPLORE→VERIFY→SUMMARIZE)
-                // 而非 bootstrap (EXPLORE→PRODUCE→SUMMARIZE)，避免 PRODUCE nudge 浪费轮次
-                // B3 fix: 透传完整 ANALYST_BUDGET (searchBudget/maxSubmits/softSubmitLimit/idleRoundsToExit)
-                tracker: ExplorationTracker.resolve({ source: 'system', strategy: 'analyst' }, { ...ANALYST_BUDGET }),
+                // B3 fix: 透传完整 ANALYST_BUDGET
+                // B4 fix: 自适应预算 — 根据项目文件数缩放 maxIterations (24~40)
+                tracker: ExplorationTracker.resolve({ source: 'system', strategy: 'analyst' }, computeAnalystBudget(projectInfo.fileCount || 0)),
                 trace: memoryCoordinator.getActiveContext(analystScopeId),
                 memoryCoordinator,
                 sharedState: {
@@ -826,6 +826,7 @@ export async function fillDimensionsV3(view, dimensions) {
                 source: 'enhanced-pipeline-strategy',
             });
             const dimTokenUsage = combinedTokenUsage;
+            const qualityScores = artifact.qualityReport;
             const dimResult = {
                 candidateCount: producerResult.candidateCount,
                 rejectedCount: producerResult.rejectedCount || 0,
@@ -836,6 +837,13 @@ export async function fillDimensionsV3(view, dimensions) {
                 tokenUsage: dimTokenUsage,
                 analysisText: analysisReport.analysisText,
                 referencedFilesList: analysisReport.referencedFiles || [],
+                qualityGate: qualityScores
+                    ? {
+                        totalScore: qualityScores.totalScore,
+                        scores: qualityScores.scores,
+                        action: gateResult?.action || (runResult?.degraded ? 'degrade' : 'pass'),
+                    }
+                    : null,
             };
             dimensionStats[dimId] = dimResult;
             // P3: 保存 checkpoint — 仅当有实质分析内容时（避免 degraded/空结果污染后续 run）
@@ -1061,6 +1069,30 @@ export async function fillDimensionsV3(view, dimensions) {
                 `~${consolidationResult.total.updated} UPDATE, ` +
                 `⊕${consolidationResult.total.merged} MERGE | ` +
                 `Total: ${smStats.total} memories (avg importance: ${smStats.avgImportance})`);
+            // 按类型和来源分布
+            logger.info(`[Insight-v3] Memory by type: ${Object.entries(smStats.byType)
+                .map(([t, n]) => `${t}=${n}`)
+                .join(', ')} | ` +
+                `by source: ${Object.entries(smStats.bySource)
+                    .map(([s, n]) => `${s}=${n}`)
+                    .join(', ')}`);
+            // 蒸馏管线详情 (来自 EpisodicConsolidator 增强返回值)
+            const cr = consolidationResult;
+            if (cr.perDimension) {
+                const perDim = cr.perDimension;
+                const topDims = Object.entries(perDim)
+                    .sort(([, a], [, b]) => b - a)
+                    .slice(0, 6);
+                logger.info(`[Insight-v3] Memory per-dimension (top ${topDims.length}): ${topDims.map(([d, n]) => `${d}=${n}`).join(', ')}`);
+            }
+            if (cr.importanceDistribution) {
+                const hist = cr.importanceDistribution;
+                const histStr = Object.entries(hist)
+                    .sort(([a], [b]) => Number(a) - Number(b))
+                    .map(([k, v]) => `imp${k}=${v}`)
+                    .join(' ');
+                logger.info(`[Insight-v3] Importance histogram: ${histStr}`);
+            }
         }
         else {
             logger.warn('[Insight-v3] Database not available — skipping Semantic Memory consolidation');
@@ -1163,6 +1195,7 @@ export async function fillDimensionsV3(view, dimensions) {
                 durationMs: stat.durationMs || 0,
                 toolCallCount: stat.toolCallCount || 0,
                 tokenUsage: stat.tokenUsage || { input: 0, output: 0 },
+                qualityGate: stat.qualityGate || null,
             };
         }
         // Phase E: 附加 Code Entity Graph 拓扑到报告

package/dist/lib/http/routes/ai.js

@@ -70,9 +70,9 @@ router.get('/providers', async (req, res) => {
     };
     const providers = [
         { id: 'google', label: 'Google Gemini', defaultModel: 'gemini-3-flash-preview' },
-        { id: 'openai', label: 'OpenAI', defaultModel: 'gpt-4o' },
+        { id: 'openai', label: 'OpenAI', defaultModel: 'gpt-5.4' },
         { id: 'deepseek', label: 'DeepSeek', defaultModel: 'deepseek-chat' },
-        { id: 'claude', label: 'Claude', defaultModel: 'claude-3-5-sonnet-20240620' },
+        { id: 'claude', label: 'Claude', defaultModel: 'claude-sonnet-4-20250514' },
         { id: 'ollama', label: 'Ollama', defaultModel: 'llama3' },
         { id: 'mock', label: 'Mock (测试)', defaultModel: 'mock-l3' },
     ].map((p) => ({

package/dist/lib/infrastructure/database/DatabaseConnection.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import Database from 'better-sqlite3';
-import { isAutoSnippetDevRepo } from '../../shared/isOwnDevRepo.js';
+import { isExcludedProject } from '../../shared/isOwnDevRepo.js';
 import pathGuard from '../../shared/PathGuard.js';
 import { initDrizzle } from './drizzle/index.js';
 const __dirname = import.meta.dirname;
@@ -30,17 +30,18 @@ export class DatabaseConnection {
         let resolvedDbPath = projectRoot && !path.isAbsolute(dbPath)
             ? path.resolve(projectRoot, dbPath)
             : path.resolve(dbPath);
-        // ── 开发仓库保护 ──────────────────────────────────────────
-        // 检测 DB 即将落地到 AutoSnippet 源码仓库内 → 重定向到临时目录
-        // 同时检查 projectRoot（MCP 模式）和 resolvedDbPath 的父目录（测试/CLI 模式）
+        // ── 排除项目保护 ──────────────────────────────────────────
+        // 检测 DB 即将落地到不适合创建知识库的项目 → 重定向到临时目录
+        // 包括：AutoSnippet 源码仓库、生态项目（autosnippet-book 等）、.autosnippet-skip 标记项目
         const effectiveRoot = projectRoot || path.resolve('.');
-        if (isAutoSnippetDevRepo(effectiveRoot)) {
+        const exclusion = isExcludedProject(effectiveRoot);
+        if (exclusion.excluded) {
             const devDbDir = path.join(os.tmpdir(), 'autosnippet-dev');
             if (!fs.existsSync(devDbDir)) {
                 fs.mkdirSync(devDbDir, { recursive: true });
             }
             resolvedDbPath = path.join(devDbDir, 'autosnippet.db');
-            process.stderr.write(`[AutoSnippet] Dev repo detected — DB redirected to ${resolvedDbPath}\n`);
+            process.stderr.write(`[AutoSnippet] Excluded project detected (${exclusion.reason}) — DB redirected to ${resolvedDbPath}\n`);
         }
         else {
             // 路径安全检查 — 防止 DB 文件创建到项目允许范围外

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

@@ -170,7 +170,21 @@ export class CursorDeliveryPipeline {
         catch (e) {
             this.logger.warn?.(`[CursorDelivery] Failed to load pending entries: ${e.message}`);
         }
-        return allEntries;
+        // 过滤掉历史遗留的 mock 条目（source=mock-bootstrap/mock-pipeline 或 createdBy=mock-ai）
+        const MOCK_SOURCES = new Set(['mock-bootstrap', 'mock-pipeline']);
+        const filtered = allEntries.filter((e) => {
+            if (MOCK_SOURCES.has(e.source)) {
+                return false;
+            }
+            if (e.createdBy === 'mock-ai') {
+                return false;
+            }
+            return true;
+        });
+        if (filtered.length < allEntries.length) {
+            this.logger.info?.(`[CursorDelivery] Filtered out ${allEntries.length - filtered.length} mock entries`);
+        }
+        return filtered;
     }
     /**
      * 从 KnowledgeService.list() 返回值提取条目数组

package/dist/lib/shared/PathGuard.js

@@ -26,7 +26,7 @@
  *  - 错误不静默：越界写操作抛出 PathGuardError
  */
 import path from 'node:path';
-import { isAutoSnippetDevRepo } from './isOwnDevRepo.js';
+import { isAutoSnippetDevRepo, isExcludedProject } from './isOwnDevRepo.js';
 import { DEFAULT_KNOWLEDGE_BASE_DIR, detectKnowledgeBaseDir, } from './ProjectMarkers.js';
 export class PathGuardError extends Error {
     projectRoot;
@@ -74,6 +74,10 @@ class PathGuard {
     #configured = false;
     /** projectRoot 是否是 AutoSnippet 自身的开发仓库 */
     #isDevRepo = false;
+    /** projectRoot 是否是应排除的项目（开发仓库、生态项目等） */
+    #isExcludedProject = false;
+    /** 排除原因 */
+    #excludeReason = '';
     /**
      * 配置 PathGuard（每个进程执行一次）
      * @param opts.projectRoot 用户项目根目录（绝对路径）
@@ -89,6 +93,9 @@ class PathGuard {
         this.#packageRoot = packageRoot ? path.resolve(packageRoot) : null;
         this.#knowledgeBaseDir = knowledgeBaseDir || null; // 延迟解析
         this.#isDevRepo = isAutoSnippetDevRepo(this.#projectRoot);
+        const exclusion = isExcludedProject(this.#projectRoot);
+        this.#isExcludedProject = exclusion.excluded;
+        this.#excludeReason = exclusion.reason;
         // 默认白名单：全局缓存 + 平台 Snippets 目录
         const HOME = process.env.HOME || process.env.USERPROFILE || '';
         if (HOME) {
@@ -175,19 +182,18 @@ class PathGuard {
         // 计算相对于 projectRoot 的路径
         const relative = path.relative(this.#projectRoot, resolved);
         const firstSegment = relative.split(path.sep)[0];
-        // ── 开发仓库保护 ──────────────────────────────────
-        // 如果 projectRoot 是 AutoSnippet 自身源码仓库，
-        // 禁止写入 .autosnippet/ 和知识库目录（AutoSnippet/），
-        // 防止在开发仓库内产生运行时数据
-        if (this.#isDevRepo) {
+        // ── 排除项目保护 ──────────────────────────────────
+        // 如果 projectRoot 是排除项目（开发仓库、生态项目等），
+        // 禁止写入 .autosnippet/ 和知识库目录
+        if (this.#isExcludedProject) {
             if (firstSegment === '.autosnippet') {
-                throw new PathGuardError(resolved, this.#projectRoot, 'Dev repo 保护: 禁止在 AutoSnippet 源码仓库内创建 .autosnippet/ 运行时数据');
+                throw new PathGuardError(resolved, this.#projectRoot, `排除项目保护 (${this.#excludeReason}): 禁止创建 .autosnippet/ 运行时数据`);
             }
             const kbDir = this.#resolveKnowledgeBaseDir();
             if (kbDir && firstSegment === kbDir) {
-                throw new PathGuardError(resolved, this.#projectRoot, `Dev repo 保护: 禁止在 AutoSnippet 源码仓库内创建 ${kbDir}/ 知识库数据`);
+                throw new PathGuardError(resolved, this.#projectRoot, `排除项目保护 (${this.#excludeReason}): 禁止创建 ${kbDir}/ 知识库数据`);
             }
-            // 开发仓库内允许写入 .cursor/.vscode/.github 等 IDE 配置
+            // 排除项目内仍允许写入 .cursor/.vscode/.github 等 IDE 配置
             for (const prefix of PROJECT_WRITE_SCOPE_PREFIXES) {
                 if (prefix !== '.autosnippet' && firstSegment === prefix) {
                     return;
@@ -196,7 +202,7 @@ class PathGuard {
             if (PROJECT_ROOT_WRITABLE_FILES.includes(relative)) {
                 return;
             }
-            throw new PathGuardError(resolved, this.#projectRoot, `Dev repo 保护: "${relative}" 不在允许范围内`);
+            throw new PathGuardError(resolved, this.#projectRoot, `排除项目保护 (${this.#excludeReason}): "${relative}" 不在允许范围内`);
         }
         // 检查是否在允许的前缀中
         for (const prefix of PROJECT_WRITE_SCOPE_PREFIXES) {