让论文PDF中每个数字都能追溯到生成它的代码行

当需要保证论文数值可复现、可验证来源时，用LaTeX超链接把每个数字锚定到对应代码行。

适用场景

解决思路

1. 在实验代码输出中为每个数值添加 \hypertarget 标签，格式为 {前缀}{行号}{字母}（同一行多个值用 a、b、c 区分），例如：print(f"\\hypertarget{{R1a}}{{45.3}}") 表示均值准确率，print(f"\\hypertarget{{R1b}}{{2.1}}") 表示标准差。
2. 在论文正文中用 \hyperlink 引用这些标签生成可点击链接，例如：Our method achieves \hyperlink{R1a}{45.3}\% accuracy ($\pm$\hyperlink{R1b}{2.1})。
3. 对由其他数值计算得出的值，使用 \num{公式, "说明"} 在编译时求值，例如：The improvement is \num{45.3 - 38.7, "accuracy gain"}\% 。
4. 在附录中生成完整代码清单，并在相关代码行插入 \hypertarget 锚点，例如在 lstlisting 中用 escapechar=@ 包裹：@\hypertarget{code1}{}@result = model.evaluate(test_data)。
5. 在 LaTeX 导言区引入所需宏包：\usepackage{hyperref} 和 \usepackage{listings}。
6. 用脚本扫描引用完整性：运行 python ~/.claude/skills/backward-traceability/scripts/ref_numeric_values.py --scan paper/main.tex --output report.json，报告所有 hypertarget、hyperlink、孤立引用和未被引用的数值。
7. 用脚本交叉校验数值一致性：运行 python ~/.claude/skills/backward-traceability/scripts/ref_numeric_values.py --verify paper/main.tex --code-output results.txt，比对论文文本与代码输出中的数值并报告不匹配项。
8. 验证追溯性：确保论文中每个数字都有对应的代码 \hypertarget，每个 \num{} 公式求值正确，并在编译后点击测试每个超链接是否跳转到正确的代码行。
9. 遵守规则：论文中每个数值结果必须可追溯到代码输出；绝不手动输入数字，始终引用已打标签的输出；任何派生/计算值都用 \num{}；附录代码清单必须与实际执行的代码一致；编译后验证所有超链接可正确解析。

适用边界 · 注意事项

• 不使用 LaTeX 编译论文或无法引入 hyperref/listings 宏包的场景。
• 数值并非由可定位的代码行生成（如纯手工估算、外部不可复现数据源）时。
• 仅需一次性快速写作、不要求可复现性或数据完整性验证的场合。