Zoo-Code

环境要求

• 已安装 Git，可访问 GitHub 克隆仓库
• 已安装 Node.js 与 pnpm 包管理器（README 使用 pnpm 管理依赖）
• 已安装 VS Code、Cursor 或 VS Code Insiders，且命令行工具 code / cursor 可用
• 本地有可用的终端环境（Windows 可用 PowerShell，macOS/Linux 用 bash）

安装与启动步骤

1. 1克隆仓库

   把 Zoo-Code 源码拉到本地，命令执行完成后会在当前目录生成 Zoo-Code 文件夹。

   git clone https://github.com/Zoo-Code-Org/Zoo-Code.git

   复制

2. 2安装依赖

   进入仓库目录后用 pnpm 安装全部依赖，首次安装耗时较久，需保持网络畅通。

   cd Zoo-Code
   pnpm install

   复制

3. 3一键构建并安装

   自动询问目标编辑器（默认 code），卸载旧版本、构建 VSIX 并安装，完成后提示重启编辑器。

   pnpm install:vsix

   复制

4. 4跳过交互安装

   加 -y 跳过所有确认使用默认值；用 --editor 指定编辑器，如 Cursor 或 Insiders。

   pnpm install:vsix -y --editor=cursor

   复制

5. 5手动构建 VSIX

   若不想自动安装，可先构建 VSIX 包，产物会生成在 bin/ 目录下，文件名含版本号。

   pnpm vsix

   复制

6. 6手动安装 VSIX

   用编辑器 CLI 安装 bin 目录下的 VSIX 包，请把文件名替换为实际生成的版本号。

   code --install-extension bin/zoo-code-.vsix

   复制

7. 7重启编辑器

   安装完成后按提示重启编辑器，让扩展加载生效。

如何确认成功

重启 VS Code 或 Cursor 后，在扩展列表或侧边栏能看到 Zoo Code 扩展并可以打开使用。

常见问题

注意事项

• README 只给出了从源码构建安装的本地开发流程，未提供商店一键安装说明。
• 自动安装命令会先卸载已存在的旧版本扩展，安装前请确认不会影响正在使用的配置。
• pnpm install:vsix 的 -y 参数会跳过所有确认提示并直接使用默认编辑器 code，非 VS Code 用户请显式指定 --editor。
• 手动安装 VSIX 时命令中的 是占位写法，必须换成 bin/ 目录下实际生成的文件名。