制器坊 编程基础

AI 工具术语表:Harness、模型、网关与报错

根据上下文识别同名术语,读懂配置与错误信息。配合操作示例、图解和检查点,完成第一次练习,再逐步排查使用中的问题。

信息层级:【有据可查】= 附官方文档或可信来源链接;【社区共识】= 社区用户普遍经验,未经官方确认;【待考察/推测】= 推测或暂未能核实,请谨慎对待。

用法:在 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 既指"词元"也指"令牌"),以上下文为准。
  • 部分中文译名为社区惯用译法,非官方统一译名。

小白练习:把本文流程逐项走通

练习目标:根据上下文识别同名术语,读懂配置与错误信息。

上文已介绍概念、配置和操作示例。下面侧重第一次实际操作时的顺序、检查点和结果核对;需要查具体参数时回到对应小节。命令逐条输入,看到上一条的结果后再继续。

  1. 先找出术语出现的位置:界面菜单、计费页面、API 文档还是命令报错。

  2. Token 出现在 Authorization 时通常是令牌;出现在输入输出计数时是词元;不要把它们互换。

  3. 把 Base URL、Endpoint、Provider 和 Model ID 分别对应到配置的四个字段,再核对实际产品的写法。

  4. 看到 Sandbox、Approval 或 Auto-review 时分别查执行边界、授权策略和审查机制,不把三个词当成同一个功能。

  5. 遇到报错先记录状态码、正文和 request-id,再按原文的英文对照查找官方说明。

继续浏览制器坊 返回顶部 ↑
教程图解100%
教程图解
灵犀台