Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
工作目录异常:日志判读
本次诊断只增加可观测性,不修改目录探测的超时预算、恢复判据、目录授权或 Agent 行为。 它不会修复原目录,也不会主动搬动用户文件。
收集
问题出现后记下发生时间和客户端版本,通过现有“上传日志”入口提供诊断日志。
本机也可以在当前实例的日志目录中搜索当天的 main 日志,筛选 scope
workdir-diagnostics。默认 info 等级即可记录,不需要打开 debug;自定义日志等级仍然生效。
这些日志需要运行包含本次改动的客户端版本,旧版本无法补录。
关联字段
| 字段 | 用途 |
|---|---|
directoryRef / probedDirectoryRef |
关联目标目录与恢复过程中实际检查的祖先目录 |
sessionRef |
关联同一个任务的检查、恢复和运行时重建 |
requestId / workerId |
关联一次探测请求与承载它的进程 |
elapsedMs / queueWaitMs / responseWaitMs |
总耗时、排队耗时、派发后的结果等待耗时 |
activeWorkers / terminatingWorkers / queued |
判断是否忙于处理其他请求,或等待旧进程退出 |
code / causeCode |
已知错误码;不认识的错误码统一为 UNKNOWN,不输出原始异常 |
目录和任务关联标识采用进程内随机密钥的 HMAC;同一次运行可关联,重启后改变。 它们不是目录原文,也不是可用来还原路径的普通路径哈希。符号链接等不同路径拼法不保证标识相同。
探测阶段
日志中的 reason |
能确认的事实 |
|---|---|
queue-full |
等候队列达到上限,本请求没有派发 |
queue-timeout |
等待进程空位耗尽预算,没有开始检查目标目录 |
deadline-before-dispatch |
准备派发时总预算已耗尽 |
host-start-failed / host-restart-failed |
创建探测进程失败;有底层已知错误时看 causeCode |
dispatch-failed |
向探测进程发送请求失败 |
host-error / host-exited |
探测进程异常或未返回结果就退出 |
response-timeout |
请求已经派发,但未在预算内收到结果 |
filesystem-error |
探测进程返回文件操作错误;看 code 区分 ENOENT、EACCES、EIO 等 |
not-directory |
文件操作返回目标不是目录 |
disposed |
探测池已关闭或正在关闭,不能把它当作目录缺失 |
response-timeout 不能单独证明硬盘损坏或掉盘。 当前内部协议没有文件操作开始回执,
它仍可能包含进程启动、文件操作或进程间通信等待;日志不会把未知原因伪装成确定的磁盘故障。
进程的创建、终止请求、kill 未获确认和最终退出都有独立日志,退出记录带 exitCode
与 terminationRequested,可判断是超时后主动终止,还是意外退出。
恢复与发送阶段
workdir recovery unavailable:看reason区分祖先探测错误、盘根缺失、裸挂载点和device-changed;设备变化附预期与实际设备号。workdir recovery directory created:真正执行了原地 mkdir;similarPathFound表示发现相似目录线索,不记录其名字。workdir recovery completed:action=fallback-selected是选用备用目录,action=fallback-recreated是重建备用目录,不能混同原目录被恢复。sameDirectory=true:备用目录与输入目录相同,是“回退到自身”的直接诊断证据;本次仅记录,不修改该行为。workdir recovery attempt failed:stage指明失败在挂载检查、备用目录 stat/mkdir、相似目录检查、原目录 mkdir 还是别名解析。随后仍可能成功回退,不能只看这一条判断最终失败。workdir preflight ready/recovered/blocked/rejected:表示发送前检查的最终走向;blocked同时记录真实错误码与实际报出的reportedReason,可识别“探测器故障却报目录不存在”。workdir DB lookup failed:读 DB 路径失败;workdir DB fallback candidate记录存在 DB 候选,sameNormalizedDirectory=true表示只是规范化后的路径拼法相同,本次不改变比较或发送逻辑。workdir runtime refresh requested/completed:表示因目录问题请求重建运行时及其结果;结合前面的目录检查日志判断重建为何成功或被阻断。
按发生时间先找 preflight failed/blocked,用 sessionRef 和 directoryRef 关联恢复记录,
再用目录标识找到对应探测的 reason、请求编号、耗时和进程状态。后续的 preflight ready
可以确认检查恢复正常,避免误判为只能重启客户端才能恢复。
上报边界
workdir-diagnostics 只按精确 scope 加入日志上传白名单。新增理由是该来源只包含
固定事件名、已知错误码、数值、布尔值和匿名关联标识,不包含目录、文件名、任务标题、
消息、凭证或原始异常。其子 scope、Renderer 转发及原有 maker-ipc / workdir-probe-host
不会因此获得上传权限;现有授权、记录边界与脱敏规则保持不变。