zcode-pro 0.16.0__tar.gz

zcode_pro-0.16.0/.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+*.log
+.idea/
+scripts/gui-test/
+dist-py/
+__pycache__/
+*.egg-info/

zcode_pro-0.16.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 z
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

zcode_pro-0.16.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.5
+Name: zcode-pro
+Version: 0.16.0
+Summary: ZCode Pro — ZCode 桌面版界面增强启动器（不修改客户端文件），核心功能：项目自定义别名
+Project-URL: Homepage, https://github.com/duanluan/zcode-pro
+Project-URL: Repository, https://github.com/duanluan/zcode-pro
+Project-URL: Issues, https://github.com/duanluan/zcode-pro/issues
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: enhancement,launcher,zcode,zcode-pro
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# ZCode Pro
+
+ZCode 桌面版界面增强工具，不修改客户端文件。核心功能：项目自定义别名。
+
+## 安装
+
+```sh
+pip install zcode-pro
+```
+
+前提：本机已安装 ZCode 桌面版（优先复用其自带的运行时，无需另装 Node.js）；未安装 ZCode 时需要 Node.js >= 22。
+
+也可以通过 npm 安装：`npm install -g zcode-pro`
+
+## 使用
+
+```sh
+zcode-pro          # 启动带增强的 ZCode
+zcode-pro --help   # 查看全部选项
+```
+
+## 链接
+
+- 主页与文档：https://github.com/duanluan/zcode-pro
+- 问题反馈：https://github.com/duanluan/zcode-pro/issues

zcode_pro-0.16.0/README.en.md

@@ -0,0 +1,130 @@
+# ZCode Pro
+
+[简体中文](README.md) | English
+
+ZCode Pro enhances the ZCode desktop UI. No client files are modified; just launch via the ZCode Pro shortcut.
+
+![AUR](https://img.shields.io/aur/version/zcode-pro) ![Platform](https://img.shields.io/badge/platform-win%20%7C%20mac%20%7C%20linux%20%7C%20AUR-blue)
+
+> **Opening settings: after launching ZCode Pro, right-click the settings button (gear) at the bottom of the ZCode sidebar to open the ZCode Pro settings window.**
+
+## ✨ Features
+
+| Feature | Description |
+| --- | --- |
+| Custom project alias | Show a custom name for a project in the sidebar; UI-only, revert anytime |
+| Switch project folder | Point a project at another folder; sidebar, tabs and task history follow. Stop running tasks before switching; historical checkpoints still reference the original path |
+| Open folder / Copy path | Project "More" menu: open the project directory in the file manager, or copy its path |
+| Session drag ordering | Reorder sessions in Pinned, Projects and Groups; persists across refreshes |
+| Session quick switch | `alt+z` toggles between the current and the last session; hold `alt` and press `x` / `c` to pick from recent sessions, release `alt` to switch (like `alt+tab`) |
+| Keep renamed session titles | Sessions you renamed keep their custom title; auto-generated titles no longer overwrite it in the sidebar |
+| Running indicator on collapsed projects | Spins a collapsed project's icon while any of its sessions is still running; stops when they all finish |
+| Idle project memory reclaim | Projects unused for a while with no running tasks release their memory automatically, and unused ones are reclaimed once after startup; sessions are untouched and reload when reopened (durations adjustable) |
+| Sidebar menu in the top bar | Turns the sidebar menu (New task / Search / Automations / Plugin store) into icon buttons next to the top-bar arrows: hover shows the name, highlighted while its view is open, shortcuts still work |
+| Collapsible Pinned section | The sidebar "Pinned" header collapses/expands its task list; the state is remembered |
+| File menu actions | Adds "Open with default app" and "Reveal in file manager" to file links in chat |
+| Copy image | Right-click an image in chat or the enlarged preview to copy it to the clipboard |
+| UI style adjustments | Fine-tune paragraph spacing, content width, line heights, list/quote/table spacing and cell padding; focusing an input highlights the affected areas; applies instantly |
+| Sidebar spacing | Fine-tune sidebar project spacing and task spacing; applies instantly |
+| Font adjustment | Custom UI font (all interface text except the terminal), question font and answer font; applies instantly |
+| Global prompt | Edit default instructions shared by all projects; applies to new sessions |
+| Software proxy | Set an HTTP proxy for plugin updates/installs and tool upgrades, with connectivity test |
+| Settings sync | Manually back up ZCode Pro settings and model settings to WebDAV, or restore them on a new computer; transfers only on click |
+| Vision proxy | Automatically hand images to vision models for recognition when the main model cannot see them, and feed the descriptions to the main model; visual chain editor (zcode-vision plugin) |
+| rtk compression | Manage rewrite hints and the command whitelist; check and upgrade the rtk program (rtk plugin) |
+| Headroom | Manage compression device, power-save switching and proxy status; check and upgrade the headroom program (headroom plugin) |
+| Plugin updates | Check and update zcode-plugins marketplace plugins in one click, optional auto-update on startup |
+
+All features can be toggled or adjusted in the settings window.
+
+## 📦 Installation
+
+Once installed, launch ZCode via the "ZCode Pro" shortcut in your app menu / Start menu, or the `zcode-pro` command in a terminal — the enhancements are enabled automatically in this mode; launching ZCode through its original entry does not load them. After launching, right-click the settings button at the bottom of the ZCode sidebar to open the ZCode Pro settings window.
+
+### 🐧 Linux / macOS
+
+```bash
+git clone https://github.com/duanluan/zcode-pro.git
+cd zcode-pro && ./scripts/install.sh
+```
+
+- Installs to `~/.local`; use `PREFIX=` to choose another location;
+- On Linux, registers an app-menu shortcut "ZCode Pro" (icon reused from the installed ZCode);
+- Do not use this script while the AUR package is installed (the script detects this and refuses): the user-level install would shadow the system-wide one;
+- Uninstall: `./scripts/install.sh --uninstall`.
+
+### 🪟 Windows
+
+```powershell
+git clone https://github.com/duanluan/zcode-pro.git
+cd zcode-pro
+powershell -ExecutionPolicy Bypass -File scripts\install.ps1          # Start menu shortcut
+powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Desktop # plus a desktop shortcut
+```
+
+- Installs to `%LOCALAPPDATA%\ZCodePro`; shortcuts launch silently without a console window;
+- Uninstall: `powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Uninstall`.
+
+### 📦 AUR (Arch / Manjaro)
+
+Installs `/usr/bin/zcode-pro` and a system-level app-menu shortcut. Depends on the [zcode](https://aur.archlinux.org/packages/zcode) package from the AUR.
+
+```bash
+yay -S zcode-pro
+paru -S zcode-pro
+# Manual installation
+git clone https://aur.archlinux.org/zcode-pro.git && cd zcode-pro && makepkg -si
+```
+
+If you previously installed via `install.sh`, run `./scripts/install.sh --uninstall` in that repository clone before switching to the AUR package. Leftover user-level files would keep shadowing the system-wide entry, and you would keep launching the old version.
+
+### 🚀 Run without installing
+
+No standalone Node.js required: when a system Node is missing, the runtime bundled with ZCode is used.
+
+```bash
+git clone https://github.com/duanluan/zcode-pro.git && cd zcode-pro
+./bin/zcode-pro            # Linux / macOS (auto-detects /opt/ZCode, /Applications/ZCode.app)
+bin\zcode-pro.cmd          # Windows (auto-detects %LOCALAPPDATA%\Programs\ZCode\ZCode.exe)
+```
+
+## 📖 Reference
+
+Command-line options (see `zcode-pro --help` for all):
+
+| Option | Description |
+| --- | --- |
+| `--cdp-port` | Debug port, default 9333 |
+| `--helper-port` | Local helper port, default 47889 |
+| `--zcode-path` | Explicit path to the ZCode executable |
+| `--inject-only` | Attach to a running instance only; do not launch a new one |
+| `--verbose` | Verbose logging |
+
+Each option can also be overridden with a `ZCODEPRO_*` environment variable.
+
+Configuration and data locations:
+
+| Content | Location |
+| --- | --- |
+| Feature switches, aliases, software proxy | `~/.zcode/zcodepro.json` |
+| Global prompt | `~/.zcode/AGENTS.md` |
+| Vision proxy (zcode-vision plugin) | `~/.zcode/zcode-vision.json` |
+| rtk compression (rtk plugin) | `~/.zcode-rtk/` |
+| Headroom (headroom plugin) | `~/.zcode/headroom.json` |
+
+After uninstalling, just start ZCode from the official entry; no system cleanup is needed.
+
+## 🔌 Plugin recommendation
+
+[duanluan/zcode-plugins](https://github.com/duanluan/zcode-plugins) is a companion plugin marketplace for ZCode: AI code review, request compression and command-output compression plugins that save tokens. To install: ZCode → Plugin Marketplace → "Add" (top right) → Add plugin marketplace, and enter `duanluan/zcode-plugins`. Installed plugins can be checked and updated from ZCode Pro settings.
+
+## 💬 Community
+
+- QQ group: **428403354** ([join](https://qm.qq.com/q/WXuISJK3ug))
+- WeChat group: add **ai4only** on WeChat to be invited
+
+<p>
+  <img src="assets/qq-group.png" width="200" alt="QQ group QR code" />
+  &nbsp;&nbsp;
+  <img src="assets/wechat-ai4only.png" width="200" alt="WeChat QR code (ai4only)" />
+</p>

zcode_pro-0.16.0/README.md

@@ -0,0 +1,130 @@
+# ZCode Pro
+
+[English](README.en.md) | 简体中文
+
+ZCode 桌面版界面增强工具。不修改客户端文件，通过 ZCode Pro 快捷方式启动即可。
+
+![AUR 版本](https://img.shields.io/aur/version/zcode-pro) ![平台](https://img.shields.io/badge/platform-win%20%7C%20mac%20%7C%20linux%20%7C%20AUR-blue)
+
+> ⚙️ **打开设置：启动 ZCode Pro 后，右键点击 ZCode 侧边栏底部的设置按钮（齿轮）即可打开 ZCode Pro 设置窗口。**
+
+## ✨ 功能
+
+| 功能 | 说明 |
+| --- | --- |
+| 项目自定义别名 | 侧边栏显示自定义名称，仅界面显示，随时恢复 |
+| 切换文件夹 | 将项目指向另一个文件夹，侧边栏、标签页与任务历史一并迁移；切换前建议先停止运行中的任务，历史检查点仍引用原路径 |
+| 打开文件夹 / 复制路径 | 项目“更多”菜单：在系统文件管理器中打开项目目录，或复制项目路径 |
+| 会话拖动排序 | 拖动置顶、项目与分组中的会话调整顺序，刷新后保持 |
+| 会话快捷切换 | `alt+z` 在当前与上次会话间来回切换；按住 `alt` 按 `x` / `c` 弹出最近会话列表选择，松开 `alt` 切换（类 `alt+tab`） |
+| 重命名会话名锁定 | 手动重命名过的会话不再被自动标题覆盖，侧栏始终显示重命名后的名字 |
+| 折叠项目运行提示 | 折叠的项目里仍有会话在运行时，项目图标旋转提示，全部结束后恢复 |
+| 空闲项目内存回收 | 长时间未使用且无任务运行的项目自动释放其占用的内存，启动后也会自动回收一次未使用的项目；会话记录不受影响，再次打开时自动恢复（时长可调） |
+| 侧栏菜单并入顶栏 | “新建任务 / 搜索 / 自动化 / 插件市场”收成顶部导航栏的图标按钮：悬停显示名称，对应界面打开时高亮，快捷键照常可用 |
+| 已置顶分区可折叠 | 侧边栏“已置顶”标题可点击折叠/展开其任务列表，状态记住 |
+| 文件菜单增强 | 会话中文件链接的右键菜单新增“默认应用打开”“打开所在目录” |
+| 复制图片 | 右键会话中的图片或放大的预览图，复制到剪贴板 |
+| 界面样式调整 | 微调段落间距、内容宽度、各类行高、列表/引用块/表格间距与单元格边距；聚焦输入框时高亮预览受影响区域，即改即生效 |
+| 侧栏间距调整 | 微调侧边栏项目间距与任务间距，即改即生效 |
+| 字体调整 | 自定义界面字体（除终端外全部界面文字）、提问字体与回答字体，即改即生效 |
+| 全局提示词 | 编辑所有项目共享的默认指令，新会话起生效 |
+| 软件代理 | 为插件更新安装与本体升级设置 HTTP 代理，附连通性检测 |
+| 设置同步 | 手动把 ZCode Pro 设置与模型设置备份到 WebDAV，或在新电脑上恢复；仅在点击时传输 |
+| 视觉代理 | 主模型不识图时自动交给视觉模型识别图片，识别描述带给主模型；可视化编辑代理链（zcode-vision 插件） |
+| rtk 压缩 | 管理改写提醒与命令白名单，rtk 本体检查更新与一键升级（rtk 插件） |
+| Headroom | 管理压缩设备、省电切换与代理运行状态，headroom 本体检查更新与升级（headroom 插件） |
+| 插件更新 | 一键检查并更新 zcode-plugins 市场插件，可选启动时自动更新 |
+
+各项功能均可在设置弹窗中开关或调整。
+
+## 📦 安装与使用
+
+安装后，通过应用菜单 / 开始菜单中的“ZCode Pro”快捷方式或终端命令 `zcode-pro` 启动 ZCode，增强在该方式下自动生效；使用原有 ZCode 入口启动时不加载增强。
+
+### 🐧 Linux / macOS
+
+- 安装至 `~/.local`，可通过 `PREFIX=` 指定其他位置；
+- Linux 会注册应用菜单快捷方式“ZCode Pro”（图标复用已安装的 ZCode）；
+- 已通过 AUR 安装时请勿再使用本脚本（脚本会检测并拒绝），用户级安装会遮蔽系统级入口；
+- 卸载：`./scripts/install.sh --uninstall`。
+
+```bash
+git clone https://github.com/duanluan/zcode-pro.git
+cd zcode-pro && ./scripts/install.sh
+```
+
+### 🪟 Windows
+
+- 程序安装至 `%LOCALAPPDATA%\ZCodePro`，快捷方式静默启动，不显示控制台窗口；
+- 卸载：`powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Uninstall`。
+
+```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 # 加桌面快捷方式
+```
+
+### 📦 AUR
+
+安装 `/usr/bin/zcode-pro` 与系统级应用菜单快捷方式，依赖 AUR 的 [zcode](https://aur.archlinux.org/packages/zcode) 包。
+
+```bash
+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：缺少系统 Node 时自动使用 ZCode 内置运行时。
+
+```bash
+git clone https://github.com/duanluan/zcode-pro.git && cd zcode-pro
+./bin/zcode-pro            # Linux / macOS（自动探测 /opt/ZCode、/Applications/ZCode.app）
+bin\zcode-pro.cmd          # Windows（自动探测 %LOCALAPPDATA%\Programs\ZCode\ZCode.exe）
+```
+
+## 📖 参考
+
+命令行选项（`zcode-pro --help` 查看全部）：
+
+| 选项 | 说明 |
+| --- | --- |
+| `--cdp-port` | 调试端口，默认 9333 |
+| `--helper-port` | 本地辅助服务端口，默认 47889 |
+| `--zcode-path` | 显式指定 ZCode 可执行文件 |
+| `--inject-only` | 只接管已在运行的实例，不启动新实例 |
+| `--verbose` | 详细日志 |
+
+各选项也可用环境变量 `ZCODEPRO_*` 覆盖。
+
+配置与数据位置：
+
+| 内容 | 位置 |
+| --- | --- |
+| 功能开关、项目别名、软件代理 | `~/.zcode/zcodepro.json` |
+| 全局提示词 | `~/.zcode/AGENTS.md` |
+| 视觉代理（zcode-vision 插件） | `~/.zcode/zcode-vision.json` |
+| rtk 压缩（rtk 插件） | `~/.zcode-rtk/` |
+| Headroom（headroom 插件） | `~/.zcode/headroom.json` |
+
+卸载后直接使用官方 ZCode 入口启动即可，无需清理系统位置。
+
+## 🔌 插件推荐
+
+[duanluan/zcode-plugins](https://github.com/duanluan/zcode-plugins) 是配套的 ZCode 插件市场，提供 AI 代码评审、对话请求压缩、命令输出压缩等插件，可显著节省 token。安装方式：ZCode → 插件市场 → 右上角“添加”→ 添加插件市场，填写 `duanluan/zcode-plugins`。已安装的插件可在 ZCode Pro 设置中一键检查并更新。
+
+## 💬 交流与反馈
+
+- QQ 群：**428403354**（[点击加入](https://qm.qq.com/q/WXuISJK3ug)）
+- 微信群：添加微信 **ai4only** 邀请进群
+
+<p>
+  <img src="assets/qq-group.png" width="200" alt="QQ 群二维码" />
+  &nbsp;&nbsp;
+  <img src="assets/wechat-ai4only.png" width="200" alt="微信二维码（ai4only）" />
+</p>

zcode_pro-0.16.0/README_PYPI.md

@@ -0,0 +1,25 @@
+# ZCode Pro
+
+ZCode 桌面版界面增强工具，不修改客户端文件。核心功能：项目自定义别名。
+
+## 安装
+
+```sh
+pip install zcode-pro
+```
+
+前提：本机已安装 ZCode 桌面版（优先复用其自带的运行时，无需另装 Node.js）；未安装 ZCode 时需要 Node.js >= 22。
+
+也可以通过 npm 安装：`npm install -g zcode-pro`
+
+## 使用
+
+```sh
+zcode-pro          # 启动带增强的 ZCode
+zcode-pro --help   # 查看全部选项
+```
+
+## 链接
+
+- 主页与文档：https://github.com/duanluan/zcode-pro
+- 问题反馈：https://github.com/duanluan/zcode-pro/issues

zcode_pro-0.16.0/bin/zcode-pro

@@ -0,0 +1,52 @@
+#!/bin/sh
+# ZCode Pro 启动器（Linux / macOS）
+# 优先用 ZCode 自带的 Node 运行时（ELECTRON_RUN_AS_NODE），无需安装 Node.js。
+set -e
+
+# 解析符号链接得到脚本真实路径（如 /usr/bin/zcode-pro → /usr/lib/zcode-pro/bin/zcode-pro），
+# 否则经 symlink 调用时 $0 目录不是安装目录，找不到 cli.mjs。
+SELF=$(readlink -f -- "$0" 2>/dev/null || printf '%s' "$0")
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$SELF")" && pwd)
+APP_DIR=$(dirname -- "$SCRIPT_DIR")
+ENTRY="$APP_DIR/cli.mjs"
+
+# 系统级安装（AUR / PREFIX=/opt）时提醒清理 ~/.local 下的手动安装残留：
+# 残留的同名快捷方式优先级更高、~/.local/bin 在 PATH 更靠前，会让菜单与终端一直运行旧版。
+case "$APP_DIR" in
+  "$HOME"/*) ;;  # 自身就是手动安装（默认装在 ~/.local），无需提醒
+  *)
+    if [ -e "$HOME/.local/share/zcode-pro" ] || [ -e "$HOME/.local/bin/zcode-pro" ] \
+       || [ -e "$HOME/.local/share/applications/zcode-pro.desktop" ]; then
+      echo "[zcodepro] 检测到 ~/.local 下有旧版手动安装残留，可能遮蔽本命令与快捷方式（表现为一直运行旧版）。" >&2
+      echo "  清理：rm -f ~/.local/bin/zcode-pro ~/.local/share/applications/zcode-pro.desktop && rm -rf ~/.local/share/zcode-pro" >&2
+    fi
+    ;;
+esac
+
+find_zcode_binary() {
+  if [ -n "$ZCODEPRO_ZCODE_PATH" ] && [ -x "$ZCODEPRO_ZCODE_PATH" ]; then
+    printf '%s' "$ZCODEPRO_ZCODE_PATH"
+    return 0
+  fi
+  for c in /opt/ZCode/zcode /usr/lib/zcode/zcode /usr/share/zcode/zcode /usr/local/ZCode/zcode \
+           "/Applications/ZCode.app/Contents/MacOS/ZCode" "$HOME/Applications/ZCode.app/Contents/MacOS/ZCode"; do
+    if [ -x "$c" ]; then
+      printf '%s' "$c"
+      return 0
+    fi
+  done
+  return 1
+}
+
+# 优先用 ZCode 内置的 Node 运行时（版本恒与 ZCode 匹配，含 node:sqlite/全局 WebSocket），
+# 避免系统 node 过旧（<22.5 缺 node:sqlite、<22 缺全局 WebSocket）时启动失败；
+# 找不到 ZCode 可执行文件时才退回系统 node。
+ZCODE_BIN=$(find_zcode_binary) || {
+  if command -v node >/dev/null 2>&1; then
+    exec node "$ENTRY" "$@"
+  fi
+  echo "[zcodepro] 未找到 node，也未找到 ZCode 可执行文件。请安装 Node.js >= 22 或设置 ZCODEPRO_ZCODE_PATH。" >&2
+  exit 1
+}
+# 用 ZCode 内置的 Node 运行时执行启动器（ELECTRON_RUN_AS_NODE 使其表现为纯 Node）
+ELECTRON_RUN_AS_NODE=1 exec "$ZCODE_BIN" "$ENTRY" "$@"

zcode_pro-0.16.0/bin/zcode-pro.cmd

@@ -0,0 +1,24 @@
+@echo off
+rem ZCode Pro 启动器（Windows）
+rem 优先用 ZCode 自带的 Node 运行时（ELECTRON_RUN_AS_NODE），无需安装 Node.js。
+setlocal
+set "SCRIPT_DIR=%~dp0"
+set "APP_DIR=%SCRIPT_DIR%.."
+set "ENTRY=%APP_DIR%\cli.mjs"
+
+where node >nul 2>nul
+if %errorlevel%==0 (
+  node "%ENTRY%" %*
+  exit /b %errorlevel%
+)
+
+set "ZCODE_BIN=%ZCODEPRO_ZCODE_PATH%"
+if not exist "%ZCODE_BIN%" set "ZCODE_BIN=%LOCALAPPDATA%\Programs\ZCode\ZCode.exe"
+if not exist "%ZCODE_BIN%" set "ZCODE_BIN=%PROGRAMFILES%\ZCode\ZCode.exe"
+if not exist "%ZCODE_BIN%" (
+  echo [zcodepro] 未找到 node，也未找到 ZCode 可执行文件。请安装 Node.js ^>= 22 或设置 ZCODEPRO_ZCODE_PATH。 1>&2
+  exit /b 1
+)
+set "ELECTRON_RUN_AS_NODE=1"
+"%ZCODE_BIN%" "%ENTRY%" %*
+exit /b %errorlevel%

zcode_pro-0.16.0/bin/zcode-pro.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+// ZCode Pro 启动器（npm 全局安装用，跨平台 Node 版；查找逻辑与 bin/zcode-pro shell 版一致）。
+// 优先用 ZCode 自带的 Node 运行时（ELECTRON_RUN_AS_NODE），避免系统 node 过旧
+// （<22.5 缺 node:sqlite、<22 缺全局 WebSocket）时启动失败；
+// 找不到 ZCode 可执行文件时回退当前 node 进程（npm 环境必有 node）。
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const cliPath = fileURLToPath(new URL('../cli.mjs', import.meta.url));
+const argv = process.argv.slice(2);
+
+async function runWithZcodeRuntime() {
+  const { resolveZcodeExecutable } = await import('../src/host/paths.mjs');
+  const zcodeBin = resolveZcodeExecutable('');
+  await new Promise((resolve, reject) => {
+    const child = spawn(zcodeBin, [cliPath, ...argv], {
+      stdio: 'inherit',
+      env: { ...process.env, ELECTRON_RUN_AS_NODE: '1' },
+    });
+    child.on('error', reject);
+    child.on('exit', (code, signal) => {
+      if (signal) process.kill(process.pid, signal);
+      else process.exit(code ?? 0);
+    });
+    resolve();
+  });
+}
+
+try {
+  await runWithZcodeRuntime();
+} catch {
+  await import(cliPath);
+}