从最小请求点火
密钥只放在服务端环境变量或密钥管理服务,不写进 HTML、客户端脚本、仓库和普通日志。先验证鉴权、模型名、请求体与超时,再增加流式输出、工具或并发。
安全红线
示例不包含真实端点与密钥;请以正式 API 文档为准,并实施轮换、最小权限和日志脱敏。

MILL MANUAL / QC ARCHIVE
这是一份面向 DeepSeek AI 工程接入的炉务手册。示例强调安全边界和排查顺序,实际接口、模型与限额以正式服务文档为准。

密钥只放在服务端环境变量或密钥管理服务,不写进 HTML、客户端脚本、仓库和普通日志。先验证鉴权、模型名、请求体与超时,再增加流式输出、工具或并发。
示例不包含真实端点与密钥;请以正式 API 文档为准,并实施轮换、最小权限和日志脱敏。

| 现象 | 先查 | 处理原则 |
|---|---|---|
| 鉴权失败 | 密钥状态、环境、请求头 | 不要在日志输出完整密钥 |
| 请求受限 | 并发、频率、账户限额 | 指数退避并设置重试上限 |
| 服务端异常 | 请求 ID、时间、状态页 | 有限重试,保留可复现信息 |
| 输出截断 | 上下文与输出上限 | 分段输入,明确停止条件 |
错误码含义可能随正式服务调整;排查时以实时文档和响应中的请求标识为准。
① 建文档索引与唯一编号;② 按自然章节切分;③ 每段保留页码或行号;④ 用固定字段提取;⑤ 跨段核对冲突;⑥ 人工复核高风险结论。

部署前确认模型许可、权重来源、精度格式、显存、上下文长度、并发与数据边界。量化可以降低资源需求,但可能改变任务质量,应以代表性样本重新验收。
模型与量化版本 / GPU 与驱动 / 推理框架 / 上下文 / 并发 / 吞吐 / 峰值显存 / 验收集版本。
BATCH: reasoning-cn-v3
MODEL: pinned-version
PROMPT: sha256:...
METRICS: quality / review / latency / cost
RESULT: DEMO ONLY
REVIEWER: pending测试集、提示词、参数、模型和评分器都需要版本标识。
汇总分数之外,保留逐条输出、失败类别与人工复核意见。