PromptHub 把你的 Prompt、SKILL.md 和项目级 AI 编程资产放进一个本地工作区。它能把同一份 Skill 一键安装到 Claude Code、Cursor、Codex、Windsurf、Gemini CLI 等十几个工具，给 Prompt 做版本管理与多模型测试，并通过 WebDAV 或自部署 Web 同步到其他设备。
数据默认存在你自己的电脑上。
最新稳定版 v0.5.6。每个平台都有两条下载链路：
- 直链下载 — 文件名固定，链接不会随版本变化，适合做长期书签或脚本调用（v0.5.7 起接入 CDN 镜像，本版本暂时回退到 GitHub Releases）
- GitHub Releases — 官方发布页，可下载历史版本、查看签名与 Release Notes
| 平台 | 直链下载 | GitHub Releases |
|---|---|---|
| Windows |   |
|
| macOS |   |
|
| Linux |   |
|
| 预览版 |  |
在应用内「设置 → 关于」打开「预览版通道」开关后，自动检查并升级 |
macOS 选哪个？ Apple Silicon（M1/M2/M3/M4）选
arm64，Intel Mac 选x64。 Windows 选哪个？ 绝大多数选x64，只有 Surface Pro X 这类 ARM 设备选arm64。
brew tap legeling/tap
brew install --cask prompthub后续升级请用 brew upgrade --cask prompthub，不要和应用内自动更新混用，否则可能出现 Homebrew 记录的版本和实际安装不一致。
应用没有 Apple 公证签名，第一次打开可能会弹「无法验证开发者」。打开终端执行：
sudo xattr -rd com.apple.quarantine /Applications/PromptHub.app然后重新打开就行。如果应用安装在其他位置，把路径替换成实际安装路径。
如果你想体验下一版的开发预览版，可以在「设置 → 关于」打开「预览版通道」开关，应用会从 GitHub Prereleases 拉取构建。一旦关掉这个开关，更新会回到稳定版，并且不会从较新的预览版自动降级到较旧的稳定版。
下面这几张展示了 0.5.6 的核心交互。
主界面（双栏首页）
Skill 商店
Skill 详情与一键安装到平台
Rules 工作区
项目级 Skill 工作区
Quick Add 多入口（手动 / 分析 / AI 生成）
外观与动画偏好
- 文件夹、标签、收藏三层组织，可拖拽排序，CRUD 全覆盖
- 模板变量
{{variable}}，复制 / 测试 / 分发时弹表单填值 - 全文搜索（FTS5），Markdown 渲染与代码高亮，附件 / 多媒体预览
- 桌面卡片支持双击进入 inline 编辑用户 Prompt 和 System Prompt
- 技能商店：内置 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：商店与仓库导入支持鉴权，减少匿名限流失败
- 标签筛选：按标签快速过滤已安装与商店技能
- 集中管理
.cursor/rules、.claude/CLAUDE.md、AGENTS.md 等规则文件 - 支持手动添加项目级 Rules，按目录分组浏览
- 与 ZIP 导出、WebDAV、自托管同步、Web 导入导出全链路打通
- 扫描项目里的
.claude/skills、.agents/skills、skills、.gemini等常见目录 - 为单个项目建立独立 Skill 工作区，不污染全局库
- 个人库、本地仓库、项目资产同一界面切换，不用在多个工具目录之间跳来跳去
- 全局 Prompt 标签管理：集中搜索、重命名、合并、删除标签，数据库与工作区文件一并同步
- 内置 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
-
新建第一个 Prompt 点「+ 新建」，写标题、描述、System Prompt 和 User Prompt。
{{变量名}}会变成一个变量，复制或测试时会弹表单让你填。 -
把 Skills 纳入工作区 去「Skills」标签，从商店选几个，或点「扫描本地」让 PromptHub 自动找你电脑上已有的 SKILL.md。
-
一键安装到 AI 工具 在 Skill 详情页选目标平台。PromptHub 会按平台规范把 SKILL.md 安装到对应目录。可以选 symlink（同步编辑）或独立复制。
-
配置同步（可选） 「设置 → 数据」里配 WebDAV，或自部署一份 PromptHub Web 当同步目标。
PromptHub Web 是一个轻量的浏览器版工作区，你可以用 Docker 把它跑在 NAS、VPS 或局域网里。它不是官方云服务，主要用途是：
- 在浏览器里访问自己的 PromptHub 数据
- 给桌面版当作除 WebDAV 之外的另一种同步目标
- 不想让数据出本地局域网
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。
CLI 适合脚本化管理、批量导入导出、自动化扫描。当前桌面版不会自动安装 prompthub 命令，需要你从仓库自己打包再装：
pnpm pack:cli
pnpm add -g ./apps/cli/prompthub-cli-*.tgz
prompthub --help也可以不安装直接跑：
pnpm --filter @prompthub/cli dev -- prompt list
pnpm --filter @prompthub/cli dev -- skill scan支持的资源命令一览（每个命令都有 --help）：
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 <path>— 显式指定 PromptHub 的userData目录--app-data-dir <path>— 显式指定应用数据根目录--version|-v— 打印 CLI 版本
完整版本说明：CHANGELOG.md
新功能
- 🧭 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、
<Reveal><Collapsible><ViewTransition><Pressable>四个意图组件、三档用户偏好），并卸掉了仅在一个组件用过的 framer-motion，ui-vendorchunk gzip 从 54 KB 降到 16 KB - 🪶 桌面端长列表（Skill 列表 / Prompt 画廊 / 看板 / Prompt 详情列表）改为
@tanstack/react-virtual虚拟化，去掉了之前手写的 setTimeout 分批渲染补丁
详见上方更新日志。
- 商店 Skill 安装时记录内容哈希，可检测远端 SKILL.md 是否更新并支持本地修改冲突保护
- Skill 整份文档 AI 翻译：围绕完整 SKILL.md 生成 sidecar 译文，支持全文翻译和沉浸式对照
- 数据目录切换通过 relaunch 真正生效
- AI 模型测试与翻译错误反馈更明确（504 / 超时 / 未配置都有具体提示）
- Web/Docker 媒体上传修复，
local-image:///local-video://自动解析 - 预览通道更新链路加固
- Issue Form 自动同步
version: x.y.z标签
- 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。
git clone https://github.com/legeling/PromptHub.git
cd PromptHub
pnpm install
# 桌面端开发
pnpm electron:dev
# 桌面端构建
pnpm build
# 自部署 Web 构建
pnpm build:webpnpm 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 体积预算检查 |
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
- 完整指南：
docs/contributing.md - 对外文档索引：
docs/README.md - 内部 SSD / spec：
spec/README.md
非平凡改动建议先在 spec/changes/active/<change-key>/ 下建一个 change 文件夹（proposal.md / specs/<domain>/spec.md / design.md / tasks.md / implementation.md），完成后把稳定事实回填到 spec/domains/、spec/architecture/，并在需要时更新 docs/、README.md。
Electron · React · TailwindCSS · Zustand · Lucide · @tanstack/react-virtual · tailwindcss-animate
感谢所有为 PromptHub 做出贡献的开发者。
欢迎加入 PromptHub 社群，反馈问题、交流使用方式、讨论新功能、抢先体验预览版。
推荐优先加入 Discord 社群，获取公告、交流支持与新版本动态
如果你更习惯用 QQ，可以加入 PromptHub QQ 交流群：
- 群号：
704298939
扫码加入 PromptHub QQ 交流群
如果 PromptHub 对你的工作有帮助，欢迎请作者喝杯咖啡。
If PromptHub is helpful to your work, feel free to buy the author a coffee.
微信支付 / WeChat Pay |
支付宝 / Alipay |
Buy Me A Coffee |
历史赞助记录归档在 docs/sponsors.md。
如果 PromptHub 对你有帮助，请给个 ⭐ 支持一下。