快速创建无需注册的临时 Postgres 数据库 #

解决数据库初始化繁琐的问题：通过 AI 调用 Claimable Postgres 接口，在几秒钟内为项目提供一个可用的 PostgreSQL 连接字符串，跳过繁琐的账号注册与配置流程。

为什么需要这个技能 #

在进行快速原型开发、编写 Demo 或运行临时测试时，配置一个完整的数据库环境往往非常耗时（安装软件、配置权限、管理账号）。

Claimable Postgres 提供了一种“即用即弃”的方案。它允许开发者通过简单的 API 或 CLI 命令瞬间获得一个真实的 Postgres 实例。这些数据库在 72 小时内有效，且无需任何信用卡或登录操作，极大地降低了启动项目的摩擦力。

适用场景 #

• 快速原型开发：当你需要一个真实的数据库来验证功能，但不想花时间部署正式环境时。
• 临时 Demo 演示：为演示项目快速准备一套干净的数据库环境。
• 自动化测试：在 CI/CD 或 AI 代理任务中，动态创建临时的数据库实例以进行集成测试。
• 教学与实验：快速尝试 SQL 语法或数据库迁移脚本。

核心工作流 #

AI 根据用户需求，可选择以下三种路径之一来部署数据库：

1. REST API 路径（最灵活） #

通过 curl 请求 https://pg.new/api/v1/database，获取包含 connection_string 和 claim_url 的 JSON 响应。AI 将其自动写入项目的 .env 文件中。

curl -s -X POST "https://pg.new/api/v1/database" \
  -H "Content-Type: application/json" \
  -d '{"ref": "agent-skills"}'

2. CLI 路径（最快捷） #

直接执行 npx 命令，该工具会自动创建数据库并将连接字符串直接写入 .env。

npx get-db@latest --yes --ref agent-skills

3. 自动化集成（Vite 插件） #

在 Vite 项目中安装 vite-plugin-db，当 DATABASE_URL 缺失时，启动 vite dev 会自动触发数据库创建。

关键注意事项：

• 有效期：未认领的数据库将在 72 小时后过期。
• 持久化：如果需要永久保留，用户需访问返回的 claim_url 登录 Neon 账号进行认领。
• 连接类型：API 返回的是池化连接（Pooled），若进行 Prisma 迁移等操作，需移除主机名中的 -pooler 以使用直连。

下载和安装 #

下载 claimable-postgres 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要 #

暂无推荐