codebuddy 可诊断并优化 ssr 性能问题：一、识别渲染瓶颈节点；二、生成页面与组件级缓存策略；三、重构数据获取逻辑；四、校验输出内容可缓存性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 辅助 SSR（服务端渲染）应用开发时发现首屏加载缓慢、TTFB 延长或服务器 CPU 持续高位，可能是由于服务端渲染路径中存在未识别的同步阻塞、重复数据获取或缓存缺失所致。CodeBuddy 可基于项目框架上下文（如 Next.js、Nuxt、SvelteKit）自动分析服务端执行链路，并提供多维度性能干预方案。以下是 CodeBuddy 支持的具体优化路径：
一、识别 SSR 渲染瓶颈节点
CodeBuddy 通过注入轻量探针捕获服务端渲染生命周期中的耗时环节，包括 load 函数执行、fetch 调用、序列化开销及组件 hydration 前准备阶段，定位具体哪一行代码或哪一个异步操作成为延迟主因。
1、在项目根目录运行命令 codebuddy analyze --ssr-trace 启动服务端追踪会话。
2、向本地 SSR 端点发起请求（如 curl http://localhost:3000/products），触发完整服务端渲染流程。
3、CodeBuddy 自动输出 trace-summary.json，其中包含每个 load 或 getServerSideProps 函数的执行耗时、子 fetch 调用次数与平均延迟、JSON 序列化体积（单位 KB）等字段。
4、检查报告中标记为 “high-blocking-io” 或 “large-serialized-payload” 的模块路径，确认是否在服务端重复解析大 JSON 或调用未加超时控制的外部 API。
二、生成页面级与组件级缓存策略
CodeBuddy 根据路由动态性、数据更新频率与用户身份特征，自动推导出适配当前页面的缓存层级与失效条件，避免手动配置 Cache-Control 头导致的缓存穿透或陈旧内容问题。
1、运行 codebuddy suggest-cache --route=/dashboard，指定目标路由路径。
2、CodeBuddy 分析该路由中所有依赖的数据源（如环境变量、API 响应头、数据库查询时间戳），判断其是否具备缓存可行性。
3、输出建议配置：若页面含用户权限信息且依赖 $env.private，则标记为 “no-cache, private”；若仅展示静态公告，则推荐 “public, max-age=600, stale-while-revalidate=300”。
4、对 SvelteKit 项目，自动补全 +page.server.ts 中的 export const prerender = true 或 export const ssr = false 标识，并标注适用前提。
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 问题
三、重构服务端数据获取逻辑
CodeBuddy 扫描服务端入口文件（如 getServerSideProps、load、+server.ts），识别低效数据组装模式，例如嵌套 await、未合并的并行 fetch、重复调用同一 API 等，并生成可直接替换的优化版本。
1、定位到 Next.js 页面文件中连续三次独立 fetch 调用，CodeBuddy 提示该模式导致 TTFB 增加约 420ms。
2、自动生成合并方案：const [user, posts, stats] = await Promise.all([fetchUser(), fetchPosts(), fetchStats()])。
3、若检测到 fetch 调用中缺少 signal 参数，CodeBuddy 插入 { signal: AbortSignal.timeout(8000) } 防止服务端长期挂起。
4、对 Nuxt 项目中 useAsyncData 使用未设 immediate: false 的场景，建议改写为 useAsyncData('key', () => api.get(), { immediate: false })，避免服务端强制触发非必要请求。
四、校验 SSR 输出内容可缓存性
CodeBuddy 对最终生成的 HTML 字符串进行语义扫描，检测是否存在阻止 CDN 缓存的动态内容片段，如内联随机数、未剥离的调试注释、客户端时间戳或未脱敏的用户标识，确保响应体满足边缘缓存要求。
1、启用 codebuddy audit-cache-output --mode=html 对 /api/ssr-preview 接口返回内容做静态分析。
2、识别出 HTML 中存在 类注释，标记为高风险缓存污染项。
3、检测到 window.__INITIAL_STATE__ = {...} 中混入了 session ID 字段，提示需剥离或哈希处理后再注入。
4、输出清理 patch：建议在 HTML 序列化前调用 stripDebugComments(html) 和 sanitizeClientState(state) 工具函数。
