miantiao-me/aigc-weekly · 上手攻略

• 仓库：miantiao-me/aigc-weekly
• 链接：https://github.com/miantiao-me/aigc-weekly
• 分类：academic-writing
• 作者：Tom
• 更新：2026-08-16

这是什么

aigc-weekly（Agili AIGC 周刊）是一个由 Agentic AI Agent 驱动的 AIGC 精选周刊系统——用最新的 AI 和 Serverless 技术，自动从互联网上发现、筛选、编辑 AIGC 相关资讯（工具、资源、论文），并通过 Next.js 前端呈现给读者。

换句话说，这是一个用 AI Agent 跑 Newsletter 的完整技术栈，包含：负责策展的 OpenCode Agent、负责内容管理的 Payload CMS、负责边缘部署的 Cloudflare 全家桶（Workers + D1 + R2 + Containers）。

周刊在线阅读地址：https://aigc-weekly.agi.li
RSS 订阅：https://aigc-weekly.agi.li/rss.xml

解决什么问题

快速安装

环境要求

• Node.js：v22 或更高版本
• pnpm：v10 或更高版本
• Docker：用于本地运行 Cloudflare Worker 沙箱（可选，本地开发需要）
• Cloudflare 账号：用于 D1（数据库）、R2（对象存储）、Workers（边缘运行时）部署
• Firecrawl 账号：用于网页爬取与信息提取（需在 firecrawl.link 注册获取 API Key）

安装步骤

# 1. 克隆仓库
git clone https://github.com/miantiao-me/aigc-weekly.git
cd aigc-weekly

# 2. 安装依赖
pnpm install

# 3. 配置环境变量
cp .env.example .env.local
# 编辑 .env.local，填写必要变量

cp worker/.env.example worker/.env.local
# 编辑 worker/.env.local，填写 FIRECRAWL_API_KEY 等

# 4. 在 wrangler.jsonc 中配置 Cloudflare 绑定
# - D1：数据库
# - R2：对象存储
# - PAYLOAD_SECRET：一个安全的随机字符串

# 5. 生成类型
pnpm generate:types

# 6. 配置 MCP 和 Agent（可选，修改 agent/.opencode/ 目录）
# 编辑 agent/opencode.json 配置 MCP Server 和模型

# 7. 本地开发
pnpm dev              # Next.js 应用：访问 http://localhost:3000 和 http://localhost:3000/admin
pnpm dev:worker      # Cloudflare Worker（包含 Agent）：需要 Docker

⚠️ 注意：Worker 本地开发需要安装 Docker 以运行本地沙箱，Agent 容器会自动启动。

部署

# 部署数据库和 Next.js 应用
pnpm deploy
# 等价于：deploy:database（迁移）+ deploy:app（OpenNext 构建与上传）

# 单独部署 Worker
pnpm deploy:worker

核心架构

项目包含三个主要组件：

Next.js 应用 (app/)
├── 面向读者的前端页面
└── Payload CMS 管理界面 (/admin)

OpenCode Agent (agent/)
└── 独立的 Agent 服务，运行在 Cloudflare Containers 上
└── 通过 MCP 协议读写 Payload CMS

Cloudflare Worker (worker/)
└── 转发请求到 Container
└── 控制 Agent 容器生命周期

技术栈详情（❓以下信息根据 README 整理，版本号建议以 package.json 为准）

Agent MCP 集成

Agent 使用 MCP（Model Context Protocol） 与 CMS 交互： - Agent 可以直接读取/写入 Payload CMS 中的周刊内容 - 在 agent/opencode.json 中配置 MCP Server 和模型 - 在 agent/.opencode/ 目录修改 Agent 的技能、子 Agent 和命令配置

项目目录结构

app/                   # Next.js 应用源代码
agent/                 # OpenCode Agent 配置和技能定义
worker/                # Cloudflare Worker 源代码
collections/            # Payload CMS 数据模型
migrations/            # 数据库迁移文件
public/                 # 静态资源
AGENTS.md               # AI 代码助手开发指南（含命令、代码风格）

典型适用场景

✅ 非常适合

• 技术 Newsletter 运营者：用 AI Agent 自动化策展，减少人工编辑时间
• AIGC 爱好者/研究者：构建自己的精选资讯流，支持 RSS 订阅
• Serverless 架构学习者：学习 Next.js + Payload CMS + Cloudflare 全家桶的整合实践
• MCP 协议应用学习者：参考 Agent 如何通过 MCP 与 CMS 交互

⚠️ 不适合

• 纯静态网站需求：如果不需要 Agent 自动策展，直接用 Next.js + Contentlayer 或 MDX 方案更简单
• 没有 Cloudflare 使用经验：生产部署需要理解 D1/R2/Workers/Containers 的配置和计费
• 预算敏感：Cloudflare Containers 需要付费套餐；本地 Docker 开发也需要一定资源

坑与注意

1. Cloudflare Containers 付费门槛：Agent 运行时需要 Cloudflare Containers，目前需要付费套餐才能在生产环境使用。不过项目支持本地 Docker 运行 OpenCode Agent 来绕过这个问题。

2. Firecrawl API 成本：Agent 依赖 Firecrawl 进行网页爬取，需要注册并配置 API Key。注意爬取量大会产生费用。

3. Payload CMS 管理界面：/admin 路径是 Payload CMS 管理面板，需要配置正确的 PAYLOAD_SECRET 和 Cloudflare D1 绑定才能正常工作。

4. RSS 订阅功能：README 提到支持 RSS（/rss.xml），如果需要此功能，需确认 Payload CMS 配置了对应的 RSS 生成逻辑。

5. ❓ Cloudflare D1 全球复制延迟：D1 是边缘分布的 SQLite，读取极快，但写入复制到全球节点可能有秒级延迟。如果周刊内容更新后 RSS 未同步，稍等片刻即可。

6. Agent 技能自定义：编辑 agent/.opencode/ 目录可以调整 Agent 的行为（子 Agent 数量、策展标准等），但目前没有详细的配置文档，需要通过阅读源码理解。

7. 项目仍在活跃开发：建议关注 Releases 获取更新，升级前注意备份数据库。

与同类对比

aigc-weekly 的差异化在于：用 Agentic AI 做策展 + MCP 协议连接 CMS + Cloudflare 边缘分发，是 Newsletter 运营在 AI 时代的一个端到端工程化参考实现。

一句话推荐结论

如果你想了解如何用 Agentic AI + Serverless 架构构建一个自动化 AIGC 周刊系统，aigc-weekly 是一个从爬取到 CMS 管理再到边缘分发的完整参考实现；如果你只是想订阅 AIGC 资讯，直接访问 aigc-weekly.agi.li 或订阅 RSS 即可。