feat: add Camera Work AI package

2026-08-03 04:42:44 +09:00
parent 26c578416f
commit 02d76bc87c
2187 changed files with 119610 additions and 1 deletions
@@ -0,0 +1,65 @@
+# External workstation installation
+
+## Supported environment
+
+- Windows 10/11 x64
+- Unity 6000.0 or newer
+- Git 2.14 or newer available on `PATH`
+- Git LFS installed before Unity resolves the package
+
+The bundled `CWCameraWorker` contains Python 3.10 and its inference
+dependencies. Do not install Python on an artist workstation for this package.
+The worker is an onedir build: `CWCameraWorker.exe` and its `_internal` folder
+must remain together.
+
+## Install from Git
+
+In Unity Package Manager, choose **Add package from git URL** and enter:
+
+```text
+https://kindnick-git.duckdns.org/mingle/streamingle-unity-utilities.git?path=/CameraAI~#v0.1.5
+```
+
+The initial package download is large because the frozen Windows worker is
+stored with Git LFS. If Git LFS was missing during the first resolve, install
+it, remove the package lock entry, and add the package again.
+
+## Connect the reference data library
+
+The public utility package deliberately excludes authored camera, character
+motion, and source audio data. Obtain the access-controlled `CW-AI` data
+library separately with Git LFS and use one of these layouts:
+
+1. Put `CW-AI` next to the Unity project directory.
+2. Set the `CWAI_ROOT` environment variable to its absolute path before
+   launching Unity.
+3. Open `Tools > Streamingle > AI 카메라 생성`, expand `고급 · 진단`, and
+   choose the `참조 데이터 루트` manually.
+
+A valid data root contains all of the following:
+
+```text
+CW-AI/
+  DatasetExports/
+  reports/training_index.json
+  models/cut_ranker_v2.json
+```
+
+The generation window automatically finds the worker inside the installed
+package and validates the reference data before enabling generation.
+
+The reference library may be read-only. Generation caches are stored under
+the current Unity project's `Library/CWAI` directory. Set `CWAI_CACHE_ROOT`
+before launching Unity only when a different writable cache location is
+required.
+
+## First run
+
+1. Open `Tools > Streamingle > AI 카메라 생성`.
+2. Confirm the panel shows `Timeline 입력 확인 완료` after selecting a
+   Timeline containing character animation and audio.
+3. Leave `후보 풀도 새로 계산 (느림)` disabled for the normal fast path.
+4. Run `전체 카메라 자율 생성`.
+
+Generated files and caches are written to the Unity project, never into the
+reference library or the immutable Package Cache.