Daily Poster

# Daily Poster

## Poster Type Map

- `daily` = `摸鱼日报`
- `baidu_hot` = `百度热点` / `百度热搜`
- 用户提到“摸鱼日报”“日报”“节假日倒计时”“下班倒计时”时，优先选择 `daily`
- 用户提到“百度热点”“百度热搜”“热搜榜”“热榜”时，优先选择 `baidu_hot`

## Use

```json
{
  "poster_type": "daily",
  "personal_info": {
    "name": "智普虾🦐",
    "bio_lines": [
      "OpenClaw 驱动的 AI 助手，搭载GLM5 模型，机智温暖有点俏皮"
    ]
  }
}
```

- 默认入口：`python scripts/render_poster.py --spec <spec.json> --output out/poster`
- `poster_type` 只支持 `daily` 和 `baidu_hot`
- `poster_type: "daily"` 表示“摸鱼日报”版式
- `poster_type: "baidu_hot"` 表示“百度热点 / 百度热搜”版式
- 用户未明确要求时，只收集 `personal_info.name` 和最多 `2` 行 `bio_lines`

## Output Format Map

当用户提到“生成图片”“导出 PNG”“发 JPG”“给我 WEBP”这类需求时，不要只停留在 SVG，要在 JSON 里补 `output`。

- 用户说“生成 png”“导出图片”“发一张海报图”时，优先使用 `output.formats: ["png"]`
- 用户说“既要源文件又要图片”“同时保留 svg 和 png”时，使用 `output.formats: ["svg", "png"]`
- 用户说“导出 jpg / jpeg”时，使用 `output.formats: ["jpg"]`，并补 `quality`
- 用户说“导出 webp”时，使用 `output.formats: ["webp"]`，并补 `quality`
- 用户没有指定清晰度时，`png` / `jpg` / `jpeg` / `webp` 默认推荐 `scale: 2`
- 用户没有指定压缩质量时，`jpg` / `jpeg` / `webp` 默认推荐 `quality: 92`
- 用户要求 `jpg` / `jpeg` 这类不透明格式时，默认补 `background: "#ffffff"`，除非用户明确要求别的底色
- AI 生成 JSON 时，优先显式写 `output.formats`，不要依赖 `--output out/poster.png` 这种后缀推断

推荐模板：

```json
{
  "output": {
    "formats": ["png"],
    "scale": 2
  }
}
```

常用输出示例：

```json
{
  "output": {
    "formats": ["svg", "png"],
    "scale": 2
  }
}
```

```json
{
  "output": {
    "formats": ["jpg"],
    "scale": 2,
    "quality": 92,
    "background": "#ffffff"
  }
}
```

## Minimal Inputs

```bash
# 摸鱼日报（daily）
python scripts/render_poster.py --type daily --spec references/daily-poster-spec.json -...

# Python Daily Poster

`Python Daily Poster` 是一个基于 JSON 规格生成中文信息海报的 Python 工具，适合做日报、榜单、资讯卡片这类固定版式输出。

当前内置两种海报类型：

- `daily`：生成 `摸鱼日报` 风格海报，可组合个人信息、摘要、倒计时、日程、语录等内容模块
- `baidu_hot`：生成 `百度热搜` 风格海报，按统一版式拉取并渲染热点榜单

默认输出 SVG，也支持按需导出 PNG/JPG/WEBP，方便接入自动化脚本、定时任务或内容发布流程。

## 安装

```bash
pip install -r requirements.txt
```

## 统一入口

```bash
# 摸鱼日报（daily）
python scripts/render_poster.py --type daily --spec references/daily-poster-spec.json --output out/daily_poster

# 百度热点 / 百度热搜（baidu_hot）
python scripts/render_poster.py --type baidu_hot --spec references/baidu-hot-spec.json --output out/baidu_hot_poster
```

也可以直接调用：

- `python scripts/render_daily_poster.py --spec ... --output ...`
- `python scripts/render_baidu_hot.py --spec ... --output ...`

## 示例展示

### 摸鱼日报 (`daily`)

![daily_poster 示例](assets/daily_poster.png)

### 百度热点 (`baidu_hot`)

![baidu_hot_poster 示例](assets/baidu_hot_poster.png)

## 摸鱼日报最小 JSON

```json
{
  "poster_type": "daily",
  "personal_info": {
    "name": "智普虾🦐",
    "bio_lines": [
      "OpenClaw 驱动的 AI 助手，搭载 GLM5 模型，机智温暖有点俏皮"
    ]
  }
}
```

## 百度热搜最小 JSON

```json
{
  "poster_type": "baidu_hot",
  "personal_info": {
    "name": "智普虾🦐",
    "bio_lines": [
      "OpenClaw 驱动的 AI 助手，搭载 GLM5 模型，机智温暖有点俏皮"
    ]
  },
  "output": {
    "formats": ["svg", "png"],
    "scale": 2
  }
}
```

## 约束

- `bio_lines` / `text_lines` 最多取前 `2` 行非空内容
- `baidu_hot` 固定使用代码内置 `title` / `subtitle` / `api_url` / `limit`
- `baidu_hot` 顶部日期区同一行显示公历、星期、农历
- 所有入口脚本都会输出统一 JSON 结果

## 项目目录架构

```text
daily-poster/
|-- .claude/                                        # 可选，本地开发工具配置...