nature-image2ppt

1# Nature Image2PPT
2 
3Use this directory as the complete runtime. Run deterministic actions only through:
4 
5```bash
6python <image2ppt-root>/cli/image2ppt/cli.py <command> ...
7```
8 
9Use Python 3.10 or later with `requirements.txt` installed. When a dedicated
10environment exists, substitute `<image2ppt-root>/.venv/bin/python` on macOS/Linux
11or `<image2ppt-root>/.venv/Scripts/python.exe` on Windows for every `python`
12command below. Do not continue after a failed `doctor`; install only the reported
13missing dependency, then rerun it.
14 
15Do not discover or invoke another Skill, CLI, Prompt, Schema, module, or state machine.
16 
17## Read the local contracts progressively
18 
19Always read `references/workflow.md`. Read `references/runtime-dependencies.md`
20only for setup or `doctor` failures, and read
21`references/ocr-text-hints-contract.md` only when choosing or troubleshooting OCR.
22 
23Before writing a page manifest, read `references/page-decision-tree.md` and
24`references/manifest-schema.md`. Add only the references needed by that page:
25 
26- structured or compound page: `references/region-decomposition.md` and
27  `references/object-routing.md`;
28- arrows: `references/manifest-arrow-extension.md`;
29- raster assets or image-backend work: `references/assets-provenance-contract.md`.
30 
31Before accepting or delivering output, read `references/qa-contract.md`.
32 
33## Preserve the single source of truth
34 
35- Treat `page_jobs.json` as the only page-state source.
36…