終端機 · SSH · SFTP

Blyck 的終端機以 xterm.js 為基礎,以相同方式的面板處理本機 shell·SSH 遠端工作階段·檔案樹·SFTP 遠端樹。分割面板以同時管理多個伺服器,並用 SFTP 像在本機一樣編輯遠端檔案。

遠端零安裝(zero-install remote)

用 Blyck 操作遠端伺服器時,伺服器上什麼都不必安裝。 遠端的需求只有一個 sshd。

若要用 VS Code Remote-SSH 使用 AI,須在每台遠端機器安裝 Claude Code·Codex 這類 AI CLI 與擴充·執行階段(Node),每次換伺服器都要反覆安裝·登入。在封閉網路或沒有安裝權限的伺服器上甚至會卡住。Blyck 將 Claude Code·Codex 在本機(我的 PC)執行,檔案作業以 SFTP·命令以 SSH 傳遞。

無需安裝 AI CLI — Claude Code·Codex 在我的 PC 上運作。不會裝在遠端伺服器上。
封閉網路·無權限的伺服器 OK — 只要 sshd 有開就能運作。
金鑰·認證集中在本機一處 — 無需在每台伺服器放 API 金鑰或登入工作階段。
伺服器上不留痕跡 — 不會在遠端產生代理行程或快取。斷線即結束。

本機終端機

shell 自動偵測

無需設定,即可自動選擇符合 OS 的 shell。

環境	自動選擇順序
Windows	PowerShell 7+ → PowerShell 5.1 → cmd.exe
macOS / WSL	bash · zsh(自動套用 `LANG=en_US.UTF-8`)

回捲搜尋 · 字型

回捲緩衝區 10,000 行 — 用 Ctrl+F 搜尋(支援正規表示式)。
Ctrl+= / Ctrl+- / Ctrl+0 — 調整字型大小。終端機·檔案樹·編輯器·聊天會依各區域分別儲存。

智慧輸出 — 點選即動作

URL — 點選會以預設瀏覽器開啟。
連按兩下檔名 — 在 ls 輸出等中連按兩下檔案會以編輯器開啟,若是資料夾則 cd 後顯示清單。
追蹤目前目錄 — 在面板標頭永遠顯示 shell 告知的位置(OSC 7)。
edit <檔案> — 在終端機輸入後,該面板會切換為該檔案的編輯器。

中文不亂碼的原因

內附 D2Coding 字型 — 即使 OS 沒有字型,中文·CJK 也能正確顯示。
Windows UTF-8 初始化 — 自動將 PowerShell 輸出編碼設為 UTF-8(65001)。
非 ASCII 命令安全傳遞 — 以 -EncodedCommand(Base64 UTF-16LE)傳遞,即使在 CP949 的公司 PC 上也不亂碼。

若遠端伺服器中文亂碼,請用 locale 命令確認伺服器的 LANG 環境變數是否為 *.UTF-8。

在終端機直接用 AI — `/claude`

在 shell 提示字元用斜線命令即時呼叫 AI。

命令	動作
`/claude <問題>`	僅文字回答(無檔案·命令權限)
`/claude? <問題>`	將最近的終端機輸出作為脈絡納入提問 — 想直接問剛發生的錯誤時
`/claude! <問題>`	授予檔案 · 命令執行權限
`/claude!? <問題>`	輸出脈絡 + 執行權限 — 「修一下這個錯誤」一句搞定

面板 · 分頁 · 子分頁

快速鍵	動作
`Ctrl+Shift+T`	新分頁
`Alt+1` ~ `Alt+8`	切換分頁
`Ctrl+\`	左右分割
`Ctrl+Shift+-`	上下分割
`Ctrl+Tab`	面板循環
Ctrl+`	子分頁循環
`Alt+Enter`	面板縮放

拖曳分隔線可自由調整比例。背景子分頁的工作階段也會持續存活,因此可將多個伺服器疊放在一個面板中切換作業。

SSH

連線

Ctrl+Shift+S 或 + 選單 → 選擇 SSH 連線…
輸入使用者名稱·主機·連接埠(預設 22),必要時輸入密碼。
選擇「於此面板」或「以新分頁」進行連線。

驗證順序

若將密碼留空,會依下列順序自動嘗試。

ssh-agent — SSH_AUTH_SOCK 環境變數或 Windows OpenSSH 代理管道
預設金鑰檔 — ~/.ssh/id_ed25519 → id_rsa → id_ecdsa 順序
shell 密碼提示 — 以上全部失敗時由伺服器直接要求

若輸入密碼,偵測到提示時會自動輸入一次。此外,同一主機的 SFTP 會在背景自動連線。

Keepalive

連線中會以 30 秒間隔傳送 keepalive 封包,防止閒置狀態斷線。

自動重連

SSH 工作階段異常中斷時,會以漸進等待間隔嘗試自動重連。

1秒 → 2秒 → 4秒 → 8秒 → 16秒 → 30秒 → 30秒 …(最多 10 次)

等待中按任意鍵即取消重連。
重連成功時工作階段會自動復原。

檔案樹

開啟

Ctrl+Shift+E 或 + 選單 → 檔案樹

鍵盤快速鍵

按鍵	動作
`↑` / `↓`	移動項目
`→` / `←`	展開 / 摺疊
`Enter`	進入 / 開啟
`Backspace`	至上層資料夾
`:`	跳至任意路徑
`Space`	選取(可多選)
`y` / `x` / `p`	複製 / 剪下 / 貼上
`d`	刪除
`r` 或 `F2`	重新命名
`n` / `N`	新檔案 / 新資料夾
`R`	重新整理
`c`	傳送路徑至終端機 shell
`a`	@附加至 AI 聊天

開啟檔案的大小政策

檔案大小	動作
≤ 2 MB	以 Monaco 編輯器開啟
2 MB ~ 32 MB	以唯讀開啟(分頁顯示 `[唯讀]`)
> 32 MB	引導 OS 預設應用程式
圖片 / PDF	內建檢視器
Office / 壓縮檔	以 OS 預設應用程式開啟

Git 徽章(本機樹)

在本機檔案樹中,會將 Git 狀態以徽章顯示在檔案旁。

徽章	意義
`?`	Untracked(未追蹤)
`+`	Staged(已暫存)
`-`	Deleted(已刪除)
`!`	Conflict(衝突)

在遠端 SFTP 樹中不會顯示 Git 徽章。

SFTP 遠端樹

連線

Ctrl+Shift+F 或 + 選單 → SFTP 遠端樹…

輸入使用者·主機(必填)·連接埠(22)·密碼(金鑰驗證則留空)·金鑰路徑·金鑰密碼·儲存名稱。

驗證順序:明確指定的金鑰 → ssh-agent → ~/.ssh 預設金鑰 → 密碼

遠端檔案編輯

在 SFTP 樹中連按兩下文字檔會以 Monaco 編輯器開啟。以 Ctrl+S 儲存時會立即上傳至遠端,變更會自動記錄到 ChangeSet,可以還原。

符號連結會在樹中以不同顏色區分顯示。

檔案上傳 · 下載

在同一個分頁並排開啟本機檔案樹與 SFTP 遠端樹,即可用 u/g 鍵快速傳輸。

方向	方法
上傳(本機 → 遠端)	在本機樹用 `Space` 選取 → `u`
下載(遠端 → 本機)	在 SFTP 樹用 `Space` 選取 → `g`

資料夾為遞迴傳輸。
進度會在狀態列以「N 個 → user@host」顯示。
若同一分頁沒有相反種類的樹,會顯示說明訊息。

右鍵選單中也可使用上傳·下載·新資料夾·重新命名·刪除,並支援伺服器間直接傳輸(不經過本機)。

儲存的連線

在 SSH 或 SFTP 對話框輸入「儲存名稱」並連線後,連線會被儲存。之後即可從清單中點一下直接連線。

密碼安全儲存

密碼與金鑰密碼會以 OS 金鑰鏈加密儲存。

Windows:DPAPI(綁定使用者帳號)
macOS:Keychain

connections.json 中只儲存加密值,明文僅存在於記憶體中。

儲存的連線可建立資料夾依團隊·環境分組。

遠端專案資料夾(AI 聊天整合)

可將 SSH/SFTP 遠端資料夾指定為 AI 聊天的作業資料夾。

設定方式

點選 AI 聊天面板上方的 📁 資料夾晶片
選擇 遠端(SSH/SFTP)連線…
選擇伺服器 → 選擇資料夾

設定後晶片會顯示為 user@host:/path · 遠端 SFTP。

動作方式

指定後,AI 的檔案工具(file_read / file_write / file_list_dir)會自動路由至 SFTP 路徑。遠端檔案變更也會記錄到 ChangeSet,可以還原。

VNC

需要遠端桌面時,使用內建 VNC 檢視器。

以主機:連接埠輸入連線,支援 VNC 密碼驗證
畫面自動符合 — 遠端畫面自動縮放以符合面板大小。
剪貼簿雙向 — 遠端 → 本機自動同步,本機 → 遠端用 Ctrl+V 或剪貼簿傳送按鈕
SSH 通道選項 — 經由跳板伺服器存取內網 VNC(自動對應本機連接埠)
檔案傳輸分頁 — 以 TightVNC 協定為基礎的上/下載。可在選項中選擇檔名編碼(UTF-8·Windows-949·Shift-JIS 等)。

WinRM — 遠端 Windows 管理

無法開啟 SSH 的 Windows 伺服器,用 WinRM 面板管理。

PowerShell 命令會在遠端執行。
中文命令也透過 -EncodedCommand 處理而安全。
委派給 AI 時,查詢命令(Get-*)會自動執行,變更命令(Set- / Remove- / Restart- 等)會經過確認。

與 AI 搭配

AI 聊天會感知使用中的 SSH 面板。以自然語言委派命令後,AI 會用 ssh_exec 工具執行並收集輸出來回答。

▸ 顯示這個伺服器的 nginx 設定檔
▸ 在 /var/log 中找出最大的 5 個檔案

AI 在建立命令前,會用 ssh_probe_env 掌握伺服器環境(OS·init 系統·套件管理員·是否為容器·記憶體·磁碟·已安裝工具版本)。不會因 apt/yum、systemd/sysvinit 的差異而建立錯誤命令。

讀取命令會自動執行,但寫入·危險命令(rm、chmod 等)在執行前會經過確認對話框。詳情請參考 AI 聊天 › 工具核准。

FAQ

Q. SSH 連不上。
請確認主機·連接埠(預設 22)·防火牆·使用者名稱。若為金鑰驗證,請確認 ~/.ssh 金鑰檔存在且已登錄到伺服器的 authorized_keys。

Q. 自動重連一直失敗。
自動重連時不會重複使用密碼。須有金鑰或 ssh-agent 驗證運作才能自動復原。僅支援密碼的伺服器請用 Ctrl+Shift+S 手動重新連線。

Q. 遠端伺服器中文亂碼。
請用 locale 命令確認伺服器的 LANG 環境變數是否為 *.UTF-8。本機 Windows 終端機由 Blyck 自動套用 UTF-8。

Q. 檔案傳輸(u/g)沒作用。
須在同一分頁同時開啟本機檔案樹與 SFTP 遠端樹。上傳在本機樹選取,下載在 SFTP 樹選取。

Q. 把儲存的連線移到其他 PC 後又要求輸入密碼。
密碼以綁定 OS 帳號的加密金鑰保護。複製到其他 PC/帳號後無法解密,因此須重新輸入。這是出於安全考量的刻意設計。

Q. 在遠端專案資料夾中無法使用 RAG 搜尋。
遠端 SFTP 資料夾目前不是 RAG 索引對象。AI 以 file_list_dir 與 file_read 工具直接探索遠端程式碼。若是本機資料夾,請試用整合搜尋。