🧬DSH 科研工具手册
Zotero × DSH Desktop × 生物信息学
🧬 第 4 部分 · 共 7 部分

④ 科研实战(生信版)

技能怎么装、流水线怎么走、10 个可直接抄的场景 · 本部分 8 小节

4-1 什么是"技能",为什么它是核心

技能(Skill)= 一包写好的专业说明书。

举例:你在会话里打一句

code
帮我看看这批单细胞数据,做完 QC 和聚类,然后画个 UMAP。

AI 会自己去"技能书柜"里翻,找到 scanpy 这个技能(里面写着 Scanpy 的标准流程和参数建议),然后照着做。

这解决了小白最大的问题:你不用知道该用哪个包、参数怎么设、图怎么画得能发表 —— 技能里已经写好了。

技能长什么样:

code
技能文件夹/               ← 文件夹名 = 技能名
└── SKILL.md             ← 说明书本体(前面有一段"什么时候用我"的说明)

技能放在哪(记住这个路径):

系统技能目录
WindowsC:\Users\你的用户名\.agents\skills\
macOS~/.agents/skills/

每个技能是里面的一个子文件夹,子文件夹里必须有 SKILL.md。 装完新开一个会话,AI 才能看到新技能。

4-2 技能怎么装(三种方法)

#方法 A:让 AI 帮你装(最推荐 👍 最适合小白)

在 DSH 里新建会话,把 GitHub 链接丢给它,然后打这段话:

code
这个 GitHub 仓库里有很多科研技能:<把链接粘在这里>
请帮我把它里面的技能(含 SKILL.md 的文件夹)安装到我的技能目录
(Windows 是 C:\Users\<我的用户名>\.agents\skills\,Mac 是 ~/.agents/skills/)。
安装前先列出你准备装哪些、有多少个,等我确认后再动手。
装完告诉我怎么验证。

AI 会:克隆仓库 → 找到所有 SKILL.md → 复制到技能目录 → 给你一份清单。 你只需要在它问"确认吗"的时候回答"确认"。

#方法 B:手动装(自己动手,最可控)

打开终端(托盘 → Open DSH Terminal),Windows 用这几行:

powershell
# ① 把仓库下载到临时目录
$REPO = "https://github.com/K-Dense-AI/scientific-agent-skills.git"
git clone --depth 1 $REPO "$env:TEMP\skills-repo"

# ② 把每个含 SKILL.md 的文件夹复制到技能目录
$DST = "$env:USERPROFILE\.agents\skills"
New-Item -ItemType Directory -Force -Path $DST | Out-Null
Get-ChildItem "$env:TEMP\skills-repo" -Recurse -Filter SKILL.md |
  ForEach-Object {
    $dir = $_.Directory
    Copy-Item $dir.FullName (Join-Path $DST $dir.Name) -Recurse -Force
  }

# ③ 数一数装了多少个
(Get-ChildItem $DST -Directory).Count

macOS / Linux 用这几行:

bash
git clone --depth 1 https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/skills-repo
mkdir -p ~/.agents/skills
find /tmp/skills-repo -name SKILL.md -print0 | while IFS= read -r -d '' f; do
  d=$(dirname "$f"); cp -R "$d" ~/.agents/skills/
done
ls ~/.agents/skills | wc -l

没有 git?Windows 在 https://git-scm.com/download/win 装一个;Mac 在终端打 xcode-select --install。

#方法 C:插件市场装插件(注意:插件 ≠ 技能)

插件市场里装的是"给 DSH 加功能的扩展"(比如某个数据库的连接器、某个界面优化)。技能和插件是两回事,但市场里也有帮你管理技能的工具(例如 dsh-any-skills、dsh-plug-skills、dsh-skillhub)。

建议:一开始先用方法 A 装几个核心技能,熟悉了再逛市场。

4-3 怎么用 awesome-academic-research-skills 榜单

网址:https://kael-odin.github.io/awesome-academic-research-skills/

它是什么:一个每天自动更新的排行榜,专门收录"服务科研的 AI 技能仓库"。它用两个关键词做精准过滤:必须有 学术/研究/论文 信号 + 必须有 skill/agent/workflow 信号。

页面怎么用:

操作作用
按 /聚焦到搜索框(搜关键词,比如 single cell、zotero、figure)
按 t切换深色/浅色主题
按 l中英文切换
按 v表格视图 / 卡片视图切换
按 f收藏(收藏的会单独标出)
按 Esc关闭弹窗
点任意一行看这个仓库的详情
「下载 JSON / CSV」把榜单导出成表格,方便自己筛选

怎么挑(三步法):

  1. 看分类:文献综述 / 深度研究 / 论文写作 / 实验复现 / 学科专项 / 综合研究 —— 先按你现在要干的事筛。
  2. 看 7 天趋势,别只看总星数:标着「热门上升」的是近期真在被人用的。
  3. 看更新时间:超过 6 个月没更新的,先别装(可能和现在的 DSH 不兼容了)。

#给你(生信方向)的三个"先装这些"

优先仓库为什么
🥇K-Dense-AI/scientific-agent-skills学科专项,160+ 科研技能 + 100+ 科学数据库,覆盖基因组/单细胞/蛋白/药物发现 —— 对生信最对口
🥈Imbad0202/academic-research-skills全流程:research → write → review → revise → finalize,写论文/改稿/回审稿意见一条龙
🥉Yuan1z0825/nature-skills 或 Boom5426/Nature-Paper-Skills投稿规格:对标 Nature 的表达风格和科研绘图

⚠️ 一句提醒:榜单收录 ≠ 质量担保。看到主打「一句话出论文」「降 AI 率」「降重」的仓库,只当格式参考用,别当学术工具用 —— 论文的结论和署名责任永远是你自己的。 完整 Top 50 见 附录 A。

4-4 给她的工作目录长这样

DSH 是按文件夹记会话的。所以一开始就把目录建规范,以后会感谢自己:

code
科研/
└── 2026-单细胞-肝癌免疫微环境/          ← 一个课题一个文件夹
    ├── 00-说明/                        # 课题背景、时间线、老板的要求
    ├── 10-文献/                        # library.bib、检索记录、纳入排除表
    ├── 20-笔记/                        # 每篇文献一张卡 + 主题综述笔记
    ├── 30-数据/                        # 原始数据(只读!不要改)
    ├── 40-分析/                        # 脚本 + 中间结果 + 图
    │   ├── scripts/                    # 所有 .py / .R / .sh
    │   ├── results/                    # 表格、h5ad、rds
    │   └── figures/                    # 图(矢量图优先:pdf/svg)
    ├── 50-论文/                        # 各章节、参考文献
    └── 90-复盘/                        # 审稿意见、修改记录、AI 使用说明

三条硬规矩:

  1. 30-数据/ 永远只读,分析产物一律写到 40-分析/。
  2. 所有脚本必须落盘(哪怕只跑了一次)—— 这是"可复现"的唯一保障。
  3. 每张图都要有一个生成它的脚本。

4-5 科研流水线 10 站

把整条链路记成 10 站。不需要一次做完,从你现在卡住的那一站开始。

站干什么用哪个技能/工具你可以这样说
1选题提问假设类技能「帮我把'肝癌免疫微环境'缩成 3 个可做的研究问题,各写出假设和验证方法」
2查文献literature-review、deep-research、paper-lookup「检索近 5 年 XXX 的单细胞研究,列出检索式并去重,存成表格」
3入库整理Zotero + Linter + Better BibTeX「帮我把这 30 个 DOI 生成 BibTeX,检查有没有查不到的」
4精读做笔记Zotcard + Better Notes + PDF2zh「按我的卡片模板,给这篇 PDF 出结构化笔记」
5综述成型literature-review、Zotero Cita「把这 20 篇笔记汇总成一份 3000 字综述,带对比表」
6数据分析scanpy、pydeseq2、pathway-enrichment、biopython、nextflow「reads 在这里,帮我写完整分析脚本,跑之前先给我看计划」
7画图scientific-visualization、scientific-schematics「把 results 里的表画成投稿级图,配色对色盲友好」
8写作academic-paper、scientific-writing、venue-templates「按目标期刊的模板写 Methods」
9评审改稿academic-paper-reviewer、peer-review「假装你是 3 位审稿人,各写一份审稿意见」
10交付docx、pptx、pdf、latex-posters「把结果做成组会 PPT,15 分钟,中文」

整条线的总调度:如果你想把第 2 到第 10 站串起来自动跑,直接说

code
用 academic-pipeline 技能,把我的「XXX 课题」从文献检索一路做到论文初稿,
每一站的产出按我的目录规范落盘,中间需要我决定的停下来问我。

4-6 十个可以直接抄的场景

直接复制粘贴,把 <> 里的内容换成你自己的。

#场景 1 · 读一篇论文,出结构化的"笔记卡"

code
把 20-笔记/ 里这篇 PDF 读完,按下面的结构写一张笔记卡,存成 20-笔记/<第一作者>-<年份>.md:
研究问题 / 用了什么数据 / 方法 / 主要结论 / 局限 / 我能用上的点 / 我的质疑。
要求:所有数字和结论都要标出在原文哪一页,不要自己编。

#场景 2 · 下载公共数据(先要计划,别让它直接跑)

code
我想用 GEO 上 <GSE 编号> 这个数据集。
先别下载,先给我一个完整的下载和分析计划:下载哪些文件、多大、存哪、
用哪个技能(建议用哪套技能)、预计多长时间。
我确认后你再执行。下载请用命令行工具,不要用浏览器。

💡 为什么要这样问:公共数据动辄几十 GB,先看计划能避免把硬盘塞满,也能避免"下了半天发现下错版本"。

#场景 3 · 单细胞:从 counts 到聚类出图

code
30-数据/ 里是 10x 的 counts 矩阵。请用 scanpy 技能做标准流程:
QC(画出线粒体基因比例、UMAP 前后对比)→ 过滤 → 归一化 → 高变基因 → PCA → 邻接图 → 聚类 → UMAP → 用 marker 基因做初步注释。
产出:脚本放 40-分析/scripts/,图放 40-分析/figures/(pdf 格式),结果放 40-分析/results/。
每一步的参数都写清楚,并告诉我为什么选这个参数。

#场景 4 · 差异表达 + 通路富集

code
用 40-分析/results/counts.csv 做差异表达分析(bulk RNA-seq,两组对照)。
用 pydeseq2,做完之后把差异基因表按 log2FC 和 padj 排好存成 csv;
再用 pathway-enrichment 做 GO/KEGG 富集,输出富集表和气泡图。
脚本和结果按目录规范存放,最后写一个 README 说明怎么重跑。

#场景 5 · 复现某篇论文的某张图

code
我想复现 <作者年份> 这篇论文的 Figure 2。
数据在 30-数据/,论文原文在 20-笔记/ 里。
先告诉我:要复现这张图需要哪些数据、缺什么、能不能做;
然后再动手。做不到的部分明确告诉我,不要编一个"看起来像"的图。

#场景 6 · 写 Methods 章节

code
按 40-分析/scripts/ 里的实际脚本,写论文的 Methods 章节。
要求:写清楚软件版本、参数、统计检验方法;不确定的地方标 [待确认] 而不是猜。
参考 50-论文/ 里目标期刊的格式要求。

#场景 7 · 组会 PPT

code
读 40-分析/ 和 50-论文/ 里的内容,做一个 15 分钟的组会 PPT(中文):
背景 2 页 / 数据与方法 3 页 / 结果 6 页(每页配一张图)/ 下一步 2 页 / 致谢 1 页。
每页备注里写清楚我要讲什么。产出 pptx 文件。

#场景 8 · 开题 / 综述初稿

code
基于 20-笔记/ 里的 25 篇文献,写一份主题综述初稿:
按"研究背景 → 目前主流方法 → 争议点 → 空白 → 我的切入点"组织。
每句话如果来自某篇文献,用 [作者 年份] 标注,并在文末给出完整参考文献。
没有文献支撑的推断,明确标成"(推测)"。

#场景 9 · 表格清洗 + 统计

code
30-数据/raw.csv 是我实验记录的表,有很多不规范的地方。
先给我一份数据质量报告(缺失值、异常值、重复、单位不一致),
然后给一个清洗方案让我确认,再执行。
统计学问题请用 statistical-analysis 技能,并告诉我每个检验的前提假设。

#场景 10 · 代码报错 / 环境问题

code
我运行这个脚本报错了,错误信息如下:

<paste 错误信息>

请先解释这个错误在说什么,再给出修复方案,
最后告诉我怎么验证修好了。不要一次改很多地方,一次改一处。

4-7 把 Zotero 和 DSH 连起来

连上之后,AI 就能直接读你的文献库,不用你一篇篇复制粘贴。

#方式一:BibTeX 中转(最稳,小白推荐)

  1. Zotero 里装 Better BibTeX
  2. 给你的项目文件夹设一个自动导出:导出到 科研/<课题>/10-文献/library.bib
  3. 在 DSH 会话里说:
code
我 Zotero 的文献库导出在 10-文献/library.bib。
请先统计有多少条、年份分布,然后告诉我里面有哪些主题。

#方式二:Zotero 本地接口(不用 API Key,但要 Zotero 开着)

Zotero 开着的时候,本机有个只读接口:

code
http://127.0.0.1:23119/api/users/0/items          ← 所有条目
http://127.0.0.1:23119/api/users/0/collections    ← 所有分类

在 DSH 里可以直接说:

code
用 Zotero 的本地接口(127.0.0.1:23119)看看我"XXX"这个分类里有多少篇文献,
列出标题和年份。

如果连不上:确认 Zotero 是打开的;另外默认是只读的,如果要让 AI 往 Zotero 写东西,需要去 Zotero 设置 → 高级 里勾选允许本机其他程序通信。

#方式三:给 AI 装一个 Zotero 连接器

在 DSH 的插件市场 / MCP 面板里注册 zotero-mcp(社区有多个实现)。这条路适合以后玩熟了再折腾。

4-8 七条铁律(别踩坑)

这一节比前面所有内容都重要。收藏起来,每次交稿前看一遍。

#铁律具体怎么做
1引用必须能查证让 AI 写参考文献后,一律要求它给出 DOI 或 PMID,然后你抽查。凡是"查无此文"的一律删掉
2不要交出原始数据未发表数据、病人信息、测序原始数据不要上传到任何云端服务。分析在本地跑,AI 只看结果摘要
3删除操作必须你亲自确认在提示词里明确写:「任何删除/覆盖/重命名的操作,先列出来等我确认」
4每一张图都要有脚本图能重现,论文才站得住。禁止"手工调一调"的图
5样本量和统计方法不要听 AI 的直觉用 statistical-analysis / experimental-design 技能,并自己核对前提假设
6AI 不能当作者按目标期刊要求写"AI 使用声明"。结论的正确性、数据的真实性,责任在你
7不确定就问"你为什么这么说"习惯性追问:「这个结论的依据是什么?如果错了,最可能错在哪?」—— 这一问能筛掉一大半幻觉