基础应用

一、把对话聊明白

思考模式三档

输入框上方可以切换思考档位，跟随会话设置，也可临时修改：

• 关闭：直接回答，速度最快，适合简单问答；
• 思考：回答前先输出一段推理过程，适合有判断量的任务；
• 深度思考：更长的推理预算，适合复杂分析。思考过程内联在正文上方，灰色斜体区分，实时滚动。

任务要交代清楚

czagent 的智能体会自主决定调用哪些工具，所以把「目标、涉及文件、完成标准」说清楚，效果远好于一句话需求。例如：

把 src/utils/date.ts 里的 moment 引用全部换成 dayjs，
保持对外函数签名不变，改完跑 pnpm test 确认。

• 附件理解：点输入框附件按钮（或直接拖入）PDF、Word、Excel、图片，自动解析后一起提问，比如「总结这份 PDF 的第三章」。
• 随时可停：流式过程中发送按钮会变成停止，点一下立即中止本轮。
• 草稿保留：输入到一半切走会话，草稿自动保存。

二、任务清单：盯住多步任务

智能体接到多步任务时会自动在右侧面板维护一份任务清单，每完成一项就打勾，你可以随时看到它推进到哪一步。也可以在对话里直接要求：

先建任务清单再开始：1. 梳理现有 API 路由
2. 补充参数校验 3. 更新接口文档 4. 跑通测试

三、上下文压缩与用量

• 长会话接近上下文上限时，自动压缩开始：消息流出现「正在生成摘要」，完成后原地变成可展开的折叠条，对话无缝继续。
• 压缩行为可在「设置 → 通用」调整：开关、保留 token 预算、保留窗口比例。
• 右栏与页脚实时显示当前会话的 token 用量，多轮可见，心里有数。
• 也可以在输入框随时说「压缩一下上下文」，手动触发。

四、AGENTS.md：项目级指令

在会话工作目录放一个 AGENTS.md，内容会自动拼进每个 Agent 的系统提示词——相当于给这个项目写一份「新人须知」，一劳永逸：

# 项目约定
- 包管理用 pnpm，不要用 npm
- 构建命令：pnpm build；测试：pnpm test
- 代码不加注释，提交信息用中文
- 改动 src/core 前先读 docs/dev/architecture.md

五、Plan → Build 工作流

对重要改动，别让智能体上来就写：

1. 切到 Plan 模式会话头部切换 Agent 为 Plan。此模式下它只能读文件、搜索、抓网页，改动一律被拒绝。
2. 让它调研并出计划描述目标，它会输出一份分步计划（计划全文以富文本直接展示给你，不只是给模型看的）。
3. 确认后切 Build计划就绪会出现确认卡，点「切换到 Build 执行」，它才按计划动手；点「暂不执行」则留在 Plan 模式继续讨论。

六、多会话并发

• 侧栏新建多个会话可以同时运行，状态灯标出「运行中 / 排队中 / 待确认」。
• 并发上限默认 4，可在「设置 → 通用 → 最大并发会话数」调整；超出自动排队，空出槽位自动接力。
• 典型用法：一个会话在改代码，另一个同时在查资料写文档。

七、两个典型场景

读懂一个陌生项目

这是别人的项目。先读 README 和目录结构，
再用 grep 统计主要模块的入口文件，
最后给我画一张模块依赖说明（Markdown）。

批量整理资料

把一批 PDF 拖进工作目录，让它逐个解析并汇成一张对比表——它会自己调用 read 与 write，全程工具卡片可见。批量、重复、有固定步骤的活儿，更进一步可以直接写脚本，见高级应用 · 脚本编排。