paper-to-html-v2.1
从研究论文PDF制作完整的中文HTML共读网页,或维护已有网页;包含核心正文完整翻译、所有主图逐面板讲解、论证链、知识卡、读者评议及可复用阅读控件。
SKILL.mdskills/paper-to-html-v2.1/SKILL.md
GitHubPaper to HTML v2
Turn research papers into interactive, explained HTML reading guides. 把研究论文变成可交互、带讲解的 HTML 阅读指南。
交付范围
默认一次交付完整首次阅读核心:英文全题与中文译题、摘要、Introduction、连续Results及全部主图/面板、作者讨论与局限、必要知识卡、全文论证链、文末读者总结与评议,以及阅读控件与随手记。内部可分批制作,每个单元执行相同质量标准;不要让用户逐图追加请求才补齐核心。 核心范围内的原文及图注提供完整中文翻译,保留条件、数量、统计、限定语和补充引用。独立完整Methods、附图详解、补充支线、复习检测、复现实验不默认生成;理解主结论必需的方法和关键附图证据在当前正文/主图中解释。进阶请求先列本文相关候选模块,按用户选择生成;明确全包/局部范围时按其请求。 不生成共读记录/阅读日志网页章节或独立日志文件。随手记及其处理回复仍保留。已有进阶内容保留,按下述归属整理。
带读交付门槛
新文章先读逐面板带读契约,保留“当前问题与数据构造 → 局部图例表 → 实际例子到判断 → 剩余问题”的完整阅读区域。先写通解释,再用教学对象装配;只保存一个 explain 短段不构成完整带读。装配覆盖、科学复述审查和浏览器交互是三项不同验收。
操作流程
术语与知识卡先执行自适应概念契约:从当前文章发现理解所需概念,再选择、消歧、建立必要前置关系并解释;词库只辅助核对,未命中不意味着忽略。每篇生成可审查清单,原文/译文/图注均有适当查阅入口,默认通用类型并允许领域适配。卡片先建立认识,再有依据地连接本文用途与相关概念;不把用户举例固化为通用词表或校准材料。匹配器、结构验收与理解/科学核查分开。
- 读入与续改定位:新论文核对正文、图注、Methods和已取得补充资料,建立本文面板清单。维护已有项目先读AGENTS、实时pending随手记及附件、已有方法草稿;保留原文、译文、锚点和用户数据。只要求对话解释或审查时不改网页。
- 核对证据再写作:读讲解范式与拆解手册,先建来源证据台账和问题网络,再写自然解释。自然解释是写作方法,不要求先在聊天中重复交付全文。校准例子只借鉴表达,不迁移旧论文事实。
- 完整讲解:按阅读与教学组织原文→完整翻译→一个明确结论模块→详细解释。结论通常1–3句,清楚优先,不设硬性字数或句数。每面板明确输入、比较对象、元素单位、局部图例、真实观察、中间推理、论证作用与界限;全文链解释上一证据为何不足及下一方法为何合适,保留并行分支和否定结果。
- 图像与装配:按图像规范检查原生矢量/位图和裁区,保留所有轴/图例,不生成式补细节。复用组件契约,用scripts/build_reader.py装配工作稿;不为新论文重新设计已经确定的交互。
- 验收与发布:执行验收,逐单元核对内容、逐视口验证交互。按维护与版本发布,桌面只保留固定同名最新版,项目内保留最新版与用户选定历史数量。报告缺失资料及未实测项,不以结构检查证明理解效果。
页面归属与顺序
| 区域 | 内容 | 默认生成 |
|---|---|---|
| 基础文章内容 | 摘要、Introduction、连续Results与主图、作者讨论/局限 | 是 |
| 知识区 | 必要基础概念、术语卡、全文论证链与简洁流程图 | 是 |
| 进阶内容 | 用户选定的Methods、附图、论文支线 | 按选择 |
| 进阶知识区 | 读者总结与评议;选定后加入复习等 | 读者评议必需,复习按选择 |
| 四区按表顺序排列,空区不显示;读者评议始终全文最后。“进阶知识区”是归属名称,不决定生成权限。知识区不冒充作者正文;首次用到陌生对象时随正文简短定义,读前基础只解释摘要后真正需要的对象和问题,不提前堆实验品系与细节。导航、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。