PromptMinder

中文 | English

PromptMinder

一个专业的提示词管理平台，让 AI 提示词管理更简单、更高效

🌟 特性

核心功能

• ✅ 提示词版本管理 - 支持版本回溯和历史记录查看
• ✅ 版本差异对比 - 类似 Git diff 的并排对比视图，快速识别提示词更新变化
• ✅ 版本审批流 - 团队空间支持可配置审批开关，支持提交/审批/拒绝/撤回
• ✅ 审批讨论与 @提及 - 审批单线程评论，支持 @团队成员 协作评审
• ✅ 变更订阅与通知中心 - 支持按提示词订阅变更，站内通知统一收敛
• ✅ 标签化管理 - 自定义标签，快速分类和检索
• ✅ 公私有模式 - 支持私有提示词和公共分享
• ✅ AI 智能生成 - 集成 AI 模型，智能生成优质提示词
• ✅ 团队协作 - 支持团队创建、成员管理与权限控制
• ✅ 提示词贡献 - 社区贡献功能，审核发布流程

用户体验

• 📱 移动端适配 - 响应式设计，完美支持移动设备
• 🌍 国际化支持 - 支持中文和英文双语
• 🎨 现代化界面 - 基于 Shadcn UI 的精美设计
• 🔍 智能搜索 - 快速搜索和过滤功能
• 📋 一键复制 - 方便的复制和分享功能

技术特性

• ⚡ 高性能 - Next.js 16 + React 19，极速加载
• 🔐 安全认证 - Clerk 提供企业级用户认证
• 💾 可靠存储 - Neon PostgreSQL + Drizzle ORM
• 🚀 易部署 - 支持 Vercel、Zeabur 一键部署

🚀 快速开始

环境要求

• Node.js 20.0 或更高版本
• npm 或 pnpm 包管理器
• Git

本地开发

1. 克隆项目

git clone https://github.com/your-username/promptMinder.git
cd promptMinder

2. 安装依赖

# 推荐使用 pnpm
pnpm install

3. 配置环境变量 创建 .env.local 文件并配置以下变量：

# 数据库配置 (Neon PostgreSQL)
DATABASE_URL=postgresql://user:password@ep-xxx.us-east-2.aws.neon.tech/neondb?sslmode=require

# Supabase 配置 (仅用于文件存储)
SUPABASE_URL=your_supabase_project_url
SUPABASE_ANON_KEY=your_supabase_anon_key

# Clerk 认证配置
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up

# NextAuth 配置
AUTH_SECRET=your_auth_secret

# AI API 配置
ZHIPU_API_KEY=your_zhipu_api_key

# GitHub OAuth (可选)
GITHUB_ID=your_github_app_id
GITHUB_SECRET=your_github_app_secret

# 基础 URL
NEXT_PUBLIC_BASE_URL=http://localhost:3000

4. 执行数据库迁移

   首次拉取最新代码后，请先执行数据库迁移（尤其是审批流升级后）：

pnpm db:migrate

5. 启动开发服务器

npm run dev
# 或者使用 pnpm
pnpm dev

访问 http://localhost:3000 查看应用。

CLI Quick Start

普通用户不需要后台脚本发 token，直接在网页里创建：

https://www.prompt-minder.com/settings/cli-tokens

然后安装并使用 CLI：

npm i -g @aircrushin/promptminder-cli
promptminder auth login --token pm_xxx
promptminder team list

CLI Agent Skill

如果你希望 Cursor、Claude Code、Codex CLI 等 AI agent 正确使用 PromptMinder CLI，优先安装独立 skill 仓库：

npx skills add aircrushin/promptminder-cli-skill

仓库地址：https://github.com/aircrushin/promptminder-cli-skill

CLI 当前仍保留 promptminder skills install，但该路径仅作为兼容旧安装方式的 deprecated compatibility 入口，后续以独立 skill 仓库为准。

📦 部署指南

Vercel 部署

1. 准备工作

   • Fork 本项目到你的 GitHub 账户
   • 注册并登录 Vercel

2. 部署步骤

   • 在 Vercel 中点击 New Project
   • 选择 Import Git Repository
   • 选择你 fork 的项目
   • 配置环境变量（见上方环境变量说明）
   • 点击 Deploy

3. 自动部署

   • 部署完成后，每次推送到主分支都会自动重新部署

Zeabur 部署

1. 访问 Zeabur 并登录

2. 创建新项目并连接 GitHub 仓库

3. 配置环境变量

4. 部署并获取访问地址

   

🗃 数据库配置

Neon PostgreSQL + Drizzle ORM

本项目使用 Neon Serverless PostgreSQL 作为数据库，Drizzle ORM 进行数据库查询和 Schema 管理。

1. 创建 Neon 数据库

   • 注册 Neon 账户
   • 创建新项目，获取 DATABASE_URL 连接字符串
   • 将连接字符串配置到 .env.local 的 DATABASE_URL 中

2. 初始化数据库表结构

# 将 Drizzle Schema 推送到数据库（首次使用或开发环境）
pnpm db:push

3. 数据库命令

pnpm db:push       # 将 Schema 推送到数据库（开发环境推荐）
pnpm db:generate   # 生成 SQL 迁移文件
pnpm db:migrate    # 执行迁移文件（生产环境推荐）
pnpm db:studio     # 打开 Drizzle Studio 可视化管理数据库

4. Schema 文件

   数据库表结构定义在 drizzle/schema/ 目录中：

   • teams.js — teams、team_members、projects 表
   • prompts.js — prompt_lineages、prompts、tags、favorites 表
   • workflow.js — 审批流与协作表（审批单、评论、提及、订阅、通知、审计事件）
   • public.js — public_prompts、prompt_likes、prompt_contributions 表
   • user.js — user_feedback、provider_keys 表

🔄 团队审批协作说明

• 团队可在「团队管理」页面开启/关闭版本审批流（存量团队默认关闭，新团队默认开启）。
• 开启后，团队内新建/改版会进入审批单，不会直接发布到版本列表。
• 审批权限：owner/admin；支持审批单评论与 @成员 协作。
• 支持按提示词订阅变更，并在通知中心查看未读/已读消息。

🔐 认证配置

Clerk 设置

1. 创建 Clerk 应用

   • 访问 Clerk
   • 创建新应用
   • 选择认证方式（邮箱、社交登录等）

2. 配置 OAuth 提供商

   • 在 Clerk 控制台中启用 GitHub、Google 等登录方式
   • 配置回调 URL

3. 获取密钥

   • 复制 Publishable Key 和 Secret Key
   • 添加到环境变量中

详细配置请参考 Clerk 官方文档

🌍 国际化

项目支持多语言，目前支持：

• 🇨🇳 简体中文
• 🇺🇸 English

语言文件位于 /messages 目录：

• zh.json - 中文翻译
• en.json - 英文翻译

添加新语言

1. 在 /messages 目录创建新的语言文件
2. 复制现有翻译文件的结构
3. 在 LanguageContext 中添加新语言支持

🛠 开发指南

项目结构

promptMinder/
├── app/                    # Next.js App Router
│   ├── api/               # API 路由
│   ├── prompts/           # 提示词相关页面
│   ├── tags/              # 标签管理页面
│   └── ...
├── components/            # React 组件
│   ├── ui/                # 基础 UI 组件
│   ├── prompt/            # 提示词相关组件
│   └── ...
├── contexts/              # React Context
├── hooks/                 # 自定义 Hooks
├── lib/                   # 工具库和配置
├── messages/              # 国际化文件
├── public/                # 静态资源
└── sql/                   # 数据库脚本

代码规范

• 使用 ESLint 进行代码检查
• 遵循 React Hooks 最佳实践
• 组件使用 TypeScript (推荐)
• CSS 使用 Tailwind CSS

贡献指南

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

🤝 社区

用户反馈

使用 Canny 收集用户反馈和功能请求。

1. 注册 Canny 账号并创建项目
2. 获取 Canny URL
3. 在应用的 Footer 组件中配置链接

📄 许可证

本项目采用 MIT 许可证。

💖 支持项目

如果这个项目对你有帮助，欢迎：

• ⭐ 给项目点个星
• 🍴 Fork 并改进
• 🐛 提交 Bug 报告
• 💡 提出新功能建议

---

PromptMinder - 让 AI 提示词管理更简单 ✨