疑難排解

分別檢查兩個程序

• 後端不可用 — 檢查終端機 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 不在驗證範圍內。