疑難排解
快速查找
常見問題與對應的修復位置：
| 症狀 | 可能原因 | 查找位置 |
|---|---|---|
| MCP 用戶端無法連線 | 過期的連接埠檔案或 VMark 未執行 | MCP 伺服器連線問題 |
| 檔案無法開啟或顯示亂碼 | 非 UTF-8 編碼或隔離屬性 | 檔案無法開啟 |
| AI 精靈卡住或沒回應 | 供應商設定錯誤或 CLI 不在 PATH 中 | AI 精靈無回應 |
| 鍵盤快捷鍵沒反應 | 在設定中被重新指派或被系統覆寫 | 鍵盤快捷鍵不起作用 |
| 大型檔案上的編輯器很慢 | 每分頁記憶體 + 1 萬行以上的輸入延遲 | 編輯器效能 |
| 切換語言後選單仍是英文 | 選單於啟動時重建 | 切換語言後選單列仍顯示英文 |
| PDF 匯出不完整 | 圖片路徑或寫入權限問題 | 匯出/列印問題 |
| Windows 啟動緩慢 | WebView2 + 防毒掃描 | 應用程式在 Windows 上啟動緩慢 |
對於以上未列出的問題，請參閱 回報 Bug。
日誌檔案
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 時，請包含以下資訊：
- VMark 版本 — 顯示在導覽列徽章或「關於」對話框中
- 作業系統 — macOS 版本、Windows 組建編號或 Linux 發行版
- 重現步驟 — 問題發生前你做了什麼操作
- 日誌檔案 — 附上或貼上相關的日誌條目
日誌條目帶有時間戳記並按模組標記（例如 [HotExit]、[MCP Bridge]、[Export]），方便查找相關內容。
查找相關日誌
- 根據上表開啟日誌目錄
- 開啟最新的
.log檔案 - 搜尋問題發生時間附近的
ERROR或WARN條目 - 複製相關行並附在你的 Bug 回報中
常見問題
應用程式在 Windows 上啟動緩慢
VMark 針對 macOS 進行了最佳化。在 Windows 上，由於 WebView2 初始化，啟動可能較慢。請確保：
- WebView2 Runtime 已更新至最新版本
- 防毒軟體沒有對應用程式資料目錄進行即時掃描
切換語言後選單列仍顯示英文
如果在設定中切換語言後選單列仍然顯示英文，請重新啟動 VMark。選單會在下次啟動時使用已儲存的語言重新建立。
終端機不接受中日韓標點符號
已在 v0.6.5+ 中修正，請更新至最新版本。
MCP 伺服器連線問題
MCP 伺服器可能無法啟動，或用戶端無法連線。
- 確保 VMark 正在執行——MCP 伺服器僅在應用程式開啟時啟動。
- 檢查是否有其他程序佔用了相同的連接埠。MCP 伺服器會寫入連接埠檔案供用戶端探索；前一個工作階段遺留的過期連接埠檔案可能導致衝突。重新啟動 VMark 以重新產生。
- 查看日誌檔案中的
[MCP Bridge]條目以識別連線錯誤。
鍵盤快捷鍵不起作用
如果快捷鍵與其他綁定衝突或已被自訂，可能表現為無回應。
- 開啟設定（
Mod + ,）並導覽至 快捷鍵 分頁，檢查快捷鍵是否被重新指派。 - 尋找重複的綁定——如果兩個動作共用同一組合鍵，只有一個會觸發。
- 在 macOS 上，某些快捷鍵可能與系統層級的綁定衝突（例如 Mission Control、Spotlight）。請檢查 系統設定 > 鍵盤 > 鍵盤快捷鍵。
匯出/列印問題
PDF 匯出可能卡住或產生不完整的輸出。
- 如果匯出中缺少圖片，請驗證圖片路徑相對於文件且檔案存在於磁碟上。絕對 URL 和遠端圖片應該可以存取。
- 檢查輸出目錄的檔案權限——VMark 需要寫入權限才能儲存匯出的檔案。
- 對於大型文件，匯出可能需要更長時間。如果看起來卡住了，請檢查日誌檔案中的
[Export]條目。
檔案無法開啟
VMark 可能拒絕開啟檔案或顯示亂碼內容。
- 驗證檔案對你的使用者帳戶有讀取權限。
- VMark 預期 UTF-8 編碼的 Markdown。其他編碼的檔案（例如 GB2312、Shift-JIS）可能無法正確顯示——請先將其轉換為 UTF-8。
- 如果檔案被其他程序鎖定（例如同步用戶端或備份工具），請關閉該程序後重試。
編輯器效能
在檔案非常大或開啟了很多分頁時，編輯器可能會變慢。
- 關閉未使用的分頁以釋放記憶體——每個開啟的分頁都維護其獨立的編輯器狀態。
- 非常大的文件（超過 10,000 行）可能導致輸入延遲。考慮將其拆分為更小的檔案。
- 如不需要，請停用專注模式和打字機模式，因為它們會增加額外的算繪開銷。
AI 精靈無回應
AI 精靈需要已設定的 AI 供應商才能運作。
- 開啟設定，驗證是否設定了 AI 供應商（例如 Ollama、OpenAI、Anthropic）並填寫了有效的模型名稱。
- 供應商的 CLI 必須在你的 PATH 中可用。在 macOS 上，GUI 應用程式的 PATH 是最小化的——如果 CLI 是透過 Homebrew 安裝的，請確保你的 Shell 設定檔匯出了正確的路徑。
- 檢查模型名稱是否有拼字錯誤。不正確的模型名稱會靜默失敗或傳回錯誤。