● 社区
glitternetwork
⚡ 即开即用
pinme
作者 glitternetwork · glitternetwork/pinme
无需配置,通过一条 CLI 命令即可将前端部署到 IPFS —— Claude 运行 pinme upload dist,返回预览链接。
PinMe 是一个 CLI + Claude Skill,可以一条命令将静态网站(dist/build/out/public)部署到 IPFS,无需账户或服务器。该 Skill 内置 AI Execution Protocol,让 Claude 精确知道如何验证 Node、安装 CLI、检测构建文件夹、并返回预览链接给用户。
为什么要用
核心特性
- 一条命令部署到 IPFS —— 无需账户,无需服务器配置
- 自动检测构建输出文件夹(dist/、build/、out/、public/)
- Skill 中包含 AI Execution Protocol:验证 Node → 安装 → 检测文件夹 → 部署 → 返回 URL
- 立即返回可分享的预览链接
- 支持任何静态网站生成器(Vite、Next export、Astro、SvelteKit static 等)
使用场景
实战用法: pinme
何时使用: 想共享预览但不想配置 Vercel/Netlify,只需要一个原始链接。
前置条件
- 已安装 Node.js — node >= 18 —— Skill 会验证
- 已构建的静态网站 — 运行框架的构建命令(如 npm run build)
步骤
-
请求 Claude 部署
构建这个 Astro 网站并通过 pinme 部署它。✓ 已复制
→ Claude 运行构建,检测 dist/,安装 pinme(如果缺失),运行上传
-
获取链接
→ 预览链接在聊天中返回
结果: 一个可分享的 IPFS 托管预览。
注意事项
- 检测到错误的文件夹(例如同时存在 dist/ 和 build/) — 明确告诉 Claude:'upload from build/'
- IPFS 网关首次加载缓慢 — 这是预期的 —— 后续加载会被缓存
何时使用: 你在迭代原型,并希望每个版本都可链接。
步骤
-
每次更改后构建和部署
每次我说'ship',就重新构建并通过 pinme 上传,然后发布链接。✓ 已复制
→ Claude 形成构建 → 部署 → 链接的节奏
结果: 可链接的迭代预览历史。
注意事项
- 每次部署 IPFS CID 都会改变(预期) — 如果想要稳定的 URL,使用 ENS 或 DNSLink
组合
与其他 MCP 搭配,撬动十倍杠杆
Claude 编写或编辑网站,然后通过 pinme 部署,无需离开会话
编辑 hero 文案,重新构建,然后 pinme upload dist —— 给我新的链接。✓ 已复制
提交更改并一次性发布预览链接
在分支上提交更改,通过 pinme 部署,并将预览链接放在 PR 描述中。✓ 已复制
成本与限制
运行它的成本
- API 配额
- PinMe 免费层有使用限制;查看 pinme.eth 了解当前限制
- 每次调用 Token 数
- 微不足道 —— Skill 很小
- 费用
- 提供免费层;更大/更持久的固定有付费层
- 提示
- 让测试预览过期;只长期固定生产 URL。
安全
权限、密钥、影响范围
凭据存储: 匿名上传无需凭据。固定持久化可选账户密钥。
数据出站: 上传的包发送到 IPFS —— 公开设计。永远不要上传密钥、.env 文件或非公开资源。
- IPFS 内容是公开的 —— 上传文件夹中的任何内容都是全球可读的。
故障排查
常见错误与修复
pinme: command not found
Skill 应该会安装它;如果被阻止,请手动运行 npm i -g pinme。
验证: pinme --version
上传卡住
检查网络;某些企业防火墙可能会阻止 IPFS bootstrap 节点。
上传了错误的文件夹
传递明确的路径:pinme upload ./dist 而不是依赖自动检测。
替代方案
pinme 对比其他方案
| 替代方案 | 何时用它替代 | 权衡 |
| Vercel / Netlify | 想要自定义域名、无服务器函数或 CI 集成 | 功能更多,需要账户和配置 |
| GitHub Pages | 你的代码在 GitHub 上,并想要一个稳定的 github.io 链接 | 与仓库绑定;部署循环较慢 |