ZCode Pro

English | 简体中文

ZCode 桌面版界面增强工具。不修改客户端文件，通过 ZCode Pro 快捷方式或终端命令 zcode-pro 启动即可。

⚙️ 打开设置：启动 ZCode Pro 后，右键点击 ZCode 侧边栏底部的设置按钮（齿轮）即可打开 ZCode Pro 设置窗口。

✨ 功能

各项功能均可在设置弹窗中开关或调整，ZCode 3.16.1 与 3.15.x 均可使用。

📦 安装与使用

版本匹配：ZCode ≥ 3.16.1 请使用 zcode-pro 1.1.0（npm / PyPI / AUR 最新发布版）；ZCode ≤ 3.15.x 请使用 zcode-pro 0.20.3（旧版仍可用）。

安装后，通过应用菜单 / 开始菜单中的“ZCode Pro”快捷方式或终端命令 zcode-pro 启动 ZCode，增强在该方式下自动生效；使用原有 ZCode 入口启动时不加载增强。

📦 npm / PyPI

运行时优先复用 ZCode 自带的运行时；未找到 ZCode 时回退系统 Node.js（≥ 22）。

# 方式一：npm 安装/卸载
npm install -g zcode-pro
zcode-pro setup --uninstall  # 卸载前先撤销快捷方式（如创建过）
npm uninstall -g zcode-pro
# 方式二：pip 安装/卸载
pip install zcode-pro
zcode-pro setup --uninstall  # 卸载前先撤销快捷方式（如创建过）
pip uninstall zcode-pro

# 通过命令启动
zcode-pro
# 添加开始菜单快捷方式
zcode-pro setup
# 添加开始菜单快捷方式 + 桌面快捷方式
zcode-pro setup --desktop
# 撤销添加快捷方式
zcode-pro setup --uninstall

🐧 Linux / macOS

• 安装至 ~/.local，可通过 PREFIX= 指定其他位置；
• Linux 会注册应用菜单快捷方式“ZCode Pro”（图标复用已安装的 ZCode）；
• 已通过 AUR 安装时请勿再使用本脚本（脚本会检测并拒绝），用户级安装会遮蔽系统级入口；
• 卸载：./scripts/install.sh --uninstall。

git clone https://github.com/duanluan/zcode-pro.git
cd zcode-pro && ./scripts/install.sh

🪟 Windows

使用 PowerShell (管理员) 运行：

git clone https://github.com/duanluan/zcode-pro.git
cd zcode-pro

# 添加开始菜单快捷方式
powershell -ExecutionPolicy Bypass -File scripts\install.ps1
# 添加开始菜单快捷方式 + 桌面快捷方式
powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Desktop
# ZCode 装在非默认目录且自动定位不到时，显式指定其路径（持久保存，卸载时清除）
powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Desktop -ZCodePath "D:\ProgramFiles\Zcode\ZCode.exe"

# 卸载
powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Uninstall

📦 AUR

安装 /usr/bin/zcode-pro 与系统级应用菜单快捷方式，依赖 AUR 的 zcode 包。

yay -S zcode-pro
paru -S zcode-pro
# 手动安装方式
git clone https://aur.archlinux.org/zcode-pro.git && cd zcode-pro && makepkg -si

从手动安装（install.sh）迁移到 AUR 前，请先在原仓库执行 ./scripts/install.sh --uninstall 清理 ~/.local 下的旧文件，再安装本包；否则旧的用户级快捷方式会一直遮蔽系统级入口，实际运行的仍是旧版本。

🚀 手动运行（不安装）

无需单独安装 Node.js：优先使用 ZCode 内置运行时，缺少系统 Node 时亦能运行；ZCode 安装在默认或自定义目录均可（自动探测，必要时查注册表）。

git clone https://github.com/duanluan/zcode-pro.git && cd zcode-pro

# Linux / macOS（自动探测 /opt/ZCode、/Applications/ZCode.app）
./bin/zcode-pro
# Windows（自动探测默认安装位置，找不到时查注册表）
bin\zcode-pro.cmd

# 手动添加开始菜单快捷方式（--desktop 同时添加桌面快捷方式，--uninstall 撤销添加快捷方式）
./bin/zcode-pro setup
bin\zcode-pro.cmd setup

📖 参考

命令行选项（zcode-pro --help 查看全部）：

各选项也可用环境变量 ZCODEPRO_* 覆盖。

配置与数据位置：

卸载后直接使用官方 ZCode 入口启动即可，无需清理系统位置。

🔌 插件推荐

duanluan/zcode-plugins 是配套的 ZCode 插件市场，提供 AI 代码评审、对话请求压缩、命令输出压缩等插件，可显著节省 token。安装方式：ZCode → 插件市场 → 右上角“添加”→ 添加插件市场，填写 duanluan/zcode-plugins。已安装的插件可在 ZCode Pro 设置中一键检查并更新。

💬 交流与反馈

• QQ 群：428403354（点击加入）
• 微信群：添加微信 ai4only 邀请进群