文档收口：工具条动作放行口径、生成动画接通与「改造 = 快速编辑」

- pitfalls.md：把「资源画布工具条的『改造』『角色动画』按钮点了没反应」按四不写改成已收口状态（不再写"尚未修"）：生成动画已接真实链路 + 参数入口为什么关、改造由快速编辑承担、其余 5 个动作逐项不做的证据；补记两条连带经验（复用共享面板时要逐个确认"可选参数在该宿主是否影响请求"；面板的泥点价就是提交按钮本身，档位常量必须与后端固定值一致）。
- decision-log.md：新增 2026-09-11 条目，记录四条决策（接通生成动画的门禁与链路、复用共享动画面板并关参数入口、改造认定为快速编辑、其余动作不接的逐项证据）与三条变异验证结果。
- AGC 技术方案「操作边界」：补 4 条当前口径（动作集合按"放进来就必须真能跑通"放行、生成动画的面板与固定档位、改造=快速编辑、未接通动作各自缺什么）。
- Issue #309 与 PR #316 正文未改：远程写操作需用户确认，decision-log 里已记录这两处需要怎么改。

docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md

@@ -66,6 +66,10 @@
 - 图片浮动工具条与图片精修草稿画布均已退役。图片的“编辑资源”入口走资源派生编辑，在资源编辑壳内提交，不再打开独立画布或图片下方快速编辑卡。
 - 资源自由画板顶部不展示“生成视频”“生成音效”“生成背景音乐”和“新增 UI 设计”等手动新建入口；顶部只保留播放、未完成编辑恢复、排序与复位等画布级动作。无源资源生成由 Agent 语义工具进入既有生成合同，已有资源的编辑和图片“生成动画”入口不受影响。
 - 图片派生编辑使用 `/api/editor/images/edits`，严格遵循 `EditorImageEditRequest`，不得携带 `assetKind`、`sourceImageSrc` 或 `sourceResourceId`。Game Agent 本地 kind 在登记编辑器来源前映射到现役 canonical kind；服务端安全业务错误必须结构化返回，不能把全部 400 折叠为同一个“平台明确拒绝”。
+- 选中资源工具的**动作集合按「放进来就必须真能跑通」放行**（`features/resource-canvas/resourceCanvasToolbarModel.ts` 的 `resolveResourceCanvasToolbarActions`）：进集合的动作必须真的接到产出新素材的链路上，未接通的一律不渲染，避免"点了没反应"的假按钮。截止 2026-09-11 真实接通的只有三项——「快速编辑」（`normalize_local_project_raster_resource` → `derive(editKind='image-reference')` → `/api/editor/images/edits`）、「生成动画」（同一段源解析 → `derive(editKind='character-animation')` → `/api/editor/character-animations/generations`，门禁为**已登记的栅格角色图**）与「下载」。
+- 「生成动画」的浮层面板直接复用共享 `ImageCanvasCharacterAnimationPanelView`，与美术画布同一份源图缩略、同一套动作预设、同一个 4000 字上限；**参数入口显式关闭**（`showParameters={false}`），因为比例 / 时长 / 清晰度 / 模型由客户端 Rust 固定为 `same` / 720p / 32 帧 / 4 秒 / `seedance2.0-fast`，面板改它们不会改变请求。面板提交按钮上的泥点价即为按钮本身（`cost` 非数字则整按钮不渲染），因此档位常量必须与 Rust 固定值一致，价格按 `calculateCharacterAnimationPrice(CHARACTER_ANIMATION_MODEL, '720p', 4)` 计算。
+- **「改造」(`redraw`) 不再另起入口**：其语义由既有的「快速编辑」承担——AGC 的快速编辑就是"按提示词基于源图重画"（`derive(image-reference, prompt)`）；`redraw` 本身在 AGC 无源图片生成被 `resource_editor.rs` 的 create 分支硬拦，`/api/editor/images/edits` 又强制要 `sourceReferenceId`，接一个独立按钮只会是同面板同链路的重复入口。
+- 其余工具条动作确认**未接通且本轮不做**，各自缺的是后端通道或交互前件：裁扩（edits 请求体不带裁扩框几何，接上是普通图片编辑）、去背景（服务端有 `/api/editor/images/background-removals`，但 AGC 无对应 `editKind`、也不在 `resource_editor.rs` 的远端路由白名单里）、提取素材（需要画布框选覆盖层 + 新 `editKind`）、完美像素 / 拆分图集（同无通道）。「参考图选择」同样不接：`ImageCanvasProjectAssetPickerDialog` 在 AGC 侧零引用，且 `DeriveLocalProjectResourceInput` 是 `deny_unknown_fields` 且没有任何参考图字段，弹窗能画但确认后的素材 id 无传输通道。
 
 ## 编辑结果投影与焦点竞态