| name | weekly-research |
| description | 前沿研究速报：自动搜索并生成结构化研究报告，覆盖时序大模型架构创新、时序大模型应用实践、AI Infra 前沿研究、国家政策动态四大板块（按此顺序产出）。支持手动执行和 macOS launchd 定时自动化（每周一 08:00）。当用户需要生成研究速报、调研前沿论文、跟踪行业政策时使用。 |
| argument-hint | [run|setup|config] |
| arguments | ["action"] |
| allowed-tools | WebSearch WebFetch Bash Read Write Edit |
| effort | max |
Weekly Research Report Generator
根据 $ARGUMENTS 执行对应操作：
- 无参数或
run：立即执行研究并生成报告
setup：配置 macOS launchd 定时任务（默认每周一早上自动执行）config：显示或编辑搜索配置
模式一：执行研究（默认）
当 $action 为空或为 run 时，执行以下完整流程。
步骤 1：读取搜索配置与历史报告
先读取 references/search-config.md 获取搜索关键词和搜索源配置。
再读取 references/report-format.md 获取报告格式规范。
然后读取 reports/ 目录下最近一期报告（按文件名日期排序取最新），提取已报道过的条目标题和来源链接，作为去重依据。后续步骤中必须跳过已报道内容，只收录新增信息。
步骤 2：并行搜索
使用 WebSearch 搜索配置中的所有关键词。将 {YYYY} 替换为当前年份。尽量并行发起多组搜索以提高效率。搜索时注意限定时间范围为上期报告之后的内容。
步骤 3：抓取详情
使用 WebFetch 抓取搜索结果中最重要的论文和页面（至少 8-10 个关键链接），获取详细的标题、作者、摘要等信息。优先抓取 arXiv 论文页和 HuggingFace 模型页。
步骤 4：生成报告
按照 references/report-format.md 中的格式生成结构化 Markdown 报告。确保：
- 每条信息包含标题、来源链接、内容摘要（2-3句）、分析评述（1-2句）
- 政策板块用中文
- 研究板块用中英混合
- 报告末尾包含"本周关键趋势总结"
- 严格去重：与上期报告重复的条目不得出现。如果某个板块在本周期内确实没有新增信息，直接注明"本周期未发现新增内容"，不要为凑数而收录旧信息或边缘信息
步骤 5：保存报告
date_str=$(date +%Y-%m-%d)
将报告写入当前工作目录下的 reports/${date_str}.md。如果 reports/ 目录不存在则创建。
步骤 6：完成
报告已保存。不要执行任何飞书/Lark 推送或云空间导入命令 —— IM 推送和 docx 归档都由调用方（shell 脚本 scripts/run-research.sh 的 archive / deliver 阶段）负责。如果你在这里尝试推送或导入，会产生重复消息或重复归档文档。直接结束即可。
注：手动调用 /weekly-research run 仅生成报告文件；自动化定时任务由 scripts/run-research.sh 统一处理「生成 → 验证 → 归档（飞书云空间 docx）→ 推送（飞书 IM，含归档链接）→ 告警」。
模式二：配置自动化（setup）
当 $action 为 setup 时，引导用户完成配置与定时任务安装：
- 若项目根目录还没有
config.sh，执行 cp config.example.sh config.sh。
- 根据用户需求编辑
config.sh（所有可调参数都在这里）：执行星期/时刻（WR_WEEKDAY / WR_RUN_HOUR）、模型与推理强度（WR_CLAUDE_MODEL / WR_CLAUDE_EFFORT）、是否投递与归档（WR_DELIVER / WR_ARCHIVE）、接收者 LARK_USER_ID、归档目录 token ARCHIVE_FOLDER_* 等。
- 运行
./scripts/setup.sh：它会从 config.sh 渲染 scripts/launchd/job.plist.template，安装到 ~/Library/LaunchAgents/<label>.plist 与 <label>-watchdog.plist，校验并 launchctl load。
- 告知运维命令：手动跑一次用
./scripts/run-research.sh，卸载用 ./scripts/uninstall.sh，查看状态用 launchctl list | grep weekly-research。
模式三：查看/编辑配置（config）
当 $action 为 config 时：
- 读取并展示
config.sh 中的运行参数（模型、节奏、投递/归档开关、必备板块）
- 读取并展示
references/search-config.md（搜索关键词与信息源）
- 询问用户是否需要修改
- 如需修改，使用 Edit 工具更新对应文件；若改了节奏或 label，提示重新运行
./scripts/setup.sh
