ArtPlayer/refactor/changes/TEMPLATE.md

<任务 ID> <变更主题>

范围

• 日期、分支、基线 SHA、关联任务：
• 修改模块、受影响包和消费者：
• 关联兼容契约和 ADR：
• 完成提交主题（包含任务 ID；SHA 通过 Git 日志查找）：

旧行为与证据

源码、声明、发布包和文档分别记录；提供最小用户调用或复现步骤。标明已复现与待验证。

改动与理由

记录最终方案、内部职责变化、资源所有者、错误/取消/事件语义。必要时解释放弃的备选方案。 新增依赖或脚本时，记录用途、版本、所属包/依赖类别、命令输入输出与副作用、锁文件和 CI/用户产物影响。

兼容评估

范围	原行为	新行为	兼容结论/例外
JS API	待填	待填	待填
TypeScript	待填	待填	待填
事件/Promise/生命周期	待填	待填	待填
DOM/CSS/插件集成	待填	待填	待填
发布入口和资源	待填	待填	待填

验证

命令/用例	环境与产物 SHA	结果	持久报告/证据
待填	待填	未运行	待填

记录失败、跳过、真实浏览器/设备未验证项，不把没有运行的检查写成通过。

发布与回退

版本影响、兼容别名/适配、依赖范围、回退提交/旧版本、是否需要重新生成产物。

结论与后续

是否满足本任务验收、阻塞、后续任务 ID、文档更新。按实际证据更新 tasks.json，模板自身不能作为完成证据。 验收后将本任务的实现、测试、文档和状态单独提交，核实实际 SHA；提交失败时不能报告交付完成。

同时对照 quality-contract.md，记录职责拆分、已处理的不合理设计、包内实现地图、风险对应测试和后续 AI 修改入口。无法适用的项目说明原因，不机械打勾。