1

docs/technical/HYPER3D_RODIN_GEN2_MODEL_GENERATION_2026-05-08.md

@@ -44,7 +44,8 @@ RODIN_MODEL_REQUEST_TIMEOUT_MS
 
 1. `HYPER3D_API_KEY` / `RODIN_API_KEY` 只允许写入本地或生产私密环境，不提交到 Git。
 2. 缺少 API Key 时，后端返回 `503 SERVICE_UNAVAILABLE`。
-3. `HYPER3D_BASE_URL` 默认使用公开 API 基础地址；如果团队后续改用代理网关，可通过环境变量覆盖。
+3. 本地真实联调推荐把 key 放在 `.env.secrets.local`；`npm run api-server`、`npm run dev:rust` 与 `npm run dev` 均应保持“外层 shell 变量优先，随后 `.env`、`.env.local`、`.env.secrets.local` 逐层覆盖”的口径，避免 `.env` 里的空示例值压掉私密 key。
+4. `HYPER3D_BASE_URL` 默认使用公开 API 基础地址；如果团队后续改用代理网关，可通过环境变量覆盖。
 
 ## 4. 后端路由
 
@@ -91,6 +92,7 @@ RODIN_MODEL_REQUEST_TIMEOUT_MS
 6. `meshMode` 限定为 `Quad/Raw`，默认 `Quad`。
 7. `addons` 首版只允许 `HighPack`。
 8. `bboxCondition` 必须为 3 个正数，按上游要求序列化为 JSON 字符串。
+9. `subscriptionKey` 是 Hyper3D 返回的 opaque token，状态查询只校验非空，不在本地做 256 字符等固定长度限制，避免长 token 阻断抓大鹅草稿内联模型生成。
 
 ## 6. 返回语义