zcode-pro 0.17.1__tar.gz → 0.17.2__tar.gz

zcode_pro-0.17.2/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.5
+Name: zcode-pro
+Version: 0.17.2
+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
+
+[English](README.en.md) | 简体中文
+
+ZCode 桌面版界面增强工具。不修改客户端文件，通过 ZCode Pro 快捷方式或终端命令 `zcode-pro` 启动即可。
+
+[![npm](https://img.shields.io/npm/v/zcode-pro?logo=npm&logoColor=white)](https://www.npmjs.com/package/zcode-pro) [![PyPI](https://img.shields.io/pypi/v/zcode-pro?logo=pypi&logoColor=white)](https://pypi.org/project/zcode-pro/) [![AUR 版本](https://img.shields.io/aur/version/zcode-pro?logo=archlinux&logoColor=white)](https://aur.archlinux.org/packages/zcode-pro) [![Windows](https://img.shields.io/badge/-Windows-0078D6?logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2ZmZmZmZiIgZD0iTTAsMEgxMS4zNzdWMTEuMzcySDBaTTEyLjYyMywwSDI0VjExLjM3MkgxMi42MjNaTTAsMTIuNjIzSDExLjM3N1YyNEgwWm0xMi42MjMsMEgyNFYyNEgxMi42MjMiLz48L3N2Zz4%3D)](https://github.com/duanluan/zcode-pro#-windows) [![macOS](https://img.shields.io/badge/-macOS-000000?logo=apple&logoColor=white)](https://github.com/duanluan/zcode-pro#-linux--macos) [![Linux](https://img.shields.io/badge/-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/duanluan/zcode-pro#-linux--macos) [![QQ 群](https://img.shields.io/badge/QQ-428403354-12B7F5?logo=qq&logoColor=white)](https://github.com/duanluan/zcode-pro#-交流与反馈) [![微信](https://img.shields.io/badge/%E5%BE%AE%E4%BF%A1-ai4only-07C160?logo=wechat&logoColor=white)](https://github.com/duanluan/zcode-pro#-交流与反馈)
+
+> ⚙️ **打开设置：启动 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 入口启动时不加载增强。
+
+### 📦 npm / PyPI
+
+运行时优先复用 ZCode 自带的运行时；未找到 ZCode 时回退系统 Node.js（≥ 22）。
+
+```bash
+# 方式一：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`。
+
+```bash
+git clone https://github.com/duanluan/zcode-pro.git
+cd zcode-pro && ./scripts/install.sh
+```
+
+### 🪟 Windows
+
+使用 **PowerShell (管理员)** 运行：
+```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](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：优先使用 ZCode 内置运行时，缺少系统 Node 时亦能运行；ZCode 安装在默认或自定义目录均可（自动探测，必要时查注册表）。
+
+```bash
+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` 查看全部）：
+
+| 选项 | 说明 |
+| --- | --- |
+| `--cdp-port` | 调试端口，默认 9333 |
+| `--helper-port` | 本地辅助服务端口，默认 47889 |
+| `--zcode-path` | 显式指定 ZCode 可执行文件 |
+| `--inject-only` | 只接管已在运行的实例，不启动新实例 |
+| `--verbose` | 详细日志 |
+| `setup [--desktop] [--uninstall]` | 安装/撤销本机快捷方式（`--desktop` 同时加桌面） |
+
+各选项也可用环境变量 `ZCODEPRO_*` 覆盖。
+
+配置与数据位置：
+
+| 内容 | 位置 |
+| --- | --- |
+| 功能开关、项目别名、软件代理 | `~/.zcode/zcodepro.json` |
+| 启动诊断日志（Windows 快捷方式静默启动排查） | `~/.zcode/zcodepro.log` |
+| 全局提示词 | `~/.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="https://raw.githubusercontent.com/duanluan/zcode-pro/main/assets/qq-group.png" width="200" alt="QQ 群二维码" />
+  &nbsp;&nbsp;
+  <img src="https://raw.githubusercontent.com/duanluan/zcode-pro/main/assets/wechat-ai4only.png" width="200" alt="微信二维码（ai4only）" />
+</p>

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/README.en.md

@@ -4,7 +4,7 @@
 
 ZCode Pro enhances the ZCode desktop UI. No client files are modified; just launch via the ZCode Pro shortcut or the `zcode-pro` terminal command.
 
-![npm](https://img.shields.io/npm/v/zcode-pro) ![PyPI](https://img.shields.io/pypi/v/zcode-pro) ![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)
+[![npm](https://img.shields.io/npm/v/zcode-pro?logo=npm&logoColor=white)](https://www.npmjs.com/package/zcode-pro) [![PyPI](https://img.shields.io/pypi/v/zcode-pro?logo=pypi&logoColor=white)](https://pypi.org/project/zcode-pro/) [![AUR](https://img.shields.io/aur/version/zcode-pro?logo=archlinux&logoColor=white)](https://aur.archlinux.org/packages/zcode-pro) [![Windows](https://img.shields.io/badge/-Windows-0078D6?logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2ZmZmZmZiIgZD0iTTAsMEgxMS4zNzdWMTEuMzcySDBaTTEyLjYyMywwSDI0VjExLjM3MkgxMi42MjNaTTAsMTIuNjIzSDExLjM3N1YyNEgwWm0xMi42MjMsMEgyNFYyNEgxMi42MjMiLz48L3N2Zz4%3D)](https://github.com/duanluan/zcode-pro#-windows) [![macOS](https://img.shields.io/badge/-macOS-000000?logo=apple&logoColor=white)](https://github.com/duanluan/zcode-pro#-linux--macos) [![Linux](https://img.shields.io/badge/-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/duanluan/zcode-pro#-linux--macos) [![QQ](https://img.shields.io/badge/QQ-428403354-12B7F5?logo=qq&logoColor=white)](https://github.com/duanluan/zcode-pro#-community) [![WeChat](https://img.shields.io/badge/WeChat-ai4only-07C160?logo=wechat&logoColor=white)](https://github.com/duanluan/zcode-pro#-community)
 
 > **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.**
 
@@ -86,6 +86,8 @@ cd zcode-pro
 powershell -ExecutionPolicy Bypass -File scripts\install.ps1
 # Add a Start-menu shortcut + a desktop shortcut
 powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Desktop
+# ZCode in a non-default directory that auto-detection misses? Pass its path (persisted, removed on uninstall)
+powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Desktop -ZCodePath "D:\ProgramFiles\Zcode\ZCode.exe"
 
 # Uninstall
 powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Uninstall
@@ -141,6 +143,7 @@ Configuration and data locations:
 | Content | Location |
 | --- | --- |
 | Feature switches, aliases, software proxy | `~/.zcode/zcodepro.json` |
+| Startup diagnostics log (silent shortcut launches, Windows) | `~/.zcode/zcodepro.log` |
 | Global prompt | `~/.zcode/AGENTS.md` |
 | Vision proxy (zcode-vision plugin) | `~/.zcode/zcode-vision.json` |
 | rtk compression (rtk plugin) | `~/.zcode-rtk/` |
@@ -158,7 +161,7 @@ After uninstalling, just start ZCode from the official entry; no system cleanup
 - WeChat group: add **ai4only** on WeChat to be invited
 
 <p>
-  <img src="assets/qq-group.png" width="200" alt="QQ group QR code" />
+  <img src="https://raw.githubusercontent.com/duanluan/zcode-pro/main/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)" />
+  <img src="https://raw.githubusercontent.com/duanluan/zcode-pro/main/assets/wechat-ai4only.png" width="200" alt="WeChat QR code (ai4only)" />
 </p>

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/README.md

@@ -4,7 +4,7 @@
 
 ZCode 桌面版界面增强工具。不修改客户端文件，通过 ZCode Pro 快捷方式或终端命令 `zcode-pro` 启动即可。
 
-![npm](https://img.shields.io/npm/v/zcode-pro) ![PyPI](https://img.shields.io/pypi/v/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)
+[![npm](https://img.shields.io/npm/v/zcode-pro?logo=npm&logoColor=white)](https://www.npmjs.com/package/zcode-pro) [![PyPI](https://img.shields.io/pypi/v/zcode-pro?logo=pypi&logoColor=white)](https://pypi.org/project/zcode-pro/) [![AUR 版本](https://img.shields.io/aur/version/zcode-pro?logo=archlinux&logoColor=white)](https://aur.archlinux.org/packages/zcode-pro) [![Windows](https://img.shields.io/badge/-Windows-0078D6?logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2ZmZmZmZiIgZD0iTTAsMEgxMS4zNzdWMTEuMzcySDBaTTEyLjYyMywwSDI0VjExLjM3MkgxMi42MjNaTTAsMTIuNjIzSDExLjM3N1YyNEgwWm0xMi42MjMsMEgyNFYyNEgxMi42MjMiLz48L3N2Zz4%3D)](https://github.com/duanluan/zcode-pro#-windows) [![macOS](https://img.shields.io/badge/-macOS-000000?logo=apple&logoColor=white)](https://github.com/duanluan/zcode-pro#-linux--macos) [![Linux](https://img.shields.io/badge/-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/duanluan/zcode-pro#-linux--macos) [![QQ 群](https://img.shields.io/badge/QQ-428403354-12B7F5?logo=qq&logoColor=white)](https://github.com/duanluan/zcode-pro#-交流与反馈) [![微信](https://img.shields.io/badge/%E5%BE%AE%E4%BF%A1-ai4only-07C160?logo=wechat&logoColor=white)](https://github.com/duanluan/zcode-pro#-交流与反馈)
 
 > ⚙️ **打开设置：启动 ZCode Pro 后，右键点击 ZCode 侧边栏底部的设置按钮（齿轮）即可打开 ZCode Pro 设置窗口。**
 
@@ -88,6 +88,8 @@ 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
@@ -143,6 +145,7 @@ bin\zcode-pro.cmd setup
 | 内容 | 位置 |
 | --- | --- |
 | 功能开关、项目别名、软件代理 | `~/.zcode/zcodepro.json` |
+| 启动诊断日志（Windows 快捷方式静默启动排查） | `~/.zcode/zcodepro.log` |
 | 全局提示词 | `~/.zcode/AGENTS.md` |
 | 视觉代理（zcode-vision 插件） | `~/.zcode/zcode-vision.json` |
 | rtk 压缩（rtk 插件） | `~/.zcode-rtk/` |
@@ -160,7 +163,7 @@ bin\zcode-pro.cmd setup
 - 微信群：添加微信 **ai4only** 邀请进群
 
 <p>
-  <img src="assets/qq-group.png" width="200" alt="QQ 群二维码" />
+  <img src="https://raw.githubusercontent.com/duanluan/zcode-pro/main/assets/qq-group.png" width="200" alt="QQ 群二维码" />
   &nbsp;&nbsp;
-  <img src="assets/wechat-ai4only.png" width="200" alt="微信二维码（ai4only）" />
+  <img src="https://raw.githubusercontent.com/duanluan/zcode-pro/main/assets/wechat-ai4only.png" width="200" alt="微信二维码（ai4only）" />
 </p>

zcode_pro-0.17.2/bin/zcode-pro.cmd

@@ -0,0 +1,48 @@
+@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%"
+rem 用户级 ZCODEPRO_ZCODE_PATH（安装脚本 -ZCodePath 写入）不会传播到已运行的资源
+rem 管理器，进程环境变量缺失时从注册表兜底读取，免去注销/重启（issue #1）。
+if not exist "%ZCODE_BIN%" for /f "tokens=2*" %%A in (
+  'reg query "HKCU\Environment" /v ZCODEPRO_ZCODE_PATH 2^>nul'
+) do if not exist "%ZCODE_BIN%" if exist "%%B" set "ZCODE_BIN=%%B"
+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"
+rem Custom install dir: look up App Paths in registry (per-machine then per-user).
+if not exist "%ZCODE_BIN%" for /f "tokens=2*" %%A in (
+  'reg query "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\zcode.exe" /ve 2^>nul ^|^|
+   reg query "HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\zcode.exe" /ve 2^>nul'
+) do if not exist "%ZCODE_BIN%" if exist "%%B" set "ZCODE_BIN=%%B"
+rem 最后兜底：ZCode 的 NSIS 安装器不写 App Paths、卸载表 DisplayIcon 常指向
+rem uninstallerIcon.ico，从其所在目录推导 ZCode.exe（win11 虚拟机实测，issue #1）。
+rem 逐条验证存在性、取第一个有效命中。src/host/paths.mjs 与 scripts/install.ps1
+rem 也各自实现卸载表定位（匹配方式不完全相同），改推导规则需三处同步。
+if not exist "%ZCODE_BIN%" for /f "tokens=2*" %%A in (
+  'reg query "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" /s /v DisplayIcon 2^>nul ^| findstr /i "zcode" ^|^|
+   reg query "HKLM\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall" /s /v DisplayIcon 2^>nul ^| findstr /i "zcode" ^|^|
+   reg query "HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" /s /v DisplayIcon 2^>nul ^| findstr /i "zcode"'
+) do if not defined ZCODEPRO_UNINST_DIR if exist "%%~dpBZCode.exe" set "ZCODEPRO_UNINST_DIR=%%~dpB"
+if defined ZCODEPRO_UNINST_DIR set "ZCODE_BIN=%ZCODEPRO_UNINST_DIR%ZCode.exe"
+if not exist "%ZCODE_BIN%" (
+  echo [zcodepro] 未找到 node，也未找到 ZCode 可执行文件。请安装 Node.js ^>= 22 或设置 ZCODEPRO_ZCODE_PATH。 1>&2
+  rem 快捷方式静默启动时看不到控制台输出，同步落盘诊断日志（issue #1）；日志超 512KB 轮转
+  if not exist "%USERPROFILE%\.zcode" mkdir "%USERPROFILE%\.zcode" >nul 2>nul
+  for %%I in ("%USERPROFILE%\.zcode\zcodepro.log") do if exist "%%~I" if %%~zI GTR 524288 move /y "%%~I" "%%~dpnI.log.old" >nul 2>nul
+  echo [%DATE% %TIME%] 未找到 node 与 ZCode 可执行文件 >> "%USERPROFILE%\.zcode\zcodepro.log"
+  exit /b 1
+)
+set "ELECTRON_RUN_AS_NODE=1"
+"%ZCODE_BIN%" "%ENTRY%" %*
+exit /b %errorlevel%

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/bin/zcode-pro.vbs

@@ -13,4 +13,5 @@ If WScript.Arguments.Count > 0 Then
   Next
   cmd = cmd & " " & Join(parts, " ")
 End If
-sh.Run cmd, 0, False
+' 经 cmd.exe 调用批处理，避免 wscript 直接运行 .cmd 在部分机器上启动异常（issue #1）
+sh.Run "cmd.exe /d /c " & cmd, 0, False

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcode-pro",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "ZCode Pro — 为 ZCode 桌面版增加界面增强（不修改客户端文件，通过 ZCode Pro 快捷方式启动即可），核心功能：项目自定义别名",
   "type": "module",
   "bin": {

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 name = "zcode-pro"
 dynamic = ["version"]
 description = "ZCode Pro — ZCode 桌面版界面增强启动器（不修改客户端文件），核心功能：项目自定义别名"
-readme = "README_PYPI.md"
+readme = "README.md"
 requires-python = ">=3.10"
 license = "Apache-2.0"
 keywords = ["zcode", "zcode-pro", "launcher", "enhancement"]
@@ -49,7 +49,6 @@ include = [
   "bin",
   "README.md",
   "README.en.md",
-  "README_PYPI.md",
   "LICENSE",
   "package.json",
   "pyproject.toml",

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/src/host/helper.mjs

@@ -15,7 +15,7 @@ import { pickFolderSystem } from './pickFolder.mjs';
 import { reorderWorkspaceTasks, reorderGroupMembers } from './taskOrder.mjs';
 import { webdavRequest, webdavPutWithMkcol, webdavHttpText } from './webdav.mjs';
 
-const VERSION = '0.17.1';
+const VERSION = '0.17.2';
 
 // 全局提示词固定在用户主目录：官方加载器按 HOME/USERPROFILE 拼 .zcode/AGENTS.md，
 // 不读 ZCODE_DATA_BASE_DIR（数据根迁走时全局指令仍在原位）。

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/src/host/main.mjs

@@ -5,8 +5,8 @@
 // 3. 连接 CDP，向所有页面注入增强脚本（新文档自动注入 + 已加载页面立即注入）
 // 4. 启动本地辅助 HTTP 服务并常驻，CDP 断开时自动重连
 import { spawn, execSync, spawnSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { randomBytes } from 'node:crypto';
 import { resolveZcodeExecutable, resolveDataRootDir } from './paths.mjs';
@@ -74,6 +74,26 @@ function guiNotify(title, body) {
   } catch { /* ignore */ }
 }
 
+// Windows 快捷方式静默启动时控制台与桌面通知都不可见（guiNotify 仅 linux 有渠道），
+// 关键启动阶段与致命错误落盘 ~/.zcode/zcodepro.log，便于排查“双击没反应”（issue #1）。
+// 日志超 512KB 时轮转为 .old（zcode-pro.cmd 失败分支有同款轮转，需同步维护）。
+let winLogRotated = false;
+function winLog(line) {
+  if (process.platform !== 'win32') return;
+  try {
+    const dir = resolveDataRootDir();
+    mkdirSync(dir, { recursive: true });
+    const file = join(dir, 'zcodepro.log');
+    if (!winLogRotated) {
+      winLogRotated = true;
+      try {
+        if (existsSync(file) && statSync(file).size > 512 * 1024) renameSync(file, `${file}.old`);
+      } catch { /* ignore */ }
+    }
+    appendFileSync(file, `[${new Date().toISOString()}] ${line}\n`);
+  } catch { /* ignore */ }
+}
+
 async function cdpAlive(port) {
   try { await fetchBrowserWsUrl(port, 1200); return true; } catch { return false; }
 }
@@ -147,9 +167,13 @@ export async function run(argv) {
   try {
     exe = resolveZcodeExecutable(args.zcodePath);
   } catch (err) {
-    if (err.code === 'ZCODE_NOT_FOUND') guiNotify('ZCode Pro 启动失败', '未找到 ZCode 可执行文件，详见终端输出。');
+    if (err.code === 'ZCODE_NOT_FOUND') {
+      winLog('未找到 ZCode 可执行文件: ' + err.message);
+      guiNotify('ZCode Pro 启动失败', '未找到 ZCode 可执行文件，详见终端输出。');
+    }
     throw err;
   }
+  winLog(`启动: ZCode=${exe}, CDP 端口 ${args.cdpPort}`);
   const dataRoot = resolveDataRootDir();
   const token = randomBytes(16).toString('hex');
   const state = { injectedPages: 0 };
@@ -166,10 +190,12 @@ export async function run(argv) {
     if (!ok) {
       console.error(`[zcodepro] 等待 ZCode 调试端口 ${args.cdpPort} 超时。`);
       if (zcodeAppProcessExists()) {
+        winLog(`等待 CDP 端口 ${args.cdpPort} 超时：ZCode 已在运行但未开调试端口，需先退出原实例`);
         console.error('[zcodepro] 检测到 ZCode 已在运行，但未开启调试端口，无法注入。');
         console.error('[zcodepro] 请手动退出当前 ZCode（zcodepro 不会替你关闭正在运行的实例），然后重新运行 zcodepro。');
         guiNotify('ZCode Pro 暂无法注入', 'ZCode 已在运行但未开启调试端口，请退出 ZCode 后重新打开 ZCode Pro。');
       } else {
+        winLog(`等待 CDP 端口 ${args.cdpPort} 超时（未见 ZCode 进程）`);
         guiNotify('ZCode Pro 启动失败', `等待 ZCode 调试端口 ${args.cdpPort} 超时。`);
       }
       process.exit(1);
@@ -191,6 +217,7 @@ export async function run(argv) {
     healthRes = await fetch(`http://127.0.0.1:${args.helperPort}/health`, { headers: { 'X-ZCodePro-Token': token } }).then((r) => r.json());
   } catch (err) {
     console.error(`[zcodepro] 辅助服务健康检查失败: ${err.message}`);
+    winLog('辅助服务健康检查失败: ' + err.message);
     server.close();
     process.exit(1);
   }
@@ -253,10 +280,12 @@ export async function run(argv) {
   }
   if (!conn) {
     console.error('[zcodepro] 无法连接 CDP，退出。');
+    winLog('无法连接 CDP，退出');
     server.close();
     process.exit(1);
   }
   console.log('[zcodepro] 已连接 CDP 并开始注入。保持本进程运行以维持增强；Ctrl+C 退出（不影响 ZCode）。');
+  winLog('已连接 CDP 并开始注入');
 
   process.on('SIGINT', () => { stopping = true; try { conn.close(); } catch {} server.close(); process.exit(0); });
   process.on('SIGTERM', () => { stopping = true; try { conn.close(); } catch {} server.close(); process.exit(0); });
@@ -268,6 +297,7 @@ export async function run(argv) {
     // 连接断开：ZCode 退出则一并退出，否则重连
     if (!(await cdpAlive(args.cdpPort))) {
       console.log('[zcodepro] ZCode 已退出，zcodepro 一并退出。');
+      winLog('ZCode 已退出，zcodepro 一并退出');
       server.close();
       process.exit(0);
     }

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/src/host/paths.mjs

@@ -1,13 +1,29 @@
 // 跨平台定位 ZCode 桌面版可执行文件。
-// 优先级：--zcode-path 参数 > ZCODEPRO_ZCODE_PATH 环境变量 > 平台默认候选路径 > 注册表（Windows） > PATH 上的 zcode。
+// 优先级：--zcode-path 参数 > ZCODEPRO_ZCODE_PATH 环境变量（进程 > 用户注册表） >
+// 平台默认候选路径 > 注册表 App Paths/卸载表（Windows） > PATH 上的 zcode。
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { arch, homedir, platform } from 'node:os';
 import { execFileSync } from 'node:child_process';
 
+// reg 输出按行取 REG_SZ 后的值，容忍引号与 ",0" 图标序号后缀。
+const reg = (args) => {
+  try {
+    return execFileSync('reg', args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+  } catch { return ''; }
+};
+const valueAfter = (out) => (out.split(/REG_SZ\s+/)[1] || '').trim();
+
+// 安装脚本 -ZCodePath 持久化的用户级环境变量（HKCU\Environment）：写入后不会传播
+// 到已运行的资源管理器，进程环境变量读不到时从这里兜底，免注销/重启（issue #1）。
+function windowsUserEnvZcodePath() {
+  const value = valueAfter(reg(['query', 'HKCU\\Environment', '/v', 'ZCODEPRO_ZCODE_PATH']));
+  return value ? [value] : [];
+}
+
 // Windows 注册表探测（结果缓存）：自定义安装目录的安装器会在 App Paths（可执行
 // 文件全路径）或卸载表 DisplayIcon（控制面板-卸载软件里可见）留有登记，固定
-// 候选找不到时兜底。reg 输出按行取 REG_SZ 后的值，容忍引号与 ",0" 图标序号后缀。
+// 候选找不到时兜底。
 let winRegistryCandidates;
 
 function windowsRegistryCandidates() {
@@ -21,18 +37,16 @@ function windowsRegistryCandidates() {
       winRegistryCandidates.push(p);
     }
   };
-  const reg = (args) => {
-    try {
-      return execFileSync('reg', args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
-    } catch { return ''; }
-  };
-  const valueAfter = (out) => (out.split(/REG_SZ\s+/)[1] || '').trim();
   // App Paths：安装器注册的可执行文件全路径（ShellExecute 同款查找）
   for (const root of ['HKLM', 'HKCU']) {
     const out = reg(['query', `${root}\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\App Paths\\zcode.exe`, '/ve']);
     if (out) push(valueAfter(out));
   }
-  // 卸载表 DisplayIcon：安装目录自定义时通常只有这里能找到
+  // 卸载表 DisplayIcon：安装目录自定义时通常只有这里能找到。
+  // ZCode 的 NSIS 安装器不写 App Paths、DisplayIcon 常指向 uninstallerIcon.ico，
+  // 从其所在目录推导 ZCode.exe（win11 虚拟机实测，issue #1）。逐条验证取第一个
+  // 有效命中。zcode-pro.cmd 与 install.ps1 也各自实现卸载表定位（匹配方式不完全
+  // 相同），改推导规则需三处同步。
   for (const key of [
     'HKLM\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall',
     'HKLM\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall',
@@ -41,7 +55,14 @@ function windowsRegistryCandidates() {
     const out = reg(['query', key, '/s', '/v', 'DisplayIcon']);
     for (const line of out.split(/\r?\n/)) {
       const seg = (line.split(/REG_SZ\s+/)[1] || '').trim();
-      if (seg && /zcode/i.test(seg)) push(seg);
+      if (seg && /zcode/i.test(seg)) {
+        push(seg);
+        const dir = seg.replace(/[^\\\/]+$/, '');
+        if (dir) {
+          push(join(dir, 'ZCode.exe'));
+          push(join(dir, 'zcode.exe'));
+        }
+      }
     }
   }
   return winRegistryCandidates;
@@ -53,6 +74,7 @@ function candidates() {
     const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
     const programFiles = process.env.PROGRAMFILES || 'C:\\Program Files';
     return [
+      ...windowsUserEnvZcodePath(),
       join(localAppData, 'Programs', 'ZCode', 'ZCode.exe'),
       join(localAppData, 'Programs', 'zcode', 'zcode.exe'),
       join(programFiles, 'ZCode', 'ZCode.exe'),

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/src/host/setup.mjs

@@ -163,7 +163,7 @@ export function windowsShortcutPlan(cmd, desktop = false, wshOk = true) {
     '  Next',
     '  cmd = cmd & " " & Join(parts, " ")',
     'End If',
-    'sh.Run cmd, 0, False',
+    'sh.Run "cmd.exe /d /c " & cmd, 0, False',
     '',
   ].join('\r\n');
   // 图标复用已安装的 ZCode：探测走 paths.mjs 同一条优先级（含注册表，覆盖自定义

{zcode_pro-0.17.1 → zcode_pro-0.17.2}/zcode_pro/__init__.py

@@ -1,3 +1,3 @@
 """ZCode Pro 的 PyPI 安装包：内置 Node 应用源码，通过 zcode-pro 命令启动。"""
 
-__version__ = "0.17.1"
+__version__ = "0.17.2"

zcode_pro-0.17.1/PKG-INFO

@@ -1,45 +0,0 @@
-Metadata-Version: 2.5
-Name: zcode-pro
-Version: 0.17.1
-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.17.1/README_PYPI.md

@@ -1,25 +0,0 @@
-# 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.17.1/bin/zcode-pro.cmd

@@ -1,29 +0,0 @@
-@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"
-rem Custom install dir: look up App Paths in registry (per-machine then per-user).
-if not exist "%ZCODE_BIN%" for /f "tokens=2*" %%A in (
-  'reg query "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\zcode.exe" /ve 2^>nul ^|^|
-   reg query "HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\zcode.exe" /ve 2^>nul'
-) do if not exist "%ZCODE_BIN%" if exist "%%B" set "ZCODE_BIN=%%B"
-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%