常见问题
所有能力都需要 LLM 吗？
不需要。文件读写、关键词检索和 wikilink 遍历可以直接使用；Auto Memory、Auto Resource 和 Auto Dream 的主要整理阶段需要 LLM；向量语义检索需要 embedding。记忆存在哪里？
默认在启动目录的.reme/。用 workspace_dir= 可以指定其他位置。持久记忆是普通文件，可以用 git 或文件同步工具备份；metadata/ 是可重建的派生状态，mem_session/ 保存 Agent wrapper 生成的运行态。
可以直接编辑记忆吗？
可以。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 服务正在运行；
- Markdown 记忆位于
daily/或digest/； resource/下的来源文件是md、txt、json、jsonl、csv、yaml或html，且 Auto Resource 已生成对应 daily 卡片；- 写入后已给后台 watcher 短暂处理时间。
reme reindex。完整重建还会扫描 resource/ 和 JSONL；实时索引 watcher 则特意只处理 daily/ 和 digest/ 下的 Markdown。
ReMe Studio 无法访问
只有找到 Web 构建产物时，HTTP 服务根路径才会提供 Studio；即使没有 Studio，Job API 仍可用。请确认当前是 HTTP backend，并安装包含 Web 构建的包，或通过service.web_static_dir / REME_WEB_STATIC_DIR 指定包含 index.html 的目录。
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 或自定义配置。