paper-to-html-v2.5
为当前用户制作或维护中文论文共读网页,重点支持生物医学实验论文;按论证结构选择详讲、简讲、合讲或跨图比较,保留核心正文、原图、知识卡、论证链与阅读控件。
SKILL.mdskills/paper-to-html-v2.5/SKILL.md
GitHubPaper to HTML v2.5
Turn research papers into interactive, explained HTML reading guides. 把研究论文变成可交互、带讲解的 HTML 阅读指南。
当前定位与讲解决策
当前版本定位为:以生物医学实验论文为主、适应当前用户的中文共读工具。先用用户实际阅读与反馈改善理解体验,再考虑其他读者和领域;不以全领域覆盖、图数、卡数或篇幅作为优化目标。沿用用户已认可的具体对象、实验设计与证据链讲法,依据本篇反馈调整,不能从用户的研究方向推定其已掌握所有技术。
先识别论文的论证结构,再决定讲解单位;允许省讲、合讲和跨图比较。 新文章在写作前按讲解单位与详略作选择。完整性针对核心问题与证据,不要求每张图独立、等量讲解。省讲省的是无增益注释,仍保留来源与必要原图/图注,不能省掉关键反例、条件或推理。复杂关键图保持详细带读。
遇到身份容易混淆的陌生对象或图例标签,通常先用熟悉的类别交代“它是什么、在本图代表什么”,再按理解需要展开机制与意义;已熟悉或语境明确时不重复铺垫,不设固定句式。
知识卡按知识点拆分与深度另行判断:不同关键概念默认独立、自足讲解;适合比较的近邻概念可合讲,但须先分别讲清,再说明共同点与差异。只需辨认身份的成批名称可集中简述。多图合讲不授权把多个知识点压成一句话。
图例先识别文章领域。生物学默认“基因与蛋白、实验方法、调控元件、细胞与亚型、生物学概念”,固定颜色且只显示实际使用类别;非生物学或混合领域按本文内容自动选择少量直白类别,不硬套生物学术语。具体分类和清单接口以adaptive-concepts.md为准。
交付范围
默认一次交付完整首次阅读核心:实际原文全题与按需译题、摘要及连续核心论证、主图/面板的原始查阅入口与按论证需要组织的讲解、作者总结与局限、必要知识卡、全文论证链,以及阅读控件与随手记。基础版不生成独立“读者总结与评议”;仅用户明确要求时作为可选进阶内容生成。内部可分批制作,按选定讲解单位保持质量;不要让用户逐图追加请求才补齐核心。 核心范围内的原文及图注提供完整中文翻译,保留条件、数量、统计、限定语和图号/补充材料引用。所有阅读内容移除纯参考文献编号及引用上标角标,不改为其他编号形式;真实单位、公式上标等保留,详见reading-and-teaching.md。核心范围按主贡献决定,不按章节名决定:方法/算法/证明是贡献主体时完整带读;复现级操作细节、附图详解、补充支线和复习检测不默认生成,关键补充依据就地解释。进阶请求先列本文相关候选模块,按用户选择生成;明确全包/局部范围时按其请求。 不生成共读记录/阅读日志网页章节或独立日志文件。随手记及其处理回复仍保留。已有进阶内容保留,按下述归属整理。
图的简短概括与作者结论
每张整图/小图译后的简短模块,先用自然语言说明“作者在这张图里做了什么、图上展示什么”,使读者先认出研究动作、对象及读数。按需要交代分组/参照、测量或统计输出;流程、相关、比较和干预图各取所需,不硬套统一句式。通常一句,必要时两句,不以机械字数或固定要素配额验收。紧接概括,单独保留醒目的“作者的结果与判断”:从对应正文提取作者实际发现及其判断,先把答案说清,再保留必要限定;详细带读随后解释图上依据。这两层各有用途,不能因新增或改写一句话概括而覆盖、合并、移除作者结论,也不能只把结论埋入后面的长讲解。流程/设计图如实说明作者研究安排;没有单面板结论时标明共同结论范围或缺少独立结论,不编造发现。写作与检查见讲解范式的简短模块规则。
带读交付门槛
先决定讲解单位,再按详细讲解要求写作。关键复杂单元保留“当前问题与数据构造 → 局部图例 → 实际例子到判断 → 剩余问题”;每个可独立切换的小图必须有局部自足的带读:交代本图问题、对象/数据构造、局部图例和单位、具体观察到判断及边界。简单图可简洁,不要求硬凑篇幅;多图可共享比较背景与跨图综合,但不能把全部教学集中到整图,只给小图一句结论和跳转入口。流程/方法图若含多条采样或检测分支,应沿箭头完整走读,解释各关键标签在此处的身份、每种方法测什么及输出什么;不能只复述“采样后做分析”或把必要解释推给整图。局部缩写只解释当前面板可定位的标签,不将整图缩写/统计尾注复制到每个小图。不能用一个空泛 explain 段替代关键推理,也不能为通过检查给简单图凑四块文字。详略选择、科学复述与浏览器交互分别验收。
图旁解释须使读者明白陌生英文类别/评分是什么、如何得到及对应哪些图中元素,不能只说按颜色区分。统计标记须就地解释检验对象、参照、方法、阈值与校正(以实际来源为准),用一个可定位的真实例子走通读数到判断;来源缺定义时标明,不能凭惯例或邻图补齐。按图例、方法与统计的讲解深度逐面板语义核查,发现同类省略须全篇排查。
读图时优先采用作者在上下文中明确写出的目的和结论,再用图中观察解释其依据。先查对应正文前后段、图注与相关讨论;没有明确表述时才作带读归纳并标明归属。设计图不冒充结果图,跨图总结不冒充单面板证明。具体执行与来源字段见来源与证据核对。
用类别概括多项读图结果时,按具体标签到分类总结给出可定位的对象、位置和比较方向,再解释哪些结果共同支持该特征及有哪些例外;不能只说“早期/混合/某通路活跃”。
整理讨论与局限时,先呈现作者明确说出的解释、不确定性及未来方向,再将我们的理解或评议另行标明;按来源与证据核对执行,不把通用批评当作作者自述。
论文结构与解释方式
先识别实际语言、主贡献、核心结构和证据依赖。默认中文共读,同语种无需重复翻译。遇到非生物医学实验论文,按范围边界与必要适配处理;不将一次外领域测试扩展成全领域优化任务,也不套用生物实验路线。保留认可的阅读控件与布局。
操作流程
资料定位、版本核对及主张审查按来源与证据核对执行;需要补足工具能力时再读外部能力选用,不把检索或安装外部Skill设为每篇必做前置。 术语与知识卡先执行术语选择与知识卡说明:从当前文章发现理解所需概念,再选择、消歧、建立必要前置关系并解释;词库只辅助核对,未命中不意味着忽略。每篇生成可审查清单,原文/译文/图注均有适当查阅入口,按领域选择直白分类。卡片先建立认识,再有依据地连接本文用途与相关概念;不把用户举例固化为通用词表或校准材料。匹配器、结构验收与理解/科学核查分开。
- 读入与续改定位:新论文核对正文、图注、方法/推导及证据材料和已取得补充资料,从原论文建立本文核心内容清单,含正文单元、主图/面板,以及承载主贡献的表格、公式、算法与证明;不能只从已生成HTML反推清单。维护已有项目先读AGENTS、实时pending随手记及附件、已有方法草稿;保留原文、译文、锚点和用户数据。只要求对话解释或审查时不改网页。
- 核对证据再写作:读讲解范式与拆解手册,先建来源证据台账和问题网络,再写自然解释;台账关联具体主张、源位置与最终页面锚点,核对作者原述、通用背景和教学归纳的边界。自然解释是写作方法,不要求先在聊天中重复交付全文。只有表达失真且案例适用时才读校准例子,只借鉴表达,不迁移旧论文事实。
- 按问题讲解:按阅读与教学保留连续原文、完整翻译与明确结论,围绕所选单元解释。详细单元讲清输入、比较、测量与元素、真实观察、推理和界限;共享比较先核对样本/条件/尺度是否可比,再讲共同方法与独有变化,不在每个面板重复整套模板。简单图按其角色简述。全文链保留真实依赖、并行及否定结果;核心表格、公式与方法按贡献需要讲解。
- 图像与装配:按图像规范检查原生矢量/位图和裁区,保留所有轴/图例,不生成式补细节。复用组件使用说明,用scripts/build_reader.py装配工作稿;不为新论文重新设计已经确定的交互。
- 分项验收与整体走读:执行验收,复用来源清单及已有验收记录,对应同一最终稿标识或hash分别记录四项的核查范围、证据及“通过/失败/未测/缺资料”;一项内状态不同则分开写,不由样本或脚本通过推定整项通过:
- 正文带读与翻译:逐核心单元对源核对完整性、译义及条件、数量、统计和限定语。
- 图片带读:核对作者目的、数据构造、局部图例、重要类群与标签、具体比较到结论及边界;按选定详略检查,不为简单图凑模板。
- 知识卡与文章梳理:按本文读者起点检查概念选择、独立自足解释及关系;检查全文问题、证据缺口、下一步理由、并行与否定结果。
- 辅助工具:在浏览器逐视口实际操作图例、标黄与撤销、刷新保留、卡片查阅返回及图片预览;随手记用隔离测试队列提交并重新读取核对,维护真实项目时保留原队列。 四项之后,在同一最终页面连续走读“正文→对应图→知识卡→返回原处→标黄/随手记→全文论证链”,检查内容衔接、图文对应及工具配合;该代表性路径不替代全文逐项核对,也不证明用户已经理解。
- 修复、重测与发布:发现错译、关键遗漏、图文/来源冲突或交互失败,先定位影响范围、修复并重测受影响对象及依赖。资料或执行条件不足以修复/验证时,保留已核实部分,交付明确标注范围的工作稿并报告未决项;不能将失败或未测项称为通过。按维护与版本发布,桌面与项目入口同步覆盖固定同名最新版,不自动保留历史;内容核对、结构检查、浏览器操作及理解效果分别报告,不新增阅读日志。
页面归属与顺序
| 区域 | 内容 | 默认生成 |
|---|---|---|
| 基础文章内容 | 摘要、按原结构连续组织的核心论证与主图、作者总结/局限 | 是 |
| 知识区 | 超出读者起点且必要的概念、术语卡、全文论证链与简洁流程图 | 是 |
| 进阶内容 | 用户选定的复现细节、附图、论文支线 | 按选择 |
| 进阶知识区 | 用户选定的读者总结与评议、复习等 | 否,仅明确要求时生成 |
| 四区按表顺序排列,空区不显示;如用户明确要求读者评议,将其放在全文最后。“进阶知识区”是归属名称,不决定生成权限。知识区不冒充作者正文;首次用到陌生对象时随正文简短定义,读前基础只解释摘要后真正需要的对象和问题,不提前堆实验品系与细节。正文DOM、编号与笔记定位一致;导航是独立的粗粒度索引,不逐段复制正文单元。 |
保留的阅读体验
具体状态与HTML属性见版式与导航。
- 顶部只保留实际全题及按需译题、作者、发布日期、期刊、原文PDF与原文链接,期刊、发布日期与原文PDF/链接在宽屏同一行排列,窄屏空间不足时自然换行,不为链接固定另起一行;不加阅读口号、制作说明、版本或备份提示。
- 左栏保留Abstract、Introduction、Results、Discussion等实际大章节,最多两级;Results二级优先按“图号+简短图名”快速定位,不逐段、逐小图或用长结论句列项。点击图号直达该图;相关正文共享该图导航归属,公共过渡与跨图比较归属上级,正文顺序与细分锚点不因此改变。具体属性见page-and-navigation.md。
- 目录常规导航不记录返回。名词→知识卡及明确的临时查阅才显示底部固定返回按钮,恢复外层位置、当前面板与独立文字滚动;返回栈用尽隐藏。
- 知识卡单列,标题右侧一个按钮切换整组展开/收起;卡片跳转居中,段落起始对齐。
- 荧光笔与图例位于目录栏底部独立工具区,目录单独滚动,展开不遮目录/正文;按钮固定原位,同一个按钮开合,默认收起且互斥展开。笔展开不启用标黄,显式开启/关闭并可撤销;术语颜色开关独立。每个小图在左侧图片下简短显示“数据来源 → 处理/指标”,复杂图按图层换行并区分患者与外部参考。详见page-and-navigation.md与components.md。
- 随手记为右边缘竖排书签,可沿边上下拖动并记住相对位置。面板无收起按钮,点外部或Escape收起,保留草稿。写当前项目、下轮助手处理,不即时调用GPT。
- 大图预览居中留边,右上圆形×,点遮罩/Escape关闭;支持缩放和平移。禁用图片原生拖拽,保留右键保存。手机/iPad可切换全部面板,原图与对应文字同时切换。
随手记输入区只保留自动阅读位置提示、文本框、粘贴截图预览和保存按钮;不显示位置/类型选择、跟随、文件上传、批量清除、退出编辑、刷新或本地服务链接。位置仅供参考,处理时按问题语义及附件定位;编辑历史记录保留原位置和类型。截图悬浮或键盘聚焦时显示右上角×逐张移除,触屏直接显示×。断线保留草稿并自动重连,不自动提交。验收自动定位、粘贴、逐张删除、保存持久化与断线恢复;历史清单筛选和编辑/删除/恢复仍保留。
文件、设置与边界
每篇唯一稳定paper-id,项目路径/端口取当前环境。核心入口paper-reading.html,队列reading-notes.json;内部工作稿与交付入口分开。来源页/段/裁区保存于内部台账,阅读区不重复展示制作定位提示或正文截图;保留原论文PDF总入口及科学上必要的图号引用。 每次交付默认覆盖固定同名最新版,不提供历史备份数量选择、首次弹窗、版本设置按钮或配套设置接口/历史轮转功能。项目入口与桌面离线副本同步覆盖;不因旧配置重新启用历史发布,不擅自删除既有历史、笔记、附件或源PDF。细则见maintenance.md。 静态全文可离线;项目笔记保存依赖独立本地服务,浏览器草稿/个人标黄不等于项目笔记。断线自动补存/移动端安全网络/即时GPT不在当前组件能力内,不虚称已实现。学习完成、理解效果和重启实测与内容/功能交付分别报告。新论文不携带本来源项目私有笔记、图片或机器路径。 将项目维护模板合并入新项目,保留适用的既有规则。仅按用户明确请求上传GitHub或安装Skill。