Skip to content

legeling/PromptHub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

144 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PromptHub Logo

PromptHub

🚀 开源免费的 AI Prompt 与 Skill 管理工具 | 数据本地存储 | 隐私优先

Prompt 管理 · 技能商店 · 多平台分发 · 版本控制 · 变量模板 · 多模型测试 — 一站式 AI 工作台


GitHub Stars GitHub Forks Downloads

Version License PRs Welcome


TypeScript Electron React TailwindCSS SQLite


macOS Windows Linux


简体中文 · 繁體中文 · English · 日本語 · Deutsch · Español · Français



💡 为什么选择 PromptHub?

PromptHub 不仅是 Prompt 管理工具,更是 AI 技能分发中心。管理你的 Prompt 和 SKILL.md 技能,一键安装到 Claude Code、Cursor、Windsurf、Codex 等 15+ 主流 AI 编程工具。支持版本控制、变量模板、多模型测试,所有数据都存在本地,隐私安全有保障。


✨ 功能特性

📝 Prompt 管理

  • 创建、编辑、删除,支持文件夹和标签分类
  • 自动保存历史版本,支持查看、对比和回滚
  • 模板变量 {{variable}},复制时动态替换
  • 快速收藏常用 Prompt,一键访问
  • 全文搜索标题、描述和内容
  • 支持多媒体参考(图片/视频)预览与附件管理

🧩 Skill 技能管理 🆕

  • 技能商店:内置 20+ 精选技能(来自 Anthropic、OpenAI 等)
  • 多平台安装:一键安装到 Claude Code、Cursor、Windsurf、Codex、Kiro、Gemini CLI、Qoder、QoderWork、CodeBuddy 等 15+ 平台
  • 本地扫描:自动发现本地已有 SKILL.md,预览选择后导入
  • 软链接/复制模式:支持 Symlink 同步编辑或独立复制
  • 平台目标目录:支持为每个平台覆写 Skills 目录,扫描与分发保持一致
  • AI 翻译:沉浸式/全文翻译技能内容,方便阅读
  • 标签筛选:按标签快速过滤技能

🤖 AI 能力

  • 内置 AI 测试,支持 国内外主流服务商
  • 覆盖各类主流大语言模型、各类开源及闭源模型
  • 同一 Prompt 多模型并行测试对比
  • 支持各类图像生成模型性能测评
  • AI 生成技能内容、智能润色

💾 数据与同步

  • 所有数据存储在本地,隐私安全有保障
  • 全量备份与恢复(.phub.gz 压缩格式)
  • WebDAV 云同步(坚果云、Nextcloud 等)
  • 支持启动同步 + 定时同步

🎨 界面与体验

  • 多视图模式:卡片、画廊、列表
  • 深色/浅色/跟随系统,多种主题色
  • 7 种语言支持
  • Markdown 渲染与代码高亮
  • 跨平台:macOS / Windows / Linux

🔐 安全功能

  • 主密码保护 - 支持设置应用级主密码
  • 私密文件夹 - 私密文件夹内容加密存储(Beta)

📸 截图

主界面

主界面

Skill 商店

Skill 商店

Skill 详情与平台安装

Skill 详情与平台安装

Skill 文件编辑与版本对比

Skill 文件编辑与版本对比

画廊视图

画廊视图

列表视图

列表视图

数据备份

数据备份

主题设置

主题设置

双语对照

双语对照

变量填充

变量填充

版本对比

版本对比

多语言支持

多语言支持

安装

下载

Releases 下载最新版本 v0.5.0:

平台 下载
Windows Windows x64 Windows arm64
macOS macOS Apple Silicon macOS Intel
Linux Linux AppImage Linux deb

💡 架构选择建议

  • macOS:Apple Silicon(M1/M2/M3/M4)下载 arm64,Intel Mac 下载 x64
  • Windows:绝大多数电脑下载 x64;只有 Windows on ARM 设备才下载 arm64

macOS 通过 Homebrew 安装

brew tap legeling/tap   # 首次安装只需执行一次
brew install --cask prompthub

Homebrew 用户升级

如果你是通过 Homebrew 安装的,后续升级建议优先使用 Homebrew,不要和应用内更新混用:

brew update
brew upgrade --cask prompthub

如果 Homebrew 已同步到新版本,但本地安装状态异常,可以重新安装当前版本:

brew reinstall --cask prompthub

💡 说明

  • 通过 DMG/EXE 手动安装的用户:优先使用应用内「检查更新」或前往 Releases 手动下载
  • 通过 Homebrew 安装的用户:优先使用 brew upgrade --cask prompthub
  • 混用两种升级方式可能导致 Homebrew 记录的版本与实际安装状态不一致

macOS 首次启动

由于应用未经过 Apple 公证签名,首次打开时可能会提示 "PromptHub 已损坏,无法打开""无法验证开发者"

解决方法(推荐):打开终端,执行以下命令绕过公证检查:

sudo xattr -rd com.apple.quarantine /Applications/PromptHub.app

💡 提示:如果应用安装在其他位置,请将路径替换为实际安装路径。

或者:打开「系统设置」→「隐私与安全性」→ 向下滚动找到安全性部分 → 点击「仍要打开」。

macOS 安装提示

从源码构建

# 克隆仓库
git clone https://github.com/legeling/PromptHub.git
cd PromptHub

# 安装依赖
pnpm install

# 开发模式
pnpm dev

# 构建应用
pnpm build

命令行 CLI

PromptHub 现在同时提供 GUI 和 CLI。

⚠️ 当前行为

  • 桌面版安装后并首次启动一次应用:PromptHub 会自动安装 prompthub 命令
  • 重新打开一个终端窗口后:就可以直接使用 prompthub --参数
  • 源码运行 / 构建后的 CLI bundle:仍然保留,适合开发和调试

桌面版用户直接使用

prompthub --help
prompthub prompt list
prompthub skill list
prompthub --output table prompt search SEO --favorite

💡 提示

  • 如果你刚安装完桌面版,请先启动一次 PromptHub
  • 如果当前终端还识别不到 prompthub,请关闭并重新打开终端

从源码运行 CLI

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-skill

使用构建后的 CLI bundle

pnpm build

node out/cli/prompthub.cjs --help
node out/cli/prompthub.cjs prompt list
node out/cli/prompthub.cjs skill list

常用全局参数

prompthub --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|search
  • skill list|get|install|scan|delete|remove

说明

  • CLI 直接读写 PromptHub 的本地数据库和 skill 仓库
  • CLI 适合脚本化管理、批量导入导出、自动化扫描
  • 桌面版会在首次启动时自动安装 shell 命令包装器
  • 如果你移动了应用安装位置,再次启动 PromptHub 会自动刷新命令包装器路径

快速开始

1. 创建 Prompt

点击「新建」按钮,填写:

  • 标题 - Prompt 名称
  • 描述 - 简短说明用途
  • System Prompt - 设置 AI 角色(可选)
  • User Prompt - 实际的提示词内容
  • 标签 - 便于分类和搜索

2. 使用变量

在 Prompt 中使用 {{变量名}} 语法定义变量:

请将以下 {{source_lang}} 文本翻译成 {{target_lang}}:

{{text}}

3. 复制使用

选中 Prompt,点击「复制」,Prompt 内容将复制到剪贴板。

4. 版本管理

编辑 Prompt 时会自动保存历史版本,点击「历史版本」可以查看和恢复。

5. Skill 技能管理

  1. 从商店添加:进入「技能商店」浏览精选技能,点击「添加到库」
  2. 安装到平台:添加后自动弹出平台选择弹窗,勾选目标 IDE 一键安装
  3. 扫描本地:自动发现本地已有的 SKILL.md,预览后选择性导入
  4. 管理与编辑:在库中编辑技能内容,支持 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

代码结构与超长文件治理规范见 docs/architecture/code-structure-guidelines.md,回归检查清单见 docs/architecture/refactor-regression-checklist.md

Star History

Star History Chart

路线图

v0.5.0 (当前) 🚀

  • Skill 安全评估:新增静态风险扫描器,可手动检查、自动复查已安装 Skills,并对商店 Skill 输出 safe / warn / high-risk / blocked
  • 商店安装前护栏:商店默认不自动检查;支持“先检查再添加”、高风险二次确认和 blocked 级别直接拦截
  • CLI 安全扫描prompthub skill scan 会返回风险等级与命中规则,适合脚本化审查本地 skill 仓库
  • 安全 / 文档收口:推荐资源、多语言文档与官网发布元数据同步到 v0.5.0

v0.4.9

  • 安全加固:SSRF 防护重写、deleteAll 确认参数、URL 协议校验、版本字段验证
  • 架构重构:skill-installer God Class 拆分为 6 个子模块 + 1 个 facade barrel
  • Skill 元数据编辑修复:编辑描述后不再被磁盘旧值覆盖,自动回写 SKILL.md frontmatter
  • 数据库迁移修复:迁移失败不再误标为完成,防止后续启动跳过失败迁移
  • 代码质量:消除 any 类型、异步化文件操作、循环引用防护、seed 竞态修复、720 测试全绿

v0.4.8

  • AI 工作台实装:模型管理、端点编辑、连接测试与场景默认模型已接入真实设置链路
  • skills.sh 社区商店接入:社区榜单、每周安装量、GitHub Star 与商店详情已集成到 PromptHub
  • Prompt / Skill 历史版本删除:支持清理不再需要保留的单条历史记录
  • Skill 手动修改回写:重新打开详情页时会从本地 SKILL.md 同步最新元数据与内容
  • 备份与 WebDAV 修复:统一备份导入格式,补齐 Skill 的 WebDAV 上传与恢复链路
  • 数据目录与迁移表达修复:设置页显示真实数据目录,并明确提示迁移后需重启切换
  • 大规模 Skill 性能优化:本地数百个 Skill 的列表和画廊视图改为分批渲染,并补上性能预算测试

v0.4.3

  • Skill 技能商店:内置 20+ 精选 AI 代理技能,来自 Anthropic、OpenAI 等官方源
  • 多平台安装:支持一键安装 SKILL.md 到 Claude Code、Cursor、Windsurf、Codex、Qoder、CodeBuddy 等 15+ 平台
  • 本地扫描预览:自动发现本地已有 SKILL.md,支持预览选择后批量导入
  • 软链接/复制模式:支持 Symlink 同步编辑或独立复制到各平台
  • AI 技能翻译:支持沉浸式翻译和全文翻译,方便阅读英文技能
  • AI 技能生成:支持 AI 生成技能内容和智能润色
  • 技能标签筛选:侧边栏标签快速过滤技能
  • 清晰的工作流:「添加到库」→「安装到平台」,添加后自动弹出平台选择

v0.3.x

  • 多层级文件夹:支持分层嵌套与拖拽管理
  • 版本控制系统:像管理代码一样管理 Prompt,支持历史对比与一键回滚
  • 变量模板系统:支持 {{variable}} 语法,自动生成填充表单,支持复制前预览
  • 多模型实验室:内置国内外主流服务商,支持多模型并行对比测试与响应时间分析
  • 跨设备同步:支持 WebDAV 增量同步与全量备份,数据高度可控
  • 极致阅读体验:支持 Markdown 全场景渲染、代码高亮、双语对照模式
  • 多维高效管理:文件夹、标签、收藏、使用次数统计、全文评分搜索
  • 多视图模式:提供卡片、精简列表、画廊三种视图,适配不同使用场景
  • 系统深度集成:全局快捷键唤起、最小化到系统托盘、暗黑模式支持
  • 更新镜像加速:内置多个 GitHub 加速镜像,解决国内用户下载更新缓慢的问题
  • 安全与隐私:主密码保护、私密文件夹加密存储,所有数据坚持本地优先

未来规划

  • 浏览器扩展:在网页端(如 ChatGPT/Claude)直接调取 PromptHub 库,实现无缝工作
  • 移动端应用:支持手机端查看、搜索与简单的编辑同步
  • 插件系统:支持用户自定义扩展 AI 供应商或本地模型(如 Ollama)集成
  • 批量导出与转换:支持将提示词导出为常用 AI 工具支持的特定格式
  • 增强型变量:支持选择框、动态日期等更复杂的变量类型
  • 技能市场:支持用户上传和分享自己创建的技能

更新日志

查看完整的更新日志:CHANGELOG.md

最新版本 v0.5.0 (2026-04-09)

安全评估 / Safety Assessment

  • 🛡️ Skill 安全评估:新增静态风险扫描,可检查已安装 Skill、商店 Skill 和 CLI 扫描结果
  • 🔒 恶意模式检测:覆盖危险 shell 片段、提权/持久化命令、凭据路径访问、编码执行和可疑工作流文件

商店 / Store

  • 🏪 安装前安全检查:商店支持“先检查再添加”,设置里可选开启“添加前自动评估”,默认关闭
  • 🚫 高风险护栏high-risk 级别需二次确认,blocked 级别直接拦截

自动化 / Automation

  • 🖥️ CLI 安全扫描输出prompthub skill scan 现在会输出风险等级和命中规则
  • 📚 发版文档同步:README、多语言 README 与官网发布元数据同步到 v0.5.0

查看完整更新日志

贡献

欢迎贡献代码!请遵循以下步骤:

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 创建 Pull Request

许可证

本项目采用 AGPL-3.0 License 开源协议。

支持

致谢

贡献者

感谢所有为 PromptHub 做出贡献的开发者!

Contributors

特别感谢:


如果这个项目对你有帮助,请给个 ⭐ 支持一下!

If this project helps you, please give it a ⭐!

Buy Me A Coffee

赞助支持 / Sponsor

如果 PromptHub 对你的工作有帮助,欢迎请作者喝杯咖啡!

If PromptHub is helpful to your work, feel free to buy the author a coffee!

WeChat Pay
微信支付 / WeChat Pay
Alipay
支付宝 / Alipay

💖 致谢支持者 / Backers

感谢以下朋友对 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!

About

一款开源、纯本地 Prompt ,Skill 管理工具,帮助你高效管理、版本控制和复用 Prompt,并一键分发skill | An open-source, local-first AI prompt management tool that helps you efficiently manage, version-control, and reuse your prompts

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors