問題排解
安裝時出現發行者警告
Section titled “安裝時出現發行者警告”Beta 版在程式碼簽署前,SmartScreen/Defender 警告是正常顯示的。請依下載頁面的「首次執行說明」只允許一次,之後便不會再顯示。安裝檔較大時,首次掃描可能需要時間 — 若視窗沒有立即跳出,請稍候後再執行一次。
VNC 遠端畫面
Section titled “VNC 遠端畫面”新分頁選單 → VNC 連線… 或儲存的連線。輸入項目:
| 項目 | 預設值 | 說明 |
|---|---|---|
| 主機 | — | VNC 伺服器 IP 或網域 |
| 連接埠 | 5900 | VNC 預設連接埠 |
| 密碼 | — | VNC 驗證密碼 |
| 儲存名稱 | — | 輸入時登錄至儲存的連線 |
以 SSH 通道存取內網 VNC
Section titled “以 SSH 通道存取內網 VNC”開啟連線對話框的 SSH 通道 選項後,可經由 bastion 伺服器存取內網 VNC。無需在防火牆外部直接開啟 5900 連接埠。
| 按鈕 | 動作 |
|---|---|
| 剪貼簿傳送 | 將本機剪貼簿送至遠端 |
Ctrl+Alt+Del | 向遠端 PC 傳送 Ctrl+Alt+Del |
| 📁 FT | 切換檔案傳輸面板 |
剪貼簿快速鍵
Section titled “剪貼簿快速鍵”Ctrl+Shift+V— 僅將本機剪貼簿傳送至遠端(不傳送貼上鍵)Ctrl+V— 傳送 + 連貼上鍵也一併傳送至遠端
檔案傳輸(TightVNC 2.x FT)
Section titled “檔案傳輸(TightVNC 2.x FT)”檔案傳輸面板功能:
| 功能 | 方法 |
|---|---|
| 瀏覽資料夾 | 點選清單,↑ 上層資料夾 |
| 重新整理 | ↻ 按鈕 |
| 新資料夾 | ➕ 按鈕 |
| 上傳 | ⬆ 按鈕(可選取多個檔案) |
| 下載 | 連按兩下 / 右鍵 / 勾選核取方塊後下載 |
| 重新命名 / 刪除 | 右鍵選單 |
上傳同名檔案時會顯示覆寫確認訊息。
若檔名亂碼,請變更面板上方的編碼下拉選單(預設 UTF-8)。變更時會自動重連。
VNC 問題排解
Section titled “VNC 問題排解”| 症狀 | 原因 | 處置 |
|---|---|---|
| 連線失敗 | 主機·連接埠·密碼錯誤 | 重新確認連線資訊,確認伺服器 VNC 是否執行 |
| 無法存取內網 | 防火牆封鎖 | 開啟 SSH 通道選項 |
| 沒有檔案傳輸面板或出錯 | 非 TightVNC 2.x 的伺服器 | 更換為 TightVNC 2.x 伺服器 |
| 檔名亂碼 | 伺服器編碼不一致 | 在編碼下拉選單選擇伺服器編碼(例:EUC-KR) |
| 看得到畫面但剪貼簿不能用 | 伺服器剪貼簿停用 | 在 VNC 伺服器設定中啟用剪貼簿共享 |
WinRM — 遠端 Windows PowerShell
Section titled “WinRM — 遠端 Windows PowerShell”新分頁選單 → WinRM(遠端 Windows)…。輸入項目:
| 項目 | 預設值 | 說明 |
|---|---|---|
| 主機 | — | 遠端 Windows PC IP 或網域 |
| 使用者 | — | Windows 本機或網域帳號 |
| 密碼 | — | 帳號密碼 |
| 連接埠 | 5985(HTTP)/ 5986(HTTPS) | 以使用 HTTPS 切換選擇 |
| 使用 HTTPS | 關閉 | 開啟為 5986,關閉為 5985 |
| 儲存名稱 | — | 輸入時登錄至儲存的連線 |
遠端 PC 前置條件
Section titled “遠端 PC 前置條件”在遠端 PC 以系統管理員身分開啟 PowerShell 並執行下列命令:
Enable-PSRemoting -Force若非網域環境而是工作群組或 IP 直接連線,須在用戶端 PC 設定 TrustedHosts。點選連線對話框的 「新增信任此主機」 按鈕即會自動處理。
若要手動設定:
# 在系統管理員 PowerShell 中執行Set-Item WSMan:\localhost\Client\TrustedHosts -Value "目標IP或主機名" -Force動作方式及限制
Section titled “動作方式及限制”- 在主控台輸入 PowerShell 命令並以 Enter 執行。
- 可用 ↑ / ↓ 鍵瀏覽命令歷程。
- 為每個命令都建立新連線的命令式方式(不保留工作階段狀態)。
- 不支援
Read-Host這類互動式提示。
WinRM 問題排解
Section titled “WinRM 問題排解”| 症狀 | 原因 | 處置 |
|---|---|---|
| 「拒絕存取」錯誤 | 帳號權限不足 | 使用系統管理員帳號或加入允許遠端管理的群組 |
| 連不上(工作群組) | 未設定 TrustedHosts | 點選對話框「新增信任此主機」 |
| 連不上(防火牆) | 5985/5986 連接埠封鎖 | 在遠端 PC 防火牆允許 WinRM 連接埠 |
| 沒有 WinRM 服務 | 未啟用 PSRemoting | 在遠端 PC 執行 Enable-PSRemoting -Force |
| HTTPS 憑證錯誤 | 自我簽署憑證 | 以 HTTP(5985)連線或設定信任憑證 |
| 選單中沒有 WinRM | 在 macOS 上執行中 | Windows 專用功能,請在 Windows PC 上使用 |
螢幕區域擷取(📷)
Section titled “螢幕區域擷取(📷)”點選分頁列的 📷 按鈕,畫面上會覆蓋透明覆疊層。
- 用滑鼠拖曳選取要擷取的區域(含外接螢幕)。
- 擷取的圖片會在標註編輯器中開啟 — 可用箭頭·文字·螢光筆加註解。
- 點選 「傳送至 AI」 按鈕後,圖片會附加到已開啟的 AI 聊天。
桌面鏡像(即時串流)
Section titled “桌面鏡像(即時串流)”新分頁選單 → 🖥️ 桌面擷取… → 從視窗清單選擇應用程式後,該視窗會即時串流到面板(僅供檢視)。
- AI 可用
panel_screenshot工具看到鏡像畫面。 - 網頁預覽面板可用 ✏️ 按鈕擷取並傳送至 AI。
整體問題排解
Section titled “整體問題排解”應用程式當機·畫面變白時
Section titled “應用程式當機·畫面變白時”| 症狀 | 原因 | 處置 |
|---|---|---|
| 畫面變白並自動重新載入 | 算繪器行程當機 | 已自動復原 — 正常運作 |
| 30 秒內反覆當機 3 次以上 | GPU 驅動程式或記憶體問題 | 更新 GPU 驅動程式後重新執行 |
| 重新載入後仍持續白畫面 | 嚴重的算繪器錯誤 | 確認 crash.log 後洽詢 |
當機記錄位置:%APPDATA%\Blyck\crash.log
當機發生時:
- 開啟
crash.log確認最後的錯誤內容。 - 用
F12開啟開發者工具,在主控台分頁確認錯誤。 - 若無法解決,請將
crash.log與logs\blyck.log附加至洽詢頁面。
卡頓·按鍵輸入延遲
Section titled “卡頓·按鍵輸入延遲”| 症狀 | 原因 | 處置 |
|---|---|---|
| 5~10 秒卡頓後自動復原 | RAG 重新索引或 LSP 初始化中主執行緒被阻塞 | 稍候 |
| 反覆卡頓 | 資源競用 | 附加 blyck.log 後洽詢 |
| AI 作業中長時間卡頓 | 回合 backstop(60 分)或 2 分鐘無回應處理 | 用 ■ 停止按鈕強制中斷 |
Blyck 在應用程式啟動時與每 4 小時間隔從 update.blyck.dev 確認更新。新版本會在背景下載後於應用程式結束時自動安裝。
| 症狀 | 原因 | 處置 |
|---|---|---|
| 更新未套用 | 應用程式未完全結束 | 連系統匣圖示完全結束後重新執行 |
| 下載失敗 | 公司網路封鎖 CDN | 向 IT 團隊要求允許 update.blyck.dev 或手動安裝 |
| 無法確認更新 | 離線環境 | 連線網路後重新啟動 |
| 症狀 | 原因 | 處置 |
|---|---|---|
| 顯示全螢幕鎖定 | 14 天試用結束 | 貼上授權金鑰以認證 |
| 「訂閱已到期」 | 訂閱到期或取消 | 在 Lemon Squeezy 入口確認訂閱狀態 |
| 認證失敗 | 離線狀態 | 連線網路後重試 |
| 「已註冊於其他裝置」 | 裝置註冊超過上限 | 在 Lemon Squeezy 入口管理裝置 |
| 認證後過 7 天被鎖定 | 超過離線寬限期 | 連線網路後重新啟動應用程式以重新驗證 |
DB 連線相關
Section titled “DB 連線相關”| 症狀 | 原因 | 處置 |
|---|---|---|
| 連線逾時 | 網路·防火牆封鎖 | 確認主機·連接埠·防火牆規則。PG/MySQL 10 秒,MSSQL 15 秒 |
Oracle ORA-xxxxx | 伺服器端錯誤(服務名·帳號鎖定等) | 重新確認伺服器連線資訊 |
Oracle NJS-116 | 不支援 Thin 模式的環境 | 勾選強制 Thick + 設定 64 位元 Instant Client 路徑 |
Oracle NJS-118 | Thick 初始化錯誤 | 重新啟動應用程式後重試 |
| MySQL BIGINT 以字串顯示 | 超過 2^53 精度保護 | 正常運作 — 非 bug |
| 連線池工作階段暴增 | — | 由連線池(最多 4 個)自動管理,沒有問題 |
詳細的 DB 相關問題請參考 DB 用戶端 頁面。
網頁預覽相關
Section titled “網頁預覽相關”| 症狀 | 原因 | 處置 |
|---|---|---|
| 頁面載入不出來 | 開發伺服器未執行 | 先執行本機開發伺服器後輸入 URL |
preview_eval 立即失敗 | 頁面仍在載入中 | 用 preview_wait 工具後重試 |
| 畫面停在空白 | URL 錯誤或伺服器錯誤 | 確認 URL 與伺服器狀態 |
詳情請參考 執行 · 預覽 頁面。
RAG 搜尋相關
Section titled “RAG 搜尋相關”| 症狀 | 原因 | 處置 |
|---|---|---|
| 沒有結果或顯示舊檔案 | 索引未更新 | 聊天設定 → 確認 RAG 索引狀態 |
| 搜尋到已刪除的檔案 | Orphan 項目 | 執行 Orphan Scan 清理工具 |
| 結果雜訊太多 | 索引了不必要的檔案 | 用 .termeditignore 新增排除模式 |
| 變更嵌入模型後結果異常 | 重新索引進行中 | 等待重新索引完成 |
RAG 索引管理請參考 RAG 搜尋 頁面。
SSH 連線相關
Section titled “SSH 連線相關”| 症狀 | 原因 | 處置 |
|---|---|---|
| 在密碼輸入處卡住 | 非標準提示(偵測等待最多 30 秒) | 直接輸入或使用密碼儲存 |
| 自動重連失敗 | 僅密碼伺服器(重連時不重用密碼) | 設定金鑰/agent 驗證或手動重新連線 |
| 只有 SFTP 失敗 | SFTP 子系統停用 | 在檔案面板手動重新連線 |
| 中文亂碼 | 伺服器地區設定 | 以伺服器 locale 確認 *.UTF-8 |
詳情請參考 終端機 · SSH · SFTP 頁面。
AI 功能相關
Section titled “AI 功能相關”| 症狀 | 原因 | 處置 |
|---|---|---|
| AI 聊天停用 | 未安裝或未登入 CLI | 在準備精靈中安裝·登入 CLI |
| 401/403 錯誤 | API 金鑰過期或錯誤 | 重新註冊金鑰或重新執行 claude login |
| 沒有回應 / 停止 | 網路或認證過期 | 自動重試 3 次後重新登入,開始新聊天 |
| 沒有核准卡片就變更檔案 | 🚀 自動模式啟用 | 用 Ctrl+3 切換為 ⚡ 執行+審查模式 |
詳情請參考 AI 聊天 頁面。
LSP 自動完成相關
Section titled “LSP 自動完成相關”| 症狀 | 原因 | 處置 |
|---|---|---|
| Python 自動完成沒作用 | 未安裝 Pyright | 第一次開啟 Python 檔案時核准「下載?」模態框 |
| Go 自動完成沒作用 | 沒有 Go 工具鏈 | 安裝 Go 後執行 go install golang.org/x/tools/gopls@latest |
| Rust 自動完成沒作用 | rust-analyzer 下載失敗 | 在可存取 GitHub 的環境重新啟動應用程式,或手動安裝後登錄 PATH |
| 公司網路下載失敗 | GitHub 封鎖 | 直接安裝該伺服器並登錄至 PATH |
終端機顯示相關
Section titled “終端機顯示相關”| 症狀 | 原因 | 處置 |
|---|---|---|
| 文字模糊 | WebGL 回退(Canvas/DOM) | 在設定中明確指定 Canvas 算繪器 |
| 全形字元對齊跑掉 | 使用 DOM 算繪器中 | 在設定中指定 Canvas 算繪器 |
| 中文亂碼(本機) | — | Windows 自動套用 UTF-8,ipconfig 等原生 exe 以 PowerShell cmdlet 替代 |
我想還原錯誤的變更
Section titled “我想還原錯誤的變更”用 Ctrl+Shift+H 開啟變更紀錄,檔案·DB·SSH 變更都有記錄。選擇項目並還原。DML 在執行前會自動備份資料,因此無 WHERE 的 UPDATE 也能復原。
詳細動作請參考 Git · ChangeSet 頁面。
記錄·資料位置(Windows)
Section titled “記錄·資料位置(Windows)”| 項目 | 位置 |
|---|---|
| 應用程式記錄 | %APPDATA%\Blyck\logs\blyck.log(2MB 輪替) |
| 當機記錄 | %APPDATA%\Blyck\crash.log |
| 連線資訊(不含密碼) | %APPDATA%\Blyck\connections.json |
| 版面配置(分頁·分割) | %APPDATA%\Blyck\layout.json |
| AI 聊天紀錄 | %APPDATA%\Blyck\chats\ |
| 變更紀錄(ChangeSet) | %APPDATA%\Blyck\blyck-history.db |
| RAG 索引 | 各工作區的 SQLite 檔案 |
密碼與 token 不是儲存在檔案,而是加密保存在 OS 認證儲存區。記錄中的密碼·token·API 金鑰·使用者路徑會自動遮罩,且僅儲存在本機,不會傳送到外部。
無法解決的問題請寄至洽詢頁面。若一併寫明環境資訊(OS·版本)與重現步驟,我們能更快協助。Blyck 內部開啟的輔助伺服器(MCP·VNC 代理等)全部僅以 localhost 動態連接埠 + token 認證開啟,因此無需防火牆例外或開放連接埠。