ShipAny Docs

快速开始

Agent 方式(推荐)

ShipAny vinext 是 agent-native 的:用 Claude Code 打开仓库,运行内置的 /quick-start skill,给一段产品简介即可——env 配置、数据库初始化、Landing Page、Dashboard 页面、模块接线全部由它完成。

/quick-start <要做什么 —— 产品简介、参考站 URL、内容来源,可任意组合>

示例:

/quick-start 做一个 AI 写作工具叫 WriteAI,参考 jasper.ai 的网站风格,内容参考 https://github.com/xxx/yyy 的 README
/quick-start 参考 linear.app 做一个项目管理工具
/quick-start 做一个 AI 壁纸生成器,叫 WallpaperAI,按月订阅

准备上线时,运行 /deploy-cloudflare ——一条命令从本地代码到线上 Workers URL。

手动初始化

前置要求:Node.js 22+pnpm 10(暂不支持 pnpm 11)。

安装依赖
pnpm install
配置环境变量
cp .env.example .env.development

启动只需要五个变量:

.env.development
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_APP_NAME=My App
DATABASE_PROVIDER=sqlite
DATABASE_URL=file:data/local.db
# 生成方式:openssl rand -base64 32
AUTH_SECRET=
初始化数据库
pnpm db:push

本地开发使用 SQLite/PostgreSQL/MySQL;Workers 生产环境使用 D1 或经 Hyperdrive 的 Postgres(由部署 skill 自动处理)。

初始化 RBAC 与管理员账号
pnpm rbac:init --admin-email=admin@example.com --admin-password=your-password
启动开发服务器
pnpm dev

打开 http://localhost:3000,登录后访问 /admin

常用命令

命令作用
pnpm dev / pnpm build开发服务器 / 生产构建(Vite)
pnpm db:setupDATABASE_PROVIDER 复制 schema 模板
pnpm db:push推送 schema 到数据库(开发环境)
pnpm db:generate / pnpm db:migrate生成 / 执行 SQL 迁移(生产环境)
pnpm db:studioDrizzle Studio 图形界面
pnpm rbac:init / pnpm rbac:assign初始化角色与权限 / 分配角色
pnpm run deploy部署到 Cloudflare Workers(也可直接用 /deploy-cloudflare)