zed-to-vscode

Zed to VS Code

Copyright (c) 2026 Naufalinux. 원본 스킬/소스/문서: GPL-3.0-or-later. references/LICENSE.txt 참조. 외부 확장은 각각의 상위 약관을 따릅니다. Dark Plus 포트의 라이선스는 해결되지 않았습니다. GPL 표시는 외부 자산을 정리하거나 재라이선스하지 않습니다.

파일 편집과 테마 전용 확장을 사용하여 VS Code 스타일의 Zed 레이아웃을 구성하십시오. 데스크톱을 자동화하거나, Zed를 실행하거나, 세션이나 서비스를 재시작하지 마십시오.

사용 시기

• 다크 테마, 파일 아이콘, 줄 바꿈, 브랜치/워크트리 표시 등 VS Code 스타일로 Zed를 설정할 때
• 재현 가능한 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. 스크립트는 설치된 확장 버전을 검증하고, 누락된 테마를 안전하게 다운로드/압축 해제하고, 중첩 설정을 병합하고, 원본 설정을 제한된 권한으로 백업하고, 원자적으로 쓰고, 결과를 다시 읽습니다. 0이 아닌 종료 코드는 성공을 의미하지 않습니다. 재시도 전에 오류를 검사하십시오.
5. 확인된 사항을 보고하고 필요한 경우 사용자에게 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에 복원하십시오. 임의의 이전 백업을 선택하지 마십시오.
• 동일한 설정을 다시 실행하는 것은 멱등적입니다. 설정 다시 쓰기나 추가 백업이 발생하지 않습니다.