对应workbuddy-start第 1.1 / 1.2 节 · 形态：一页，可打印填写
用途：装之前先确认「这台机器行不行」，装完再核对「三个设置对不对」。90% 的安装报错能在这页拦掉。
第一部分 · 环境自查（装之前填，四行）
| 项目 | 要求 | 我的实际情况 | 是否达标 |
|---|---|---|---|
| 操作系统版本 | 官方文档列出的最低版本及以上 | ☐ 达标 ☐ 不达标 | |
| 可用内存 | 建议 8 GB 以上（同时开浏览器时 16 GB 更稳） | ☐ 达标 ☐ 不达标 | |
| 目标盘剩余空间 | 至少留出安装包体积的 3 倍 | ☐ 达标 ☐ 不达标 | |
| 安装 / 工作目录路径 | 纯英文、无空格、非同步盘、非系统临时目录 | ☐ 达标 ☐ 不达标 |
怎么查（Windows）：设置 → 系统 → 关于（看版本与内存）；此电脑 → 右键目标盘 → 属性（看剩余空间）。怎么查（macOS）：左上角 → 关于本机；访达 → 选中磁盘 → 显示简介。
四行里最容易踩的两个
| 情况 | 会发生什么 | 怎么改 |
|---|---|---|
| 路径含中文或空格 | 安装到一半报「路径无效」，或装完读不到文件 | 换成 D:\ai-workspace 这类纯英文短路径 |
| 指向 OneDrive / iCloud / 坚果云 | 文件被同步进程锁定，工具写入时报「文件被占用」，且每次同步都重传 | 工作目录移到本地非同步目录；需要备份用单独的备份策略 |
判定规则：四行里有任意一行不达标，先处理这一行，再开始安装。不要抱着「先装上再说」的心态——装到一半失败，残留文件比装不上更难清。
填写示例（一台虚构的家用 Win11 笔记本）
| 项目 | 要求 | 我的实际情况 | 是否达标 |
|---|---|---|---|
| 操作系统版本 | 官方文档列出的最低版本及以上 | Windows 11 家庭中文版 24H2 | ☑ 达标 |
| 可用内存 | 建议 8 GB 以上（同时开浏览器时 16 GB 更稳） | 16 GB（已占用 9.2 GB） | ☑ 达标 |
| 目标盘剩余空间 | 至少留出安装包体积的 3 倍 | D 盘剩余 96 GB | ☑ 达标 |
| 安装 / 工作目录路径 | 纯英文、无空格、非同步盘、非系统临时目录 | 初填 C:\Users\我 的文档\AI 工具（含中文 + 空格）→ 改为 D:\ai-workspace | ☐→☑ 达标 |
读法：第四行填的是「初值 → 改成什么」，这正是这张表的意义——不达标不是放弃安装，是先改再装。那一行改完的 D:\ai-workspace 同时用在了第三部分的三个设置里，整张清单是连着的。
第二部分 · 安装过程核对
| 步 | 动作 | 完成 |
|---|---|---|
| 1 | 从官方渠道下载（核验来源域名、文件大小、数字签名） | ☐ |
| 2 | 记录安装包版本号与下载日期：版本 ______ 日期 ______ | ☐ |
| 3 | 遇到权限提示时，确认提示来源是安装程序本身，再授予 | ☐ |
| 4 | 安装完成后先不导入任何资料 | ☐ |
为什么记录版本号：三个月后遇到问题，第一句要问的就是「你装的是哪一版」。没记就只能猜。
不要从第三方下载站装：捆绑安装、旧版本、改包是常态。省下的两分钟，后面可能要用两小时清。
第三部分 · 首次启动的三个设置（关键）
| 设置项 | 建议值 | 为什么 | 我的设置 |
|---|---|---|---|
| ① 工作目录 | 专门建的空目录，如 D:\ai-workspace | 它决定工具能看到你哪些文件。指向桌面或整个用户目录，等于把全部资料交出去 | |
| ② 默认输出位置 | 与工作目录分开的子目录，如 D:\ai-workspace\out | 输入输出混在一起，事后分不清哪份是工具产出、哪份是原件 | |
| ③ 开机自启 | 试用期先关掉 | 后台常驻会占内存、可能扫描文件；确定长期使用再开 |
设置完成后的验证（必做，30 秒）
发一个空任务：
列出当前工作区里的文件，只输出文件名。- 能看到文件列表 → 安装与目录授权都通了，继续往下学。
- 列表为空 → 工作目录设错或授权未生效，回第 ① 项重设。
- 报权限错误 → 回第一部分第四行，检查路径是否在受保护目录（如
C:\Program Files）。
填写示例（同一台虚构笔记本）
| 设置项 | 建议值 | 我的设置 |
|---|---|---|
| ① 工作目录 | 专门建的空目录，如 D:\ai-workspace | D:\ai-workspace（新建空目录） |
| ② 默认输出位置 | 与工作目录分开的子目录 | D:\ai-workspace\out |
| ③ 开机自启 | 试用期先关掉 | 关 |
验证结果记一行：2026-11-08 空任务返回 3 个文件名 → 通过。看文件列表也算结果，要记下「列出了几个」——空列表和报错是两种不同的失败，对应的回查位置不一样。
第四部分 · 卸载与重装（不要等到出事才学）
正确顺序，少一步就会留残留：
- 先退出进程（托盘图标右键退出，不是直接关窗口）；
- 系统设置里卸载程序；
- 手动删除残留配置目录（Windows 一般在
%AppData%下以产品名命名的文件夹）； - 确认工作目录里的原始资料没有被删——卸载不该动你的文件，如果被删了，说明当初把资料放进了安装目录，这是设计错误。
重装前：把配置文件复制一份到工作目录外。重装后配置会丢，任务模板和授权记录都要重设。
自查
- [ ] 四行环境自查全部达标，并写下了实际值
- [ ] 能说出为什么不把工作目录放在同步盘
- [ ] 三个设置项都已按建议配置，并知道各自影响什么
- [ ] 用空任务验证过：能读到工作区文件
- [ ] 知道卸载的正确顺序（先退进程 → 卸载 → 清残留 → 确认资料还在）
四项都能做到，1.1 / 1.2 两节的自查就完成了。做不到的项，回到对应小节重看，不要往下跳——第 2 章的目录授权建立在这四行之上。
*纷析云（杭州）科技有限公司 · codebiz.cn ｜ 本材料为课程配套，随课程版本更新*