用 pinme CLI 一条龙部署前端、Worker 和数据库

部署一个小型全栈项目，通常意味着拼装一个托管平台、一个 Serverless 函数服务和一个数据库，再为每一层写胶水配置。pinme 是一个零配置部署 CLI，把三层——前端、Worker 后端、数据库——收进少数几条命令背后，还附带官方 skill，让编码 agent 能替你驱动整条流程。

为什么这个 Skill 重要

项目工作流覆盖的不只是静态页面：pinme create 会先在平台侧开通 Worker 和数据库资源，下载官方项目模板，把配置写入 pinme.toml，并尝试首次部署。此后 pinme save 部署全部层，定向命令只重建你改过的那一块。静态上传路径覆盖另一种情况——发布一个已构建好的 dist/ 目录，不碰项目脚手架。

README 还为 agent 写下了带护栏的协议：skill 会告诉你的编码 agent 哪条命令适配哪个任务，以及什么东西永远不该上传。

安装

安装 CLI（需要 Node.js 16.13.0 或更新版本）：

npm install -g pinme

在 agent 工作流中使用时，按 README 的指引先安装 PinMe skill：

npx skills add glitternetwork/pinme

实战：启动并迭代一个全栈项目

1. 认证、生成脚手架、部署：

npm install -g pinme
pinme login
pinme create my-app
cd my-app
pinme save

2. create 不只是生成文件：它先创建平台侧项目资源，安装工作区依赖，构建 Worker，上传 Worker 代码和 SQL 文件，然后构建前端并尝试首次上传。CLI 会打印项目管理 URL。
3. 只改了前端？跳过全量部署：

pinme update-web

另外两条是 update-worker（Worker 代码）和 update-db（db/ 里的 SQL 迁移）。 4. 部署时绑定域名：

pinme save --domain my-site

5. 纯静态构建可以完全跳过项目流程：先 pinme login，再 pinme upload dist。README 的静态上传流程依次检查 dist/、build/、out/、public/，并为上传写明了域名规则：包含点号的名称按 DNS 域名处理，不带点号的名称则成为 PinMe 子域名。

技巧

• 上传前先了解文档写明的限额：单文件 100MB、目录上传 500MB 是默认值（均可通过环境变量覆盖），update-db 则强制每次 SQL 总量不超过 10MB。
• 自动化场景可以用 pinme set-appkey <AppKey> 代替交互式浏览器登录。
• 域名绑定需要钱包余额——先跑 pinme wallet-balance 查一下。
• README 里给 agent 的护栏值得抄进自己的习惯：永远不要上传 src/ 这类源码目录，也不要上传 node_modules、.git 或 .env。
• pinme delete my-app 删除平台侧的 Worker、域名绑定和 D1 数据库；本地文件不受影响。

何时不用这个 Skill

项目模板是有文档支撑的后端托管路径——README 的护栏明确要求 agent 不要在该流程之外声称提供后端托管。如果你已经跑在主流 PaaS 上，或者只想要把静态文件传到 IPFS 侧（CLI 也支持，包括 CAR 导入导出），先权衡一下是否值得搭 PinMe 的项目结构。

查看 排行榜 了解更多 skill。