模板失败反馈 / Template failure feedback

遇到制作、更新、声音、字幕、布局或导出问题，可以说“把这个问题反馈给模板维护方”。反馈不收费，不影响现有制作和更新，不删除原包、工程或失败结果。

提交后先核查原因；确认属于模板问题后，通常在次日更新版本中修复。复杂问题可能需要更长时间，进展以反馈编号查询结果为准。收到反馈不代表已经确认模板缺陷或修复。

给 AI 助手

1. 使用已验签的原始个人 .motion 与原 Key。只收集本次相关且已授权的对话节选、实际失败步骤、预期/实际结果和错误。原因不确定就写“未知/推测”。不读取聊天数据库、其它对话、环境变量或无关目录，不上传原片、整包、保护源码、整个工程或截图。
2. 当前工具需 1.0.0-rc.28 或更新。新下载包内已提供。旧包不含此命令时，从固定官方地址 https://motiongit.com/assets/motion-runtimes/1.0.0-rc.28.json 读取公开 SHA256、bytes、minimumNode，再下载同目录 1.0.0-rc.28.mjs 到新的私有工具目录（POSIX 0700，Windows 仅当前用户可读）。系统 HTTPS 和哈希工具校验字节数及 SHA 后才执行；禁止重定向、关闭 TLS 或使用包内公钥替代官方信任。用已有 Node.js 22+，无需安装全局工具、换 Key 或重打包。不得覆盖旧工具/模板。
3. 写一个本地输入 JSON，字段如下（用实际情况替换，未知环境写 unknown；工具会自动填入 OS、架构、Node）：

{
  "summary": "预览失败的简述",
  "stage": "preview",
  "expected": "预期结果",
  "actual": "实际观察到的失败",
  "suspectedCause": "未知；猜测与事实分开",
  "steps": ["实际操作步骤"],
  "error": "相关错误节选",
  "conversation": [{"role": "user", "content": "相关且授权提供的需求"}],
  "environment": {"os": "auto", "arch": "auto", "node": "auto", "assistant": "实际助手名称或 unknown", "model": "实际模型或 unknown"}
}

1. 先准备草稿，不上传：

node <已校验的工具.mjs> api <原始个人.motion> feedback-prepare <输入.json> <新草稿.json>

工具会遮蔽已知 Key、常见凭据、邮箱、手机号及用户主目录；自动脱敏不保证识别全部隐私。展示实际草稿并检查余下隐私，确认提交授权。已有对这份内容的明确提交授权不重复询问。修改内容后生成新草稿，重新核对新 SHA。不要为正常制作增加反馈关卡。离线有已缓存的签名信任时，可加全局 --offline 只生成草稿。

1. 只提交已核对的内容：

node <已校验的工具.mjs> api <原始个人.motion> feedback-submit <草稿.json> --confirm-sha256 <reportSha256>
node <已校验的工具.mjs> api <原始个人.motion> feedback-status <反馈编号>

成功回执包含 id、status、policy、credits:0；本地保留 .receipt.json。网络中断不代表已收到：原草稿带固定操作编号，重试同一草稿防止重复提交。状态为 received / investigating / template_confirmed / resolved / not_template；resolved 关联正式发布的较新版本，之后走正常增量更新。查询只向本人开放，私有对话仅供维护人员排查，不公开到评论区。认证、签名或网络失败时保留草稿，不能自行换 Key、改审批、补造证据或谎报已收到；也可由用户在模板评论区留下脱敏的问题说明。

English

Failure reporting is optional and free. Preserve original packages, projects and failed output, and continue unaffected work. Prepare a local sanitized draft containing only relevant, authorized conversation excerpts and actual errors. Show it, check remaining private details and obtain permission unless already explicitly authorized for this content. Submit the exact reviewed SHA, keep the receipt ID and retry the same draft after an uncertain network result. No extra generation scope, credit balance, website login or Key change is required. Only the reporter and maintenance staff may access the report. Confirmed template defects are usually fixed in the following day’s release; complex issues may take longer. Receipt does not establish defect confirmation or a completed fix.