运行日志与错误诊断 · expert-2.1.2
2026-10-15
这次错误的原因
“文字位置须为top或bottom”由本地计划校验产生。原来AI输出结构只把copy_position定义为字符串,没有限定可用值;程序后续却严格只接受top/bottom,而且setdefault不能修复已存在的空字符串。空值、中文或大小写等格式差异都可能让已完成的AI策划在校验时失败。
上次失败结果未保存,所以不能确认当时的具体原值。本次修复针对已确认的程序衔接缺陷;新增日志后再失败,就能追溯到图片行名、字段原值和AI返回内容。
已完成的修复
| 情况 | 处理 |
|---|---|
| AI输出约束 | copy_position在结构化输出中限定为top/bottom;text_mode限定为local/none/integrated。上游提示词明确规则。 |
| 空值或缺失 | 位置使用bottom;颜色使用现有默认值;写入规范化警告日志。 |
| 明确的格式差异 | 去首尾空白、统一英文大小写;“顶部/上方”映射top,“底部/下方”映射bottom;均记录原值与处理结果。 |
| 无法确定的值 | 例如仅“left”无法说明顶部还是底部,仍阻止应用;提示具体图片行、字段名与原值,不静默猜测。 |
| 调用费用 | 校验失败不自动重复请求模型。诊断快照用于查错,不会自动应用未经审核的计划。 |
如何查看运行过程
- 重启工作台,点击主界面右上角的运行日志。AI分析窗口也有同名按钮。
- 默认显示运行日志,勾选“自动刷新”即可查看阶段起止、请求发送与返回、耗时、缓存复用、取消以及成图保存过程。
- 发生错误时,选择“仅错误”或“警告及错误”;也可从下拉列表直接选择错误日志文件。
- 点击记录,在下方查看异常类型、完整调用堆栈、行名、模型、HTTP状态或网络原因等信息。
- 把错误弹窗里的“追踪编号”输入关键字框,按回车,可集中查看同一任务的相关记录。
- AI计划校验失败时,点击查看关联AI返回快照,读取脱敏后的模型返回值,定位具体字段。
- 需要交给维护人员时,使用“导出当前筛选日志”。只导出界面当前显示的记录;关联快照可在日志文件夹的“诊断快照”中查找。
保存在哪里
D:\简顿科技视觉数据\日志\运行_日期.jsonl:运行过程及错误。D:\简顿科技视觉数据\日志\错误_日期.jsonl:错误记录和堆栈。D:\简顿科技视觉数据\日志\诊断快照:AI文本返回及模型报告,不包含提交的图片二进制或API请求头。
文件按日期记录,单个日志达到5MB后归档续写,旧记录保留。查看器默认展示选中文件最近500条,完整记录仍在文件中。日志位于本机数据目录,覆盖程序文件夹不会覆盖日志。
记录边界
日志会记录诊断所需的产品路径、任务名称及AI返回文本;已知API密钥和常见凭据字段自动脱敏,不记录密钥请求头、图片base64或内部思考内容。日志写入失败会在查看器提示,避免日志故障中断正常任务。
另一台电脑更新
关闭工作台,解压此次升级ZIP到独立目录,运行“安装或更新到D盘.cmd”。使用环境自己的配置、模板和密钥继续保留。原来的操作入口和图片尺寸设置保持原方式。