故障排查

分别检查两个进程

• 后端不可用：检查终端 A 和 curl --fail http://127.0.0.1:4318/api/health，确认 HOST、PORT 与教程一致。
• 页面不可用：检查终端 B。若 3001 端口被占用，结束自己的冲突进程，或明确选择允许的前端 origin。此版本后端 CORS 接受 localhost/127.0.0.1 的 3000、3001 端口。
• 页面正常但 API 或 WebSocket 失败：使用 NEXT_PUBLIC_API_BASE_URL、NEXT_PUBLIC_WS_BASE_URL，包含 _BASE_。旧 README 中缺少这一部分的示例不对应当前源码。修改环境变量后重启 Next。
• SQLite 原生绑定失败：确认 Node 22，并在同一运行时重新进行锁定安装。其他 Node 版本安装的原生模块可能需要重建，应按实际错误定位。

区分空数据、新工作台和已有工作台

新的 DB_PATH 会创建另一个工作台。初始化配置只在房间数据库为空时使用；修改初始化文件，不会自动替换已有房间。重启时使用相同 DB_PATH 和 ARCHIVE_DIR。相对路径随工作目录变化，所以快速开始提供绝对路径。

归档已列出却无法读取时，检查配置的归档目录下是否仍有文件。导出错误可能来自路径不存在、JSON 无效或目标不可写。导出器生成 template.json，不是完整数据库备份。

对话没有推进

检查 provider/model 设置、选中的角色，以及 ASK 是否有等待回答的问题。本地归档成功不验证凭据、provider 可用性或模型行为。排错时不要反复启动自动对话；检查本地日志，但不粘贴凭据或完整私人对话。

此版本已知限制

这是开发中的网页应用，不是已经验证的桌面发行版或多用户托管服务。浏览器标题与产品 README 使用不同名称。模板导出会省略显示定义，详见归档与预设。本次首次使用验收覆盖本地变量、归档与预设输出；不包含真实模型质量和 OAuth。