用途:该技能用于查看部署在 Cloudflare Workers 上的运行日志,包括请求路径、响应状态、console.log 输出和错误信息。仓库中主站与 API 是两个独立的 Cloudflare Worker,需要分别跟踪。适用于调试 openagents.com 或 openagents.com/api 返回的 401/500、确认 Worker 是否收到预期请求头(如 X-OA-Internal-Key)及返回未授权的原因、查看 Rust API 或 Web 应用的 console 输出、与 Khala 日志关联分析。
涉及的两个 Worker:openagents-api,配置文件 apps/api/wrangler.toml,路由 openagents.com/api/*,用途为 Rust API(legacyparity、control、D1、R2 等);openagents-web-app,配置文件 apps/web/wrangler.jsonc,路由 openagents.com 主站,为 TanStack/React 应用(Node 兼容)。需在包含对应 Worker 配置的应用目录运行 wrangler tail,也可用 --config 或 --cwd 指定。
用法:实时跟踪只提供直播流,Cloudflare CLI 不提供历史日志,历史数据需通过仪表盘的 Workers & Pages → 对应 worker → Logs / Real-time Logs 或 Logpush 查看。基础命令:在 apps/api 下运行 npx wrangler tail 跟踪 API Worker;在 apps/web 下运行 npx wrangler tail 跟踪 Web 应用 Worker。保持命令运行后在浏览器复现问题,即可看到每个请求、状态和 console 输出。常用选项包括 --format pretty(默认人类可读)、--format json(每行一个 JSON 对象,可管道给 jq)、--status ok、--status error、--method GET、--search "legacyparity"、--header "x-oa-internal-key"、--sampling-rate 1(记录 100% 请求)。示例:cd apps/api && npx wrangler tail --status error --format pretty;cd apps/api && npx wrangler tail --format json | jq 'select(.url | contains("legacyparity"))'。调试涉及主站与 API 的完整链路时,可在两个终端分别运行两个 Worker 的 tail,必要时在第三个终端运行 Khala 日志:cd apps/web && npx khala logs --prod --success,然后复现并观察。
限制:仅支持实时,没有 --history,tail 持续流式输出直到 Ctrl+C;高负载下可能采样,可用 --sampling-rate 1 降低采样;每个 Worker 最多 10 个并发 tail 会话;日志不得打印密钥,诊断日志应使用长度或“存在/不存在”表示。涉及 legacyparity 鉴权时,API Worker 会输出若干诊断行,用于判断内部密钥缺失或值不匹配;Khala 动作在每次请求前记录 fetch key_len 与 url,可与 Worker 日志对照,确认 Khala 发送的内容与 Worker 收到的内容。具体仓库路径、路由与诊断文本均以资料为准。