paperdelta 0.3.0__tar.gz

paperdelta-0.3.0/.gitattributes

@@ -0,0 +1,24 @@
+*.py text eol=lf
+*.tex text eol=lf
+*.csv text eol=lf
+*.json text eol=lf
+*.yaml text eol=lf
+*.yml text eol=lf
+*.md text eol=lf
+*.cjs text eol=lf
+*.js text eol=lf
+*.css text eol=lf
+*.svg text eol=lf
+*.toml text eol=lf
+*.rst text eol=lf
+MANIFEST.in text eol=lf
+.gitattributes text eol=lf
+.gitignore text eol=lf
+LICENSE -text
+*.pdf binary
+*.png binary
+*.webm binary
+# Frozen inputs and historical source snapshots require exact original bytes.
+tests/corpus/** -text
+docs/evidence/** -text
+evaluations/** -text

paperdelta-0.3.0/.github/ISSUE_TEMPLATE/01-bug-en.yml

@@ -0,0 +1,38 @@
+name: Bug report (English)
+description: Report incorrect behavior or a failed workflow.
+title: "[Bug] "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        [切换到中文](https://github.com/amos689/paperdelta/issues/new?template=02-bug-zh-CN.yml).
+        For vulnerabilities, use [private reporting](https://github.com/amos689/paperdelta/security/advisories/new).
+        Use a small original or synthetic example; omit secrets and unpublished research.
+  - type: input
+    id: environment
+    attributes:
+      label: Version and environment
+      description: PaperDelta version/commit, Python version, OS and CPU; browser if relevant.
+      placeholder: 0.2.0a1, Python 3.12, Windows 11 x64
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Exact commands and the smallest paper/data/configuration that reproduces the problem.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected and actual result
+      description: Include the exit code and relevant error or report excerpt. Remove personal paths.
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Screenshots, reduced logs or a workaround, if useful.

paperdelta-0.3.0/.github/ISSUE_TEMPLATE/02-bug-zh-CN.yml

@@ -0,0 +1,38 @@
+name: 缺陷报告（简体中文）
+description: 报告错误行为或无法完成的工作流。
+title: "[Bug] "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        [Switch to English](https://github.com/amos689/paperdelta/issues/new?template=01-bug-en.yml)。
+        安全漏洞请用[私密报告](https://github.com/amos689/paperdelta/security/advisories/new)。
+        请使用最小原创或合成样例，不要提交密钥或未公开研究内容。
+  - type: input
+    id: environment
+    attributes:
+      label: 版本与环境
+      description: PaperDelta 版本/提交、Python 版本、操作系统与 CPU；涉及报告时提供浏览器。
+      placeholder: 0.2.0a1，Python 3.12，Windows 11 x64
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: 复现方式
+      description: 完整命令，以及能够复现问题的最小论文、数据和配置。
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: 预期与实际结果
+      description: 包含退出码及相关错误或报告片段，请移除私人路径。
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: 补充信息
+      description: 有帮助时提供截图、精简日志或临时解决方法。

paperdelta-0.3.0/.github/ISSUE_TEMPLATE/03-feature-en.yml

@@ -0,0 +1,29 @@
+name: Feature request (English)
+description: Describe a research workflow PaperDelta could support better.
+title: "[Feature] "
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        [切换到中文](https://github.com/amos689/paperdelta/issues/new?template=04-feature-zh-CN.yml).
+        Describe your workflow using original or synthetic examples, without private research material.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Workflow and problem
+      description: What are you trying to do, and where does the current workflow fall short?
+    validations:
+      required: true
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Desired behavior
+      description: Give a concrete input/output example and say which decisions should remain with the author.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives or related tools
+      description: Include existing workarounds, examples or references if useful.

paperdelta-0.3.0/.github/ISSUE_TEMPLATE/04-feature-zh-CN.yml

@@ -0,0 +1,29 @@
+name: 功能建议（简体中文）
+description: 描述希望 PaperDelta 更好支持的研究工作流。
+title: "[Feature] "
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        [Switch to English](https://github.com/amos689/paperdelta/issues/new?template=03-feature-en.yml)。
+        请使用原创或合成样例描述工作流，不要提交私人研究材料。
+  - type: textarea
+    id: problem
+    attributes:
+      label: 工作流与问题
+      description: 你想完成什么？现有流程的哪一步不够好用？
+    validations:
+      required: true
+  - type: textarea
+    id: outcome
+    attributes:
+      label: 希望实现的行为
+      description: 给出具体输入/输出例子，说明哪些决定应由论文作者保留。
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 替代方案或相关工具
+      description: 有帮助时附上现有解决方法、示例或参考资料。

paperdelta-0.3.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security vulnerability / 安全漏洞
+    url: https://github.com/amos689/paperdelta/security/advisories/new
+    about: Report vulnerabilities privately / 请私下报告漏洞。

paperdelta-0.3.0/.github/PULL_REQUEST_TEMPLATE/zh-CN.md

@@ -0,0 +1,16 @@
+[English](../pull_request_template.md)
+
+## 修改内容与原因
+
+说明解决的问题、修改后的行为及具体例子；已有相关 Issue 时附上链接。
+
+## 验证
+
+列出执行的命令或手动检查、结果及仍未覆盖的范围。行为变更应说明相关输入身份、
+未知状态以及补丁/恢复案例。
+
+## 文档与证据
+
+- [ ] 用户可见消息及维护文档已配齐中英文，或本次修改不涉及它们。
+- [ ] 冻结证据和原许可证保留原始字节；需要时，为新证据建立新身份。
+- [ ] 共享样例和日志不包含凭据或私人研究材料。

paperdelta-0.3.0/.github/pull_request_template.md

@@ -0,0 +1,23 @@
+[简体中文](PULL_REQUEST_TEMPLATE/zh-CN.md)
+
+<!-- To load the Chinese form, add ?template=zh-CN.md to the new PR URL
+     (or &template=zh-CN.md if a query already exists) before writing. -->
+
+## What changes and why?
+
+Describe the problem, the resulting behavior and a concrete example. Link a related
+issue if one exists.
+
+## Validation
+
+List the commands or manual checks performed and their results. State any remaining
+limits. For behavior changes, include relevant input identity, unknown-state and
+patch/recovery cases.
+
+## Documentation and evidence
+
+- [ ] User-facing text and maintained guides have English and Chinese counterparts,
+      or this change does not affect them.
+- [ ] Frozen evidence and original licenses retain their bytes; new evidence has
+      a new identity where applicable.
+- [ ] Shared fixtures and logs contain no credentials or private research material.

paperdelta-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,86 @@
+name: PaperDelta checks
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python: ['3.11', '3.12', '3.13', '3.14']
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install '.[dev,mcp]'
+      - run: python -m ruff check src tests tools
+      - run: python -m ruff format --check src tests tools
+      - run: python -X utf8 tools/check_docs.py
+      - run: python -X utf8 tools/run_tests.py -q --junitxml=build/test-results.xml
+      - run: python -X utf8 tools/validate_examples.py --out build/examples-validation
+      - run: python -X utf8 tools/build_release.py --out build/release-candidate
+      - run: python -X utf8 tools/audit_release.py --directory build/release-candidate
+      - name: Keep test evidence
+        if: always()
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: tests-${{ matrix.os }}-${{ matrix.python }}
+          path: build/test-results.xml
+          if-no-files-found: warn
+
+  macos:
+    name: macOS ${{ matrix.host.arch }} / Python ${{ matrix.python }}
+    strategy:
+      fail-fast: false
+      matrix:
+        host:
+          - {os: macos-15, arch: arm64}
+          - {os: macos-15-intel, arch: x86_64}
+        python: ['3.11', '3.12', '3.13', '3.14']
+    runs-on: ${{ matrix.host.os }}
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install build
+      - run: python -X utf8 tools/build_release.py --out build/release-candidate
+      - run: python -X utf8 tools/audit_release.py --directory build/release-candidate
+      - name: Validate native installed wheel, filesystem and terminal
+        run: >-
+          python -X utf8 tools/validate_platform.py
+          --wheel build/release-candidate/*.whl
+          --out build/macos-validation
+          --require-system Darwin
+          --expected-arch ${{ matrix.host.arch }}
+      - name: Keep macOS evidence
+        if: always()
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: macos-${{ matrix.host.arch }}-python-${{ matrix.python }}
+          path: |
+            build/macos-validation/evidence.json
+            build/macos-validation/core-smoke.json
+            build/macos-validation/*.log
+            build/macos-validation/suite/**/*.json
+            build/macos-validation/suite/**/*.log
+            build/macos-validation/suite/**/*.xml
+            build/macos-validation/examples/evidence.json
+            build/macos-validation/ci-demo/evidence.json
+            build/release-candidate/package-audit.json
+          if-no-files-found: warn

paperdelta-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,83 @@
+name: Publish stable release to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Existing stable release tag (for example v0.3.0)
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pypi-${{ inputs.tag || github.event.release.tag_name }}
+  cancel-in-progress: false
+
+jobs:
+  verify:
+    if: github.repository == 'amos689/paperdelta' && (github.event_name == 'workflow_dispatch' || !github.event.release.prerelease)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+      actions: read
+    env:
+      RELEASE_TAG: ${{ inputs.tag || github.event.release.tag_name }}
+      GH_TOKEN: ${{ github.token }}
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+        with:
+          ref: ${{ inputs.tag || github.event.release.tag_name }}
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: '3.12'
+      - name: Verify tag, successful CI and exact GitHub release assets
+        run: python -X utf8 tools/verify_release.py --tag "$RELEASE_TAG" --out build/public-release
+      - run: python -X utf8 tools/audit_release.py --directory build/public-release
+      - name: Check package metadata and isolated core installation
+        run: |
+          python -m pip install twine
+          python -m twine check --strict build/public-release/*.whl build/public-release/*.tar.gz
+          python -m venv build/core-install
+          build/core-install/bin/python -m pip install build/public-release/*.whl
+          build/core-install/bin/python -I tools/package_smoke.py --out build/public-release/core-smoke.json
+      - name: Select only verified Python distributions
+        run: |
+          mkdir dist
+          cp build/public-release/*.whl build/public-release/*.tar.gz dist/
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: pypi-distributions
+          path: dist/
+          if-no-files-found: error
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: publication-verification
+          path: |
+            build/public-release/publication-verification.json
+            build/public-release/package-audit.json
+            build/public-release/core-smoke.json
+
+  publish:
+    needs: verify
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: pypi
+      url: https://pypi.org/project/paperdelta/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          name: pypi-distributions
+          path: dist/
+      - name: Publish the verified release with short-lived credentials
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          skip-existing: true

paperdelta-0.3.0/.gitignore

@@ -0,0 +1,18 @@
+.venv/
+.venv-*/
+.tools/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+build/
+.paperdelta/transactions/
+.paperdelta/transactions.lock
+.paperdelta/proposals/
+.paperdelta/patches/
+.paperdelta/ui.json
+

paperdelta-0.3.0/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+[简体中文](CHANGELOG.zh-CN.md)
+
+## 0.3.0 — batch binding and continuous review
+
+- Ship a complete offline `demo` in the core wheel and support PyPI installation.
+- Reuse explicit CSV experiment definitions across batch metrics and paper locations;
+  support bounded literal table cells and all/subset/cancel confirmation.
+- Add numeric review scopes and reasoned, context-bound exclusions without hiding
+  accepted failures. Preserve backups when adopting configuration schema 2.
+- Watch content changes, mark pending checks, refresh reports and show a linked review queue.
+- Add four in-memory batch MCP tools (seventeen overall), with pagination, correction,
+  stale-input checks and explicit author acceptance through the CLI.
+- Write report schema 2 while reading version 1, and maintain bilingual UI and guides.
+- Publish stable versions from verified GitHub assets through PyPI Trusted Publishing.
+  Remove Related work from both READMEs; retain historical evaluation records.
+
+See [workflows](docs/workflows.md) and [release notes](docs/v0.3.md).
+
+## 0.2.0a1 — first public alpha
+
+- Trace changed CSV/JSON evidence to declared numeric occurrences, comparisons
+  and figure inputs in existing LaTeX papers. Keep incomplete evidence explicit.
+- Review findings in an offline HTML report with English/Chinese switching,
+  search, filters and expandable evidence. Localize CLI, diagnostics and MCP text.
+- Connect a paper with typed `guide` steps and explicit final confirmation.
+  Repair moved locations with old/new context while preserving scientific meaning.
+- Preview verified numeric patches, apply with stale-input checks, recheck and
+  recover original bytes when later edits have not intervened.
+- Expose thirteen optional read-only MCP tools and a CI adapter that compares
+  target-commit snapshots and highlights mapping/rule/review changes.
+- Ship original examples, bilingual documentation, feedback forms, validation
+  tools and separately licensed evaluation materials.
+
+Requires Python 3.11+. Checking needs no model key, GPU or TeX installation.
+The GitHub release supplies a wheel, source distribution, evaluation bundle and
+SHA256 checksums. No package-index release is available.
+
+### Validation and limits
+
+[Local acceptance](docs/v0.2-acceptance.md) and
+[native Apple Silicon results](docs/macos-validation-2026-10-03.md) retain exact
+commands, identities and failures. The [Actions matrix](https://github.com/amos689/paperdelta/actions/workflows/ci.yml)
+covers Python 3.11–3.14 on Windows, Linux and both Mac architectures; inspect the
+release commit's run and artifacts for its actual results.
+
+This alpha checks an explicitly declared static LaTeX subset. Dynamic TeX,
+significance inference and general scientific correctness are outside its scope.
+The 150-case study uses already observed papers with synthetic evidence: 126 cases
+passed complete expectations and 24 failed. It is not a fresh accuracy benchmark.
+Local model experiments did not establish a reliable automatic mapper. Independent
+user feedback starts after launch. See [evaluation](docs/evaluation.md) and
+[rules](docs/rules.md). Earlier `0.1.0a2` records are local development history.

paperdelta-0.3.0/CHANGELOG.zh-CN.md

@@ -0,0 +1,48 @@
+# 更新日志
+
+[English](CHANGELOG.md)
+
+## 0.3.0 — 批量绑定与持续审查
+
+- 核心 wheel 内置完整离线 `demo`，支持 PyPI 安装。
+- 在多个指标和论文位置间复用明确的 CSV 实验定义，支持限定字面表格单元格及
+  全部、部分选择和取消确认。
+- 新增数字审查范围及绑定上下文、含理由的排除，不能隐藏已有失败；升级配置版本 2 时保留备份。
+- 监听内容变化，标记等待重查，刷新报告并展示可跳转的处理清单。
+- 增加四个内存批量 MCP 工具，总计十七个，支持分页、纠正及过期检查，仍由 CLI 明确确认。
+- 新报告使用 schema 版本 2，继续读取版本 1，中英文界面和教程同步。
+- 通过 PyPI Trusted Publishing 发布经过核验的 GitHub 正式版产物。
+  两个 README 移除 Related work，保留历史评测记录。
+
+详见[工作流](docs/zh-CN/workflows.md)及[发行说明](docs/zh-CN/v0.3.md)。
+
+## 0.2.0a1 — 首次公开 Alpha
+
+- 将 CSV/JSON 证据变化关联到现有 LaTeX 论文中明确绑定的数字、比较结论和图表输入，
+  明确保留证据不完整的状态。
+- 提供支持中英文切换、搜索、筛选和证据展开的离线 HTML 报告，并本地化 CLI、
+  诊断及 MCP 说明。
+- 使用带类型的 `guide` 步骤及最终明确确认接入论文；结合新旧上下文修复移动位置，
+  保持科学含义不变。
+- 预览经过验证的数值补丁，检查输入是否过期，再应用、重查；没有后续改写时，
+  可恢复原始字节。
+- 提供十三项可选只读 MCP 工具，以及读取目标提交快照、提示映射/规则/审阅变化的
+  CI 适配器。
+- 提供原创样例、双语文档、反馈表单、验证工具和按原许可单独分发的评测材料。
+
+需要 Python 3.11 以上版本。检查不需要模型密钥、GPU 或 TeX 安装。
+GitHub 发行版提供 wheel、源码包、评测包及 SHA256 校验文件，尚未发布到包索引。
+
+### 验证与限制
+
+[本地验收](docs/zh-CN/v0.2-acceptance.md)和
+[原生 Apple Silicon 结果](docs/zh-CN/macos-validation-2026-10-03.md)保留准确的命令、
+身份及失败记录。[Actions 矩阵](https://github.com/amos689/paperdelta/actions/workflows/ci.yml)
+覆盖 Windows、Linux 和两种 Mac 架构的 Python 3.11–3.14，实际结果以发行提交的
+运行记录和产物为准。
+
+本 Alpha 检查明确声明的静态 LaTeX 子集；动态 TeX、显著性推断和整体科学正确性
+不在支持范围。150 案例研究使用已见论文配合合成证据，其中 126 项满足完整预期、
+24 项失败，不能作为新样本准确率。已有本地模型实验未证明自动映射可靠。
+独立用户反馈在上线后收集。详见[评测](docs/zh-CN/evaluation.md)和
+[规则](docs/zh-CN/rules.md)。较早的 `0.1.0a2` 记录属于本地开发历史。

paperdelta-0.3.0/CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing
+
+[简体中文](CONTRIBUTING.zh-CN.md)
+
+Use the [English or Chinese issue forms](https://github.com/amos689/paperdelta/issues/new/choose)
+for bugs and feature requests. Include the command, version and a minimal original
+paper/data example. Remove private paths, credentials and unpublished research from
+attachments. Report vulnerabilities through the [security policy](SECURITY.md).
+
+Pull requests use an English template by default. To use Chinese, append
+`?template=zh-CN.md` to the new pull request URL before writing (or
+`&template=zh-CN.md` if it already has a query). See the
+[Chinese template](.github/PULL_REQUEST_TEMPLATE/zh-CN.md). Write in either language;
+new user-facing messages and maintained documentation need both translations.
+
+Use Python 3.11+ and install `python -m pip install -e '.[dev,mcp]'`.
+Run `python tools/run_tests.py -q`, `python -m ruff check src tests tools` and
+`python -m ruff format --check src tests tools`. Tests use fresh project-local
+scratch directories under `.tools/test-runs`; do not replace them with a shared
+temporary directory that another process might own.
+
+Start with a concrete paper/data example and state what the checker should know,
+what it should leave unknown, and which bytes it may change. Useful contributions
+include missing parser cases, data identity mistakes, macro contracts, explicit
+unit conversions and documentation that reduces first-time mapping work.
+
+Keep the checker independent of model providers, experiment execution and TeX
+compilation. A new numeric patch rule needs stale-input, exact-span and recovery
+coverage. It must not silently strengthen a scientific claim. Preserve unknown
+states and coverage denominators; do not improve a pass rate by dropping cases.
+
+Use original fixtures or record permission and license for imported material.
+Public source availability alone does not grant redistribution rights to papers,
+figures or datasets. Record upstream attribution for any copied implementation.
+Current code was written for this project; related work is in `docs/research.md`.
+
+The default license is MIT. Schema changes should include a migration decision,
+version behavior and examples. Cross-platform CI configuration is checked in;
+only actual successful runs count as compatibility evidence.
+
+Add English and Simplified Chinese messages together; preserve placeholders and
+machine identifiers. Pair maintained documentation pages and link to their matching
+translation. See [language conventions](docs/languages.md). Keep original licenses
+and frozen study records intact. New studies pin a new implementation identity;
+do not update an old lock to make a changed implementation appear reproduced.
+
+Use a GitHub noreply address in this repository's local Git configuration when
+contributing with email privacy. Do not place personal addresses in fixtures or
+published logs. Third-party author credits and license texts remain intact.
+
+README logos and static badges are repository-owned SVG assets. Regenerate badges
+with `python tools/build_badges.py` after changing package version or Python
+requirements; `python tools/check_docs.py` checks they match the configuration.
+The CI badge displays live GitHub results. Keep badge claims tied to declared
+dependencies and actual platform evidence.

paperdelta-0.3.0/CONTRIBUTING.zh-CN.md

@@ -0,0 +1,43 @@
+# 贡献指南
+
+[English](CONTRIBUTING.md)
+
+通过[中英文问题表单](https://github.com/amos689/paperdelta/issues/new/choose)提交缺陷或
+功能建议，附上命令、版本及最小原创论文/数据样例。附件中移除私人路径、凭据及
+未公开研究内容。安全漏洞请按[安全政策](SECURITY.zh-CN.md)私下报告。
+
+PR 默认使用英文模板。创建 PR 时，在网址末尾添加 `?template=zh-CN.md` 后再填写；
+已有查询参数时添加 `&template=zh-CN.md`。也可参考[中文模板](.github/PULL_REQUEST_TEMPLATE/zh-CN.md)。
+讨论可以使用任一语言；新增用户界面消息和维护文档需配齐两种语言。
+
+使用 Python 3.11 以上版本，安装 `python -m pip install -e '.[dev,mcp]'`。
+运行 `python tools/run_tests.py -q`、`python -m ruff check src tests tools` 和
+`python -m ruff format --check src tests tools`。测试在 `.tools/test-runs` 下创建
+独立临时目录，不要改用可能由其他进程占用的共享临时目录。
+
+从具体论文及数据样例出发，说明检查器应知道什么、应保持哪些未知，以及哪些字节
+允许改变。欢迎补充解析边界、数据身份错误、宏约定、明确单位转换，以及降低首次
+映射难度的文档。
+
+保持检查器独立于模型供应商、实验执行和 TeX 编译。新的数值补丁规则必须覆盖输入
+过期、准确位置和恢复，不得悄悄强化科学结论。保留未知状态和覆盖分母，不能通过
+删除案例提高通过率。
+
+使用原创样例，或记录导入材料的许可和授权。源文件公开不代表论文、图表或数据集
+可以再分发。复制实现时记录上游署名。当前代码为本项目编写，相关工作见
+[调研记录](docs/zh-CN/research.md)。
+
+默认许可证为 MIT。schema 变化应包括迁移决定、版本行为和示例。仓库包含跨平台
+CI 配置，但只有真实成功运行才算兼容性证据。
+
+中英文消息一起添加，保留占位符和机器标识符。维护中的文档应有对应译文并互相
+链接，详见[语言约定](docs/zh-CN/languages.md)。原许可证及冻结研究记录保持不变。
+新研究锁定新的实现身份，不得修改旧锁文件，让变更后的代码冒充原实验复现。
+
+需要邮箱隐私时，在本仓库的 Git 局部配置中使用自己的 GitHub noreply 邮箱。
+不要在样例或公开日志中写入个人邮箱；第三方作者署名及许可证原文保持完整。
+
+README Logo 和静态徽章是随仓库维护的 SVG 文件。修改包版本或 Python 要求后，
+执行 `python tools/build_badges.py` 重新生成；`python tools/check_docs.py` 会核对
+它们是否与配置一致。CI 徽章展示 GitHub 的实时结果，其他徽章应与真实依赖和平台
+验证证据保持一致。

paperdelta-0.3.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 PaperDelta contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+