🚀 开源免费的 AI Prompt 与 Skill 管理工具 | 数据本地存储 | 隐私优先
Prompt 管理 · 技能商店 · 多平台分发 · 版本控制 · 变量模板 · 多模型测试 — 一站式 AI 工作台
💡 为什么选择 PromptHub?
PromptHub 不仅是 Prompt 管理工具,更是 AI 技能分发中心。管理你的 Prompt 和 SKILL.md 技能,一键安装到 Claude Code、Cursor、Windsurf、Codex 等 15+ 主流 AI 编程工具。支持版本控制、变量模板、多模型测试,所有数据都存在本地,隐私安全有保障。
|
|
|
|
|
|
除了桌面版,PromptHub 现在也提供轻量级的自部署网页版,适合作为个人浏览器工作区,或作为桌面版的备份源 / 恢复源。
它不是 SaaS 云服务,而是一个适合个人或小规模自托管的浏览器版工作区。核心能力包括 Prompt、文件夹、Skill、导入导出、媒体文件、设置,以及作为桌面版的数据同步目标。
更完整的部署、升级、备份、Docker 与开发说明见 docs/web-self-hosted.md。
- 想在浏览器里访问自己的 PromptHub 数据
- 想把自部署网页版当成桌面版的备份源 / 恢复源
- 不想折腾 WebDAV,希望有一个更直观的单机自托管界面
- 新实例首次访问时会进入
/setup,而不是登录页 - 第一个用户会被创建为管理员
- 首个管理员创建完成后,公开注册默认关闭,不适合作为开放注册的多人 SaaS
在仓库根目录执行:
cp apps/web/.env.example apps/web/.env
cd apps/web
docker compose up -d --build最少需要关注这几个配置:
JWT_SECRET至少 32 位随机字符串,用于登录鉴权ALLOW_REGISTRATION=false建议保持关闭,避免初始化后继续开放注册DATA_ROOTPromptHub Web 的数据根目录;应用会在其下写入data/、config/、logs/、backups/
默认访问地址:
http://localhost:3871
docker pull ghcr.io/legeling/prompthub-web:latest
docker run -d \
--name prompthub-web \
-p 3871:3000 \
-e JWT_SECRET='replace-with-a-random-secret-at-least-32-chars' \
-e ALLOW_REGISTRATION=false \
-v "$(pwd)/apps/web/data:/app/data" \
ghcr.io/legeling/prompthub-web:latest桌面版进入 设置 -> 数据 后,可以直接配置:
- 自部署 PromptHub URL
- 用户名
- 密码
配置完成后,桌面版可以执行:
- 测试连接
- 上传当前本地工作区到自部署网页版
- 从自部署网页版下载并恢复
- 启动时自动拉取
- 定时后台推送
请备份整个数据根目录,而不只是 SQLite 文件。默认 Compose 示例里建议至少备份:
apps/web/data
apps/web/config
apps/web/logs其中会包含:
data/prompthub.dbdata/prompts/...data/skills/...data/assets/...config/settings/...backups/...logs/...
如果你只是想快速部署,上面的内容已经够用了;更细的工程说明、Compose 变体和开发命令请看 docs/web-self-hosted.md。
从 Releases 下载最新版本 v0.5.5:
| 平台 | 下载 |
|---|---|
| Windows | |
| macOS | |
| Linux | |
| 预览版 |
💡 架构选择建议
- macOS:Apple Silicon(M1/M2/M3/M4)下载
arm64,Intel Mac 下载x64- Windows:绝大多数电脑下载
x64;只有 Windows on ARM 设备才下载arm64- 预览版:如果你想提前测试即将发布的修复,可前往 GitHub
Prereleases页面下载,或在应用内设置里显式加入预览更新通道0.5.5-beta.1:这是为了补齐历史0.5.5预览构建机器可判定标识而重新发布的历史 beta 版本。它在 semver 上低于0.5.5stable,应视为手动下载安装的测试版,而不是稳定版用户的默认升级目标
brew tap legeling/tap # 首次安装只需执行一次
brew install --cask prompthub如果你是通过 Homebrew 安装的,后续升级建议优先使用 Homebrew,不要和应用内更新混用:
brew update
brew upgrade --cask prompthub如果 Homebrew 已同步到新版本,但本地安装状态异常,可以重新安装当前版本:
brew reinstall --cask prompthub💡 说明
- 通过 DMG/EXE 手动安装的用户:优先使用应用内「检查更新」或前往 Releases 手动下载
- 通过 Homebrew 安装的用户:优先使用
brew upgrade --cask prompthub- 混用两种升级方式可能导致 Homebrew 记录的版本与实际安装状态不一致
由于应用未经过 Apple 公证签名,首次打开时可能会提示 "PromptHub 已损坏,无法打开" 或 "无法验证开发者"。
解决方法(推荐):打开终端,执行以下命令绕过公证检查:
sudo xattr -rd com.apple.quarantine /Applications/PromptHub.app💡 提示:如果应用安装在其他位置,请将路径替换为实际安装路径。
或者:打开「系统设置」→「隐私与安全性」→ 向下滚动找到安全性部分 → 点击「仍要打开」。
# 克隆仓库
git clone https://github.com/legeling/PromptHub.git
cd PromptHub
# 安装依赖
pnpm install
# 开发模式
pnpm dev
# 构建应用
pnpm buildPromptHub 现在同时提供 GUI 和 CLI。
⚠️ 当前行为
- 桌面版安装后并首次启动一次应用:PromptHub 会自动安装
prompthub命令- 重新打开一个终端窗口后:就可以直接使用
prompthub --参数- 源码运行 / 构建后的 CLI bundle:仍然保留,适合开发和调试
prompthub --help
prompthub prompt list
prompthub skill list
prompthub --output table prompt search SEO --favorite💡 提示
- 如果你刚安装完桌面版,请先启动一次 PromptHub
- 如果当前终端还识别不到
prompthub,请关闭并重新打开终端
pnpm install
# 查看帮助
pnpm cli:dev -- --help
# Prompt 命令
pnpm cli:dev -- prompt list
pnpm cli:dev -- prompt get <id>
pnpm cli:dev -- prompt create --title "Landing Hero" --user-prompt "Write a landing page hero"
# Skill 命令
pnpm cli:dev -- skill list
pnpm cli:dev -- skill get <id-or-name>
pnpm cli:dev -- skill scan
pnpm cli:dev -- skill install ~/.claude/skills/my-skillpnpm build
node out/cli/prompthub.cjs --help
node out/cli/prompthub.cjs prompt list
node out/cli/prompthub.cjs skill listprompthub --help
prompthub --output table prompt list
prompthub --data-dir /path/to/user-data prompt list
prompthub --app-data-dir /path/to/app-data skill list--output json|table:切换 JSON 或表格输出--data-dir:显式指定 PromptHub 的userData目录--app-data-dir:显式指定应用数据根目录
prompt list|get|create|update|delete|searchskill list|get|install|scan|delete|remove
- CLI 直接读写 PromptHub 的本地数据库和 skill 仓库
- CLI 适合脚本化管理、批量导入导出、自动化扫描
- 桌面版会在首次启动时自动安装 shell 命令包装器
- 如果你移动了应用安装位置,再次启动 PromptHub 会自动刷新命令包装器路径
点击「新建」按钮,填写:
- 标题 - Prompt 名称
- 描述 - 简短说明用途
- System Prompt - 设置 AI 角色(可选)
- User Prompt - 实际的提示词内容
- 标签 - 便于分类和搜索
在 Prompt 中使用 {{变量名}} 语法定义变量:
请将以下 {{source_lang}} 文本翻译成 {{target_lang}}:
{{text}}
选中 Prompt,点击「复制」,Prompt 内容将复制到剪贴板。
编辑 Prompt 时会自动保存历史版本,点击「历史版本」可以查看和恢复。
- 从商店添加:进入「技能商店」浏览精选技能,点击「添加到库」
- 安装到平台:添加后自动弹出平台选择弹窗,勾选目标 IDE 一键安装
- 扫描本地:自动发现本地已有的 SKILL.md,预览后选择性导入
- 管理与编辑:在库中编辑技能内容,支持 AI 生成和润色
💡 支持的平台:Claude Code、GitHub Copilot、Cursor、Windsurf、Kiro、Gemini CLI、Trae、OpenCode、Codex CLI、Roo Code、Amp、OpenClaw、Qoder、QoderWork、CodeBuddy
| 类别 | 技术 |
|---|---|
| 框架 | Electron 33 |
| 前端 | React 18 + TypeScript 5 |
| 样式 | TailwindCSS |
| 状态管理 | Zustand |
| 本地存储 | SQLite(WASM) |
| 构建工具 | Vite + electron-builder |
PromptHub/
├── src/
│ ├── main/ # Electron 主进程
│ │ ├── database/ # SQLite 数据库操作
│ │ ├── ipc/ # IPC 通信处理
│ │ ├── services/ # 核心服务 (Skill 安装器等)
│ │ ├── index.ts # 主进程入口
│ │ ├── menu.ts # 应用菜单
│ │ ├── shortcuts.ts # 快捷键
│ │ └── updater.ts # 自动更新
│ ├── preload/ # 预加载脚本
│ ├── renderer/ # React 渲染进程
│ │ ├── components/ # UI 组件
│ │ │ ├── folder/ # 文件夹组件
│ │ │ ├── layout/ # 布局组件
│ │ │ ├── prompt/ # Prompt 组件
│ │ │ ├── skill/ # Skill 组件
│ │ │ ├── settings/ # 设置页面
│ │ │ └── ui/ # 通用 UI 组件
│ │ ├── i18n/ # 国际化 (7 种语言)
│ │ ├── services/ # 服务层 (AI, WebDAV)
│ │ ├── stores/ # Zustand 状态管理
│ │ └── styles/ # 全局样式
│ └── shared/ # 共享类型和常量
│ ├── constants/ # 常量定义 (平台配置、技能注册表)
│ └── types/ # TypeScript 类型
├── resources/ # 应用图标等静态资源
├── .github/workflows/ # CI/CD 配置
└── package.json
代码结构与超长文件治理规范见 spec/architecture/code-structure-guidelines.md,回归检查清单见 spec/architecture/refactor-regression-checklist.md。
PromptHub 现在采用 docs/ 与 spec/ 双层文档职责:docs/ 负责仓库/用户/贡献者可读说明,spec/ 负责内部 SSD、稳定 specs、架构、问题追踪、归档。
这套内部结构参考 OpenSpec:稳定事实进 spec/specs/,活跃增量进 spec/changes/active/<change-key>/specs/<domain>/spec.md,完成后归档到 spec/changes/archive/,并按迭代式工作流持续把实施结果同步回稳定层。
相比上一版,这次补齐了此前缺失的稳定规格层、delta spec 层、archive 层、legacy 层与模板层,并从 git HEAD 恢复了被误删的内部文档原文,避免内容只剩历史记录可查。
核心 SSD 闭环是:需求 -> 规格 -> 设计 -> 任务 -> 实施 -> 同步 -> 归档。
docs/README.md:外部说明区索引docs/:部署、贡献、用户说明、多语言 README、图片资源spec/README.md:内部 SSD 索引spec/specs/:稳定的 source-of-truth specsspec/architecture/:长期有效的内部架构与工程事实文档spec/changes/active/<change-key>/:正在进行的内部变更spec/changes/archive/<date>-<change-key>/:已完成或已废弃的变更归档spec/changes/legacy/:历史平铺内部变更文档保留区spec/issues/active/:尚未收敛为具体实现变更的问题与质量风险spec/changes/_templates/:提案、delta spec、设计、任务、实施模板
proposal.md:为什么做、范围、风险、回滚思路specs/<domain>/spec.md:行为变化本身,包含新增/修改/移除的要求与场景design.md:技术方案、受影响模块、数据/IPC/迁移影响tasks.md:实施清单与验证项implementation.md:实际做了什么、验证了什么、同步了哪些稳定文档
- 小修小补可以直接改代码
- 复杂功能、跨模块改动、重构、迁移和关键 bug 修复应先建立
spec/changes/active/变更文件夹 - 实施完成后,必须把最终落地情况写进
implementation.md - 变更完成后,把稳定行为同步回
spec/specs/,把长期有效的工程结论同步回spec/architecture/ - 对外可见契约变化再同步回
docs/或根README.md - 发布或放弃后,把变更目录移到
spec/changes/archive/
完整规则见 docs/README.md 和 spec/README.md。
- Skill 商店更新检测:商店下载的 Skill 记录安装内容哈希,可检测远端
SKILL.md是否更新 - 稳定 / 预览更新通道:默认只更新稳定版,加入预览版本后才会接收 GitHub prerelease 测试版
- Skill 更新冲突保护:本地改动和远端改动同时存在时提示冲突,需显式覆盖才会更新
- 网页版媒体修复:Docker/Web 环境支持图片、视频上传,并能显示桌面同步来的本地媒体链接
- 同步与密码修复:修复网页端同步后普通文件夹误上锁,新增网页端登录密码修改入口,桌面取消私密需先解锁
- 安全加固:SSRF 防护重写、deleteAll 确认参数、URL 协议校验、版本字段验证
- 架构重构:skill-installer God Class 拆分为 6 个子模块 + 1 个 facade barrel
- Skill 元数据编辑修复:编辑描述后不再被磁盘旧值覆盖,自动回写 SKILL.md frontmatter
- 数据库迁移修复:迁移失败不再误标为完成,防止后续启动跳过失败迁移
- 代码质量:消除
any类型、异步化文件操作、循环引用防护、seed 竞态修复、720 测试全绿
- AI 工作台实装:模型管理、端点编辑、连接测试与场景默认模型已接入真实设置链路
- skills.sh 社区商店接入:社区榜单、每周安装量、GitHub Star 与商店详情已集成到 PromptHub
- Prompt / Skill 历史版本删除:支持清理不再需要保留的单条历史记录
- Skill 手动修改回写:重新打开详情页时会从本地
SKILL.md同步最新元数据与内容 - 备份与 WebDAV 修复:统一备份导入格式,补齐 Skill 的 WebDAV 上传与恢复链路
- 数据目录与迁移表达修复:设置页显示真实数据目录,并明确提示迁移后需重启切换
- 大规模 Skill 性能优化:本地数百个 Skill 的列表和画廊视图改为分批渲染,并补上性能预算测试
- Skill 技能商店:内置 20+ 精选 AI 代理技能,来自 Anthropic、OpenAI 等官方源
- 多平台安装:支持一键安装 SKILL.md 到 Claude Code、Cursor、Windsurf、Codex、Qoder、CodeBuddy 等 15+ 平台
- 本地扫描预览:自动发现本地已有 SKILL.md,支持预览选择后批量导入
- 软链接/复制模式:支持 Symlink 同步编辑或独立复制到各平台
- AI 技能翻译:支持沉浸式翻译和全文翻译,方便阅读英文技能
- AI 技能生成:支持 AI 生成技能内容和智能润色
- 技能标签筛选:侧边栏标签快速过滤技能
- 清晰的工作流:「添加到库」→「安装到平台」,添加后自动弹出平台选择
- 多层级文件夹:支持分层嵌套与拖拽管理
- 版本控制系统:像管理代码一样管理 Prompt,支持历史对比与一键回滚
- 变量模板系统:支持
{{variable}}语法,自动生成填充表单,支持复制前预览 - 多模型实验室:内置国内外主流服务商,支持多模型并行对比测试与响应时间分析
- 跨设备同步:支持 WebDAV 增量同步与全量备份,数据高度可控
- 极致阅读体验:支持 Markdown 全场景渲染、代码高亮、双语对照模式
- 多维高效管理:文件夹、标签、收藏、使用次数统计、全文评分搜索
- 多视图模式:提供卡片、精简列表、画廊三种视图,适配不同使用场景
- 系统深度集成:全局快捷键唤起、最小化到系统托盘、暗黑模式支持
- 更新镜像加速:内置多个 GitHub 加速镜像,解决国内用户下载更新缓慢的问题
- 安全与隐私:主密码保护、私密文件夹加密存储,所有数据坚持本地优先
- 浏览器扩展:在网页端(如 ChatGPT/Claude)直接调取 PromptHub 库,实现无缝工作
- 移动端应用:支持手机端查看、搜索与简单的编辑同步
- 插件系统:支持用户自定义扩展 AI 供应商或本地模型(如 Ollama)集成
- 批量导出与转换:支持将提示词导出为常用 AI 工具支持的特定格式
- 增强型变量:支持选择框、动态日期等更复杂的变量类型
- 技能市场:支持用户上传和分享自己创建的技能
查看完整的更新日志:CHANGELOG.md
Skill 更新 / Skill Updates
- 🧩 商店 Skill 更新检测:商店下载的 Skill 会保存安装时内容哈希与版本,可检查远端
SKILL.md是否变化 - 🚦 稳定 / 预览更新通道:系统设置可加入预览版本;默认只检查稳定版,加入后才会检查 GitHub prerelease 测试版
- 🛡️ 本地修改冲突保护:本地改过且远端也变化时标记为冲突,只有显式覆盖才会更新
网页版 / Web
- 🌐 媒体上传与显示修复:Web/Docker 环境支持图片、视频选择上传,并能显示桌面同步来的
local-image:///local-video://媒体 - 🔐 同步私密状态修复:桌面数据同步到网页端时,不再把缺失
visibility的普通文件夹误判为私密 - 🔑 登录密码修改入口:自托管 Web 设置页新增密码修改表单
桌面与文档 / Desktop & Docs
- 🔒 私密文件夹保护:桌面端取消文件夹私密状态前必须先通过主密码解锁
- 🌍 多语言与发版文档同步:补齐 Skill 更新文案,并同步 README、多语言 README 与官网发布元数据到
v0.5.5
- 🔄 更新链路修复补发:将原
0.5.5线的历史预览构建重新标记为0.5.5-beta.1,用于提供清晰的 beta / prerelease 语义 ⚠️ 使用方式说明:该版本低于0.5.5stable,适合手动下载安装做历史测试,不作为稳定版用户的默认自动升级目标
欢迎贡献代码。完整贡献规范、开发环境、测试门禁与 DOS/SSD 文档流程见 docs/contributing.md。
本项目采用 AGPL-3.0 License 开源协议。
- 问题反馈: GitHub Issues
- 功能建议: GitHub Discussions
- Electron - 跨平台桌面应用框架
- React - UI 框架
- TailwindCSS - CSS 框架
- Zustand - 状态管理
- Lucide - 图标库
感谢所有为 PromptHub 做出贡献的开发者!
特别感谢:
如果 PromptHub 对你的工作有帮助,欢迎请作者喝杯咖啡!
If PromptHub is helpful to your work, feel free to buy the author a coffee!
欢迎加入 PromptHub QQ 交流群,一起反馈问题、交流使用方式和讨论新功能。
- 群号:
704298939
感谢以下朋友对 PromptHub 的捐赠支持:
| 日期 | 支持者 | 金额 | 留言 |
|---|---|---|---|
| 2026-01-08 | *🌊 | ¥100.00 | 支持优秀的软件! |
| 2025-12-29 | *昊 | ¥20.00 | 感谢您的软件!能力有限,小小支持 |
联系邮箱 / Contact: legeling567@gmail.com
感谢每一位支持者!你们的支持是我持续开发的动力!
Thank you to every supporter! Your support keeps me motivated to continue development!















