weekly-research

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 时，引导用户完成配置与定时任务安装：

1. 若项目根目录还没有 config.sh，执行 cp config.example.sh config.sh。
2. 根据用户需求编辑 config.sh（所有可调参数都在这里）：执行星期/时刻（WR_WEEKDAY / WR_RUN_HOUR）、模型与推理强度（WR_CLAUDE_MODEL / WR_CLAUDE_EFFORT）、是否投递与归档（WR_DELIVER / WR_ARCHIVE）、接收者 LARK_USER_ID、归档目录 token ARCHIVE_FOLDER_* 等。
3. 运行 ./scripts/setup.sh：它会从 config.sh 渲染 scripts/launchd/job.plist.template，安装到 ~/Library/LaunchAgents/<label>.plist 与 <label>-watchdog.plist，校验并 launchctl load。
4. 告知运维命令：手动跑一次用 ./scripts/run-research.sh，卸载用 ./scripts/uninstall.sh，查看状态用 launchctl list | grep weekly-research。

---

模式三：查看/编辑配置（config）

当 $action 为 config 时：

1. 读取并展示 config.sh 中的运行参数（模型、节奏、投递/归档开关、必备板块）
2. 读取并展示 references/search-config.md（搜索关键词与信息源）
3. 询问用户是否需要修改
4. 如需修改，使用 Edit 工具更新对应文件；若改了节奏或 label，提示重新运行 ./scripts/setup.sh