ZCode Agent
ZCode Agent 是 ZCode 自研的默认智能体，也是新建任务时最直接的提问入口。您可以在同一个工作台里提出需求、补充上下文、引用文件、调用命令，并选择适合当前任务的模型和执行模式。
作为 ZCode 的核心智能体能力，ZCode Agent 针对 GLM-5.2 系列模型 做了深度适配，在复杂项目理解、长任务规划、多轮上下文保持和连续代码修改上表现稳定。面对需要持续推进的 Long Horizon Task，ZCode Agent 能更好地结合工作区状态、文件引用、执行模式和 Git 分支信息，把一次任务从需求理解推进到落地改动。
工作台入口
ZCode Agent 直接理解 ZCode 的工作区、任务列表、文件引用、模型选择、执行模式和 Git 分支状态，因此适合承担从需求理解到代码修改再到提交前检查的一整条开发链路。
使用 ZCode Agent 时，可以在输入框中直接 @ 引用文件，使用 / 调用命令，通过 $ 调用技能，并在同一个任务里切换模型、执行模式和分支。对于日常开发任务，它通常是最稳定的首选入口。
补充上下文
在聊天输入框左下角点击「+」，可以快速为当前任务补充上下文：上传附件、引用文件、关联历史对话或调用命令。你也可以直接在输入框中键入对应符号，触发相同的能力。
| 入口 | 触发符号 | 作用 |
|---|---|---|
| 添加附件 | — | 上传截图、文档、需求材料等文件，作为当前任务的上下文 |
| 插入 @ 提及 | @ | 引用工作区中的文件，让 Agent 精准定位到相关代码 |
| 插入 # 会话 | # | 关联历史对话，把已有任务的上下文带入当前任务 |
| 插入 / 命令 | / | 调用已保存的命令，快速复用固定提示词或流程 |
提示：除上述入口外，输入框还支持
$调用技能。先描述目标、再用@、#、/、$精准补充上下文，通常能让 ZCode Agent 更快理解并完成任务。
项目指令文件
如果希望长期约束 ZCode Agent 的行为，可以添加 AGENTS.md 指令文件。ZCode 会在启动任务时读取该文件，并把其中的项目约定、编码规范、验证方式、注意事项等提供给 Agent。
ZCode 当前读取两个来源：
| 来源 | 路径 / 查找方式 | 说明 |
|---|---|---|
| 用户全局指令 | ~/.zcode/AGENTS.md | 适合写入跨项目通用的个人偏好、协作方式和常用约定。 |
| Workspace 指令 | 当前 Workspace 中的 AGENTS.md | 适合写入当前项目专属的工程约定。 |
如果两个来源都存在，ZCode 会先拼接用户全局指令，再拼接工作区指令；工作区指令会被视为当前任务的主要项目来源。如果两个来源都不存在，则不会注入项目指令内容。
CLAUDE.md 不作为 ZCode Agent 后续运行时持续读取的项目指令文件。对于已有 Claude Code 项目，ZCode 只会在 onboarding 阶段做一次性迁移，将已有内容复制到 AGENTS.md，迁移后以 AGENTS.md 为准。
项目指令文件适合写入稳定、可复用的团队约定，例如：
- 项目的技术栈、目录结构和关键模块说明。
- 代码风格、命名规范和提交前需要执行的验证命令。
- 对高风险文件、生产配置、权限操作的额外注意事项。
- 团队希望 Agent 遵守的协作方式，例如先给计划、少做无关重构、优先使用现有工具链。
提示：ZCode 只读取用户全局
AGENTS.md和当前 Workspace 的AGENTS.md，不会合并多个层级的AGENTS.md。当前也不会扫描子目录、展开@import/@include，或根据任务类型自动选择规则文件。建议将最重要、最稳定的项目规则放在当前 Workspace 的AGENTS.md中。
执行模式
执行模式控制 ZCode Agent 在修改文件、执行命令前的确认策略：是每步先确认、先出计划，还是尽量连续地完成任务。你可以根据任务风险、复杂度和是否需要持续介入，在不同模式之间快速切换。
当前可选模式
ZCode Agent 当前的执行模式菜单包含以下模式，聊天输入框聚焦时可用 Shift + Tab 快速循环切换：
| 执行模式 | 工作方式 | 适用场景 |
|---|---|---|
| 变更前确认 | 每次修改文件前都先询问确认 | 关键代码、生产配置等高风险改动 |
| 自动编辑 | 自动编辑文件，命令等高风险操作仍需确认 | 常规迭代开发，希望减少编辑确认 |
| 计划模式 | 先检查代码并给出计划，确认后再开始编辑 | 需求复杂、步骤较多、希望先校准方案的任务 |
| 完全访问 | 编辑文件与执行命令时尽量减少确认次数 | 目标明确、风险较低、希望快速推进的任务 |
提示：如果任务涉及关键文件、命令执行或大范围修改，优先使用计划模式或变更前确认；若只是常规编辑或明确的小任务，可以使用自动编辑或完全访问来减少打断。
推理强度
推理强度（思考级别）控制模型在回答前是否进行深度思考：开启后会以更充分的思考过程处理问题，结果通常更稳定，但响应也会更慢一些。在聊天输入框右下角、模型名称旁的思考图标处即可切换。
以 GLM 系列模型（GLM-5.2 等）为例，推理强度分为两档：
| 档位 | 工作方式 | 适用场景 |
|---|---|---|
| Off | 不进行额外思考，直接回答 | 简单问答、明确的小修改，响应最快 |
| On | 默认以最深的思考深度处理任务 | 复杂架构设计、疑难 Bug 排查等高难度任务 |
接入的其他模型（如 Claude、GPT 等）同样支持推理强度调节，可选档位随模型而定，按需在同一入口切换即可。
建议：简单任务可关闭推理强度以获得更快响应；遇到复杂任务时开启即可，开启后会默认使用最深的思考深度处理问题。
使用建议
- 先描述目标：在输入框里直接说明要实现、修复或分析的内容，让 ZCode Agent 先建立任务目标；需要多轮迭代的长任务，可使用 目标模式（Goal） 设定可校验的会话目标。
- 再补充上下文：使用
@引用关键文件，或通过附件补充截图、文档和需求材料。 - 用命令和技能提效：需要固定流程时使用
/调用命令；需要复用能力时使用$调用技能。 - 根据风险选择执行模式：普通编辑可用更高效的模式；涉及关键文件、命令执行或提交前检查时，使用计划模式先校准方案。
- 保持同一任务连续推进：同一个任务里可以持续追问、补充约束、查看改动并完成提交前确认，避免把上下文拆散。