[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73870":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":16,"starSnapshotCount":16,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},73870,"ZTools","ZToolsCenter\u002FZTools","ZToolsCenter","一个高性能、可扩展的应用启动器和插件平台  uTools 的开源实现 | 支持 macOS 和 Windows","",null,"TypeScript",2857,240,9,91,0,42,113,486,126,109.15,"MIT License",false,"main",[],"2026-06-12 04:01:12","# ZTools\n\n\u003Cdiv align=\"center\">\n\n\u003Cimg src=\".\u002F.github\u002Fassets\u002Ficon.png\" alt=\"ZTools Logo\" width=\"120\">\n\n**一个高性能、可扩展的应用启动器和插件平台**\n\n_uTools 的开源实现 | 支持 macOS 和 Windows_\n\n[![GitHub release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Flzx8589561\u002FZTools)](https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002FZTools\u002Freleases)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Flzx8589561\u002FZTools)](.\u002FLICENSE)\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%20%7C%20Windows-blue)](https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002FZTools)\n\n[English](.\u002FREADME_EN.md) | 简体中文\n\n\u003C\u002Fdiv>\n\n---\n\n## ✨ 特性\n\n- 🚀 **快速启动** - 拼音搜索、正则匹配、历史记录、固定应用\n- 🧩 **插件系统** - 支持 UI 插件和无界面插件，完整的 API 支持\n- 📋 **剪贴板管理** - 历史记录、搜索、图片支持、跨平台原生实现\n- 🎨 **主题定制** - 系统\u002F亮色\u002F暗色模式，6 种主题色可选\n- ⚡ **高性能** - LMDB 数据库、WebContentsView 架构、极速响应\n- 🌍 **跨平台** - 原生支持 macOS 和 Windows，统一体验\n- 🔒 **数据隔离** - 插件数据独立存储，安全可靠\n- 🛠️ **开发友好** - 完整的 TypeScript 类型支持，热重载开发\n- ⚙️ **最新技术栈** - Electron 38.5 + Node 22.20 + Chrome 140\n\n## 📸 预览\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\".\u002F.github\u002Fassets\u002Fdemo.gif\" alt=\"ZTools 演示\" width=\"600\">\n  \u003Cp>\u003Ci>快速启动应用和搜索功能演示\u003C\u002Fi>\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n### 界面展示\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd width=\"50%\">\n        \u003Cimg src=\".\u002F.github\u002Fassets\u002Fmain-light.png\" alt=\"主界面 - 亮色主题\">\n        \u003Cp align=\"center\">\u003Ci>主界面 - 亮色主题\u003C\u002Fi>\u003C\u002Fp>\n      \u003C\u002Ftd>\n      \u003Ctd width=\"50%\">\n        \u003Cimg src=\".\u002F.github\u002Fassets\u002Fmain-dark.png\" alt=\"主界面 - 暗色主题\">\n        \u003Cp align=\"center\">\u003Ci>主界面 - 暗色主题\u003C\u002Fi>\u003C\u002Fp>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd width=\"50%\">\n        \u003Cimg src=\".\u002F.github\u002Fassets\u002Fsettings.png\" alt=\"设置界面\">\n        \u003Cp align=\"center\">\u003Ci>设置界面 - 主题定制和通用设置\u003C\u002Fi>\u003C\u002Fp>\n      \u003C\u002Ftd>\n      \u003Ctd width=\"50%\">\n        \u003Cimg src=\".\u002F.github\u002Fassets\u002Fplugin-market.png\" alt=\"插件市场\">\n        \u003Cp align=\"center\">\u003Ci>插件市场 - 在线安装和管理插件\u003C\u002Fi>\u003C\u002Fp>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n## 🚀 快速开始\n\n### 安装\n\n#### 方式 1：下载预编译版本（推荐）\n\n从 [Releases](https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002FZTools\u002Freleases) 页面下载最新版本：\n\n- **macOS**: `ztools-x.x.x.dmg` 或 `ZTools-x.x.x-arm64-mac.zip`\n- **Windows**: `ztools-x.x.x-setup.exe` 或 `ztools-x.x.x-win.zip`\n\n#### 方式 2：从源码构建\n\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002FZTools.git\ncd ZTools\n\n# 安装依赖\npnpm install\n\n# 开发模式\npnpm dev\n\n# 构建\npnpm build:mac    # macOS\npnpm build:win    # Windows\npnpm build:linux  # Linux (当前主机架构)\npnpm build:linux:x64 # Linux (按 amd64\u002Fx64 架构打包)\npnpm build:linux:arm64 # Linux (按 arm64 架构打包)\n```\n\n### 使用\n\n1. 启动应用后，使用快捷键 `Option+Z`（macOS）或 `Alt+Z`（Windows）唤起主界面\n2. 输入应用名称或命令进行搜索\n3. 按 `↑` `↓` `←` `→` 选择，`Enter` 确认，`Esc` 退出\n\n### 插件市场\n\nZTools 提供内置的插件市场，可以方便地浏览和安装插件：\n\n**主要功能**：\n\n- 📦 **在线安装** - 一键下载安装插件\n- 🔄 **插件升级** - 检测插件更新，一键升级到最新版本\n- 🔍 **插件详情** - 查看插件描述、版本、作者等详细信息\n- ✅ **已装管理** - 已安装插件可直接打开或升级\n\n**使用方法**：\n\n1. 打开 ZTools 设置（点击头像）\n2. 切换到\"插件市场\"标签\n3. 浏览并安装感兴趣的插件\n4. 已安装插件会显示\"打开\"或\"升级\"按钮\n\n**技术实现**：\n\n- 插件托管在 GitHub Releases（[ZTools-plugins](https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002FZTools-plugins\u002Freleases)）\n- 插件列表：从 `plugins.json` 文件获取插件信息和下载链接\n- 插件包格式：ZIP 压缩包，包含 `plugin.json` 和插件文件\n- 版本比较：自动对比本地版本和市场版本（语义化版本号）\n- 升级策略：先卸载旧版本，再安装新版本\n\n### 应用内更新\n\nZTools 支持应用内一键更新，无需手动下载安装包：\n\n**更新流程**：\n\n1. 应用自动检查更新（启动时或手动检查）\n2. 发现新版本时显示更新提示\n3. 点击更新按钮开始下载更新包\n4. 下载完成后自动安装并重启应用\n\n**技术实现**：\n\n- 更新源：GitHub Releases（[ZTools](https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002FZTools\u002Freleases)）\n- 更新信息文件：`latest.yml`（包含版本号、更新日志等）\n- 更新包格式：ZIP 压缩包，命名格式为 `update-{platform}-{arch}-{version}.zip`\n  - 示例：`update-darwin-arm64-1.2.8.zip`（macOS Apple Silicon）\n  - 示例：`update-win32-x64-1.2.8.zip`（Windows x64）\n- 更新程序：独立的 `ztools-updater` 可执行文件\n  - macOS: `ztools-updater`（位于 Contents\u002FMacOS\u002F）\n  - Windows: `ztools-agent.exe`（位于应用根目录）\n- 更新流程：\n  1. 从 GitHub Releases 下载 `latest.yml` 获取最新版本信息\n  2. 下载对应平台的更新包\n  3. 解压并启动独立的 updater 程序\n  4. 应用退出\n  5. updater 替换 `app.asar` 文件\n  6. 自动重启应用\n\n**平台支持**：\n\n- ✅ macOS (Apple Silicon)\n- ✅ Windows (x64)\n\n## 🧩 插件开发\n\nZTools 是一个强大、可扩展的插件平台，使用自定义插件提升您的生产力。通过简单的配置、丰富的 API 以及跨平台支持，您可以轻松开发出功能强大的插件。\n\n**插件系统特点**：\n\n- 📝 **简单配置** - 通过标准的 `plugin.json` 文件轻松定义插件，无需复杂的设置\n- 🔌 **丰富的 API** - 通过全局 `ztools` 对象访问系统能力，包括通知、模拟输入和持久化存储\n- 🎯 **灵活的指令** - 使用文本、正则或全局钩子触发您的插件，以适应任何工作流\n- 🌍 **跨平台** - 一次构建，在 Windows、macOS 和 Linux 上运行，在所有设备上获得一致的体验\n\n> 📖 **完整文档**：查看 [ZTools 开发者文档](https:\u002F\u002Fztoolscenter.github.io\u002FZTools-doc\u002F) 了解更多详情\n\nZTools 提供完整的插件系统，支持两种类型：\n\n### UI 插件\n\n```json\n\u002F\u002F plugin.json\n{\n  \"name\": \"my-plugin\",\n  \"version\": \"1.0.0\",\n  \"description\": \"我的插件\",\n  \"main\": \"index.html\",\n  \"logo\": \"logo.png\",\n  \"features\": [\n    {\n      \"code\": \"search\",\n      \"explain\": \"搜索功能\",\n      \"cmds\": [\"搜索\"]\n    }\n  ]\n}\n```\n\n### 无界面插件\n\n无界面插件适合后台任务、数据处理等不需要 UI 的场景。\n\n```json\n\u002F\u002F plugin.json（注意：没有 main 字段）\n{\n  \"name\": \"my-headless-plugin\",\n  \"version\": \"1.0.0\",\n  \"description\": \"后台处理插件\",\n  \"logo\": \"logo.png\",\n  \"features\": [\n    {\n      \"code\": \"process\",\n      \"explain\": \"后台处理\",\n      \"cmds\": [\"处理\"]\n    }\n  ]\n}\n```\n\n```javascript\n\u002F\u002F preload.js\nwindow.exports = {\n  process: {\n    mode: 'none', \u002F\u002F 无界面插件标识\n    args: {\n      enter: async (action) => {\n        \u002F\u002F 处理逻辑\n        window.ztools.showNotification('执行完成')\n        return { success: true }\n      }\n    }\n  }\n}\n```\n\n### 插件 API\n\nZTools 提供丰富的 API：\n\n- **数据库 API** - 持久化数据存储\n- **剪贴板 API** - 访问和监听剪贴板\n- **UI API** - 控制窗口和界面\n- **对话框 API** - 显示对话框和文件选择器\n- **Shell API** - 执行命令行命令\n- **窗口管理 API** - 创建独立窗口\n\n详细文档请查看 [CLAUDE.md](.\u002FCLAUDE.md)\n\n## 🛠️ 技术栈\n\n- **框架**: Electron 38 + Vue 3 + TypeScript\n- **构建**: Vite + electron-vite\n- **数据库**: LMDB（高性能键值存储）\n- **状态管理**: Pinia\n- **搜索引擎**: Fuse.js（拼音支持）\n- **原生模块**: C++ (Node-API)\n  - 剪贴板监听\n  - 窗口管理\n  - 区域截图（Windows）\n\n## 📁 项目结构\n\n```\nztools\u002F\n├── src\u002F\n│   ├── main\u002F              # 主进程\n│   │   ├── api\u002F          # IPC API 模块\n│   │   ├── core\u002F         # 核心功能（数据库、原生模块）\n│   │   ├── windowManager.ts\n│   │   └── pluginManager.ts\n│   ├── preload\u002F          # Preload 脚本\n│   └── renderer\u002F         # 渲染进程（Vue）\n│       ├── components\u002F\n│       ├── stores\u002F       # Pinia 状态管理\n│       └── App.vue\n├── resources\u002F            # 资源文件\n│   ├── lib\u002F             # 原生模块（.node）\n│   └── preload.js       # 插件 Preload\n└── CLAUDE.md            # 完整技术文档\n```\n\n## 📚 文档\n\n- [CLAUDE.md](.\u002FCLAUDE.md) - 完整技术文档和架构说明\n- [开发命令](#开发命令) - 常用命令说明\n- [插件开发](#插件开发) - 插件开发指南\n\n## 💻 开发\n\n### 环境要求\n\n- Node.js >= 18\n- npm >= 9\n- macOS 或 Windows 开发环境\n\n### 代码拉取\n\n1. 先 fork 仓库\n\n- 如果需要贡献代码请 fork [ztools-api-types](https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002Fztools-api-types) 和 [ztools-plugin-cli](https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002Fztools-plugin-cli) 仓库\n\n2. 拉取完整代码\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002FZTools.git --recurse-submodules\n```\n\n### 开发命令\n\n```bash\n# 安装依赖\npnpm install\n\n# 开发模式（热重载）\npnpm dev\n\n# 类型检查\npnpm typecheck          # 全部\npnpm typecheck:node     # 主进程 + preload\npnpm typecheck:web      # 渲染进程\n\n# 代码格式化\npnpm format             # Prettier 格式化\npnpm lint               # ESLint 检查\n\n# 构建\npnpm build              # 仅编译源码\npnpm build:mac          # 打包 macOS 应用\npnpm build:win          # 打包 Windows 应用\npnpm build:linux        # 打包 Linux 应用 (当前主机架构)\npnpm build:linux:x64    # 打包 Linux 应用 (amd64\u002Fx64)\npnpm build:linux:arm64  # 打包 Linux 应用 (arm64)\npnpm build:unpack       # 打包但不生成安装包（调试用）\n```\n\n### 调试\n\n- 主进程：在 VS Code 中按 F5，或使用 `pnpm dev` 查看终端日志\n- 渲染进程：在应用中按 `Cmd+Option+I`（macOS）或 `Ctrl+Shift+I`（Windows）打开开发者工具\n- 插件：在插件页面点击\"打开开发者工具\"按钮\n\n## 🗺️ 路线图\n\n### 已完成 ✅\n\n- [x] 应用快速启动和搜索\n- [x] 插件系统（UI + 无界面）\n- [x] 剪贴板历史管理\n- [x] 跨平台支持（macOS + Windows）\n- [x] LMDB 数据库迁移\n- [x] 主题定制\n- [x] 数据隔离\n- [x] 插件市场\n- [x] 全局快捷键自定义\n- [x] 插件分离为独立窗口\n- [ ] 插件自动更新\n- [ ] 云同步（可选）\n- [ ] Linux 支持\n- [ ] MCP工具集\n\n## 🐛 问题反馈\n\n遇到问题？请在 [Issues](https:\u002F\u002Fgithub.com\u002FZToolsCenter\u002FZTools\u002Fissues) 中反馈。\n\n提交 Issue 时请包含：\n\n- 操作系统版本\n- ZTools 版本\n- 复现步骤\n- 错误日志（如有）\n\n## 📄 许可证\n\n本项目采用 [MIT License](.\u002FLICENSE) 许可证。\n\n## 💖 赞助支持\n\n如果 ZTools 对你有帮助，欢迎通过爱发电赞助支持项目的持续开发：\n\n\u003Ca href=\"https:\u002F\u002Fafdian.com\u002Fa\u002FZTools\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F爱发电-赞助支持-946ce6?style=for-the-badge\" alt=\"爱发电\">\n\u003C\u002Fa>\n\n## 💝 致谢\n\n- [uTools](https:\u002F\u002Fu.tools\u002F) - 灵感来源\n- [Electron](https:\u002F\u002Fwww.electronjs.org\u002F) - 跨平台桌面应用框架\n- [Vue.js](https:\u002F\u002Fvuejs.org\u002F) - 渐进式 JavaScript 框架\n- [LMDB](http:\u002F\u002Fwww.lmdb.tech\u002F) - 高性能嵌入式数据库\n\n## ⭐ Star 历史\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=lzx8589561\u002FZTools&type=Date)](https:\u002F\u002Fstar-history.com\u002F#lzx8589561\u002FZTools&Date)\n\n---\n\n\u003Cdiv align=\"center\">\n\n**如果这个项目对你有帮助，请给个 Star ⭐️**\n\nMade with ❤️ by [lzx8589561](https:\u002F\u002Fgithub.com\u002Flzx8589561)\n\n\u003C\u002Fdiv>\n","ZTools 是一个高性能、可扩展的应用启动器和插件平台，支持 macOS 和 Windows。其核心功能包括快速启动应用、强大的插件系统、剪贴板管理以及主题定制等。技术上，ZTools 采用 Electron 38.5 + Node 22.20 + Chrome 140 的最新技术栈，并使用 LMDB 数据库确保极速响应。此外，它还提供了完整的 TypeScript 类型支持和热重载开发环境，方便开发者进行插件开发。适用于需要高效管理和启动应用的个人用户或开发者，特别适合那些希望在不同平台上拥有统一操作体验的用户。",2,"2026-06-11 03:47:44","high_star"]