# 森虫虫系列课 · Codex 新手术语表

遇到不熟悉的词，可以先看“怎么理解”，再看“容易混淆的地方”。不用一次背完；英文保留在旁边，方便对照界面。

这份术语表对应《Codex 完整基础课》。具体入口和可用功能会随版本、账号与工作环境变化。

## 应用、聊天与材料

| 术语 | 怎么理解 | 容易混淆的地方 |
|---|---|---|
| ChatGPT 桌面应用 | 安装在电脑上的应用，可以提供不同的工作入口。 | 应用叫 ChatGPT，不代表里面每段聊天都处于同一种模式。 |
| Chat | 偏向日常问答与交流的入口。 | 不能简单理解为“完全不能使用工具”。 |
| Work | 偏向一般工作任务和交付成果的入口。 | Work 的界面和功能不能直接当成 Codex 的界面。 |
| Codex | 面向代码、开发工具和相关文件工作的代理入口。 | 安装桌面应用，不等于把大模型安装成了本地离线程序。 |
| Agent／代理 | 能围绕目标使用工具、推进多步工作的助手。 | 能采取行动，不代表每次都理解正确或自动完成所有检查。 |
| 聊天／chat | 一段有自己消息记录和工作进展的沟通过程。 | 新聊天不等于新建了一个磁盘文件夹。 |
| 项目／project | 把相关聊天、材料和工作放在一起组织。 | 项目不是聊天本身，也不一定就是电脑文件夹。 |
| 本地项目 | 与电脑上的一个或多个目录关联的项目。 | 普通 ChatGPT 项目不会仅凭“项目”这个名字获得本地目录访问权。 |
| 工作区／workspace | 当前工作涉及的范围；有时也指账号所属的组织空间。 | 含义要结合页面判断，不能默认它就是整台电脑。 |
| 文件夹／directory | 电脑上组织文件的位置。 | 与聊天记录、模型或外部服务账号是不同东西。 |
| 路径／path | 说明文件或目录具体在哪里，像文件的地址。 | 两份文件名字相同，路径不同，就可能不是同一份。 |
| 上下文／context | 理解这次请求所依据的对话、材料和说明。 | 可访问某文件不等于已经读取；同项目也不等于每段聊天共享全部对话。 |
| 上下文用量 | 当前聊天使用了多少可处理的背景空间。 | 不是电脑硬盘容量，也不表示聊天能无限记住所有细节。 |
| 附件／attachment | 明确加给当前请求的文件、图片等材料。 | 附加一份文件，不等于开放整个磁盘。 |
| 引用／mention | 从候选中选中一个具体对象，让请求明确指向它。 | 只输入一个名字，不一定形成有效引用。 |
| 压缩／compact | 整理长聊天的上下文，帮助继续工作。 | 不是文件备份，也不保证每个细节原样保留。 |
| 置顶／pin | 把常用聊天或项目放到方便找到的位置。 | 不增加模型记忆，也不改变文件权限。 |
| 归档／archive | 把聊天从活跃列表收起来，之后可以查找和恢复。 | 不删除磁盘文件；正在运行的工作或关联计划可能受到影响。 |
| 移除项目 | 从应用项目列表中移除项目关联。 | 不等于删除本地文件或现有聊天。 |

回看：第 1—3 章。

## 输入与运行控制

| 术语 | 怎么理解 | 容易混淆的地方 |
|---|---|---|
| 请求／prompt | 你告诉代理希望做什么的文字或其他输入。 | 不需要神秘句式；目标、材料、限制与检查标准更有用。 |
| 发送 | 提交当前消息。 | 回车是否发送取决于设置，不能默认所有人的按键习惯相同。 |
| 斜杠命令／slash command | 在输入框输入 `/`，从列表选择快捷操作。 | 桌面、CLI 和其他入口的命令不一定相同。 |
| 引导／Steer | 运行中补充要求，调整当前工作的方向。 | 与排到下一轮的消息不同，也不撤销已完成动作。 |
| 排队／Queue | 把消息留到之后处理。 | 出现在队列里，只说明正在等待，不表示已经执行。 |
| 停止 | 停下当前运行；具体停止什么，要看所用控件。 | 停止不等于撤销已有文件变化或外部动作。 |
| 继续 | 从当前允许继续的状态往下推进，或用下一条消息接着沟通。 | 先看为什么停下，不能靠一句“继续”解决缺材料或缺授权。 |
| 计划模式／Plan mode | 先整理目标、步骤和需要确认的问题。 | 不是权限档位，也不等于完全不读取文件。 |
| 聊天分支／fork | 从已有讨论分出另一条沟通路线。 | 不等于 Git 分支，也不证明所有文件复制了一套。 |
| 反馈 | 指出哪里不符合要求，以及希望如何改变。 | “再好一点”不如说清位置、预期和修改范围。 |
| 听写／dictation | 把说出来的话转成文字输入。 | “转录并发送”可能直接提交；听写与实时语音对话不同。 |

回看：第 4—5 章；实时语音见第 22 章。

## 模型、推理与权限

| 术语 | 怎么理解 | 容易混淆的地方 |
|---|---|---|
| 模型／model | 负责处理这次请求的模型选择。 | 模型、权限和工作位置是三个不同选项。 |
| 推理强度／reasoning effort | 调整模型处理复杂问题时的思考投入。 | 越高不保证越正确，也不会增加文件访问权。 |
| Power | 某些版本提供的模型与推理预设调节方式。 | 预设可能同时涉及模型和推理，不只是一个权限或速度开关。 |
| Faster／Smarter | Power 中偏向更快或更深入的选择方向。 | 不是要求每次都选最深入；先看任务是否需要。 |
| Advanced／高级选项 | 分别查看或选择模型、推理强度及支持的速度设置。 | 能看到哪些选项，取决于当前账号、模型和版本。 |
| Max | 给所选模型更多时间处理困难问题的推理选择。 | 更长的处理不等于必然正确，也会影响等待和用量。 |
| Ultra | 使用子代理分工处理复杂任务的选择。 | 不只是普通的“再慢一档”；并非所有模型都提供。 |
| 使用情况／usage | 当前账号的用量、限制窗口等信息。 | 应查看自己的当前状态，不照搬别人的固定数字。 |
| 权限／permissions | 允许读取、写入、执行和访问的范围。 | 聊天里说“先不要修改”是任务要求，不会自动把系统权限改成只读。 |
| 沙箱／sandbox | 对执行动作施加的技术边界，例如可写目录或网络范围。 | 沙箱与审批不同；并非每个边界内动作都必须手动批准。 |
| 审批／approval | 对需要额外批准的动作进行审查。 | 批准一次，不等于无限期批准以后的所有动作。 |
| 请求批准 | 需要额外批准的动作交给你判断。 | 普通读取并不一定逐次弹窗。 |
| 帮我批准 | 把符合条件的批准请求交给自动审查。 | 沿用工作区沙箱，不能当成完全访问权限。 |
| 完全访问权限 | 更宽的文件和网络操作范围。 | 不应只为少看弹窗就默认选它；仍要理解具体动作。 |
| 自定义权限 | 使用配置文件中定义的规则。 | 与“自由修改所有权限”不是一回事，组织规则仍可能约束它。 |
| 登录认证／authentication | 确认正在使用哪个账号。 | 登录成功不等于所有工具与写入动作都已经获准。 |
| 授权／authorization | 允许访问哪些服务数据或使用哪些能力。 | 账号连接授权和具体动作批准需要分别判断。 |

回看：第 6—7 章。

## 文件、终端与运行位置

| 术语 | 怎么理解 | 容易混淆的地方 |
|---|---|---|
| 预览／preview | 查看文件内容或呈现效果。 | 看起来整齐，不代表事实、数字或功能正确。 |
| 编辑／edit | 修改已有内容。 | 聊天里展示了一段修改稿，不代表已经写入磁盘文件。 |
| 生成／create | 产生新的内容或文件。 | 要检查保存路径，分清原文件和新增文件。 |
| 终端／terminal | 与命令行程序交互的文字窗口。 | 不是聊天框，不会自动把任意自然语言当成正确命令。 |
| shell | 解释并执行命令的程序。 | 与承载它的终端窗口有关，但不是同一个概念。 |
| 命令／command | 交给程序执行的具体指令。 | 可能只读取，也可能写入、删除、下载或联网；长短不能代表风险。 |
| 当前目录 | 命令默认围绕哪个目录工作。 | 不一定等于你正在预览的文件所在目录。 |
| 输出／output | 命令返回的过程信息、结果或错误。 | 输出很多不等于成功，没有输出也不一定失败。 |
| 进程／process | 正在运行的一个程序实例。 | 关闭面板、停止聊天和终止进程，不是同一动作。 |
| 运行环境／environment | 让任务能执行的文件、程序、依赖、配置与连接条件。 | 只有文件齐全，不一定能运行；还可能缺程序或授权。 |
| Local／本地 | 在当前电脑或所连接主机的目录中执行相应动作。 | 不等于模型离线，也不表示完全不用网络。 |
| Cloud／云端 | 在准备好的远程任务环境中执行。 | 本地文件、程序、浏览器登录状态不会自动全部搬过去。 |
| Remote／远程计算机 | 连接另一台符合条件的主机，在那台电脑上工作。 | 不等于直接选择一个托管云端任务环境。 |

回看：第 8—9、13 章。

## Git、差异与审查

| 术语 | 怎么理解 | 容易混淆的地方 |
|---|---|---|
| Git | 记录并管理文件版本变化的工具。 | 不等于 GitHub，也不会因为用了 Git 就自动上传或发布。 |
| GitHub | 可托管仓库、支持协作与审查的平台。 | 它是服务平台，Git 是版本管理工具。 |
| 仓库／repository／repo | 由 Git 管理版本历史的一组文件。 | 不是所有普通文件夹都是 Git 仓库。 |
| 分支／branch | 在共同版本历史上发展的一条工作路线。 | 不等于聊天分支、另一台电脑或云端备份。 |
| 暂存／stage | 挑选哪些改动进入下一次提交。 | 暂存之后还没有完成提交。 |
| 取消暂存／unstage | 把改动从本次待提交的选择中移出。 | 不等于丢弃文件里的改动。 |
| 提交／commit | 在仓库历史里记录一次选定的变化。 | 不等于推送、合并或上线。 |
| 推送／push | 把本地提交发送到配置的远端仓库。 | 不自动代表已经合并或部署。 |
| 拉取／pull | 取得远端变化并按设置整合。 | 不只是下载文件，还可能遇到冲突。 |
| PR／Pull Request | 在支持的平台提出一组变更，请别人检查并考虑合并。 | PR 不等于已经合并，也不是 Git 的 pull 命令。 |
| 合并／merge | 把不同版本路线的变化整合起来。 | 合并成功不证明行为正确或已经发布。 |
| 冲突／conflict | 不同修改无法自动协调，需要决定保留哪些内容。 | 不宜直接“全部接受”而不看改动。 |
| Worktree／工作树 | 同一 Git 仓库的一份独立工作目录和检出状态。 | 不是通用备份，也不保证依赖和被忽略文件都齐全。 |
| diff／差异 | 对照改动前后，查看增加、删除或修改了什么。 | 不是运行结果，也不代表测试通过或已经发布。 |
| 变更面板／Review pane | 查看项目差异及比较范围的界面。 | 打开面板，不等于已经请求了一次代码审查。 |
| 代码审查／code review | 检查变更，寻找问题、依据和风险。 | 与实际运行测试不同，也不能保证发现全部问题。 |
| 测试／test | 用规定的输入或操作，检查实际行为。 | 通过结论只覆盖做过的检查，不能扩大成“所有情况都正确”。 |
| 还原／回退 | 对明确范围恢复或丢弃改动。 | 不能承诺一个按钮逆转所有外部影响；先确认对象和范围。 |

回看：第 10—12 章。

## 技能、插件、MCP 与触发方式

| 术语 | 怎么理解 | 容易混淆的地方 |
|---|---|---|
| Skill／Skills／技能 | 一份可重复使用的做事方法，也可能带参考资料、脚本和模板。 | 不是模型，也不是外部账号访问权本身。 |
| SKILL.md | 技能中描述用途与操作方法的文件。 | 有了说明文件，不代表所需工具与连接都已经准备好。 |
| 插件／plugin | 便于安装和分发的能力包，可能包含技能与工具连接。 | 安装插件不等于已经登录它依赖的外部服务。 |
| MCP | 让代理连接工具和数据的一种协议方式。 | 不是某家具体服务，也不是让模型自动更聪明的开关。 |
| MCP 服务器 | 通过 MCP 提供具体工具或数据的程序或服务。 | 可以在本地运行，也可以通过远程地址连接，不一定要租机器。 |
| STDIO | 用启动命令运行本地 MCP 程序的一种连接方式。 | 需要的是命令和参数，不能直接把服务网址当成启动命令。 |
| Streamable HTTP | 通过服务地址连接 MCP 的一种方式。 | 地址、认证和服务可用性都需要分别确认。 |
| Authenticate／认证 | 服务要求登录时，进入它的账号认证流程。 | 认证成功后仍要检查连接状态和工具是否可调用。 |
| Hook／Hooks／钩子 | 某个指定事件发生时，触发事先准备的动作。 | 不等于定时任务，也不同于按任务描述选用的技能。 |
| 事件／event | 工作流程中的一个时间点，例如会话开始或工具执行前。 | 是系统报告的时机，不是一组要依次点击的按钮。 |
| 匹配器／matcher | 判断哪些具体情况应该触发这个钩子。 | 与触发后执行什么是两件事。 |
| 处理器／handler | 钩子命中以后实际执行的动作。 | 不能只凭配置里有某种类型名称，就认为当前版本支持执行它。 |
| 计划任务／自动化 | 到指定时间或符合支持条件时，启动安排好的工作。 | 本地任务仍需要电脑、应用和所需环境可用。 |
| 目标模式／Goal mode | 围绕一个明确目标持续推进，直到完成、暂停或需要更多信息。 | 不等于每天定时重新启动，也不会扩大原有权限。 |

记忆方法：**技能管方法，MCP 接工具，插件装成包，Hook 管事件触发，计划任务管何时再开始。**

回看：第 14—17 章；目标模式见第 22 章。

## 长期代理、浏览器与常用辅助功能

| 术语 | 怎么理解 | 容易混淆的地方 |
|---|---|---|
| Dot／Dots／你的 Dot | 持续跟进工作的云端代理，可以安排任务并带回进展。 | 不是三个点的更多菜单；需要使用你的 Mac 时，这台 Mac 仍须在线并运行应用。 |
| Agents／智能体目录 | 查找可复用工作区代理的入口，可以按用途和所需连接选择。 | 与某次任务临时分派的子代理不同。 |
| Subagent／子代理 | 接受一部分独立工作，再把结果交回主任务的代理。 | 并行会增加用量，也可能因同时编辑同一文件产生冲突。 |
| 浏览器工具 | 读取或操作网页的能力。 | 不等于自动拥有个人浏览器里所有登录状态和授权。 |
| 电脑操控／Computer Use | 在支持的范围内观察并操作应用界面。 | 不能推断它能控制任意应用；系统权限与产品限制仍然适用。 |
| AGENTS.md | 给代理看的可复用工作约定，例如使用哪些材料、怎样检查结果。 | 不同目录的约定有作用范围，不应把临时要求永久混进去。 |
| config.toml | 存放部分默认配置的文件。 | 与写自然语言工作约定的 AGENTS.md 分工不同。 |
| 记忆／Memory | 帮后续任务利用此前相关背景的机制。 | 不保证每个细节永远准确；本地 Codex 记忆与 ChatGPT 云端记忆也要分开理解。 |
| Computer History／电脑历史 | 在启用和允许的范围内，把交互事件与可读取文字整理成工作线索。 | 不是历史录屏；暂停以后收集与删除已有记录不同，也不是纯离线处理。 |
| Pets／宠物 | 可选的桌面悬浮伙伴与交互入口。 | 更换形象不会改变模型能力和权限。 |
| 实时语音／Voice | 边说边交流，查看进度或调整工作。 | 麦克风权限不等于同时开放屏幕和电脑操控。 |
| Appshots／应用快照 | 把最前方窗口的图像与可读取文字作为聊天材料。 | 文字可能不止当前可见的一小块；不是持续监控或操控整台电脑。 |
| Composer Predictions／输入预测 | 给下一条消息提供建议，接受后成为可编辑草稿。 | 按 Tab 接受不等于自动发送，也不是每个账号都提供。 |
| 分享快照 | 把某一时刻的聊天内容作为只读内容分享。 | 不会跟随原聊天持续更新，也不授予接收者访问你的电脑。 |
| Record & Replay／录制与回放 | 演示一段操作，把工作方法整理成可复用技能。 | 不是聊天历史录像，也不保证以后机械重复同一组鼠标坐标。 |

回看：第 18—20、22 章。遇到异常时，先回第 21 章找排查顺序。

## 最后记住这四个区别

- **模型**：由什么能力处理。
- **推理强度**：投入多少思考。
- **工作位置**：动作在哪里发生。
- **权限**：允许访问什么、执行什么。

再问自己三句话：现在处理哪份材料？动作发生在哪里？我怎样检查结果？
