pinme-publisher

---
name: pinme-publisher
description: 使用Pinme工具发布静态网站到IPFS网络，通过ENS子域名提供永久、可验证的访问链接。无需DNS和服务器，一键部署前端项目。
license: MIT
compatibility: 需要安装Node.js和Pinme CLI工具
metadata:
  version: "1.0.0"
  author: "iFlow Team"
  tags: "ipfs static-site deployment web3 pinme"
allowed-tools: run-shell-command read-file ...

---
name: pinme-publisher
description: 使用Pinme工具发布静态网站到IPFS网络，通过ENS子域名提供永久、可验证的访问链接。无需DNS和服务器，一键部署前端项目。
license: MIT
compatibility: 需要安装Node.js和Pinme CLI工具
metadata:
  version: "1.0.0"
  author: "iFlow Team"
  tags: "ipfs static-site deployment web3 pinme"
allowed-tools: run-shell-command read-file write-file
---

# Pinme静态网站发布技能

## 概述
本技能基于Glitter Protocol的Pinme工具，提供一键式静态网站部署到IPFS网络的功能。上传的文件将被固定到IPFS，内容哈希写入ENS子域名，通过eth.limo等网关提供服务。

## 使用场景
- 个人作品集网站部署
- 静态博客发布
- 前端项目演示
- 文档站点托管
- 永久性内容存档

## 前置要求
1. 安装Node.js环境
2. 全局安装Pinme工具：
   ```bash
   npm install -g pinme
   # 或
   yarn global add pinme
   ```

## 操作步骤

### 1. 环境检查
- 验证Node.js安装
- 检查Pinme CLI可用性
- 确认网络连接

### 2. 项目准备
根据项目类型进行配置：

#### Vite项目
在`vite.config.js`中添加：
```javascript
export default {
  base: "./",
  // 其他配置...
}
```

#### 其他构建工具
确保资源路径使用相对路径，避免绝对路径引用。

### 3. 内容发布
支持以下发布方式：

#### 交互式发布
```bash
pinme upload
```

#### 指定路径发布
```bash
pinme upload /path/to/dist
pinme upload ./index.html
```

#### 批量发布
支持单个文件或整个目录上传。

### 4. 访问管理
发布成功后获得：
- IPFS内容哈希
- ENS子域名访问链接
- 永久性访问地址

## 输入输出示例

### 输入参数
```json
{
  "path": "./dist",
  "type": "directory",
  "description": "要发布的静态网站目录"
}
```

### 输出结果
```json
{
  "success": true,
  "ipfs_hash": "bafybeifdwyoz66u5czbbjvmmais5fzrzrolxbyiydqsbrxessndt3s6zdi",
  "ens_url": "https://your-site.eth.limo/",
  "gateway_url": "https://ipfs.io/ipfs/bafybeifdwyoz66u5czbbjvmmais5fzrzrolxbyiydqsbrxessndt3s6zdi",
  "size": "15.2MB",
  "files_count": 42
}
```

## 限制说明
- 单个文件大小限制：20MB
- 目录总大小限制：500MB
- 上传历史记录存储在`~/.pinme/`

## 管理功能

### 查看发布历史
```bash
pinme list
pinme ls -l 5  # 显示最近5条记录
```

### 移除内容
```bash
pinme rm bafybeifdwyoz66u5czbbjvmmais5fzrzrolxbyiydqsbrxessndt3s6zdi
```

### 清理历史
```bash
pinme list -c  # 清空所有历史记录
```

## 最佳实践
1. **优化文件大小**：压缩图片资源，移除无用文件
2. **使用相对路径**：确保所有资源引用使用相对路径
3. **测试本地访问**：发布前确保本地构建正常
4. **备份重要内容**：虽然IPFS提供持久性，但建议保留源文件
5. **定期维护**：清理不需要的历史发布记录

## 常见问题处理

### 上传失败
- 检查网络连接
- 验证文件大小是否超限
- 确认Pinme工具正确安装

### 访问异常
- 等待IPFS网络同步（通常几分钟）
- 检查ENS域名解析
- 尝试不同的IPFS网关

### 构建问题
- 确保构建输出使用相对路径
- 检查资源文件完整性
- 验证HTML文件引用正确性

## 相关工具
- Pinme发布脚本：见 `scripts/pinme_publisher.py`
- 配置模板：见 `assets/config-template.json`
- 项目构建示例：见 `examples/`

## 技术支持
- GitHub Issues: https://github.com/glitternetwork/pinme/issues
- 邮箱: pinme@glitterprotocol.io
- 官方网站: https://pinme.eth.limo/