docs: LTX2.3 数字人 spec 补充 media.py image_path 转发缺口

writing-plans 阶段发现:media.py 只给 api/ 通道转发 image_path,comfy/ 通道收不到肖像图。
增加 media.py 一行级改动(非 api 分支把 image_path 加入 workflow_params),
标记名对齐为 $~image_path! / $~audio_path! / $prompt!。

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

docs/superpowers/specs/2026-06-18-ltx2-digital-human-workflow-design.md

@@ -35,6 +35,17 @@ LoRA + 音频驱动),把它做成 Pixelle 的 `comfy/` 工作流,经已建好的
 用户操作:Comfy Cloud 网页打开模板/share → Workflow → Export (API Format) → 放服务器
 (如 `/tmp/ltx2_api.json`)。服务端无法代取(需登录态)。
 
+## Pixelle media.py 改动(writing-plans 阶段发现的必需项)
+
+现状:`pixelle_video/services/media.py` 的 `__call__` 只把 `image_path` 转发给 `api/` 通道
+(`api_media`),**comfy/ 通道的 workflow_params 不含 image_path**。`audio_path` 经 `**params`
+能进 workflow_params,但肖像图进不去。所以 comfy/ 工作流收不到肖像图。
+
+改动:在 `media.py` 的非 api/ 分支(构建 `workflow_params` 处),把 `image_path` 也加入
+`workflow_params`(命名 `image_path`),使其能被 `$~image_path!` 标记注入。一行级小改,
+但属 Pixelle 源码(非 BoosAPI 仓库),改在容器内 `/app/pixelle_video/services/media.py`,
+并同步到宿主持久化(确认 media.py 是否在挂载卷;若在镜像内则需固化方案)。
+
 ## 架构
 
 ```
@@ -53,14 +64,13 @@ SaveVideo 产出 → 适配器 /view 取回 → Pixelle HTML 模板合成
 ## 工作流改造(实现步骤)
 
 基于用户导出的 API-format JSON:
-1. `LoadImage` 节点 → `_meta.title = "$~image!"`(必填、媒体上传)
+1. `LoadImage` 节点 → `_meta.title = "$~image_path!"`(必填、媒体上传;键名对齐 media.py 转发的 image_path)
-2. `LoadAudio` 节点 → `_meta.title = "$~audio!"`
+2. `LoadAudio` 节点 → `_meta.title = "$~audio_path!"`(键名对齐 api_video_params 注入的 audio_path)
-3. 文本提示节点(PrimitiveStringMultiline / CLIPTextEncode)→ `_meta.title = "$prompt!"`
+3. 文本提示节点(PrimitiveStringMultiline / CLIPTextEncode)→ `_meta.title = "$prompt!"`(对齐 media.py 的 prompt)
 4. `SaveVideo` 已知输出节点,自动识别,不标记
 5. 删除 `RecordAudio` 节点(UI 录音交互,服务端不需要)
 6. 成品写 `data/workflows/comfy/digital_ltx2.json`(宿主持久化,经 `./data` 挂载)
-7. 参数名(image/audio/prompt)与 Pixelle 数字人 pipeline 实际传入键对齐:实现时读
+7. 键名以 media.py 实际放入 workflow_params 的为准(image_path/audio_path/prompt),已在 writing-plans 阶段确认。
-   `pixelle_video/pipelines/asset_based.py` 确认确切键名,不一致则调整标记名。
 
 ## 验证