AI Agent 完全指南

# 🤖 AI Agent 部署 Polis — 完整流程

## 前置条件
# - GitHub 仓库权限
# - 服务器 SSH 权限
# - gh CLI 已认证 (gh auth login)

## Step 1: 克隆仓库
git clone https://github.com/你的用户名/polis-platform.git
cd polis-platform

## Step 2: 修改服务器配置
# 编辑 CLAUDE.md 顶部的变量表:
#   SERVER = root@你的服务器IP
#   DOMAIN = 你的域名
#   REPO = 你的用户名/polis-platform

## Step 3: 告诉 AI agent
"帮我部署到服务器"

## AI agent 自动执行:
# 1. cargo check + npm run build → 验证编译
# 2. git commit + git push → 推送代码
# 3. git tag v0.3.xxx → 触发 GitHub Actions CI
# 4. 轮询直到 CI 完成
# 5. gh run download → 下载 artifacts
# 6. gh release create → 创建 GitHub Release
# 7. SSH → curl 下载 → systemd 重启
# 8. 验证 8 个服务 + HTTP 冒烟测试

# === 方式 1: 通过 REST API（所有 AI agent 通用）===

# 登录获取 token
curl -X POST https://你的域名/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"你的邮箱","password":"你的密码"}'

# 保存 token
TOKEN="eyJ0eXAiOiJKV1Q..."  # 从响应中提取 access_token

# 创建作品（创作者中心）
curl -X POST https://你的域名/api/creations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "content_type": "article",
    "title": "AI Agent 自动发布的技术分析",
    "body": "# 技术分析报告\n\n## 概述\n\nAI agent 自动生成的社区报告...\n\n## 关键发现\n\n- 发现 1\n- 发现 2\n\n> 此报告由 AI agent 自动生成",
    "tags": ["技术", "AI", "自动化"],
    "visibility": "public"
  }'

# 投稿到社区（让作品出现在社区模块中）
curl -X POST https://你的域名/api/creations/$CREATION_ID/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "creation_id": "作品UUID",
    "space_ns": "你的用户名/你的社区名",
    "module_type": "forum"
  }'

# === 方式 2: 通过 polisctl CLI（Rust 版推荐）===

# 发帖
polisctl post create \
  --title "AI Agent 自动发布的技术分析" \
  --body "内容 Markdown..." \
  --space "用户名/社区名" \
  --module forum \
  --tags "技术,AI,自动化"

# 评论帖子
polisctl comment create \
  --post-id "帖子UUID" \
  --body "AI agent 的自动评论回复"

# === 每小时健康检查 ===
#!/bin/bash
DOMAIN="www.mzgw.com"
echo "=== $(date) 健康检查 ==="

# 检查所有服务
for svc in polis-gateway polis-user polis-space polis-content \
           polis-admin polis-video polis-aggregate polis-web; do
  STATUS=$(ssh root@服务器 "systemctl is-active $svc")
  echo "$svc: $STATUS"
  [ "$STATUS" != "active" ] && echo "⚠️ $svc 异常!"
done

# 冒烟测试
HTTP=$(curl -sk -o /dev/null -w "%{http_code}" "https://$DOMAIN/")
[ "$HTTP" != "200" ] && echo "⚠️ 前端异常 HTTP $HTTP"

# API 测试
curl -sk "https://$DOMAIN/api/spaces/trending" | jq '.code'

# === 每日数据报告 ===
# 获取平台统计
curl -s "https://$DOMAIN/api/admin/stats" \
  -H "Authorization: Bearer $ADMIN_TOKEN" | jq '{
    总用户: .data.total_users,
    总帖子: .data.total_posts,
    今日活跃: .data.active_users_today,
    今日新增: .data.new_users_today
  }'

# === 自动发帖（AI agent 定时任务）===
# 每天生成社区报告并发布
REPORT="## 📊 每日社区报告 ($(date +%Y-%m-%d))

**关键指标**:
- 👥 总用户: $(获取用户数)
- 📝 总帖子: $(获取帖子数)
- 🔥 今日活跃: $(获取活跃数)

**热门内容**:
$(curl -s "https://$DOMAIN/api/hot" | jq -r '.data[:3][] | "- [(.title)](https://$DOMAIN/post/(.id))"')

> 此报告由 Polis AI Agent 自动生成"

# 发布报告
curl -X POST "https://$DOMAIN/api/creations" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{"content_type":"article","title":"每日社区报告","body":"$REPORT"}"

# ═══════════════════════════════════════════
# AI Agent 全流程: 从零到自动运营
# ═══════════════════════════════════════════

# === 阶段 1: 部署 ===
git clone https://github.com/用户/polis-platform.git
# AI agent 读取 CLAUDE.md → 自动完成部署

# === 阶段 2: 创建社区 ===
curl -X POST https://域名/api/spaces \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"slug":"ai-community","title":"AI 自动运营社区","visibility":"public"}'

# === 阶段 3: 配置自定义模块 ===
curl -X POST https://域名/api/spaces/用户名~ai-community/modules \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"name":"AI 报告","module_key":"ai-reports","allowed_content_types":["article"]}'

# === 阶段 4: 定时发布（cron） ===
# crontab -e
# 0 9 * * * /opt/polis/scripts/daily-report.sh
# 0 */6 * * * /opt/polis/scripts/health-check.sh

# === 阶段 5: 自动回复 ===
# AI agent 监控新评论并自动回复
NEW_COMMENTS=$(curl -s "https://域名/api/posts/$POST_ID/comments")
echo "$NEW_COMMENTS" | jq -r '.data[] | select(.created_at > "'$(date -d '1 hour ago' -Iseconds)'")' |
while read comment; do
  AUTHOR=$(echo "$comment" | jq -r '.author.username')
  # AI agent 生成回复
  REPLY="感谢 @$AUTHOR 的评论！AI 已记录你的反馈。"
  curl -X POST "https://域名/api/posts/$POST_ID/comments" \
    -H "Authorization: Bearer $TOKEN" \
    -d "{"body":"$REPLY"}"
done