dsh-prime-memory 0.22.1 → 0.24.0

package/dist/index.js

@@ -13,6 +13,7 @@ import { memorySchema, resolveDataDir } from './config.js';
 import { registerBenchControl } from './bench-control.js';
 import { registerCapture } from './hooks/capture.js';
 import { registerRecall } from './hooks/recall.js';
+import { SessionRecalledStore } from './store/session-recalled.js';
 import { MemoryRunner } from './pipeline/runner.js';
 import { RebuildController } from './pipeline/rebuild.js';
 import { RuminateController } from './pipeline/ruminate.js';
@@ -36,9 +37,18 @@ import { SlotStore } from './store/slots.js';
 import { registerMemoryTools } from './tools/index.js';
 import { registerSlotTools } from './tools/slots.js';
 import { registerSlotRecall } from './hooks/slot-recall.js';
+import { registerObsoleteNotice } from './hooks/obsolete-notice.js';
 import { RoomRegistryStore } from './store/rooms-registry.js';
+import { MemorySourceStore } from './store/memory-sources.js';
+import { SkillStore } from './store/skill-store.js';
+import { registerSkillRecall } from './hooks/skill-recall.js';
+import { registerSkillTools } from './tools/skills.js';
 import { RecallUsageStore } from './store/recall-usage.js';
+import { RecallFeedbackStore } from './store/recall-feedback.js';
+import { MdLedgerStore } from './store/memory-md-ledger.js';
+import { ObsoleteNoticeStore } from './store/obsolete-notices.js';
 import { registerSlotsProjection } from './projection/slots.js';
+import { registerRecallProjection } from './projection/recall.js';
 import { errDetail, withFileLog } from './util/filelog.js';
 import { buildRouteChain, resolveModelRoute, invalidateEffortCache } from './llm.js';
 import { effectiveCfg } from './pipeline/runner.js';
@@ -164,7 +174,10 @@ export async function apply(ctx, config) {
         l0: new L0Store(dataDir, db, embed, logger),
         l1: new L1Store(dataDir, db, embed, config.recall.strategy, logger, config.recall.decayHalfLifeDays, 
         // §D 第 3 路:图谱回链。图谱不可用时 searchNodes 自带 no-op,不影响双路。
-        (query, limit, family) => db.graphStore.searchNodes(query, limit, family ? [family] : undefined)),
+        (query, limit, family) => db.graphStore.searchNodes(query, limit, family ? [family] : undefined), 
+        // 投射开着才给没名字的新记录起名（“关时零动作”这条承诺不改）。
+        // 传函数而不是布尔：读的是当前配置对象，不把启动那一刻的值钉进 store。
+        () => config.memExport?.enabled === true),
         // L2/L3 分族隔离:各自目录与文件(scenes/chat|work、persona-chat|work.md)
         scenes: {
             chat: new SceneStore(dataDir, 'chat', logger),
@@ -175,6 +188,13 @@ export async function apply(ctx, config) {
             work: new PersonaStore(dataDir, 'work', logger),
         },
         state: new StateStore(StateStore.pathFor(dataDir), logger),
+        // 会话“活召回集”（G-live）：sessionKey → 本会话已注入未压缩的记录 id；持久化，旧会话重开载回。
+        recalled: new SessionRecalledStore(dataDir, logger),
+        // 召回相关度反馈与过时播报队列（装配于下方，需 await init）。
+        feedback: undefined,
+        notices: undefined,
+        // md 投射指纹账本（N9；装配于下方，需 await init）。
+        mdLedger: undefined,
         // 激活槽位(active slot):独立 slots.json,高频小改不拖累 checkpoint 原子写
         slots: new SlotStore(SlotStore.pathFor(dataDir), logger, {
             maxSlots: config.slots.maxSlots,
@@ -356,6 +376,12 @@ export async function apply(ctx, config) {
     // Room 注册表(分类管理 beta.4;损坏降级为纯自生长目录)
     const roomRegistry = new RoomRegistryStore(dataDir, logger);
     await roomRegistry.init();
+    // 外部记忆来源注册表（轨3 Connect；默认由 cfg.memport.enabled 关门控，sidecar 本身无条件加载）
+    const memorySources = new MemorySourceStore(dataDir, logger);
+    await memorySources.init();
+    // 技能存储（轨2；sidecar 无条件加载，但工具/注入均由 cfg.skills.enabled 默认关自 no-op）
+    const skillStore = new SkillStore(dataDir, logger);
+    await skillStore.init();
     const ruminate = storageOk && !db.isDegraded() && ruminateFile
         ? new RuminateController(ctx, config, runner, stores, logger, live, ruminateFile, roomRegistry)
         : undefined;
@@ -367,13 +393,40 @@ export async function apply(ctx, config) {
     const recallUsage = new RecallUsageStore(dataDir, logger);
     await recallUsage.init();
     stores.usage = recallUsage;
+    // 召回相关度反馈（人在召回卡上打 -1..5）与「已声明过时」待播报队列。
+    // 两个都是低频用户动作 → 立即落盘；sidecar 缺席/损坏只降级为只读，不阻断任何读路径。
+    const recallFeedback = new RecallFeedbackStore(dataDir, logger);
+    await recallFeedback.init();
+    stores.feedback = recallFeedback;
+    const obsoleteNotices = new ObsoleteNoticeStore(dataDir, logger);
+    await obsoleteNotices.init();
+    stores.notices = obsoleteNotices;
+    // md 投射指纹账本（N9）：派生态，缺席/损坏只降级为只读，不弄挂任何读路径。
+    // 它与 feedback/notices 同属“库外 sidecar”，不进快照哈希投影。
+    const mdLedger = new MdLedgerStore(dataDir, logger);
+    await mdLedger.init();
+    stores.mdLedger = mdLedger;
     const recall = registerRecall(ctx, config, stores, logger, live, modes, dataDir, recallUsage);
     runner.setAfterRun(recall.invalidateProfile);
     registerMemoryTools(ctx, config, stores, logger, modes, live, ruminate, storageOk ? roomRegistry : undefined);
     // 激活槽位(active slot):工具面 + 常驻注入 + 服务端投影(均走 ctx.effect,可撤销)
     registerSlotTools(ctx, config, stores.slots, logger, modes, live, stores.l1);
     const slotRecall = registerSlotRecall(ctx, config, stores.slots, logger, live);
+    // 轨2 技能：工具面与常驻注入（均 cfg.skills.enabled 默认关时自 no-op，零表面积）。
+    registerSkillTools(ctx, config, skillStore, logger, live);
+    registerSkillRecall(ctx, config, skillStore, logger, live);
+    // memorySlots 投影：常驻槽位（手动 pin 的约定）的展示契约，消费方是 dsh-brief-sidebar。
+    // 宿主契约（dsh-session-projection/lib/index.js）：插件不注册时 key 从快照消失、
+    // 客户端读作 capability absence（不会毒化历史加载），所以“摘注册”技术上可行；
+    // 但那是把跨插件展示契约直接抽掉，旧版 brief-sidebar 会默默丢分区——隐藏请走它自己的
+    // 「记忆槽位分区」开关。本包另提供一个会话感知的 memoryRecall 投影。
     registerSlotsProjection(ctx, stores.slots, stores.l1);
+    // memoryRecall 投影：本会话“已注入且未被压缩覆盖”的召回集（会话感知，init 取 header.id），
+    // 与常驻槽位是两条轴：那个是手动 pin 的硬注入约定，这个是非常驻的相关性浮现结果。
+    // 带上反馈面：条目要显示人已经打过的那一笔（rating）。
+    registerRecallProjection(ctx, stores.recalled, stores.l1, recallFeedback);
+    // 人打 -1 声明过时后，下一轮向模型一次性播报“这条已退场、别再依据它作答”。
+    registerObsoleteNotice(ctx, config, obsoleteNotices, logger);
     void slotRecall;
     registerMemoryRpc(ctx, config, stores, logger, {
         degraded: () => !storageOk || db.isDegraded(),
@@ -388,7 +441,7 @@ export async function apply(ctx, config) {
         runnerView: (sid, mode) => runner.sessionView(sid, mode),
         l0Count: (sid) => stores.l0.countBySession(sid),
         capabilities: () => db.getCapabilities(),
-    }, ruminate, storageOk ? roomRegistry : undefined);
+    }, ruminate, storageOk ? roomRegistry : undefined, storageOk ? memorySources : undefined, skillStore);
     // bench 控制服务(config.benchControl 门控,默认关):仅基准/调试部署注册,
     // 供同进程的 bench-runner lifecycle 赛道触发 rebuild / 设置会话档位
     // (宿主侧 RPC 无 call(),见 bench-control.ts)

package/dist/memory-types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 记忆类型词表的**唯一事实源**（pm-name-distill A 节）。
+ *
+ * 在此之前，"类型全集"手抄在四处：`MEMORY_TYPE_DIRS`（投射目录）、`ADD_TYPES`（写入白名单）、
+ * `TYPE_LABELS`（面板标签）、抽取/去重 prompt 的枚举串。四处各自演化过——宿主记忆分类
+ * （29 类）与插件 7 类字面交集为空，`memory_add` 把外部分类**静默改写**成 `episodic`，
+ * 而 memport 的警告文案却承诺"按原样透传"。同一件事两套口径，漂移只是时间问题。
+ *
+ * 词表内容 = **宿主 29 类原名**（与 memport 导入的分类字面一致，不再造 `dev_*`/`exp_*`
+ * 那层映射——映射层每多一处就多一处漂移）+ 插件旧 7 类（库里 1166 条正带着它们，
+ * 不许一夜之间全变 `unclassified`）+ `unclassified` 兜底目录。
+ *
+ * 本文件必须**零依赖运行**（不引 node: 模块）：client 侧与 server 侧同源消费，
+ * prompt 渲染也从这里派生。
+ */
+/** 类型族（与 `types.ts` 的 `MemoryFamily` 同域；这里重述字面量以免运行时循环引用）。 */
+export type TypeFamily = 'chat' | 'work';
+/** 宿主记忆分类的 29 类原名（实测自宿主记忆目录树，条数分布见计划 findings 第一节）。 */
+export declare const HOST_MEMORY_TYPES: readonly string[];
+/** 插件早期 7 类（蒸馏管线现役词表；库里存量正带着，永久保留）。 */
+export declare const LEGACY_MEMORY_TYPES: readonly string[];
+/**
+ * 兜底目录名（不是可赋值类型）：不在词表的 `type` 原值照旧写进 frontmatter，
+ * 只在**目录层**归这里。归进某个 `work_*` 会静默把这批记录的 family 挑到 work 侧
+ * （family 决定共享面），所以它自成一桶、族取 chat。
+ */
+export declare const UNCLASSIFIED_DIR = "unclassified";
+/**
+ * 非词表 type 进入写路径时的降级目标。旧代码在 `tools/index.ts` 里把 `'episodic'`
+ * 当字面量散写；集中到这里，降级行为至少有一个可 grep 的名字。
+ */
+export declare const DOWNGRADE_TARGET = "episodic";
+/** 可赋值类型全集（宿主 29 + 旧 7 = 36；`unclassified` 不在其中——它是目录，不是类型）。 */
+export declare const MEMORY_TYPE_VOCABULARY: ReadonlySet<string>;
+/**
+ * 族映射（新旧同放）。旧 `familyForType` 靠 `type.startsWith('work')` 前缀猜族，
+ * 新词表里 `project_*`/`development_*`/`*_experience` 都是 work 族却不带 work 前缀——
+ * 前缀判定会把它们静默归进 chat，而 family 决定召回/浏览/去重的共享面。
+ */
+export declare const TYPE_FAMILY_MAP: Readonly<Record<string, TypeFamily>>;
+/** 类型 → 面板中文标签（真源；client 侧经 `list-records` 的 `typeCatalog` 下发消费）。 */
+export declare const MEMORY_TYPE_LABELS: Readonly<Record<string, string>>;
+/** 投射目录全集 = 可赋值类型 + 兜底桶（37 个）。`memory-md.ts` 的白名单从这里派生。 */
+export declare function memoryTypeDirs(): ReadonlySet<string>;
+/** 是否为词表内类型（写路径白名单判据；`unclassified` 不算——没人该主动赋它）。 */
+export declare function isKnownType(type: string): boolean;
+/** 族查询：查表；未知值回落旧前缀规则并交给 `onUnknownFamily` 提醒一次。 */
+export declare function familyOf(type: string): TypeFamily;
+/**
+ * CSS 类名用的 slug（`work_fact` → `work-fact`）。
+ *
+ * 面板标签类名以前直接拼 `type` 原值（下划线），而主题 CSS 定义的是连字符类——
+ * `dsh-mem-tag-work_fact` 匹配不上 `.dsh-mem-tag-work-fact`，标签无色（F11 既有断裂）。
+ * 拼接点统一走这里，判据只有一份。
+ */
+export declare function slugOf(type: string): string;
+/** 面板词表目录（下发给 client 的 `typeCatalog`；含兜底桶，顺序 = 旧 7 → 宿主 29 → 兜底）。 */
+export declare function typeCatalogEntries(): Array<{
+    id: string;
+    label: string;
+}>;
+/** chat / work 族的可赋值类型（prompt 枚举串从这里渲染，不再手抄）。 */
+export declare function typesOfFamily(family: TypeFamily): string[];
+/** prompt/工具描述用的枚举串（`|` 或 `/` 连接，顺序稳定：旧 7 在前）。 */
+export declare function typeEnumSep(sep: string, family?: TypeFamily): string;
+/** 测试/宿主接线用：替换未知族的提醒出口（传 undefined 恢复 console）。 */
+export declare function setFamilyWarnSink(sink?: (msg: string) => void): void;
+/** 清空"已提醒"集（用例要能反复断言只 warn 一次）。 */
+export declare function resetFamilyWarned(): void;

package/dist/memory-types.js

@@ -0,0 +1,165 @@
+/**
+ * 记忆类型词表的**唯一事实源**（pm-name-distill A 节）。
+ *
+ * 在此之前，"类型全集"手抄在四处：`MEMORY_TYPE_DIRS`（投射目录）、`ADD_TYPES`（写入白名单）、
+ * `TYPE_LABELS`（面板标签）、抽取/去重 prompt 的枚举串。四处各自演化过——宿主记忆分类
+ * （29 类）与插件 7 类字面交集为空，`memory_add` 把外部分类**静默改写**成 `episodic`，
+ * 而 memport 的警告文案却承诺"按原样透传"。同一件事两套口径，漂移只是时间问题。
+ *
+ * 词表内容 = **宿主 29 类原名**（与 memport 导入的分类字面一致，不再造 `dev_*`/`exp_*`
+ * 那层映射——映射层每多一处就多一处漂移）+ 插件旧 7 类（库里 1166 条正带着它们，
+ * 不许一夜之间全变 `unclassified`）+ `unclassified` 兜底目录。
+ *
+ * 本文件必须**零依赖运行**（不引 node: 模块）：client 侧与 server 侧同源消费，
+ * prompt 渲染也从这里派生。
+ */
+/** 宿主记忆分类的 29 类原名（实测自宿主记忆目录树，条数分布见计划 findings 第一节）。 */
+export const HOST_MEMORY_TYPES = [
+    // —— 个人可见（chat 族）：用户画像的四类 ——
+    'user_info', 'user_hobby', 'user_communication', 'user_behavior',
+    // —— 项目轴（work 族）——
+    'project_introduction', 'project_tech_stack', 'project_architecture',
+    'project_build_configuration', 'project_dependency_configuration', 'project_ide_configuration',
+    'project_scm_configuration', 'project_environment_configuration', 'project_rule',
+    // —— 开发规范轴（work 族）——
+    'development_code_specification', 'development_practice_specification',
+    'development_test_specification', 'development_comment_specification',
+    // —— 经验轴（work 族）——
+    'task_summary_experience', 'task_breakdown_experience', 'task_flow_experience', 'task_experience',
+    'tool_experience', 'mcp_experience', 'skill_experience', 'learned_skill_experience',
+    'expert_experience', 'important_decision_experience', 'common_pitfalls_experience',
+    'history_task_reference_files',
+];
+/** 插件早期 7 类（蒸馏管线现役词表；库里存量正带着，永久保留）。 */
+export const LEGACY_MEMORY_TYPES = [
+    'persona', 'episodic', 'instruction', 'work_fact', 'work_task', 'work_method', 'work_artifact',
+];
+/**
+ * 兜底目录名（不是可赋值类型）：不在词表的 `type` 原值照旧写进 frontmatter，
+ * 只在**目录层**归这里。归进某个 `work_*` 会静默把这批记录的 family 挑到 work 侧
+ * （family 决定共享面），所以它自成一桶、族取 chat。
+ */
+export const UNCLASSIFIED_DIR = 'unclassified';
+/**
+ * 非词表 type 进入写路径时的降级目标。旧代码在 `tools/index.ts` 里把 `'episodic'`
+ * 当字面量散写；集中到这里，降级行为至少有一个可 grep 的名字。
+ */
+export const DOWNGRADE_TARGET = 'episodic';
+/** 可赋值类型全集（宿主 29 + 旧 7 = 36；`unclassified` 不在其中——它是目录，不是类型）。 */
+export const MEMORY_TYPE_VOCABULARY = new Set([
+    ...LEGACY_MEMORY_TYPES, ...HOST_MEMORY_TYPES,
+]);
+/**
+ * 族映射（新旧同放）。旧 `familyForType` 靠 `type.startsWith('work')` 前缀猜族，
+ * 新词表里 `project_*`/`development_*`/`*_experience` 都是 work 族却不带 work 前缀——
+ * 前缀判定会把它们静默归进 chat，而 family 决定召回/浏览/去重的共享面。
+ */
+export const TYPE_FAMILY_MAP = Object.freeze((() => {
+    const map = {};
+    for (const t of LEGACY_MEMORY_TYPES)
+        map[t] = t.startsWith('work') ? 'work' : 'chat';
+    for (const t of HOST_MEMORY_TYPES)
+        map[t] = t.startsWith('user_') ? 'chat' : 'work';
+    map[UNCLASSIFIED_DIR] = 'chat';
+    return map;
+})());
+/** 类型 → 面板中文标签（真源；client 侧经 `list-records` 的 `typeCatalog` 下发消费）。 */
+export const MEMORY_TYPE_LABELS = Object.freeze({
+    persona: '画像偏好',
+    episodic: '客观事件',
+    instruction: '全局指令',
+    work_fact: '工作事实',
+    work_task: '工作任务',
+    work_method: '工作方法',
+    work_artifact: '工作资产',
+    user_info: '用户信息',
+    user_hobby: '用户爱好',
+    user_communication: '沟通风格',
+    user_behavior: '行为规范',
+    project_introduction: '项目介绍',
+    project_tech_stack: '技术栈',
+    project_architecture: '架构设计',
+    project_build_configuration: '构建配置',
+    project_dependency_configuration: '依赖配置',
+    project_ide_configuration: 'IDE 配置',
+    project_scm_configuration: '版本控制配置',
+    project_environment_configuration: '环境配置',
+    project_rule: '项目规则',
+    development_code_specification: '代码规范',
+    development_practice_specification: '实践规范',
+    development_test_specification: '测试规范',
+    development_comment_specification: '注释规范',
+    task_summary_experience: '任务总结',
+    task_breakdown_experience: '任务拆解',
+    task_flow_experience: '任务流程',
+    task_experience: '任务经验',
+    tool_experience: '工具经验',
+    mcp_experience: 'MCP 经验',
+    skill_experience: '技能经验',
+    learned_skill_experience: '习得技能',
+    expert_experience: '专家经验',
+    important_decision_experience: '重要决策',
+    common_pitfalls_experience: '常见陷阱',
+    history_task_reference_files: '历史参考文件',
+    [UNCLASSIFIED_DIR]: '未分类',
+});
+/** 投射目录全集 = 可赋值类型 + 兜底桶（37 个）。`memory-md.ts` 的白名单从这里派生。 */
+export function memoryTypeDirs() {
+    return new Set([...MEMORY_TYPE_VOCABULARY, UNCLASSIFIED_DIR]);
+}
+/** 是否为词表内类型（写路径白名单判据；`unclassified` 不算——没人该主动赋它）。 */
+export function isKnownType(type) {
+    return MEMORY_TYPE_VOCABULARY.has(type);
+}
+/** 族查询：查表；未知值回落旧前缀规则并交给 `onUnknownFamily` 提醒一次。 */
+export function familyOf(type) {
+    const f = TYPE_FAMILY_MAP[type];
+    if (f !== undefined)
+        return f;
+    noteUnknown(type);
+    return type.startsWith('work') ? 'work' : 'chat';
+}
+/**
+ * CSS 类名用的 slug（`work_fact` → `work-fact`）。
+ *
+ * 面板标签类名以前直接拼 `type` 原值（下划线），而主题 CSS 定义的是连字符类——
+ * `dsh-mem-tag-work_fact` 匹配不上 `.dsh-mem-tag-work-fact`，标签无色（F11 既有断裂）。
+ * 拼接点统一走这里，判据只有一份。
+ */
+export function slugOf(type) {
+    return type.replace(/_/g, '-');
+}
+/** 面板词表目录（下发给 client 的 `typeCatalog`；含兜底桶，顺序 = 旧 7 → 宿主 29 → 兜底）。 */
+export function typeCatalogEntries() {
+    return [...LEGACY_MEMORY_TYPES, ...HOST_MEMORY_TYPES, UNCLASSIFIED_DIR].map((id) => ({
+        id,
+        label: MEMORY_TYPE_LABELS[id] ?? id,
+    }));
+}
+/** chat / work 族的可赋值类型（prompt 枚举串从这里渲染，不再手抄）。 */
+export function typesOfFamily(family) {
+    return [...MEMORY_TYPE_VOCABULARY].filter((t) => TYPE_FAMILY_MAP[t] === family);
+}
+/** prompt/工具描述用的枚举串（`|` 或 `/` 连接，顺序稳定：旧 7 在前）。 */
+export function typeEnumSep(sep, family) {
+    const list = family === undefined ? [...LEGACY_MEMORY_TYPES, ...HOST_MEMORY_TYPES] : typesOfFamily(family);
+    return list.join(sep);
+}
+// —— 未知类型的"只提醒一次"：诊断集封到 64 个就不再记录（宁可漏提醒，不让集合无限吃内存）。
+const warnedUnknownFamilies = new Set();
+let warnSink = (msg) => console.warn(msg);
+/** 测试/宿主接线用：替换未知族的提醒出口（传 undefined 恢复 console）。 */
+export function setFamilyWarnSink(sink) {
+    warnSink = sink ?? ((msg) => console.warn(msg));
+}
+/** 清空"已提醒"集（用例要能反复断言只 warn 一次）。 */
+export function resetFamilyWarned() {
+    warnedUnknownFamilies.clear();
+}
+function noteUnknown(type) {
+    if (warnedUnknownFamilies.has(type))
+        return;
+    if (warnedUnknownFamilies.size < 64)
+        warnedUnknownFamilies.add(type);
+    warnSink(`[memory] type '${type}' 不在词表，family 按旧前缀规则回落（请核对来源）`);
+}

package/dist/memport/format.d.ts

@@ -0,0 +1,75 @@
+/** MMF v1.1 默认列序（缺 `#cols=` 时按此解析；v1 包缺 vf/vt/st 列按 -/-/? 补齐）。 */
+export declare const DEFAULT_COLS: readonly ["type", "created", "updated", "vf", "vt", "st", "cf", "rw", "tags", "content"];
+/**
+ * 类型码 → 运行时 type（与 memport.py TYPE_CODES 一字不差）。
+ *
+ * 旧码（插件 7 类）不变；pm-name-distill task_1.7 补进宿主 29 类的新码，使外部包
+ * 带来的宿主分类不再被写侧抹平——两实现同表是 `memport-ts-consistency` 的前提。
+ */
+export declare const TYPE_CODES: Record<string, string>;
+/** 持续性取值域：p 时点 / s 已结束区间 / o 仍在持续 / t 无时间性 / ? 未判定。 */
+export declare const PERSISTENCE: readonly ["p", "s", "o", "t", "?"];
+export interface MemRecord {
+    seq: number;
+    type: string;
+    typeFull: string;
+    created: string;
+    updated: string;
+    vf: string;
+    vt: string;
+    st: string;
+    cf: string;
+    rw: string;
+    tags: Record<string, string>;
+    content: string;
+    hash: string;
+    createdMs: number | null;
+    createdPrec: string;
+    updatedMs: number | null;
+    updatedPrec: string;
+    vfMs: number | null;
+    vfPrec: string;
+    vtMs: number | null;
+    vtPrec: string;
+}
+export interface Bundle {
+    header: Record<string, string>;
+    cols: string[];
+    records: MemRecord[];
+    errors: string[];
+    warnings: string[];
+    declaredCount: number | null;
+    declaredSha: string | null;
+    /** 记录体原始行（未去转义），用于校验和复算——与 Python `body` 对齐。 */
+    bodyLines: string[];
+}
+/** NFKC + 空白折叠 + 去首尾（用于哈希与相似度，不改原文）。 */
+export declare function normText(s: string): string;
+/**
+ * 内容哈希：sha256(normText + 小写)[:16]。
+ * 注意：Python 用 casefold（激进大小写折叠），JS 用 toLowerCase；
+ * 对 CJK/ASCII 记忆正文等价，仅极端 Unicode 有别——实际记忆集不含此类，
+ * 跨实现金标准走包级 sha256（不逐条折叠），不受影响。
+ */
+export declare function contentHash(s: string): string;
+/** 记录稳定 id：`mp_` + sha256(src|chash)[:16]。 */
+export declare function recordId(src: string, chash: string): string;
+/** 解码内容列：反斜杠+反斜杠 → 单反斜杠；反斜杠+n → 换行（其余反斜杠原样）。 */
+export declare function unescapeContent(s: string): string;
+/**
+ * 编码内容列：反斜杠 → 双反斜杠、CRLF → LF、LF → 反斜杠+n。
+ * 用 charCode 常量而非控制字符字面量，避免跨工具写盘时 CR/LF 被吞进正则/字符串字面量。
+ */
+export declare function escapeContent(s: string): string;
+/** `k:v;k:v` → 对象（缺冒号的段忽略）。 */
+export declare function parseTags(raw: string): Record<string, string>;
+/** 时间串 → { ms|null, precision }（镜像 Python parse_time；naive 视为本地）。 */
+export declare function parseTime(raw: string): {
+    ms: number | null;
+    precision: string;
+};
+/**
+ * 解析整包文本 → Bundle（含结构校验）。镜像 memport.py parse_bundle。
+ * 入参是字符串（调用方读文件时自带编码处理）；此处容错剥离 BOM。
+ */
+export declare function parseBundle(text: string): Bundle;