疑難排解

分別檢查兩個程序

• 後端不可用：檢查終端機 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。