trae异常日志说明文档需以错误码为唯一根因：以上是真实报错，code字段值为【redis_conn_timeout】，不是占位符，不要替换、不要泛化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为Trae平台生成一份异常日志说明文档，但每次输出都堆砌“请检查配置”“建议查阅官方文档”“可能由多种原因导致”这类空泛表述——开发同学拿到后仍要翻三遍日志、查五次文档，根本没法直接定位问题。
用错误码锚定唯一根因
打开你手头正在调试的Trae服务日志，找到第一条含ERROR或FATAL的行，例如：{"level":"error","msg":"failed to connect to redis","code":"REDIS_CONN_TIMEOUT","trace_id":"t-8a3f1e"}。
在提示词中直接粘贴这整行JSON，紧接一句：“以上是真实报错，code字段值为【REDIS_CONN_TIMEOUT】，不是占位符，不要替换、不要泛化。”
这一步必须做。Trae模型看到带引号的code值会自动绑定到内置错误码库，跳过所有“可能”“通常”类模糊推理路径。
若日志中无code字段，立刻回退检查Trae服务是否启用了log.level=debug且error_code_injection=true——【未开启错误码注入的日志说明文档，90%内容将失效】。
按三段式结构写说明
方法一：触发动作 + 平台实体 + 异常特征
把原始提示词“Redis连接超时”改写为：“API网关 → 调用redis-client → 连接等待超时（timeout_ms=5000）”。其中“API网关”是Trae控制台左侧导航栏明确显示的模块名，“redis-client”是服务注册中心里实际注册的服务别名，“timeout_ms=5000”必须带单位和数值，不能写“默认超时”。
方法二：绑定租户与时间锚点
在提示词中加入：tenant_id: "t-7a2f9b" AND timestamp:[2026-07-03T14:20:00Z TO 2026-07-03T14:25:00Z] AND "REDIS_CONN_TIMEOUT"。注意tenant_id必须用双引号包裹，且大小写敏感——Trae后台不自动补全或忽略大小写。
方法三：复用平台内置标签语法
直接输入：tag:redis_error AND tag:timeout AND trace_id:"t-8a3f1e"。Trae的tag字段已预置redis_error、auth_fail、rate_limit等23个语义化标签，不用自己定义；但trace_id必须完整复制自上游日志，缺一位字符都查不到关联链路。
强制输出可执行动作
第一步：让Trae仅输出一行命令，格式为trae debug --service redis-client --env prod --trace t-8a3f1e。命令中--service值必须来自服务注册中心，不能写“你的Redis服务”。
第二步：命令执行后，若返回connection refused，则立即追加：“检查redis-client配置中host是否指向k8s Service DNS名（如redis-svc.trae-system.svc.cluster.local），而非localhost或127.0.0.1”。
第三步：若返回timeout after 5000ms，则输出：“登录Pod执行nc -zv redis-svc 6379，失败则说明网络策略阻断，成功则需调大timeout_ms参数并重启服务”。
这三步必须严格按顺序生成。跳过任一环节，说明文档就变成纯理论推演，无法指导现场操作。
