autosnippet 2.1.0 → 2.4.0

package/lib/external/mcp/tools.js

@@ -17,6 +17,7 @@ export const TOOL_GATEWAY_MAP = {
   autosnippet_enrich_candidates: { action: 'candidate:update', resource: 'candidates' },
   autosnippet_bootstrap_knowledge: { action: 'knowledge:bootstrap', resource: 'knowledge' },
   autosnippet_bootstrap_refine: { action: 'candidate:update', resource: 'candidates' },
+  autosnippet_create_skill: { action: 'create:skills', resource: 'skills' },
 };
 
 export const TOOLS = [
@@ -623,7 +624,45 @@ export const TOOLS = [
       required: ['skillName'],
     },
   },
-  // 35. ② 内容润色：Bootstrap 候选 AI 精炼（Phase 6）
+  // 35. 创建项目级 Skill
+  {
+    name: 'autosnippet_create_skill',
+    description:
+      '创建一个项目级 Skill 文档，写入 .autosnippet/skills/<name>/SKILL.md。\n' +
+      'Skill 是 Agent 的领域知识增强文档，帮助 Agent 正确执行特定任务。\n' +
+      '创建后自动更新编辑器索引（.cursor/rules/autosnippet-skills.mdc），使 Skill 被 AI Agent 被动发现。\n' +
+      '\n' +
+      '使用场景：\n' +
+      '  • 将反复出现的操作指南/架构决策/编码规范固化为 Skill\n' +
+      '  • 为特定 Target/模块创建定制化开发指南\n' +
+      '  • 记录项目私有的最佳实践（不适合放入通用知识库）\n' +
+      '\n' +
+      '⚠️ 注意：Skill 名称建议使用 kebab-case，如 my-auth-guide',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          description: 'Skill 名称（kebab-case，如 my-auth-guide）。将作为目录名。',
+        },
+        description: {
+          type: 'string',
+          description: 'Skill 一句话描述（写入 SKILL.md frontmatter）',
+        },
+        content: {
+          type: 'string',
+          description: 'Skill 正文内容（Markdown 格式，不含 frontmatter）',
+        },
+        overwrite: {
+          type: 'boolean',
+          default: false,
+          description: '如果同名 Skill 已存在，是否覆盖（默认 false）',
+        },
+      },
+      required: ['name', 'description', 'content'],
+    },
+  },
+  // 36. ② 内容润色：Bootstrap 候选 AI 精炼（Phase 6）
   {
     name: 'autosnippet_bootstrap_refine',
     description:

package/lib/http/middleware/roleResolver.js

@@ -96,7 +96,7 @@ export function roleResolverMiddleware(options = {}) {
         }
       } else {
         // 无探针实例 → 本地开发默认 admin（向后兼容）
-        req.resolvedRole = 'developer_admin';
+        req.resolvedRole = 'developer';
         req.resolvedUser = 'local';
       }
 

package/lib/http/routes/auth.js

@@ -44,7 +44,7 @@ if (!process.env.ASD_AUTH_SECRET) {
 function createToken(username) {
   const payload = {
     sub: username,
-    role: 'developer_admin',
+    role: 'developer',
     iat: Date.now(),
     exp: Date.now() + TOKEN_TTL,
   };
@@ -107,7 +107,7 @@ router.post('/login', asyncHandler(async (req, res) => {
     success: true,
     data: {
       token,
-      user: { username, role: 'developer_admin' },
+      user: { username, role: 'developer' },
     },
   });
 }));

package/lib/http/routes/monitoring.js

@@ -160,12 +160,12 @@ router.get('/cache', (req, res) => {
 
 /**
  * POST /api/v1/monitoring/cache/clear
- * 清空缓存（仅限 developer_admin）
+ * 清空缓存（仅限 developer）
  */
 router.post('/cache/clear', async (req, res) => {
   // 角色检查：仅 admin 可操作
   const role = req.resolvedRole || 'visitor';
-  if (role !== 'developer_admin') {
+  if (role !== 'developer') {
     return res.status(403).json({
       success: false,
       error: { message: '仅管理员可清空缓存' },
@@ -285,7 +285,7 @@ router.get('/dashboard', async (req, res) => {
 
 /**
  * POST /api/v1/monitoring/reset
- * 重置监控统计（仅限开发环境 + developer_admin）
+ * 重置监控统计（仅限开发环境 + developer）
  */
 router.post('/reset', (req, res) => {
   if (process.env.NODE_ENV === 'production') {
@@ -297,7 +297,7 @@ router.post('/reset', (req, res) => {
 
   // 角色检查：仅 admin 可操作
   const role = req.resolvedRole || 'visitor';
-  if (role !== 'developer_admin') {
+  if (role !== 'developer') {
     return res.status(403).json({
       success: false,
       error: { message: '仅管理员可重置监控统计' },

package/lib/http/routes/search.js

@@ -214,23 +214,6 @@ router.get('/graph/stats', asyncHandler(async (req, res) => {
   res.json({ success: true, data: stats });
 }));
 
-/**
- * GET /api/v1/search/compliance
- * 合规评估报告
- */
-router.get('/compliance', asyncHandler(async (req, res) => {
-  const { period } = req.query;
-  const container = getServiceContainer();
-  const evaluator = container.get('complianceEvaluator');
-
-  if (!evaluator) {
-    return res.json({ success: true, data: { overallScore: 0, message: 'ComplianceEvaluator not available' } });
-  }
-
-  const report = evaluator.evaluate({ period });
-  res.json({ success: true, data: report });
-}));
-
 /**
  * POST /api/v1/search/trigger-from-code
  * Xcode trigger 搜索模拟 (stub — 功能未完整实现)

package/lib/injection/ServiceContainer.js

@@ -49,10 +49,10 @@ import { AutomationOrchestrator } from '../service/automation/AutomationOrchestr
 import { ToolRegistry } from '../service/chat/ToolRegistry.js';
 import { ChatAgent } from '../service/chat/ChatAgent.js';
 import { ALL_TOOLS } from '../service/chat/tools.js';
+import { SkillHooks } from '../service/skills/SkillHooks.js';
 
 // ─── P3: Infrastructure ──────────────────────────────
-import { EventBus } from '../infrastructure/event/EventBus.js';
-import { PluginManager } from '../infrastructure/plugin/PluginManager.js';
+// EventBus / PluginManager imports removed — source files retained for future use
 
 /**
  * DependencyInjection 容器
@@ -88,18 +88,10 @@ export class ServiceContainer {
       if (bootstrapComponents.gateway) {
         this.singletons.gateway = bootstrapComponents.gateway;
       }
-      if (bootstrapComponents.reasoningLogger) {
-        this.singletons.reasoningLogger = bootstrapComponents.reasoningLogger;
-      }
-      if (bootstrapComponents.roleDriftMonitor) {
-        this.singletons.roleDriftMonitor = bootstrapComponents.roleDriftMonitor;
-      }
-      if (bootstrapComponents.complianceEvaluator) {
-        this.singletons.complianceEvaluator = bootstrapComponents.complianceEvaluator;
-      }
-      if (bootstrapComponents.sessionManager) {
-        this.singletons.sessionManager = bootstrapComponents.sessionManager;
+      if (bootstrapComponents.constitution) {
+        this.singletons.constitution = bootstrapComponents.constitution;
       }
+
       if (bootstrapComponents.projectRoot) {
         this.singletons._projectRoot = bootstrapComponents.projectRoot;
       }
@@ -209,17 +201,7 @@ export class ServiceContainer {
       return this.singletons.gateway;
     });
 
-    // ReasoningLogger
-    this.register('reasoningLogger', () => this.singletons.reasoningLogger || null);
 
-    // RoleDriftMonitor
-    this.register('roleDriftMonitor', () => this.singletons.roleDriftMonitor || null);
-
-    // ComplianceEvaluator
-    this.register('complianceEvaluator', () => this.singletons.complianceEvaluator || null);
-
-    // SessionManager
-    this.register('sessionManager', () => this.singletons.sessionManager || null);
   }
 
   /**
@@ -257,11 +239,12 @@ export class ServiceContainer {
         const gateway = this.get('gateway');
         const projectRoot = this.singletons._projectRoot || process.cwd();
         const candidateFileWriter = new CandidateFileWriter(projectRoot);
+        const skillHooks = this.get('skillHooks');
         this.singletons.candidateService = new CandidateService(
           candidateRepository,
           auditLogger,
           gateway,
-          { fileWriter: candidateFileWriter }
+          { fileWriter: candidateFileWriter, skillHooks }
         );
       }
       return this.singletons.candidateService;
@@ -276,12 +259,13 @@ export class ServiceContainer {
         const knowledgeGraphService = this.get('knowledgeGraphService');
         const projectRoot = this.singletons._projectRoot || process.cwd();
         const fileWriter = new RecipeFileWriter(projectRoot);
+        const skillHooks = this.get('skillHooks');
         this.singletons.recipeService = new RecipeService(
           recipeRepository,
           auditLogger,
           gateway,
           knowledgeGraphService,
-          { fileWriter }
+          { fileWriter, skillHooks }
         );
       }
       return this.singletons.recipeService;
@@ -332,23 +316,12 @@ export class ServiceContainer {
       return this.singletons.guardCheckEngine;
     });
 
-    // ─── 新迁移的服务 ────────────────────────────────────
+    // ─── Constitution ────────────────────────────────────
+    this.register('constitution', () => this.singletons.constitution || null);
 
-    // EventBus
-    this.register('eventBus', () => {
-      if (!this.singletons.eventBus) {
-        this.singletons.eventBus = new EventBus();
-      }
-      return this.singletons.eventBus;
-    });
+    // ─── 新迁移的服务 ────────────────────────────────────
 
-    // PluginManager
-    this.register('pluginManager', () => {
-      if (!this.singletons.pluginManager) {
-        this.singletons.pluginManager = new PluginManager();
-      }
-      return this.singletons.pluginManager;
-    });
+    // EventBus / PluginManager — 已移除注册（源文件保留，未来可恢复）
 
     // RetrievalFunnel (Advanced Search)
     this.register('retrievalFunnel', () => {
@@ -518,6 +491,14 @@ export class ServiceContainer {
       }
       return this.singletons.chatAgent;
     });
+
+    // SkillHooks (Skill 生命周期钩子 — 加载 skills/*/hooks.js)
+    this.register('skillHooks', () => {
+      if (!this.singletons.skillHooks) {
+        this.singletons.skillHooks = new SkillHooks();
+      }
+      return this.singletons.skillHooks;
+    });
   }
 
   /**

package/lib/service/candidate/CandidateService.js

@@ -11,11 +11,12 @@ import { v4 as uuidv4 } from 'uuid';
  * 包括创建、批准、驳回和应用到 Recipe 的业务逻辑
  */
 export class CandidateService {
-  constructor(candidateRepository, auditLogger, gateway, { fileWriter } = {}) {
+  constructor(candidateRepository, auditLogger, gateway, { fileWriter, skillHooks } = {}) {
     this.candidateRepository = candidateRepository;
     this.auditLogger = auditLogger;
     this.gateway = gateway;
     this.fileWriter = fileWriter || null;
+    this.skillHooks = skillHooks || null;
     this.logger = Logger.getInstance();
   }
 
@@ -52,6 +53,16 @@ export class CandidateService {
         throw new ValidationError('Invalid candidate data');
       }
 
+      // ── SkillHooks: onCandidateSubmit ──
+      if (this.skillHooks) {
+        const hookResult = await this.skillHooks.run('onCandidateSubmit', candidate, {
+          userId: context.userId,
+        });
+        if (hookResult?.block) {
+          throw new ValidationError(`SkillHook blocked: ${hookResult.reason || 'unknown'}`);
+        }
+      }
+
       // 保存到数据库
       const created = await this.candidateRepository.create(candidate);
 

package/lib/service/chat/ChatAgent.js

@@ -27,9 +27,12 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { TaskPipeline } from './TaskPipeline.js';
+import { Memory } from './Memory.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SKILLS_DIR = path.resolve(__dirname, '../../../skills');
+const PROJECT_ROOT = path.resolve(__dirname, '../../..');
+const SKILLS_DIR = path.resolve(PROJECT_ROOT, 'skills');
+const SOUL_PATH = path.resolve(PROJECT_ROOT, 'SOUL.md');
 const MAX_ITERATIONS = 6;
 
 export class ChatAgent {
@@ -39,6 +42,10 @@ export class ChatAgent {
   #logger;
   /** @type {Map<string, TaskPipeline>} */
   #pipelines = new Map();
+  /** @type {string} 缓存的项目概况（每次 execute 刷新一次） */
+  #projectBriefingCache = '';
+  /** @type {Memory|null} 跨对话轻量记忆 */
+  #memory = null;
 
   /**
    * @param {object} opts
@@ -55,6 +62,12 @@ export class ChatAgent {
     /** 是否有 AI Provider（只读） */
     this.hasAI = !!aiProvider;
 
+    // 初始化跨对话记忆
+    try {
+      const projectRoot = container?.singletons?._projectRoot || process.cwd();
+      this.#memory = new Memory(projectRoot);
+    } catch { /* Memory init failed, degrade silently */ }
+
     // 注册内置 DAG 管线
     this.#registerBuiltinPipelines();
   }
@@ -71,6 +84,9 @@ export class ChatAgent {
    * @returns {Promise<{reply: string, toolCalls: Array, hasContext: boolean}>}
    */
   async execute(prompt, { history = [] } = {}) {
+    // 每次对话刷新项目概况（不是每轮 ReAct）
+    this.#projectBriefingCache = await this.#buildProjectBriefing();
+
     const toolSchemas = this.#toolRegistry.getToolSchemas();
     const systemPrompt = this.#buildSystemPrompt(toolSchemas);
 
@@ -97,11 +113,9 @@ export class ChatAgent {
 
       if (!action) {
         // 没有 Action → 最终回答
-        return {
-          reply: this.#cleanFinalAnswer(response),
-          toolCalls,
-          hasContext: toolCalls.length > 0,
-        };
+        const reply = this.#cleanFinalAnswer(response);
+        this.#extractMemory(prompt, reply);
+        return { reply, toolCalls, hasContext: toolCalls.length > 0 };
       }
 
       // 执行工具
@@ -141,8 +155,11 @@ export class ChatAgent {
       systemPrompt: '直接回答用户问题，不要再调用工具。',
     });
 
+    const finalReply = this.#cleanFinalAnswer(finalResponse);
+    this.#extractMemory(prompt, finalReply);
+
     return {
-      reply: this.#cleanFinalAnswer(finalResponse),
+      reply: finalReply,
       toolCalls,
       hasContext: toolCalls.length > 0,
     };
@@ -574,9 +591,18 @@ ${code.substring(0, 3000)}
       ? `\n## 可用 Skills\n通过 load_skill 工具按需加载领域知识文档，获取操作指南和最佳实践参考。\n\n| Skill | 说明 |\n|---|---|\n${skillList.map(s => `| ${s.name} | ${s.summary || '-'} |`).join('\n')}\n\n**场景 → Skill 推荐**：\n- 冷启动、初始化 → autosnippet-coldstart\n- 深度项目分析 → autosnippet-analysis\n- 候选生成 → autosnippet-candidates + autosnippet-create\n- 代码规范审计 → autosnippet-guard\n- Snippet 概念解释 → autosnippet-concepts\n- 生命周期管理 → autosnippet-lifecycle\n- Swift/ObjC/JS·TS 语言参考 → autosnippet-reference-{swift,objc,jsts}\n- 项目结构分析 → autosnippet-structure\n- 不确定该用哪个 → autosnippet-intent\n`
       : '';
 
-    return `你是 AutoSnippet 项目的统一 AI 中心。项目内所有 AI 推理和分析都通过你执行。
-你拥有 ${toolSchemas.length} 个工具覆盖知识库管理全链路：搜索、提交、审核、质量评估、Guard 检查、知识图谱、冷启动等。
+    // SOUL — AI 人格注入（如果 SOUL.md 存在）
+    let soulSection = '';
+    try {
+      if (fs.existsSync(SOUL_PATH)) {
+        soulSection = '\n' + fs.readFileSync(SOUL_PATH, 'utf-8').trim() + '\n';
+      }
+    } catch { /* SOUL.md not available */ }
 
+    return `${soulSection}
+你是 AutoSnippet 项目的统一 AI 中心。项目内所有 AI 推理和分析都通过你执行。
+你拥有 ${toolSchemas.length} 个工具覆盖知识库管理全链路：搜索、提交、审核、质量评估、Guard 检查、知识图谱、冷启动等。
+${this.#projectBriefingCache}${this.#memory?.toPromptSection() || ''}
 可用工具:
 
 ${toolDescriptions}
@@ -599,7 +625,9 @@ ${skillSection}
    - 候选创建/提交 → load_skill("autosnippet-candidates")
    - 代码规范/Guard → load_skill("autosnippet-guard")
    - 不确定做什么 → load_skill("autosnippet-intent")
-8. 你可以组合多个工具完成复杂任务（如：查重 → 提交 → 质量评分 → 知识图谱关联）。`;
+8. 你可以组合多个工具完成复杂任务（如：查重 → 提交 → 质量评分 → 知识图谱关联）。
+9. 当工具返回 _meta.confidence = "none" 时，告知用户无匹配并建议下一步，不要凭空编造。当 _meta.confidence = "low" 时，明确标注结果不确定性。
+10. 优先使用组合工具（analyze_code, knowledge_overview, submit_with_check）减少调用轮次。`;
   }
 
   /**
@@ -660,24 +688,39 @@ ${skillSection}
 
   /**
    * 列出可用的 Skills 及其摘要（用于系统提示词）
+   * 加载顺序: 内置 skills/ → 项目级 .autosnippet/skills/（同名覆盖）
    * @returns {{ name: string, summary: string }[]}
    */
   #listAvailableSkills() {
+    const skillMap = new Map();
+
+    // 1. 内置 Skills
+    this.#loadSkillsFromDir(SKILLS_DIR, skillMap);
+
+    // 2. 项目级 Skills（覆盖同名内置 Skill）
+    const projectSkillsDir = path.resolve(PROJECT_ROOT, '.autosnippet', 'skills');
+    this.#loadSkillsFromDir(projectSkillsDir, skillMap);
+
+    return Array.from(skillMap.values());
+  }
+
+  /**
+   * 从目录加载 Skills 到 Map
+   */
+  #loadSkillsFromDir(dir, skillMap) {
     try {
-      const dirs = fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
+      const dirs = fs.readdirSync(dir, { withFileTypes: true })
         .filter(d => d.isDirectory())
         .map(d => d.name);
-      return dirs.map(name => {
-        const skillPath = path.join(SKILLS_DIR, name, 'SKILL.md');
+      for (const name of dirs) {
+        const skillPath = path.join(dir, name, 'SKILL.md');
         let summary = '';
         try {
           const raw = fs.readFileSync(skillPath, 'utf-8');
-          // 从 frontmatter description 或首行 # 后提取摘要
           const fmMatch = raw.match(/^---[\s\S]*?description:\s*["']?(.+?)["']?\s*$/m);
           if (fmMatch) {
             summary = fmMatch[1];
           } else {
-            // fallback: 取首个非空非标题行
             const lines = raw.split('\n');
             for (const line of lines) {
               const trimmed = line.trim();
@@ -688,10 +731,88 @@ ${skillSection}
             }
           }
         } catch { /* SKILL.md not found */ }
-        return { name, summary };
-      });
+        skillMap.set(name, { name, summary });
+      }
+    } catch { /* directory not found */ }
+  }
+
+  /**
+   * 构建项目概况注入到系统提示词（每次 execute 刷新一次）
+   * 单次 SQL 聚合 < 5ms，静默降级
+   */
+  async #buildProjectBriefing() {
+    try {
+      const db = this.#container?.get('database');
+      if (!db) return '';
+      // knowledge_type → kind 映射:
+      //   rule: code-standard, code-style, best-practice, boundary-constraint
+      //   pattern: code-pattern, architecture, solution
+      //   fact: code-relation, inheritance, call-chain, data-flow, module-dependency
+      const stats = db.prepare(`
+        SELECT
+          (SELECT COUNT(*) FROM recipes) as recipeCount,
+          (SELECT COUNT(*) FROM recipes WHERE knowledge_type IN ('code-standard','code-style','best-practice','boundary-constraint')) as ruleCount,
+          (SELECT COUNT(*) FROM recipes WHERE knowledge_type IN ('code-pattern','architecture','solution')) as patternCount,
+          (SELECT COUNT(*) FROM recipes WHERE knowledge_type IN ('code-relation','inheritance','call-chain','data-flow','module-dependency')) as factCount,
+          (SELECT COUNT(*) FROM recipes WHERE knowledge_type = 'boundary-constraint') as guardRuleCount,
+          (SELECT COUNT(*) FROM candidates WHERE status='pending') as pendingCandidates,
+          (SELECT COUNT(*) FROM candidates) as totalCandidates
+      `).get();
+      if (!stats || stats.recipeCount === 0) {
+        return '\n## 项目状态\n⚠️ 知识库为空。建议先执行冷启动（bootstrap_knowledge）。\n';
+      }
+      let section = `\n## 项目状态\n- 知识库: ${stats.recipeCount} 条 Recipe（${stats.ruleCount || 0} rule / ${stats.patternCount || 0} pattern / ${stats.factCount || 0} fact）\n- Guard 规则: ${stats.guardRuleCount || 0} 条\n- 候选: ${stats.pendingCandidates} 条待审 / ${stats.totalCandidates} 条总计\n`;
+      if (stats.pendingCandidates > 10) {
+        section += `\n⚠️ 有 ${stats.pendingCandidates} 条候选积压，建议执行批量审核。\n`;
+      }
+      return section;
     } catch {
-      return [];
+      return ''; // DB 不可用时静默降级
+    }
+  }
+
+  /**
+   * 从用户消息中提取偏好/决策写入 Memory
+   * 使用正则匹配，不调 AI — 零延迟
+   */
+  #extractMemory(prompt, _reply) {
+    if (!this.#memory) return;
+    try {
+      const prefPatterns = [
+        /我们(项目|团队)?(不用|不使用|禁止|避免|偏好|习惯|规范是)/,
+        /以后(都|请|要)/,
+        /记住/,
+      ];
+      if (prefPatterns.some(p => p.test(prompt))) {
+        this.#memory.append({
+          type: 'preference',
+          content: prompt.substring(0, 200),
+          ttl: 30,
+        });
+      }
+    } catch { /* memory write failure is non-critical */ }
+  }
+
+  /**
+   * 事件驱动入口（P2 预留接口）
+   * @param {{ type: string, payload: object, source?: string }} event
+   */
+  async executeEvent(event) {
+    const { type, payload } = event;
+    const prompt = this.#eventToPrompt(type, payload);
+    return this.execute(prompt, { history: [] });
+  }
+
+  #eventToPrompt(type, payload) {
+    switch (type) {
+      case 'file_saved':
+        return `文件 ${payload.filePath} 刚被保存，变更了 ${payload.changedLines} 行。请分析是否有值得提取为 Recipe 的代码模式。如果有，说明原因；没有就说"无需操作"。`;
+      case 'candidate_backlog':
+        return `当前有 ${payload.count} 条候选积压（最早 ${payload.oldest}）。请按质量分类：哪些值得审核、哪些可以直接拒绝、哪些需要补充信息。`;
+      case 'scheduled_health':
+        return `请执行知识库健康检查：Recipe 覆盖率、过时标记、Guard 规则有效性。给出简要报告。`;
+      default:
+        return `事件: ${type}\n${JSON.stringify(payload)}`;
     }
   }
 

package/lib/service/chat/Memory.js

@@ -0,0 +1,104 @@
+/**
+ * Memory — 跨对话轻量记忆
+ *
+ * 设计:
+ * - JSONL 文件存储，每行一条记忆
+ * - 支持 TTL 自动过期
+ * - 上限 maxEntries，超出时截断旧条目
+ * - 读写均做静默降级（Memory 是增强，不是核心路径）
+ *
+ * 记忆类型:
+ * - preference: 用户偏好（"我们不用 singleton"、"以后用 DI"）
+ * - decision:   关键决策（"Network 模块审核通过"）
+ * - context:    项目上下文（"主语言是 Swift，使用 SPM"）
+ *
+ * 文件路径: .autosnippet/memory.jsonl
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+export class Memory {
+  #filePath;
+  #maxEntries;
+
+  /**
+   * @param {string} projectRoot — 用户项目根目录
+   * @param {object} [opts]
+   * @param {number} [opts.maxEntries=50] — 最大记忆条数
+   */
+  constructor(projectRoot, { maxEntries = 50 } = {}) {
+    this.#filePath = path.join(projectRoot, '.autosnippet', 'memory.jsonl');
+    this.#maxEntries = maxEntries;
+  }
+
+  /**
+   * 读取最近 N 条记忆，过滤过期项
+   * @param {number} [limit=20]
+   * @returns {{ ts: string, type: string, content: string, ttl?: number }[]}
+   */
+  load(limit = 20) {
+    try {
+      if (!fs.existsSync(this.#filePath)) return [];
+      const raw = fs.readFileSync(this.#filePath, 'utf-8').trim();
+      if (!raw) return [];
+      const lines = raw.split('\n').filter(Boolean);
+      const now = Date.now();
+      return lines
+        .map(l => { try { return JSON.parse(l); } catch { return null; } })
+        .filter(Boolean)
+        .filter(m => !m.ttl || (now - new Date(m.ts).getTime()) < m.ttl * 86400000)
+        .slice(-limit);
+    } catch {
+      return [];
+    }
+  }
+
+  /**
+   * 追加一条记忆
+   * @param {{ type: string, content: string, ttl?: number }} entry
+   */
+  append(entry) {
+    try {
+      const dir = path.dirname(this.#filePath);
+      fs.mkdirSync(dir, { recursive: true });
+      const line = JSON.stringify({ ts: new Date().toISOString(), ...entry });
+      fs.appendFileSync(this.#filePath, line + '\n', 'utf-8');
+      this.#compact();
+    } catch { /* write failure non-critical */ }
+  }
+
+  /**
+   * 生成供系统提示词的记忆摘要
+   * @returns {string}
+   */
+  toPromptSection() {
+    const memories = this.load();
+    if (memories.length === 0) return '';
+    const lines = memories.map(m => `- [${m.type}] ${m.content}`).join('\n');
+    return `\n## 历史记忆\n以下是之前对话中积累的项目偏好和决策，请参考：\n${lines}\n`;
+  }
+
+  /**
+   * 当前记忆条数
+   */
+  get size() {
+    return this.load(this.#maxEntries).length;
+  }
+
+  /**
+   * 超过 maxEntries 时截断旧条目
+   */
+  #compact() {
+    try {
+      const raw = fs.readFileSync(this.#filePath, 'utf-8').trim();
+      if (!raw) return;
+      const lines = raw.split('\n').filter(Boolean);
+      if (lines.length > this.#maxEntries) {
+        fs.writeFileSync(this.#filePath, lines.slice(-this.#maxEntries).join('\n') + '\n', 'utf-8');
+      }
+    } catch { /* ignore */ }
+  }
+}
+
+export default Memory;