第 8 章 · 环境配置：先验证能力，再增加工具
选择入口，先确认能做什么
本章以 Trae/TraeCode 的官方中文文档作为一种具体入口，同时提供通用验收步骤。不同地区版本、账号方案、IDE 与 CLI 的能力可能不同；本教程没有对你的本地 Trae 界面逐项实测。
从官方网站获取客户端，确认系统要求和账号可用性。登录可能用于服务访问、计费等，并不只是同步配置。安装后，先检查以下能力：
| 能力 | 怎么确认 | 不具备时怎么办 |
|---|---|---|
| 模型对话 | 简单问答成功 | 检查登录、额度、网络和可用模型 |
| 文件读取 | 能返回测试文件中的指定一句话 | 粘贴材料，或按官方说明添加文件能力 |
| 文件写入 | 实际创建一个可打开的小文件 | 先做纯文本练习 |
| 命令/代码运行 | 明确显示执行结果或错误 | 暂不做依赖脚本的任务 |
| 网页检索 | 能给出已访问的来源与日期 | 人工提供官方资料 |
| 技能发现 | 技能面板或日志可见 | 按第 9 章配置，不能以输出风格代替验证 |
很多 IDE 已内置文件和终端能力。文件系统 MCP 不是必装项；也没有一个所有产品通用的“Office MCP”。
模型连接有不同方式
产品可能提供内置模型、订阅登录、企业网关或自定义 API Key。按当前版本支持的方式配置，不要假定所有客户端都能接任意提供商。
使用自定义 API 时，核对提供商、接口地址、模型标识和计费主体。消费产品订阅与 API 额度不能默认互通；不要把密钥写到教程截图、提示词、技能文件或公开仓库。
初学先保持模型默认参数。有些推理模型不支持或限制 temperature；把它调低也不能消除事实错误。先用固定样例比较结果，比机械设置“公文 0.1、创作 1.0”更可靠。
建立练习目录
ai-office-lab/
├── input/ 原始练习材料，保留不改
├── output/ 生成结果
├── references/ 已核实的参考资料
└── .trae/
└── skills/ 使用该产品项目技能功能时建立
“不要改 input/”是操作约定；需要强制保护时，还要使用文件权限或沙箱。将工作目录限制到练习项目，不授权整个磁盘。
先手动新建 input/测试记录.txt，写入“练习编号：LAB-001；主题：示例会议”。然后发出：
读取 input/测试记录.txt，告诉我练习编号。
将主题复制到 output/读取结果.txt，不修改原文件。
完成后重新读取输出文件，报告内容与实际路径。
如果不能读写文件，说明缺少的能力，不要声称已保存。
自己打开结果验证。遇到失败先看日志：文件不存在、路径无权访问、命令未安装和模型错误，解决方法不同。
确有缺口时再配置 MCP
参考 Trae 工具面板 进入 MCP 管理，按目标服务的官方配置填写启动命令或远程地址、所需凭据和授权范围。不要盲目粘贴来路不明的安装命令，也不要把网络服务地址和本地启动命令混用。
验收分三步：连接成功、工具可见、一次只读测试返回正确结果。服务显示“已连接”不等于业务权限与参数都正确。
本章通过条件
- 能完成上述读写小实验，或明确记录只能使用纯文本模式；
- 知道模型与工具分别由谁提供，敏感资料是否会传到外部；
- 知道哪里查看执行记录、停止任务和调整授权；
- 后续用到的文件格式、编译器或编辑器已确认，而非默认存在。
参考：Trae 官方文档、推理模型参数与提示建议。