Skip to content

会话、上下文与工作区

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
请先阅读相关代码,给出最小修改方案。暂时不要改文件。

下一步

围绕安装、配置、日常使用、扩展能力和排障整理的 NeoCode 用户指南。