使用手册 · 本站原创整理 · 独立阅读版
ZCode 使用手册
连接模型、打开工作区，完成一个小网页并检查文件。
入门步骤
1. 安装后，先确认模型连接
ZCode 是智谱的桌面编程工具，工作区用来确定本次任务所在的项目。应用安装完成和模型连接成功是两件事，先完成接入再开始文件任务。
- 从 ZCode 官网下载与你的系统和芯片匹配的安装包，完成安装。
- 首次启动选择“开始使用 ZCode”；不需要迁移旧对话时可先跳过迁移。
- 通过左下角“连接使用”按自己的情况连接 BigModel、Z.ai 或配置模型接入。
- 核对账号权限、套餐或调用费用；不要把账号密钥写入练习文件。
入门步骤
2. 打开练习工作区，先读后写
新建一个空的 hello-page 文件夹作为练习工作区。打开后先确认位置，再让 Agent 列出目录；如果里面已有文件，先弄清用途。
- 从工作区入口打开 hello-page；也可以在快捷入口中找到“打开文件夹”。
- 创建任务，发送下面的只读请求。
- 核对回复中的目录与实际选择一致，再进入下一步。
请列出当前工作目录及其中的文件，说明哪些文件已经存在。现在只做检查，不创建、不修改、不删除任何文件。入门步骤
3. 生成一个范围明确的小网页
第一项任务不需要数据库、登录或部署。让 Agent 先交代文件计划，再完成一个静态页面，方便直接检查。以下是本站教学任务。
- 检查计划是否只涉及当前练习目录和必要文件，再确认执行。
- 等待文件生成，核对实际创建的文件列表。
- 如果任务中途失败，保留错误信息，让 Agent 从失败步骤继续。
请先说明文件计划，等我确认后在当前练习目录创建一个“周末阅读角”网页。需要标题、三本虚构书籍卡片和页尾说明；所有文案为中文，不含真实联系方式。使用 HTML 和 CSS，无需后端、外部图片或在线字体。页面在手机宽度下也能阅读，不覆盖已有文件。完成后列出文件路径及打开方法。入门步骤
4. 从文件树查看结果，再改一处
官方文件树支持单击预览文件，也支持双击或 Enter 用默认编辑器打开。需要 Agent 处理某个文件时，可以把文件拖入输入框，或用右键的“添加到聊天”。
- 点击工作区的文件树图标，找到刚生成的 HTML 和 CSS。
- 预览代码，再按生成时提供的方法用浏览器打开网页。
- 缩窄浏览器，检查卡片换行和文字是否溢出。
- 引用相关文件，要求只修正一个问题，完成后重新检查。
请检查刚才网页的窄屏布局。如果三张卡片挤在同一行，请只修改必要的样式，让窄屏变成单列。保留标题、卡片文字和配色，列出修改文件以及实际执行的检查。入门步骤
5. 把任务和项目整理好
任务列表可以按分组、工作区或时间线组织。围绕同一个网页继续修正时，保留已有任务的上下文；切换到另一项目时，先确认工作区。
- 用工作区视图找到 hello-page 下的任务。
- 后续修改继续说明具体文件、要改的内容和完成标准。
- 任务完成后保留文件；归档只是整理任务列表，不代替文件备份。
- 熟悉基本流程后，再通过官方目录学习目标模式、Skill、MCP 和自动化。
功能用法
6. 用目标模式推进有验收标准的长任务
目标模式用于需要多轮完成的任务。目标说明“怎样算完成”，执行模式决定过程中哪些操作需要确认，两者不能混为一谈。先完成一次小任务，再尝试持续运行。
- 在空闲会话的输入框输入 /goal 查看当前目标；处于计划模式或任务正在执行时，先结束当前步骤并核对状态。
- 用 /goal 后接具体目标，写清允许修改的范围和检查方法。已有目标时新描述会替换旧目标，发送前确认对象。
- 查看摘要面板的目标卡片与每轮进度，核对实际文件和检查结果；需要中止时使用 /goal pause，之后可用 /goal resume 恢复。
- 完成后仍要打开产物检查；清除目标不会替你回滚已经写入的文件。
/goal 修复当前 index.html 在 320px 下三张卡片横向溢出的问题。只修改这个文件的必要样式，保留全部文字和桌面三列布局；实际检查 320px 与 1440px，给出修改位置和检查结果。不安装依赖、不部署。功能用法
7. 把固定检查步骤做成 Skill
Skill 适合反复使用的一套工作方法，例如每次网页修改后检查窄屏和导航。它通常由目录及 SKILL.md 组成。下面是本站编写的只读检查技能样例；创建前先确认不会覆盖同名技能。
- 进入“设置 → 技能”，使用“新建技能”向导，或者按官方目录约定创建技能文件。项目专用技能放在项目 .zcode/skills/<技能名>/SKILL.md 中。
- 填写 name 和 description，写清触发条件与输出。保存后点击刷新，检查来源与启用开关。
- 在聊天框输入 $ 选择技能，再补充此次文件和目标；斜杠菜单的技能分组也可以找到它。
- 先用小页面验证检查是否有依据；只启用常用技能，避免大量描述占用上下文。
---
name: page-review
description: 网页修改后，检查文字、导航与窄屏布局，并区分已测和未测项。
---
# 网页检查
只检查用户指定的页面，不修改文件。
1. 读取页面及相关样式，说明检查范围。
2. 能打开浏览器时，检查 320px 与 1440px、导航和键盘焦点。
3. 报告复现步骤和证据；无法运行时明确写“未验证”。
4. 不把静态阅读当作浏览器检查，不自动发布。进阶技巧
8. 用项目记忆保留稳定偏好
官方文档说明 Memory 默认关闭，可在“设置 → 常规”开启；需要支持该功能的版本，当前说明从 v3.6.4 起支持。它保存同一项目的长期偏好，与一次会话的上下文、MCP 记忆服务不同。
- 先判断是否需要跨会话保留规则，再决定开启；开关影响新会话及重启后恢复的会话，进行中的对话保持原设置。
- 只记录稳定约定，例如“这个项目使用 pnpm，不自动提交”；临时端口、当前错误和密码不放入长期记忆。
- 新会话里询问“你记住了这个项目的哪些信息”，逐项核对；过时内容可用“忘掉……”删除对应记忆。
- 记录可能增加模型请求和 Token 用量；远程工作区的支持范围以当前文档为准，不假定与本地相同。
请说明你记住了当前项目的哪些工作约定，区分长期记忆、项目指令文件和本次对话中的临时要求。先只列出来源，不新增或删除记忆。常见问题
9. 常见问题：连接、文件引用和技能识别
先排查接入与上下文，再扩大任务。以下不会要求把 API Key 贴进聊天或练习文件。
终端能调用模型，ZCode 为什么仍未连接？
终端环境变量与桌面模型配置是两套入口，不会自动同步。检查 ZCode 的“连接使用”或模型管理，确认账号、服务地址与可用模型；套餐与通用 API 的端点按官方连接说明选择。
Connect 一直 Loading，或者提示没有额度？
先检查能否访问所选模型服务，再检查账号或 API Key 的模型权限和可用额度。工具安装成功不代表模型调用成功；保留完整错误码后查看官方排查说明。
如何让它针对某个文件夹分析？
在输入框输入 @，按名称筛选文件或文件夹，也可从文件树拖入。发送前检查实际引用的路径；引用目录后仍要说明分析哪些文件、要回答什么，不要只写“看一下”。
Skill 建好了，列表为空或没有被使用？
先核对 SKILL.md 的目录和 name／description 字段，在“设置 → 技能”清除筛选、刷新并检查启用开关。能看到但不主动使用时，写清触发条件或用 $ 显式选择；启用过多技能也会影响描述注入。
案例与练习
10. 实战练习：修复阅读角的手机布局
下面提供一份可下载的 HTML 起始文件。它故意把三张卡片固定成三列，方便在窄屏复现问题。先看到问题，再让 ZCode 只修复相关样式。
- 下载起始文件并保存为独立练习目录里的 index.html，用浏览器打开，先在 320px 宽度观察横向溢出。
- 用 ZCode 打开这个目录，引用 index.html，发送下面的任务。需要先讨论方案时使用计划模式；目标模式是另一种可选流程。
- 修改后刷新页面，在两种宽度重新检查，核对文件差异。无法打开浏览器的检查应保留为未验证。
请读取 @index.html，定位三张卡片在 320px 下溢出的原因。先说明需要改的样式，确认后只修复窄屏布局；1440px 仍为三列，保留全部文案。不要用隐藏横向溢出来遮住问题。完成后列出修改位置、实际检查的宽度与结果；不要部署。来源与核对范围
已核对 ZCode 官方安装、文件管理、目标模式、Skill、Memory 与 FAQ。练习和起始 HTML 由本站编写，未在 ZCode 账号内执行；不将起始文件或验收目标当作产品生成结果。
本文为本站整理，不是官方译本。示例任务与完成标准用于学习，不代表产品承诺。