# aigc-weekly

**Repository Path**: markyun/aigc-weekly

## Basic Information

- **Project Name**: aigc-weekly
- **Description**: aigc-weekly AIGC 周刊 是一份专注于人工智能生成内容（AIGC）领域的精选周刊。

汇集了每周最新的 AI 进展、工具发现与深度观点，旨在为你提供高质量的行业洞察,分享从 RSS 源获取到的优质信息聚合，包含：AI技术、AI产品、思维观点、AI开源项目、AI资源和工具、LLMs资讯,Vibe Coding经验等
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-13
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# scifYun 的 周刊 站点

一个由 AI Agent 驱动的精选技术周刊站点。本项目采用静态站点架构，由 Claude Agent 自动抓取、筛选和撰写内容。 源码基于 https://aigc-weekly.agi.li 项目修改而来。 目前已经实现了 AIGC（人工智能生成内容） 和 前端技术周刊的 2套 内容。

---

<!-- **在线阅读**: <https://markyun.github.io/aigc-weekly/> -->

<!-- **RSS订阅**: <https://markyun.github.io/aigc-weekly/rss.xml> -->

![aigc-weekly](https://socialify.git.ci/miantiao-me/aigc-weekly/image?description=1&forks=1&name=1&owner=1&pattern=Circuit+Board&stargazers=1&theme=Auto)

## 特性

- **AI 智能策展**：Claude Agent 自动从信息源抓取、筛选和撰写周刊内容
- **静态站点**：Next.js 15 静态导出，可部署到任意静态托管平台
- **Markdown 存储**：周刊内容以 Markdown 文件存储，支持 Git 版本控制
- **零成本托管**：可免费部署到 Vercel / Netlify / GitHub Pages

## 技术栈

- **框架**：[Next.js 15](https://nextjs.org/) (App Router + Static Export)
- **内容存储**：Markdown 文件 + Frontmatter
- **Agent SDK**：[@anthropic-ai/claude-agent-sdk](https://docs.anthropic.com/en/docs/agents-and-tools/claude-agent-sdk)
- **网页抓取**：[Firecrawl](https://firecrawl.dev/) MCP

## 快速开始

### 前置要求

- Node.js v22+
- pnpm v10+

### 安装

```bash
git clone https://gitee.com/markyun/aigc-weekly.git.git
cd aigc-weekly
pnpm install
```

### 配置

**1. 站点配置**：复制 `.env.example` 为 `.env.local`

**2. Agent 配置**：创建 `worker/.env.local`（Agent 专用）

```bash
# worker/.env.local
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_AUTH_TOKEN=sk-ant-your-api-key
FIRECRAWL_API_KEY=fc-your-key  # 可选
```

### 本地开发

```bash
# 启动 Next.js
pnpm dev
# 访问 http://localhost:3000

# 启动 Agent（可选）
pnpm dev:agent

# 生成周刊（需先启动 Agent）
pnpm weekly

# 生成周刊2（不需启动 Agent）
在 AI cli 启动: /weekly
```

### 构建

```bash
pnpm build
# 输出目录：out/
```

### 部署

1. npm install -g vercel
2. vercel login
3. vercel --prod

## 项目结构

```
web-weekly/
├── app/(frontend)/     # 前端页面
├── posts/              # 周刊 Markdown 文件
├── agent/              # Claude Agent
│   ├── .claude/        # Agent 技能定义
│   └── index.ts        # Agent 服务入口
├── lib/                # 工具函数
├── scripts/            # 构建脚本
└── public/             # 静态资源
```

## Agent 工作流

执行 `/weekly` 命令后，Agent 依次执行：

1. **Researcher**：从信息源抓取内容
2. **Editor**：筛选和评分
3. **Writer**：撰写周刊
4. **Validator**：校验格式
5. **Reviewer**：审核内容

最终周刊保存到 `posts/{year}-w{week}.md`。

## 生成周刊

### 方式一：Claude Code CLI（推荐）

在 Claude Code CLI 中直接执行命令，无需启动额外服务。

```bash
# 在 Claude Code CLI 中输入
/weekly
```

**优点**：

- ✅ 无需启动 Agent 服务
- ✅ 支持交互式执行和调试
- ✅ 可实时查看执行过程

### 方式二：Agent HTTP 服务

通过 HTTP 接口调用 Agent 服务生成周刊。

**快速方式**：

```bash
# 终端 1：启动 Agent 服务
pnpm dev:agent

# 终端 2：触发生成（友好输出）
pnpm weekly
```

输出示例：

```
🚀 开始生成周刊...
📋 Session ID: d5f07f0b-aa76-4707-aae6-50f4c128f61f
🤖 Agent: 正在从信息源抓取内容...
🤖 Agent: 筛选完成，共 15 条高质量内容
🤖 Agent: 正在撰写周刊...
✅ 任务完成！
⏱️  耗时: 180000ms
💰 成本: $0.45
```

**原始命令方式**：

```bash
# 1. 启动 Agent 服务
pnpm dev:agent

# 2. 新开终端，使用 curl 触发
curl -X POST http://localhost:2442/chat \
  -H 'Content-Type: application/json' \
  -d '{"prompt": "/weekly"}' \
  --no-buffer

# 3. 等待完成后，提交推送
git add posts/ public/rss.xml drafts/
git commit -m "chore: generate weekly"
git push
```

### 方式三：GitHub Actions（自动化）

项目已配置 GitHub Actions，可实现每周自动生成。

**配置步骤**：

1. Fork 本仓库到你的 GitHub
2. 进入仓库 Settings → Secrets and variables → Actions
3. 添加以下 Secrets：

| Secret 名称            | 说明                               |
| ---------------------- | ---------------------------------- |
| `ANTHROPIC_BASE_URL`   | API 服务地址（可选，默认官方地址） |
| `ANTHROPIC_AUTH_TOKEN` | Anthropic API 密钥                 |
| `FIRECRAWL_API_KEY`    | Firecrawl 密钥（可选）             |

4. 启用 GitHub Actions：进入 Actions 标签页，启用工作流

**触发方式**：

- **自动**：每周日 UTC 10:00（北京时间 18:00）
- **手动**：进入 Actions → Generate Weekly → Run workflow

## 部署

### Vercel

1. Fork 本仓库到你的 GitHub
2. 在 Vercel 导入项目
3. 配置环境变量
4. 部署

### GitHub Pages

添加 `.github/workflows/deploy.yml`：

```yaml
name: Deploy
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v2
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: pnpm
      - run: pnpm install
      - run: pnpm build
      - uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./out
```

## 许可证

本项目采用 [GNU Affero General Public License v3.0](LICENSE) 许可证。