疑難排解

日誌檔案

VMark 會寫入日誌檔案以協助診斷問題。日誌包含來自 Rust 後端和前端的警告與錯誤資訊。

日誌檔案位置

平台	路徑
macOS	~/Library/Logs/app.vmark/
Windows	%APPDATA%\app.vmark\logs\
Linux	~/.local/share/app.vmark/logs/

日誌層級

層級	記錄內容	正式環境	開發環境
Error	失敗、當機	是	是
Warn	可復原的問題、降級處理	是	是
Info	關鍵節點、狀態變更	是	是
Debug	詳細追蹤資訊	否	是

日誌輪替

• 最大檔案大小：5 MB
• 輪替策略：保留一個歷史日誌檔案
• 舊日誌會被自動替換

回報 Bug

回報 Bug 時，請包含以下資訊：

1. VMark 版本 — 顯示在導覽列徽章或「關於」對話框中
2. 作業系統 — macOS 版本、Windows 組建編號或 Linux 發行版
3. 重現步驟 — 問題發生前你做了什麼操作
4. 日誌檔案 — 附上或貼上相關的日誌條目

日誌條目帶有時間戳記並按模組標記（例如 [HotExit]、[MCP Bridge]、[Export]），方便查找相關內容。

查找相關日誌

1. 根據上表開啟日誌目錄
2. 開啟最新的 .log 檔案
3. 搜尋問題發生時間附近的 ERROR 或 WARN 條目
4. 複製相關行並附在你的 Bug 回報中

常見問題

應用程式在 Windows 上啟動緩慢

VMark 針對 macOS 進行了最佳化。在 Windows 上，由於 WebView2 初始化，啟動可能較慢。請確保：

• WebView2 Runtime 已更新至最新版本
• 防毒軟體沒有對應用程式資料目錄進行即時掃描

切換語言後選單列仍顯示英文

如果在設定中切換語言後選單列仍然顯示英文，請重新啟動 VMark。選單會在下次啟動時使用已儲存的語言重新建立。

終端機不接受中日韓標點符號

已在 v0.6.5+ 中修正，請更新至最新版本。