Document the local-only reference collector
Full build / Import + headless tests (push) Successful in 41s
Full build / Full desktop build + optional release (push) Skipped

This commit is contained in:
zwitschi committed 2026-11-03 17:12:32 +01:00
1 parent 43c17ce3c0
commit 480a1ba05f
1 file changed
+16
+16
View File
@@ -215,6 +215,22 @@ weathered) of one reference photo's framing, each with its `.refgen.json` proven
concept board stays comparable with its photo board. The reference passes the same SIDECAR licence concept board stays comparable with its photo board. The reference passes the same SIDECAR licence
gate as `--reference` on `generate`. gate as `--reference` on `generate`.
### Local-only reference collection (`refcollect`)
`tools/refcollect.py` downloads images from DuckDuckGo image search into `tmp/research/<slug>/` for
development reference only. It applies **no licence gate** (rows are marked `local_only` /
`unchecked-local`); everything it fetches must never be committed or promoted into
[`screens/refs/`](screens/refs/README.md) without the normal sidecar licence + privacy gate. This
is the owner-authorised local-only override (TODO.md §3D model re-evaluation → A).
```bash
python3 tools/refcollect.py search "Comedy Store Sunset Boulevard" --slug comedy-store --limit 20
python3 tools/refcollect.py sheet --slug comedy-store # local contact sheet (never committed)
```
Requires `pip install duckduckgo-search` (renamed `ddgs` upstream). DuckDuckGo rate-limits by IP
(HTTP 202) and the tool retries with backoff, so run per-venue batches spaced out.
### Reference-board research (`refboard`) ### Reference-board research (`refboard`)
`tools/refboard.py` searches, fetches and documents Wikimedia Commons photos of a real location for `tools/refboard.py` searches, fetches and documents Wikimedia Commons photos of a real location for