信息层级:【有据可查】= 附官方文档或可信来源链接;【社区共识】= 社区用户普遍经验,未经官方确认;【待考察/推测】= 推测或暂未能核实,请谨慎对待。
用法:在 Agent 设置页、API 文档、报错信息里看到不认识的英文词,来这里查。"层级"列沿用本专栏三层标注:大多数为行业通用术语(社区共识),个别附官方来源。
1. Agent / Harness 相关
| 英文 | 中文 | 一句话解释 | 在哪见到 |
|---|---|---|---|
| Harness | 外壳 / 运行框架 | 包在模型外面、负责工具、权限、上下文管理的程序 | dsh = DeepSeek Harness |
| Agent | 智能体 / 代理 | 能自主调用工具完成多步任务的 AI 应用 | 全部 |
| Subagent | 子代理 | 主 Agent 派出去处理子任务的 Agent | Codex、Claude Code、Grok Build |
| Tool call / Function calling | 工具调用 / 函数调用 | 模型输出结构化请求,让外壳执行某个工具 | API 文档 |
| MCP (Model Context Protocol) | 模型上下文协议 | 把外部工具/数据源接入 Agent 的开放协议 | 各 Agent(官网) |
| ACP (Agent Client Protocol) | 代理客户端协议 | 让编辑器接入外部 Agent 的协议 | dsh、Grok Build |
| Skill | 技能 | 打包好的说明 + 脚本,Agent 按需加载 | 各 Agent |
| Plugin / Extension | 插件 / 扩展 | 扩展功能的附加组件 | dsh、酒馆 |
| Hook | 钩子 | 在特定事件前后自动运行的脚本 | Claude Code、Qoder |
| Sandbox | 沙箱 | 限制命令能访问的文件/网络的隔离环境 | AI 编程 Agent 怎么选:工具、权限与工作方式 |
| Approval / Permission prompt | 审批 / 权限弹窗 | 执行前询问用户 | 全部 |
| Allowlist / Denylist | 允许列表 / 拒绝列表 | 免询问 / 禁止的命令规则 | Cursor、Claude Code |
| Auto mode / Auto-review | 自动模式 / 自动审查 | 由分类器代替人判断是否放行 | 相关教程(DSH 日常工作流、profile 与进阶用法、Codex 本地使用:安装、权限、项目规则与排错、Claude Code 使用:安装、权限与项目工作流、ZCode 使用:连接模型、执行模式与目标任务、Cursor 使用:项目规则、执行模式与自带 Key、Grok Build 使用:安装、权限、沙箱与目标任务、WorkBuddy 使用:工作空间、文档任务与模型设置、OpenClaw 入门:独立环境、配置与安全边界、Qoder 使用:IDE、CLI、权限与自定义模型、千问办公使用:个人空间、扩展与文档交付) |
| YOLO / Bypass permissions | 全放行模式 | 跳过所有确认(危险) | 多个 Agent |
| Workspace | 工作区 | Agent 被允许操作的项目目录 | 全部 |
| Worktree | 工作树 | Git 的多工作目录功能,Agent 常用来并行任务 | Codex、Grok Build |
| AGENTS.md / Rules | 项目说明 / 规则文件 | 写给 Agent 看的项目约定 | Codex、Cursor |
| Context window | 上下文窗口 | 一次能处理的最大 Token 数 | 大语言模型原理:Token、上下文、生成与幻觉 |
| Compact / Compaction | 压缩上下文 | 把长对话总结成短摘要以腾出空间 | 多个 Agent |
| Session / Resume | 会话 / 恢复 | 保存与继续之前的对话 | 全部 |
| Headless | 无界面模式 | 在脚本/CI 里非交互运行 | Codex exec、dsh |
| Effort / Reasoning effort | 推理强度 | 模型"想多久"的档位 | dsh、Codex |
| Profile | 配置档 | 一组可切换的设置 | dsh、Codex |
| Slash command | 斜杠命令 | 以 / 开头的快捷指令 |
全部 |
| Prompt injection | 提示注入 | 藏在网页/文件中的恶意指令劫持 Agent | AI 账号安全:登录态、密钥、授权与申诉 |
2. API / 模型调用相关
| 英文 | 中文 | 一句话解释 |
|---|---|---|
| Endpoint | 端点 / 接口地址 | 某个 API 功能的 URL,如 /v1/chat/completions |
| Base URL | 基础地址 | 所有端点的公共前缀,如 https://api.deepseek.com |
| API Key / Token(鉴权) | API 密钥 / 令牌 | 证明你身份的字符串;不要泄露 |
| Bearer token | 持有者令牌 | 放在 Authorization: Bearer xxx 头里的 Key |
| Provider | 供应商 / 模型来源 | 提供模型 API 的一方 |
| Model ID | 模型标识 | 调用时填写的模型名字符串 |
| OpenAI-compatible | OpenAI 兼容 | 接口格式与 OpenAI 一致,客户端可通用 |
| Chat Completions / Responses / Messages | 对话补全 / 响应 / 消息接口 | OpenAI 与 Anthropic 的不同接口风格 |
| Wire API / Protocol | 传输协议格式 | 客户端与服务端说哪种"方言" |
| Streaming / SSE | 流式输出 / 服务器推送事件 | 边生成边返回 |
| Token(计量) | 词元 | 计费与上下文的基本单位 |
| Input / Output / Cached tokens | 输入 / 输出 / 缓存命中 Token | 计费分别计算 |
| Prompt caching | 提示缓存 | 重复前缀可打折或加速 |
| Rate limit | 速率限制 | 单位时间请求/Token 上限 |
| Quota | 配额 | 可用总量 |
| RPM / TPM | 每分钟请求数 / 每分钟 Token 数 | 限流指标 |
| Retry-After | 重试等待时间 | 429/503 响应头,告诉你多久后再试 |
| Backoff(exponential) | (指数)退避 | 每次失败后等更久再重试(API 报错速查:状态码、错误正文与重试) |
| Temperature / Top P | 温度 / 核采样 | 控制随机性 |
| Max tokens | 最大输出长度 | 限制回复长度 |
| System prompt / Developer message | 系统提示 / 开发者消息 | 设定模型行为的高优先级指令 |
| Embedding | 嵌入向量 | 文本 → 向量,用于检索 |
| RAG | 检索增强生成 | 先检索资料再让模型回答 |
| Fine-tuning / LoRA | 微调 / 低秩适配 | 见 预训练、微调、LoRA 与 RAG:怎样区分 |
| Quantization(Q4/Q8) | 量化 | 降低精度以减小显存(本地部署值不值:硬件、显存、电费与时间) |
| Inference | 推理(运行模型) | 区别于"训练" |
| Latency / Throughput | 延迟 / 吞吐 | 速度指标 |
| BYOK (Bring Your Own Key) | 自带密钥 | 在产品中使用你自己的 API Key |
3. 中转站 / 聚合平台 / 网关相关
| 英文 / 常见说法 | 中文 | 一句话解释 |
|---|---|---|
| Gateway | 网关 | 统一入口,转发并翻译请求(magpie、New API) |
| Proxy / Relay | 代理 / 中转 | 替你把请求转发给上游 |
| Aggregator | 聚合平台 | 一个账号/Key 访问多家模型 |
| Upstream / Downstream | 上游 / 下游 | 上游 = 真正提供模型的服务;下游 = 调用者 |
| Channel | 渠道 | New API 中的一个上游配置 |
| Token(New API) | 令牌 | 网关发给下游用户的 Key |
| Group | 分组 | 按用户/渠道分组控制权限与倍率 |
| Ratio / Multiplier | 倍率 | 中转站计费相对于基准的系数,看清楚再充值 |
| Quota(额度) | 额度 | 预付余额或可用量 |
| Model mapping / Alias | 模型映射 / 别名 | 请求名 → 实际上游模型名 |
| Load balancing / Routing | 负载均衡 / 路由 | 在多个上游间分配请求 |
| Fallback / Failover | 回退 / 故障转移 | 主上游失败时切换备用 |
| Self-hosted | 自托管 / 自建 | 部署在你自己的服务器 |
| Reverse proxy | 反向代理 | Nginx/Caddy 放在服务前提供 HTTPS |
| Whitelist(IP) | IP 白名单 | 只允许特定来源访问 |
| Audit log | 审计日志 | 谁在何时做了什么 |
| Rotation(account/key rotation) | 轮换 | 定期更换 Key 属安全做法;多账号轮换规避额度可能违反条款(Cockpit Tools:凭据存放、功能边界与条款判断) |
| ToS / AUP | 服务条款 / 可接受使用政策 | 决定"能不能这么用"的文件 |
| Resale | 转售 | 多数官方条款限制 |
4. 报错与运维常见英文
| 英文 | 中文 | 常见场景 |
|---|---|---|
| Unauthorized (401) | 未认证 | Key 错误 |
| Forbidden (403) | 禁止访问 | 无权限 / 地区不支持 |
| Not Found (404) | 未找到 | URL 或模型名错 |
| Too Many Requests (429) | 请求过多 | 限流或额度用尽 |
| Internal Server Error (500) | 服务器内部错误 | 上游故障 |
| Bad Gateway (502) / Gateway Timeout (504) | 网关错误 / 网关超时 | 代理或上游问题 |
| Service Unavailable (503) / Overloaded (529) | 服务不可用 / 过载 | 高峰期 |
| Timeout | 超时 | 网络或长请求 |
| Connection refused | 连接被拒绝 | 服务没启动或端口不对 |
| Deprecated | 已弃用 | 未来会移除的功能 |
| Breaking change | 破坏性变更 | 升级后旧配置可能失效 |
| Changelog / Release notes | 更新日志 | 升级前必看 |
来源:状态码含义参见 MDN HTTP 状态码【有据可查】;AI 厂商的具体细分见API 报错速查:状态码、错误正文与重试。
5. 本篇无法核实/需谨慎的点
- 同一英文词在不同产品中含义可能不同(如 Token 既指"词元"也指"令牌"),以上下文为准。
- 部分中文译名为社区惯用译法,非官方统一译名。
小白练习:把本文流程逐项走通
练习目标:根据上下文识别同名术语,读懂配置与错误信息。
上文已介绍概念、配置和操作示例。下面侧重第一次实际操作时的顺序、检查点和结果核对;需要查具体参数时回到对应小节。命令逐条输入,看到上一条的结果后再继续。
-
先找出术语出现的位置:界面菜单、计费页面、API 文档还是命令报错。
-
Token 出现在 Authorization 时通常是令牌;出现在输入输出计数时是词元;不要把它们互换。
-
把 Base URL、Endpoint、Provider 和 Model ID 分别对应到配置的四个字段,再核对实际产品的写法。
-
看到 Sandbox、Approval 或 Auto-review 时分别查执行边界、授权策略和审查机制,不把三个词当成同一个功能。
-
遇到报错先记录状态码、正文和 request-id,再按原文的英文对照查找官方说明。
