一、路径总览（相对站点根路径）。前台用户：工作台「帮助与反馈」/dashboard/help 内提供控制台登录、大模型网关与本篇指南链接（/guides/llm-and-chat-testing）。本地开发端口以 package.json 中 dev 为准（常为 3040）。
二、环境：在部署或 .env.local 配置模型网关密钥与可选模型名、接口地址。不要将密钥写入仓库或前端。
三、管理端：/admin/login — 具备 ADMIN 角色的账号来自 NextAuth（种子 prisma/seed 可创建 admin）；/admin/llm — 维护 LlmProviderProfile：apiKeyEnvVar、model、enabled、每日软告警阈值等。列表中 keyConfigured=false 时不要启用该项。启用且密钥可读时，/api/chat 走上游 LLM；否则回演示 fallback。
四、内容运营：/admin/cases — 批量导入案例（V9 Excel 模版 + 同款 UTF-8 CSV + 字段对照 TXT）；服务端将模版列组装为结构化 payload.v9，对齐前台 CaseCardV9 与 /library/[id] 详情。案例仓库 /library 提供上述下载入口。
五、推荐测试流程：① 管理端 Provider 绿灯。② /dashboard/chat 发送短问；期望 metadata.mode 为 llm。③ 关闭密钥后再问，应变更为 fallback。④ 观察服务器日志不出现完整密钥。必要时跑 npm test / vitest 与生产构建校验。