名称： pinme
描述： |
通过 PinMe CLI 一键将静态网站部署到 IPFS。
使用场景：(1) 用户希望部署已构建的前端项目；(2) 需要将静态文件（dist/build/out/public）上传到 IPFS；(3) 请求获取已部署站点的预览链接。
支持：Vite、React、Vue、Next.js、Angular、Create React App 及静态站点。
输出：上传成功后返回预览链接 (https://pinme.eth.limo/#/preview/*)。

PinMe - 零配置前端部署

一键将静态网站部署到 IPFS 网络。无需服务器、无需账户、无需配置。

使用场景

在以下情况使用此技能：
- 用户要求“部署”、“上传”或“发布”前端项目
- 用户希望获取已构建站点的预览链接
- 用户提及 PinMe 或 IPFS 部署
- 项目已生成静态文件（dist/、build/、out/、public/）

快速开始

# 安装 PinMe
npm install -g pinme

# 部署（自动检测静态目录）
pinme upload dist

# 获取预览链接
# https://pinme.eth.limo/#/preview/*

核心工作流程

1. 检查前提条件

# 检查 Node.js 版本（要求 16.13.0+）
node --version

# 验证 pinme 是否已安装
pinme --version

2. 识别静态目录

PinMe 按优先级自动检测目录：

验证规则：
- ✅ 文件夹必须存在
- ✅ 必须包含 index.html
- ✅ 必须有实际的静态文件（CSS、JS、图片等）

3. 执行部署

# 部署 dist 目录（最常见）
pinme upload dist

# 部署指定目录
pinme upload build

# 上传并绑定自定义域名（需要 Plus 版本）
pinme upload dist --domain my-site

4. 返回结果

仅返回预览链接：https://pinme.eth.limo/#/preview/*

命令参考

上传限制

错误处理

AI 执行协议

用于程序化部署：

1. 检查环境：node --version（需要 >=16.13.0）
2. 按需安装：npm install -g pinme
3. 检测目录：检查 dist/、build/、out/、public/
4. 验证：必须包含 index.html
5. 执行：pinme upload <directory>
6. 返回：仅返回预览链接

禁止操作：
- ❌ 上传 node_modules、.env、.git
- ❌ 上传源码目录（src/）
- ❌ 上传配置文件（package.json 等）
- ❌ 上传不存在或空的文件夹

GitHub Actions 集成

示例工作流：

名称： 部署到 PinMe
on: [push]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '18'
      - run: npm ci && npm run build
      - run: npm install -g pinme
      - run: pinme set-appkey "${{ secrets.PINME_APPKEY }}"
      - run: pinme upload dist --domain "${{ secrets.DOMAIN }}"

机器可读配置

{
  "tool": "pinme",
  "requirements": {
    "node_version": ">=16.13.0"
  },
  "install": "npm install -g pinme",
  "upload": "pinme upload {{directory}}",
  "upload_with_domain": "pinme upload {{directory}} --domain {{domain}}",
  "validDirectories": ["dist", "build", "out", "public"],
  "requiredFiles": ["index.html"],
  "excludePatterns": ["node_modules", ".env", ".git", "src"],
  "limits": {
    "single_file": "200MB",
    "total_directory": "1GB"
  },
  "output": "preview_url",
  "preview_url_format": "https://pinme.eth.limo/#/preview/*",
  "fixed_domain_format": "https://*.pinit.eth.limo"
}

资源

• 官网： https://pinme.eth.limo/
• GitHub： https://github.com/glitternetwork/pinme
• AppKey： https://pinme.eth.limo/（从仪表板获取）