Twig 问枝

用 AI 读论文时，常遇到三个问题：

1. AI 的回答不够精炼、不好理解，有时还不真实；
2. 看完 AI 的总结心里没底，不知道自己算不算真的读懂了；
3. 读新领域的论文时概念太多，一追问就是两三层，对话越拉越长，回不到主线。

Twig 把阅读过程画成一棵树：论文各节沿主干竖排，你向 AI 追问的问题向右分叉，可以分很多层。每个节点有一张知识卡片，回头复习时，顺着线就能看出“先懂什么，才能懂什么”。

配合 AI 读论文

扩展自带一套给 AI 的书写规则（skill twig）。在 VSCode 里用 Claude Code、Codex、Gemini 或 Copilot 这类能读写本地文件的 AI 读论文时，AI 按规则一边讲解、一边维护这棵树：

• 精炼、好懂：详细讲解留在对话里，树里只记整理好的结论；
• 处处有出处：卡片每段都标明来自原文哪一节、哪张图、哪一页，原文没说、由 AI 推出的内容单独标【推断】；
• 按知识的依赖关系挂：新问题挂在它依赖的概念下面；合并节点、调整结构前先问你；
• 不怕对话太长：进度记在文件里，开新对话后让 AI 读一下这个文件，就能接着读。

读完出题

读完全文后，AI 会写一份提问清单和一份参考答案，分成两个文件，你可以先自己作答再对答案：

• 20–30 题，由浅入深：动机与问题 → 方法设计 → 结论与证据 → 原文细节 → 局限与迁移；
• 考理解而不是记忆，阅读中被纠正过的误解会出成辨析题；
• 答案逐题带出处，可以回原文核对。

提问清单：由浅入深分层

参考答案：逐题带出处

功能

• 实时预览：打开任意 *_twig.md，点编辑器右上角的树形图标，旁边出现树状图，编辑后自动刷新。Ctrl + 滚轮或右下角按钮缩放，按住空白处拖动平移。
• 知识卡片：点方框打开卡片。卡片里的 [文字](#id) 链接可跳到其他节点。
• 节点状态：虚线框表示暂挂的问题，米黄框表示超出本文范围的拓展问题。
• 跳转原文：卡片里的页码和图表号都可以点，打开论文并定位到出处所在的那一行。需要另装 PDF Viewer 扩展。
• 导出网页：右键 *_twig.md →“导出 HTML”，生成一个独立网页，可以直接发给别人。
• 新建：命令面板执行“Twig：新建 Twig”，从模板新建文件。

文件格式

文件由 AI 按规则维护，一般不用手写。需要自己核对的是开头的 pdf（论文路径，相对于 Twig 文件）和 firstPage（PDF 第 1 页对应的期刊页码），它们决定能否跳对页。

---
title: 作者 (年份) Twig
progress: §1 引言
current: s1
pdf: ../论文.pdf
firstPage: 991
---

## 全文主线：一句话说清这篇论文 {#topic}

【原文 · §1 p.991】
卡片正文，支持表格、列表、引用和公式，行间公式用 KaTeX 排版。

## §1 引言：这节在做什么 {#s1}

## 追问的问题？ {#q1 parent=s1 status=pending}

节点标题写成一行 ## 标题 {#id parent=父节点id status=pending}：不写 parent 即为主干，status=pending 为暂挂，status=extra 为超出本文。

安装 AI 书写规则

第一次启动时扩展会询问是否安装书写规则：

• 同意后，规则写入家目录下 .claude/skills/twig，本机装有 Codex、Gemini 时也写入它们的 skills 目录（Copilot 读取 Claude Code 的目录）；
• 安装后，对 AI 说“开始读某篇论文”即可；
• 扩展升级时规则自动更新，可在设置 twig.installSkill 中关闭。

调整回答风格

规则用 Claude 开发测试，换用其他 AI 时风格可能不同。不满意时，在对应 AI 的 skills/twig/ 目录下新建 个人偏好.md，写几条要求，例如“新术语先用一句话解释”，附一张满意的卡片作范例更好。它升级时不会被覆盖，只调风格，不改出处规则；不要直接改 书写要求.md，升级时会被覆盖。

许可

MIT