PaperFlow 论文分析与综述
把论文分析、研究综述任务交给 PaperFlow 后端执行。
前置：先把 paperflow 连上
- 跑起 MCP server：
uvx paperflow-mcp（需 uv，macOS 可brew install uv）。 - 配 API Key：到 <https://liangkaggle.com/api-keys> 生成，在 MCP 客户端里设
PAPERFLOW_API_KEY；或用PAPERFLOW_API_KEY_FILE指向存有 Key 的文件（不要把明文写进配置）。 - 完整接入步骤（含 Claude Desktop / Cursor / OpenClaw 配置片段）：<https://liangkaggle.com/mcp>。
装好后确认客户端里 paperflow 的工具（analyze_paper / get_paper / create_survey / get_survey）可见。缺 Key 时工具会报 HTTP 401——照实告知用户去「API Keys」页生成，不要自行编造 Key。
选择操作
| 用户意图 | 调用 |
|---|---|
| 给 arXiv 链接/ID 或论文全文，要「分析 / 解读 / 速读 / 评审」 | analyze_paper |
| 要「综述 / 调研 / 梳理」某个研究方向 | create_survey |
| 问某次分析或综述好了没、要结果 | get_paper / get_survey |
| 要完整长文本 | resource paperflow://papers/{id} / paperflow://surveys/{id} |
执行
- 分析论文 —— 调用
analyze_paper(arxiv_url=...或text=..., route="quick")。
-arxiv_url与text二选一，不能都空；route取quick（默认，最快最省）/deep/full。拿不准就用quick。
- 完成条件：拿到status=completed的 Markdown 结果，或拿到paper_id+「进行中」提示。 - 追进度 —— 步骤 1 返回「进行中」时，用
get_paper(paper_id=...)继续查，直到completed/failed。
- 完成条件：得到终态；仍非终态则如实告知用户「仍在跑」并给出 id。 - 生成综述 —— 调用
create_survey(topic=..., max_papers=50)。
-topic≥2 字；max_papers10–200；可选date_start/date_end（年份，0 表示不限）。
- 完成条件：拿到完整report_md，或拿到survey_id+「进行中」提示。 - 追综述 —— 用
get_survey(survey_id=...)取，直到completed/failed/cancelled。
- 完成条件：终态之一，或明确告知仍在跑。 - 交付 —— 把工具返回的 Markdown 组织给用户；长文优先用 resource 取全文。
- 完成条件：回答里出现本次调用的 id 与最终结论/状态。
成本（动手前先告知用户）
- 论文分析按次计费：
quick¥0.10 /deep¥0.30 /full¥0.50。 - 综述：终身首篇免费，之后 ¥5/篇。
- 一次请求涉及多篇不同论文或多主题时，先说明将产生的费用，再执行。
注意
- 不要重复提交：同一 arXiv / 同一主题若已提交过，复用已有 id +
get_*查询；再次analyze_paper/create_survey会重复扣费。 - 以工具返回为准：不编造分数、结论、引用或引用数；工具报错照实反馈（如 401 = Key 无效/未配置，需用户重新获取）。
- 长任务默认最长等
analyze_paper300s /create_survey600s；超时属正常，用返回的 id 续查，别重开任务。 - 完整结果优先走 resource（
paperflow://papers/{id}、paperflow://surveys/{id}）；get_paper(include_agents=True)输出很长，仅在确需 Agent 明细时使用。
