zcode-pro 0.20.3 → 1.1.0

package/README.en.md

@@ -12,16 +12,17 @@ ZCode Pro enhances the ZCode desktop UI. No client files are modified; just laun
 
 | 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 |
+| Custom project alias | Show a custom name for a project in the sidebar; UI-only, revert anytime; renaming is built into ZCode ≥ 3.16.1 (project menu "Edit project") — the feature disables itself there and offers to migrate existing aliases |
+| 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; retired on ZCode ≥ 3.16.1, where a project can hold multiple directories natively |
 | 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`) |
+| Session quick switch | `alt+z` toggles between the current and the last session; hold `alt` and press `x` (up) / `c` (down) to pick from recent sessions (10 shown initially, pressing `c` at the bottom loads 5 more), `alt+e` opens the last 10 directly, `alt+r` opens running / finished-but-unseen tasks; arrow keys also move the highlight, release `alt` or press `Enter` to switch (like `alt+tab`); the five trigger keys are customizable in Settings → Shortcuts |
 | Keep renamed session titles | Sessions you renamed keep their custom title; auto-generated titles no longer overwrite it in the sidebar |
 | Task name prompt | When a new session starts answering, generates the task name with a provider and prompt you choose (following the current session and glm-5.3-flash by default; every question sent before the first answer counts), saved as a manual rename the built-in auto title never overrides; provider, model and prompt are editable in settings, with a test button |
-| Running indicator on collapsed projects | Spins a collapsed project's icon while any of its sessions is still running; stops when they all finish |
+| Running indicator while collapsed | While any session is running, collapsed projects and the "Tasks" / "Pinned" section headers show the same loader the running task row uses; it disappears when 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 |
+| Plugin card sandbox reclaim | Releases the oldest plugin-card sandboxes once the cap is hit (the one being viewed goes last), so new cards keep opening after the 64-slot pool fills up; released cards come back when their session is reopened (cap adjustable) |
+| Sidebar menu in the top bar | Turns "New task / Search / Automations / Plugin store" into icon buttons in the top navigation bar: 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 |
@@ -36,10 +37,12 @@ ZCode Pro enhances the ZCode desktop UI. No client files are modified; just laun
 | 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.
+All features can be toggled or adjusted in the settings window; works on both ZCode 3.16.1 and 3.15.x.
 
 ## 📦 Installation
 
+> **Version match**: for ZCode ≥ 3.16.1 use **zcode-pro 1.1.0** (latest npm / PyPI / AUR release); for ZCode ≤ 3.15.x use **zcode-pro 0.20.3** (the previous release, still available).
+
 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.
 
 ### 📦 npm / PyPI

package/README.md

@@ -12,15 +12,16 @@ ZCode 桌面版界面增强工具。不修改客户端文件，通过 ZCode Pro
 
 | 功能 | 说明 |
 | --- | --- |
-| 项目自定义别名 | 侧边栏显示自定义名称，仅界面显示，随时恢复 |
-| 切换文件夹 | 将项目指向另一个文件夹，侧边栏、标签页与任务历史一并迁移；切换前建议先停止运行中的任务，历史检查点仍引用原路径 |
+| 项目自定义别名 | 侧边栏显示自定义名称，仅界面显示，随时恢复；ZCode ≥ 3.16.1 已内置改名（项目菜单“编辑项目”），本功能自动停用并引导把已有别名迁移过去 |
+| 切换文件夹 | 将项目指向另一个文件夹，侧边栏、标签页与任务历史一并迁移；切换前建议先停止运行中的任务，历史检查点仍引用原路径；ZCode ≥ 3.16.1 官方已支持一个项目挂多个目录，本功能随之停用 |
 | 打开文件夹 / 复制路径 | 项目“更多”菜单：在系统文件管理器中打开项目目录，或复制项目路径 |
 | 会话拖动排序 | 拖动置顶、项目与分组中的会话调整顺序，刷新后保持 |
-| 会话快捷切换 | `alt+z` 在当前与上次会话间来回切换；按住 `alt` 按 `x` / `c` 弹出最近会话列表选择，松开 `alt` 切换（类 `alt+tab`） |
+| 会话快捷切换 | `alt+z` 在当前与上次会话间来回切换；按住 `alt` 按 `x`（上移）/ `c`（下移）在最近会话列表中选择（初始 10 条，`c` 到底再加载 5 条），`alt+e` 直接打开最近 10 条，`alt+r` 打开正在运行与运行完未查看的任务；方向键同样可选，松开 `alt` 或 `Enter` 切换（类 `alt+tab`）；五个入口键可在 设置 → 快捷键 中修改 |
 | 重命名会话名锁定 | 手动重命名过的会话不再被自动标题覆盖，侧栏始终显示重命名后的名字 |
 | 任务名提示词 | 新会话开始作答时按所选供应商与提示词生成任务名（默认跟随当前会话、glm-5.3-flash，提问阶段的多条消息都计入），生成结果按手动重命名保存，官方自动标题不再覆盖；可在设置中选供应商、模型并编辑提示词，附测试按钮 |
-| 折叠项目运行提示 | 折叠的项目里仍有会话在运行时，项目图标旋转提示，全部结束后恢复 |
+| 折叠时任务运行中提示 | 有会话在运行时，折叠的项目与“任务”“已置顶”等分区头显示与任务运行中同款的加载图标，全部结束后消失 |
 | 空闲项目内存回收 | 长时间未使用且无任务运行的项目自动释放其占用的内存，启动后也会自动回收一次未使用的项目；会话记录不受影响，再次打开时自动恢复（时长可调） |
+| 插件界面沙箱回收 | 插件卡片沙箱数量达到上限时释放最早创建的（正在查看的排最后），避免 64 个名额耗尽后新卡片打不开；被释放的旧卡片重新打开所在会话即恢复（上限可调） |
 | 侧栏菜单并入顶栏 | “新建任务 / 搜索 / 自动化 / 插件市场”收成顶部导航栏的图标按钮：悬停显示名称，对应界面打开时高亮，快捷键照常可用 |
 | 已置顶分区可折叠 | 侧边栏“已置顶”标题可点击折叠/展开其任务列表，状态记住 |
 | 文件菜单增强 | 会话中文件链接的右键菜单新增“默认应用打开”“打开所在目录” |
@@ -36,10 +37,12 @@ ZCode 桌面版界面增强工具。不修改客户端文件，通过 ZCode Pro
 | Headroom | 管理压缩设备、省电切换与代理运行状态，headroom 本体检查更新与升级（headroom 插件） |
 | 插件更新 | 一键检查并更新 zcode-plugins 市场插件，可选启动时自动更新 |
 
-各项功能均可在设置弹窗中开关或调整。
+各项功能均可在设置弹窗中开关或调整，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