Zed 到 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，以避免并发编辑。
步骤
- 使用
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)。
它启用 VS Code 键绑定；左侧资源管理器/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.before-vscode-<timestamp>.bak，位于 settings.json 旁边。要回滚，请让用户关闭 Zed，然后将报告的确切备份恢复到 settings.json 上；不要选择任意较旧的备份。 - 重新运行相同设置是幂等的：不会重写设置或创建额外备份。