FS 快速接入-云监控(CMS)-阿里云帮助中心

将云端记忆服务映射为本地虚拟文件系统，Agent 通过标准 Shell 命令（ls/cat/echo/rm）自主探索和管理记忆，实现 Pull 范式的上下文获取。

前置条件

拥有阿里云账号，并已开通 AgentLoop 记忆库服务。
已在控制台创建 Workspace 和记忆库。
获取 AccessKey ID / Secret。
Linux 或 macOS 系统。

操作步骤

步骤一：安装插件

方式一：让 Agent 自行安装（推荐）

我们提供了一个 INSTALL_PROMPT.md。只需要把这段内容发给你的 Agent（如 Cursor Agent 或 Claude Code），它就会全自动完成：

底层 FUSE 依赖的安装。
Python 包的下载。
环境变量的配置。
自动在后台挂载文件系统。

你甚至可以看着它遇到报错时，自己去查日志、自己修复依赖，直到挂载成功。

方式二：手动安装

如果你更喜欢手动控制，可以按以下步骤操作：

Step 1: 安装 FUSE 依赖

Linux (Ubuntu/Debian):

sudo apt-get install fuse

Linux (CentOS/RHEL):

sudo yum install fuse

macOS:

brew install macfuse

说明

macOS 需要在「系统偏好设置 → 安全性与隐私」中允许 macFUSE 内核扩展。

Step 2: 安装 Python 包

pip install agentloop-memory-fs

Step 3: 配置环境变量

export ALIBABA_CLOUD_ACCESS_KEY_ID=your_access_key_id
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_access_key_secret
export CMS_ENDPOINT=cms.cn-hangzhou.aliyuncs.com
export CMS_WORKSPACE=your_workspace_name
export CMS_MEMORY_STORE=your_memory_store_name

Step 4: 启动挂载

# 创建挂载点
mkdir -p /tmp/agentloop_memory

# 启动文件系统（后台运行）
agentloop-memory-fs /tmp/agentloop_memory &

步骤二：与 AI Agent 集成（核心步骤）

System Prompt 集成是实现 Pull 范式 的关键——让 Agent 自主决策何时检索记忆，而不是被动接收。

配置 System Prompt

在 Agent 的系统提示词中加入以下说明：

Agent	配置文件位置
Qwen CLI	`~/.qwen/QWEN.md`
Claude Code	`~/.claude/CLAUDE.md` 或项目根目录 `CLAUDE.md`
Cursor	`.cursor/rules` 或项目级 `.cursorrules`

# Memory
你具有跨会话持久记忆能力，挂载于 `/tmp/agentloop_memory/store/`。
- 搜索: `cat search/{query}.txt` — 语义搜索，query 为自然语言关键词
- 写入: `echo "内容" > _add.txt` — 异步处理
- 遇到不确定的路径，请 `cat _help.txt`

为什么这样就够了？ Agent 已经具备 Shell 操作能力，只需告诉它“记忆在哪、怎么用”，它就能自主决定何时检索、检索什么。

工作流示例

配置完成后，Agent 会自主展现以下行为：

发现信息缺口 → Agent 意识到需要了解用户背景。
主动搜索 → cat /tmp/agentloop_memory/store/search/用户技术栈.txt。
获取结果 → FUSE 返回 Top-N 相关记忆。
生成回答 → 结合记忆给出精准回复。
主动沉淀 → echo "用户决定采用微服务架构" > /tmp/agentloop_memory/store/_add.txt。

步骤三：验证

# 1. 添加一条记忆
echo "我喜欢用 Vim 编辑器" > /tmp/agentloop_memory/store/_add.txt

# 2. 等待异步处理
sleep 3

# 3. 搜索记忆
cat "/tmp/agentloop_memory/store/search/编辑器偏好.txt"

预期输出：

[
  {
    "id": "019c269b-...",
    "memory": "The user prefers using Vim editor.",
    "score": 0.89
  }
]

卸载文件系统

fusermount -u /tmp/agentloop_memory  # Linux
umount /tmp/agentloop_memory         # macOS

核心操作映射

意图	Shell 命令	等价 API
浏览目录结构	`ls /tmp/agentloop_memory/store/`	-
查看帮助	`cat /tmp/agentloop_memory/store/_help.txt`	-
添加记忆	`echo "用户偏好深色模式" > /tmp/agentloop_memory/store/_add.txt`	`POST /memories`
语义搜索	`cat /tmp/agentloop_memory/store/search/UI偏好.txt`	`GET /search?q=UI偏好`
查看特定记忆	`cat /tmp/agentloop_memory/store/memories/{id}.json`	`GET /memories/{id}`
删除记忆	`rm /tmp/agentloop_memory/store/memories/{id}.json`	`DELETE /memories/{id}`
查看用户全部记忆	`cat /tmp/agentloop_memory/store/users/{user_id}/_all.txt`	`GET /users/{user}/memories`