人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习【免费下载链接】agent-core-javaopenJiuwen agent core Java是 openJiuwen Core的 Java版本提供AI Agent开发、运行、调优与演进相关的全套SDK能力。项目地址https://gitcode.com/openJiuwen/agent-core-java点击查看免费下载MemCheckItem是 openJiuwen agent-core-java 记忆引擎中“记忆增量更新判定”环节的核心数据结构用于承载大模型对单条新记忆与既有记忆之间冗余 / 冲突 / 共存关系的检查结论。本文围绕该类的字段定义、JSON 契约、在MemUpdateChecker中的消费流程与配套测试展开帮助你理解 Agent 长期记忆如何通过“检查—动作”机制实现去重与纠偏。MemCheckItem 在记忆引擎中的定位在 openJiuwen 的记忆模块中增量更新不是简单的新旧记忆叠加而是先由模型判定语义关系再生成增删动作。com.openjiuwen.memory.manage.update包负责这一整套能力其核心类型包括类型说明CheckResult检查结果枚举redundant/conflicting/noneMemCheckItem单条检查结果对象即本文主角MemoryActionItem记忆更新动作对象ADD / DELETEMemoryStatus动作状态枚举MemUpdateChecker基于提示词和模型输出判断记忆冗余与冲突MemCheckItem描述的是“模型对一条新记忆给出的检查结论”这条新记忆是冗余、冲突还是可共存若冗余 / 冲突它与哪些旧记忆相关。它处于整个更新流程的“模型输出解析”与“动作生成”之间的桥梁位置。参见包说明文档 update.README.md。数据结构Java record 定义源码 MemCheckItem.java 将MemCheckItem实现为不可变的 Java record并使用 Jackson 的JsonProperty注解声明 JSON 字段名public record MemCheckItem( JsonProperty(info_id) String infoId, JsonProperty(info_text) String infoText, CheckResult result, JsonProperty(related_infos) MapString, String relatedInfos ) { public MemCheckItem { Objects.requireNonNull(infoId, info_id); Objects.requireNonNull(infoText, info_text); Objects.requireNonNull(result, result); relatedInfos relatedInfos null ? new LinkedHashMap() : new LinkedHashMap(relatedInfos); } }公开成员一览与原 API 文档一致字段类型说明infoIdString新记忆的 ID对应 JSON 键info_idinfoTextString新记忆的内容文本对应 JSON 键info_textresultCheckResult该条记忆的检查结论relatedInfosMapString, String相关联的旧记忆ID → 内容对应 JSON 键related_infos从源码结构看使用 record 意味着对象天然不可变便于在异步检查流程中安全传递紧凑构造器compact constructor还会在创建时执行非空校验并保证relatedInfos永远不为null。字段逐一解析infoId 与 infoText被检查的新记忆infoId标识被检查的新记忆条目infoText是它的内容。二者在构造器中均通过Objects.requireNonNull强制非空防止模型输出解析出缺失关键字段的对象。result模型给出的结论result的类型是枚举CheckResult定义见 CheckResult.java枚举值JSON 原始值语义REDUNDANTredundant新记忆与旧记忆语义冗余无需新增CONFLICTINGconflicting新记忆与旧记忆逻辑冲突需要以新替旧NONEnone可共存正常新增该枚举通过JsonValue/JsonCreator支持与字符串值的双向转换这也是MemCheckItem能被 Jackson 从模型输出 JSON 直接反序列化的前提。relatedInfos关联的旧记忆relatedInfos是一个MapString, String键为旧记忆 ID、值为旧记忆内容。其填充规则是仅当result为redundant或conflicting时携带关联旧记忆若为none则为空对象。构造函数会把入参复制为LinkedHashMap以保持插入顺序并在传入null时兜底为空 Map。JSON 序列化契约与模型输出严格对齐MemCheckItem的四个字段通过JsonProperty与蛇形命名snake_case的 JSON 键一一对应这正是为了直接解析大模型返回的检查结果。底层提示词模板 memory_update_check.md 明确要求模型输出如下结构[{info_id: , info_text: , result: , related_infos: {}}, ...]其中result取值限定为redundant、conflicting、nonerelated_infos仅在冗余或冲突时填充{旧信息ID: 旧信息内容, ...}none时为空对象{}。由此可见MemCheckItem的字段设计完全来自该提示词模板的输出规范二者共同构成“提示词要求—模型输出—Java 对象解析”的闭环。在 MemUpdateChecker 中的消费流程MemCheckItem的消费方是 MemUpdateChecker.java。其check方法支持无模型直接全量新增、以及带模型与重试次数的重载整体流程如下调用formatInput将新旧记忆格式化为ID: 内容文本新记忆逆序、旧记忆顺序填充提示词模板的new_information/old_information变量通过PromptApplier应用memory_update_check模板构造UserMessage参见 PromptApplier.java在独立 IO 线程池中调用模型使用JsonOutputParser解析响应将解析结果OBJECT_MAPPER.convertValue(item, MemCheckItem.class)反序列化为MemCheckItem列表遍历检查结果按result分发生成MemoryActionItem动作REDUNDANT跳过该新记忆不产生任何动作CONFLICTING为新记忆生成ADD动作同时为relatedInfos中仍存在于旧记忆的条目生成DELETE动作新替旧NONE为新记忆生成ADD动作。若模型输出解析失败且重试耗尽或未配置模型则回退为“全部新记忆直接 ADD”保证记忆更新流程不会因模型异常而中断。解析层同时兼容模型输出“单个对象”与“对象数组”两种形态normalizeParsedResult会统一归一为列表。动作对象MemoryActionItem(id, content, status)与状态枚举MemoryStatus(ADD/DELETE)的实现见 MemoryActionItem.java 与 MemoryStatus.java。通过测试用例掌握典型行为仓库测试 MemUpdateCheckerTest.java 覆盖了MemCheckItem相关的全部典型场景可作为使用参考冗余模型返回result: redundant且related_infos: {2: I enjoy books}时检查结果为空——新记忆被丢弃冲突模型返回result: conflicting且关联旧记忆{2: I hate books}时生成“新增新记忆 1 删除旧记忆 2”两个动作共存result: none时仅生成新记忆的ADD动作健壮性模型输出非法 JSON 时回退为全量新增单个对象输出会被归一化为列表处理重复 ID 仍正常消费模型响应构造校验memCheckItemCreation测试验证了四个访问器方法infoId()、infoText()、result()、relatedInfos()与字段值的正确性。此外enumValuesArePythonCompatible测试确认了CheckResult与MemoryStatus的字符串值与 Python 版本保持兼容——MemCheckItem的源码注释明确说明其镜像自 Python 侧openjiuwen/core/memory/manage/update/mem_update_checker.py这为跨语言实现的一致性提供了保障。小结MemCheckItem虽然只是一个四字段的数据对象却是 openJiuwen 记忆增量更新链路中承上启下的关键它向上承接大模型的 JSON 检查输出info_id、info_text、result、related_infos与提示词模板的字段规范一一对应向下驱动MemUpdateChecker生成具体的 ADD / DELETE 动作从而让 Agent 的长期记忆在持续写入过程中自动去重、自动纠偏、避免信息冲突累积。理解这一对象等于掌握了 openJiuwen 记忆引擎“先检查、后更新”的增量维护机制入口。赞分享人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习【免费下载链接】agent-core-javaopenJiuwen agent core Java是 openJiuwen Core的 Java版本提供AI Agent开发、运行、调优与演进相关的全套SDK能力。项目地址https://gitcode.com/openJiuwen/agent-core-java点击查看免费下载相关推荐FragmentMemoryUnit 碎记忆单元模型详解——openJiuwen agent-core-java 记忆引擎数据模型篇FragmentMemoryUnit 碎记忆单元模型详解——openJiuwen agent core java 记忆引擎数据模型篇 本文围绕 openJiuw人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习openJiuwen agent-core-java 记忆检索结果模型 MemResult 深度解析openJiuwen agent core java 记忆检索结果模型 MemResult 深度解析 MemResult 是 openJiuwen agent人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习DLSS Swapper9 种 DLL、8 个游戏库不更新游戏也能切换缩放版本DLSS Swapper9 种 DLL、8 个游戏库不更新游戏也能切换缩放版本 如果你的游戏还停在上一代 DLSS而新版早就发布你又不想等厂商推送补丁、桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习【免费下载链接】agent-core-javaopenJiuwen agent core Java是 openJiuwen Core的 Java版本提供AI Agent开发、运行、调优与演进相关的全套SDK能力。项目地址https://gitcode.com/openJiuwen/agent-core-java点击查看免费下载MemCheckItem是 openJiuwen agent-core-java 记忆引擎中“记忆增量更新判定”环节的核心数据结构用于承载大模型对单条新记忆与既有记忆之间冗余 / 冲突 / 共存关系的检查结论。本文围绕该类的字段定义、JSON 契约、在MemUpdateChecker中的消费流程与配套测试展开帮助你理解 Agent 长期记忆如何通过“检查—动作”机制实现去重与纠偏。MemCheckItem 在记忆引擎中的定位在 openJiuwen 的记忆模块中增量更新不是简单的新旧记忆叠加而是先由模型判定语义关系再生成增删动作。com.openjiuwen.memory.manage.update包负责这一整套能力其核心类型包括类型说明CheckResult检查结果枚举redundant/conflicting/noneMemCheckItem单条检查结果对象即本文主角MemoryActionItem记忆更新动作对象ADD / DELETEMemoryStatus动作状态枚举MemUpdateChecker基于提示词和模型输出判断记忆冗余与冲突MemCheckItem描述的是“模型对一条新记忆给出的检查结论”这条新记忆是冗余、冲突还是可共存若冗余 / 冲突它与哪些旧记忆相关。它处于整个更新流程的“模型输出解析”与“动作生成”之间的桥梁位置。参见包说明文档 update.README.md。数据结构Java record 定义源码 MemCheckItem.java 将MemCheckItem实现为不可变的 Java record并使用 Jackson 的JsonProperty注解声明 JSON 字段名public record MemCheckItem( JsonProperty(info_id) String infoId, JsonProperty(info_text) String infoText, CheckResult result, JsonProperty(related_infos) MapString, String relatedInfos ) { public MemCheckItem { Objects.requireNonNull(infoId, info_id); Objects.requireNonNull(infoText, info_text); Objects.requireNonNull(result, result); relatedInfos relatedInfos null ? new LinkedHashMap() : new LinkedHashMap(relatedInfos); } }公开成员一览与原 API 文档一致字段类型说明infoIdString新记忆的 ID对应 JSON 键info_idinfoTextString新记忆的内容文本对应 JSON 键info_textresultCheckResult该条记忆的检查结论relatedInfosMapString, String相关联的旧记忆ID → 内容对应 JSON 键related_infos从源码结构看使用 record 意味着对象天然不可变便于在异步检查流程中安全传递紧凑构造器compact constructor还会在创建时执行非空校验并保证relatedInfos永远不为null。字段逐一解析infoId 与 infoText被检查的新记忆infoId标识被检查的新记忆条目infoText是它的内容。二者在构造器中均通过Objects.requireNonNull强制非空防止模型输出解析出缺失关键字段的对象。result模型给出的结论result的类型是枚举CheckResult定义见 CheckResult.java枚举值JSON 原始值语义REDUNDANTredundant新记忆与旧记忆语义冗余无需新增CONFLICTINGconflicting新记忆与旧记忆逻辑冲突需要以新替旧NONEnone可共存正常新增该枚举通过JsonValue/JsonCreator支持与字符串值的双向转换这也是MemCheckItem能被 Jackson 从模型输出 JSON 直接反序列化的前提。relatedInfos关联的旧记忆relatedInfos是一个MapString, String键为旧记忆 ID、值为旧记忆内容。其填充规则是仅当result为redundant或conflicting时携带关联旧记忆若为none则为空对象。构造函数会把入参复制为LinkedHashMap以保持插入顺序并在传入null时兜底为空 Map。JSON 序列化契约与模型输出严格对齐MemCheckItem的四个字段通过JsonProperty与蛇形命名snake_case的 JSON 键一一对应这正是为了直接解析大模型返回的检查结果。底层提示词模板 memory_update_check.md 明确要求模型输出如下结构[{info_id: , info_text: , result: , related_infos: {}}, ...]其中result取值限定为redundant、conflicting、nonerelated_infos仅在冗余或冲突时填充{旧信息ID: 旧信息内容, ...}none时为空对象{}。由此可见MemCheckItem的字段设计完全来自该提示词模板的输出规范二者共同构成“提示词要求—模型输出—Java 对象解析”的闭环。在 MemUpdateChecker 中的消费流程MemCheckItem的消费方是 MemUpdateChecker.java。其check方法支持无模型直接全量新增、以及带模型与重试次数的重载整体流程如下调用formatInput将新旧记忆格式化为ID: 内容文本新记忆逆序、旧记忆顺序填充提示词模板的new_information/old_information变量通过PromptApplier应用memory_update_check模板构造UserMessage参见 PromptApplier.java在独立 IO 线程池中调用模型使用JsonOutputParser解析响应将解析结果OBJECT_MAPPER.convertValue(item, MemCheckItem.class)反序列化为MemCheckItem列表遍历检查结果按result分发生成MemoryActionItem动作REDUNDANT跳过该新记忆不产生任何动作CONFLICTING为新记忆生成ADD动作同时为relatedInfos中仍存在于旧记忆的条目生成DELETE动作新替旧NONE为新记忆生成ADD动作。若模型输出解析失败且重试耗尽或未配置模型则回退为“全部新记忆直接 ADD”保证记忆更新流程不会因模型异常而中断。解析层同时兼容模型输出“单个对象”与“对象数组”两种形态normalizeParsedResult会统一归一为列表。动作对象MemoryActionItem(id, content, status)与状态枚举MemoryStatus(ADD/DELETE)的实现见 MemoryActionItem.java 与 MemoryStatus.java。通过测试用例掌握典型行为仓库测试 MemUpdateCheckerTest.java 覆盖了MemCheckItem相关的全部典型场景可作为使用参考冗余模型返回result: redundant且related_infos: {2: I enjoy books}时检查结果为空——新记忆被丢弃冲突模型返回result: conflicting且关联旧记忆{2: I hate books}时生成“新增新记忆 1 删除旧记忆 2”两个动作共存result: none时仅生成新记忆的ADD动作健壮性模型输出非法 JSON 时回退为全量新增单个对象输出会被归一化为列表处理重复 ID 仍正常消费模型响应构造校验memCheckItemCreation测试验证了四个访问器方法infoId()、infoText()、result()、relatedInfos()与字段值的正确性。此外enumValuesArePythonCompatible测试确认了CheckResult与MemoryStatus的字符串值与 Python 版本保持兼容——MemCheckItem的源码注释明确说明其镜像自 Python 侧openjiuwen/core/memory/manage/update/mem_update_checker.py这为跨语言实现的一致性提供了保障。小结MemCheckItem虽然只是一个四字段的数据对象却是 openJiuwen 记忆增量更新链路中承上启下的关键它向上承接大模型的 JSON 检查输出info_id、info_text、result、related_infos与提示词模板的字段规范一一对应向下驱动MemUpdateChecker生成具体的 ADD / DELETE 动作从而让 Agent 的长期记忆在持续写入过程中自动去重、自动纠偏、避免信息冲突累积。理解这一对象等于掌握了 openJiuwen 记忆引擎“先检查、后更新”的增量维护机制入口。赞分享人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习【免费下载链接】agent-core-javaopenJiuwen agent core Java是 openJiuwen Core的 Java版本提供AI Agent开发、运行、调优与演进相关的全套SDK能力。项目地址https://gitcode.com/openJiuwen/agent-core-java点击查看免费下载相关推荐FragmentMemoryUnit 碎记忆单元模型详解——openJiuwen agent-core-java 记忆引擎数据模型篇FragmentMemoryUnit 碎记忆单元模型详解——openJiuwen agent core java 记忆引擎数据模型篇 本文围绕 openJiuw人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习openJiuwen agent-core-java 记忆检索结果模型 MemResult 深度解析openJiuwen agent core java 记忆检索结果模型 MemResult 深度解析 MemResult 是 openJiuwen agent人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习DLSS Swapper9 种 DLL、8 个游戏库不更新游戏也能切换缩放版本DLSS Swapper9 种 DLL、8 个游戏库不更新游戏也能切换缩放版本 如果你的游戏还停在上一代 DLSS而新版早就发布你又不想等厂商推送补丁、桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
