5 分钟阅读

Memory：记忆文件 CLI

安装 agent-fs 和 Zioon 登录适配，在终端读写与网页相同的记忆文件。

安装固定版本#

先按 Bun 官方文档安装 Bun，再安装 Memory 当前公开支持的 agent-fs 版本与登录适配：

终端

mkdir -p "$HOME/.local/share/zioon-agent-fs"
bun add --cwd "$HOME/.local/share/zioon-agent-fs" @desplega.ai/agent-fs@0.18.5
curl -fsSL https://memory.zioon.tech/downloads/agentfs-login.mjs \
  -o "$HOME/.local/share/zioon-agent-fs/agentfs-login.mjs"
curl -fsSL https://memory.zioon.tech/downloads/install-agentfs-login.mjs \
  -o "$HOME/.local/share/zioon-agent-fs/install-agentfs-login.mjs"
bun "$HOME/.local/share/zioon-agent-fs/install-agentfs-login.mjs" \
  --upstream-cli "$HOME/.local/share/zioon-agent-fs/node_modules/@desplega.ai/agent-fs/dist/cli.js"

本段是 macOS / Linux 的公开安装流程。安装后将 ~/.local/bin 加入 PATH；其他平台与最新兼容信息见 Memory 官方文档。

登录一次#

终端

~/.local/bin/agent-fs login --api-url https://memory.zioon.tech
~/.local/bin/agent-fs auth status

打开显示的链接，确认自己的账号与验证码。登录适配保存服务地址、凭据与默认存储位置，后续不需要重复设置环境变量。

查看、搜索和编辑#

终端

agent-fs ls /memory/dev.identity
agent-fs cat /memory/dev.identity/profile.md
agent-fs grep "项目" /memory/dev.identity
agent-fs write /memory/dev.identity/notes.md --content "今天的协作笔记"
agent-fs log /memory/dev.identity/notes.md

写入实际修改你的记忆文件，并留下版本记录。运行示例前确认文件路径和内容。网页与 CLI 可以看到同一份内容。

退出登录#

终端

agent-fs logout

该命令撤销并移除当前 CLI 登录。网页登录可通过控制台的退出操作结束。

最后核对：2026-10-28 · 能力以实际部署与账号权限为准