Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions plugins/ztools-dock/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# 程序坞开发约定

- 用中文沟通。
- 默认只做最小回归:构建/打包检查,以及本次变更直接影响的测试和1条实际宿主操作链路。
- 只有用户明确要求“完整回归”时,才运行全量单元、`scripts/test-host.mjs` 和完整升级测试;不要每个版本自动运行全套。
- 新增功能验证取消、保存及必要的失败分支;文案和普通样式调整以构建与页面查看为主,不扩展成全量功能回归。
- 市场 CI 的构建与打包属于发布检查。提交说明只填写本次实际执行的检查范围,不沿用旧版通过数量。
44 changes: 44 additions & 0 deletions plugins/ztools-dock/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,49 @@
## 0.1.21

- 统一入口编辑与外观设置的下拉样式,加入搜索、选中标记、键盘选择和自动避让。
- 插件与分类的当前值、下拉选项都显示图标,支持分类自定义图片。
- 插件图标按可见范围加载,缩略图缓存最多128项、最长64px、最多3项并发,避免重复读取插件清单。

## 0.1.20

- 添加插件前先确认两项读取权限,默认不勾选,全部勾选后才能继续。
- 新增授权管理入口,可查看状态、停止读取,并打开ZTools设置移除宿主授权。
- 精简设置说明;默认采用定向回归,仅用户明确要求时执行完整回归。

## 0.1.19

- 移除外层背景材质选项,替换为背景图片上传、预览、更换和移除。
- 支持PNG、JPG和WebP(5MB以内),自动压缩存入配置,在导航条和弹窗中居中裁剪铺满。
- 原生云母和亚克力背景停用;菜单和入口玻璃样式保持独立,背景图片支持不透明度及备份迁移。

## 0.1.18

- 新增冰蓝厚玻璃、柔光磨砂、液态玻璃、清透描边、虹彩玻璃,直接应用于每个分类菜单和入口卡片。
- 材质强度 0~100% 可调,增加效果预览;卡片质感与外层云母/亚克力背景分别设置。
- 旧配置沿用经典纯色,原分类、入口与尺寸保留。

## 0.1.17

- 修复悬浮反复展开时卡片布局和裁剪区域重算导致的闪跳,收起时保留弹窗尺寸。
- 原生材质背景先于内容窗口显示;钉住收起保持布局并禁止隐藏卡片获得焦点。

## 0.1.16

- 插件入口改为选择已安装插件及其指令,自动带入插件图标。
- 插件列表按需授权读取;旧入口保留,停用或同名插件标明原因。

# 更新记录

## 0.1.15 - 2026-11-14

- 设置按停靠位置、边缘触发区、菜单导航、卡片弹窗、材质与颜色、展开与收起分组,增加快速跳转与尺寸恢复自动按钮;入口管理和备份帮助同步调整。
- 商店详情精简为快速使用、常用功能和运行要求,移除重复说明、开发测试记录和重复截图。

- 材质下拉框改为直接点击的纯色、云母、亚克力按钮,保存期间防止重复点击;原生材质之间切换立即恢复已有背景布局。
- 关闭钉住功能时同时移除图钉占用的宽度或高度;手动固定导航尺寸时,分类区域接管按钮位置。
- 新增导航条宽度、高度和卡片弹窗宽度、高度四项独立设置,0 为自动;固定弹窗按可用宽度减少列数,超出高度时滚动,所有尺寸限制在屏幕可用区域内。
- 四项尺寸支持备份、升级恢复和外观重置;旧配置默认自动,保留原有分类与入口。

## 0.1.14 - 2026-11-13

- “图标大小”改为50%~150%的“卡片缩放”滑块,默认100%,同步缩放入口卡片宽高、图片/图标、间距和文字,顶部分类导航大小保持不变。
Expand Down
83 changes: 19 additions & 64 deletions plugins/ztools-dock/MARKET.md
Original file line number Diff line number Diff line change
@@ -1,77 +1,32 @@
# 程序坞

Windows 屏幕边缘的分类启动器。悬停边缘触发条展开程序坞,按分类打开应用、文件、文件夹、网址和已安装的 ZTools 插件。
把常用应用、文件、文件夹、网址和 ZTools 插件放到屏幕边缘。鼠标移过去展开,点击即可打开。

## 使用
![程序坞](screenshots/dock-adaptive-width.png)

- “卡片缩放”范围50%~150%,默认100%,调整整张入口卡片、图标和间距;弹窗同步自适应,空间不足时减少列数,导航保持原大小。旧高度和图标大小作为基准保留。
## 开始使用

- “外观与行为 → 启用钉住功能”控制导航栏图钉,默认开启。关闭后隐藏按钮并取消已有钉住,恢复整体自动收起。
- “每行最多列数”为上限:入口不足时按实际数量自动收窄弹窗,卡片大小保持不变;搜索结果也同步自适应。
1. 安装后,在 ZTools 输入 **程序坞设置**,添加分类和入口。也可以把应用、快捷方式、文件或文件夹拖进设置页。
2. 复制网址或本地文件后唤起 ZTools,选择 **添加到程序坞**。没有自动匹配时,粘贴到搜索框或直接输入这条指令。
3. 悬停屏幕边缘的触发条展开;也可以搜索 **程序坞** 或 **dock**。右键程序坞打开设置。

- “外观与行为”中的“显示菜单栏名称”“显示入口名称”可以分别关闭分类导航和入口卡片文字,默认都开启。关闭后悬停提示、搜索和管理页面名称仍保留。
在插件管理中关闭本插件的“退出即结束”,让程序坞留在后台。需要随 ZTools 启动时,可开启宿主提供的“跟随启动”。

- 在“外观与行为”选择上/下/左/右停靠;支持比例定位(0% 起点、50% 居中、100% 终点),也可选择距左/右边的距离,侧边停靠对应距上/下边。距离为逻辑像素,超出工作区时自动限制。默认顶部居中,侧边分类纵向滚动。
## 按习惯调整

- 在 ZTools 搜索“程序坞设置”管理分类和入口,搜索“程序坞”或“dock”展开面板。
- 分类栏右侧图钉可钉住导航条。鼠标离开后卡片区收起,移回导航条再次展开;取消钉住后整个程序坞自动收起。
- 右键顶部细条、导航栏或卡片面板打开设置。分类和入口可拖拽排序,空分类在设置中管理。
- 复制网址、应用、文件或文件夹后唤起 ZTools,选择“添加到程序坞”;也可粘贴到搜索框。宿主关闭复制内容自动匹配时,可手动粘贴或输入“添加到程序坞”。单项打开预填表单,批量添加先确认。
- 默认分类:网址 → 网址;应用 → 常用工具;文件 → 文件处理;文件夹 → 文件夹。可在表单中修改分类。
- 网址编辑页“获取图标”读取网站 favicon,并随配置保存;失败时可选择本地 PNG/JPG/WebP 图片。
- “外观与行为”可选择经典细条、虫仔、蜗牛触发主题,以及50%~150%的入口卡片缩放。卡通主题为静态矢量图案,触发区高度为 32 px。
- 触发图案底边始终朝向所选屏幕边缘。“底部距屏幕边缘”默认为0,正数向内、负数藏到边缘外,至少保留1px供悬停唤出。可上传2MB以内PNG,自动裁掉透明留白、按比例显示,图案高度最多160px;图片随JSON备份保存。
- 面板支持纯色、原生云母、原生亚克力。原生材质需要 Windows 11 22H2+;不支持的系统使用纯色。背景不透明度只调整表面着色,不改变文字和图标的不透明度,系统模糊强度由 Windows 控制。
- 搜索默认关闭,可在“外观与行为”开启。开启后 Ctrl+F 聚焦搜索,Enter 打开首项。
- “外观与行为”页底部的重置仅恢复该页设置,保留分类、入口、图标、顺序和启用/暂停状态。
- 备份页可导出、导入 JSON 配置。退出 ZTools 会同时结束程序坞。
- **整理入口**:分类和入口可拖动排序,空分类自动隐藏。插件与分类选择支持图标,长列表可搜索。网址支持获取网站图标,也可选择本地图片。
- **停靠位置**:上、下、左、右任选,按比例或距离定位。触发区可用细条、虫仔、蜗牛,或上传 PNG(不超过 2 MB)。
- **尺寸与外观**:菜单条、卡片弹窗分别设置宽高;点击“自动”恢复内容适配。卡片支持 50%~150% 整体缩放,菜单名称和入口名称可分别隐藏。
- **卡片材质**:经典纯色、冰蓝厚玻璃、柔光磨砂、液态玻璃、清透描边、虹彩玻璃,作用于每个菜单和入口,强度支持 0~100%。
- **钉住与搜索**:图钉只固定菜单条,卡片仍随鼠标离开收起。图钉和搜索框都可在设置中开关,搜索默认关闭。
- **备份**:导出、导入 JSON,保存分类、入口、图片和外观。重置外观不会删除分类和入口;换电脑后,本地路径可能需要重新选择。

## 界面
![分组设置](screenshots/settings-overview.png)

![50%卡片](screenshots/dock-card-scale-50.png)
## 运行要求

![150%卡片](screenshots/dock-card-scale-150.png)
仅支持 Windows,依赖 ZTools 运行。可在一个选定显示屏的工作区四边停靠,副屏断开后回到主屏。

![钉住功能开关](screenshots/pin-setting.png)
菜单与入口的玻璃样式使用高光、渐变和内阴影呈现。导航条和弹窗支持上传背景图片(PNG、JPG、WebP,最大5MB),可更换、移除并调整不透明度;图片随配置备份保存。

![两入口自适应弹窗](screenshots/dock-adaptive-width.png)

![悬浮分类栏和入口卡片](screenshots/dock.png)

上图为隔离配置中的示例入口,展示自定义分类、图标与卡片布局,不表示内置截图、录屏等工具。

![重置外观与行为](screenshots/appearance.png)

![PNG和边缘距离设置](screenshots/trigger-art-settings.png)

![卡片整体缩放设置](screenshots/card-scale-settings.png)

![停靠方向和位置设置](screenshots/position-settings.png)

![左侧停靠](screenshots/dock-position-left.png)

![名称显示设置](screenshots/name-visibility-settings.png)

![仅显示图标](screenshots/names-hidden-top.png)

## 范围

仅支持 Windows,在一个选定显示屏的工作区四边停靠。副屏断开后回退主屏。依赖 ZTools 后台运行,可按宿主提供的“退出即结束”“跟随启动”选项设置。

不包含全屏自动避让、多屏同时停靠、应用参数或自定义脚本。管理员窗口、UAC 安全桌面及独占全屏场景未保证兼容。插件跳转使用唯一插件标题和指令,同名插件无法区分。

## 构建与验证

```sh
npm ci
npm test
npm run build
```

正式安装目录为 `dist/`。源码 manifest 位于 `public/plugin.json`。`npm run pack` 可生成根布局的安装 ZIP,并排除旧哈希资源和 Vite 内部清单。

0.1.14已通过43项单元、46项生产ZIP隔离宿主检查。另1项最终桌面合成像素检查因Windows锁屏暂不可执行,没有计为通过;原生Mica/Acrylic属性、四向背景窗组件边界和生命周期检查通过。5项0.1.13→0.1.14升级/恢复检查通过。宿主验证环境为ZTools3.3.0-beta.2安装版app.asar + 独立Electron41.4.0,不能等同日常EXE完整人工验收。文件粘贴匹配及原生选择框使用受控适配器,本地PNG解码、文件读写和程序启动执行真实API。

宿主回归需设置 `ZTOOLS_EXECUTABLE`,另用 `ZTOOLS_APP` 指向 app.asar(若适用),执行 `npm run test:host`。测试使用独占临时 profile,不修改日常用户配置。

MIT 许可。Vue 与 Lucide 的许可随构建产物提供。
暂不支持全屏自动避让、多屏同时停靠、启动参数和自定义脚本;管理员窗口、UAC 安全桌面及独占全屏场景未保证兼容。添加插件入口时,从已安装插件中选择名称和指令,自动带入图标。首次使用需勾选两项读取权限并在 ZTools 确认;“备份与帮助 → 插件授权”可管理读取和宿主授权。同名插件暂无法区分。
83 changes: 19 additions & 64 deletions plugins/ztools-dock/README.md
Original file line number Diff line number Diff line change
@@ -1,77 +1,32 @@
# 程序坞

Windows 屏幕边缘的分类启动器。悬停边缘触发条展开程序坞,按分类打开应用、文件、文件夹、网址和已安装的 ZTools 插件。
把常用应用、文件、文件夹、网址和 ZTools 插件放到屏幕边缘。鼠标移过去展开,点击即可打开。

## 使用
![程序坞](screenshots/dock-adaptive-width.png)

- “卡片缩放”范围50%~150%,默认100%,调整整张入口卡片、图标和间距;弹窗同步自适应,空间不足时减少列数,导航保持原大小。旧高度和图标大小作为基准保留。
## 开始使用

- “外观与行为 → 启用钉住功能”控制导航栏图钉,默认开启。关闭后隐藏按钮并取消已有钉住,恢复整体自动收起。
- “每行最多列数”为上限:入口不足时按实际数量自动收窄弹窗,卡片大小保持不变;搜索结果也同步自适应。
1. 安装后,在 ZTools 输入 **程序坞设置**,添加分类和入口。也可以把应用、快捷方式、文件或文件夹拖进设置页。
2. 复制网址或本地文件后唤起 ZTools,选择 **添加到程序坞**。没有自动匹配时,粘贴到搜索框或直接输入这条指令。
3. 悬停屏幕边缘的触发条展开;也可以搜索 **程序坞** 或 **dock**。右键程序坞打开设置。

- “外观与行为”中的“显示菜单栏名称”“显示入口名称”可以分别关闭分类导航和入口卡片文字,默认都开启。关闭后悬停提示、搜索和管理页面名称仍保留。
在插件管理中关闭本插件的“退出即结束”,让程序坞留在后台。需要随 ZTools 启动时,可开启宿主提供的“跟随启动”。

- 在“外观与行为”选择上/下/左/右停靠;支持比例定位(0% 起点、50% 居中、100% 终点),也可选择距左/右边的距离,侧边停靠对应距上/下边。距离为逻辑像素,超出工作区时自动限制。默认顶部居中,侧边分类纵向滚动。
## 按习惯调整

- 在 ZTools 搜索“程序坞设置”管理分类和入口,搜索“程序坞”或“dock”展开面板。
- 分类栏右侧图钉可钉住导航条。鼠标离开后卡片区收起,移回导航条再次展开;取消钉住后整个程序坞自动收起。
- 右键顶部细条、导航栏或卡片面板打开设置。分类和入口可拖拽排序,空分类在设置中管理。
- 复制网址、应用、文件或文件夹后唤起 ZTools,选择“添加到程序坞”;也可粘贴到搜索框。宿主关闭复制内容自动匹配时,可手动粘贴或输入“添加到程序坞”。单项打开预填表单,批量添加先确认。
- 默认分类:网址 → 网址;应用 → 常用工具;文件 → 文件处理;文件夹 → 文件夹。可在表单中修改分类。
- 网址编辑页“获取图标”读取网站 favicon,并随配置保存;失败时可选择本地 PNG/JPG/WebP 图片。
- “外观与行为”可选择经典细条、虫仔、蜗牛触发主题,以及50%~150%的入口卡片缩放。卡通主题为静态矢量图案,触发区高度为 32 px。
- 触发图案底边始终朝向所选屏幕边缘。“底部距屏幕边缘”默认为0,正数向内、负数藏到边缘外,至少保留1px供悬停唤出。可上传2MB以内PNG,自动裁掉透明留白、按比例显示,图案高度最多160px;图片随JSON备份保存。
- 面板支持纯色、原生云母、原生亚克力。原生材质需要 Windows 11 22H2+;不支持的系统使用纯色。背景不透明度只调整表面着色,不改变文字和图标的不透明度,系统模糊强度由 Windows 控制。
- 搜索默认关闭,可在“外观与行为”开启。开启后 Ctrl+F 聚焦搜索,Enter 打开首项。
- “外观与行为”页底部的重置仅恢复该页设置,保留分类、入口、图标、顺序和启用/暂停状态。
- 备份页可导出、导入 JSON 配置。退出 ZTools 会同时结束程序坞。
- **整理入口**:分类和入口可拖动排序,空分类自动隐藏。插件与分类选择支持图标,长列表可搜索。网址支持获取网站图标,也可选择本地图片。
- **停靠位置**:上、下、左、右任选,按比例或距离定位。触发区可用细条、虫仔、蜗牛,或上传 PNG(不超过 2 MB)。
- **尺寸与外观**:菜单条、卡片弹窗分别设置宽高;点击“自动”恢复内容适配。卡片支持 50%~150% 整体缩放,菜单名称和入口名称可分别隐藏。
- **卡片材质**:经典纯色、冰蓝厚玻璃、柔光磨砂、液态玻璃、清透描边、虹彩玻璃,作用于每个菜单和入口,强度支持 0~100%。
- **钉住与搜索**:图钉只固定菜单条,卡片仍随鼠标离开收起。图钉和搜索框都可在设置中开关,搜索默认关闭。
- **备份**:导出、导入 JSON,保存分类、入口、图片和外观。重置外观不会删除分类和入口;换电脑后,本地路径可能需要重新选择。

## 界面
![分组设置](screenshots/settings-overview.png)

![50%卡片](screenshots/dock-card-scale-50.png)
## 运行要求

![150%卡片](screenshots/dock-card-scale-150.png)
仅支持 Windows,依赖 ZTools 运行。可在一个选定显示屏的工作区四边停靠,副屏断开后回到主屏。

![钉住功能开关](screenshots/pin-setting.png)
菜单与入口的玻璃样式使用高光、渐变和内阴影呈现。导航条和弹窗支持上传背景图片(PNG、JPG、WebP,最大5MB),可更换、移除并调整不透明度;图片随配置备份保存。

![两入口自适应弹窗](screenshots/dock-adaptive-width.png)

![悬浮分类栏和入口卡片](screenshots/dock.png)

上图为隔离配置中的示例入口,展示自定义分类、图标与卡片布局,不表示内置截图、录屏等工具。

![重置外观与行为](screenshots/appearance.png)

![PNG和边缘距离设置](screenshots/trigger-art-settings.png)

![卡片整体缩放设置](screenshots/card-scale-settings.png)

![停靠方向和位置设置](screenshots/position-settings.png)

![左侧停靠](screenshots/dock-position-left.png)

![名称显示设置](screenshots/name-visibility-settings.png)

![仅显示图标](screenshots/names-hidden-top.png)

## 范围

仅支持 Windows,在一个选定显示屏的工作区四边停靠。副屏断开后回退主屏。依赖 ZTools 后台运行,可按宿主提供的“退出即结束”“跟随启动”选项设置。

不包含全屏自动避让、多屏同时停靠、应用参数或自定义脚本。管理员窗口、UAC 安全桌面及独占全屏场景未保证兼容。插件跳转使用唯一插件标题和指令,同名插件无法区分。

## 构建与验证

```sh
npm ci
npm test
npm run build
```

正式安装目录为 `dist/`。源码 manifest 位于 `public/plugin.json`。`npm run pack` 可生成根布局的安装 ZIP,并排除旧哈希资源和 Vite 内部清单。

0.1.14已通过43项单元、46项生产ZIP隔离宿主检查。另1项最终桌面合成像素检查因Windows锁屏暂不可执行,没有计为通过;原生Mica/Acrylic属性、四向背景窗组件边界和生命周期检查通过。5项0.1.13→0.1.14升级/恢复检查通过。宿主验证环境为ZTools3.3.0-beta.2安装版app.asar + 独立Electron41.4.0,不能等同日常EXE完整人工验收。文件粘贴匹配及原生选择框使用受控适配器,本地PNG解码、文件读写和程序启动执行真实API。

宿主回归需设置 `ZTOOLS_EXECUTABLE`,另用 `ZTOOLS_APP` 指向 app.asar(若适用),执行 `npm run test:host`。测试使用独占临时 profile,不修改日常用户配置。

MIT 许可。Vue 与 Lucide 的许可随构建产物提供。
暂不支持全屏自动避让、多屏同时停靠、启动参数和自定义脚本;管理员窗口、UAC 安全桌面及独占全屏场景未保证兼容。添加插件入口时,从已安装插件中选择名称和指令,自动带入图标。首次使用需勾选两项读取权限并在 ZTools 确认;“备份与帮助 → 插件授权”可管理读取和宿主授权。同名插件暂无法区分。
Loading
Loading