---
name: creator-checking
description: 检查实际工程、运行主流程和定位资源/交互问题，依据观测进行先期优化，输出复现与自测结果。
---

# 检查工程和实际运行

## 形成工程事实

读取入口、构建/启动配置、外部调用、资源和已有测试。可从技能包根运行 `python3 scripts/project.py inspect <工程目录或ZIP>` 辅助识别；它只报告工程类型与文件数，不校验入口、资源完整性、容量、密钥或实际运行，不能作为“打包通过”的证明。不自动执行来历不明的附件脚本。记录实际版本和修改范围。

## 自测步骤

1. 给出真实启动方式、页面/场景入口和测试身份范围。
2. 在实际 UI 完成主操作，验证结果展示、返回、重开和刷新。
3. 按选中功能补测异常；联机实玩和 AI 真实生成是完成条件。
4. 观察实际下载、重复请求、长帧、内存与退出后的资源清理。
5. 同一环境比较修复前后，保留失败记录与复测结果。

## 设计和优化

先处理白屏、无反馈、错误结果、无界重试、重复副作用和泄露密钥，再依据测量处理启动、资源与渲染问题。重复请求不等于重复下载；不能用静音、删技能、改变时间步或降低玩法复杂度来冒充优化。

## 常见问题

界面有反应但战斗不走：分别检查模拟帧、远端确认进度与渲染长帧。日志显示成功但界面未更新：沿任务/订单标识追踪服务结果、状态存储和组件订阅。开发页正常而导出白屏：检查相对路径、构建依赖和实际响应头。

报告包含入口、预期、实际、环境、版本和修改文件。详细测量见[运行验收](../../guides/packaging/validation.md)，接口边界见[架构](../../guides/development/architecture.md)。