外观
10 日志与故障排查
多窗口问题应先看失败账号的 状态，再查看状态单元格提示或页内错误。需要检查节点执行过程时，再使用通用运行日志。
通用日志入口、筛选和反向验证见运行与调试。
推荐排查顺序
- 记录第一条可见错误，不要同时修改多个设置。
- 确认问题发生在启动程序、获取窗口、调整、排列还是星链运行。
- 只检查失败账号的句柄、配置和状态。
- 每次修改一个条件，再重新执行对应的独立操作。
常见问题
| 现象 | 常见原因 | 处理 |
|---|---|---|
| 启动程序 没有新增窗口 | 当前匹配数已达到目标，或路径无效 | 核对目标总数；检查启动路径和页内错误 |
| 获取窗口 结果为空 | 窗口标题或类名不匹配 | 重新核对 PC 窗口匹配条件，等待目标窗口完全打开 |
| 获取后原尾行句柄消失 | 批量枚举会清空未被匹配窗口占用的尾行 | 需要保留单行指定时，不要在之后再次全表获取 |
| 调整或排列按钮不可用，或结果提示空句柄 | 未勾选账号，或所选账号句柄为空 | 勾选具有有效句柄的账号行；空句柄行会在逐项结果中跳过 |
| 选中多行但只处理了部分窗口 | 多个账号重复绑定了同一个窗口 | 保留一个账号的绑定，其他账号重新获取正确窗口 |
| 调整尺寸提示请求值与实际值不同 | 目标窗口限制尺寸，或程序在调整后恢复了尺寸 | 比较逐项请求/实际尺寸，尝试较小值或重新获取正确窗口 |
| 排列次序与屏幕排序不同 | 批量处理使用账号原有行顺序 | 按账号原有顺序检查，不以当前显示顺序判断 |
| 单个账号保持 未开始 并出现错误 | 句柄为空、失效、重复占用或配置不可用 | 查看该行错误，重新获取窗口并选择有效配置 |
| 当前配置 或准星不可用 | 账号正处于活动状态 | 停止或等待该账号进入终态 |
| 无法开始另一组账号 | 当前选择的账号仍在准备 | 等 开始 按钮恢复后，再选择空闲账号开始 |
| 选择 停止 后其他账号仍运行 | 停止只处理所选活动账号 | 按需选择其他活动账号并再次停止 |
| 多个账号表格提示列结构不一致 | 自定义列并非同一套结构 | 从一致模板或复制结果恢复列结构 |
表格.列名没有更新 | 节点未成功写入，或结果尚未显示 | 检查节点日志，稍候或等账号运行结束后再查看 |
| 表格旧值突然为空 | 自定义列被删除，或查看了另一个账号 | 检查列变更和账号归属 |
窗口问题的最小验证
- 对失败行重新使用单行准星获取窗口。
- 确认句柄和标题发生正确更新。
- 只选择这一行执行 立即调整。
- 检查提示中的已处理和跳过数量；失败时核对请求尺寸与窗口实际大小。
- 成功后再选择 开始。
这样可以把窗口枚举、批量顺序和星链问题分开定位。
运行问题的最小验证
- 只选择一个账号。
- 使用已确认有效的句柄和默认配置。
- 运行一条最短的演示星链。
- 观察准备期间保持 未开始，脚本开始后进入 运行中，正常结束后进入 运行完成。
- 单账号成功后再逐步增加账号。