MemAgora

jarvis.memagora 是 Jarvis 官方 canonical 知识库插件。当前公开版本是 0.3.3。

安装后，Jarvis 会管理本机 memagorad 服务，并向 worker 提供三个 MemAgora MCP 工具：memagora.search、memagora.fetch 和 memagora.upload。插件还贡献一个 canonical workflow：/curate-knowledge。

它提供什么

能力	当前行为
本地服务	Jarvis 下载、校验、安装并启动 `memagorad@0.1.0`
数据目录	默认使用 `${jarvisDataDir}/data/memagora`，可通过 Jarvis KB 设置指向用户配置路径
MCP search	`memagora.search` 只读检索本地知识库
MCP fetch	`memagora.fetch` 按 `ref` 读取具体记忆源
MCP upload	`memagora.upload` 写入 intake，必须 `explicit_intent=true`
Workflow	`/curate-knowledge` 启动 `knowledge-curation`，整理 note、session、project、raw source 或 pending uploads

MemAgora 在 Jarvis 中更接近“本地知识库 sidecar + workflow”，不是网页服务，也不是 hosted MemAgora MCP endpoint。

安装

推荐使用本机 Jarvis UI：

打开 Settings -> Extensions。
进入 Marketplace。
找到 jarvis.memagora。
打开详情并审查版本、权限、签名和 native dependency。
确认安装。需要本机 daemon 时，同意 Jarvis 下载和校验 memagorad。
安装完成后启用插件。
检查 MemAgora readiness，确认 service ready。

CLI 等价命令：

.venv/bin/jarvis extensions registry-install jarvis.memagora --version 0.3.3 --enable --install-native-dependencies

如果不传 --install-native-dependencies，CLI 不会安装 memagorad。这种状态适合只审查 pack，不适合验证完整 MemAgora 工具链。

使用 workflow

安装并启用后，可以在 Jarvis 聊天中使用：

/curate-knowledge <note | session | project | raw source | pending uploads>

这个 workflow 的目标是把待整理内容转换成可审查的知识条目或 upload-ready payload。它不是把所有会话自动写入知识库；写入仍要经过明确意图和 schema 约束。

Worker 工具

Jarvis worker 启动时会通过 internal MCP relay 获得 MemAgora 工具。

工具	读写	用途
`memagora.search`	只读	搜索本地 MemAgora 知识库
`memagora.fetch`	只读	根据 search 返回的 `ref` 拉取源内容
`memagora.upload`	写入	上传明确要进入知识库 intake 的内容

memagora.upload 要求 explicit_intent=true。如果 agent 没有用户明确要求、workflow 交接明确要求或当前任务的 durable handoff 需求，就不应该调用 upload。

更新和修复

在 Settings -> Extensions 的 Updates 视图检查 jarvis.memagora：

已安装版本低于 catalog latest 时，Jarvis 会显示可用更新；
update apply 会重新校验 artifact、签名、review fingerprint 和能力变化；
native dependency 会在更新时重新 preflight，Jarvis 可复用 SHA 匹配的既有二进制；
如果 service down，先在插件详情或 MemAgora readiness 中查看 native service 状态，再重试安装/更新。

当前 live catalog 的 latestVersion 是 0.3.3。安装成功后，更新检查应显示 installed/latest 均为 0.3.3 且 state 为 up to date。

隐私

MemAgora 数据属于用户本机知识库边界。插件文档、catalog、PR 和公开日志都不应包含：

KB 正文；
真实本机绝对路径；
私有条目名；
原始会话内容；
API key、token 或其它 secret。

memagorad 只绑定 loopback。Jarvis 管理 native dependency 下载、hash 校验、安装位置、启动参数和健康检查。

更新日志

0.3.3

通过 descriptor-first internal MCP 暴露 search、fetch 和 upload。
fetch 使用 GET /v1/memories/{ref}，支持 Jarvis relay 安全渲染 path 参数。
upload 使用 POST /v1/memories，并要求 explicit_intent=true。
保留一个 canonical 知识整理 workflow：knowledge-curation，命令为 /curate-knowledge。

0.3.x

退役旧查询/写入端点和散乱 workflow。
使用 Jarvis host-managed memagorad，不让 pack 自行下载或启动任意代码。
将 MemAgora 从“配置档示例”收束为本地知识库插件 MVP。

支持

排障时记录以下信息即可，不要贴 KB 内容：

Jarvis 版本；
jarvis.memagora installed/latest version；
native service readiness；
update check state；
worker 是否能看到 memagora.search、memagora.fetch、memagora.upload；
失败步骤是 install、enable、service health、search、fetch 还是 upload。

源码

当前公共 marketplace 展示的是可安装 artifact、文档、隐私、更新日志和支持入口。插件包源码由维护者仓库构建发布；公开文档不应把私有仓库路径或本机路径写入 catalog。