fix(opencode): 이미지가 게이트웨이까지 안 오던 것 — vision 모델에 modalities.image 표시 + 이미지 턴은 OpenCode 에 gateway/605 지정

고객사 실측: 게이트웨이 로그 parts=['text']. OpenCode 는 모델 설정에 이미지 입력 표시가 없으면
파트를 떨구고 텍스트만 보냄. render_opencode 가 AAF_FABRIX_VISION_MODEL_ID 모델에 attachment/modalities 를
붙이고, deploy.sh 가 OPENCODE_VISION_MODEL=gateway/605 를 채워 백엔드가 이미지 턴에 그 모델을 지정.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

5_django_backend/.env.example

@@ -2,7 +2,7 @@
 OPENCODE_BASE_URL=http://localhost:4096
 OPENCODE_AGENT=codeassist
 # 이미지 요청만 이 모델로 (로컬 OpenRouter). 고객사는 비우고 AAF_FABRIX_VISION_MODEL_ID 사용
-OPENCODE_VISION_MODEL=openrouter/google/gemma-4-31b-it
+OPENCODE_VISION_MODEL=openrouter/google/gemma-4-31b-it   # 고객사는 gateway/605 (deploy.sh 가 채움)
 
 # 토큰 서명 키 (비우면 data/.auth_secret 자동 생성)
 AUTH_SECRET=

5_django_backend/deploy.sh

@@ -14,7 +14,9 @@ grep -q '^DB_SSLMODE=' .env || echo 'DB_SSLMODE=disable' >> .env
 grep -q '^STREAM_FIRST_EVENT_TIMEOUT_S=' .env || echo 'STREAM_FIRST_EVENT_TIMEOUT_S=300' >> .env
 grep -q '^AAF_FABRIX_READ_TIMEOUT_S=' .env || echo 'AAF_FABRIX_READ_TIMEOUT_S=300' >> .env
 grep -q '^ABAP_INDEX_URL=' .env || echo 'ABAP_INDEX_URL=http://127.0.0.1:8100' >> .env
-grep -q '^BACKEND_PORT=' .env || echo 'BACKEND_PORT=8080' >> .env   # OpenCode 가 붙을 Django 포트. 없으면 8001 로 렌더돼 'Unable to connect'
+grep -q '^BACKEND_PORT=' .env || echo 'BACKEND_PORT=8080' >> .env
+# 이미지 붙은 턴은 백엔드가 OpenCode 에 이 모델을 지정 — 기본(339)으로 가면 OpenCode 가 이미지를 떨굼
+grep -q '^OPENCODE_VISION_MODEL=' .env || echo 'OPENCODE_VISION_MODEL=gateway/605' >> .env   # OpenCode 가 붙을 Django 포트. 없으면 8001 로 렌더돼 'Unable to connect'
 sed -i 's/^AAF_FABRIX_MODEL_ID=.*/AAF_FABRIX_MODEL_ID=339/; s/^AAF_FABRIX_MODELS=.*/AAF_FABRIX_MODELS=339:GaussO Flash,581:GaussO Think,605:Gemma4/' .env
 .venv/bin/python manage.py migrate --noinput
 [ -f seed/snippets.db ] && .venv/bin/python manage.py import_snippets seed/snippets.db

5_django_backend/opencode/render_opencode.py

@@ -34,7 +34,7 @@ def load_env(path: Path) -> dict[str, str]:
             k, v = line.split("=", 1)
             v = v.split("  #", 1)[0].strip().strip("\"'")  # 줄 끝 주석은 두 칸 띄고 #
             out[k.strip()] = v
-    out.update({k: v for k, v in os.environ.items() if k.startswith(("AAF_", "BACKEND_PORT", "MCP_"))})
+    out.update({k: v for k, v in os.environ.items() if k.startswith(("AAF_", "BACKEND_PORT", "MCP_", "OPENCODE_"))})
     return out
 
 
@@ -43,7 +43,15 @@ def render(env: dict[str, str]) -> str:
         (env.get("AAF_FABRIX_MODEL_ID") or "default"): "FabriX"
     }
     values = dict(env)
-    values["AAF_FABRIX_MODELS_JSON"] = json.dumps({mid: {"name": name} for mid, name in models.items()}, ensure_ascii=False)
+    # vision 모델엔 이미지 입력 가능 표시 — 없으면 OpenCode 가 이미지 파트를 떨구고 텍스트만 보냄(고객사 실측: parts=['text'])
+    vision = (env.get("AAF_FABRIX_VISION_MODEL_ID") or "").strip()
+    def _model(mid: str, name: str) -> dict:
+        m: dict = {"name": name}
+        if mid == vision:
+            m["attachment"] = True
+            m["modalities"] = {"input": ["text", "image"], "output": ["text"]}
+        return m
+    values["AAF_FABRIX_MODELS_JSON"] = json.dumps({mid: _model(mid, name) for mid, name in models.items()}, ensure_ascii=False)
     values["AAF_FABRIX_DEFAULT_MODEL"] = next(iter(models))
     values.setdefault("BACKEND_PORT", "8001")
     values.setdefault("MCP_PORT", "8888")