PromptHub Logo # PromptHub 本地优先的 Prompt、Skill 与 AI 编程资产工作台。
[![GitHub Star 数量](https://img.shields.io/github/stars/legeling/PromptHub?style=for-the-badge&logo=github&color=yellow)](https://github.com/legeling/PromptHub/stargazers) [![下载量](https://img.shields.io/github/downloads/legeling/PromptHub/total?style=for-the-badge&logo=github&color=blue)](https://github.com/legeling/PromptHub/releases) [![版本](https://img.shields.io/badge/release-v0.6.2_stable-22C55E?style=for-the-badge)](https://github.com/legeling/PromptHub/releases/latest) [![许可证](https://img.shields.io/badge/license-AGPL--3.0-blue?style=for-the-badge)](./LICENSE) [![开发版本](https://img.shields.io/badge/development-main-8B5CF6?style=for-the-badge)](./CHANGELOG.md#unreleased) 最新稳定版为 `0.6.2`，已于 2026-10-27 发布。
![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white) ![Electron](https://img.shields.io/badge/Electron-47848F?style=flat-square&logo=electron&logoColor=white) ![React](https://img.shields.io/badge/React-61DAFB?style=flat-square&logo=react&logoColor=black) ![TailwindCSS](https://img.shields.io/badge/Tailwind-38B2AC?style=flat-square&logo=tailwind-css&logoColor=white) ![SQLite](https://img.shields.io/badge/SQLite-003B57?style=flat-square&logo=sqlite&logoColor=white)
![macOS](https://img.shields.io/badge/macOS-000000?style=flat-square&logo=apple&logoColor=white) ![Windows](https://img.shields.io/badge/Windows-0078D6?style=flat-square&logo=windows&logoColor=white) ![Linux](https://img.shields.io/badge/Linux-FCC624?style=flat-square&logo=linux&logoColor=black)
[简体中文](./README.md) · [繁體中文](./docs/README.zh-TW.md) · [English](./docs/README.en.md) · [日本語](./docs/README.ja.md) · [Deutsch](./docs/README.de.md) · [Español](./docs/README.es.md) · [Français](./docs/README.fr.md)
Download

PromptHub 把你的 Prompt、SKILL.md 和项目级 AI 编程资产放进一个本地工作区。它能把同一份 Skill 一键安装到 Claude Code、Cursor、Codex、Windsurf、Antigravity、Cline 等十几个工具，给 Prompt 做版本管理与多模型测试，并通过 WebDAV 同步到其他设备，或把完整快照备份到自部署 Web。 数据默认存在你自己的电脑上。 --- ## 目录 - [桌面版下载](#install) - [截图](#screenshots) - [核心能力](#features) - [快速上手](#quick-start) - [自部署网页版](#self-hosted-web) - [命令行 CLI](#cli) - [更新日志](#changelog) - [路线图](#roadmap) - [从源码运行](#dev) - [仓库结构](#project-structure) - [贡献与文档](#contributing) - [许可证 / 致谢 / 社区](#meta) --- **模型服务合作伙伴** | APIMart | infistar.cc | | :---: | :---: | | APIMart 专注 AI 图片与视频生成的低价 API 平台 | Infistar.cc 一站式全球大模型 API 服务平台 |
查看合作伙伴介绍 **感谢 APIMart 赞助了本项目！** APIMart 是专注 AI 图片/视频生成的低价 API 平台，GPT-Image-2 低至 **$0.006/张**，**1 美元可出图 160+ 张**。 图片、视频一套异步 API 通吃，提交任务拿 ID、回调取结果，跑批万张不超时、换模型不改代码。 按量付费、无月费，通过此 [注册链接](https://go.apimart.ai/gh-prompthub) 注册即可开用。 --- **PromptHub × infistar.cc 无限星河｜全模型 API · 高效管理与测试 AI 资产** 感谢 Infistar.ai 无限星河 赞助并为 PromptHub 提供模型服务支持！ ⚡ 稳定支持多模型测试：提供企业级高并发通道与多节点冗余，价格低至官方渠道 1 折，满足 Prompt 测试、AI生成、翻译润色及多模型并行对比等场景。 🧠 一个 API Key 接入主流模型：全面支持 ChatGPT、Claude、Gemini、Kimi、GLM、DeepSeek 等模型，兼容 OpenAI 标准接口，可在 PromptHub 中快速完成Provider与模型配置。 🛠️ 赋能Prompt与Skill工作流：适用于Prompt优化、Skill生成、图片Prompt反推及不同模型效果对比，帮助用户更高效地管理和复用AI编程资产。 🎁 PromptHub用户专属福利：通过 [专属推广链接](https://infistar.cc/register?aff=RX9CVLVQ&ref_source=link) 注册并完成首次调用，即可领取 [5美元等值测试额度 / 首充专属优惠]！
---
## 📥 桌面版下载 最新稳定版 **v0.6.2** 已发布。直链下载指向 GitHub Latest 稳定版资产；镜像同步完成后会切回固定文件名 CDN 直链： 升级前可创建全量备份；自部署 Web 服务器也请升级至 `0.6.2`。 - **直链下载** — 指向 GitHub 最新稳定版资产，避免 CDN 镜像未就绪时出现 404；镜像同步完成后会切回固定文件名 CDN 直链 - **GitHub Releases** — 官方发布页，可下载历史版本、查看签名与完整 Release Notes。 | 平台 | 直链下载 | GitHub Releases | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Windows | [![Windows x64](https://img.shields.io/badge/Windows_x64-0078D6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-Setup-0.6.2-x64.exe) [![Windows arm64](https://img.shields.io/badge/Windows_arm64-0078D6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-Setup-0.6.2-arm64.exe) | [![Windows x64](https://img.shields.io/badge/Windows_x64-0078D6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-Setup-0.6.2-x64.exe) [![Windows arm64](https://img.shields.io/badge/Windows_arm64-0078D6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-Setup-0.6.2-arm64.exe) | | macOS | [![macOS Apple Silicon](https://img.shields.io/badge/macOS_Apple_Silicon-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-0.6.2-arm64.dmg) [![macOS Intel](https://img.shields.io/badge/macOS_Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-0.6.2-x64.dmg) | [![macOS Apple Silicon](https://img.shields.io/badge/macOS_Apple_Silicon-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-0.6.2-arm64.dmg) [![macOS Intel](https://img.shields.io/badge/macOS_Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-0.6.2-x64.dmg) | | Linux | [![Linux AppImage](https://img.shields.io/badge/Linux_AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-0.6.2-x64.AppImage) [![Linux deb](https://img.shields.io/badge/Linux_deb-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-0.6.2-amd64.deb) | [![Linux AppImage](https://img.shields.io/badge/Linux_AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-0.6.2-x64.AppImage) [![Linux deb](https://img.shields.io/badge/Linux_deb-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/legeling/PromptHub/releases/latest/download/PromptHub-0.6.2-amd64.deb) | > **macOS 选哪个？** Apple Silicon（M1/M2/M3/M4）选 `arm64`，Intel Mac 选 `x64`。 > **Windows 选哪个？** 绝大多数选 `x64`，只有 Surface Pro X 这类 ARM 设备选 `arm64`。 ### macOS 通过 Homebrew ```bash brew tap legeling/tap brew install --cask prompthub ``` 后续升级请用 `brew upgrade --cask prompthub`，**不要**和应用内自动更新混用，否则可能出现 Homebrew 记录的版本和实际安装不一致。 ### macOS 安全验证 macOS 安装包会使用 Developer ID 签名并完成 Apple 公证。请优先从 GitHub Release、官网镜像或 Homebrew 安装；如果系统仍提示无法验证，请重新下载当前 Release 的 DMG 后再安装。 `0.5.9` 早期预览包和更早的历史包可能尚未完成签名公证。如果你明确下载的是这些历史版本，并且 macOS 提示「已损坏」或「无法验证开发者」，可以在终端执行： ```bash sudo xattr -rd com.apple.quarantine /Applications/PromptHub.app ``` 然后重新打开应用。如果应用安装在其他位置，把路径替换成实际安装路径。
macOS 安装提示
### 预览通道 如果你想体验下一版的开发预览版，可以在「设置 → 关于」打开「预览版通道」。应用会同时检查正式版与预览版，按版本号提供最新更新；例如 `0.6.0-beta.2` 可以升级到 `0.6.0`。关闭后只接收正式版，应用不会自动降级。已安装的旧预览构建若未检测到 `0.6.0`，请关闭预览通道后重新检查更新。
## 截图 > 以下为 0.5.9 的历史界面截图，展示 Prompt、Skill、MCP、Plugin 和 Rules 工作区；0.6.0 界面已有更新。

主界面（双栏首页）

主界面

Skill 商店

Skill 商店

Skill 详情与一键安装到平台

Skill 平台安装

MCP 工作区

MCP 工作区

Plugin 工作区

Plugin 工作区

Rules 工作区

Rules 工作区

项目级 Skill 工作区

项目级 Skill 工作区

Quick Add 多入口（手动 / 分析 / AI 生成）

Quick Add

外观与动画偏好

外观设置
## 核心能力 ### 📝 Prompt 管理 - 文件夹、标签、收藏三层组织，可拖拽排序，CRUD 全覆盖 - 模板变量 `{{variable}}`，复制 / 测试 / 分发时弹表单填值 - 全文搜索（FTS5），Markdown 渲染与代码高亮，附件 / 多媒体预览 - 桌面卡片支持双击进入 inline 编辑用户 Prompt 和 System Prompt ### 🧩 Skill 商店与一键分发 - **技能商店**：内置 20+ 精选技能（来自 Anthropic、OpenAI 等），可叠加自定义商店源（GitHub / skills.sh / 本地目录） - **一键安装到平台**：Claude Code、Cursor、Windsurf、Codex、Antigravity、Kiro、Kilo Code、Cline、Qoder、QoderWork、CodeBuddy、Trae、Trae CN、OpenCode 等 15+ 平台；Gemini 仅保留企业与付费 API 兼容目标 - **本地扫描**：自动发现本地已有 SKILL.md，预览选择后导入，避免在多个工具目录间复制粘贴 - **Symlink / Copy 双模式**：选 symlink 共享编辑，选 copy 各平台保留独立副本 - **平台目标目录可覆写**：为每个平台单独配置 Skills 目录，扫描和分发保持一致 - **AI 翻译与润色**：以完整 SKILL.md 为单位生成 sidecar 译文，支持沉浸式对照和全文翻译 - **安全策略**：安装/更新前的内容与 AI 扫描可按全局、来源渠道和具体商店精细开关；关闭扫描仍强制执行路径、压缩包、符号链接、体积、必需文件和指纹校验 - **GitHub Token**：商店与仓库导入支持鉴权，减少匿名限流失败 - **标签筛选**：按标签快速过滤已安装与商店技能 ### 📐 Rules（AI 编程规则） - 集中管理 `.cursor/rules`、`.claude/CLAUDE.md`、AGENTS.md 等规则文件 - 支持手动添加项目级 Rules，按目录分组浏览 - 与 ZIP 导出、WebDAV、自托管备份恢复、Web 导入导出全链路打通 ### 🤖 项目与 Agent 资产工作区 - 扫描项目里的 `.claude/skills`、`.agents/skills`、`skills`、`.gemini` 等常见目录 - 为单个项目建立独立 Skill 工作区，不污染全局库 - 个人库、本地仓库、项目资产同一界面切换，不用在多个工具目录之间跳来跳去 - 全局 Prompt 标签管理：集中搜索、重命名、合并、删除标签，数据库与工作区文件一并同步 ### 🧪 AI 测试与生成 - 内置 AI 测试，主流国内外服务商都能配（OpenAI、Anthropic、Gemini、Azure、自定义 endpoint 等） - 同一 Prompt 多模型并行对比，文本和图像模型都支持 - AI 生成技能、AI 润色技能、Quick Add AI 直接生成结构化 Prompt 草稿 - 统一的端点管理与连接测试，错误信息精确到 504 / 超时 / 未配置 ### 🕒 版本控制与历史 - 每次保存 Prompt 自动写入历史版本，支持版本对比、差异高亮、一键回滚 - Skill 同样维护版本历史，可创建命名版本、查看差异、按版本回滚 - Rules 历史快照可预览、恢复到草稿 - 商店 Skill 安装时记录内容哈希，远端 SKILL.md 变更可检测，本地修改有冲突保护 ### 💾 数据、同步与备份 - 本地优先：所有数据默认存在你自己的电脑上 - 全量备份 / 恢复使用 `.phub.gz` 压缩格式 - WebDAV 同步（坚果云、Nextcloud 等） - WebDAV / S3 在线同步只允许一个活动同步源，避免多源冲突写入 - 自部署 PromptHub Web 独立保存不可变快照；启动和定时任务只上传，绝不会自动拉取或覆盖本地数据 - 桌面版与 Web 版必须完全同版本才会备份；恢复由用户显式触发，并先创建本地安全快照 ### 🔐 隐私与安全 - 主密码用于解锁应用内的私密内容 - 私密文件夹只提供应用内隐藏，本地文件不加密 - 跨平台离线运行：macOS / Windows / Linux - 7 种界面语言：简体中文、繁體中文、English、日本語、Deutsch、Español、Français
## 快速上手 1. **新建第一个 Prompt** 点「+ 新建」，写标题、描述、System Prompt 和 User Prompt。`{{变量名}}` 会变成一个变量，复制或测试时会弹表单让你填。 2. **把 Skills 纳入工作区** 去「Skills」标签，从商店选几个，或点「扫描本地」让 PromptHub 自动找你电脑上已有的 SKILL.md。 3. **一键安装到 AI 工具** 在 Skill 详情页选目标平台。PromptHub 会按平台规范把 SKILL.md 安装到对应目录。可以选 symlink（同步编辑）或独立复制。 4. **配置同步或备份（可选）** 「设置 → 数据」里配 WebDAV / S3 在线同步，或自部署一份 PromptHub Web 保存独立恢复快照。
## 自部署网页版 PromptHub Web 是一个轻量的浏览器版工作区，你可以用 Docker 把它跑在 NAS、VPS 或局域网里。它**不是**官方云服务，主要用途是： - 在浏览器里访问自己的 PromptHub 数据 - 给桌面版保存不改变在线工作区的不可变备份快照 - 不想让数据出本地局域网 ```bash cd apps/web cp .env.example .env docker compose up -d --build ``` `.env` 里有几个必须改的： - `JWT_SECRET`：≥ 32 位随机字符串 - `ALLOW_REGISTRATION=false`：建议保持关闭，第一个用户初始化完之后就不要再开公开注册 - `DATA_ROOT`：数据根目录，会在下面创建 `data/`、`config/`、`logs/`、`backups/` 默认在 `http://localhost:3871`。第一次打开会跳到 `/setup`，你创建的第一个用户就是管理员。 桌面版接入这一份 Web：「设置 → 数据 → Self-Hosted PromptHub」，填 URL、用户名、密码。可以测试版本与备份能力、创建远端快照、显式恢复最近快照，以及启用只上传的启动/定时自动备份。自动任务不会拉取、合并或覆盖本地数据。 ### Cloudflare Workers 版（分支实验） 如果你希望把在线自部署版跑在 Cloudflare 边缘网络上，可以使用本分支的 `apps/web-cloudflare`。它把 API 运行在 Workers，账号和旧同步快照元数据存到 D1，图片 / 视频媒体存到 R2。当前该分支仍实现旧 live-sync API；新版桌面端的备份专用 `/api/backups/desktop` 路由补齐前，不会把它当作安全自部署备份端点。
PromptHub Cloudflare Workers 登录页

Cloudflare Workers 在线自部署登录页

当前 Cloudflare 版优先覆盖数据同步、Prompt / Folder / Rules / Skills 数据展示与媒体同步。安装到 Claude / Codex 本地目录、扫描本机技能仓库这类本地文件系统能力仍由桌面端负责。 更详细的 Docker / NAS / VPS 自部署说明在 [`docs/web-self-hosted.md`](./docs/web-self-hosted.md)，Cloudflare Workers + D1 + R2 部署说明在 [`docs/cloudflare-workers.md`](./docs/cloudflare-workers.md)。 0.6.2：Desktop 与 CLI 共用 Skill、MCP、Plugin 的 Core 管理流程。自托管 Web 与 Cloudflare 提供三类资源的保存、编辑、版本、完整包导入导出及同步；不提供 Agent 分发、服务器目录扫描或 SSH 安装。CLI 单独打包安装。
## 命令行 CLI CLI 适合脚本化管理、批量导入导出、自动化扫描。当前桌面版**不会**自动安装 `prompthub` 命令，需要你从仓库自己打包再装： ```bash pnpm pack:cli pnpm add -g ./apps/cli/prompthub-cli-*.tgz prompthub --help ``` 也可以不安装直接跑： ```bash pnpm --filter @prompthub/cli run dev prompt list pnpm --filter @prompthub/cli run dev skill scan ``` 支持的资源命令一览（每个命令都有 `--help`）： ```text prompt list / get / create / update / delete / duplicate / search versions / create-version / delete-version / diff / rollback use / copy list-tags / rename-tag / delete-tag relation list|create|update|delete output-format list|create|delete|reorder （create/update 支持 --parent-id 树父节点） folder list / get / create / update / delete / reorder agent list / get / enable / disable add / update / configure / reset / delete config list|read（只读检查并脱敏敏感值） identity get|set rules list / scan / read / save / rewrite versions / version-read / version-restore / version-delete add-project / remove-project export / import skill list / get / import（兼容别名：install）/ delete / remove versions / create-version / rollback / delete-version export / scan / scan-safety / sync-from-repo update / check-update platforms / platform-status / distribute / redistribute / undistribute （兼容别名：install-md / uninstall-md） project-install / install-project repo-files / repo-read / repo-write / repo-delete / repo-mkdir / repo-rename mcp list / get / create / update / delete market / sources / install / import enable / disable / check / env-import export / apply / remove plugin list / get / market / sources / install / import / delete metadata / check / check-update / update / import-child-mcp targets / status / distribute / redistribute / undistribute versions / create-version / rollback / delete-version ai providers / provider-add / provider-delete models / model-add / model-delete routes / route-set / route-clear workspace export / import （完整 SyncSnapshot：prompts、relations、output-formats、 skills + skillFiles、MCP、plugins、rules、媒体） sync status / push / pull doctor database-lock [--recover] ``` Skill 导入、版本快照和分发统一应用内置忽略规则与根目录 `.prompthubignore`，并在写入前阻止疑似私钥、访问令牌和密码。默认成功输出是有界摘要；只有明确使用 `--full` 才返回 Skill 正文与完整文件快照。 常用全局参数： - `--output json|table` — 输出格式 - `--summary` — 返回有界摘要（默认） - `--full` — 返回完整资源内容 - `--quiet` — 成功时不输出 stdout，错误仍输出 stderr - `--data-dir ` — 显式指定 PromptHub 的 `userData` 目录 - `--app-data-dir ` — 显式指定应用数据根目录 - `--version|-v` — 打印 CLI 版本
## 更新日志 完整版本说明：**[CHANGELOG.md](./CHANGELOG.md)** ### v0.6.2 (2026-10-27, 正式版) 新增工作区手动刷新与草稿保护、标签排序；统一全量备份和远程恢复，修复 CLI 检测与 Agent 模型服务配置，并区分 Antigravity 桌面应用与 CLI。 ### v0.6.1 (2026-10-21, 正式版) 新增 Plugin 市场来源、原生 Codex 插件管理和跨端资源管理，改进安装反馈、更新窗口与 Skill 文件刷新；修复旧设置凭据迁移启动问题，并提供可复制的启动错误日志。 ### v0.6.0 (2026-10-18, 正式版) `0.6.0` 已于 2026-10-18 正式发布，提供 Windows、macOS、Linux 安装包和独立 CLI。 - **存储、同步与升级**：SQLite 统一管理结构化记录，完整包与历史文件保持可恢复；WebDAV/S3 自动同步增加共同基线与冲突审阅，并修复旧数据启动迁移。 - 右键快捷标签、批量标签，以及标签使用次数、排序和筛选跳转 - 表格、卡片、画廊的批量收藏、移动、删除和标签操作；启动文件夹恢复与 Ctrl+F / Cmd+F 搜索 - 来源与备注折叠、参考媒体入口前移、空结果清除筛选，以及本地化安全错误提示 - 多词 AND 全文搜索、顶栏新建根节点、移动子树的文件夹一致性与选择驱动的树展开 - 全局拖入备份预览、备份迁移指引，以及保留权限校验的 Web 文件夹可见性推导 ### v0.6.0-beta.2（2026-09-03，预览版） - 生图工作台新增整图编辑、生成结果继续创作、GPT Image 编辑和不遮挡画布的详情面板 - Git 缺失时，公开 GitHub、GitLab.com 和兼容 Gitea Skill 可回退到安全的 HTTPS 归档下载 - Rules 恢复保留外部编辑与可恢复历史；升级安全点、备份保留和混合 Prompt 布局恢复更稳健 - 更新器新增自动/官方/镜像来源切换、发布说明与传输指标，并同步 macOS 托盘更新状态 - 新增 Doubao Work Skill 目标，修复关闭选择持久化和 OpenCode 全局会话发现 - 此预览版发布时的稳定版为 `v0.5.9` ### v0.6.0-beta.1（2026-08-20，替换预览版） - 统一 Agent 工作台集中管理 Skills、MCP、Plugins、Rules、供应商/模型、配置文件、额度和历史会话 - 文件优先 canonical 数据权威、恢复候选、自愈和 Windows `0.5.9` 升级双启动门禁共同保护预览用户数据 - 有界 SQLite 临时库路径修复覆盖安装后第二次启动失败；本次在相同 beta tag 原位替换受影响的预览包 - 已安装旧 `v0.6.0-beta.1` 的用户需要手动下载并覆盖安装修复包，同版本替换不会触发自动更新 - 此预览版发布时的稳定版为 `v0.5.9` ### v0.5.9（2026-07-09，正式版） - Plugin 管理正式收口：My Plugins / Plugin Store / Agent Plugin 对齐 Skill 风格，支持安装、详情、版本快照、来源更新确认、批量操作、Agent 分发和子 Skill / MCP 导入 - MCP 管理与同步能力扩展：MCP 工作台、官方模板商店、Agent 目标分发、健康检查、.env 按需导入、CLI MCP 命令和一键重同步设计完成阶段性收口 - 整套 Agent 资产备份：自托管备份恢复纳入 My Skills、My MCP、My Plugins 和 Rules 等数据 - Skill 来源更新改为 SHA-256 包指纹和三方对账，并修复 registry 指纹、content-url 基线和 URL 脱敏问题 - Plugin 来源更新和批量商店更新现在先展示差异并要求确认，不再点击后直接覆盖本地 Plugin - Prompt 支持组合、排序和持久化自定义输出格式序列，并随备份恢复 - macOS 发布链路加强 Developer ID 签名、公证、DMG/ZIP 校验和 Gatekeeper 验证 ### v0.5.9-beta.1（2026-06-14，预览版） - MCP 管理工作台预览版：新增本地 MCP 库、官方模板商店、Agent 目标分发、健康检查、按需导入 .env 和 CLI MCP 命令 - Prompt 关系树与语义关系：现有列表和表格支持拖拽成父子结构、展开/折叠、父级标签、子项计数和详情页关系导航 - Git 仓库 Skill 导入修复：SSH GitHub 扫描走本地 clone，地址变更可重新扫描，HTTPS 限流会提示改用 SSH - Skill 图片资源预览支持滚轮缩放、抓手拖拽、右下角固定缩放控件和全屏预览 - Skill 版本展示从 v1 开始，详情标题点击即可复制 Skill 名称 ### v0.5.8（2026-06-04） - 图片 Prompt 反推新增独立入口，支持视觉模型生成结构化生图 Prompt，先预览/复制再决定是否保存 - AI 模型配置改为供应商优先的三栏体验，区分供应商、模型能力和业务路由 - ClawHub 与 skill.sh 商店接入远程搜索、分类、分页/滚动加载、缓存和完整 Skill 包安装 - Skill 生命周期矩阵继续加固，覆盖我的 Skill、项目 Skill、Agent Skill、平台安装、copy / symlink、内置 Skill 和外部软链接 - GitHub / Gitea / 自托管 Git 来源更新检查更准确，并忽略常见缓存文件以减少误报 - Skill 文件视图接入轻量代码编辑器，支持语法高亮、行号、自动换行和更准确的文件图标 ### v0.5.8-beta.3（2026-06-02，预览版） - Skill 文件视图接入轻量代码编辑器，支持语法高亮、行号、自动换行和更准确的文件图标 - GitHub 导入到“我的 Skill”的条目现在可以直接检查来源更新，并在更新前创建版本快照 - Cherry Studio、Agent Skill、项目 Skill、copy / symlink、内置 Skill 与外部软链接状态继续补强 - Prompt / Skill 版本历史弹窗改为更适合检索和对比的表格化呈现 ### v0.5.8-beta.2（2026-06-02，预览版） - Skill 生命周期操作继续补强，覆盖项目 Skill、Agent Skill 和平台 Skill 的安装、卸载、删除与软链接路径 - 项目详情页删除按钮改为默认红色 destructive 样式，降低误操作风险 - Skill 管理页和项目/Agent 内部切换统一使用横向过渡动画 - GitHub Actions 发布链路同步到 Node 24 ### v0.5.8-beta.1（2026-06-01，预览版） - 图片 Prompt 反推工作流新增独立入口，支持通过视觉模型反推结构化生图 Prompt，并可把原图作为参考图保存 - AI 模型服务重构为供应商优先的三栏配置体验，区分供应商实例、模型能力和业务路由 - 独立 CLI 的 `--version` 与 package 版本同步到 `0.5.8-beta.1` - 项目 Skill 结果区改为紧凑列表，次要动作收口为 icon-only ### v0.5.7（2026-05-29） - Prompt AI 快速编辑：详情页、详情弹窗和右键菜单统一接入 `AI 快速编辑`，支持先生成草稿再应用或继续编辑 - 同名 Skill variant 正式落地：允许同名但不同来源的 Skill 并存，并统一围绕 `source_id` 与托管容器结构收口 - 备份导入恢复链路加固，降低恢复后的状态漂移风险 - `scanRemoteGithub` 统一支持 HTTPS / SSH 的 GitHub、Gitea 和自托管 Git 仓库 - AI Workbench 的 `测试连接` 成功状态现可持久回显，切换回来不会掉回 `未验证` - Kilo Code 规则扫描补齐，避免新增平台遗漏全局规则文件 ### v0.5.7-beta.2（2026-05-28，预览版） - Git 商店源支持 `branch / directory` 配置、远程分支建议和 GitHub / SSH / 自部署 Git 仓库 - 项目 Skill 导入支持 `copy / symlink` 高级模式，并按项目记住导入偏好与目标目录 - Agent 管理与 Skill 平台安装内置接入 `Kilo Code`，移除 `Roo Code` ### v0.5.7-beta.1（2026-05-26，预览版） - 统一 built-in / custom agent 完整配置模型，Skill Settings 可直接覆写 `root / skills / rules / agents / commands / config` 路径 - 新增 `Cline`、`Trae CN` 内置平台预设，并让 Rules 工作区按 agent 配置和顺序即时刷新 - 支持把 Skill 直接部署到项目本地 agent 目录，默认 `.agents/skills`，并支持多目标选择 - 平台 symlink 安装回退到 copy 时会明确提示 warning，不再伪装成普通成功 - Prompt 详情双击编辑收口：双击哪块就编辑哪块，编辑态尽量保持原页面结构 ### v0.5.6（2026-05-12） **新功能** - 🧭 **Rules 集中管理工作台**：桌面端独立的 Rules 页面，统一管理全局规则和手动添加的项目规则，支持搜索、历史快照预览、恢复到草稿，并接入 ZIP 导出、WebDAV、自托管备份恢复和 Web 导入导出 - 📁 **项目级 Skill 工作区**：可以为本地项目建立独立 Skill 工作区，自动扫描常见目录，在项目上下文中预览、导入和分发 Skill - 🤖 **Quick Add 支持 AI 直接生成 Prompt**：除了分析已有 Prompt，Quick Add 现在也能根据目标和约束直接生成结构化 Prompt 草稿 - 🏷️ **全局 Prompt 标签管理**：侧栏标签区域新增统一入口，可集中搜索、重命名、合并和删除标签，同步更新数据库与工作区文件 - 🔐 **Skill 商店支持 GitHub Token**：减少匿名限流导致的商店和仓库导入失败 **修复** - ✍️ 卡片详情支持双击编辑用户提示词和系统提示词 - 🪟 修复检查更新弹窗闪烁、下载按钮不可稳定点击，以及开机自启时不能按 `minimizeOnLaunch` 最小化的问题 - ↔️ Skills 三栏列宽调节、双击重置、标题换行、商店搜索的一组易用性回归 - 🔁 Rules、Skill 附加文件和托管副本在 ZIP 导出、WebDAV、自托管备份恢复和 Web 导入导出链路中的一致性 - 🖼️ 自托管 Web 登录改用一次性图形验证码 **优化** - 🏠 双栏首页稳定支持模块显隐、拖拽排序，背景图独立开关 - ☁️ 桌面端只允许一个活动同步源驱动自动同步，避免多源同时写入冲突 - ✨ 引入完整的桌面端动画系统（duration / easing / scale tokens、`` `` `` `` 四个意图组件、三档用户偏好），并卸掉了仅在一个组件用过的 framer-motion，`ui-vendor` chunk gzip 从 54 KB 降到 16 KB - 🪶 桌面端长列表（Skill 列表 / Prompt 画廊 / 看板 / Prompt 详情列表）改为 `@tanstack/react-virtual` 虚拟化，去掉了之前手写的 setTimeout 分批渲染补丁
## 路线图 ### v0.6.2 ← 正式版 新增工作区手动刷新与草稿保护、标签排序；统一全量备份和远程恢复，修复 CLI 检测与 Agent 模型服务配置，并区分 Antigravity 桌面应用与 CLI。 ### v0.6.1 新增 Plugin 市场来源、原生 Codex 插件管理和跨端资源管理，改进安装反馈、更新窗口与 Skill 文件刷新；修复旧设置凭据迁移启动问题，并提供可复制的启动错误日志。 ### v0.5.9 - Plugin / MCP 管理对齐 Skill 体验，覆盖商店、Agent 分发、详情、标签筛选、更新确认和安全检查 - Agent 资产同步、网络代理、CLI 项目安装和 Skill 来源更新检查进入稳定版 - Prompt 关系树、Windows Agent 路径、Web 验证码开关、macOS 签名公证和发布链路修复随正式版提供给用户 ### v0.5.8 - 图片 Prompt 反推、AI 模型供应商/能力/路由配置和生图测试链路稳定落地 - Skill 生命周期矩阵收口，覆盖商店、Git、Agent、项目、平台、copy / symlink 和内置 Skill - ClawHub / skill.sh 商店、来源更新检查、代码视图、文件图标和版本历史体验补齐 ### v0.5.7 - Prompt AI 快速编辑、同名 Skill variant、远程 Git 扫描和 AI Workbench 验证状态加固 ### v0.5.6 详见上方更新日志。 ### v0.5.5 - 商店 Skill 安装时记录内容哈希，可检测远端 SKILL.md 是否更新并支持本地修改冲突保护 - Skill 整份文档 AI 翻译：围绕完整 SKILL.md 生成 sidecar 译文，支持全文翻译和沉浸式对照 - 数据目录切换通过 relaunch 真正生效 - AI 模型测试与翻译错误反馈更明确（504 / 超时 / 未配置都有具体提示） - Web/Docker 媒体上传修复，`local-image://` / `local-video://` 自动解析 - 预览通道更新链路加固 - Issue Form 自动同步 `version: x.y.z` 标签 ### v0.4.x - AI 工作台、模型管理、端点编辑、连接测试与场景默认模型 - skills.sh 社区商店接入，支持榜单、安装量、Star - skill-installer God Class 拆分、SSRF 防护、URL 协议校验 - 多平台 Skill 一键安装：Claude Code、Cursor、Windsurf、Codex、Cline 等十几个平台 - AI 翻译、AI 生成 Skill、本地批量扫描 ### 在做 / 在想 - [ ] 浏览器扩展：在 ChatGPT / Claude 网页里直接调用 PromptHub 库 - [ ] 移动端：手机查看、搜索、轻量编辑同步 - [ ] 插件机制：本地模型（Ollama 等）和自定义 AI 供应商 - [ ] Prompt 商店：复用社区验证过的提示词模板 - [ ] 更复杂的变量类型：选择框、动态日期等 - [ ] 用户上传分享自创 Skill
## 从源码运行 需要 Node.js ≥ 24、pnpm 9。 ```bash git clone https://github.com/legeling/PromptHub.git cd PromptHub pnpm install # 桌面端开发 pnpm electron:dev # 桌面端构建 pnpm build # 自部署 Web 构建 pnpm build:web ``` `pnpm build` 默认只构建桌面版。Web 需要显式 `pnpm build:web`。 常用开发命令： | 命令 | 用途 | | ------------------------------------------------ | ------------------------------------- | | `pnpm electron:dev` | 启动桌面端开发环境（vite + electron） | | `pnpm dev:web` | 启动 Web 开发环境 | | `pnpm lint` / `pnpm lint:web` | 代码风格检查 | | `pnpm typecheck` / `pnpm typecheck:web` | TypeScript 类型检查 | | `pnpm test -- --run` | 桌面端 vitest 单元 + 集成测试 | | `pnpm test:e2e` | Playwright e2e | | `pnpm verify:web` | Web lint + typecheck + test + build | | `pnpm test:release` | 桌面端发布前完整门禁 | | `pnpm --filter @prompthub/desktop bundle:budget` | 桌面端 bundle 体积预算检查 |
## 仓库结构 ```text PromptHub/ ├── apps/ │ ├── desktop/ # Electron 桌面端 │ ├── cli/ # 独立 CLI（基于 packages/core） │ └── web/ # 自部署 Web ├── packages/ │ ├── core/ # CLI 与桌面共享的核心逻辑 │ ├── db/ # 共享数据层（SQLite schema、查询） │ └── shared/ # 共享类型、IPC 常量、协议定义 ├── docs/ # 对外文档 ├── spec/ # 内部 SSD / 设计规范 ├── website/ # 官网相关资源 ├── README.md ├── CONTRIBUTING.md └── package.json ```
## 贡献与文档 - 入口：[CONTRIBUTING.md](./CONTRIBUTING.md) - 完整指南：[`docs/contributing.md`](./docs/contributing.md) - 对外文档索引：[`docs/README.md`](./docs/README.md) - 内部 SSD / spec：[`spec/README.md`](./spec/README.md) - 项目内置 spec skill：[`spec-init`](./.agents/skills/spec-init/SKILL.md) - `spec-init` 上游仓库：[`git@github.com:legeling/spec-init.git`](git@github.com:legeling/spec-init.git) - 文档拓扑路由：[`spec-init.topology.yml`](./spec-init.topology.yml) PromptHub 按风险维护文档：已有主题原位更新，独立新主题保留一份权威说明，跨会话工作按需增加一份计划。具体规则见 [文档规则](./spec/rules/document-routing-rules.md)，业务和历史资料从 [spec 入口](./spec/README.md) 定向查找。
## 许可证 [AGPL-3.0](./LICENSE) ## 反馈 - 问题：[GitHub Issues](https://github.com/legeling/PromptHub/issues) - 想法：[GitHub Discussions](https://github.com/legeling/PromptHub/discussions) ## 致谢 [Electron](https://www.electronjs.org/) · [React](https://react.dev/) · [TailwindCSS](https://tailwindcss.com/) · [Zustand](https://zustand-demo.pmnd.rs/) · [Lucide](https://lucide.dev/) · [@tanstack/react-virtual](https://tanstack.com/virtual) · [tailwindcss-animate](https://github.com/jamiebuilds/tailwindcss-animate) ## 贡献者 感谢所有为 PromptHub 做出贡献的开发者。 Contributors ## Star History Star History ## 社区 欢迎加入 PromptHub 社群，反馈问题、交流使用方式、讨论新功能、抢先体验预览版。
Join PromptHub Discord Community

推荐优先加入 Discord 社群，获取公告、交流支持与新版本动态


### QQ 交流群 如果你更习惯用 QQ，可以加入 PromptHub QQ 交流群： - 群号：`704298939`
PromptHub QQ 交流群二维码

扫码加入 PromptHub QQ 交流群

## 赞助支持 / Sponsor 如果 PromptHub 对你的工作有帮助，欢迎请作者喝杯咖啡。 If PromptHub is helpful to your work, feel free to buy the author a coffee.
WeChat Pay
微信支付 / WeChat Pay 		Alipay
支付宝 / Alipay 		Buy Me A Coffee
Buy Me A Coffee
联系邮箱：legeling567@gmail.com 历史赞助记录归档在 [`docs/sponsors.md`](./docs/sponsors.md)。 ---

如果 PromptHub 对你有帮助，请给个 ⭐ 支持一下。