codebuddy通过规则文件、/rules指令、私有知识库和craft批量重构四步实现日志结构化与分级规范：统一字段、校验级别、结合运维语义、自动修复存量日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在开发中发现日志格式混乱、字段缺失、级别混用，导致AI无法准确解析或告警系统误判，则很可能是日志未遵循结构化与分级规范。以下是使用CodeBuddy实现日志格式统一和日志级别规范的具体方法：
一、启用日志规范规则文件（.codebuddy/rules）
通过在项目根目录下配置自然语言规则文件，强制AI生成符合团队标准的日志语句。该方式定义硬性约束，确保所有新生成或补全的日志代码自动遵守字段、格式与级别要求。
1、在项目根目录创建 .codebuddy/rules 文件夹（若不存在）。
2、在该文件夹内新建 log-standards.md，写入如下内容：
3、保存后，在VS Code或JetBrains中调用CodeBuddy的Craft功能，AI将自动识别并应用该规则。
4、后续所有日志生成、补全、重构操作，均会严格遵循：必须包含 timestamp、level、trace_id、event、duration_ms 字段；error 级别仅用于不可恢复异常；warn 仅用于业务异常但流程可继续；info 限于关键路径完成节点。
二、使用 /rules 指令自动生成日志规范配置
CodeBuddy内置斜杠指令可基于当前项目技术栈（如Spring Boot、Express、FastAPI）自动推导适配的日志结构模板，并生成配套的配置文件与校验逻辑，避免人工编写规则偏差。
1、在IDE插件对话框中输入 /rules generate log standard for Spring Boot。
2、AI返回包含三类产物：log-schema.json（定义必选字段与类型）、log-level-policy.md（明确各模块允许使用的级别边界）、LogEnforcer.java（可直接集成的AOP切面类）。
3、点击“Apply”按钮，AI将自动把上述文件写入对应目录，并在pom.xml中添加依赖声明。
4、再次调用日志补全时，AI将依据生成的schema校验字段完整性，并依据policy校验level使用是否越界。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
三、接入私有知识库强化上下文感知
当团队已有《日志治理白皮书》《SRE告警分级手册》等文档时，上传至CodeBuddy企业版私有知识库，使AI在生成日志时能结合真实运维场景做语义级判断，而非仅依赖语法规则。
1、登录CodeBuddy管控台，进入“知识库”模块，创建名为 log-governance-kb 的新知识库。
2、上传PDF或Markdown格式的《核心服务日志规范V3.2》，AI将在10分钟内完成向量化索引。
3、在Craft对话中输入：“为订单超时检查方法添加日志”，AI将自动引用知识库中“支付域超时事件应标记为warn且携带payment_id与timeout_threshold_ms”的条款。
4、生成结果中，日志语句将包含 "level":"warn","event":"order_timeout_check_failed","payment_id":"PAY20260521XXXX","timeout_threshold_ms":30000，完全匹配SRE手册要求。
四、使用Craft功能批量重写现有非规范日志
针对存量代码中大量散落的print、console.log、logger.info("xxx")等非结构化日志，可通过Craft发起批量重构任务，由AI按统一Schema注入缺失字段、修正级别、替换占位符。
1、在Craft界面点击“Add”，选择全部含日志语句的Java/TS/Python文件。
2、输入指令：“请将所选文件中所有原始日志语句，按以下结构重写：{timestamp, level, trace_id, event, [business_fields]}；禁止删除原业务逻辑；保留原有方法签名与控制流。”
3、AI解析每条日志上下文，自动补全 trace_id 来源于当前MDC或requestId，自动推断 level 应为 warn 还是 error（依据是否有throw或return false）。
4、确认预览无误后，点击“Apply All”，AI将一次性将全部日志写入源文件，不改动任何非日志代码。
