@zooique/memora 0.1.0

package/dist/memory/vectorStore.js

@@ -0,0 +1,144 @@
+/**
+ * 向量存储 — 纯 JS 实现，内存 + JSON 持久化
+ *
+ * M-206：语义检索的向量索引层
+ * - 存储记忆 ID → 向量的映射
+ * - 支持余弦相似度搜索（topK）
+ * - 持久化到 JSON 文件（冷启动时加载）
+ *
+ * 设计原则：
+ * - 0 新 npm 依赖（不引入 sqlite-vec / LanceDB 等外部向量库）
+ * - 单用户本地场景，5k 条记录内纯 JS 余弦相似度 < 10ms
+ * - 向量维度由 embedding 模型决定，存储层不关心
+ *
+ * 详见 ADR-002 · 存储层抽象（向量检索备选方案）
+ * 详见 ADR-013 · 记忆归档三步价值过滤
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { logger } from '../logging/logger.js';
+import { cosineSimilarity } from '../utils/math.js';
+/**
+ * 向量存储
+ *
+ * 纯 JS 实现，内存中维护向量索引，定期持久化到 JSON 文件
+ * 适用于单用户本地场景（5k 条记录以内）
+ *
+ * 依赖 EmbeddingService 接口（依赖倒置，与 llm/ 层解耦）
+ */
+export class VectorStore {
+    storePath;
+    embeddingProvider;
+    /** 内存中的向量索引 */
+    entries = new Map();
+    /** 向量维度（由第一个插入的向量决定） */
+    dimension = 0;
+    /** 是否有未持久化的变更 */
+    dirty = false;
+    constructor(storePath, embeddingProvider) {
+        this.storePath = storePath;
+        this.embeddingProvider = embeddingProvider;
+    }
+    /**
+     * 从 JSON 文件加载向量索引（冷启动）
+     */
+    async load() {
+        try {
+            const content = await readFile(this.storePath, 'utf-8');
+            const data = JSON.parse(content);
+            this.dimension = data.dimension;
+            this.entries.clear();
+            for (const entry of data.entries) {
+                this.entries.set(entry.id, entry.vector);
+            }
+            this.dirty = false;
+            logger.info({ count: this.entries.size, dimension: this.dimension }, '向量索引加载完成');
+        }
+        catch {
+            // 文件不存在或格式错误，从空开始
+            logger.info({ path: this.storePath }, '向量索引文件不存在，从空开始');
+        }
+    }
+    /**
+     * 持久化向量索引到 JSON 文件
+     */
+    async save() {
+        if (!this.dirty)
+            return;
+        const data = {
+            version: 1,
+            dimension: this.dimension,
+            entries: Array.from(this.entries.entries()).map(([id, vector]) => ({ id, vector })),
+        };
+        await mkdir(dirname(this.storePath), { recursive: true });
+        await writeFile(this.storePath, JSON.stringify(data), 'utf-8');
+        this.dirty = false;
+        logger.info({ count: this.entries.size }, '向量索引持久化完成');
+    }
+    /**
+     * 为文本生成向量并存储
+     * @param id 记忆 ID
+     * @param text 待嵌入的文本
+     */
+    async upsert(id, text) {
+        const vector = await this.embeddingProvider.embed(text);
+        if (this.dimension === 0) {
+            this.dimension = vector.length;
+        }
+        this.entries.set(id, vector);
+        this.dirty = true;
+    }
+    /**
+     * 批量嵌入并存储
+     * @param items ID + 文本对
+     */
+    async batchUpsert(items) {
+        const texts = items.map((item) => item.text);
+        const results = await this.embeddingProvider.batchEmbed(texts);
+        for (let i = 0; i < items.length; i++) {
+            const result = results[i];
+            const item = items[i];
+            if (!result || !item)
+                continue;
+            if (this.dimension === 0) {
+                this.dimension = result.vector.length;
+            }
+            this.entries.set(item.id, result.vector);
+        }
+        this.dirty = true;
+    }
+    /**
+     * 删除向量
+     */
+    delete(id) {
+        this.entries.delete(id);
+        this.dirty = true;
+    }
+    /**
+     * 语义搜索：基于查询文本的向量，返回 topK 最相似的 ID
+     * @param query 查询文本
+     * @param topK 返回数量上限
+     * @param minSimilarity 最低相似度阈值（0~1）
+     * @returns ID + 相似度 对的数组，按相似度降序排列
+     */
+    async search(query, topK = 5, minSimilarity = 0.3) {
+        const queryVector = await this.embeddingProvider.embed(query);
+        const scored = [];
+        for (const [id, vector] of this.entries) {
+            const similarity = cosineSimilarity(queryVector, vector);
+            if (similarity >= minSimilarity) {
+                scored.push({ id, similarity });
+            }
+        }
+        // 按相似度降序排列，取 topK
+        scored.sort((a, b) => b.similarity - a.similarity);
+        return scored.slice(0, topK);
+    }
+    /**
+     * 获取存储的向量数量
+     */
+    get size() {
+        return this.entries.size;
+    }
+}
+//# sourceMappingURL=vectorStore.js.map

package/dist/memory/vectorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorStore.js","sourceRoot":"","sources":["../../src/memory/vectorStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAkCnD;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IAWH;IACA;IAXnB,eAAe;IACP,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE9C,wBAAwB;IAChB,SAAS,GAAG,CAAC,CAAC;IAEtB,iBAAiB;IACT,KAAK,GAAG,KAAK,CAAC;IAEtB,YACmB,SAAiB,EACjB,iBAAmC;QADnC,cAAS,GAAT,SAAS,CAAQ;QACjB,sBAAiB,GAAjB,iBAAiB,CAAkB;IACnD,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;YACpD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;YAClB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,MAAM,IAAI,GAAoB;YAC5B,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;SACpF,CAAC;QAEF,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAAY;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,KAA0C;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;gBAAE,SAAS;YAC/B,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,IAAI,GAAG,CAAC,EACR,aAAa,GAAG,GAAG;QAEnB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE9D,MAAM,MAAM,GAA8C,EAAE,CAAC;QAC7D,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACzD,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/persona/personaManager.d.ts

@@ -0,0 +1,121 @@
+import type { IMemoryStorage } from '../memory/storageInterface.js';
+import type { Persona, PersonaMode } from '../persona/types.js';
+/**
+ * 角色管理器（personas/ + SQLite + 关键词匹配）
+ */
+export declare class PersonaManager {
+    private readonly configDir?;
+    private readonly index?;
+    /** 当前激活的角色 */
+    private activePersona;
+    /** 角色列表缓存（启动时扫描一次） */
+    private personaList;
+    /** 激活模式 */
+    private mode;
+    /** 角色切换时间戳列表（用于时间窗口缓冲） */
+    private switchTimestamps;
+    /** 缓冲区开关（60s 内 3 次切换后锁定） */
+    private switchLocked;
+    /** 锁定恢复计时器 */
+    private unlockTimer;
+    /** 时间窗口：60 秒 */
+    private static readonly SWITCH_WINDOW_MS;
+    /** 窗口内最大切换次数 */
+    private static readonly MAX_SWITCHES_IN_WINDOW;
+    /** 锁定后自动恢复时间：5 分钟 */
+    private static readonly AUTO_UNLOCK_MS;
+    /**
+     * @param configDir 配置目录（角色文件在 <configDir>/personas/ 下）
+     * @param index SQLite 索引（用于写入 persona 记忆）
+     */
+    constructor(configDir?: string | undefined, index?: IMemoryStorage | undefined);
+    /**
+     * 启动时加载：扫描目录 + 激活指定角色 + 写入 SQLite
+     *
+     * @param activePersona 要激活的角色名（可选，不传则使用第一个找到的角色）
+     * @returns 激活角色的 system prompt 段
+     */
+    load(activePersona?: string): Promise<string>;
+    /**
+     * 获取当前激活的角色名（用于 bootstrap 过滤）
+     */
+    get activeName(): string;
+    /**
+     * 获取当前激活角色对象（Phase 2.1：AffectController 需要 traits 字段）
+     *
+     * 返回 null 时表示未加载任何角色（使用默认行为）。
+     */
+    getActive(): Persona | null;
+    /**
+     * 切换角色（带时间窗口缓冲）
+     *
+     * 错误策略统一（IX-03）：角色不存在时抛 MemoraError，与 switchProject 一致。
+     * 交换锁定时仍返回当前 prompt（非错误，是限流保护）。
+     *
+     * @param name 角色名
+     * @returns 新角色的 system prompt 段
+     * @throws MemoraError 如果角色不存在
+     */
+    switchPersona(name: string): string;
+    /**
+     * 根据用户输入自动匹配最合适的角色
+     *
+     * 匹配条件：
+     *   - 当前模式为 'auto'（非手动锁定）
+     *   - 缓冲区未锁定
+     *   - 匹配得分 ≥ 0.5
+     *   - 匹配的角色与当前角色不同
+     *
+     * @param userInput 用户输入文本
+     * @returns 匹配的角色名，无匹配返回 null
+     */
+    autoMatch(userInput: string): string | null;
+    /**
+     * 设置激活模式
+     *
+     * @param mode 'auto'（自动匹配）| 'manual'（手动固定）
+     */
+    setMode(mode: PersonaMode): void;
+    /** 获取当前激活模式 */
+    get currentMode(): PersonaMode;
+    /**
+     * 获取当前激活的角色
+     */
+    get active(): Persona | null;
+    /**
+     * 获取角色列表
+     */
+    get list(): Persona[];
+    /**
+     * 清理定时器资源（Agent.close() 时调用）
+     *
+     * PersonaManager 持有 unlockTimer（角色切换防抖锁的自动恢复计时器），
+     * 若不清理，Agent 关闭后定时器仍会触发回调，在已关闭的实例上执行引发异常。
+     */
+    close(): void;
+    /**
+     * 构建 system prompt 中的角色段
+     */
+    buildSystemPrompt(name?: string): string;
+    /**
+     * 记录一次角色切换（时间窗口缓冲）
+     */
+    private recordSwitch;
+    /**
+     * 扫描单层目录，加载角色列表
+     */
+    private scanPersonas;
+    /**
+     * 将所有角色写入 SQLite 索引
+     */
+    private writeAllToIndex;
+    /**
+     * 将单个角色写入 SQLite 索引
+     */
+    private writePersonaToIndex;
+    /**
+     * 创建默认角色
+     */
+    private createDefaultPersona;
+}
+//# sourceMappingURL=personaManager.d.ts.map

package/dist/persona/personaManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personaManager.d.ts","sourceRoot":"","sources":["../../src/persona/personaManager.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA4B/D;;GAEG;AACH,qBAAa,cAAc;IA0BvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IA1BzB,cAAc;IACd,OAAO,CAAC,aAAa,CAAwB;IAC7C,sBAAsB;IACtB,OAAO,CAAC,WAAW,CAAiB;IACpC,WAAW;IACX,OAAO,CAAC,IAAI,CAAuB;IACnC,0BAA0B;IAC1B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,4BAA4B;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,cAAc;IACd,OAAO,CAAC,WAAW,CAA8C;IAEjE,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAK;IACnD,qBAAqB;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAW;IAEjD;;;OAGG;gBAEgB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,KAAK,CAAC,EAAE,cAAc,YAAA;IAGzC;;;;;OAKG;IACG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqCnD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;OAIG;IACH,SAAS,IAAI,OAAO,GAAG,IAAI;IAI3B;;;;;;;;;OASG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAyBnC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA8B3C;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAUhC,eAAe;IACf,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,GAAG,IAAI,CAE3B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,EAAE,CAEpB;IAED;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAUxC;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;YACW,YAAY;IAyB1B;;OAEG;YACW,eAAe;IAQ7B;;OAEG;YACW,mBAAmB;IAejC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAU7B"}

package/dist/persona/personaManager.js

@@ -0,0 +1,349 @@
+/**
+ * 角色管理器 — 加载、切换、注入角色人格（personas/ 目录 + SQLite 存储）
+ *
+ * 职责：
+ *   - 从 configDir/personas/*.md 加载角色文件
+ *   - 解析 frontmatter（name / keywords / description）
+ *   - 写入 SQLite 索引（source: persona, score: 1.0）
+ *   - 将激活角色注入到 system prompt 顶部
+ *   - 支持运行时切换角色 + 关键词自动匹配
+ *
+ * 设计原则（architecture_philosophy_rules.md §1）：
+ *   - Persona 遵循"万物皆记忆"——存入 SQLite 作为 persona 来源记忆
+ *   - 召回管线做特殊处理：bootstrap 只取当前激活角色的 1 条 persona 记忆
+ *   - 角色可被会话关键词动态匹配自动切换，也可手动指定
+ *
+ * 目录约定：
+ *   - 单层角色：只有宿主程序级 <configDir>/personas/*.md
+ *   - 目录名 personas/ 与代码 Persona 术语一致，区别于用户身份信息
+ */
+import { scoreByKeywords } from '../utils/segmenter.js';
+import { SOURCE_LABELS } from '../memory/types.js';
+import { logger } from '../logging/logger.js';
+import { configError } from '../utils/errors.js';
+import { scanMarkdownDir, parseKeywords, resolveSubdir } from '../utils/scanner.js';
+import { safeSetTimeout, clearSafeTimeout } from '../utils/safeTimer.js';
+/**
+ * 从 frontmatter 解析 traits.* 键值对
+ *
+ * 遍历 frontmatter 中以 "traits." 开头的键，提取数值。
+ * 非数值或超出 0-1 范围的值被静默忽略（防御性解析）。
+ *
+ * @param fm frontmatter 键值对映射
+ * @returns traits 对象，无有效键时返回 undefined
+ */
+function parseTraits(fm) {
+    const traits = {};
+    for (const [key, value] of Object.entries(fm)) {
+        if (!key.startsWith('traits.'))
+            continue;
+        const traitName = key.slice(7); // 去掉 'traits.' 前缀
+        if (!traitName)
+            continue;
+        const num = Number(value);
+        // 防御性校验：必须是有效数值且在 0-1 范围内
+        if (Number.isFinite(num) && num >= 0 && num <= 1) {
+            traits[traitName] = num;
+        }
+    }
+    return Object.keys(traits).length > 0 ? traits : undefined;
+}
+/**
+ * 角色管理器（personas/ + SQLite + 关键词匹配）
+ */
+export class PersonaManager {
+    configDir;
+    index;
+    /** 当前激活的角色 */
+    activePersona = null;
+    /** 角色列表缓存（启动时扫描一次） */
+    personaList = [];
+    /** 激活模式 */
+    mode = 'auto';
+    /** 角色切换时间戳列表（用于时间窗口缓冲） */
+    switchTimestamps = [];
+    /** 缓冲区开关（60s 内 3 次切换后锁定） */
+    switchLocked = false;
+    /** 锁定恢复计时器 */
+    unlockTimer = null;
+    /** 时间窗口：60 秒 */
+    static SWITCH_WINDOW_MS = 60_000;
+    /** 窗口内最大切换次数 */
+    static MAX_SWITCHES_IN_WINDOW = 3;
+    /** 锁定后自动恢复时间：5 分钟 */
+    static AUTO_UNLOCK_MS = 300_000;
+    /**
+     * @param configDir 配置目录（角色文件在 <configDir>/personas/ 下）
+     * @param index SQLite 索引（用于写入 persona 记忆）
+     */
+    constructor(configDir, index) {
+        this.configDir = configDir;
+        this.index = index;
+    }
+    /**
+     * 启动时加载：扫描目录 + 激活指定角色 + 写入 SQLite
+     *
+     * @param activePersona 要激活的角色名（可选，不传则使用第一个找到的角色）
+     * @returns 激活角色的 system prompt 段
+     */
+    async load(activePersona) {
+        this.personaList = await this.scanPersonas();
+        if (this.personaList.length === 0) {
+            logger.warn({ personaCount: 0 }, '未找到任何角色文件，将使用默认角色');
+            this.activePersona = this.createDefaultPersona();
+            await this.writePersonaToIndex(this.activePersona);
+            return this.buildSystemPrompt();
+        }
+        logger.info({ count: this.personaList.length, names: this.personaList.map((p) => p.name) }, '角色文件加载完成');
+        // 写入 SQLite 索引（persona 遵循万物皆记忆）
+        await this.writeAllToIndex();
+        // 激活指定角色
+        if (activePersona) {
+            const found = this.personaList.find((p) => p.name === activePersona);
+            if (found) {
+                this.activePersona = found;
+            }
+            else {
+                logger.warn({ requested: activePersona }, '未找到指定角色，使用第一个');
+                // QC-17 移除非空断言：personaList 已在第 72 行检查非空
+                this.activePersona = this.personaList[0] ?? this.createDefaultPersona();
+            }
+        }
+        else {
+            // QC-17 移除非空断言：personaList 已在第 72 行检查非空
+            this.activePersona = this.personaList[0] ?? this.createDefaultPersona();
+        }
+        logger.info({ persona: this.activePersona.name }, '角色已激活');
+        return this.buildSystemPrompt();
+    }
+    /**
+     * 获取当前激活的角色名（用于 bootstrap 过滤）
+     */
+    get activeName() {
+        return this.activePersona?.name ?? 'default';
+    }
+    /**
+     * 获取当前激活角色对象（Phase 2.1：AffectController 需要 traits 字段）
+     *
+     * 返回 null 时表示未加载任何角色（使用默认行为）。
+     */
+    getActive() {
+        return this.activePersona;
+    }
+    /**
+     * 切换角色（带时间窗口缓冲）
+     *
+     * 错误策略统一（IX-03）：角色不存在时抛 MemoraError，与 switchProject 一致。
+     * 交换锁定时仍返回当前 prompt（非错误，是限流保护）。
+     *
+     * @param name 角色名
+     * @returns 新角色的 system prompt 段
+     * @throws MemoraError 如果角色不存在
+     */
+    switchPersona(name) {
+        // 缓冲区检查（限流保护，非错误）
+        if (this.switchLocked) {
+            logger.info({ persona: name }, '角色切换已锁定（60s 内超过 3 次），保持当前');
+            return this.buildSystemPrompt();
+        }
+        const found = this.personaList.find((p) => p.name === name);
+        if (!found) {
+            // 统一错误策略：找不到目标时抛错，而非静默保持当前
+            throw configError('角色切换失败', `角色 "${name}" 不存在`, [
+                '使用 persona.list 查看可用角色',
+                '在 agent-config/personas/ 目录下创建该角色配置文件',
+            ]);
+        }
+        if (this.activePersona?.name === name) {
+            return this.buildSystemPrompt(); // 同一角色，不需要切换
+        }
+        this.activePersona = found;
+        this.recordSwitch();
+        logger.info({ persona: name }, '角色已切换');
+        return this.buildSystemPrompt();
+    }
+    /**
+     * 根据用户输入自动匹配最合适的角色
+     *
+     * 匹配条件：
+     *   - 当前模式为 'auto'（非手动锁定）
+     *   - 缓冲区未锁定
+     *   - 匹配得分 ≥ 0.5
+     *   - 匹配的角色与当前角色不同
+     *
+     * @param userInput 用户输入文本
+     * @returns 匹配的角色名，无匹配返回 null
+     */
+    autoMatch(userInput) {
+        if (this.mode !== 'auto')
+            return null;
+        if (this.switchLocked)
+            return null;
+        if (this.personaList.length === 0)
+            return null;
+        const matches = [];
+        for (const persona of this.personaList) {
+            if (persona.keywords.length === 0)
+                continue;
+            const score = scoreByKeywords(userInput, persona.keywords);
+            if (score > 0) {
+                matches.push({ name: persona.name, score });
+            }
+        }
+        if (matches.length === 0)
+            return null;
+        matches.sort((a, b) => b.score - a.score);
+        // QC-17 移除非空断言：matches 已在第 174 行检查非空
+        const best = matches[0];
+        if (!best)
+            return null;
+        if (best.score < 0.5)
+            return null;
+        if (this.activePersona?.name === best.name)
+            return null;
+        return best.name;
+    }
+    /**
+     * 设置激活模式
+     *
+     * @param mode 'auto'（自动匹配）| 'manual'（手动固定）
+     */
+    setMode(mode) {
+        this.mode = mode;
+        // 切回自动模式时清除锁定状态
+        if (mode === 'auto' && this.switchLocked) {
+            this.switchLocked = false;
+            this.switchTimestamps = [];
+            logger.info({ mode: this.mode }, '角色切换锁定已解除（模式切回自动）');
+        }
+    }
+    /** 获取当前激活模式 */
+    get currentMode() {
+        return this.mode;
+    }
+    /**
+     * 获取当前激活的角色
+     */
+    get active() {
+        return this.activePersona;
+    }
+    /**
+     * 获取角色列表
+     */
+    get list() {
+        return this.personaList;
+    }
+    /**
+     * 清理定时器资源（Agent.close() 时调用）
+     *
+     * PersonaManager 持有 unlockTimer（角色切换防抖锁的自动恢复计时器），
+     * 若不清理，Agent 关闭后定时器仍会触发回调，在已关闭的实例上执行引发异常。
+     */
+    close() {
+        if (this.unlockTimer) {
+            clearSafeTimeout(this.unlockTimer);
+            this.unlockTimer = null;
+        }
+    }
+    /**
+     * 构建 system prompt 中的角色段
+     */
+    buildSystemPrompt(name) {
+        const p = name ? this.personaList.find((item) => item.name === name) : this.activePersona;
+        if (!p)
+            return '';
+        const meta = [`【当前角色】${p.name}`];
+        if (p.description)
+            meta.push(p.description);
+        return `${meta.join(' · ')}\n\n${p.content}`;
+    }
+    // ── 私有方法 ──────────────────────────────────────
+    /**
+     * 记录一次角色切换（时间窗口缓冲）
+     */
+    recordSwitch() {
+        const now = Date.now();
+        // 清理过期记录
+        this.switchTimestamps = this.switchTimestamps.filter((t) => now - t < PersonaManager.SWITCH_WINDOW_MS);
+        this.switchTimestamps.push(now);
+        if (this.switchTimestamps.length >= PersonaManager.MAX_SWITCHES_IN_WINDOW) {
+            logger.warn({ count: this.switchTimestamps.length }, '角色切换过于频繁，锁定 5 分钟');
+            this.switchLocked = true;
+            // 5 分钟后自动解锁
+            if (this.unlockTimer)
+                clearSafeTimeout(this.unlockTimer);
+            this.unlockTimer = safeSetTimeout(() => {
+                this.switchLocked = false;
+                this.switchTimestamps = [];
+                logger.info({ mode: this.mode }, '角色切换锁定已自动解除');
+            }, PersonaManager.AUTO_UNLOCK_MS);
+        }
+    }
+    /**
+     * 扫描单层目录，加载角色列表
+     */
+    async scanPersonas() {
+        const list = [];
+        const personasDir = resolveSubdir(this.configDir, 'personas');
+        if (!personasDir)
+            return list;
+        const entries = await scanMarkdownDir(personasDir);
+        for (const entry of entries) {
+            const fm = entry.frontmatter;
+            list.push({
+                name: entry.name,
+                id: fm['id'] ?? `persona:${entry.name}`,
+                description: fm['description'],
+                keywords: parseKeywords(fm),
+                content: entry.body.trim(),
+                filePath: entry.filePath,
+                // Phase 2.1：解析 traits.* 键值对（如 traits.playfulness: 0.7）
+                traits: parseTraits(fm),
+            });
+        }
+        return list;
+    }
+    /**
+     * 将所有角色写入 SQLite 索引
+     */
+    async writeAllToIndex() {
+        if (!this.index)
+            return;
+        for (const persona of this.personaList) {
+            await this.writePersonaToIndex(persona);
+        }
+        logger.info({ count: this.personaList.length }, '角色记忆已写入 SQLite');
+    }
+    /**
+     * 将单个角色写入 SQLite 索引
+     */
+    async writePersonaToIndex(persona) {
+        if (!this.index)
+            return;
+        const now = new Date().toISOString();
+        const memory = {
+            id: persona.id,
+            content: persona.content,
+            source: SOURCE_LABELS.PERSONA,
+            name: persona.name,
+            createdAt: now,
+            accessedAt: now,
+            score: 1.0,
+        };
+        this.index.upsert(memory);
+    }
+    /**
+     * 创建默认角色
+     */
+    createDefaultPersona() {
+        return {
+            name: 'default',
+            id: 'persona:default',
+            description: '默认通用助手',
+            keywords: [],
+            content: '你是一个通用 AI 助手，以专业、友好的态度回应用户。',
+            filePath: '(built-in)',
+        };
+    }
+}
+//# sourceMappingURL=personaManager.js.map

package/dist/persona/personaManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personaManager.js","sourceRoot":"","sources":["../../src/persona/personaManager.ts"],"names":[],"mappings":"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"}

package/dist/persona/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 角色模块类型定义
+ */
+/** 角色定义（从 personas/*.md frontmatter 解析） */
+export interface Persona {
+    /** 角色名（文件名去 .md） */
+    name: string;
+    /** 唯一 id（用于 SQLite 索引） */
+    id: string;
+    /** 角色描述（可选） */
+    description?: string;
+    /** 关键词（用于自动匹配切换） */
+    keywords: string[];
+    /** 人格正文（frontmatter 之后的 markdown 内容） */
+    content: string;
+    /** 来源路径 */
+    filePath: string;
+    /**
+     * 角色特质（Phase 2.1：AffectController 情感基调推导）
+     *
+     * 开放字符串键值对，非封闭枚举。预设键：
+     * - playfulness: 调皮度 0-1（默认 0.3）
+     * - warmth: 温暖度 0-1（默认 0.5）
+     * - directness: 直接度 0-1（默认 0.5）
+     *
+     * 宿主可自由扩展。从 persona .md 的 frontmatter 解析（如 traits.playfulness: 0.7）。
+     */
+    traits?: Record<string, number>;
+}
+/** 角色激活模式 */
+export type PersonaMode = 'auto' | 'manual';
+//# sourceMappingURL=types.d.ts.map

package/dist/persona/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persona/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,OAAO;IACtB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,aAAa;AACb,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC"}