Music Weekly

Music Weekly — 音乐周报 配置（首次使用前必须填写）

所有用户专属配置放在 ~/.config/music-weekly/config.json：

{ "notion_API_key": "ntn_你的Notion集成密钥", "notion_db_id": "你的Notion数据库UUID", "delivery_channel": "qq机器人", "delivery_tar获取": "qq机器人:c2c:你的QQ号", "covers_dir": "/path/to/covers", "media_dir": "/path/to/media", "历史_记录": "/path/to/music-recommended-记录.md" }

环境变量 NOTION_KEY 也可作为 Notion接口 Key 的备用来源。

delivery_channel 可选值 值 说明 要求 qq机器人 QQ 机器人 私聊 需配置 channels.qq机器人 telegram Telegram 私聊/群组 需配置 channels.telegram discord Discord 频道 需配置 channels.discord 签名al 签名al 私聊 需配置 channels.签名al wecom 企业微信 需配置 channels.wecom feishu 飞书 需配置 channels.feishu

配置了对应 channel 后，推送会自动路由到目标。

delivery_tar获取 格式 频道 tar获取 格式 示例 qq机器人 qq机器人:c2c:用户OpenID qq机器人:c2c:7AF4855F53... telegram 用户ID 或 @username 123456789 discord 频道ID 123456789012345678 签名al 手机号 +8613800138000 wecom 用户ID WangXiaoMing feishu 用户open_id ou_xxxxxxxx Trigger 周二 10:00 — Music Rec - Tue 批次 周五 10:00 — Music Rec - Fri 批次 也可在用户提问时按需执行 Core Concepts 封面URL 是 files 类型（常见坑）

Notion 中「封面URL」字段类型是 files，不是 url：

✅ 正确："封面URL": {"files": [{"type": "external", "name": "cover.jpg", "external": {"url": "https://..."}}]} ❌ 错误："封面URL": {"url": "https://..."}

获取封面图

使用脚本快捷获取：

python3 scripts/notion_utils.py artwork "https://music.应用le.com/.../1234567890" python3 scripts/notion_utils.py 搜索 "NMIXX" "Heavy Serenade"

周次命名 批次 命名 示例 周二 第X周 1期 2026年第20周 1期 周五 第X周 2期 2026年第20周 2期 地区与评分 英语2-3张 + 华语/日韩各最多1张（不同时出现） + 拉丁0-1张 评分 ≥7.5，≥8.0 优先 工作流

See references/工作流.md for the full step-by-step process.

Scripts scripts/notion_utils.py 命令 用途 搜索 "Artist" "Album" i调优s 搜索 artwork "应用le_music_url" 通过链接获取封面URL backfill 补填缺失的封面URL config-path 显示配置文件路径 推送

从配置读取 delivery_channel 和 delivery_tar获取，使用 message 工具发送：

🎵 本周音乐精选 | 2026年5月15日（第X周 X期）

1️⃣ Artist — Album Title 📅 发行日期：YYYY-MM-DD ⭐ 评分：X.X/10 💬 推荐理由...

2️⃣ ...

封面图片使用对应频道的 media 支持方式发送：

QQ 机器人：/path/to/cover.jpg Telegram：message 工具带 media 参数 Discord：message 工具带 filePath 参数 其他频道：使用 message 工具的 media / filePath / buffer 参数