paper-reading-web
将用户提供的研究论文一次制作成完整、可持续共读的中文 HTML 网页,包含原文与完整翻译、逐图带读、图例对应、论证链、知识卡及随手记;也用于按反馈维护这类网页。
Файлы23
Открыть в GitHubSKILL.mdskills/paper-reading-web/SKILL.md
GitHub全文文献共读网页
默认交付
收到论文后一次生成完整的“首次阅读核心版”:摘要、必要背景、Introduction及Results连续正文与完整翻译、所有主图及各面板独立带读、讨论与局限、完整论证链、必要术语知识卡、全文末尾读者总结与评议,以及导航/返回/缩放/随手记/两个独立标记开关。核心内容内部可以分批构建,但不得省略主图或压缩后半部分。方法只在理解当前正文/主图所必需的位置解释,不默认另写全套方法参考。
默认不生成附图逐图详解、补充材料支线、完整Methods翻译/独立参考库、复习检测题、延迟复习、复现实验等进阶内容。首次仅保存来源清单和可选模块名称,不写它们的内容,也不放待填模板;关键附图若是主结论必要验证,可在核心论证中简短引用相关证据并说明来源。读完或用户要求进阶时,先列与该论文有关的候选模块、用途及范围,由用户选择后再生成。现有网页已生成的进阶内容保留并移入第二部分,不删除。用户明确请求全包或局部时以本次范围为准。
图片按图像清晰度规范检查:先查矢量/位图,矢量裁区直接高分辨率渲染;位图保留原生像素,不能把插值放大称为清晰度提升。呈现按首次阅读/按需进阶分组,组内保持正文实际顺序。
目标是让第一次读论文的人知道:上一结果留下什么问题,为什么采用当前方法,图中每个元素是什么,实际结果支持什么,以及为何继续下一项实验。提供完整内容不等于用户读完或掌握,不承诺无需修改或已改善长期记忆。
工作流程
- 新建:读取原论文,确认正文/Methods/图注是否齐全。生成本文专属的主图面板清单、正文与图的对应关系、实验和比较对象清单;不要继承其他论文的图数、坐标、基因、组别或样本量。缺补充材料时说明证据范围,不补造内容。
- 续改:先读取项目随手记队列、已有阅读方法草稿及AGENTS.md。先处理真实待办,按请求含义定位,章节选择只作为提示。仅要求对话解释时不改网页。
- 写正文解析、图带读或论证链前,必须先读对话式论文讲解范式。先写可在聊天中直接回答当前问题的自然解释,再放入网页;不得用结论标签或专家限制列表代替中间推理。然后先按 文章拆解与讲解操作手册 建立来源证据台账与问题网络,说明每条连接的证据缺口和方法理由,再阅读 references/reading-and-teaching.md,写出所有正文单元和每个面板的独立带读。每图检查原图和图注,不只依赖文字摘要。逐单元执行手册的首次读者检验;不能只按模板填标题,不能把完整交付当作理解成功。
- 默认使用 固定组件与装配契约 中的实际HTML/CSS/JS及项目提问服务器,按
scripts/build_reader.py装配;不要为新论文重做返回、折叠控件、面板和笔记接口。阅读 references/page-and-navigation.md,构建或更新同一HTML;按 references/maintenance.md 实现可持续记录与运行方式。输出留在项目outputs/,不带入本Skill来源项目的私人笔记、路径或论文图片。 - 逐项执行 references/acceptance.md。结构验证只是发现遗漏;内容准确、图例对应和教学推理必须人工逐项核对。能使用浏览器时检查实际交互;访问受限时报告未实测项,不绕过限制。
- 交付可用链接、HTML及必要资源;如已约定桌面分享版,同步同名离线文件。简短说明已完成范围、缺失资料及功能验证范围。上传或安装Skill是另一个请求,不自动执行。
内容不可混淆
- 每单元:内部核对原文位置 → 连续英文 → 完整中文翻译 → 一个简短、明确的结论模块(清楚优先,通常1–3句,不设单句或字数硬限制) → 详细讲解。概括只在翻译下方,不在开头再复制。
- 全文完整翻译与概括分开;图注的样本量、统计、阈值、图例和补充引用不能因分析已经解释而省略。来源疑似错误照实翻译,另加译注。
- 图前先给理解图所需的Results正文,按作者论证关系接图;不机械按PDF分页切断跨栏段落。
- 图例逐项写“实际颜色/形状/位置 → 具体含义”;每个小图单独核对,不把多个符号与多个含义分两串列出。
- 研究图是观察/比较还是干预必须说明;RNA数量差异不叫序列改变,组间差异不写成随时间变化。TF基因的调控区、TF蛋白结合位点与motif预测不是同一个对象。
- 每个面板完整带读;批量输出不降低标准。标题或篇幅统计不能代替具体结果和中间推理。
文件约定
建议保留 outputs/paper-reading.html、outputs/reading-notes.json、outputs/阅读方法草稿.md。具体名称及端口按当前项目配置,不硬编码设备路径。为项目AGENTS写入适用的维护要求,见 assets/AGENTS-reading.md,合并而非覆盖既有项目规则。
本Skill固化的是用户确认的呈现与制作规范,不是已证明的学习疗效;主动回忆及延迟复习效果按实际反馈记录为待验证。
已取消模块
不生成共读记录/阅读日志网页章节,也不生成对应导航、下拉选项、进阶候选或记录文件;旧历史文件保留,不继续要求维护这类输出。必要的待办和处理回复仍在随手记队列。当前项目的明确维护指令优先。
首读语境与紧凑排版(最新)
读前背景只解释读摘要后真正需要的基本对象、日常矛盾、本文的问题。每个新对象先说是什么、为何出现在本文、此刻只需理解什么;不提前堆实验缩写、转基因品系、组别、流式门或统计符号。实验工具/特定组别在首次使用的正文前简短引入:先讲待解决问题,再讲工具身份/比较设计/为何可回答,随后读原文与图。不要把实验细节挪到读前并默认读者已知道,也不要用“不是某某”替代正向定义。 已提供原文与译文时,阅读区不反复标“来源PDF第X页/对应文段/按完整段落还原”等制作和定位提示,不在段标题加“图Xa前的正文”。来源页、段落范围及图号仍保存于内部证据台账,供准确核对,不重复占用阅读区。原始PDF总入口和科学上必要的图号引用保留。 短卡按内容自然高度,紧凑标题/段落间距和适量内边距,不设统一大高度、空白占位或一两句的大框。避免只为对齐而拉高。逐项看正文密度、首次出现术语是否有定义、前后知识依赖,而非只验证DOM数量。
三分区与独立读者评议(最新)
网页按基础文章内容(摘要、Introduction/Results与主图、作者讨论局限)→知识区(基础概念、术语卡、全文论证链)→进阶内容(选择后生成的附图、Methods及论文支线)→进阶知识区(选择后生成的复习自检、默认必需的读者总结与评议)排列。空分区不显示。知识区不等于可选生成:必要概念/卡片/论证链与读者评议默认必须生成,复习等仍为可选。基础概念不冒充作者Introduction;读前确需的知识通过摘要后短链接访问,保留精确返回,图前的必要即时解释仍随正文,避免迫使读者来回翻。导航分组与实际DOM/笔记选项顺序一致。 “读者总结与评议”是首次交付必需模块,放所有现有内容之后、全文最后;不等待用户确认读完。通俗复述全篇、方法与问题路线、证据支撑的创新、最可信结论、未解决机制/替代解释/推广边界、另一种观察角度及可检验的下一步。明确区分作者结果、教学归纳、个人评议与未检验假设;不凭本文断言全球首次,不为了批判而否定有效证据,也不把建议写成已做实验。不仅复述作者思路,要基于具体证据给读者判断。 图例按钮只显示“图例”,保留点击展开/收起与aria-expanded状态。
术语卡片容器标记data-reader-card-group,容器内提供一键展开/收起;组件自动补齐按钮,操作只作用于本组术语卡,不误展开复习答案或全页其他details。全文论证链默认附简洁流程框图:研究问题→各阶段方法与关键发现,箭头写上一证据不足/下一问题;并行实验明确标并行,不把论证顺序当成发生时间或因果链。用离线可用HTML/CSS或SVG,不依赖CDN;手机可纵向阅读,保留后面的完整讲解。
术语组最新控件:标题与单个切换按钮同一行,按钮靠最右;全部展开时显示“一键收起”,否则显示“一键展开”,点击完成相反操作。监听单卡展开状态以同步文字,按钮只操作当前术语组;窄屏保持同一行并检查不溢出。此要求替代双按钮/另起一行。
最新四区及紧凑笔工具
顺序固定为基础文章内容→知识区→进阶内容→进阶知识区。知识区放基础概念、术语卡与论证链;复习自检、读者总结与评议放进阶知识区。分区表示归属,不自动改变生成权限:读者总结仍按此前要求首次默认必需、全文最后;复习仍需用户选择。更新导航、DOM和笔记下拉,保留锚点。 笔图标与图例按钮在同一行。笔图标一直可见、图标不变,点击展开或折叠;展开只出现“开启/关闭”同一切换按钮及“撤销”。开关文案表示点击动作,默认“开启”,开启后显示“关闭”;收起时关闭标记模式而保留已有标黄。不再使用独立收起笔按钮。按钮紧凑但可操作,手机及桌面展开后整行不溢出,图例内容在下方保持两列三行。
2026-10-13文字质量优先
本轮明确取代严格一句/过度精炼要求:清楚表达对象、比较、实际结果和理由优先,缩短重复而非推理。正文解析、图带读、全文论证链均依对话式范式逐单元制作/验收。旧对话借鉴表达方式,科学事实必须按当前PDF独立核对;旧回答的错图或过强因果不得迁移。
临时查阅与浮层交互(2026-10-13)
返回按钮仅在正文名词链接跳到知识卡、或明确标记data-reader-return的临时查阅链接之后出现;目录与普通章节导航不建立返回记录,并清除过时记录。返回后恢复页位置、面板选择及独立文字滚动;栈用尽隐藏按钮。不可把所有页内锚点都作为临时查阅。 随手记入口为右边缘竖排“随手记”书签,面板不设收起按钮;点面板外自动收起,Escape亦可收起。内部填写、附件选择和图片预览不误关;草稿及附件保留。 图片预览为居中留白窗口,桌面宽约68%、高约78%;平板约80%、手机约90%宽以保障读图。右上角圆形×,缩放工具左上;点遮罩或Escape关闭。拖动图片结束到外部不误判为遮罩点击;保留滚轮/拖动/双指缩放。打开预览不清除笔记草稿。 验收含:目录跳转无返回、知识跳转有返回且精确还原;随手记内点击不关/外点击关/草稿保留;预览圆形关闭与遮罩关闭、内点击不关、窄屏无溢出。
正式交付版本与备份数量
首次打开询问:覆盖(0历史备份)/保留1个备份/保留2个备份;最新版另计。保存到项目reader-settings.json,离线选择仅在浏览器内有效,不能冒充项目文件已写入。允许稍后选择并从版本设置更改,未选择时不擅自清理历史。 每次正式交付前读项目设置,使用scripts/publish_reader.py保存简称_vN.0_YYYY-MM-DD_HHMMSS.html(北京时间),网页显示版本及时间。保留latest+指定历史数量,按交付序列清理manifest所管的历史HTML,只操作本项目versions目录;不清理论文、图片、附件、笔记、个人标黄或任意用户文件。改变备份数量在下次交付生效,版本号单调递增,不依赖剩余文件数。工作稿小改/测试不生成正式版。固定paper-reading.html为最新入口;历史快照须离线完整、自带图/样式/脚本与可用PDF入口。先检查来源和功能再发布,桌面分享同步并保留可辨认版本名。首次交付选择前不编造已实施的备份策略。
最新桌面与拖图规则(替代此前桌面版本命名建议)
桌面固定一份同名最新版HTML,每次正式交付完成后覆盖该文件,不在桌面堆历史。工作项目versions目录保存版本号+北京时间命名的最新版及0/1/2历史备份;固定最新入口继续可用。发布用--desktop传当前已约定桌面路径,不删除其他桌面文件;HTML中显示当前版本及更新时间。未选择备份策略不清理历史。 正文图与预览图均draggable=false并阻止dragstart,避免原生图片拖拽抢占左键平移;不拦截contextmenu,保留右键保存图片。此行为不影响浏览器滚轮缩放、触控双指缩放和关闭操作。
随手记书签支持鼠标/触控沿最右边上下拖动,仅改变纵向位置;上下各留8px,不越出视口。移动超过6px区分拖动与点击,拖后不误开面板;正常点击与键盘激活仍切换。按论文ID在浏览器保存相对位置,刷新/尺寸变化时恢复并限制范围。拖动不修改笔记内容。