autosnippet 3.3.8 → 3.3.9

package/dashboard/dist/index.html

@@ -5,7 +5,7 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-DV8biUkH.js"></script>
+    <script type="module" crossorigin src="/assets/index-DEU4tJtP.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-BZEJEVBn.js">
     <link rel="modulepreload" crossorigin href="/assets/icons-BMNb0V6L.js">

package/dist/lib/bootstrap.js

@@ -44,7 +44,12 @@ export class Bootstrap {
             // 0.5 确保 PathGuard 已配置（如果调用方未提前配置）
             // MCP 服务器会在 initialize() 之前配置，但 CLI/测试可能跳过
             if (!pathGuard.configured) {
-                const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+                const isMcpMode = process.env.ASD_MCP_MODE === '1';
+                const projectRoot = process.env.ASD_PROJECT_DIR || (isMcpMode ? undefined : process.cwd());
+                if (!projectRoot) {
+                    throw new Error('[Bootstrap] MCP 模式下缺少 ASD_PROJECT_DIR 环境变量，' +
+                        '且 PathGuard 未提前配置。请在 .vscode/mcp.json 中设置 ASD_PROJECT_DIR。');
+                }
                 Bootstrap.configurePathGuard(projectRoot);
             }
             // 1. 加载配置

package/dist/lib/cli/SetupService.js

@@ -46,7 +46,7 @@
 import { execSync } from 'node:child_process';
 import { copyFileSync, cpSync, existsSync, mkdirSync, readdirSync, renameSync, rmdirSync, rmSync, writeFileSync, } from 'node:fs';
 import { join, resolve } from 'node:path';
-import { isAutoSnippetDevRepo } from '../shared/isOwnDevRepo.js';
+import { isExcludedProject } from '../shared/isOwnDevRepo.js';
 import { DEFAULT_KNOWLEDGE_BASE_DIR, DEFAULT_SUB_REPO_DIR, isGitRepo, } from '../shared/ProjectMarkers.js';
 import { PACKAGE_ROOT } from '../shared/package-root.js';
 import { FileDeployer } from './deploy/FileDeployer.js';
@@ -81,9 +81,10 @@ export class SetupService {
         this.seed = options.seed || false;
         this.subRepoDir = options.subRepoDir || DEFAULT_SUB_REPO_DIR;
         this.subRepoUrl = options.subRepoUrl;
-        // ── 开发仓库保护 ──────────────────────────────────
-        if (isAutoSnippetDevRepo(this.projectRoot)) {
-            throw new Error('[SetupService] 检测到当前目录是 AutoSnippet 源码开发仓库，' +
+        // ── 排除项目保护 ──────────────────────────────────
+        const exclusion = isExcludedProject(this.projectRoot);
+        if (exclusion.excluded) {
+            throw new Error(`[SetupService] 检测到当前目录是排除项目（${exclusion.reason}），` +
                 '拒绝执行 setup 以避免创建 .autosnippet/ 和 AutoSnippet/ 运行时数据。' +
                 '\n提示: 请在用户项目目录中运行 asd setup。');
         }

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/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/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) {

package/dist/lib/shared/isOwnDevRepo.d.ts

@@ -1,10 +1,14 @@
 /**
- * isOwnDevRepo — 检测当前 projectRoot 是否是 AutoSnippet 自身的开发仓库
+ * isOwnDevRepo — 检测 projectRoot 是否应排除 AutoSnippet 运行时数据创建
  *
- * 用于防止 MCP 服务器 / CLI 在开发环境中把源码仓库当做用户项目，
- * 避免在开发仓库内创建 `.autosnippet/` 和 `AutoSnippet/candidates/` 等运行时数据。
+ * 三层保护：
+ *  1. isAutoSnippetDevRepo — AutoSnippet 自身源码仓库
+ *  2. isAutoSnippetEcosystemRepo — AutoSnippet 生态项目（autosnippet-book 等）
+ *  3. isExcludedProject — 综合判定：不适合创建知识库的项目
  *
- * 检测条件（三者同时满足）：
+ * 用于防止 MCP 服务器 / CLI 在不当目录创建 `.autosnippet/` 运行时数据。
+ *
+ * isAutoSnippetDevRepo 检测条件（三者同时满足）：
  *  1. projectRoot/package.json 的 name === 'autosnippet'
  *  2. projectRoot/lib/bootstrap.ts 存在（源码标记）
  *  3. projectRoot/SOUL.md 存在（项目灵魂文档）
@@ -14,5 +18,26 @@
  * 结果按 dir 缓存，避免重复 IO
  */
 export declare function isAutoSnippetDevRepo(dir: string): boolean;
+/**
+ * 判断 dir 是否是 AutoSnippet 生态项目（不应创建运行时数据）
+ *
+ * 检测条件：package.json 的 name 以 'autosnippet-' 开头
+ * 例如 autosnippet-book、autosnippet-examples 等
+ */
+export declare function isAutoSnippetEcosystemRepo(dir: string): boolean;
+/**
+ * 综合判定：项目是否应排除创建 .autosnippet/ 运行时数据
+ *
+ * 当前排除：
+ *  1. AutoSnippet 源码仓库本身
+ *  2. AutoSnippet 生态项目（autosnippet-book 等）
+ *  3. 存在 .autosnippet-skip 标记文件的项目（用户手动排除）
+ *
+ * @returns { excluded: boolean; reason: string }
+ */
+export declare function isExcludedProject(dir: string): {
+    excluded: boolean;
+    reason: string;
+};
 /** 重置缓存（仅用于测试） */
 export declare function _resetDevRepoCache(): void;

package/dist/lib/shared/isOwnDevRepo.js

@@ -1,10 +1,14 @@
 /**
- * isOwnDevRepo — 检测当前 projectRoot 是否是 AutoSnippet 自身的开发仓库
+ * isOwnDevRepo — 检测 projectRoot 是否应排除 AutoSnippet 运行时数据创建
  *
- * 用于防止 MCP 服务器 / CLI 在开发环境中把源码仓库当做用户项目，
- * 避免在开发仓库内创建 `.autosnippet/` 和 `AutoSnippet/candidates/` 等运行时数据。
+ * 三层保护：
+ *  1. isAutoSnippetDevRepo — AutoSnippet 自身源码仓库
+ *  2. isAutoSnippetEcosystemRepo — AutoSnippet 生态项目（autosnippet-book 等）
+ *  3. isExcludedProject — 综合判定：不适合创建知识库的项目
  *
- * 检测条件（三者同时满足）：
+ * 用于防止 MCP 服务器 / CLI 在不当目录创建 `.autosnippet/` 运行时数据。
+ *
+ * isAutoSnippetDevRepo 检测条件（三者同时满足）：
  *  1. projectRoot/package.json 的 name === 'autosnippet'
  *  2. projectRoot/lib/bootstrap.ts 存在（源码标记）
  *  3. projectRoot/SOUL.md 存在（项目灵魂文档）
@@ -13,6 +17,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 /** 多路径缓存（同一进程可能检测多个目录） */
 const _cache = new Map();
+/** 排除项目缓存 */
+const _excludeCache = new Map();
 /**
  * 判断 dir 是否是 AutoSnippet 自身的源码开发仓库
  * 结果按 dir 缓存，避免重复 IO
@@ -44,7 +50,61 @@ export function isAutoSnippetDevRepo(dir) {
     _cache.set(resolved, result);
     return result;
 }
+/**
+ * 判断 dir 是否是 AutoSnippet 生态项目（不应创建运行时数据）
+ *
+ * 检测条件：package.json 的 name 以 'autosnippet-' 开头
+ * 例如 autosnippet-book、autosnippet-examples 等
+ */
+export function isAutoSnippetEcosystemRepo(dir) {
+    const resolved = path.resolve(dir);
+    try {
+        const pkgPath = path.join(resolved, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const raw = fs.readFileSync(pkgPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            return typeof pkg.name === 'string' && pkg.name.startsWith('autosnippet-');
+        }
+    }
+    catch {
+        // 读取失败 → 不是
+    }
+    return false;
+}
+/**
+ * 综合判定：项目是否应排除创建 .autosnippet/ 运行时数据
+ *
+ * 当前排除：
+ *  1. AutoSnippet 源码仓库本身
+ *  2. AutoSnippet 生态项目（autosnippet-book 等）
+ *  3. 存在 .autosnippet-skip 标记文件的项目（用户手动排除）
+ *
+ * @returns { excluded: boolean; reason: string }
+ */
+export function isExcludedProject(dir) {
+    const resolved = path.resolve(dir);
+    const cached = _excludeCache.get(resolved);
+    if (cached !== undefined) {
+        return cached;
+    }
+    let result;
+    if (isAutoSnippetDevRepo(resolved)) {
+        result = { excluded: true, reason: 'AutoSnippet 源码开发仓库' };
+    }
+    else if (isAutoSnippetEcosystemRepo(resolved)) {
+        result = { excluded: true, reason: 'AutoSnippet 生态项目' };
+    }
+    else if (fs.existsSync(path.join(resolved, '.autosnippet-skip'))) {
+        result = { excluded: true, reason: '项目包含 .autosnippet-skip 标记' };
+    }
+    else {
+        result = { excluded: false, reason: '' };
+    }
+    _excludeCache.set(resolved, result);
+    return result;
+}
 /** 重置缓存（仅用于测试） */
 export function _resetDevRepoCache() {
     _cache.clear();
+    _excludeCache.clear();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.3.8",
+  "version": "3.3.9",
   "description": "Extract code patterns into a knowledge base for AI coding assistants",
   "type": "module",
   "main": "dist/lib/bootstrap.js",