这节要做成什么
写下自己看到的入口和版本限制；从虚构 brief 中摘出 3 条带原文依据的行动项，所有内容仍只是本地草稿。
TraeWork 是历史检索词，当前教学以 TRAE 为准。网页、桌面、移动端以及账号、地区、组织权限可能不同。本配置不表示已经登录、安装、授权、连接 MCP/浏览器、运行命令、发布或部署。
官方说明 TraeWork 和 TraeCode 已融合为新的 TRAE；桌面版可在 Agent 和 IDE 间工作，IDE 中还有 SOLO。你的界面以实际可见内容为准。先下载本节虚构材料，第一遍只看图片和步骤；确认自己找到入口后，再照着做。做不下去时，不要跳到高权限操作，直接用本页的“卡住怎么办”。
遇到不懂的词？点开看一句解释，不用先背概念
- 提示词
- 你交给 AI 的工作说明。写清要看什么、不能做什么、要留下什么；它不能替你打开权限，也不能替你确认结果。
- 上下文
- 这一次实际交给工具看的内容。聊天里提到文件名，不等于文件已经上传、被读到或理解正确。
- 项目 / 工作区
- 把同一件事的聊天、文件或设置放在一起的地方。不同产品叫法不同；不要假定它自动连上网盘、邮箱或所有旧聊天。
- API
- 让程序调用服务的入口，常常和网页聊天是两套权限与收费。密钥像密码，不要放进提示词、网页前端或仓库。
- 命令行 / 终端
- 用文字命令操作电脑或工具的窗口，不是网页聊天。教材给出命令示例，不代表你的电脑已经安装、运行或通过测试。
- 连接器
- 把外部资料或工具接给 AI 的通道。看得到可连接的选项，不等于已经获准读取、写入或发送；先看范围和授权。
- 改动对比（Diff）/ 分支
- 改动对比会显示文件哪里变了；分支把新尝试放到单独副本，方便逐项看、测试和撤回。
- 试跑（dry-run）
- 先预览或模拟流程，不真实发送、付款、发布或改生产记录。试跑不是正式执行，也不是完成证明。
- 草稿 / 成品
- 草稿只是候选内容；有的产品把可展示内容叫 Artifact。文件能打开、来源能回查、人工检查通过后，才可以说它是可交付结果。
- 记忆（Memory）
- 有些产品会保存偏好或历史信息，开关和范围要按当前账号设置与官方说明核对。本课仍只使用明确给出的材料。
- 待确认
- AI 可能写出听起来合理、却没有依据的话。找不到原始来源的数字、事实或结论，要写“待确认”，不能润色成肯定句。
- 检查与恢复
- 检查是按清单看文件、来源、公式或测试记录；恢复是回到可用的文件或版本。小测通过、多个 AI 答案相同，都不能代替这两步。
只准备这一节用得到的材料
人工核对后，把 3 条行动项存到 notes/first-win-action-items.md；这只是草稿，不表示 TRAE 做过外部动作。
只依据虚构 brief.md 的一小段文字，写 3 条行动项；每条后写“依据：原文关键词”。不要读其他文件、写文件、发送或发布。完成后回看来源。没有对应工具时，用同一小样本手工整理，并明确写“未在工具中执行”。
看清界面，再动手
先看图注中的产品、端和状态，再找相同文字或区域，然后才照下一步做。已登录实拍只证明图注写明的局部状态；官方参考不表示你的账号已连接、获权或执行。
这是官方动画中提取的原始单帧，不是本课程练习目录、任务契约或人工审批已经执行的证据；画面没有显示文件上传、计划内容或产物。
查看原始来源 ↗ · 查看原尺寸图，可缩放小字 ↗- ① 先找什么
- 输入框下的 Manual Approval 和 Local 行，以及左栏的 New task。
- ② 正常会看到什么
- 可以认出一个真实的新任务工作面中把执行前复核和本地范围放在任务输入附近；并不显示课程副本。
- ③ 和图不一样怎么办
- 若没有 Manual Approval 或 Local，记录当前版本和界面；仍手工建立副本、output/、notes/，不要为追平截图而开远程或外部权限。
作者个人教程案例，不是青禾练习副本；Open Folder 只说明入口存在，不能证明课程文件已导入、远程主机已连接或权限已授予。
查看原始来源 ↗ · 查看原尺寸图，可缩放小字 ↗- ① 先找什么
- Open Folder 与 Clone Git Repository 两个项目入口。
- ② 正常会看到什么
- 能区分本地副本导入与克隆仓库；本课优先选本地练习副本，不连接远程主机。
- ③ 和图不一样怎么办
- 若入口名称不同或只见网页端，记为手工传递，不把网页对话说成本地文件系统。
公开官方文档中的样例界面，不是本课程账号或虚构练习目录；不能证明学习者已导入文件、已执行计划或有相同权限。
查看原始来源 ↗- ① 先找什么
- 中央新任务输入框下的“本地/选择文件夹（可选）”以及右上IDE切换。
- ② 正常会看到什么
- 能定位官方Agent任务工作面与可选本地目录入口；画面没有课程文件已导入的证据。
- ③ 和图不一样怎么办
- 界面无此入口时记录版本和界面，只手工处理 brief 短摘录；不要安装或授权以追平截图。
分步跟做 · 完整课文
先确认自己打开的是哪一个产品和页面，再看图、读这一步、照着做。下方保留完整原课文、提示词和检查要求；找不到入口或结果不一样时，不要猜按钮，先用“卡住怎么办”。
学习目标与先修
：先做两件小事：复制练习材料，再写下你能看到什么。零基础就能开始。先准备一个你有读写权限的本地文件夹；不用会 Git。做完后，你会有一份真实入口和版本的记录，也不会碰原始材料。
必要概念
：工作区就是允许工具读取或修改的一组本地文件，不是它能随意查看的网盘。任务说明是写清“要 AI 做什么”的说明，里面要有输入、边界、输出和检查方法。版本核对是看自己的客户端、地区、账号和菜单，不是照着别人的截图找按钮。官方 2026-10-08 的更新介绍 Agent 窗口可跨项目管理任务和产物；你没看到它，就写“未验证”，不要假装有。6
具体操作（约 40 分钟）
：
- 先打开官方入口，先别下载或授权。记下网站域名、你能见到的网页/桌面/移动入口、登录区域提示和日期。这样以后不会把别人的版本当成自己的版本。
- 已装桌面版时，先到“关于 / 更新 / 版本”一类位置记下版本号。再按功能名找 Agent 和 IDE。官方快速开始说默认进入 IDE，也可切到 Agent，但你的界面可能不同。3 找不到就停下，写“未验证”；不要为了找功能安装陌生软件。
- 用文件管理器把整个
practice复制为qinghe-trae-practice。进入副本后新建output/和notes/。不要在原目录运行build_practice.py，它会重建材料。原件和练习结果分开，出错时才有地方退回去。 - 打开
notes/version-check.md。写日期、客户端、入口、可见模式、能否上传文件、有没有 Agent/IDE/SOLO、是否受组织规定限制。没见到的写“未验证”，不要写成“没有”或“肯定有”。 - 桌面版能用时，先找“打开文件夹 / 选择项目”，只导入副本根目录。用网页时，只建一个练习任务，不上传真实资料。官方说明桌面版可以导入本地文件夹或克隆 Git 仓库。3
- 先把下面提示词发给 AI，只让它复述范围和列计划。它不该写文件、跑命令或联网。等复述正确，再做后面的课。
可直接复制的提示词
：
你是青禾学习工作室的练习助手。
本次只做环境与任务边界核验，不读取未明确提供的系统，不运行命令，不写文件，不联网搜索，不发送或发布任何内容。
已知材料位于当前练习副本，可能包含：brief.md、sales.csv、leads.csv、meeting.md、knowledge.md、acceptance.md。
请输出：
1. 你准备读取的文件清单；
2. 你不能做的外部动作；
3. 一个不超过6步的后续工作计划；
4. 你需要人工确认的入口、权限或版本问题。
不要计算数据，不要把缺失信息自行补全。
练习
：先在 notes/version-check.md 写至少 8 行记录。再把提示词发给可用 AI 对话；本机没有 TRAE 时，手写你期待的计划也算完成。练的是把边界说清楚，不是成功登录。
检查方法
：确认有练习副本和 output/；记录里把“看见”和“未验证”分开；AI 的回答没有说要发邮件、发布、付款、删除或覆盖原始文件。
常见失败与修正：把网页对话当成本地磁盘时，只粘贴一小段样本并写明来源；找不到 SOLO 时，不装来源不明的插件，改用能看到的普通对话或 IDE；AI 提出跑命令时，先让它解释命令、目标路径、影响范围和 dry-run，再决定是否手动执行。
公开界面示例：只用来认位置
下面的画面来自公开演示，只帮你认功能大概在哪里。它们不是本课已完成的记录，画面里的示例数字也不是青禾练习答案。
- 先复制 practice/，再在自己的新任务或项目入口中只选择该副本根目录。
- 若可见 Manual Approval，保留人工批准；若不可见，在 notes/version-check.md 记为未验证。
- 在输入框粘贴课01边界提示，只要求复述范围与计划，不运行命令或写文件。
- 记下当前版本、可见入口和未验证项，不把公开样例当成自己已经做成功。
只在这份虚构练习副本里跟做。要连外部服务、改权限、发给别人或发布前，先问你自己或负责人；不要照搬演示者的授权范围。
先照着做，再自己做一遍
先对照上方图片和完整步骤，确认你输入了什么、看到了什么、在哪一步停下；不要只复制提示词。
先按四句虚构 brief 在模板写“看见 / 未验证 / 不做”，再逐句摘出 3 条行动项和原文依据。
换一段自己改写的 50 字虚构课程 brief，独立写 3 条行动项、1 个待确认问题和 1 个不能执行的外部动作。
这节要保存的文件
这些文件名是本节的检查要求。只有你实际生成、保存并能打开，才算做成；下载的模板不是已经完成的结果。
文件不会上传。这个检查只看栏目，不会替你核对数字、事实、真实工具操作或组织批准。
自己逐项检查
勾选是你的自检记录，不是教师认证。最好请另一位人核对来源、公式或测试。
卡住怎么办
先停在当前步骤，记录页面上实际看到的文字和端别；不要为了和图一致而扩大权限、提交、发送或删除。
找不到本地文件夹选择
不把网页端当作本地磁盘；手工粘贴brief短摘录并在记录中标“手工传递”。
AI提出运行命令或写文件
停止在计划阶段，要求先解释路径、影响和dry-run；本课不执行。
确认自己真的分清了
每题都有解析，可以重复作答。答对概念题不等于已经在外部系统完成操作。
记下这次，下次接着学
未登录时记录只留在当前浏览器。登录后，只有你确认合并并启用同步，状态和笔记才会同步；作业原文和文件不会上传。
