历史上的今天文章撰写
根据当天日期，检索历史上今天发生过的重大事件，撰写一篇带配图的科普文章，最终输出为响应式 HTML（配图以 base64 内嵌，单文件可离线浏览）。
工作流
按顺序执行以下五个步骤，每一步的产出作为下一步的输入：
1. 历史事件提炼
- 调用聚合数据「今日历史」接口获取当天事件列表，脚本见
scripts/history_client.py（接口todayOnhistory/queryEvent，按当天"月/日"查询，月、日均不补零）。 - 从返回结果中筛选 2~3 个重大事件。事件优先级：爱国 > 科技 > 人物 > 社会 > 文化。
- 事件选择要兼顾代表性、故事性和读者认知度，避免堆砌冷门条目；同一领域尽量不重复。
2. 信息收集
- 将选中的每个事件拆解为具体搜索关键词（如"事件名 + 时间 + 背景/影响"）。
- 调用百度 AI 搜索采集素材，脚本见
scripts/search_client.py（千帆 AI Search，baidu_search_v2数据源）。 - 用
batch_search批量检索、extract_text提取纯文本，注意甄别来源可信度。 - 两次搜索之间保持间隔（默认 2 秒）以避免限流。
3. 文章大纲生成
- 根据搜索素材生成结构化大纲：引言 → 逐事件分章节 → 结语。
- 在每个章节标注配图位置与配图描述（prompt），为后续文生图做准备。
4. 文章撰写
- 逐章节撰写正文，叙事有感染力、有史实、有升华。
- 调用千帆文生图为配图位置生成 3~7 张配图，脚本见
scripts/image_client.py（qwen-image模型，默认尺寸1376x768）。
5. 润色升华
- 对全文进行润色，让叙事有感染力、有升华。
- 生成响应式 HTML，将配图以 base64 内嵌，输出到 macOS 桌面（详见下文「输出要求」）。
特殊要求
- 所有涉及大语言模型调用的地方，直接使用背后的模型能力，不额外调用外部 LLM 接口。
- 输出格式：响应式 HTML，配图以 base64 内嵌（单文件、离线可用）。
- 输出目录：macOS 桌面
~/Desktop。代码中统一用os.path.expanduser("~/Desktop")展开，切勿使用全角～。
脚本与配置
技能目录下 scripts/ 包含可复用的 API 客户端，可直接调用或作为参考：
| 脚本 | 用途 |
|---|---|
scripts/history_client.py |
聚合数据「今日历史」接口，按当天"月/日"（不补零）查询事件列表 |
scripts/search_client.py |
百度 AI 搜索客户端，提供 search / batch_search / extract_text |
scripts/image_client.py |
千帆文生图客户端，提供 generate / generate_and_save / generate_batch，输出目录已用 os.path.expanduser 展开 |
scripts/config.example.py |
配置模板，包含全部接口 URL、模型名、尺寸与密钥占位 |
密钥与配置
出于安全，本技能不内置任何真实 API Key。使用前：
- 复制
scripts/config.example.py为scripts/config.py（或直接在环境中设置同名环境变量）。 - 在
config.py中填入以下三个密钥（仅保留在本地，勿提交到版本库）：
- 聚合数据「今日历史」Key → 环境变量HISTORY_API_KEY
- 千帆 AI Search Key → 环境变量BAIDU_SEARCH_API_KEY
- 千帆文生图 Key → 环境变量QIANFAN_API_KEY - 确认
IMAGE_OUTPUT_DIR为~/Desktop（脚本已用os.path.expanduser展开，保持半角~）。
运行脚本前确认已安装 requests（python -m pip install requests）。
配置项说明
| 配置项 | 默认值 | 说明 |
|---|---|---|
IMAGE_OUTPUT_DIR |
~/Desktop |
配图与 HTML 输出目录，半角 ~ |
IMAGE_MODEL_URL |
https://qianfan.baidubce.com/v2/images/generations |
千帆文生图接口 |
IMAGE_MODEL_NAME |
qwen-image |
文生图模型名 |
IMAGE_SIZE |
1376x768 |
配图尺寸 |
BAIDU_SEARCH_URL |
https://qianfan.baidubce.com/v2/ai_search |
百度 AI 搜索接口 |
BAIDU_SEARCH_SOURCE |
baidu_search_v2 |
搜索数据源 |
BAIDU_SEARCH_RECENCY |
year |
搜索时间范围 |
SEARCH_DELAY_SECONDS |
2.0 |
搜索间隔秒数 |
HISTORY_API_URL |
https://v.juhe.cn/todayOnhistory/queryEvent |
聚合数据历史接口 |
本次关键改动说明
- 输出目录：全角
～/Desktop→ 半角~/Desktop。 - 代码：
ImageClient.__init__增加self.output_dir = os.path.expanduser(output_dir)，确保~/Desktop正确落到当前用户的苹果桌面。 - 配置：明确新增
IMAGE_OUTPUT_DIR：~/Desktop。
以上改动不影响其他 API 调用逻辑。
