autosnippet 2.8.0 → 2.8.2

package/README.md

@@ -5,7 +5,7 @@
 **Project Knowledge Engine for iOS / Swift Teams**
 
 将团队的代码模式、最佳实践沉淀为 AI 可检索的知识库，<br>
-让 Cursor、Copilot 和 Xcode 都按你的项目规范生成代码。
+让 Cursor、Trae、Copilot 和 Xcode 都按你的项目规范生成代码。
 
 [![npm version](https://img.shields.io/npm/v/autosnippet.svg?style=flat-square)](https://www.npmjs.com/package/autosnippet)
 [![License](https://img.shields.io/npm/l/autosnippet.svg?style=flat-square)](https://github.com/GxFn/AutoSnippet/blob/main/LICENSE)
@@ -24,7 +24,7 @@ AI 编码助手生成的代码往往脱离项目上下文——不知道团队
                                                         │
                 ┌───────────────────────────────────────┘
                 ↓
-        Cursor / Copilot / Xcode  ──→  按规范生成代码
+        Cursor / Trae / Copilot / Xcode  ──→  按规范生成代码
 ```
 
 ## 核心概念
@@ -131,6 +131,10 @@ AutoSnippet 为 Cursor 提供完整的 MCP + Skills 集成：
 asd install:cursor-skill --mcp  # 安装 Skills + MCP 配置
 ```
 
+### Trae
+
+Trae 支持 MCP 协议，MCP 配置格式与 Cursor 兼容——安装 Cursor 集成后即可在 Trae 中使用相同的 MCP 工具与 Skills。
+
 ### VSCode Copilot
 
 ```bash

package/bin/api-server.js

@@ -24,6 +24,12 @@ async function main() {
 
     // 配置路径安全守卫 — 阻止写操作逃逸到项目外
     const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+
+    // 切换工作目录到项目根 — 确保 DB 等相对路径正确解析
+    if (projectRoot !== process.cwd()) {
+      process.chdir(projectRoot);
+    }
+
     Bootstrap.configurePathGuard(projectRoot);
 
     // 初始化应用程序引导

package/bin/cli.js

@@ -605,6 +605,11 @@ async function initBootstrap() {
 async function initContainer(opts = {}) {
   const projectRoot = opts.projectRoot || process.cwd();
 
+  // 切换工作目录到项目根 — 确保 DB 等相对路径正确解析
+  if (resolve(projectRoot) !== resolve(process.cwd())) {
+    process.chdir(projectRoot);
+  }
+
   // 配置路径安全守卫 — 阻止写操作逃逸到项目外
   const { default: Bootstrap } = await import('../lib/bootstrap.js');
   Bootstrap.configurePathGuard(projectRoot);

package/lib/external/mcp/McpServer.js

@@ -54,6 +54,12 @@ export class McpServer {
 
       // 路径安全守卫 — 在任何写操作前配置
       const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+
+      // 切换工作目录到项目根 — 确保 DB 等相对路径正确解析
+      if (projectRoot !== process.cwd()) {
+        process.chdir(projectRoot);
+      }
+
       Bootstrap.configurePathGuard(projectRoot);
 
       this.bootstrap = new Bootstrap();

package/lib/http/routes/candidates.js

@@ -22,7 +22,7 @@ const MAX_BATCH_SIZE = 100;
 router.get('/', asyncHandler(async (req, res) => {
   const { status, language, category, keyword } = req.query;
   const page = safeInt(req.query.page, 1);
-  const pageSize = safeInt(req.query.limit, 20, 1, 100);
+  const pageSize = safeInt(req.query.limit, 20, 1, 1000);
 
   const container = getServiceContainer();
   const candidateService = container.get('candidateService');

package/lib/infrastructure/database/DatabaseConnection.js

@@ -9,6 +9,9 @@ const __dirname = path.dirname(__filename);
 
 /**
  * DatabaseConnection - 数据库连接管理器
+ *
+ * 重要：相对 DB 路径通过 projectRoot 解析，而非 process.cwd()。
+ * 这样即使 MCP 服务器的 cwd 不是项目目录，DB 也不会创建到项目外。
  */
 export class DatabaseConnection {
   constructor(config) {
@@ -22,8 +25,14 @@ export class DatabaseConnection {
   async connect() {
     const dbPath = this.config.path;
 
+    // 使用 projectRoot（PathGuard 已配置）优先解析相对路径，
+    // 而非 path.resolve()（依赖 cwd，MCP 场景下 cwd 可能是用户主目录）
+    const projectRoot = pathGuard.projectRoot;
+    const resolvedDbPath = (projectRoot && !path.isAbsolute(dbPath))
+      ? path.resolve(projectRoot, dbPath)
+      : path.resolve(dbPath);
+
     // 路径安全检查 — 防止 DB 文件创建到项目允许范围外
-    const resolvedDbPath = path.resolve(dbPath);
     pathGuard.assertProjectWriteSafe(resolvedDbPath);
     
     // 确保数据目录存在
@@ -32,7 +41,7 @@ export class DatabaseConnection {
       fs.mkdirSync(dbDir, { recursive: true });
     }
 
-    this.db = new Database(dbPath, {
+    this.db = new Database(resolvedDbPath, {
       verbose: this.config.verbose ? (msg) => process.stderr.write(`[SQL] ${msg}\n`) : null,
     });
 

package/lib/shared/PathGuard.js

@@ -104,11 +104,11 @@ class PathGuard {
     this.#packageRoot = packageRoot ? path.resolve(packageRoot) : null;
     this.#knowledgeBaseDir = knowledgeBaseDir || null;  // 延迟解析
 
-    // 默认白名单：Xcode snippets 目录、全局缓存
+    // 默认白名单：Xcode snippets 目录、全局缓存（cache 子目录，不含整个 ~/.autosnippet）
     const HOME = process.env.HOME || process.env.USERPROFILE || '';
     if (HOME) {
       this.#allowList.add(path.join(HOME, 'Library/Developer/Xcode/UserData/CodeSnippets'));
-      this.#allowList.add(path.join(HOME, '.autosnippet'));
+      this.#allowList.add(path.join(HOME, '.autosnippet', 'cache'));
     }
 
     // 用户自定义白名单

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "2.8.0",
+  "version": "2.8.2",
   "description": "AutoSnippet - 连接开发者、AI 与项目知识库的工具",
   "type": "module",
   "main": "lib/bootstrap.js",

package/skills/autosnippet-coldstart/SKILL.md

@@ -1,4 +1,3 @@
-```skill
 ---
 name: autosnippet-coldstart
 description: Cold-start knowledge base initialization. Full 9-dimension analysis workflow — works with both external Agent and internal AI. Call bootstrap_knowledge, then systematically analyze code and submit candidates.
@@ -465,4 +464,3 @@ description: Cold-start knowledge base initialization. Full 9-dimension analysis
 - **autosnippet-reference-swift**: Swift 业界最佳实践参考（命名/并发/错误处理/内存/设计模式）
 - **autosnippet-reference-objc**: Objective-C 业界最佳实践参考（ARC/Block/Delegate/Prefix/GCD）
 - **autosnippet-reference-jsts**: JavaScript/TypeScript 业界最佳实践参考（async/React/Node/ESM/类型系统）
-```

package/skills/autosnippet-reference-jsts/SKILL.md

@@ -1,4 +1,3 @@
-```skill
 ---
 name: autosnippet-reference-jsts
 description: JavaScript/TypeScript 业界最佳实践参考。涵盖类型系统、模块化、错误处理、async/await、命名、ESLint 规则，为冷启动分析提供高质量参考标准。
@@ -437,4 +436,3 @@ const url = baseUrl + '/api/v' + version + '/users/' + userId;
 - **autosnippet-coldstart**: 完整冷启动流程（本 Skill 的主 Skill）
 - **autosnippet-reference-swift**: Swift 业界最佳实践参考
 - **autosnippet-reference-objc**: Objective-C 业界最佳实践参考
-```

package/skills/autosnippet-reference-objc/SKILL.md

@@ -1,4 +1,3 @@
-```skill
 ---
 name: autosnippet-reference-objc
 description: Objective-C 业界最佳实践参考。涵盖命名前缀、属性声明、Delegate 模式、内存管理、nullability、错误处理，为冷启动分析提供高质量参考标准。
@@ -424,4 +423,3 @@ if ([NSThread isMainThread]) {
 - **autosnippet-coldstart**: 完整冷启动流程（本 Skill 的主 Skill）
 - **autosnippet-reference-swift**: Swift 业界最佳实践参考
 - **autosnippet-reference-jsts**: JavaScript/TypeScript 业界最佳实践参考
-```

package/skills/autosnippet-reference-swift/SKILL.md

@@ -1,4 +1,3 @@
-```skill
 ---
 name: autosnippet-reference-swift
 description: Swift 业界最佳实践参考。涵盖命名规范、Swift Concurrency、SwiftUI 模式、错误处理、内存管理、设计模式，为冷启动分析提供高质量参考标准。
@@ -458,4 +457,3 @@ UIView.animate(
 - **autosnippet-coldstart**: 完整冷启动流程（本 Skill 的主 Skill）
 - **autosnippet-reference-objc**: Objective-C 业界最佳实践参考
 - **autosnippet-reference-jsts**: JavaScript/TypeScript 业界最佳实践参考
-```