OpenKnowledge 实测:MCP 写入与重启恢复
运行发布版 0.89.3 的真实本地服务,用人工 Markdown 验证 MCP 写入、编辑、词法检索、忽略规则、文件监听及重启后的磁盘恢复。
AgentIndex · 发布于 2026-11-07 · 更新于 2026-11-07
OpenKnowledge 把本地 Markdown 编辑器和智能体工具放在同一个工作区。选型时应先验证一个基础问题:智能体报告保存后,文件是否真正落盘、可被检索,并在服务重启后仍然可读?本篇直接启动发布包的 HTTP/MCP 服务验证这条链路。
发布版 0.89.3 完成了本次写入、定点替换、磁盘回读与重启恢复。服务还索引了外部新建文件;不存在的替换文本被明确拒绝,文件没有变化。结果支持把它作为本地文档与智能体之间的连接层候选,但不等于已经证明 AI 写作质量、可视化编辑保真或团队同步可靠性。
测试对象是 npm 发布包
2026 年 11 月 7 日,我们安装 @inkeep/[email protected],实际执行它分发的 dist/cli.mjs。源代码审查对应发布标签 v0.89.3,提交 2a5c081bda0d0dedcccee4ae1f7ddd959032fbc0。记录同时包含 npm integrity 与已安装入口文件 SHA-256,没有把主分支的新功能默认算到发布版里。固定发布源码
环境为 macOS 26.6.2、Node.js 26.3.0 ARM64,满足包要求的 Node 24+。项目初始化采用 --no-mcp --no-skills --content-dir notes,保留真实个人编辑器配置;启动使用专用临时项目、回环地址和独立端口,并关闭自动打开浏览器。本次没有向真实客户端安装技能。
测试子进程不继承模型 API Key 或令牌类环境变量,检索显式指定 semantic:false,只验证本地词法检索。没有云模型、嵌入提供商或 GitHub 账号参与。复现脚本和结果
服务实际提供了什么
初始化创建 .ok 配置和临时 Git 仓库,结构化输出说明 MCP 注册被跳过。启动后,Web 页面的 HTML 与引用的一项前端资源都返回 HTTP 200;API 可以读回预先写入的中文 Markdown。
随后,我们按 MCP 协议初始化会话、完成初始化通知并请求工具清单。服务实际公布了 19 个工具,包括 search、write、edit、exec、历史与链接相关操作。这个数量是接口清单,不是已经测试了全部 19 项。
| 实际流程 | 结果 |
|---|---|
| API 读取预置中文文档 | HTTP 200,内容正确 |
| 词法检索人工唯一词 | 返回对应文档及片段 |
MCP write | 返回已应用、已保存;磁盘出现真实 Markdown |
MCP edit 定点替换 | 返回已应用;磁盘读回替换后的词 |
| 替换不存在的文本 | 返回错误、未保存、建议重读;文件内容不变 |
../ 越界写入 | 拒绝;测试范围外没有生成对应文件 |
| 外部新建 Markdown | 文件监听后可以检索到 |
| 结束进程后重新启动 | API 和检索仍能读到已修改内容 |
页面和资源能加载,只证明发布包服务了前端。我们没有在编辑器中操作富文本、拖拽组件或双向转换复杂文档,不把 HTTP 成功描述成完整 UI 验收。
保存结果与文件结果相互核对
MCP 写入内容包含标题、人工唯一标记和中文。服务返回 outcome: applied、saved: true、nextStep: none;我们随后在内容目录找到 Markdown,读取到预期字节。定点替换后再次检查磁盘,而不是只相信工具的成功文字。
另一个请求尝试替换不存在的字符串,结果是 isError: true,结构化结果报告 refused、saved: false 和 nextStep: re-read。磁盘内容保持不变。这给智能体明确的恢复方向:重新读取当前文档再生成修改,而不是盲目重试原操作。编辑实现
写入与编辑还带回预览链接和“尚未连接浏览器”的提示。本次没有自动执行那段提示,因此评测没有在不知情下变成客户端界面操作。调用方也应区分内容已经保存和预览界面已经连接。
词法检索、监听与忽略规则
对预置文档的人工唯一词查询,返回正确路径和内容片段。用普通文件系统接口新增另一份 Markdown 后,运行中的 MCP 检索也找到了它,验证了外部写入被监听、进入索引的路径。
我们还通过内容目录中的 .okignore 排除一个人工 private/ 子目录。查询其中独有的假标记没有命中文档。这只是所测索引过滤规则,不是文档权限、机密隔离或全部访问接口的认证。
这些查询使用小型人工语料和容易区分的唯一词,不是语义相关性、中文分词质量或大规模索引性能基准。源码说明启用语义检索时,查询与匹配内容会发给配置的嵌入提供商;本次用 semantic:false 明确排除了那条路径。检索接口
重启恢复覆盖到哪一层
完成修改后,我们结束实际服务进程,再用相同临时项目启动新的服务进程,建立新的 MCP 会话。API 读回修改后的内容;词法检索也返回同一文档。恢复对象是磁盘文档和重新可用的索引,不是模型对话、运行中的任务或任意进程内状态。
另一个请求使用含 ../ 的文档路径,服务返回参数错误,内容目录之外没有生成测试文件。这说明选定写入入口的路径限制生效,没有形成对整个应用的攻击面审计。写入实现
本篇也没有突然断电、并发编辑冲突、磁盘写满或 Git 仓库损坏的测试。因此,正常进程重启成功不能扩展为所有故障下的数据可靠性承诺。
采用判断
如果已有 Markdown 内容,希望让智能体以结构化工具修改并检索它,同时保留可直接读回的文件,这个发布版值得在副本上试用。先限定内容目录、选择检索方式,再用自己的文档跑通写入、失败恢复和重启检查。项目采用 GPL-3.0-or-later,依赖和部署方式也应纳入团队评估。
桌面安装、模型写作、WYSIWYG 往返、多人协作、GitHub 自动同步、分享链接、远程暴露与 Windows/Linux 均没有纳入本次验收。需要比较另一种本地知识整理方式,可看 Obsidian Second Brain 评测;需要审查技能安装产生的文件,可看 Claude Code Templates 实测。