常见问题
所有能力都需要 LLM 吗？
不需要。文件读写、关键词检索和 wikilink 遍历可以直接使用；Auto Memory、Auto Resource 和 Auto Dream 的主要整理阶段需要 LLM；向量语义检索需要 embedding。记忆存在哪里？
默认在启动目录的.reme/。用 workspace_dir= 可以指定其他位置。记忆主体是普通文件，可以用 git 或文件同步工具备份；metadata/ 是可重建的派生状态。
可以直接编辑记忆吗？
可以。daily/ 和 digest/ 中的 Markdown 就是用户界面。编辑长期结论时尽量保留来源链接；移动和删除文件时优先使用 ReMe action，避免留下悬空链接。
HTTP 和 MCP 怎么选？
CLI、脚本和普通应用使用默认 HTTP；原生支持 MCP 的 Agent 使用 MCP。两种服务暴露同一组 job，并共享 workspace。可以在接入概览中比较不同边界。故障排查
服务无法启动或端口被占用
默认端口是2333。先定位已有进程，或换端口：
reme search 等命令连接失败
普通 action 会连接运行中的服务。确认服务存在，并避免手工指定与服务不一致的 backend、transport、host 或 port：
MCP 客户端无法连接
推荐使用 streamable HTTP：http://127.0.0.1:2333/mcp。检查客户端没有使用 SSE URL、错误端口或 HTTP backend。
Auto Memory / Auto Dream 报模型错误
确认启动 ReMe 的目录中存在.env，或环境变量已导出：
reme/config/default.yaml 为准。
开启 embedding 后维度不匹配
embedding 模型的输出维度必须与配置一致。更换模型或维度后，旧向量不能复用，修正配置并重建索引：新文件搜索不到
确认：- ReMe 服务正在运行；
- 文件位于
daily/、digest/或resource/； - 文件类型在 watcher 支持范围内；
- 写入后已给后台 watcher 短暂处理时间。
reme reindex。若直接修改了服务未监听的文件，索引不会自动更新。
Claude Code 会话没有自动记录
确认 ReMe MCP 服务仍在运行、plugin 的.mcp.json 地址正确，并查看 plugins/reme/logs/auto_memory_hook.log。Stop hook 是异步 best-effort，服务不可达时不会阻塞 Claude Code。
反馈问题
仍无法解决时，请在 GitHub Issues 提供：- ReMe 版本和操作系统；
- 启动命令与实际 backend / transport；
- 最小复现步骤和完整错误；
- 是否启用了 LLM、embedding 或自定义配置。