ai-memory init 详解：wiki/db/raw/logs 数据目录结构大起底

ai-memory init 详解wiki/db/raw/logs 数据目录结构大起底【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory一分钟看懂ai-memory init 是干什么的ai-memory是一个面向编码 Agent CLI如 Claude Code、Codex、Cursor 等的AI 长期记忆系统帮你的 Agent 跨会话、跨厂商保留项目知识。而ai-memory init是安装后要执行的第一步命令它会一次性创建wiki、raw、db、logs等数据目录并生成默认配置文件是整个记忆系统的地基。这一篇文章带你起底这套数据目录结构每个目录存什么、谁可读、能不能手改以及新手最常问的几个问题。一键初始化步骤30 秒完成在终端执行ai-memory init这条命令做了三件事源码见crates/ai-memory-cli/src/commands/init.rs创建数据根目录默认~/.local/share/ai-memory/权限自动设为仅属主可读写创建 4 个子目录wiki、raw、db、models生成默认配置config.toml模板来自crates/ai-memory-cli/templates/config.default.toml并自动写入一个随机token_pepper用于多用户场景的令牌加盐。幂等设计重复执行init是安全的——已存在的目录和配置不会被覆盖。确需重置配置时才加--force。初始化后的目录结构如下~/.local/share/ai-memory/ ├── config.toml # 服务配置绑定地址、衰减参数、认证等 ├── wiki/ # Markdown 知识库长期记忆的真相源 ├── raw/ # 不可变的原始观测数据JSONL 分段 ├── db/ │ └── memory.sqlite # SQLite 派生索引全文/向量检索 ├── models/ # 预留目录放本地嵌入模型 └── logs/ # 按天滚动的运行日志wiki 目录唯一真相源可以手改wiki/是整个系统最重要的目录存放由 LLM 从你的 Agent 会话中提炼出来的 Markdown 知识页面按工作区/项目组织例如concepts/、decisions/、gotchas/等子目录。它的几个关键特性Git 版本化wiki 本身是一个 Git 仓库每次记忆整合、每次会话结束都会产生一次提交改错了可以直接回滚可人工编辑用 Obsidian 或 vim 直接改 Markdown 即可文件监听器会自动把外部修改同步回索引持久可靠SQLite 索引丢了可以重建但 wiki 里的 Markdown 才是不会丢的源数据。下面这张图就是 wiki 内容通过 Web 界面浏览的效果ai-memory 的 wiki 项目视图db 目录可随时重建的派生索引db/memory.sqlite是一个 SQLite 数据库存放的是派生索引而不是源数据页面全文检索FTS5、链接图谱、会话记录、嵌入向量等。所有搜索命令ai-memory search、MCP 的memory_query都走这里。 新手记住一句话wiki 是书db 是书签索引。索引损坏或升级出问题时重建索引即可不会损失 wiki 里的知识。raw 与 logs两个兜底目录raw/存放经过清洗sanitize的、不可变的观测数据JSONL 分段是 wiki 页面背后的原始证据。Agent 可以回溯某条记忆最初来自哪次会话但正常情况下你不用碰它logs/CLI 和服务器写入按天滚动的日志默认为~/.local/share/ai-memory/logs/。排障时优先看这里。值得注意的是如果该位置不可写例如只读沙箱环境ai-memory 会降级到系统临时目录或仅输出到 stderr命令依然可用而不是直接报错。config.toml 里的安全细节值得一看init生成的配置文件默认权限为600仅属主可读写数据目录为700属于防御默认式设计token_pepper自动生成每次全新安装都会产生不同的随机值用于让窃取的用户令牌哈希在离线环境下失效多用户可选配置里预留了root_username等多用户归因字段单机单人场景保持默认即可配置可分离存放init支持--config /etc/ai-memory/config.toml把配置放到数据目录之外数据根目录不变方便 systemd 等系统服务部署。初始化之后打开 Web 界面验证效果服务跑起来后ai-memory serve浏览器访问默认端口49374就能看到你所有工作区和项目的 wiki 概览——每个项目卡片显示页面数量与最近活跃时间这是验证 init 是否成功的直观方式新手常见问题FAQQ1重复执行ai-memory init会破坏数据吗不会。目录创建是幂等的已有config.toml时默认跳过写入只有显式--force才会覆盖。Q2数据目录能放到别的位置吗可以。通过--data-dir参数或环境变量AI_MEMORY_DATA_DIR指定init会在你指定的位置创建同样的结构。Q3raw 和 wiki 到底哪个是真的两者分工不同wiki 是提炼后的长期知识真相源raw 是不可变的原始观测证据。前者面向检索与阅读后者面向审计与回溯。小结目录存什么能否手改丢了会怎样wiki/Markdown 知识页面真相源✅ 推荐损失知识需备份恢复db/SQLite 派生索引❌ 不用管可重建raw/不可变原始观测❌ 只读性质无法回溯证据链logs/按天滚动日志❌ 自动管理仅影响排障跑完ai-memory init后建议定期备份wiki/它是 Git 仓库天然适合版本管理其余目录基本可以设置后忘了它。更多细节可参考项目文档docs/ARCHITECTURE.md与docs/install.md。【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考