xbot-project-diagnostics

# xbot 项目诊断与迁移 本 Skill 处理普通业务代码之外的**项目级问题**。当前包含两条工作流： 1. 旧版可视化项目解析 / 迁移。 2. 影刀应用“应用文件已损坏”等项目完整性问题排查与修复。 先根据用户症状选择对应工作流，不把两套步骤机械地全部执行。普通 Python 业务 bug、网页元素问题、Excel / WPS 问题仍按项目 `AGENTS.md` 和知识库对应事实页处理。 ## 工作流 A：可视化项目解析与迁移 ### 1. 先做只读项目盘点 在真实项目根目录执行： ```powershell python .agents/skills/xbot-project-diagnostics/scripts/inspect_visual_project.py . ``` 脚本只读取结构元数据，不输出 `package.json` 中的变量值，也不解码 `.pybx`。根据输出确认： - `startup` 和所有 flow 的 `name` / `filename` / `kind` / `groupName`。 - Visual flow 对应 `.pybx`、Code flow 对应 `.py` 是否实际存在。 - Code flow 的公开函数、参数和 import 关系。 - 全局变量名称、元素库和图像库条目数。 ### 2. 证据顺序 1. `package.json`：启动流、flow 类型和文件映射。 2. Code flow `.py`：`main(args)`、公开函数、参数与调用边界。 3. `selectorsV2.xml` / `imagesV2.xml` / `package.py`：资源名称和对象来源。 4. Visual flow `.pybx`：影刀维护的二进制流程文件，不把它当文本、JSON 或 Python 猜内部步骤。 5. 需要步骤级逻辑时，使用当前环境可用的影刀 Studio、截图或可读导出作为证据；先从已安装工具的 help 发现真实命令，不编造命令、标志或流程 ID。 无法确认 Visual flow 内部步骤时，明确标记“未确认”，不要根据流程名补全业务逻辑。 ### 3. 迁移到编码版 迁移前先整理每个待迁移流程的真实业务顺序、输入输出、分支 / 循环、异常路径、页面定位、全局变量、元素 / 图像资源和市场指令调用。只迁移已有证据确认的行为。 迁移时： - 保留用户已确认的 XPath、字段名、参数名、按钮文案和业务口径，不顺带重写业务。 - 主流程按真实业务顺序自上而下展开，遵守项目 `AGENTS.md` 的代码结构规则。 - 一次迁移一个可验证的业务边界；不要先删除原 Visual flow 再尝试复原。 - 新增 `.py` flow 后按项目同步规则更新 `package.json` 并编译；资源仍被使用时不要删除元素库、图像库或全局变量。 迁移完成至少验证：新 Code flow 已登记、Python 编译通过、必要的影刀同步完成、关键业务路径与旧流程证据一致。没有实际运行过的步骤不得写成“已验证运行”。 ## 工作流 B：应用文件损坏排查 典型界面提示： ```text 加载失败 应用文件已损坏，是否获取云端备份为副本？ ``` 不要只根据这个弹窗猜 Python 代码坏了。**先看影刀日志，确认失败层级。** ### 1. 先查真实错误 优先读取失败时间附近的影刀日志： ```text %LOCALAPPDATA...