# PromptHub **Repository Path**: baoge1983/PromptHub ## Basic Information - **Project Name**: PromptHub - **Description**: No description available - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-12 - **Last Updated**: 2026-05-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
PromptHub Logo # PromptHub 本地优先的 Prompt、Skill 与 AI 编程资产工作台。
[![GitHub Stars](https://img.shields.io/github/stars/legeling/PromptHub?style=for-the-badge&logo=github&color=yellow)](https://github.com/legeling/PromptHub/stargazers) [![Downloads](https://img.shields.io/github/downloads/legeling/PromptHub/total?style=for-the-badge&logo=github&color=blue)](https://github.com/legeling/PromptHub/releases) [![Version](https://img.shields.io/badge/release-v0.5.6-22C55E?style=for-the-badge)](https://github.com/legeling/PromptHub/releases/latest) [![License](https://img.shields.io/badge/license-AGPL--3.0-blue?style=for-the-badge)](./LICENSE)
![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、Gemini CLI 等十几个工具,给 Prompt 做版本管理与多模型测试,并通过 WebDAV 或自部署 Web 同步到其他设备。 数据默认存在你自己的电脑上。 --- ## 目录 - [桌面版下载](#install) - [截图](#screenshots) - [核心能力](#features) - [快速上手](#quick-start) - [自部署网页版](#self-hosted-web) - [命令行 CLI](#cli) - [更新日志](#changelog) - [路线图](#roadmap) - [从源码运行](#dev) - [仓库结构](#project-structure) - [贡献与文档](#contributing) - [许可证 / 致谢 / 社区](#meta) ---
## 📥 桌面版下载 最新稳定版 **v0.5.6**。每个平台都有两条下载链路: - **直链下载** — 文件名固定,链接不会随版本变化,适合做长期书签或脚本调用(**v0.5.7 起接入 CDN 镜像,本版本暂时回退到 GitHub Releases**) - **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.5.6-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.5.6-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.5.6-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.5.6-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.5.6-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.5.6-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.5.6-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.5.6-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.5.6-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.5.6-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.5.6-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.5.6-amd64.deb) | | 预览版 | [![Preview Prereleases](https://img.shields.io/badge/Preview_Prereleases-8B5CF6?style=for-the-badge&logo=github&logoColor=white)](https://github.com/legeling/PromptHub/releases?q=prerelease%3Atrue) | 在应用内「设置 → 关于」打开「预览版通道」开关后,自动检查并升级 | > **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 首次启动提示「已损坏」 应用没有 Apple 公证签名,第一次打开可能会弹「无法验证开发者」。打开终端执行: ```bash sudo xattr -rd com.apple.quarantine /Applications/PromptHub.app ``` 然后重新打开就行。如果应用安装在其他位置,把路径替换成实际安装路径。
macOS 安装提示
### 预览通道 如果你想体验下一版的开发预览版,可以在「设置 → 关于」打开「预览版通道」开关,应用会从 GitHub Prereleases 拉取构建。一旦关掉这个开关,更新会回到稳定版,并且不会从较新的预览版自动降级到较旧的稳定版。
## 截图 > 下面这几张展示了 0.5.6 的核心交互。

主界面(双栏首页)

主界面

Skill 商店

Skill 商店

Skill 详情与一键安装到平台

Skill 平台安装

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、Kiro、Gemini CLI、Qoder、QoderWork、CodeBuddy、Trae、OpenCode、Roo Code 等 15+ 平台 - **本地扫描**:自动发现本地已有 SKILL.md,预览选择后导入,避免在多个工具目录间复制粘贴 - **Symlink / Copy 双模式**:选 symlink 共享编辑,选 copy 各平台保留独立副本 - **平台目标目录可覆写**:为每个平台单独配置 Skills 目录,扫描和分发保持一致 - **AI 翻译与润色**:以完整 SKILL.md 为单位生成 sidecar 译文,支持沉浸式对照和全文翻译 - **安全扫描**:安装前用 AI 审阅链路检查 Skill 内容,受限来源直接阻断 - **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 等) - 自部署 PromptHub Web 可作为额外的同步源 / 备份源 - 启动时自动拉取 + 后台定时同步;只允许一个活动同步源驱动自动同步,避免多源冲突写入 ### 🔐 隐私与安全 - 主密码保护应用入口,AES-256-GCM 加密 - 私密文件夹内容加密存储(Beta) - 跨平台离线运行: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,或自部署一份 PromptHub Web 当同步目标。
## 自部署网页版 PromptHub Web 是一个轻量的浏览器版工作区,你可以用 Docker 把它跑在 NAS、VPS 或局域网里。它**不是**官方云服务,主要用途是: - 在浏览器里访问自己的 PromptHub 数据 - 给桌面版当作除 WebDAV 之外的另一种同步目标 - 不想让数据出本地局域网 ```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、用户名、密码。可以测连接、上传当前工作区、从 Web 拉回本地、启动时自动拉取、后台定时推送。 更详细的部署、升级、备份、GHCR 镜像、开发说明在 [`docs/web-self-hosted.md`](./docs/web-self-hosted.md)。
## 命令行 CLI CLI 适合脚本化管理、批量导入导出、自动化扫描。当前桌面版**不会**自动安装 `prompthub` 命令,需要你从仓库自己打包再装: ```bash pnpm pack:cli pnpm add -g ./apps/cli/prompthub-cli-*.tgz prompthub --help ``` 也可以不安装直接跑: ```bash pnpm --filter @prompthub/cli dev -- prompt list pnpm --filter @prompthub/cli 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 folder list / get / create / update / delete / reorder rules list / scan / read / save / rewrite versions / version-read / version-restore / version-delete add-project / remove-project export / import skill list / get / install / delete / remove versions / create-version / rollback / delete-version export / scan / scan-safety / sync-from-repo platforms / platform-status / install-md / uninstall-md repo-files / repo-read / repo-write / repo-delete / repo-mkdir / repo-rename workspace export / import ``` 常用全局参数: - `--output json|table` — 输出格式 - `--data-dir ` — 显式指定 PromptHub 的 `userData` 目录 - `--app-data-dir ` — 显式指定应用数据根目录 - `--version|-v` — 打印 CLI 版本
## 更新日志 完整版本说明:**[CHANGELOG.md](./CHANGELOG.md)** ### 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.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 等十几个平台 - 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/changes/active//` 下建一个 change 文件夹(`proposal.md` / `specs//spec.md` / `design.md` / `tasks.md` / `implementation.md`),完成后把稳定事实回填到 `spec/domains/`、`spec/architecture/`,并在需要时更新 `docs/`、`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 对你有帮助,请给个 ⭐ 支持一下。