okf-memory/okf-agent-memory
本机核实 okf-agent-memory 是否可用
本机核实 okf-agent-memory 0.1.2：可安装、建库、写入、检索、读回；完好库检查通过，缺少规范抬头时检查不通过。
实验田正式路线
这项项目没有绕过实验田。
01 · 问题
我想解决什么
本实验的背景与起因 一、工作里真正卡住的地方 现在做开发，很多人已经把 AI 对话当成日常工作台的一部分：需求在对话里说，方案在对话里改，报错也在对话里排查。短任务还好办，屏幕上几屏文字扫得过来。任务一拉长，问题就暴露出来。前面已经确认过的命名约定、接口字段、环境限制、否决过的方案、修通过的报错原因，会随着窗口滚动离开眼前。下一轮继续时，要么重新翻历史消息，要么把旧笔记大段粘贴回去。翻漏了，就按过时结论往下改；贴多了，上下文又臃肿，真正关键的几句话反而更难定位。 这不是「有没有记过」的问题，而是「记过的东西能不能在需要时被稳定地找回，并且还能分辨哪些条目已经不完整、不可直接采信」。人可以凭印象说「好像写过」，机器和下一轮对话却不能靠印象工作。没有可检索、可核对的落点，所谓记忆就只是散落在聊天记录和临时文件里的碎片。 二、常见补救为什么仍然费劲 为了补上这个缺口，常见做法并不少。有人写在本地记事本，有人写在云文档，有人写在仓库某个说明文件里，有人把结论塞进个人知识库。这些材料对人阅读往往够用，可一旦要服务「写代码时的连续工作」，就会碰到几类实际麻烦。 第一，入口不统一。笔记在 A 处，代码在 B 处，对话在 C 处，要用的时候先花时间找地方。第二，结构不统一。有的只有一段话，有的缺标题，有的缺时间与适用范围，后人（包括下一轮 AI 对话）很难判断这条还算不算数。第三，检索不统一。文件名、标题、正文用词不一致时，关键词对不上，明明写过也等于没有。第四，缺少使用前的检查。条目缺关键抬头、缺必要说明时，没有一道固定手续在采用前把问题标出来，只能靠人眼临场发现，发现晚了就会把错误前提带进后续修改。 于是就出现一种很常见的循环：越依赖对话推进工作，越需要外部记忆；外部记忆越散，对话越要反复补上下文；补上下文越多，真正有效的信息占比越低。要打断这个循环，需要的是本机可写、可搜、可检查的记忆方式，而不是再多开几个临时文档。 三、为何选 okf-agent-memory okf-agent-memory 是面向上述场景的开源项目，仓库地址：https://github.com/okf-memory/okf-agent-memory 。它把知识条目放在本机目录中管理，并可纳入 Git；提供本机检索，便于按词找回概念；也提供检查能力，便于发现结构不完整、抬头不规范等问题。它不要求先搭建外部数据库，也不把「还能不能记住」完全押在某次云端会话是否仍开启。 对本实验而言，它的价值不在宣传句子，而在能否用真实机器跑出可核对的结果：装得上还是装不上，写得进还是写不进，搜得到还是搜不到，检查在完好资料与不规范文件两种情况下分别给出什么报告，读回时内容是否还在。把这些跑清楚，才谈得上它是不是「本机可用的记忆库」。 四、本实验要核实的问题 本实验在本机核实下列事项： 1. 软件能否安装，版本是否明确； 2. 能否初始化出记忆库； 3. 一条笔记能否写入； 4. 用与内容相关的关键词搜索时能否命中； 5. 库内资料完好时，检查是否通过； 6. 库中存在缺少规范抬头的文件时，检查是否不通过，并能否指出问题； 7. 已写入内容能否再读回。 本机环境为 macOS（ARM），软件版本为 okf-agent-memory 0.1.2。实际操作顺序为：查询版本；初始化记忆库；写入笔记；关键词搜索；对完好库做检查；加入缺少规范抬头的文件后再次检查；读回笔记。各次输出与退出码分别留档，作为结论依据。
02 · 过程
我是怎样做的
实验过程 本机环境为 macOS，芯片架构为 ARM。所用软件为 okf-agent-memory，版本 0.1.2，由官方发布的 macOS ARM 可执行文件安装到本机工作目录后使用。实验不依赖外部数据库，所有操作均在本机目录中完成。每一操作的标准输出、标准错误与退出码分别写入日志文件，并配有对应截图，便于事后逐条核对，而不是事后凭印象概括。 第一步：确认安装与版本。 在本机终端进入工具所在目录，执行版本查询命令。命令能够正常启动，并打印版本号 0.1.2，退出码为 0。若这一步失败，后续建库、写入与检查都没有讨论基础，因此把它单独留下完整输出。本步确认：本机跑的就是 0.1.2，而不是其它版本或空命令别名。 第二步：初始化记忆库。 在指定工作目录执行初始化。初始化会在该目录下生成记忆库所需的基础文件与目录结构，包括清单类文件与运行日志等。本步退出码为 0。初始化完成后，检查目录内容，确认基础结构已经落地。没有这一步，就不存在可写入的落点，后面的笔记与检索都无从谈起。 第三步：写入一条笔记。 在已初始化的记忆库中新建一条概念类笔记，写入与本机留存、检索相关的正文，保存后退出码为 0。本步要核实的是：工具是否真能把一条可读内容写入库中，而不是只提供空转命令。写入成功后，库内应能看到对应条目文件或等效记录。 第四步：按关键词搜索。 使用与笔记正文相关的词语作为检索词，在记忆库中执行搜索。本机返回了命中结果，其中包含刚写入的条目，退出码为 0。本步要核实的是：内容写进去之后，能否在需要时被关键词找回。若检索长期空结果而正文确实存在，则「可检索」不能成立；本机本次可以命中。 第五步：资料完好时的检查。 在库内仅含规范内容、尚未放入缺抬头文件时，执行检查命令。检查报告为通过，退出码为 0。本步建立正常基线：库干净时，检查应当放行。基线有了，后面再放入不规范文件时的失败，才有对照意义。 第六步：存在缺少规范抬头的文件时再检查。 在记忆库中加入一份缺少规范抬头的文件，其它条件尽量不变，再次执行同一套检查。检查结果为不通过，退出码为 1，输出中能够指出该文件存在抬头方面的问题。本步与第五步对照：同一检查命令，在完好库与含不规范文件的库上表现不同；失败不是含糊跳过，而是带有可阅读的问题说明。 第七步：读回已写入的笔记。 按条目标识读回第三步写入的笔记正文。读回内容与写入时一致，正文仍在，退出码为 0。本步收束「写入是否只是表面上成功」：只有能读回，写入—检索—读出才构成闭环。 过程汇总：七步均在本机真实执行；第 1、2、3、4、5、7 步退出码为 0；第 6 步退出码为 1。日志与截图按步分别保存。
03 · 结果
实际发生了什么
实验结果 一、安装与环境 okf-agent-memory 在本机可以安装并运行。版本查询显示 0.1.2。后续步骤均基于该版本在 macOS ARM 本机执行，不依赖外部数据库服务。 二、建库与写入 初始化后，记忆库目录与基础文件可以生成。向库中写入一条笔记可以成功完成，退出码为 0。说明工具能够形成可落盘的内容条目，而不是只能打印帮助信息。 三、检索与读回 使用与笔记内容相关的关键词搜索时，可以命中对应条目，退出码为 0。再按条目读回，正文仍在，退出码为 0。说明「写入 → 找回 → 读出」在本机可以走通，记忆不是写完即失的临时缓存。 四、检查能力 在资料完好时，检查结果为通过，退出码 0。在库中存在缺少规范抬头的文件时，检查结果为不通过，退出码 1，并且能够指出该文件的问题。两相对照，检查具有实际区分能力：完好库与含不规范文件的库，不会得到相同的「一概通过」结果。 五、综合判断 就本机这次实测而言，okf-agent-memory 能够满足下列基本用途：安装可用；建立记忆库；写入笔记；按关键词检索；读回内容；在资料完好时通过检查；在出现缺少规范抬头的文件时给出不通过报告。 本轮结论严格限制在上述本机事实。项目主页或其它材料中的省字比例、性能数字、适用面等说法，若要成立，需要另开对应实测，不能由本次安装与读写检查直接推出。 六、对起因的回应 起因是：长对话里约定与结论容易丢失，散落笔记又难检索、难核对。本机结果表明，至少在「能装、能写、能搜、能读回、能对不规范文件给出检查失败」这一层，okf-agent-memory 提供了一条可操作的本机路径。它是否成为日常主力，取决于后续是否持续写入有质量的条目、检索词是否与内容匹配，以及是否接受把记忆放在本机目录与 Git 中管理；那些属于使用方式问题，不是本次「能不能用」的同一问题。
04 · 避坑
哪些地方值得注意
搜索词需要与写入内容相关，词不对题时未命中不能单独证明检索失效。检查结果取决于库内文件是否规范：完好库与含不规范文件的库结果本就不同。结论绑定本机版本与系统：macOS ARM、okf-agent-memory 0.1.2。本轮未覆盖云端集成与多人协作流程。
05 · 最终评价
这次实验的结论
本机核实结论：okf-agent-memory 0.1.2 可以安装；可以建库、写入、检索与读回；资料完好时检查通过；存在缺少规范抬头的文件时检查不通过。就「本机是否可用」这一问题，答案是可用，且检查具有区分能力。
实验日志时间线
这项实验是怎样一步步做出来的。
- 01
第1步：确认软件版本 在本机执行 okf version。 命令输出： okf version v0.1.2 (OKF v0.2 specification) EXIT:0 结果：版本为 0.1.2，退出码 0。本机可以启动该工具。
第1步：确认软件版本 第1步：确认软件版本 收成证据15 - 02
第2步：初始化记忆库 在工作目录执行 okf init，建立记忆库基础目录与文件。 命令输出： Initialized OKF v0.2 bundle in '/Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-08/03-experiment/v31-prod-20260908T0709/okf/workdir/bundle' EXIT:0 total 16 drwxr-xr-x@ 4 luanjian staff 128 Sep 8 09:11 . drwxr-xr-x@ 3 luanjian staff 96 Sep 8 09:11 .. -rw-r--r--@ 1 luanjian staff 46 Sep 8 09:11 index.md -rw-r--r--@ 1 luanjian staff 69 Sep 8 09:11 log.md 结果：初始化完成，退出码 0。记忆库目录已生成。
第2步：初始化记忆库 第2步：初始化记忆库 - 03
第3步：写入一条笔记 向记忆库写入一条概念笔记。 命令输出： Created concept 'lab-genoffice-note.md' (Lab note free office) in '/Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-08/03-experiment/v31-prod-20260908T0709/okf/workdir/bundle' EXIT:0 结果：笔记写入成功，退出码 0。
第3步：写入一条笔记 第3步：写入一条笔记 - 04
第4步：按关键词搜索 使用与笔记内容相关的关键词在记忆库中检索。 命令输出： Found 1 matching concept(s) in '/Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-08/03-experiment/v31-prod-20260908T0709/okf/workdir/bundle': 1. [2.88] lab-genoffice-note (Fact) Matches: title, body EXIT:0 [ { "concept_id": "lab-genoffice-note", "title": "Lab note free office", "type": "Fact", "description": "", "score": 2.88, "matched_on": [ "title", "body" ] } ] 结果：检索命中对应条目，退出码 0。
第4步：按关键词搜索 第4步：按关键词搜索 - 05
第5步：对完好库做检查 在库内资料完好时执行 okf validate。 命令输出： OKF v0.2 check of "/Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-08/03-experiment/v31-prod-20260908T0709/okf/workdir/bundle" (v0.2): 1 concept(s), 0 error(s), 0 warning(s); 0 broken link(s), 0 orphan(s), 0 stale. Conformant. EXIT:0 结果：检查通过，退出码 0。
第5步：对完好库做检查 第5步：对完好库做检查 - 06
第6步：库中有缺少规范抬头的文件后再检查 在记忆库中加入一份缺少规范抬头的文件后，再次执行 okf validate。 命令输出： warn concepts/broken-bad.md: orphan (no concept links in or out) warn lab-genoffice-note.md: orphan (no concept links in or out) error concepts/broken-bad.md: missing YAML frontmatter block OKF v0.2 check of "/Users/luanjian/.codex/.chatgpt-projects/g-p-6a95b9dda1a88191959a9d5876b34d3b/outputs/2026-09-08/03-experiment/v31-prod-20260908T0709/okf/workdir/bundle" (v0.2): 2 concept(s), 1 error(s), 0 warning(s); 0 broken link(s), 2 orphan(s), 0 stale. NOT conformant. EXIT:1 结果：检查未通过，退出码 1，并指出该文件缺少 YAML 抬头等问题。
第6步：库中有缺少规范抬头的文件后再检查 第6步：库中有缺少规范抬头的文件后再检查 - 07
第7步：读回笔记 按条目标识读回已写入的笔记正文。 命令输出： ID: lab-genoffice-note Type: Fact Title: Lab note free office Description: Generated: 2026-09-08T01:11:28Z by agent/cli --- Body --- Online office got expensive; need free local memory for agents. EXIT:0 结果：正文可读回，退出码 0。
第7步：读回笔记 第7步：读回笔记
收成区 · 与本实验绑定
报告、长文、视频材料和下载包都从上面的日志长出来。
“已产出”表示内容和文件已经形成，不代表核心 3D 界面的端到端验收已经通过。本实验仍保留为“进行中”。
实验报告 · okf-agent-memory
# 实验报告 · okf-agent-memory 本机核实 - 日历日：2026-09-08 - run_id：v31-prod-20260908T0709 - experiment_id：1059bb13-e0fd-4242-ada3-6515f07a4b63 - 仓库：https://github.com/okf-memory/okf-agent-memory - 版本：0.1.2（macOS ARM 本机二进制） - 试验田：https://jianailab.com/studio/field?experiment=1059bb13-e0fd-4242-ada3-6515f07a4b63 ## 背景 长对话写代码时，约定、接口结论与已确认教训容易被冲掉。散落在记事本、云文档、仓库说明里的备忘，对人可读，却难以统一检索与使用前检查。okf-agent-memory 将知识条目放在本机目录，可纳入 Git，提供检索与检查，不依赖外部数据库。 ## 环境 - 系统：macOS ARM - 工具：okf-agent-memory 0.1.2 - 工作目录：03-experiment/.../okf/workdir/bundle ## 实测步骤与退出码 | 步 | 操作 | 退出码 | |---|---|---| | 1 | okf version | 0 | | 2 | okf init | 0 | | 3 | okf create（写入笔记） | 0 | | 4 | okf search（关键词检索） | 0 | | 5 | okf validate（完好库） | 0 | | 6 | okf validate（含缺少规范抬头的文件） | 1 | | 7 | okf show（读回） | 0 | 各步标准输出见 okf/logs/；试验田每步含文字、2 图、1 视频。 ## 结果 - 可安装，版本 0.1.2 - 可建库、写入、按关键词命中、读回 - 完好库检查通过；缺抬头文件时检查不通过并指出问题 - 本轮不评价宣传中的省字比例等指标 ## 结论 在本机条件下，okf-agent-memory 可用，检查具有区分能力。
长文章 · okf-agent-memory 本机核实
# 本机记忆库能不能用？我们装了 okf-agent-memory 跑了一遍 ## 导语 用 AI 写代码、改项目时，对话一长，前面确认过的命名、接口字段、报错原因，常常滚出屏幕。下一轮要么翻历史，要么把大段笔记再贴回去。翻漏了就按过期说法继续改；贴多了，上下文臃肿，关键几句更难找。问题不只是「有没有记过」，而是记过的东西能不能稳定找回，以及不完整的条目能不能在使用前被标出来。 开源项目 okf-agent-memory（https://github.com/okf-memory/okf-agent-memory）把面向编程场景的知识条目放在本机目录里管理，可以纳入 Git，提供检索，也提供结构检查，不必先搭外部数据库。2026 年 9 月 8 日，剑的 AI 实验室在 macOS（ARM）本机安装 0.1.2 版，按真实命令完成建库、写入、搜索、检查与读回，并把每一步的输出、截图和录屏留在试验田。 本文只依据这次本机事实，不保证任何团队用法，也不把宣传材料里的其它数字写成已验证结论。 ## 一、项目定位与使用边界 okf-agent-memory 面向「本机可写、可搜、可检查」的知识条目管理。条目以文件形式落在本地，便于版本管理；检索按关键词找回概念；检查用于发现缺抬头、结构不完整等问题。它适合需要把约定和结论从聊天窗口挪到可复核落点的开发者。本次实验不涉及多人协作服务、云端同步产品对比，也不评价「能省多少字」一类宣传口径。 ## 二、安装过程 本机为 macOS ARM。使用官方发布的 darwin-arm64 可执行文件，版本查询结果为 0.1.2。工具可正常启动。安装路径与工作目录记录在当日实验包 `03-experiment/v31-prod-20260908T0709/okf/` 下。不依赖外部数据库服务。 ## 三、运行记录 实际完成七步，各步命令不同，退出状态分别留档。 第一步，执行版本查询，得到 0.1.2，退出码 0。确认后续步骤建立在明确版本之上。 第二步，初始化记忆库，在工作目录生成基础目录与清单类文件，退出码 0。没有这一步，就不存在可写入的落点。 第三步，写入一条概念笔记，退出码 0。说明工具能够把可读内容写入库中，而不是只能打印帮助信息。 第四步，用与笔记内容相关的关键词检索，命中对应条目，退出码 0。说明写入之后可以按词找回。 第五步，在库内资料完好时执行检查，结果通过，退出码 0。建立「干净库」基线。 第六步，在库中加入一份缺少规范抬头的文件后，再次执行检查。结果不通过，退出码 1，输出指出该文件缺少 YAML 抬头等问题。与第五步对照，同一检查在两种库状态下表现不同。 第七步，按条目标识读回笔记正文，内容仍在，退出码 0。写入—检索—读出形成闭环。 试验田实验页对上述七步均保留中文说明、截图与录屏，地址为 https://jianailab.com/studio/field?experiment=1059bb13-e0fd-4242-ada3-6515f07a4b63 。 ## 四、未通过与未测试 第六步在含不规范文件时检查不通过，属于预期中的产品行为，不是安装失败。本次未测试云端集成、多人同时写入、大规模词库性能，也未复核项目宣传中的省字比例或其它业务指标。结论仅覆盖本机安装、读写、检索与检查区分能力。 ## 五、对读者的可执行含义 若你也在长对话里反复丢失约定，可以关注这条路径：把稳定结论写入本机记忆库，用关键词找回，在采用前跑一遍检查。完好资料应能通过；缺抬头、结构残缺的文件应被标出，而不是 silently 混进上下文。 使用时注意：搜索词要与写入内容相关，否则「未命中」不能单独说明工具失效；检查结果随库内文件是否规范而变；换系统或换版本后应重新核实。 ## 六、想自己试 1. 在 GitHub 搜索 okf-memory/okf-agent-memory，打开官方仓库。 2. 按说明取得与本机架构匹配的版本（本次为 0.1.2，macOS ARM）。 3. 先查版本，再初始化记忆库，写入一条短笔记，用相关词搜索，读回正文。 4. 对完好库做一次检查；如需观察失败报告，可对照官方规范准备一份缺抬头样例后再检查。 5. 把输出与退出状态自己留档，对照本文结论。 ## 结论 在 2026-09-08 的本机条件下，okf-agent-memory 0.1.2 可以安装，可以建库、写入、检索与读回；资料完好时检查通过，存在缺少规范抬头的文件时检查不通过。它提供了一条可操作的本机记忆路径。是否成为日常主力，取决于你是否持续写入有质量的条目、检索词是否匹配，以及是否接受把记忆放在本机目录与 Git 中管理。 这里是剑的 AI 实验室。每天选一个开源项目，装上，跑一遍，把结果公开记录。