Zed to VS Code
Copyright (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を閉じてもらうことを推奨します(同時編集による競合を避けるため)。
手順
terminalを使用して、python3 --version、curl --version、および可能であればzed --versionを確認します。実行前に、同梱のスクリプトをread_fileで内容を確認してください。terminalを使用してプレビュー:python3 <skill-dir>/scripts/zed-to-vscode.py --dry-run。これにより書き込みやダウンロードは行われず、計画された値のみが表示されます(既存の機密情報は表示されません)。- ユーザーがセットアップをリクエストした後、
terminalを使用して適用:python3 <skill-dir>/scripts/zed-to-vscode.py。ネットワークダウンロードのために最大300秒の待機を許可します。出力と正確なバックアップパスをキャプチャしてください。 - スクリプトはインストール済みの拡張機能のバージョンを検証し、不足しているテーマを安全にダウンロード/展開し、ネストされた設定をマージし、元の設定を制限されたパーミッションでバックアップし、アトミックに書き込み、結果を読み戻します。ゼロ以外の終了コードは成功を示しません。再試行する前にエラーを確認してください。
- 検証された内容を報告し、必要に応じてユーザーにZedを手動で再起動するよう依頼してください。ファイルチェックのみからの視覚的な確認を主張しないでください。
設定
スクリプトはピン留めされたテーマ専用拡張機能 vscode-dark-plus 0.0.1 と vscode-icons 13.0.0 をインストールします。VScode Dark Plus と VSCode Icons for Zed (Dark) を選択します。
VSCodeキーバインドを有効にします。左側にエクスプローラー/Git/アウトライン、下部にターミナル/エージェント、アイコン付きタブ、ブレッドクラム、ミニマップ、行番号、インデントガイド、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と同じディレクトリにsettings.json.before-vscode-<timestamp>.bakとして作成されます。ロールバックするには、ユーザーにZedを閉じてもらい、報告された正確なバックアップをsettings.jsonに復元してください。任意の古いバックアップを選択しないでください。 - 同一設定の再実行は冪等です。設定の再書き込みや追加のバックアップは行われません。