Skip to content

Releases: MrGeDiao/paper-reading-zh

paper-reading-zh v0.1.4 - Docs consistency and README refresh

Choose a tag to compare

@MrGeDiao MrGeDiao released this 01 Jul 05:48

paper-reading-zh v0.1.4

v0.1.4 是一次文档一致性修补,不引入新的阅读模式或证据规则行为。改动集中在把 v0.1.2 遗留的自检与正文矛盾修好、把公开文档对齐到可核验的事实。

背景

v0.1.3 发布后的一次评审发现一批文档级问题:v0.1.2 数学规则改版时「输出前自检」清单与反例文本没跟着同步、issue 模板版本示例写死、DESIGN.md 引用公开读者拿不到的内部工具、深读触发词在三入口之间不一致。这些都不改变规则行为(或只是把规则对齐到 v0.1.2 已发布的意图),按轻量语义版本走 patch。

变更

  1. 修复自检与正文矛盾paper-reading-zh/SKILL.md 与两份 Web prompt 的「输出前自检」原 公式是否全部使用 LaTeX 改为 公式与多符号表达式是否使用 LaTeX;叙述段的单个变量是否未被强行包成行内公式。旧写法会让严格执行自检的模型在最后一步把叙述里的裸变量重新包成行内公式,正好回退 v0.1.2 想修的问题。
  2. 数学规则反例文本对齐:反例从 $x$$y$ 更新为 \(x\)$x$,与 v0.1.2 的行内公式新默认写法一致(三入口同步)。
  3. 触发词同步可行性判断 补进两份 Web prompt 的深读意图列表,与 SKILL.md 及各自工程拆解模式的措辞对齐,消除文件内前后不一致。
  4. issue 模板版本无关化.github/ISSUE_TEMPLATE/bug_report.yml 的版本示例改为版本无关写法,不再随发版过时。
  5. DESIGN.md 去除无出处内部工具名quick_validate.py 改为「AgentSkills 风格的 frontmatter / 目录结构校验(本仓库不附带校验脚本)」;裸 shuorenhua 改为「中文文风复查工具(如开源的 shuorenhua 规则包)」,并移除 v0.1.3 引入的 Maintenance Provenance 段,回核三条清单原样保留。
  6. README 版本标识:badge 更新到 v0.1.4,去掉“版本与文档”里随发版过时的单行版本说明。围绕证据演示的 README 正文已随 v0.1.3 发布,本版本不再改动。

未改动:

  • 阅读模式、证据规则、触发意图集合、术语规则均无行为变化。
  • 行间公式仍用 $$...$$
  • 安装方式与目录结构不变。
  • 已发布的 v0.1.3 版本记录和 docs/release-v0.1.3.md 保留原样。

决策依据

  • 自检项与正文相互矛盾是比“规则不够全”更隐蔽的问题:它让规则包内部自我抵消。这一条对齐属于修复 v0.1.2 未完成的意图,不是新增行为,故归 patch。
  • 内部工具名对公开读者不可复现,与项目“可核验”的口径自相矛盾;用可核验表述替换,不承诺仓库不存在的脚本。
  • 版本示例写死会在每次发版后过时,改成指向 README badge / CHANGELOG 的版本无关写法后无需再动。

已知限制

  • 本版本的规则文本改动(自检项修复、反例文本对齐、触发词同步)均为对齐 v0.1.2 已发布行为的修补,不引入新的阅读或证据行为,按验收通则豁免新增真实论文验证记录;四平台完整端到端回归仍未覆盖,排期在后续 minor 版本。
  • ChatGPT 网页端对 \(...\) 的渲染支持仍取决于 OpenAI 的实现,回退条件(平台明确支持 dollar-style 时可用 $...$)自 v0.1.2 起保留。

建议 tag

v0.1.4

建议发布标题

paper-reading-zh v0.1.4 - Docs consistency and README refresh

paper-reading-zh v0.1.3 - Documentation provenance update

Choose a tag to compare

@MrGeDiao MrGeDiao released this 17 Jun 08:28

paper-reading-zh v0.1.3

v0.1.3 是文档规划和维护溯源版本。它记录本仓如何使用本地多 agent 协作方式辅助文档更新,但不改变 paper-reading-zh 的论文阅读规则、触发边界或安装方式。

背景

DESIGN.md 是本项目规划、兼容矩阵和证据规则的单一事实源。v0.1 设计约束明确不把 paper-reading-zh 做成多 agent 调度器,也不引入固定文献流水线、traceability manifest 或 claim id。

本次更新需要说明维护者可以在文档设计、审稿和风险扫描中使用协作工作流,同时避免让读者误解为 skill 本身新增了多 agent 论文精读能力。

变更

  1. 版本标识:README badge 和项目状态更新到 v0.1.3
  2. 维护溯源DESIGN.md 新增 Maintenance Provenance,记录本次使用 tri-collab 式本地维护工作流作为协作方式。
  3. 公开发布面DESIGN.md 的 Public Surface 列表增加 docs/release-v0.1.3.md
  4. 验证状态:说明 v0.1.3 只更新公开文档、版本记录和维护溯源,不需要新的端到端论文阅读回归。

未改动:

  • paper-reading-zh/SKILL.md
  • paper-reading-zh/references/modes.md
  • prompts/claude-project.mdprompts/chatgpt-project.md
  • 阅读模式、证据规则、兼容矩阵、安装方式和输出契约。

决策依据

  • 本仓版本策略允许公开文档的兼容增强走 patch。
  • tri-collab 是维护者本地使用的协作流程引用;公开文档只记录流程名称,不记录维护者本机绝对路径。
  • 把维护过程和用户侧运行时行为分开,可以保留 v0.1 的简洁边界:论文精读规则仍只关注材料范围、证据边界和输出结构。

已知限制

  • 本版本只记录维护协作方式,不公开维护者本机 skill 路径,也不作为公共用户入口。
  • 本版本没有新增论文样例验证,也没有完成 Claude Project、ChatGPT Project、Codex、Claude Code 四个平台的完整端到端回归测试。
  • 本版本不代表 paper-reading-zh 会自动调用 Claude Code、Antigravity 或其他 agent 参与论文阅读。

建议 tag

v0.1.3

建议发布标题

paper-reading-zh v0.1.3 - Documentation provenance update

paper-reading-zh v0.1.2 - Inline math rendering stability

Choose a tag to compare

@MrGeDiao MrGeDiao released this 27 May 15:05

paper-reading-zh v0.1.2

v0.1.2 修改数学表达规则,规避 Codex Desktop 等客户端中行内 $...$ 渲染不稳定导致裸 dollar 符号出现在输出里的问题。

背景

v0.1.1 发布后发现,Codex Desktop(以及部分其他 Markdown 客户端)对行内 $...$ 的渲染时有时无:dollar 符号有时被当作普通文本输出,导致读者看到的不是公式而是 $\tau$ 这样的裸字符串。行间 $$...$$ 不受影响。

这不是规则包本身的 bug,渲染由客户端决定,但规则可以选择更稳健的默认写法来降低影响面。

变更

  1. 行内公式默认写法:从 $...$ 改为 \(...\)。只有当前平台明确支持 dollar-style 行内数学时才使用 $...$,且要求 $ 两侧有 ASCII 空格或标点边界。
  2. 单变量叙述:中文叙述中出现单个变量时,优先用中文术语或普通符号(xy),不要反复输出 $x$$y$
  3. 符号示例对齐:SKILL.md 中核心符号示例从 $\tau$$\lambda$$\alpha$ 改为 \(\tau\)\(\lambda\)\(\alpha\)
  4. 同步范围paper-reading-zh/SKILL.mdprompts/claude-project.mdprompts/chatgpt-project.md 三个文件均已更新。

未改动:

  • 行间公式仍用 $$...$$
  • 证据规则、阅读模式、触发边界、术语规则均无变化。
  • 不影响安装方式或目录结构。

决策依据

  • \(...\) 是标准 LaTeX 行内数学定界符,在支持 MathJax 或 KaTeX 的客户端上普遍可用。
  • 对于不支持任何 LaTeX 渲染的纯文本环境,\(x\) 的可读性不比 $x$ 差,但不会产生孤立 dollar 符号的歧义。
  • 单变量用中文术语或 code span(如 x)替代,在所有客户端上都稳定显示。

已知限制

  • ChatGPT 网页端对 \(...\) 的渲染支持取决于 OpenAI 的实现。如果在 ChatGPT Project 中遇到 \(...\) 不渲染的情况,可以在 Project instructions 中手动把规则改回 $...$。本版本的规则已保留“当前平台明确支持 dollar-style 时可使用 $...$”的回退条件。
  • 这次变更不能保证所有客户端都正确渲染行内数学,渲染始终由客户端决定。

建议 tag

v0.1.2

建议发布标题

paper-reading-zh v0.1.2 - Inline math rendering stability

paper-reading-zh v0.1.1 - Open-source readiness

Choose a tag to compare

@MrGeDiao MrGeDiao released this 27 May 08:08

paper-reading-zh v0.1.1

v0.1.1 是开源准备版本,重点不是增加新模式,而是把公开维护面和真实验证证据补齐。

Highlights

  • 新增 CHANGELOG.mdCONTRIBUTING.mdSECURITY.md、Issue 模板和 PR 模板。
  • 新增真实论文最小端到端验证记录:docs/validation-2026-05-27.md
  • README 增加从 GitHub clone 后安装 Agent Skill 的命令。
  • DESIGN / README 更新验证状态:已经完成一次真实 PDF 文本层验证,但仍不宣称全平台完整回归。

Validation

本版本用一篇未随仓库发布的 16 页 PDF 做了最小验证:A Time Scaling Theory for Multi-Layer Electronic Systems。验证重点包括材料范围说明、观点 / 路线图论文变体选择、实验 / 产业数字锚点、公式抽取乱码边界,以及 venue / CCF / 官方代码未核验时不补事实。

Public Release Note

公开发布时建议使用干净公开仓或 orphan public branch,不直接把包含工作记录、草稿或本地验证材料的完整开发历史改成 public。

建议 tag:v0.1.1

建议发布标题:paper-reading-zh v0.1.1 - Open-source readiness