Skip to content
duanluanPublic

About

ZCode Pro — ZCode 桌面版界面增强

Resources

Stars

20 stars

Watchers

0 watching

Forks

Repository files navigation

ZCode Pro

English | 简体中文

ZCode 桌面版增强工具:壁纸引擎(图片/视频/网页)、皮肤主题、会话快捷切换、状态栏统计等三十余项界面与体验增强。不修改客户端文件,通过 ZCode Pro 快捷方式或终端命令 zcode-pro 启动即可生效。

npm PyPI AUR 版本 Windows macOS Linux QQ 群 微信

⚙️ 打开设置:启动 ZCode Pro 后,右键点击 ZCode 侧边栏底部的设置按钮(齿轮)即可打开 ZCode Pro 设置窗口。

✨ 功能

按主题分组排列:分类列为设置弹窗的标签页,带 · 的(如“行为 · 全局提示词”)为标签页内的二级子标签。功能表按主题归类,截图按弹窗内的标签页顺序排列。

分类 功能 说明
功能 项目菜单增强(打开文件夹 / 复制路径) 项目“更多”菜单:在系统文件管理器中打开项目目录,或复制项目路径
侧边栏会话拖动排序 拖动调整置顶、项目与分组中的会话顺序,重启后不变
会话快捷切换 alt+z 在当前与上次会话/新建任务之间来回切换;按住 alt 按 x(上移)/ c(下移)在最近会话列表中选择(初始 10 条,c 到底再加载 5 条),alt+e 直接打开最近 10 条,alt+r 打开正在运行与运行完未查看的任务;方向键同样可选,Enter 或点击行切换;五个入口键可在 设置 → 快捷键 中修改
重命名会话名锁定 手动重命名过的会话不再被自动标题覆盖,侧栏始终显示重命名后的名字
已置顶分区可折叠 侧边栏“已置顶”标题可点击折叠/展开其任务列表,折叠状态会记住
文件菜单增强 会话中文件链接的右键菜单新增“默认应用打开”“打开所在目录”
图片右键复制 右键会话中的图片或放大的预览图,复制到剪贴板
插件界面沙箱回收 插件卡片沙箱数量达到上限时释放最早创建的(正在查看的排最后),避免 64 个名额耗尽后新卡片打不开;被释放的旧卡片重新打开所在会话即恢复
插件卡片自动重试 名额腾出后自动补挂因 64 上限失败的插件卡片(自动点“重新加载”)
折叠时任务运行中提示 有会话在运行时,折叠的项目行与“项目”“任务”“已置顶”分区头显示与任务运行中同款的加载图标,全部结束后消失
子代理运行中提示 任务行在后台子代理运行时显示机器人图标、后台终端命令运行时显示终端图标(同时运行机器人优先);未读圆点让位到行尾常显;会话运行中始终显示转圈图标;项目未读徽标忽略错误行
新标签页插件面板入口 官方“新标签页”只列官方面板与推荐的官方插件;本功能把第三方市场插件(headroom、rtk 等)的面板卡片加进去,点击在侧边面板打开
复制表格 回答内容表格的工具条新增“复制表格”按钮:以富文本写入剪贴板,粘贴进 Excel / 富文本编辑器即被识别为表格(分列成格、不带边框与背景色);纯文本场景自动降级为 Tab 分列
会话 ID 显示为任务名链接 提问与回答里出现的会话 ID(sess_ / session_ 开头)显示为任务名,点击切换到该会话,悬停显示原 ID;代码块里的 ID 不处理
模型名显示供应商 输入框的模型名前显示供应商名(如 BigModel-Max1 / glm-5.3),区分同名模型
编辑时保持当前模型 编辑上一条消息时保持你点编辑前选的模型,不换成这条消息当时用的模型;进入编辑后仍可再换
导入会话 把 Codex、Claude Code、dsh、pi 的历史会话复制成 ZCode 任务:按来源分标签,可搜索、按项目筛选、多选导入;导入是快照,保留文字、思考、工具调用和图片,不改变源会话
插件自动更新 一键检查并更新 zcode-plugins 市场插件,可设为打开设置时自动更新
快捷键 会话快捷键自定义 会话快捷切换的五个入口键(默认 alt+z / x / c / e / r)逐个修改:点“修改”后按下新键位(字母/数字)即生效,键位冲突会提示;可一键重置为默认
行为 · ZCode CLI ZCode CLI 技能清单检查:统计完整清单字符数并对照注入预算,超出时提示清单被降级为只剩技能名和路径并给出建议预算;可配置技能系统、清单预算、额外技能目录与功能开关;工作区记忆仍在官方 设置 → Agent 能力 → 记忆 中配置,改动新会话起生效
行为 · 全局提示词 全局提示词 编辑所有项目共享的默认指令,新会话起生效
行为 · 自动重命名 自动重命名 新会话开始作答时按所选供应商与提示词生成任务名(默认跟随当前会话、glm-5.3-flash,提问阶段的多条消息都计入),生成结果按手动重命名保存,官方自动标题不再覆盖;可在设置中选供应商、模型并编辑提示词,附测试按钮;任务行悬浮按钮与右键菜单“重命名任务”下可按最近问答手动重命名,入口开关与问答数在设置里
外观 · 样式 侧栏菜单并入顶栏 “新建任务 / 搜索 / 自动化 / 插件市场”收成顶部导航栏的图标按钮,对应界面打开时高亮
字体调整 自定义界面字体(除终端外全部界面文字)、提问字体与回答字体
侧栏间距调整 微调侧边栏项目间距与任务间距
界面样式调整 微调段落间距、内容宽度、各类行高、列表/引用块/表格间距与单元格边距;聚焦输入框时高亮预览受影响区域
外观 · 状态栏 状态栏统计 提问输入框右下角显示统计项:最近输出 tokens/s(流式生成中按文本增长估算并标 ≈,调用完成后切到官方 60 秒窗口值,回答结束后停留在最后速率)、平均缓存命中率、累计输入/输出、上下文占用(占用高时变色)、主请求数、今日/累计 token、任务总数,以官方数据为主;各项的顺序与显隐在 设置 → 外观 → 状态栏 调整。速率与每轮用量按会话记录统计,子代理是独立的会话记录、不计入
每轮回答 token 用量 在每条回答末尾操作按钮的时间后面显示该轮的输入/输出 token 与缓存命中率(本地记录只保留最近一段,更早的回答不标注)
外观 · 主题 界面皮肤 内置 11 套知名编辑器主题配色(Dracula / Nord / Tokyo Night / Catppuccin / Gruvbox / One Dark / Solarized / Rosé Pine / Everforest / Night Owl / Kanagawa),自动匹配 ZCode 的浅色 / 深色模式;另可自定义主题:浅色、深色各选 5 个颜色生成整套配色,改色实时生效
外观 · 壁纸 壁纸 整窗铺背景,五种来源:无背景 / 本地图库(可传多张、点选当前、可单删)/ 文件夹(原地读取,按间隔定时轮换,可选随机或按文件名顺序)/ 网址(可按间隔定时刷新,配合随机图 API)/ 网页(沙箱 iframe 铺在后方);左栏 / 中栏 / 右栏可分区独立设置(仅静态图,缩放与遮罩可单独调、可跟随全局);遮罩不透明度(图片向主题背景色淡化程度)、图片模糊、面板不透明度(左栏、中栏与右栏的不透明程度)、插件卡片遮罩(插件卡片透出壁纸时垫在卡片底下的主题色遮罩)四个滑杆调节,另有转场方式、视频音量/倍速/帧率上限与暂停条件;设置弹窗默认磨砂透出壁纸(可在该页关掉),菜单等浮层保持不透明保可读;图库随 WebDAV 同步的 zcode-pro 组一起上传(覆盖式,不留历史版本)
性能 空闲项目内存回收 长时间未使用且无任务运行的项目自动释放其占用的内存,启动后也会自动回收一次未使用的项目;会话记录不受影响,再次打开时自动恢复(时长可调)
代理 软件代理 为插件市场更新安装、headroom 与 rtk 的安装升级设置 HTTP 代理(WebDAV 同步可选走代理,默认关),附连通性检测
同步 设置同步 手动把 ZCode Pro 设置与模型设置备份到 WebDAV,或在新电脑上恢复;仅在点击时传输
Vision 视觉代理 主模型不识图时自动交给视觉模型识别图片,识别描述带给主模型;可视化编辑代理链(zcode-vision 插件)
Headroom Headroom 压缩 管理压缩设备、省电切换与代理运行状态,headroom 本体检查更新与升级(headroom 插件)
rtk rtk 压缩 管理改写提醒与命令白名单,rtk 本体检查更新与一键升级(rtk 插件)

各项功能均可在设置弹窗中开关或调整;建议使用最新版 ZCode,旧版本部分功能可能不可用。

🎛 设置界面

右键点击 ZCode 侧边栏底部的设置按钮(齿轮)即可打开设置窗口,主要标签页如下:

功能 外观 · 壁纸 外观 · 主题
外观 · 样式 外观 · 状态栏 行为 · ZCode CLI
行为 · 全局提示词 行为 · 自动重命名 性能
快捷键 代理 同步
导入会话 Vision Headroom
rtk

Vision / Headroom / rtk 三个标签页来自同名插件,未安装时显示一键安装卡,装好后恢复完整设置。

📦 安装与使用

版本建议:推荐使用最新版 ZCode,旧版本部分功能可能不可用。

安装后,通过应用菜单 / 开始菜单中的“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 内置运行时;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

🔒 安全说明

  • 启动器会以 --remote-debugging-port(默认 9333)拉起 ZCode,靠这个调试端口注入增强脚本。该端口没有鉴权,本机任何进程(含其他系统用户)连上后可以在 ZCode 页面里执行任意脚本,只适合在个人电脑上使用;可用 --cdp-port <端口> 或环境变量 ZCODEPRO_CDP_PORT 换端口(挡得住随手扫描,挡不住有心的本机进程)。
  • 本机服务只监听 127.0.0.1:47889,所有接口都要随机 token 才能调用;壁纸等媒体文件的直链上也带着同一个 token,外部网页读不走图库文件。
  • WebDAV 密码与自动重命名用的 API Key 明文存在本机配置文件里(文件权限限本人读写),同步上传时这两项只留本机;自定义模型供应商的 API Key 会随“模型设置”组上传到你自己的 WebDAV(这是同步模型配置本身需要的)。

📖 参考

命令行选项(zcode-pro --help 查看全部):

选项 说明
--cdp-port 调试端口,默认 9333
--helper-port 本地辅助服务端口,默认 47889
--zcode-path 显式指定 ZCode 可执行文件
--inject-only(别名 --no-launch) 只接管已在运行的实例,不启动新实例
--verbose、-v 详细日志
setup [--desktop] [--uninstall] 安装/撤销本机快捷方式(--desktop 同时加桌面)
wallpaper <操作> 壁纸命令行:list / set / rotate / params / upload / delete(wallpaper -h 看详细用法)

仅 --cdp-port、--helper-port、--zcode-path 三个选项另有对应环境变量 ZCODEPRO_CDP_PORT、ZCODEPRO_HELPER_PORT、ZCODEPRO_ZCODE_PATH,命令行参数优先。另有 ZCODE_DATA_BASE_DIR(ZCode 数据根目录)、RTK_DIR(rtk 状态目录)等环境变量,完整列表见 zcode-pro --help。

配置与数据位置:

内容 位置
功能开关、外观(主题/壁纸/样式)、快捷键、代理与同步配置 ~/.zcode/zcodepro.json
启动诊断日志 ~/.zcode/zcodepro.log
全局提示词 ~/.zcode/AGENTS.md
ZCode 行为配置(技能清单预算等) ~/.zcode/cli/config.json
壁纸图库 ~/.zcode/backgrounds/
视觉代理(zcode-vision 插件) ~/.zcode/zcode-vision.json
rtk 压缩(rtk 插件) ~/.zcode-rtk/
Headroom(headroom 插件) ~/.zcode/headroom.json

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

🔌 插件推荐

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

💬 交流与反馈

  • QQ 群:428403354(点击加入)
  • 微信群:添加微信 ai4only 邀请进群

QQ 群二维码    微信二维码(ai4only)

About

ZCode Pro — ZCode 桌面版界面增强

Resources

Stars

20 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages