Pi 安裝指南

Pi 是專為 AI 輔助程式開發設計的智慧平台，提供強大的推理能力和多模型支援，完整整合 Superpowers 技能系統。

平台特色

Pi 作為新興的 AI 開發平台，提供：

• 🧠 強大推理：先進的推理和問題解決能力
• 🤖 多模型支援：Claude、GPT-4、本地模型等
• 🔧 工具整合：豐富的工具和擴充生態
• 🛠️ 開發工具：完整的開發環境和 CI/CD
• 📚 Superpowers 支援：原生技能生態系統整合

系統需求

硬體需求

• 處理器：x64_64 或 ARM64 架構
• 記憶體：至少 8 GB RAM（建議 16 GB 以上）
• 硬碟空間：至少 2 GB 可用空間

軟體需求

• 作業系統：
  • Windows 10/11（x64）with WSL2
  • macOS 11+ (Big Sur 或更高版本)
  • Ubuntu 20.04+、Debian 11+、Fedora 35+
• 容器：Docker 或 Podman
• 網路：穩定的網際網路連線

安裝步驟

使用 Docker 安裝（推薦）

# 第 1 步：安裝 Docker
# Windows：安裝 Docker Desktop
# macOS：安裝 Docker Desktop
# Linux：curl -fsSL https://get.docker.com | sh

# 第 2 步：拉取 Pi 映像
docker pull pi-ai/latest

# 第 3 步：啟動 Pi 容器
docker run -d \
  --name pi \
  -p 8080:8080 \
  -v $(pwd):/workspace \
  -e PI_API_KEY="your-api-key" \
  pi-ai/latest

# 第 4 步：訪問 Web 介面
# 開啟瀏覽器訪問 http://localhost:8080

使用 CLI 安裝

# 第 1 步：下載 CLI 工具
# 訪問 https://pi.ai/install
# 下載適合您平台的版本

# 第 2 步：安裝 CLI
# macOS/Linux
chmod +x pi-installer
sudo ./pi-installer

# Windows
pi-installer.exe

# 第 3 步：驗證安裝
pi --version

# 第 4 步：初始化
pi init

配置設定

基礎配置

# 建立 Pi 配置目錄
mkdir -p ~/.pi

# 建立配置檔案
cat > ~/.pi/config.json << 'EOF
{
  "platform": {
    "defaultModel": "claude-fable-5",
    "fallbackModel": "claude-opus-4-8"
  },
  "workspace": {
    "defaultPath": "./workspace",
    "autoSave": true
  },
  "superpowers": {
    "enabled": true,
    "skillsPath": "~/.superpowers/skills",
    "autoLoad": true
  }
}
EOF

API 金鑰設定

# 設定 API 金鑰
export PI_API_KEY="your-api-key"

# 或在配置檔案中設定
{
  "api": {
    "provider": "anthropic",
    "apiKey": "your-api-key",
    "baseURL": "https://api.anthropic.com"
  }
}

專案配置

# 在專案根目錄建立 .pi 目錄
mkdir -p .pi

# 建立專案配置
cat > .pi/config.json << 'EOF'
{
  "project": {
    "name": "my-project",
    "type": "web-app"
  },
  "ai": {
    "contextFiles": ["README.md", "CLAUDE.md"],
    "ignorePatterns": ["node_modules", "dist", ".git"]
  },
  "superpowers": {
    "primarySkill": "test-driven-development",
    "autoSkills": ["verification-before-completion"],
    "contextLanguage": "zh-TW"
  }
}
EOF

使用方式

Web 介面使用

# 啟動 Pi 服務
pi start

# 開啟瀏覽器
# http://localhost:8080

# 使用 Superpowers 技能
# 在 Chat 介面中輸入：
使用 brainstorming skill 探索新功能設計

CLI 使用

# 啟動 CLI 模式
pi chat

# 使用技能
pi skill brainstorming "探索微服務架構"

# 批次處理
pi batch src/**/*.ts --skill test-driven-development

# 分析專案
pi analyze --skill systematic-debugging

IDE 整合

# 安裝 VSCode 擴展
code --install-extension pi-ai.pi

# 在 VSCode 中使用
# 按 Ctrl+Shift+P 開啟指令面板
# 搜尋 "Pi: Run Skill"

Superpowers 整合

技能使用

# 列出可用技能
pi skills list

# 使用特定技能
pi skill brainstorming "探索 API 設計"

# 組合多個技能
pi skills chain "writing-plans -> test-driven-development -> verification"

# 查看技能詳情
pi skills info brainstorming

自訂技能

# 建立自訂技能目錄
mkdir -p ~/.superpowers/skills/my-skills

# 建立技能定義
cat > ~/.superpowers/skills/my-skills/my-workflow.md << 'EOF'
---
name: my-workflow
description: 我的專屬工作流程
---

## 使用時機
當需要處理特定類型的任務時

## 執行步驟
1. 分析需求
2. 制定計畫
3. 執行實作
4. 驗證結果
EOF

# 重新載入技能
pi skills reload

開發流程整合

Git Hooks 整合

# 建立 git hooks
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
# Pi 自動執行驗證
pi verify --skill verification-before-completion --staged

if [ $? -ne 0 ]; then
  echo "驗證失敗，提交中止"
  exit 1
fi
EOF

chmod +x .git/hooks/pre-commit

CI/CD 整合

# GitHub Actions 整合
# .github/workflows/pi-review.yml

name: Pi Superpowers Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    container:
      image: pi-ai/cli:latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Run Superpowers Review
        env:
          PI_API_KEY: ${{ secrets.PI_API_KEY }}
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          pi review --skill requesting-code-review \
            --diff origin/main...HEAD \
            --output review-report.md
            
      - name: Upload Review
        uses: actions/upload-artifact@v2
        with:
          name: review-report
          path: review-report.md

Docker 深度整合

Docker Compose 配置

# docker-compose.yml
version: '3.8'

services:
  pi:
    image: pi-ai/latest
    container_name: pi-server
    ports:
      - "8080:8080"
      - "8081:8081"
    volumes:
      - ./workspace:/workspace
      - ~/.pi:/root/.pi
      - ~/.superpowers:/root/.superpowers
    environment:
      - PI_API_KEY=${PI_API_KEY}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - SUPERPOWERS_ENABLED=true
    restart: unless-stopped

  workspace:
    image: node:18
    container_name: dev-environment
    volumes:
      - ./workspace:/workspace
    working_dir: /workspace
    command: sleep infinity

開發容器

# 啟動開發環境
docker-compose up -d

# 進入開發容器
docker exec -it dev-environment bash

# 在容器中使用 Pi
pi chat
pi skill brainstorming "探索新功能"

常見問題

安裝問題

Q1: Docker 映像拉取失敗

A:

# 檢查 Docker 網路
docker info

# 使用鏡像加速器
# 在 Docker Desktop 中設定中國大陸鏡像站

# 或手動拉取
docker pull pi-ai/latest --platform linux/x64_64

Q2: CLI 安裝失敗

A:

# 檢查權限
chmod +x pi-installer

# 使用 sudo 安裝
sudo ./pi-installer

# 檢查系統需求
pi --check-requirements

Q3: Web 介面無法開啟

A:

# 檢查容器狀態
docker ps -a | grep pi

# 檢查日誌
docker logs pi-server

# 重啟容器
docker restart pi-server

配置問題

Q4: API 金鑰無效

A:

# 驗證 API 金鑰格式
echo $PI_API_KEY | grep -E "^sk-"

# 重新設定金鑰
pi config set api.key YOUR_API_KEY

# 驗證設定
pi config get api.key

Q5: 技能無法載入

A:

# 檢查技能路徑
pi config get skills.path

# 重新載入技能
pi skills reload

# 檢查技能檔案
ls -la ~/.superpowers/skills/

使用問題

Q6: 回應品質不佳

A:

// 調整模型參數
{
  "ai.temperature": 0.3,
  "ai.topP": 0.9,
  "ai.maxTokens": 50000
}

// 使用較小的模型
{
  "platform.defaultModel": "claude-opus-4-8"
}

Q7: 工作區同步問題

A:

# 檢查 volume 掛載
docker inspect pi-server | grep Mounts

# 手動同步檔案
docker cp src/main.ts pi-server:/workspace/

# 重啟容器
docker restart pi-server

效能優化

資源限制

# Docker Compose 限制資源
services:
  pi:
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G
        reservations:
          cpus: '0.5'
          memory: 2G

快取策略

# 啟用快取
{
  "cache.enabled": true,
  "cache.location": ".pi/cache",
  "cache.maxSize": 1000
}

並行處理

# 調整並行設定
{
  "parallel.enabled": true,
  "parallel.maxWorkers": 4
}

資源連結

官方資源

• 官方網站：https://pi.ai
• 文件中心：https://docs.pi.ai
• GitHub：https://github.com/pi-ai/pi
• Discord：https://discord.gg/pi-ai

學習資源

• 教程：https://pi.ai/tutorials
• API 文件：https://docs.pi.ai/api
• 範例：https://github.com/pi-ai/examples

社群資源

• 論壇：https://community.pi.ai
• 部落格：https://blog.pi.ai
• Twitter：https://twitter.com/pi_ai

下一步

安裝完成後，建議：

1. 驗證安裝：測試 CLI 和 Web 介面
2. 配置 API：設定必要的 API 金鑰
3. 安裝 Superpowers：安裝並配置技能系統
4. 建立專案：建立新專案並配置 Pi
5. 探索功能：嘗試 AI 聊天和技能使用

開始使用 Pi 和 Superpowers，體驗新一代 AI 開發平台的強大能力！