PinMe(固定我)
一行命令部署你的前端或全栈应用,零配置。
证据显示明确的部署流程和do not upload列表,但权限和确认机制仅依赖CLI登录,缺少对敏感数据处理的詳細说明。扣分:权限最小化不明确,没有回滚方案。
有CI测试覆盖部分命令成功路径,但静态审查无法验证实际执行。扣分:测试覆盖不完整,异常处理细节不足。
技能描述清晰,提供决策图和非适用范围,但环境适配有限,尤其是对中国大陆网络的访问依赖问题不明确。扣分:边界界定和触发条件证据不足。
文档结构清晰,包含命令参考和常见错误,但缺少版本变更记录和所有权信息。扣分:维护责任和更新路径不明确。
核心任务可实现,但静态审查无法验证输出直接可用性。扣分:缺乏可验证的部署结果。
有测试文件但覆盖不全面,且没有独立验证证据。扣分:第三方执行证据有限。
- 该技能依赖外部服务(IPFS、Cloudflare),在中国大陆可能无法访问,建议明确提示用户。
- 上传前需确认用户意图,避免误上传敏感文件。
这个 Skill 能做什么,适合哪些场景?
PinMe 是一个零配置的部署工具,可通过 CLI 将静态文件上传至 IPFS,或创建并部署包含前端(React+Vite)、后端(Cloudflare Worker)和数据库(D1 SQLite)的全栈项目。该技能(skill)提供了详细的命令流程、项目结构和代码模式,指导代理在需要“固定”网页或需要后端支持时使用。它需要用户登录(通过 pinme login 或 AppKey),并依赖于 npm 安装的 pinme 命令。
该技能指导代理执行以下操作:1) 检查并更新 pinme CLI 至最新版本;2) 通过 pinme login 或 pinme set-appkey <AppKey> 进行身份验证;3) 路径1(上传文件/静态站点):确定构建产物目录(dist/build/out/public),运行 pinme upload <path> 上传,并返回最终 URL;4) 路径2(全栈项目):运行 pinme create <name> 创建项目,修改模板代码(Worker、前端、SQL),执行 pinme save 进行单命令部署,或使用 pinme update-worker、pinme update-web、pinme update-db 更新特定部分;5) 在 Worker 中实现 JSON API、数据库操作(D1)、文件存储(R2)和邮件发送(通过 PinMe API)。
- 用户需要快速部署一个静态网站或文件夹(如构建产物)到 IPFS,并获得一个可分享的预览 URL。
- 用户希望从零开始创建一个全栈应用(React 前端 + Cloudflare Worker 后端 + D1 数据库),通过单条命令完成部署。
- 开发者已有一个 PinMe 项目,只修改了后端代码,需要使用 `pinme update-worker` 快速更新 Worker 而不重新部署前端。
- 项目需要数据库迁移,可以使用 `pinme update-db` 推送 SQL 迁移文件。
- 后端需要发送电子邮件,支持通过 PinMe API 集成邮件发送功能。
这个 Skill 有哪些优点和局限?
- 零配置,单命令部署全栈应用,无需手动配置云计算资源。
- 支持 IPFS 静态托管,免费且去中心化。
- 提供完整的项目模板(React+Vite+Worker+D1),并指导如何修改。
- 提供增量更新命令(update-worker、update-web、update-db),节省部署时间。
- 需要用户登录或 AppKey,可能不适用于完全自动化的无人值守场景。
- 对静态上传有大小限制(默认单文件 100MB,目录 500MB),并可能受网络影响。
- 文档中未提到测试套件或明确的支持保证,对于生产环境可能不够透明。
- 特定于 PinMe 平台,如果用户希望使用其他部署平台,则不适用。
如何安装这个 Skill?
该技能位于 monorepo 仓库 glitternetwork/pinme 中。安装整个技能集合:npx skills add glitternetwork/pinme。确保 Node.js >= 16.13.0,并全局安装 CLI:npm install -g pinme。
如何使用这个 Skill?
在支持 Agent Skills 的客户端(如 Claude Code)中,通过提示词触发,例如:“使用 pinme 部署我的前端”或“创建一个全栈项目”。对于静态文件:运行 pinme login(或 pinme set-appkey <AppKey>),然后执行 pinme upload <dist|build|out|public>,并返回打印的 URL。对于全栈项目:运行 pinme login,pinme create my-app,修改模板代码,然后从项目根目录运行 pinme save。确保返回完整的预览 URL(包括所有哈希字符)。
这个 Skill 与同类方案有什么区别?
该技能隐含与 Netlify、Vercel 等平台部署工具可比,但未明确提及。鉴于其重点在于 IPFS 和 Cloudflare Worker,它可能更适合去中心化部署场景。