Prepare release-ready Mini Viewer with DINOv2 feature querying

Author: RunyiYang

.gitattributes

@@ -0,0 +1,20 @@
+* text=auto eol=lf
+
+*.py text eol=lf
+*.sh text eol=lf
+*.md text eol=lf
+*.toml text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.txt text eol=lf
+
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.webp binary
+*.mp4 binary
+*.ply binary
+*.npy binary
+*.npz binary
+*.pth binary
+*.pt binary

.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: ci
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  static-release-checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+      - name: Install lightweight dev tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install tomli pyyaml ruff pytest
+      - name: Validate release metadata and syntax
+        run: |
+          python scripts/validate_release.py
+      - name: Ruff syntax-focused check
+        run: |
+          ruff check . --select E9,F63,F7,F82
+      - name: Static tests
+        run: |
+          PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 pytest -q

.gitignore

@@ -1,20 +1,52 @@
+# Python
+__pycache__/
+*/__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.ipynb_checkpoints/
+
+# Local environments
+.venv/
+venv/
+.env
+.env.*
+
+# Mini Viewer runtime outputs
+.tmp/
+outputs/
 output_logs/
-*.pth
-*.ply
-*.error
+snapshot*.png
 *.log
-checkpoints/
+*.error
 
-__pycache__/
-*/__pycache__/
-*.pyc
-teaser/
-datastats/
-results/
+# Large local data/artifacts
+checkpoints/
 data/
+results/
 figs/
-figs/*
+teaser/
+datastats/
+*.ply
 *.npy
-.tmp/
-data/
-data/*
+*.npz
+*.pth
+*.pt
+*.mp4
+
+# Patch/apply backups
+.mini_viewer_*_backup_*/
+mini_viewer_patch/
+mini_viewer_runtime_hotfix_*/
+mini_viewer_clean_runtime_*/
+mini_viewer_project_cleanup_*/
+mini_viewer_metadata_cleanup_*/
+mini_viewer_unified_project_files_*/
+mini_viewer_release_*/
+
+# OS/editor
+.DS_Store
+.vscode/
+.idea/

CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+## 0.3.0 - 2026-04-24
+
+### Added
+
+- DINOv2 aligned-feature support via `--feature-type dinov2` / `--feature-type dino`.
+- `--dino-feature` alias for visual feature tensors.
+- `--query-image` for DINOv2 image-prompt querying.
+- `--dino-model`, defaulting to `facebook/dinov2-base`.
+- `scripts/download_dino.py` for offline/cache preparation.
+- Generic `--feature-file` option that works for SigLIP2, CLIP, DINOv2, and custom features.
+- Release-ready static validation, CI, changelog, release checklist, `.gitattributes`, and normalized `.gitignore`.
+
+### Changed
+
+- Reframed the GUI folder as **Feature Query** because it now supports text, image, and vector queries.
+- Query encoders are lazy-loaded only when a model-backed query is used.
+- Feature loader now recognizes DINO/DINOv2/visual feature keys in `.npz`, `.pt`, and `.pth` files.
+- Consolidated CPU/CUDA/hotfix behavior into normal source files.
+
+### Notes
+
+- DINOv2 is visual-only. Use an image path or `--query-feature`; it does not encode text prompts.
+- Add an explicit `LICENSE` before publishing a public GitHub release.
+
+## 0.2.0 - 2026-04-24
+
+### Added
+
+- Unified CUDA/CPU environment via `env.yml` and `requirements.txt`.
+- CPU render fallback controls for interactive rerendering.
+- SigLIP2 default query encoder: `google/siglip2-so400m-patch16-512`.
+- Feature-map visualization, query recoloring, queried-feature bbox export.
+- Camera keyframe placement, Nerfstudio-style camera-path JSON export, and video rendering.