跳到主要内容

L1创建编辑与生命周期维护

创建一条人工原子记忆​

创建命令带来六类输入：操作者上下文、记忆库 ID、授权 revision、Atom 类型、正文和可选来源。它不需要 Atom revision，因为后端会生成新 Atom。

JdbcL1ManualGovernance.create() 的执行顺序如下：

/** 创建 Atom、首个人工版本和谱系，并把幂等回执与投影通知写进同一个事务。 */
private Result create(Create command, String operation, String fingerprint) {
    Instant now = clock.instant();
    // Atom、首个版本和谱系各自有稳定身份，使用有时间顺序的 UUID 方便数据库索引写入。
    L1AtomId atomId = new L1AtomId(UuidCreator.getTimeOrderedEpoch());
    MemoryVersionId versionId = new MemoryVersionId(UuidCreator.getTimeOrderedEpoch());
    MemoryLineageId lineageId = new MemoryLineageId(UuidCreator.getTimeOrderedEpoch());
    jdbc.sql("insert into memory_evolution.l1_atom "
                    + "(atom_id, memory_asset_id, atom_type, current_version_id, lifecycle, revision, "
                    + "created_at, changed_at) values (?, ?, ?, ?, 'ACTIVE', 1, ?, ?)")
            .params(atomId.value(), command.memoryAssetId().value(), command.type().name(), versionId.value(),
                    Timestamp.from(now), Timestamp.from(now))
            .update();
    // 正文放进只追加版本表。Atom 只保存当前版本指针和生命周期。
    persistVersion(
            versionId, atomId, command.memoryAssetId(), 1, command.content(),
            MemoryVersionProvenance.MANUAL, now);
    persistManualLineage(
            lineageId, command.memoryAssetId(), versionId, L1EvolutionDecision.STORE,
            command.context().principal().userId(), command.sources(), now);
    L1AtomSnapshot atom = new L1AtomSnapshot(
            atomId, command.memoryAssetId(), command.type(), versionId,
            L1AtomLifecycle.ACTIVE, 1, now, now);
    MemoryVersionSnapshot version = new MemoryVersionSnapshot(
            versionId, atomId, command.memoryAssetId(), 1, command.content(),
            MemoryVersionProvenance.MANUAL, now);
    MemoryLineageSnapshot lineage = new MemoryLineageSnapshot(
            lineageId, command.memoryAssetId(), versionId, L1EvolutionDecision.STORE,
            command.sources(), new MemoryLineageOrigin.Manual(command.context().principal().userId()), now);
    // 先保存可重放回执，再写投影变更；二者仍在同一个数据库事务内。
    insertReceipt(command, operation, fingerprint, atom, Optional.of(version), Optional.of(lineage),
            Optional.empty(), Optional.empty());
    append(atom, MemoryProjectionSource.Operation.UPSERT, command.context().correlationId(), now);
    jdbc.sql("set constraints all immediate").update();
    return contentResult(atom, version, lineage, List.of());
}

付费内容提示

该文档的全部内容仅对「码力全开」项目实战&技术讲解 知识星球用户开放

加入星球，一次获得完整项目资料、全栈技术知识库和长期答疑服务。

100万+字全栈技术知识库深入讲解技术核心、数据库、中间件和分布式等内容
9套热门的实战项目持续更新的企业级项目覆盖高并发、微服务、数据中台 和 AI Agent 等方向
AI 技术知识大模型面试详解覆盖 AI 模型原理、Agent、RAG、MCP、Skills、Harness 等核心知识点
文档 + 视频两种讲解形式既能系统阅读，也能跟随视频理解核心业务

完整项目实战资料

每套项目均包含从 0 到 1 讲解文档核心业务讲解视频

从基础项目到复杂业务场景，项目资料会持续更新。

9 套项目
  • 01Nexus Agent AI 智能体
  • 02Nexus Agent Pro 完全版
  • 03Agent Up Memory
  • 04黑马点评Plus
  • 05大麦
  • 06大麦Pro
  • 07大麦AI
  • 08流量切换
  • 09数据中台

加入后还能获得

进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。

从学习、面试到项目启动，都可以继续获得支持。

  • 1 对 1 解答项目和技术问题都可以提问
  • 针对性补充没有讲清楚的内容会继续补充
  • 面试与简历指导梳理回答技巧和项目亮点
  • 中间件云环境项目依赖可以直接接入使用
  • 面试后复盘被问住的问题可以继续交流
  • 远程问题解决项目启动问题可协助排查
知识星球二维码

扫码进入知识星球

  1. 打开微信，扫描左侧二维码，加入「码力全开」项目实战&技术讲解 知识星球
  2. 查看星球使用指导，获取完整项目讲解资料索引
解锁全部付费内容
🎁优惠