paper-to-html-v2.2

从研究论文PDF制作完整的中文HTML共读网页,或维护已有网页;包含核心正文完整翻译、所有主图逐面板讲解、论证链、知识卡、读者评议及可复用阅读控件。

SKILL.md

GitHub

Paper to HTML v2.2

Turn research papers into interactive, explained HTML reading guides. 把研究论文变成可交互、带讲解的 HTML 阅读指南。

交付范围

默认一次交付完整首次阅读核心:实际原文全题与按需译题、摘要及连续核心论证、全部主图/面板、作者总结与局限、必要知识卡、全文论证链、文末读者总结与评议,以及阅读控件与随手记。内部可分批制作,每个单元执行相同质量标准;不要让用户逐图追加请求才补齐核心。 核心范围内的原文及图注提供完整中文翻译,保留条件、数量、统计、限定语和图号/补充材料引用。所有阅读内容移除纯参考文献编号及引用上标角标,不改为其他编号形式;真实单位、公式上标等保留,详见reading-and-teaching.md。核心范围按主贡献决定,不按章节名决定:方法/算法/证明是贡献主体时完整带读;复现级操作细节、附图详解、补充支线和复习检测不默认生成,关键补充依据就地解释。进阶请求先列本文相关候选模块,按用户选择生成;明确全包/局部范围时按其请求。 不生成共读记录/阅读日志网页章节或独立日志文件。随手记及其处理回复仍保留。已有进阶内容保留,按下述归属整理。

带读交付门槛

新文章先读逐图讲解要求,保留“当前问题与数据构造 → 局部图例表 → 实际例子到判断 → 剩余问题”的完整阅读区域。先写通解释,再用教学对象装配;只保存一个 explain 短段不构成完整带读。装配覆盖、科学复述审查和浏览器交互是三项不同验收。

论文结构与解释方式

先读跨领域适配,识别实际原文语言、主贡献、核心结构及每个单元的论证方式;实验不是所有论文的默认路线。默认中文共读,可按用户语言请求调整;同语种无需重复翻译。保留认可的阅读控件与布局。

操作流程

资料定位、版本核对及主张审查按来源与证据核对执行;需要补足工具能力时再读外部能力选用,不把检索或安装外部Skill设为每篇必做前置。 术语与知识卡先执行术语选择与知识卡说明:从当前文章发现理解所需概念,再选择、消歧、建立必要前置关系并解释;词库只辅助核对,未命中不意味着忽略。每篇生成可审查清单,原文/译文/图注均有适当查阅入口,默认通用类型并允许领域适配。卡片先建立认识,再有依据地连接本文用途与相关概念;不把用户举例固化为通用词表或校准材料。匹配器、结构验收与理解/科学核查分开。

  1. 读入与续改定位:新论文核对正文、图注、方法/推导及证据材料和已取得补充资料,从原论文建立本文核心内容清单,含正文单元、主图/面板,以及承载主贡献的表格、公式、算法与证明;不能只从已生成HTML反推清单。维护已有项目先读AGENTS、实时pending随手记及附件、已有方法草稿;保留原文、译文、锚点和用户数据。只要求对话解释或审查时不改网页。
  2. 核对证据再写作:读讲解范式与拆解手册,先建来源证据台账和问题网络,再写自然解释;台账关联具体主张、源位置与最终页面锚点,核对作者原述、通用背景和教学归纳的边界。自然解释是写作方法,不要求先在聊天中重复交付全文。只有表达失真且案例适用时才读校准例子,只借鉴表达,不迁移旧论文事实。
  3. 完整讲解:按阅读与教学组织原文→完整翻译→一个明确结论模块→详细解释。结论通常1–3句,清楚优先,不设硬性字数或句数。每面板明确输入、比较对象、元素单位、局部图例、真实观察、中间推理、论证作用与界限;全文链按真实依赖解释:递进关系写前一步的缺口与下一步理由;并行、定义依赖、反证或最终整合按其关系讲,保留否定结果。核心表格、公式、算法和证明按cross-domain-reading.md逐项带读,不以主图齐全替代核心齐全。
  4. 图像与装配:按图像规范检查原生矢量/位图和裁区,保留所有轴/图例,不生成式补细节。复用组件使用说明,用scripts/build_reader.py装配工作稿;不为新论文重新设计已经确定的交互。
  5. 验收与发布:执行验收,逐单元核对内容、逐视口验证交互。按维护与版本发布,桌面只保留固定同名最新版,项目内保留最新版与用户选定历史数量。报告缺失资料及未实测项,不以结构检查证明理解效果。

页面归属与顺序

区域 内容 默认生成
基础文章内容 摘要、按原结构连续组织的核心论证与主图、作者总结/局限 是
知识区 超出读者起点且必要的概念、术语卡、全文论证链与简洁流程图 是
进阶内容 用户选定的复现细节、附图、论文支线 按选择
进阶知识区 读者总结与评议;选定后加入复习等 读者评议必需,复习按选择
四区按表顺序排列,空区不显示;读者评议始终全文最后。“进阶知识区”是归属名称,不决定生成权限。知识区不冒充作者正文;首次用到陌生对象时随正文简短定义,读前基础只解释摘要后真正需要的对象和问题,不提前堆实验品系与细节。导航、DOM顺序、编号及笔记选项一致。

保留的阅读体验

具体状态与HTML属性见版式与导航。

  • 目录常规导航不记录返回。名词→知识卡及明确的临时查阅才显示底部固定返回按钮,恢复外层位置、当前面板与独立文字滚动;返回栈用尽隐藏。
  • 知识卡单列,标题右侧一个按钮切换整组展开/收起;卡片跳转居中,段落起始对齐。
  • 左下笔与图例按钮同一行,图例展开为两列三行、与侧栏对齐、每项单行。笔展开不启用标黄;状态默认关闭,按钮显示“开启”,启用后显示“关闭”;另有“撤销”。术语颜色开关独立,文章不使用类别角标。
  • 随手记为右边缘竖排书签,可沿边上下拖动并记住相对位置。面板无收起按钮,点外部或Escape收起,保留草稿。写当前项目、下轮助手处理,不即时调用GPT。
  • 大图预览居中留边,右上圆形×,点遮罩/Escape关闭;支持缩放和平移。禁用图片原生拖拽,保留右键保存。手机/iPad可切换全部面板,原图与对应文字同时切换。

文件、设置与边界

每篇唯一稳定paper-id,项目路径/端口取当前环境。核心入口paper-reading.html,队列reading-notes.json,项目备份策略reader-settings.json,版本清单reader-versions.json;工作稿与正式历史快照分开。来源页/段/裁区保存于内部台账,阅读区不重复展示制作定位提示或正文截图;保留原论文PDF总入口及科学上必要的图号引用。 备份策略以项目文件为唯一依据:0/1/2历史备份,最新版另计。首次本地服务页面询问,可稍后选择;桌面离线版仅显示策略及本地服务入口,不另建离线策略。未选择时仍交付带时间标签的工作版,不清理历史。正式发布命名简称_vN.0_北京时间.html,桌面文件名固定;细则见maintenance.md。 静态全文可离线;项目笔记保存依赖独立本地服务,浏览器草稿/个人标黄不等于项目笔记。断线自动补存/移动端安全网络/即时GPT不在当前组件能力内,不虚称已实现。学习完成、理解效果和重启实测与内容/功能交付分别报告。新论文不携带本来源项目私有笔记、图片或机器路径。 将项目维护模板合并入新项目,保留适用的既有规则。仅按用户明确请求上传GitHub或安装Skill。