zed-to-vscode

Zed to VS Code

版權所有 (c) 2026 Naufalinux。原始技能/來源/文件：GPL-3.0-or-later。請參閱 references/LICENSE.txt。外部擴充套件保留原始授權條款；Dark Plus 移植版的授權狀態未定。GPL 標籤不會清除或重新授權外部資產。

透過檔案編輯與僅限佈景主題的擴充套件，配置類似 VS Code 的 Zed 佈局。請勿自動化桌面、啟動 Zed 或重新啟動任何工作階段或服務。

使用時機

• 將 Zed 設定為類似 VS Code 的風格，包含深色主題、檔案圖示、自動換行及分支/工作樹指示器。
• 重新套用或分享可重現的 Linux 編輯器設定。
• 請勿用於安裝 Zed 本身、Git 復原或匯入憑證。

文件

請閱讀 references/GUIDE.md，內含印尼語的逐步腳本指南、ZIP/TAR 匯入、Git 複製安裝、分享、回滾與疑難排解。該指南區分本地技能歸檔檔案與 Hermes 快照 JSON，且不假設已存在公開的 Git 儲存庫。

先決條件

• 已安裝 Zed；具備 Python 3.12+ 與 curl。
• 首次下載擴充套件時需要存取 https://api.zed.dev 的網路連線。
• 從 skill_view 回傳的路徑解析此技能目錄；切勿對使用者的家目錄進行硬編碼。
• 建議請使用者手動關閉 Zed 後再套用設定，以避免並行編輯衝突。

步驟

1. 使用 terminal 檢查 python3 --version、curl --version 及可用的 zed --version。在執行腳本前，先用 read_file 讀取內含的腳本。
2. 使用 terminal 預覽：python3 <skill-dir>/scripts/zed-to-vscode.py --dry-run。此操作不會進行任何寫入或下載，僅會印出計劃的值，而非現有的機密資訊。
3. 使用者要求設定後，使用 terminal 套用：python3 <skill-dir>/scripts/zed-to-vscode.py。允許最多 300 秒的網路下載時間。擷取輸出內容與確切的備份路徑。
4. 腳本會驗證已安裝的擴充套件版本、安全地下載/解壓縮遺失的主題、合併巢狀設定、以嚴格權限備份原始設定、以原子寫入方式寫入，並讀取結果以確認。非零的退出碼不代表成功；在重試前應先檢查錯誤。
5. 報告已驗證的項目，並視需要請使用者手動重新開啟 Zed。請勿僅憑檔案檢查來聲稱視覺驗證。

設定

腳本會安裝固定版本的僅佈景主題擴充套件：vscode-dark-plus 0.0.1 與 vscode-icons 13.0.0。它會選取 VScode Dark Plus 與 VSCode Icons for Zed (Dark)。

它會啟用 VSCode 快捷鍵；左側的 Explorer/Git/Outline 面板；底部終端機/代理；包含圖示的分頁；麵包屑導覽列；小地圖；行號；縮排引導線；以及 soft_wrap: editor_width。UI、編輯器與終端機的字型大小均為 12。現有的字型、不相關的設定、憑證與代理權限保持不變。JSONC 註解會在設定被重寫時移除，但原始檔案會以完整形式備份。

title_bar 設定會明確啟用 show_branch_name、show_branch_status_icon、show_worktree_name 與 show_project_items。Git 指示器位於 Zed 頂部，而非 VS Code 的左下角位置。

預設值會遵守 XDG_CONFIG_HOME 與 XDG_DATA_HOME。可透過 --config-dir PATH --data-dir PATH 安全地覆寫。若已存在其他版本的擴充套件，腳本會拒絕執行，而非自動降級。

陷阱與安全

• 請勿對此工作流程使用 CUA、合成輸入或 GUI 擷取。Plasma X11 工作階段當機曾與 CUA 指標熱插拔同時發生；切勿在使用者的即時桌面上重現此情況。
• 分支指示器需要實際的 Git 儲存庫。使用 terminal 執行 git -C <project> status --short --branch 來診斷。缺少 .git 不會透過建立新儲存庫來修復；未經明確授權請勿執行 git init。
• 佈局僅為相似，並非像素級一致。原生的 Zed 面板控制元件與 VS Code 的活動列不同。
• 語言/專案覆寫或工作區狀態可能會覆寫全域偏好設定。應個別調查這些情況，而非盲目地重設它們。
• 切勿使用此技能匯出個人 Zed 設定、備份、API 金鑰、日誌、記憶體或工作階段。僅匯出此目錄中可重複使用的檔案。
• 若透過 Python 下載時遇到 HTTP 403 錯誤，請使用內含的 curl 路徑；切勿偽造成功的安裝。

驗證與回滾

• 透過 terminal 執行 python3 <skill-dir>/scripts/test_setup.py 進行隔離的離線測試。測試不得觸碰實際的編輯器設定。
• 確認腳本輸出已驗證擴充套件清單與合併後的設定。重新啟動後的 GUI 識別仍需使用者自行視覺檢查。
• 備份檔案會命名為 settings.json.before-vscode-<timestamp>.bak，與 settings.json 位於同一目錄。若要回滾，請使用者關閉 Zed，然後將腳本回報的確切備份檔案還原至 settings.json；請勿選擇任意的較舊備份。
• 重新執行相同的設定是冪等的：不會重寫設定或產生額外備份。