dsh-tavern-bundle 0.1.0

package/lib/application/group-chat/group-chat-orchestrator.js.map

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

package/lib/application/memory/memory-retriever.d.ts

@@ -0,0 +1,37 @@
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { MemoryCategory, MemoryEntry } from '../../domain/schemas.js';
+export interface MemoryQuery {
+    readonly characterId: string;
+    /** 本轮用户消息；空查询时相关项退化为 salience/recency 排序。 */
+    readonly query?: string;
+    readonly sceneId?: string;
+    readonly instanceId?: string;
+    readonly ownerUserId?: string;
+    readonly category?: MemoryCategory;
+    readonly limit?: number;
+    readonly minConfidence?: number;
+    readonly updateAccess?: boolean;
+}
+export interface MemoryHit {
+    readonly memory: MemoryEntry;
+    readonly score: number;
+    readonly relevance: number;
+    readonly recency: number;
+    readonly reasons: readonly string[];
+}
+/** 关键词相关性：完整 query 命中得 1；否则按非字母数字 token 的命中比例。 */
+export declare function relevanceScore(fact: string, query: string): number;
+/** 时间衰减：updatedAt 距 now 的天数，越大越旧，得分趋近 0。 */
+export declare function recencyScore(updatedAt: string, now?: Date): number;
+export declare function scoreMemory(memory: MemoryEntry, query: string, now?: Date): {
+    readonly score: number;
+    readonly relevance: number;
+    readonly recency: number;
+    readonly reasons: readonly string[];
+};
+export declare class MemoryRetriever {
+    #private;
+    constructor(memories: KvTable<string, MemoryEntry>);
+    retrieve(query: MemoryQuery): Promise<MemoryHit[]>;
+}
+//# sourceMappingURL=memory-retriever.d.ts.map

package/lib/application/memory/memory-retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retriever.d.ts","sourceRoot":"","sources":["../../../src/application/memory/memory-retriever.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAMD,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAKlE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC,CAMA;AAED,qBAAa,eAAe;;gBAGd,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC;IAI5C,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAuCzD"}

package/lib/application/memory/memory-retriever.js

@@ -0,0 +1,91 @@
+const DEFAULT_MIN_CONFIDENCE = 0.3;
+const DEFAULT_LIMIT = 5;
+const CATEGORY_QUOTA = { player: 2, world: 2, npc: 2, general: 2, 'shared-experience': 3, 'relationship-milestone': 2 };
+/** 关键词相关性：完整 query 命中得 1；否则按非字母数字 token 的命中比例。 */
+export function relevanceScore(fact, query) {
+    const q = query.trim().toLocaleLowerCase();
+    if (q === '')
+        return 0;
+    const f = fact.toLocaleLowerCase();
+    if (f.includes(q))
+        return 1;
+    const tokens = q.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+    if (tokens.length === 0)
+        return 0;
+    let hits = 0;
+    for (const token of tokens)
+        if (f.includes(token))
+            hits += 1;
+    return hits / tokens.length;
+}
+/** 时间衰减：updatedAt 距 now 的天数，越大越旧，得分趋近 0。 */
+export function recencyScore(updatedAt, now) {
+    const updated = Date.parse(updatedAt);
+    if (!Number.isFinite(updated))
+        return 0;
+    const ageDays = Math.max(0, (now?.getTime() ?? Date.now()) - updated) / 86_400_000;
+    return 1 / (1 + ageDays);
+}
+export function scoreMemory(memory, query, now) {
+    const relevance = relevanceScore(memory.fact, query);
+    const recency = recencyScore(memory.updatedAt, now);
+    const salience = memory.salience;
+    const score = relevance * 0.5 + salience * 0.3 + recency * 0.2;
+    return { score, relevance, recency, reasons: [`rel=${relevance.toFixed(2)}`, `sal=${salience.toFixed(2)}`, `rec=${recency.toFixed(2)}`] };
+}
+export class MemoryRetriever {
+    #memories;
+    constructor(memories) {
+        this.#memories = memories;
+    }
+    async retrieve(query) {
+        const limit = query.limit ?? DEFAULT_LIMIT;
+        const minConfidence = query.minConfidence ?? DEFAULT_MIN_CONFIDENCE;
+        const text = query.query ?? '';
+        const hits = [];
+        for (const [, memory] of this.#memories.entries()) {
+            if (memory.characterId !== query.characterId)
+                continue;
+            if (memory.status !== 'active')
+                continue;
+            // 伙伴升格记忆属于个人 Agent 关系，不进入普通角色卡聊天上下文。
+            if (memory.sourceEventId?.startsWith('promotion:'))
+                continue;
+            if (query.sceneId !== undefined && memory.sceneId !== query.sceneId)
+                continue;
+            if (query.instanceId !== undefined && memory.instanceId !== query.instanceId)
+                continue;
+            if (query.category !== undefined && memory.category !== query.category)
+                continue;
+            if (query.ownerUserId !== undefined && memory.ownerUserId !== query.ownerUserId)
+                continue;
+            if (memory.confidence < minConfidence)
+                continue;
+            const scored = scoreMemory(memory, text);
+            hits.push({ memory, score: scored.score, relevance: scored.relevance, recency: scored.recency, reasons: scored.reasons });
+        }
+        hits.sort((a, b) => (b.score - a.score)
+            || (b.memory.salience - a.memory.salience)
+            || (a.memory.updatedAt < b.memory.updatedAt ? 1 : a.memory.updatedAt > b.memory.updatedAt ? -1 : 0)
+            || (a.memory.id < b.memory.id ? -1 : a.memory.id > b.memory.id ? 1 : 0));
+        const selected = [];
+        const quota = {};
+        for (const hit of hits) {
+            if (selected.length >= limit)
+                break;
+            const used = quota[hit.memory.category] ?? 0;
+            if (used >= CATEGORY_QUOTA[hit.memory.category])
+                continue;
+            quota[hit.memory.category] = used + 1;
+            selected.push(hit);
+        }
+        if (query.updateAccess === true && selected.length > 0) {
+            const accessedAt = new Date().toISOString();
+            for (const hit of selected) {
+                await this.#memories.put(hit.memory.id, { ...hit.memory, lastAccessedAt: accessedAt });
+            }
+        }
+        return selected;
+    }
+}
+//# sourceMappingURL=memory-retriever.js.map

package/lib/application/memory/memory-retriever.js.map

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

package/lib/application/memory/memory-service.d.ts

@@ -0,0 +1,128 @@
+/**
+ * MemoryService —— 独立记忆系统（阶段 5.2）。
+ *
+ * 数据模型（memories 表）：characterId 必填（跨角色隔离）；来源可追溯
+ * （source + sourceEventId）；更正不删历史（supersedes 标记）；遗忘标记
+ * forgotten。
+ *
+ * 约束（产品文档 §5.2）：
+ * - 模型不得自行写入记忆：只有通过 remember 工具（或明确来源的系统/
+ *   user/game-rule 调用方）才能写入；
+ * - 记忆不跨角色混淆：characterId 是必填字段；
+ * - 召回按 salience 排序（重要记忆优先），tie-break 最新优先。
+ *
+ * 关系图谱联动（由调用方提供 userNodeId 触发；character-instance 节点在
+ * summon 时由 orchestrator 登记）：
+ * - remember 写入新记忆 → familiarity +1（上限 100）；
+ * - remember 携带 category='player'（用户信任声明）→ trust +5；
+ * - supersede 更正同一事实 → trust +1；
+ * - recall 命中 → familiarity +0.5（每轮）。
+ * ContextAssembler 的检索路径暂不传 userNodeId（无用户上下文），联动留待
+ * 后续子阶段在投递链路接入。
+ */
+import type { KvTable } from '@deepseek-ai/dsh-storage-domain';
+import type { MemoryCategory, MemoryEntry, MemorySource } from '../../domain/schemas.js';
+import type { AuditService } from '../../core/audit-service.js';
+import { RelationshipService } from '../relationship/relationship-service.js';
+import type { RelationshipEventService } from '../relationship/relationship-event-service.js';
+import type { RelationshipProjection } from '../relationship/relationship-projection.js';
+export declare const DEFAULT_MEMORY_LIMIT = 5;
+export declare const DEFAULT_MIN_CONFIDENCE = 0.3;
+export declare const DEFAULT_CONFIDENCE = 0.8;
+export declare const DEFAULT_SALIENCE = 0.5;
+/** 关系值上限（0-100 语义约定）。 */
+export declare const MAX_RELATIONSHIP_VALUE = 100;
+/** 关系联动规则（单位 delta）。 */
+export declare const FAMILIARITY_PER_REMEMBER = 1;
+export declare const FAMILIARITY_PER_RECALL_HIT = 0.5;
+export declare const TRUST_PER_PLAYER_DECLARATION = 5;
+export declare const TRUST_PER_SUPERSEDE = 1;
+export interface RememberParams {
+    readonly characterId: string;
+    readonly instanceId?: string;
+    readonly sceneId?: string;
+    /** 幂等键：同 id 更新（不新建）。缺省生成新 id。 */
+    readonly id?: string;
+    readonly fact: string;
+    readonly category?: MemoryCategory;
+    readonly source?: MemorySource;
+    /** 稳定用户与消息证据仅由受信调用方提供（阶段 3）。 */
+    readonly ownerUserId?: string;
+    readonly sourceMessageIds?: readonly string[];
+    readonly candidateId?: string;
+    readonly sourceEventId?: string;
+    readonly confidence?: number;
+    readonly salience?: number;
+    /** 联动：提供时 familiarity +1；category='player' 额外 trust +5。 */
+    readonly userNodeId?: string;
+}
+export interface RecallParams {
+    readonly characterId: string;
+    readonly instanceId?: string;
+    readonly sceneId?: string;
+    /** 在 fact 中模糊匹配（大小写不敏感）。 */
+    readonly keyword?: string;
+    readonly category?: MemoryCategory;
+    readonly limit?: number;
+    readonly minConfidence?: number;
+    /** 联动：命中时 familiarity +0.5。 */
+    readonly userNodeId?: string;
+    /** 是否更新命中记忆的 lastAccessedAt（默认 true）。 */
+    readonly updateAccess?: boolean;
+}
+export interface SupersedeParams {
+    readonly oldId: string;
+    readonly newFact: string;
+    readonly category?: MemoryCategory;
+    readonly source?: MemorySource;
+    readonly sourceEventId?: string;
+    readonly confidence?: number;
+    readonly salience?: number;
+    /** 联动：更正后 trust +1。 */
+    readonly userNodeId?: string;
+}
+export declare class MemoryService {
+    #private;
+    constructor(memoryTable: KvTable<string, MemoryEntry>, _relationshipService: RelationshipService, audit: AuditService, events?: RelationshipEventService, projection?: RelationshipProjection);
+    /** 读一条记忆；不存在返回 null。 */
+    get(memoryId: string): MemoryEntry | null;
+    /**
+     * 写入记忆（幂等：同 id 更新）。写入后按规则联动关系图谱
+     * （提供 userNodeId 时：familiarity +1；category='player' 额外 trust +5）。
+     */
+    remember(params: RememberParams): Promise<MemoryEntry>;
+    /**
+     * 检索记忆：按 characterId（必填）+ 可选 instanceId/sceneId/category/
+     * keyword/minConfidence 过滤，salience DESC → updatedAt DESC 排序，
+     * 取 limit 条（默认 5）。命中时更新 lastAccessedAt（updateAccess=true），
+     * 提供 userNodeId 时联动 familiarity +0.5。
+     */
+    recall(params: RecallParams): Promise<MemoryEntry[]>;
+    /**
+     * 更正记忆：旧记忆标记 superseded（不删除，保留审计链路），创建新记忆
+     * （supersedes 指向旧 id）。提供 userNodeId 时联动 trust +1。
+     */
+    supersede(params: SupersedeParams): Promise<MemoryEntry>;
+    /**
+     * 标记正式记忆的聊天证据已失效。用户已经审阅接受的内容不会被自动删除，
+     * 但后续 UI/检索策略可据此提示或降权；重复标记不产生额外审计。
+     */
+    markEvidenceInvalidated(memoryId: string): Promise<MemoryEntry | null>;
+    /** 遗忘记忆：标记 forgotten（幂等；不存在或已非 active 时不写）。记录审计。 */
+    forget(memoryId: string): Promise<void>;
+    /** 遗忘某个来源事件下的全部 active 记忆；返回处理条数。 */
+    forgetBySourceEvent(sourceEventId: string, characterId?: string): Promise<number>;
+    /** 遗忘 sourceEventId 以指定前缀开头的全部 active 记忆；返回处理条数。 */
+    forgetBySourceEventPrefix(prefix: string, characterId?: string): Promise<number>;
+    /** 指定角色（可再按场景）的全部 active 记忆；供候选冲突检测等只读扫描使用。 */
+    listActiveByCharacter(characterId: string, sceneId?: string): MemoryEntry[];
+    /**
+     * 场景内全部记忆（UI 数据面；含 superseded/forgotten 历史）。
+     * filter 支持 category / status；salience DESC → updatedAt DESC 排序。
+     */
+    listByScene(sceneId: string, filter?: {
+        category?: MemoryCategory;
+        status?: 'active' | 'superseded' | 'forgotten';
+    }): Promise<MemoryEntry[]>;
+}
+//# sourceMappingURL=memory-service.d.ts.map

package/lib/application/memory/memory-service.d.ts.map

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

package/lib/application/memory/memory-service.js

@@ -0,0 +1,346 @@
+/**
+ * MemoryService —— 独立记忆系统（阶段 5.2）。
+ *
+ * 数据模型（memories 表）：characterId 必填（跨角色隔离）；来源可追溯
+ * （source + sourceEventId）；更正不删历史（supersedes 标记）；遗忘标记
+ * forgotten。
+ *
+ * 约束（产品文档 §5.2）：
+ * - 模型不得自行写入记忆：只有通过 remember 工具（或明确来源的系统/
+ *   user/game-rule 调用方）才能写入；
+ * - 记忆不跨角色混淆：characterId 是必填字段；
+ * - 召回按 salience 排序（重要记忆优先），tie-break 最新优先。
+ *
+ * 关系图谱联动（由调用方提供 userNodeId 触发；character-instance 节点在
+ * summon 时由 orchestrator 登记）：
+ * - remember 写入新记忆 → familiarity +1（上限 100）；
+ * - remember 携带 category='player'（用户信任声明）→ trust +5；
+ * - supersede 更正同一事实 → trust +1；
+ * - recall 命中 → familiarity +0.5（每轮）。
+ * ContextAssembler 的检索路径暂不传 userNodeId（无用户上下文），联动留待
+ * 后续子阶段在投递链路接入。
+ */
+import { randomUUID } from 'node:crypto';
+import { RelationshipService } from '../relationship/relationship-service.js';
+export const DEFAULT_MEMORY_LIMIT = 5;
+export const DEFAULT_MIN_CONFIDENCE = 0.3;
+export const DEFAULT_CONFIDENCE = 0.8;
+export const DEFAULT_SALIENCE = 0.5;
+/** 关系值上限（0-100 语义约定）。 */
+export const MAX_RELATIONSHIP_VALUE = 100;
+/** 关系联动规则（单位 delta）。 */
+export const FAMILIARITY_PER_REMEMBER = 1;
+export const FAMILIARITY_PER_RECALL_HIT = 0.5;
+export const TRUST_PER_PLAYER_DECLARATION = 5;
+export const TRUST_PER_SUPERSEDE = 1;
+function clamp01(value) {
+    return Math.min(1, Math.max(0, value));
+}
+export class MemoryService {
+    #memories;
+    #audit;
+    #events;
+    #projection;
+    constructor(memoryTable, _relationshipService, audit, events, projection) {
+        this.#memories = memoryTable;
+        this.#audit = audit;
+        this.#events = events;
+        this.#projection = projection;
+    }
+    /** 读一条记忆；不存在返回 null。 */
+    get(memoryId) {
+        return this.#memories.get(memoryId) ?? null;
+    }
+    /** 记忆关键字段快照（审计用）。 */
+    #snapshotOf(memory) {
+        return {
+            id: memory.id,
+            characterId: memory.characterId,
+            fact: memory.fact,
+            category: memory.category,
+            status: memory.status,
+            ...(memory.sceneId === undefined ? {} : { sceneId: memory.sceneId }),
+            ...(memory.supersedes === undefined ? {} : { supersedes: memory.supersedes }),
+        };
+    }
+    /** 内部纯写入（幂等：同 id 更新，保留 characterId/createdAt）。返回是否新建与更新前状态。 */
+    async #write(params) {
+        const now = new Date().toISOString();
+        const existing = this.#memories.get(params.id);
+        if (existing !== undefined) {
+            const updated = {
+                ...existing,
+                fact: params.fact,
+                category: params.category ?? existing.category,
+                source: params.source ?? existing.source,
+                ...(params.ownerUserId === undefined ? {} : { ownerUserId: params.ownerUserId }),
+                ...(params.sourceMessageIds === undefined ? {} : { sourceMessageIds: [...params.sourceMessageIds] }),
+                ...(params.candidateId === undefined ? {} : { candidateId: params.candidateId }),
+                ...(params.sourceEventId === undefined ? {} : { sourceEventId: params.sourceEventId }),
+                confidence: clamp01(params.confidence ?? existing.confidence),
+                salience: clamp01(params.salience ?? existing.salience),
+                updatedAt: now,
+            };
+            await this.#memories.put(params.id, updated);
+            return { entry: updated, created: false, previous: existing };
+        }
+        const entry = {
+            id: params.id,
+            characterId: params.characterId,
+            ...(params.instanceId === undefined ? {} : { instanceId: params.instanceId }),
+            ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }),
+            fact: params.fact,
+            category: params.category ?? 'general',
+            status: 'active',
+            ...(params.supersedes === undefined ? {} : { supersedes: params.supersedes }),
+            source: params.source ?? 'tool',
+            ...(params.ownerUserId === undefined ? {} : { ownerUserId: params.ownerUserId }),
+            ...(params.sourceMessageIds === undefined ? {} : { sourceMessageIds: [...params.sourceMessageIds] }),
+            ...(params.candidateId === undefined ? {} : { candidateId: params.candidateId }),
+            ...(params.sourceEventId === undefined ? {} : { sourceEventId: params.sourceEventId }),
+            confidence: clamp01(params.confidence ?? DEFAULT_CONFIDENCE),
+            salience: clamp01(params.salience ?? DEFAULT_SALIENCE),
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.#memories.put(params.id, entry);
+        return { entry, created: true };
+    }
+    /**
+     * 写入记忆（幂等：同 id 更新）。写入后按规则联动关系图谱
+     * （提供 userNodeId 时：familiarity +1；category='player' 额外 trust +5）。
+     */
+    async remember(params) {
+        const { entry, created, previous } = await this.#write({ ...params, id: params.id ?? randomUUID() });
+        await this.#audit.log({
+            entityType: 'memory',
+            entityId: entry.id,
+            action: created ? 'create' : 'update',
+            ...(previous === undefined ? {} : { before: this.#snapshotOf(previous) }),
+            after: this.#snapshotOf(entry),
+            source: params.source ?? 'tool',
+            ...(params.sourceEventId === undefined ? {} : { sourceEventId: params.sourceEventId }),
+            ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }),
+        });
+        if (created && params.source !== 'tool' && this.#events !== undefined && params.ownerUserId !== undefined && params.userNodeId !== undefined && params.instanceId !== undefined) {
+            await this.#events.appendEvent({ ownerUserId: params.ownerUserId, characterId: params.characterId, ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }), fromNodeId: `character-instance:${params.instanceId}`, toNodeId: params.userNodeId, type: 'familiarity', delta: 1, source: params.source ?? 'system', idempotencyKey: `memory:${entry.id}:familiarity`, ...(params.sourceEventId === undefined ? {} : { sourceEventId: params.sourceEventId }) });
+            if (this.#projection !== undefined)
+                await this.#projection.recompute({ ownerUserId: params.ownerUserId, characterId: params.characterId, ...(params.sceneId === undefined ? {} : { sceneId: params.sceneId }) });
+        }
+        return entry;
+    }
+    /**
+     * 检索记忆：按 characterId（必填）+ 可选 instanceId/sceneId/category/
+     * keyword/minConfidence 过滤，salience DESC → updatedAt DESC 排序，
+     * 取 limit 条（默认 5）。命中时更新 lastAccessedAt（updateAccess=true），
+     * 提供 userNodeId 时联动 familiarity +0.5。
+     */
+    async recall(params) {
+        const limit = params.limit ?? DEFAULT_MEMORY_LIMIT;
+        const minConfidence = params.minConfidence ?? DEFAULT_MIN_CONFIDENCE;
+        const keyword = params.keyword?.trim().toLocaleLowerCase();
+        const hits = [];
+        for (const [, memory] of this.#memories.entries()) {
+            if (memory.characterId !== params.characterId)
+                continue;
+            if (memory.status !== 'active')
+                continue;
+            if (params.instanceId !== undefined && memory.instanceId !== params.instanceId)
+                continue;
+            if (params.sceneId !== undefined && memory.sceneId !== params.sceneId)
+                continue;
+            if (params.category !== undefined && memory.category !== params.category)
+                continue;
+            if (memory.confidence < minConfidence)
+                continue;
+            if (keyword !== undefined && keyword !== '' && !memory.fact.toLocaleLowerCase().includes(keyword))
+                continue;
+            hits.push(memory);
+        }
+        hits.sort((a, b) => (b.salience - a.salience)
+            || (a.updatedAt < b.updatedAt ? 1 : a.updatedAt > b.updatedAt ? -1 : 0));
+        const kept = hits.slice(0, limit);
+        if (kept.length === 0)
+            return kept;
+        // 访问日志：更新 lastAccessedAt（不改 updatedAt，避免污染排序）。
+        if (params.updateAccess !== false) {
+            const accessedAt = new Date().toISOString();
+            for (const memory of kept) {
+                await this.#memories.put(memory.id, { ...memory, lastAccessedAt: accessedAt });
+            }
+        }
+        // 联动：recall 命中 → familiarity +0.5。
+        return kept;
+    }
+    /**
+     * 更正记忆：旧记忆标记 superseded（不删除，保留审计链路），创建新记忆
+     * （supersedes 指向旧 id）。提供 userNodeId 时联动 trust +1。
+     */
+    async supersede(params) {
+        const oldEntry = this.#memories.get(params.oldId);
+        if (oldEntry === undefined)
+            throw new Error(`[Tavern] 记忆不存在：${params.oldId}`);
+        const now = new Date().toISOString();
+        if (oldEntry.status === 'active') {
+            await this.#memories.put(oldEntry.id, { ...oldEntry, status: 'superseded', updatedAt: now });
+            await this.#audit.log({
+                entityType: 'memory',
+                entityId: oldEntry.id,
+                action: 'supersede',
+                before: this.#snapshotOf(oldEntry),
+                after: { ...this.#snapshotOf(oldEntry), status: 'superseded' },
+                source: params.source ?? oldEntry.source,
+                ...(params.sourceEventId === undefined ? {} : { sourceEventId: params.sourceEventId }),
+                ...(oldEntry.sceneId === undefined ? {} : { sceneId: oldEntry.sceneId }),
+            });
+        }
+        const { entry: fresh } = await this.#write({
+            id: randomUUID(),
+            characterId: oldEntry.characterId,
+            ...(oldEntry.instanceId === undefined ? {} : { instanceId: oldEntry.instanceId }),
+            ...(oldEntry.sceneId === undefined ? {} : { sceneId: oldEntry.sceneId }),
+            fact: params.newFact,
+            category: params.category ?? oldEntry.category,
+            source: params.source ?? oldEntry.source,
+            ...(params.sourceEventId === undefined ? {} : { sourceEventId: params.sourceEventId }),
+            confidence: params.confidence ?? oldEntry.confidence,
+            salience: params.salience ?? oldEntry.salience,
+            supersedes: oldEntry.id,
+        });
+        await this.#audit.log({
+            entityType: 'memory',
+            entityId: fresh.id,
+            action: 'create',
+            after: this.#snapshotOf(fresh),
+            source: params.source ?? oldEntry.source,
+            ...(params.sourceEventId === undefined ? {} : { sourceEventId: params.sourceEventId }),
+            ...(oldEntry.sceneId === undefined ? {} : { sceneId: oldEntry.sceneId }),
+        });
+        const oldOwnerUserId = oldEntry.ownerUserId;
+        if (params.source !== 'tool' && this.#events !== undefined && oldOwnerUserId !== undefined && params.userNodeId !== undefined && oldEntry.instanceId !== undefined) {
+            await this.#events.appendEvent({ ownerUserId: oldOwnerUserId, characterId: oldEntry.characterId, ...(oldEntry.sceneId === undefined ? {} : { sceneId: oldEntry.sceneId }), fromNodeId: `character-instance:${oldEntry.instanceId}`, toNodeId: params.userNodeId, type: 'trust', delta: 1, source: params.source ?? 'system', idempotencyKey: `memory-supersede:${oldEntry.id}:${fresh.id}`, ...(params.sourceEventId === undefined ? {} : { sourceEventId: params.sourceEventId }) });
+            if (this.#projection !== undefined)
+                await this.#projection.recompute({ ownerUserId: oldOwnerUserId, characterId: oldEntry.characterId, ...(oldEntry.sceneId === undefined ? {} : { sceneId: oldEntry.sceneId }) });
+        }
+        return fresh;
+    }
+    /**
+     * 标记正式记忆的聊天证据已失效。用户已经审阅接受的内容不会被自动删除，
+     * 但后续 UI/检索策略可据此提示或降权；重复标记不产生额外审计。
+     */
+    async markEvidenceInvalidated(memoryId) {
+        const memory = this.#memories.get(memoryId);
+        if (memory === undefined)
+            return null;
+        if (memory.evidenceInvalidatedAt !== undefined)
+            return memory;
+        const next = { ...memory, evidenceInvalidatedAt: new Date().toISOString(), updatedAt: new Date().toISOString() };
+        await this.#memories.put(memoryId, next);
+        await this.#audit.log({
+            entityType: 'memory', entityId: memoryId, action: 'update',
+            before: this.#snapshotOf(memory), after: this.#snapshotOf(next), source: 'system',
+            ...(next.sceneId === undefined ? {} : { sceneId: next.sceneId }),
+        });
+        return next;
+    }
+    /** 遗忘记忆：标记 forgotten（幂等；不存在或已非 active 时不写）。记录审计。 */
+    async forget(memoryId) {
+        const memory = this.#memories.get(memoryId);
+        if (memory === undefined || memory.status !== 'active')
+            return;
+        await this.#memories.put(memoryId, { ...memory, status: 'forgotten', updatedAt: new Date().toISOString() });
+        await this.#audit.log({
+            entityType: 'memory',
+            entityId: memoryId,
+            action: 'forget',
+            before: this.#snapshotOf(memory),
+            after: { ...this.#snapshotOf(memory), status: 'forgotten' },
+            source: memory.source,
+            ...(memory.sceneId === undefined ? {} : { sceneId: memory.sceneId }),
+        });
+    }
+    /** 遗忘某个来源事件下的全部 active 记忆；返回处理条数。 */
+    async forgetBySourceEvent(sourceEventId, characterId) {
+        let forgotten = 0;
+        const now = new Date().toISOString();
+        for (const [, memory] of this.#memories.entries()) {
+            if (memory.status !== 'active')
+                continue;
+            if (memory.sourceEventId !== sourceEventId)
+                continue;
+            if (characterId !== undefined && memory.characterId !== characterId)
+                continue;
+            await this.#memories.put(memory.id, { ...memory, status: 'forgotten', updatedAt: now });
+            await this.#audit.log({
+                entityType: 'memory',
+                entityId: memory.id,
+                action: 'forget',
+                before: this.#snapshotOf(memory),
+                after: { ...this.#snapshotOf(memory), status: 'forgotten' },
+                source: memory.source,
+                ...(memory.sceneId === undefined ? {} : { sceneId: memory.sceneId }),
+            });
+            forgotten += 1;
+        }
+        return forgotten;
+    }
+    /** 遗忘 sourceEventId 以指定前缀开头的全部 active 记忆；返回处理条数。 */
+    async forgetBySourceEventPrefix(prefix, characterId) {
+        let forgotten = 0;
+        const now = new Date().toISOString();
+        for (const [, memory] of this.#memories.entries()) {
+            if (memory.status !== 'active')
+                continue;
+            if (memory.sourceEventId === undefined || !memory.sourceEventId.startsWith(prefix))
+                continue;
+            if (characterId !== undefined && memory.characterId !== characterId)
+                continue;
+            await this.#memories.put(memory.id, { ...memory, status: 'forgotten', updatedAt: now });
+            await this.#audit.log({
+                entityType: 'memory',
+                entityId: memory.id,
+                action: 'forget',
+                before: this.#snapshotOf(memory),
+                after: { ...this.#snapshotOf(memory), status: 'forgotten' },
+                source: memory.source,
+                ...(memory.sceneId === undefined ? {} : { sceneId: memory.sceneId }),
+            });
+            forgotten += 1;
+        }
+        return forgotten;
+    }
+    /** 指定角色（可再按场景）的全部 active 记忆；供候选冲突检测等只读扫描使用。 */
+    listActiveByCharacter(characterId, sceneId) {
+        const result = [];
+        for (const [, memory] of this.#memories.entries()) {
+            if (memory.characterId !== characterId)
+                continue;
+            if (memory.status !== 'active')
+                continue;
+            if (sceneId !== undefined && memory.sceneId !== sceneId)
+                continue;
+            result.push(memory);
+        }
+        return result;
+    }
+    /**
+     * 场景内全部记忆（UI 数据面；含 superseded/forgotten 历史）。
+     * filter 支持 category / status；salience DESC → updatedAt DESC 排序。
+     */
+    async listByScene(sceneId, filter) {
+        const result = [];
+        for (const [, memory] of this.#memories.entries()) {
+            if (memory.sceneId !== sceneId)
+                continue;
+            if (filter?.category !== undefined && memory.category !== filter.category)
+                continue;
+            if (filter?.status !== undefined && memory.status !== filter.status)
+                continue;
+            result.push(memory);
+        }
+        result.sort((a, b) => (b.salience - a.salience)
+            || (a.updatedAt < b.updatedAt ? 1 : a.updatedAt > b.updatedAt ? -1 : 0));
+        return result;
+    }
+}
+//# sourceMappingURL=memory-service.js.map