会话、上下文与工作区
NeoCode 的日常使用围绕三个概念:工作区、会话和上下文。
工作区决定 Agent 能看哪个项目;会话保存一个连续任务的对话;上下文是 Agent 当前回答时能参考的信息。
工作区
工作区通常是你的项目目录。NeoCode 的文件读取、搜索、编辑和命令执行都围绕当前工作区进行。
启动时指定工作区:
bash
neocode --workdir /path/to/project建议一个会话只服务一个工作区。切换到另一个项目时,新建会话会更清楚。
会话
会话保存一次连续任务的对话历史、工具结果和任务进展。适合把一个功能、一个 bug、一次审查或一次文档更新放在同一个会话里完成。
打开会话选择器:
text
/session也可以使用 Ctrl+N 新建会话。
上下文
上下文是 Agent 当前回答时能参考的材料,包括你的最新输入、会话历史、项目规则、记忆、Skills、任务状态和必要的项目摘要。
当会话很长时,旧信息可能干扰当前任务。可以执行:
text
/compact压缩后继续任务时,建议补一句当前目标:
text
继续刚才的修复,目标是让 go test ./internal/runtime 通过。什么时候继续当前会话
| 场景 | 建议 |
|---|---|
| 继续同一个 bug 或功能 | 继续当前会话 |
| 刚才让 Agent 先规划,现在要实现 | 继续当前会话 |
| 同一任务里补测试或补文档 | 继续当前会话 |
| 需要追问刚才的解释 | 继续当前会话 |
什么时候新建会话
| 场景 | 建议 |
|---|---|
| 切换到不相关任务 | 新建会话 |
| 切换到另一个项目 | 新建会话并切换工作区 |
| 旧上下文明显干扰回答 | 先 /compact,不行再新建 |
| 想从干净状态重新描述需求 | 新建会话 |
写清楚任务目标
好的输入通常包含目标、范围和验证方式:
text
请修复 internal/config 里的配置加载问题,只改必要文件,并运行 go test ./internal/config。不够清楚的输入:
text
帮我看看这个。如果任务复杂,先让 NeoCode 规划:
text
请先阅读相关代码,给出最小修改方案。暂时不要改文件。下一步
- 想学习本地控制命令:Slash 指令
- 想写项目级规则:AGENTS.md 项目规则
- 想看日常流程:日常使用
