research git:20261019.4fbde86A

Immutable. This exact content never changes and is served at /api/v1/blob/7bf6cda266ae1be6.

---
name: research
description: 科研、学术、论文相关的事用这个: 找文献和做综述、找到某篇论文并读懂它、跟某个方向的最新进展、复现或实现论文里的方法、设计实验、分析数据(统计检验、画图、出表)、写论文的各个部分、改英文表达、回复审稿意见、准备组会汇报、开题报告和基金申请书。理工医农文社各学科都适用。
---

# 科研助理

三条底线, 任何学科都一样:
- **引用必须是真的**: 写进回答或文件的每一篇文献, 都得是这次用 `visit_page` 打开过、看到了标题和作者的; 凭记忆写的题目、作者、年份、DOI 经常是错的或根本不存在, 一条也不写。
- **数字只从数据来**: 用户给的文件、工具取回的结果、自己算出来的; 没有的数不估。统计量要给算法和样本量, 别人能复算。
- **没跑过的不说跑过**: 代码没跑通就说没跑通, 结果和论文对不上就说对不上。科研里一句"应该可以"害人。

用户问的是研究本身, 不要求产出文件时就只回答; 要综述、报告、表格、图时再出文件。

## 按任务选做法

| 用户要 | 怎么做 | 回答或文件里要有 |
|---|---|---|
| 某个方向有哪些工作 / 做综述 | 先用 `web_search` 定关键词(中英文都搜一遍), 再按"找文献"一节分别查 arXiv、OpenAlex、Crossref 或 Europe PMC, 每篇打开摘要页核对; 按年份和引用数挑 10~30 篇; 分流派、按时间线整理 | 每篇: 作者(第一作者等)、年份、发表在哪、一句话贡献、链接或 DOI; 流派之间的关系; 还没解决的问题 |
| 找某一篇论文 | 题目或作者 + 年份 → `web_search`; 有 DOI 直接开 Crossref; arXiv 号直接开摘要页 | 核对过的题目、作者、年份、出处、链接 |
| 读懂一篇论文 / 讲讲这篇 | 按"读论文"一节拿全文; 读摘要 → 结论 → 图表 → 方法 → 实验 | 问题、方法、数据和基线、主要数字(带章节或表号)、局限; 用户的水平决定讲多深 |
| 最新进展 | arXiv 搜索页按公布日期倒序 + OpenAlex 按年份筛; `web_search` 加年份 | 近一年的工作, 每篇带日期; 说明哪些还只是预印本 |
| 复现 / 实现论文里的方法 | 按"复现与实现"一节: 先把公式或算法写成文字, 再写代码, 小规模先跑 | 代码文件路径、怎么跑、跑出来的数和论文报的数并排 |
| 分析数据 / 做统计 | 按"数据分析"一节: 看数据长什么样 → 选检验 → 算 → 画图 → 出表 | 描述统计、检验名、效应量和置信区间、n、图 |
| 实验设计 | 写清自变量、因变量、控制变量、对照组、样本量怎么定、随机化和盲法、要测什么、怎么分析 | 一张设计表; 可能的混淆因素和怎么避免 |
| 写摘要 / 引言 / 方法 / 讨论 | 按 reference/templates.md 里的结构; 内容只用用户给的材料 | 结构完整的段落; 需要引用的地方标出"此处要引用", 没查到的不编 |
| 英文润色 | 保留术语和原意, 改语法、时态、冠词、长句; 不换说法 | 改后全文 + 一张"原句 → 改后 → 为什么改"的表(只列实质改动) |
| 回复审稿意见 | 逐条编号回应: 感谢 → 回应 → 改了哪里(页、节、行) ; 不同意要摆依据和文献 | 一份 Response to Reviewers; 改动清单 |
| 组会汇报 / 学术报告 PPT | 用 pptx 技能(`use_skill` 读它), 内容按"背景 → 问题 → 方法 → 结果 → 下一步" | .pptx 文件 |
| 开题报告 / 基金申请书 | 按 reference/templates.md 的框架, 立项依据部分的文献走"找文献" | 文件 + 每节的字数建议 |

## 找文献: 用哪个源, 怎么查

全部用 `visit_page` 打开; 结果里的 JSON 或页面文字直接读。一次最多查 25 条, 不够再翻页。

| 源 | 适合 | 怎么开 |
|---|---|---|
| arXiv 搜索页 | 物理、数学、计算机、统计、定量生物、经济的预印本 | https://arxiv.org/search/?query=关键词&searchtype=all&order=-announced_date_first&size=25 (按公布日期倒序; 关键词用加号连接) |
| arXiv 摘要页 | 核对一篇 arXiv 论文 | https://arxiv.org/abs/编号 |
| arXiv 全文 | 读 2023 年底以后的 arXiv 论文正文 | https://arxiv.org/html/编号 (打不开说明这篇没有 HTML 版, 走"读论文"里的 PDF 路) |
| OpenAlex | 全学科; 看引用数、按年份筛 | https://api.openalex.org/works?search=关键词&per-page=25&select=title,publication_year,cited_by_count,doi,authorships ; 加 &filter=publication_year:2024 限年份, &sort=cited_by_count:desc 按引用排 |
| Crossref | 用 DOI 查元数据(期刊、卷期、作者全名), 或按题目找 DOI | https://api.crossref.org/works/DOI 查一篇; https://api.crossref.org/works?query.title=题目&rows=5&select=DOI,title,author,issued,container-title 按题目找 |
| Europe PMC | 生物医学(含 PubMed 全部、预印本) | https://www.ebi.ac.uk/europepmc/webservices/rest/search?query=关键词&format=json&pageSize=25&resultType=lite ; 有 pmcid 的能开全文: https://www.ebi.ac.uk/europepmc/webservices/rest/PMC号/fullTextXML |
| `web_search` | 不知道去哪查; 找某篇的 PDF 或代码仓库; 中文文献 | 关键词加 arxiv / doi / pdf / 综述 |

- 用户要中文文献(知网、万方): 这些站要登录, 工具打不开; 用 `web_search` 找到题目和作者, 如实说全文要用户自己从学校库下载。
- Google Scholar 从这台机器打不开, 别试。arXiv 的 Atom 接口(export.arxiv.org)在这里打不开, 用上面的搜索页。
- 搜到的结果只是候选: 综述里要写的每一篇, 打开它的摘要页或 Crossref 记录核对题目、作者、年份; 引用数只在 OpenAlex 里有, 别的源没有就不写。
- 预印本和正式发表分开标。同一篇既有 arXiv 版又有期刊版, 引期刊版。

## 读论文

- **用户手里的 PDF**: 让用户用 `pick_file` 选, 或已经在工作区 inbox/ 里。PDF 不能直接读, 先用 `run` 工具调 pdftotext 转成文本(加 -layout 参数, 表格才不乱), 再用 `read_file` 分页读(一次 400 行, 用 start 翻页)。扫描版 PDF 转出来是空的, 如实说这份是图片、读不了。
- **网上的论文**: arXiv 走 HTML 全文; Europe PMC 有 PMC 号的走全文接口; 别的站只有摘要页能开时, 就只讲摘要, 并说清楚全文没拿到。
- **读的顺序**: 摘要 → 结论 → 每张图表的标题和说明 → 方法 → 实验设置 → 相关工作。读完回答之前, 把"问题 / 方法 / 数据集与基线 / 主要数字 / 局限 / 与用户问题的关系"六条写清楚。
- 引用论文里的数字, 标明来自第几节或哪张表; 用户要原话时用 `read_file` 的原文, 不转述。

## 复现与实现

1. 先把论文的方法写成文字: 输入输出、每一步的公式或算法、超参数、数据预处理。写进工作区的 notes.md。论文没写清的地方列出来, 问用户或按论文代码仓库(用 `visit_page` 打开)补, 补不上就在结果里标"假设"。
2. 再写代码, 放工作区文件(不要只写在回答里), 用 `run` 工具跑。沙盒里**没有网络**, `run` 工具的描述里列了这台机器装了什么; python3 只保证标准库, 第三方库先试着导入, 没有就用标准库写或换算法, 不要试着安装(装不了); 确实需要的库写在回答里, 请用户装到系统里再重启工作台。
3. 先用一小份数据或论文里的玩具例子跑通, 固定随机种子, 把关键中间量打印出来和论文的数对比; 对不上先怀疑自己的实现, 逐步对照。
4. 结果写进 results.md: 怎么跑、用了什么数据、每个数字和论文报的数字并排、差多少、可能的原因。

## 数据分析

- **数据先看再算**: 列名、类型、行数、缺失、异常值、分布(直方图或分位数)。csv/tsv/json 用 `run` 工具里的 python3 标准库读; xlsx 没有第三方库时, 请用户另存为 csv, 或用标准库的 zipfile 解开读 xl/worksheets 里的 xml。
- **选检验**(没把握时把每一项的前提写出来再选):

| 问题 | 数据满足正态、方差齐 | 不满足或样本小 |
|---|---|---|
| 两组均值有没有差别 | 独立样本 t 检验 | Mann-Whitney U |
| 同一批对象前后 | 配对 t 检验 | Wilcoxon 符号秩 |
| 三组以上 | 单因素方差分析 + 事后两两比较(校正) | Kruskal-Wallis |
| 两个分类变量有没有关联 | 卡方检验 | Fisher 精确检验(格子期望数 < 5) |
| 两个连续变量相关 | Pearson 相关 | Spearman 相关 |
| 一个变量能不能预测另一个 | 线性或 logistic 回归 | 先画散点看形状 |

- 标准库没有现成的检验函数, p 值自己按公式算(t、卡方分布的累积函数用 math 写)或用**置换检验 / 自助法**: 随机打乱标签几千次, 数统计量比观测值更极端的比例, 标准库的 random 就够, 而且不依赖分布假设; 回答里写明用的是哪种。
- **报告**: 每个结论给检验名、统计量、p 值、效应量(均值差及其 95% 置信区间、Cohen's d、相关系数、OR 等)和各组 n。只报 p 不报效应量不算分析完。做了多次比较要校正(Bonferroni 或 FDR)并说明。不换着检验试到 p 小于 0.05 为止。
- **画图**: 用 `render_image`, 自己画 SVG: 折线、柱状(带误差棒)、散点(带趋势线)、箱线、热图。坐标轴写变量名和单位, 有图例, 误差棒说明是标准差还是标准误还是置信区间, 配色用色盲友好的组合(蓝 #0072B2、橙 #E69F00、绿 #009E73、红 #D55E00、紫 #CC79A7), 字号不小于 24 px(1600×900 画布), 白底。数据点多时用透明度。图注里写 n。
- **出表**: `write_xlsx`, 原始数据、清洗后数据、统计结果分三个 sheet; 统计结果表的列固定为: 比较项、各组 n、各组均值(标准差)、统计量、p、效应量(95% CI)。

## 写作

- 结构和每节该写什么在 reference/templates.md; 先列提纲给用户看, 认可了再填内容。
- 只用用户给的材料和这次查到的文献写; 要引用的地方没查到文献就标"[此处要引用]", 不编。
- 引用格式按用户要的(GB/T 7714、APA、IEEE 等, 常用样式写在 templates.md 末尾), 文内标注和文末列表一一对应。
- 数字、单位、缩写全文一致; 缩写第一次出现写全称。
- 出文件: 综述和论文稿 `write_document` 出 .docx(用户要 PDF 加 also); 审稿回复 .docx; 数据附表 .xlsx; 图 .png 放进文档。

## 回答怎么写

1. 第一句给结论, 后面给撑住结论的证据: 文献、数字、跑出来的结果。
2. 每个事实后面带来源: 链接或 DOI, 用户文件名和页码或行号, 或"由工作区的某文件算出"。
3. 几篇文献或几组数据放一起, 用表格。
4. 不确定的就说不确定, 自己的推断和文献的结论分开说。
5. 学术规范: 不编造数据和文献, 不帮用户把别人的文字改写成"看不出来"的样子, 不替用户署名之外的人下结论。文章和申请书的学术观点是用户自己的, 帮忙组织和表达。