# 森虫虫系列课 · Codex 功能学习地图

第一次学习，建议先按顺序看第 1—8 章，认识入口、材料、操作和权限。之后按需要学习终端、版本管理、扩展和自动化；遇到具体问题，可以直接按下面的主题回看。

这门课讲基础功能，不要求你跟做一个完整项目。无需一次记住所有按钮，先知道要解决什么问题、到哪里找、操作后检查什么。

## 22 章学习地图

| 章节 | 学完要能做到什么 | 适合回看的主题 |
|---|---|---|
| **01 认识 Codex、安装与入口** | 分清桌面应用与工作模式，建立对能力和结果的合理预期。 | Chat / Work / Codex；安装和登录；代理能做什么；本地安装为什么不等于模型离线。 |
| **02 界面导航与聊天管理** | 找到聊天和项目，把常用记录整理得容易返回。 | 新聊天；历史与搜索；重命名；置顶；归档与恢复；移除项目；显示和隐藏面板。 |
| **03 项目、文件与上下文** | 指定正确的工作材料，判断代理本次知道什么。 | 项目与文件夹；打开目录；文件路径；同项目的不同聊天；可访问与已读取；上下文用量与压缩；跨设备同步。 |
| **04 输入框、资料引用与提问** | 用清楚的目标、材料、限制和检查标准提出请求。 | 添加文件、文件夹与图片；@ 引用；斜杠命令；换行与发送；听写；如何把一句请求说清楚。 |
| **05 运行控制、计划与聊天分支** | 看懂正在发生什么，在需要时停止、调整或分出另一条思路。 | 等待与卡住；停止后的检查；引导与排队；编辑队列；继续；/plan 开关；从计划到实施；聊天分支；具体反馈。 |
| **06 模型、推理强度与使用情况** | 根据问题选择能力和思考投入，而不是盲目开到最高。 | 模型选择器；Sol / Luna / Astra；Power 与 Advanced；推理档位；Max 与 Ultra；用量；慢在哪里。 |
| **07 权限、联网与授权** | 读懂权限选项和批准请求，判断允许什么。 | 请求批准、帮我批准、完全访问；沙箱与审批；命令影响；联网通道；服务登录和授权；拒绝后如何继续。 |
| **08 阅读文件、编辑与预览** | 打开真实产物，分清读取、修改和生成，给出具体反馈。 | 文件链接与路径；导航面板；预览；内容核对；原文件与新版本；检查报告的范围；停止、回退与归档。 |
| **09 终端从看懂到可控** | 认识终端的输入、目录、输出和运行状态。 | 打开终端；命令结构；读写区别；退出状态；命令找不到；权限错误；持续进程；停止命令；清屏；重复动作。 |
| **10 Git 基础与协作动作** | 分清保存、暂存、提交、推送和协作请求。 | Git 与 GitHub；仓库；分支；暂存；提交信息；推送；拉取与冲突；Pull Request；Git 设置。 |
| **11 diff、代码审查与测试** | 选对比较范围，读懂变化，并判断检查结论覆盖了什么。 | diff 的加减行；暂存与未暂存；布局；取消暂存与还原；本地和远程审查；评论与批准；测试；未验证事项。 |
| **12 Worktree、并行与交接** | 理解独立工作目录的用途，避免把隔离当作备份。 | 工作树与聊天/Git 分支；新建前检查；并行分工；依赖缺失；交接；分支占用；同工作树新聊天；清理前保存成果。 |
| **13 本地、云端、远程与环境** | 选对动作执行位置，确认材料和结果在哪里。 | Work in；本地项目；云端环境选择与创建；远程计算机；材料迁移边界；环境依赖；选错位置后的恢复。 |
| **14 Skill / Skills 的发现与使用** | 判断何时需要复用方法，并完成技能的查找和调用。 | 普通请求与技能；搜索详情；创建技能；独立技能安装器；插件技能；$ 选择；自动匹配；停用；检查技能结果。 |
| **15 插件、MCP 与服务连接** | 分清能力包、做事方法和工具连接，检查连接是否真正可用。 | 插件搜索、安装、禁用与卸载；MCP；STDIO 与远程地址；添加服务器；保存重启；认证；/mcp；连接排错。 |
| **16 Hook / Hooks：事件触发的动作** | 读懂触发时机、条件、动作和失败影响。 | 会话与工具事件；匹配器与处理器；来源和信任；配置范围；同步与后台边界；与技能/计划任务的区别；排错。 |
| **17 计划任务与自动化** | 把以后要做的工作安排清楚，并检查真实运行。 | 时间、时区和频率；同聊天跟进与独立运行；创建和保存；立即运行；本地在线条件；运行记录；暂停、修改与结束。 |
| **18 Dot / Dots：持续工作的代理** | 交代长期职责，分清消息、服务和电脑访问，找到进展与控制入口。 | 你的 Dot；初始化；三类连接；云端电脑与 Mac；活动列表；计划和记忆；规则；暂停、停止、删除。 |
| **19 浏览器与电脑操控** | 区分查资料、操作网页和控制应用，确认所需连接与权限。 | 搜索与浏览器；内置浏览器；Chrome 扩展；电脑操控；系统权限；网站许可；上传下载；网页批注；接管与排错。 |
| **20 设置、偏好与配置边界** | 根据想改变的行为找到设置，调整后检查实际效果。 | 设置入口；发送和跟进；防止睡眠；外观；快捷键与通知；AGENTS.md；记忆；Computer History；Pets；config.toml。 |
| **21 排错与恢复控制** | 先辨认故障类型，再用可检查的步骤恢复工作。 | 等批准还是连接失败；找聊天与文件；跑偏后停止；命令失败；按钮缺失；上下文混乱；可重现反馈；恢复顺序。 |
| **22 其他常用功能与复习导览** | 认识辅助入口，并按实际问题选择功能。 | 智能体目录与子代理；实时语音；Appshots；输入预测；分享快照；录制与回放；目标模式；功能选择与复习。 |

## 遇到问题，直接去哪里

| 我现在的问题 | 优先回看 |
|---|---|
| 应用装好了，却分不清自己在 Chat、Work 还是 Codex。 | 第 1 章；界面导航接第 2 章。 |
| 找不到昨天的聊天，或者想改名、置顶、恢复归档。 | 第 2 章；仍找不到看第 21 章。 |
| 它看错材料、漏了文件，或者似乎忘了重要条件。 | 第 3—4 章；上下文混乱看第 21 章。 |
| 它正在往错误方向做，或者新要求不知道该排队还是立即发送。 | 第 5 章。 |
| 不知道该换模型、加大思考，还是调整权限。 | 第 6—7 章；动作位置另看第 13 章。 |
| 收到结果，但不知道文件到底在哪里、有没有真的保存。 | 第 8 章；找不到文件看第 21 章。 |
| 终端滚了很多字，不知道是成功、报错还是还在运行。 | 第 9 章。 |
| 暂存、提交、推送、PR、上线总是混在一起。 | 第 10 章；检查改动接第 11 章。 |
| 想让几件工作并行，又担心彼此改乱文件。 | 第 12 章；子代理见第 22 章。 |
| 切到云端以后找不到本机资料，或不确定远程电脑是什么。 | 第 13 章。 |
| 每次重复交代同一套方法，想保存下来复用。 | 第 14 章；演示操作生成技能见第 22 章。 |
| 插件装好了，但服务仍未登录或工具不能调用。 | 第 15 章；授权概念回第 7 章。 |
| 想在某个动作前后自动检查，或想每天定时运行。 | 动作事件看第 16 章；按时间安排看第 17 章。 |
| 想让代理长期跟进，但不知道去哪里看它在做什么。 | 第 18 章；持续推进单一目标见第 22 章。 |
| 希望读取网页、操作 Chrome 或控制另一个应用。 | 第 19 章；权限问题接第 7 章。 |
| 想改发送键、通知、字体，或弄清规则与记忆。 | 第 20 章。 |
| 想用语音、窗口快照、输入建议或聊天分享。 | 第 22 章。 |

## 不同需求可以这样学习

- **先会日常使用**：第 1—8 章，再看第 20—22 章。先把材料、请求、权限和结果检查弄清楚。
- **开始接触代码和文件版本**：在前面基础上看第 9—13 章，分清终端、Git、差异、工作树与执行环境。
- **希望复用方法和连接服务**：看第 14—15 章，再按需要进入第 16—17 章。
- **需要长期跟进或网页操作**：看第 18—19 章，同时回顾第 7 章的权限边界。
- **正在遇到故障**：先看第 21 章定位问题，再返回相关功能章节，不必把所有设置重调一遍。

## 每学会一个功能，就检查这五件事

1. 它是什么，解决什么问题？
2. 从哪个入口进入？
3. 选择之后，实际改变了什么？
4. 什么情况下适合使用，哪些条件还需要具备？
5. 去哪里检查结果，出错后怎样停下或恢复？

不认识名词时，配合 [新手术语表](新手术语表.md) 查阅。课程中的界面是教学示意；实际使用时，看清自己当前的界面、账号、权限和真实结果。