PinMe：零配置全栈项目部署 CLI 的功能与使用边界

工具定位

PinMe 是一个面向全栈项目的零配置部署 CLI，提供集成前端、Worker 后端与数据库的项目模式，也提供不涉及项目流程的静态上传路径。README 还给出了供 AI Agent 使用的项目模式协议与上传回退流程。

环境与安装

需要 Node.js >= 16.13.0，通过 npm 全局安装后可查看版本确认。在 Agent 工作流中使用前，README 要求先安装 PinMe skill。

项目工作流

pinme create <name> 不只是生成文件：它要求已登录，先在平台侧创建项目资源，再拉取官方模板、写入 pinme.toml 与前后端配置、安装依赖、构建并上传 Worker 代码与 SQL，最后构建前端并尝试首次上传。目标目录已存在时，除非加 --force，否则会先询问是否覆盖。

pinme save 需在含 pinme.toml 的项目根目录运行，执行完整部署：安装依赖、构建并上传 Worker、上传 db/ 下的 SQL、构建并上传 frontend/dist，可选绑定域名。只改一层时可用 update-worker、update-db、update-web 分别处理；delete 删除平台侧 Worker、域名绑定和 D1 数据库，不影响本地文件。

静态上传与 IPFS

pinme upload <路径> 可将文件或目录上传到 IPFS；域名中含点的按 DNS 域名处理，不含点的按 PinMe 子域名处理，--dns 可强制 DNS 模式。另有 bind 上传并绑定域名、import/export 处理 CAR 文件、rm 删除已上传内容。认证可用浏览器登录或 set-appkey，后者适用于自动化场景。

限制与注意事项

单文件上传默认上限 100MB，目录默认上限 500MB，可由环境变量覆盖；update-db 每次 SQL 总载荷上限 10MB。上传、导入与项目命令需要认证，域名绑定需要钱包余额。save 与各 update-* 命令必须在含 pinme.toml 的项目根目录执行。Agent 使用说明还要求不要上传源码目录、依赖目录或敏感配置文件。

测试

项目使用 Vitest 做单元与集成测试，并包含真实 CLI 冒烟测试、npm 包检查与 Stryker 变异测试；测试不得调用线上的 PinMe、IPFS 或 CAR 服务。