跨会话保存
背景、偏好和协作笔记保存在你的记忆目录。新的对话可以读取已有文件，继续之前的工作。
PERSISTENT MEMORY FOR AI AGENTS
给 AI 一份
可以读写的记忆。
用文件保存你的背景、偏好和项目进展。
在网页中查看和修正，让 Agent 通过 CLI 读取和更新。
agent-fs login --api-url https://memory.zioon.tech
agent-fs ls /memory/dev.identity
agent-fs cat /memory/dev.identity/profile.md第一次使用？安装 Bun 和 CLI。登录信息自动保存在本机，后续直接继续。
WHAT YOU CAN DO
保存、查找、更新。
一份记忆文件，可以在网页和命令行中使用。
按内容搜索
在控制台搜索文件内容，或用 agent-fs grep 查找关键词，定位散落在不同文件里的信息。
查看版本历史
写入会留下版本记录。查看文件的修改时间和历史版本，了解记忆是如何更新的。
直接编辑原文
在控制台浏览目录、创建文件、编辑和下载。文件在其他地方更新后，保存会提示冲突并保留草稿。
FILES YOU CAN READ
记忆就是文件。
Markdown 适合写背景和笔记，JSON 保存结构化信息，JSONL 记录连续发生的事件。用已有的文件格式，按你习惯的方式整理。
- profile.md
- 你的背景、偏好和协作习惯
- projects/
- 每个项目的上下文与进展
- biography/events.jsonl
- 按时间积累的协作记录
目录与文件内容示例
/memory/dev.identity/
├── profile.md
├── projects/
│ └── zioon/notes.md
└── biography/
└── events.jsonlprofile.md
# 关于我
交流语言：中文
协作偏好：先读项目背景，再开始修改。
## 当前项目
Zioon — 记录决策、进展与下一步。WORK WITH YOUR AGENT
用几条命令，接上记忆。
登录后，Agent 和你使用同一套文件路径与 CLI。
读取背景
开始工作前，先读取已有的偏好和上下文。
agent-fs cat /memory/dev.identity/profile.md写下进展
把新的笔记保存成文件，留给下一次协作。
agent-fs write /memory/dev.identity/notes.md \
--content "项目进展与下一步"搜索内容
按关键词查找记忆，不必逐个打开文件。
agent-fs grep "项目" /memory/dev.identity查看历史
检查某份记忆的写入记录与版本变化。
agent-fs log /memory/dev.identity/notes.mdGOOD TO KNOW
开始之前。
如何开始使用？
进入控制台，登录或注册后即可创建记忆文件。需要在终端中使用时，按文档安装 CLI 并登录。
登录后还要重复配置环境变量吗？
不需要。CLI 把凭据、服务地址和默认存储位置保存在 ~/.agent-fs/config.json，后续可以直接使用；凭据过期或被撤销时重新登录。
网页里能修改 Agent 写下的记忆吗？
可以。网页和 CLI 读写同一份文件。控制台可以查看原文、搜索、编辑、下载和查看版本历史；并发修改发生冲突时，会保留编辑器中的草稿。
Memory 和 agent-fs 是什么关系？
Memory 基于 agent-fs 的 CLI 和文件存储能力，提供 Zioon 账号登录与网页控制台。通过登录配置连接服务，使用 agent-fs 命令管理自己的记忆。
开始整理你的记忆。
在控制台新建文件，或按文档连接 CLI。