ZCode 核心能力设置
第 1 步 · 安装并登录 已经装好 ZCode 并登录成功 → 本篇把它的核心能力打开，让它从“能聊天”变成“能动手”。
🌟 核心目标：打开完全访问 + 电脑控制 + 浏览器控制 + 记忆和索引，搞清授权背后的机理与开关用途，让 ZCode 真正能操作电脑和项目。套餐和模型统一放到第 3 步选择，本篇不碰。预计 5～10 分钟。
先照着这张清单设置
- 开启“完全访问”；
- 开启“电脑控制”和输入框按钮；
- 开启“内置浏览器控制”；
- 开启工作区记忆；
- 开启新文件夹和存储库索引。
1. 开启“完全访问”
新建一个任务，在输入框左下角点击权限菜单，选择 “完全访问”。
开启后，ZCode 在执行文件修改、命令和工具任务时不会频繁停下来询问权限，更适合连续完成任务。
这一步做到什么程度算对：输入框左下角的权限标签明确显示为“完全访问”；这张图同时圈出了模型菜单，但本步只选择“完全访问”，模型会在第 3 步统一设置。
为什么敢开完全访问
很多外贸新手看到“完全访问”四个字心里会打鼓：这会不会有安全风险？把权限给 AI 会不会误删文件？
这里讲透背后的机理与放心的理由：
- 受限在受信任的工作区目录：ZCode 并非漫无目的地在整台电脑乱窜，它的读写和命令执行默认严格限制在你在当前任务中打开的本地项目文件夹内。
- 关键节点有安全确认机制：教程推进的整个工作流中，关键交付与外部发布都保留了人工确认节点；AI 负责跑腿写草稿和改代码，最终决定权始终在你手中。
- 如果不放心可以降级审批：如果你对某些敏感任务有所顾虑，随时可以将权限切回默认的逐项批准模式。不过代价很明显：AI 每读取一个文件、每跑一行命令都会暂停并弹窗让你点确认，一个轻量任务可能被反复打断几十次，体验非常割裂。
- 日常推荐配置：在自己的受信任目录做外贸建站、数据整理、代码脚本调试时，开启“完全访问”是效率最高、体验最流畅的省心选择。
2. 开启电脑控制
进入 设置 → 电脑控制，依次完成：
- 开启 “启用电脑控制”；
- 开启 “在输入框显示电脑操作按钮”；
- 确认 辅助功能（Accessibility） 显示“已授权”；
- 确认 屏幕录制（Screen Recording） 显示“已授权”。
这一步做到什么程度算对：设置页面中两个开关均处于开启高亮状态，下方的辅助功能与屏幕录制两栏均出现绿色的“已授权”文字。
完成后回到新建任务页面，输入框右侧或附近应能看到电脑操作图标按钮。
不开电脑控制会怎样
很多新手好奇：只让 AI 看文字不行吗，为什么非要开电脑控制？
- 不开电脑控制的直接后果：当你在建站或运行程序遇到报错弹窗时，AI 无法看到你屏幕上的真实报错画面；它无法帮你点击确定按钮、无法帮你定位图形界面里的配置开关，你必须把报错一行行手打或截图发给它，沟通成本极高。
- 开启之后的核心价值：AI 具备了“看屏幕”和“帮你操作”的眼睛与双手。它能直接识别屏幕上的异常提示，并在你授权下自动完成界面点击与软件调试。
系统授权失败排查路径
在 macOS 系统上，由于系统级隐私保护极其严格，新手经常遇到“弹窗没弹出来”或“勾选了却依然提示未授权”的卡点：
- 排查一：弹窗未弹出时手动添加授权。打开 macOS 的 系统设置 > 隐私与安全性，分别找到 辅助功能 与 屏幕录制。点击列表下方的加号（
+），手动将“应用程序”中的 ZCode 添加进去，并确保右侧开关处于开启状态。 - 排查二：勾选后显示未生效必须彻底重启。macOS 对权限变更的生效机制需要重载进程。勾选权限后，直接关闭 ZCode 窗口可能只是最小化；必须彻底退出应用（按
Cmd + Q），再重新打开 ZCode，设置项就会立刻识别为“已授权”。 - 排查三：Windows 权限提示受限。Windows 用户若遇控制失效，通常检查是否被某些电脑管家的“防外部截屏/按键注入”功能静默拦截，将 ZCode 加入受信任白名单即可恢复。
3. 开启浏览器控制
进入 设置 → 浏览器控制，打开 “开启内置浏览器控制”。
“导入 Chrome 登录状态”不是必选项。只有当你希望 ZCode 内置浏览器直接使用 Chrome 中已登录的网站时，再按需要导入。
这一步做到什么程度算对：顶部“开启内置浏览器控制”开关变亮为已开启状态即可。
不开浏览器控制后果
- 不开浏览器控制的直接后果：AI 在执行网站搭建、竞品分析或页面效果验证时，无法自动启动内置浏览器加载网页；它无法替你检查页面排版是否错位，也无法自动测试网页按钮点击与表单提交是否正常。
- 开启之后的核心价值：ZCode 拥有了一个完全受控的内置沙箱浏览器环境。它能帮你自动打开刚写好的独立站网页，边跑边截屏验证视觉效果，发现前端报错立刻在代码里修正，全程无需你手工在浏览器和编辑器之间反复切屏复制链接。
4. 开启工作区记忆
进入设置，在左侧打开 “记忆”，再开启 “工作区记忆”。如果当前版本没有独立的“记忆”入口，就到 “通用” 中查找“工作区记忆”。
它会帮助 ZCode 在同一工作区持续理解你的项目背景、偏好和已确认规则，减少重复说明。
这一步做到什么程度算对：工作区记忆开关呈开启状态，下方提示说明显示记忆功能已就绪。
开记忆前后的直观差异
很多新手觉得“记忆”听起来很抽象，其实在日常使用中差别非常直观：
- 不开记忆的糟糕体验：每次你新开一个任务提问，AI 都像初次见面的陌生人。你必须把“我们是做不锈钢餐具外贸出口的”、“目标客户是欧美批发商”、“产品牌号主打 304 和 316”这类背景前情提要重新复制粘贴一遍，极易令人疲倦。
- 开启记忆后的质感飞跃：第二天或下周当你再发起新对话，直接问“把昨天的报价条款改得更温和一点”，AI 能直接调出你工作区的历史背景，不需要你再解释项目是做什么的，回答立刻切中业务痛点。
工作区与全局记忆区分
根据软件界面已有的说明规则，两者的边界非常分明：
- 工作区记忆：只记录当前项目或特定工作区内的业务事实、规则与代码约定，项目之间互不污染。
- 全局记忆：跨所有工作区生效，记录你个人的通用沟通偏好（比如“称呼统一用你”、“输出代码默认写中文注释”）。新手先开好工作区记忆即可。
5. 开启索引库
进入 设置 → 索引库，打开：
- “索引新文件夹”；
- “索引存储库以实现即时搜索”。
这样 ZCode 打开新项目后可以更快检索文件和理解仓库内容。
这一步做到什么程度算对：索引库设置页面的两个开关均保持开启，ZCode 在载入新文件夹后能自动在后台建立符号与语义索引。
索引库运作机理与效用
外贸独立站或自动化项目动辄包含几十上百个文档、脚本与样式文件。不开索引时，AI 每次回答你关于代码与文本的问题，都必须像人工挨个翻文件夹一样临时全盘遍历，不仅回答响应变慢，面对较深目录还极易遗漏关联定义。
开启索引库之后，ZCode 会在后台静默为项目内的代码符号、文件名与语义文本建立结构化倒排索引：
- 秒级定位目标文件：当你发出指令“找到我们产品的英文规格参数表”，它能瞬间定位具体文件路径并读取核心字段；
- 全项目上下文关联感知：当你在一个文件里修改了变量名或产品链接，AI 能通过索引预先感知到其他页面是否存在引用，避免改漏引发页面损坏。
因此，将“索引新文件夹”和“索引存储库以实现即时搜索”保持常开，是保证 AI 拥有全局工程视野的基础。
📋 设置阶段避坑汇总
| 坑 | 后果 | 怎么避 |
|---|---|---|
| 🔴 只开“完全访问”，没开电脑控制或系统授权 | 文件/命令权限有了，但输入框不会出现电脑操作按钮，也控制不了屏幕 | 完全访问是任务权限，电脑控制是另一项能力；电脑控制 + 辅助功能 + 屏幕录制三项都要单独确认授权 |
| 🟡 macOS 勾选授权后以为立即生效 | 没重启进程导致权限判定失败，反复开关折腾 | 勾选系统权限后，务必按 Cmd + Q 彻底退出 ZCode 再重新启动 |
| 🟡 顺手在本步改了模型 | 与第 3 步来回冲突 | 本步只开能力，模型统一留到第 3 步 |
| 🟡 担心完全访问不安全而一直选逐项批准 | 每一步读写命令都要手动点几十次确认，工作流被极度碎片化打断 | 受信任的项目目录放心开启完全访问，关键输出保留人工验收节点即可 |
| 🟢 把“导入 Chrome 登录状态”当成必选 | 多一步、还涉及账号数据 | 只有需要复用 Chrome 登录态时才导入，日常建站测试完全无需导入 |
✅ 完成检查
回到新建任务页面，确认：
- 权限显示“完全访问”；
- 输入框显示电脑操作按钮；
- 系统设置中辅助功能与屏幕录制均已授权；
- 内置浏览器控制已打开；
- 工作区记忆已打开；
- 两个索引开关已打开。
📚 延伸阅读
- 📚 第 1 步 · 安装并登录：还没装好 ZCode 的先回到这一步
- 📚 第 3 步 · 套餐与模型配置：选好内置套餐和日常模型
- 📚 第 4 步 · 安装 ZCode AI 员工团：让不同模型按岗位协作
📄 第 3 步 · 套餐与模型配置 —— 选好套餐和日常模型，ZCode 就可以直接开始干活了。