运行日志与错误诊断 · 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”无法说明顶部还是底部,仍阻止应用;提示具体图片行、字段名与原值,不静默猜测。
调用费用校验失败不自动重复请求模型。诊断快照用于查错,不会自动应用未经审核的计划。

如何查看运行过程

  1. 重启工作台,点击主界面右上角的运行日志。AI分析窗口也有同名按钮。
  2. 默认显示运行日志,勾选“自动刷新”即可查看阶段起止、请求发送与返回、耗时、缓存复用、取消以及成图保存过程。
  3. 发生错误时,选择“仅错误”或“警告及错误”;也可从下拉列表直接选择错误日志文件。
  4. 点击记录,在下方查看异常类型、完整调用堆栈、行名、模型、HTTP状态或网络原因等信息。
  5. 把错误弹窗里的“追踪编号”输入关键字框,按回车,可集中查看同一任务的相关记录。
  6. AI计划校验失败时,点击查看关联AI返回快照,读取脱敏后的模型返回值,定位具体字段。
  7. 需要交给维护人员时,使用“导出当前筛选日志”。只导出界面当前显示的记录;关联快照可在日志文件夹的“诊断快照”中查找。

保存在哪里

文件按日期记录,单个日志达到5MB后归档续写,旧记录保留。查看器默认展示选中文件最近500条,完整记录仍在文件中。日志位于本机数据目录,覆盖程序文件夹不会覆盖日志。

记录边界

日志会记录诊断所需的产品路径、任务名称及AI返回文本;已知API密钥和常见凭据字段自动脱敏,不记录密钥请求头、图片base64或内部思考内容。日志写入失败会在查看器提示,避免日志故障中断正常任务。

另一台电脑更新

关闭工作台,解压此次升级ZIP到独立目录,运行“安装或更新到D盘.cmd”。使用环境自己的配置、模板和密钥继续保留。原来的操作入口和图片尺寸设置保持原方式。