如何用 SMFS 把 Supermemory 容器挂载为本地目录并配置 memory paths【免费下载链接】supermemoryMemory and context engine app that is extremely fast, scalable, and can be run fully locally. The Memory API for the AI era.项目地址: https://gitcode.com/GitHub_Trending/su/supermemorySMFS 是 Supermemory 提供的文件系统工具它把一个 Supermemory 容器container挂载成本地目录之后就能用ls、cat、grep这些标准 shell 命令读写记忆不需要引入 SDK。这篇文章覆盖从安装二进制、登录、执行挂载到用--memory-paths指定哪些文件会被 Supermemory 提炼为记忆memories的完整路径以及挂载后的验证与常见状态排查。适用环境为 macOSarm64、x64和 Linuxarm64、x64Windows 暂不支持官方文档明确将其排除在 v0 roadmap 之外。macOS 上挂载走 NFSv3Linux 上走 FUSE两者都由 SMFS 自动处理不需要额外安装。准备条件一个 Supermemory API key。文档中的获取入口是 console.supermemory.ai登录时会被要求输入。一个 container tag。它是你组织里用来划分记忆边界的字符串标识如agent_memory、user_alex命名规则在 Container Tags 文档中有定义不超过 100 个字符只允许字母、数字、-、_、:。挂载时传给smfs mount的就是这个 tag。安装二进制一条命令完成安装二进制会被放到~/.local/bincurl -fsSL https://smfs.ai/install | bash装完后如果smfs不在PATH里把~/.local/bin加进 shell profile然后重开终端。登录登录是一次性操作key 会被存到全局凭据里smfs login它交互式提示输入 Supermemory API key。也可以在脚本里直接传 keysmfs login --key sm_...其中sm_...需要替换成你自己的 API key文档原文即以此占位。挂载容器smfs mount agent_memoryagent_memory是示例中的 container tag替换成你自己的 tag。执行后 SMFS 会在当前目录下创建一个与 tag 同名的文件夹agent_memory/并把容器挂载在那里。挂载以后台守护进程运行并在挂载根写入标记文件.smfs供其他工具以及语义化grepwrapper识别挂载位置。想在其他位置挂载就用--pathsmfs mount agent_memory --path ~/memory验证挂载成功文档给出的验证方式就是用普通文件系统命令读挂载点ls agent_memory/ cat agent_memory/profile.md每个挂载的根目录都有一个虚拟文件profile.md由 Supermemory 自动生成、只读内容是容器内记忆的实时摘要——cat profile.md可以在不遍历所有文件的情况下拿到容器概览。能读到内容即说明挂载可用。再确认守护进程状态smfs status它会显示该挂载的连接状态connectivity、队列深度queue depth和最近一次同步时间。进入挂载目录内部时可以省略 tagSMFS 会自动通过最近的.smfs标记解析也可以用smfs status --json拿结构化输出或smfs list列出本机所有 SMFS 挂载。配置 memory paths这一节是容易踩坑的地方SMFS 不是普通文件系统它会在指定路径的文件上生成 memories——这些文件会被 Supermemory 提取、摘要并索引。挂载点内其他路径的文件仍然可被语义检索默认通过SuperRAG索引不会丢失。默认行为默认情况下名为user.md或memory.md的文件会被当作 memory path。把这些文件放到挂载点任意位置Supermemory 就会自动从它们生成 memories。用--memory-paths自定义在挂载时传入--memory-paths来控制哪些文件成为 memoriessmfs mount agent_memory --memory-paths /notes/,/journal.md文档给出的规则路径是绝对路径以挂载根为锚点必须以/开头结尾带/表示递归匹配该目录下的所有文件/notes/覆盖/notes/foo.md、/notes/2026/march.md等结尾不带斜杠只匹配单个精确文件/journal.md多个路径用逗号分隔传空字符串--memory-paths 会完全关闭 memory 生成省略该 flag 时保留容器 tag 上已有的配置没有则回退到user.md和memory.md。也就是说memory paths 只在挂载时设置想改路径需要 unmount 后带新的--memory-paths重新挂载。同步模式与相关 flag挂载默认是双向同步本地读命中缓存本地写入排队后在后台推送到 Supermemory远端变更按轮询拉取。多写者你、另一个 agent、dashboard场景用默认模式即可。可选分支# 关闭远端变更轮询写入仍会推送适合 agent 是唯一写者、需要稳定读视图的场景 smfs mount agent_memory --no-sync # 缓存只在内存里unmount 后不保留适合 CI、一次性沙箱等短生命周期场景 smfs mount agent_memory --ephemeral其他常用 flag完整列表见 Mount 文档Flag作用--clean挂载前清掉本地缓存从 API 重新拉取--sync-interval secs远端变更轮询间隔默认30秒--drain-timeout secsunmount 时冲刷未完成写入的最长时间默认30秒--foreground守护进程内联运行而不 detach--backend name仅 Linuxfuse默认或nfs--key key显式传 API key存入项目凭据随时强制同步一次推送未完成写入并拉取远端变更smfs sync agent_memory拆掉沙箱前用一次比较稳妥。卸载与收尾smfs unmount agent_memory卸载会按--drain-timeout冲刷完挂起的写入再退出守护进程未冲刷完的部分在下次挂载时恢复。在挂载目录内部执行时 tag 可省略smfs unmount。smfs logout只会移除凭据活动挂载仍在运行直到你显式 unmount。排查文档针对当前场景给出了三个明确的排查路径感觉缓存过期或不同步卸载后用--clean重新挂载它会清掉本地 SQLite 缓存并从 API 拉取最新数据服务端内容不变smfs unmount agent_memory smfs mount agent_memory --clean挂载行为异常 / 二进制疑似损坏smfs install会把当前二进制重新复制进~/.local/bin并重置权限。挂载内语义grep不生效smfs mount首次挂载时会自动安装 shell wrapper写入~/.zshrc。如果升级二进制后失效跑一次smfs init强制重装然后重开终端或source ~/.zshrc。注意 wrapper 只在挂载内检测到.smfs标记生效传任何 flaggrep -r、grep -i等会回落到真正的grep。限制与边界同一台设备上同一个 container tag 不能同时挂载两次一台设备一个 tag 只保留一个挂载不同设备挂同一个 tag 完全支持。同一台设备上可以并行挂载多个不同容器。同一台机器上的多个 agent 可以共用一个挂载点读写的约束就是每个容器每个设备一个挂载。挂载只覆盖 macOS 和 Linux 的 arm64/x64Windows 场景官方文档指向 Bash Toolsupermemory/bash/supermemory-bash作为替代方案见 Bash Tool 文档。更多示例可参考 SMFS 概览 和 安装文档。【免费下载链接】supermemoryMemory and context engine app that is extremely fast, scalable, and can be run fully locally. The Memory API for the AI era.项目地址: https://gitcode.com/GitHub_Trending/su/supermemory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考