第一次会话
创建第一个 Session,并理解时间线、Todo、Diff 和确认请求是如何组织的。
KCode 的核心业务对象是 Session。你在界面里看到的消息时间线、Todo、Diff、权限请求和问题请求,都会围绕某个 Session 收敛,而不是散在多个入口里。
第一次会话建议从什么开始
第一次交互建议从明确、可验证、低风险的任务开始,例如:
帮我梳理这个仓库的启动链路,并指出 apps/web、apps/server 和 packages/engine 的职责边界。
这类任务有两个好处:
- 你能快速看懂它如何组织上下文和工具调用。
- 即使结果不完美,也不会直接把仓库推进高风险改动。
第一次会看到哪些反馈
- 消息时间线:记录 Prompt、流式输出和工具调用。
- Todo:展示任务拆解和执行进度。
- Diff:展示建议改动或当前变更。
- Permission / Question:当运行时需要额外确认时,会回到会话里提出。
什么样的第一类任务最稳
- 阅读型任务:例如梳理架构、解释某个目录职责。
- 低风险改动:例如改文档、补说明、调整文案。
- 明确目标的小修复:例如排查一个局部问题或补测试。
为什么 Session 比页面更重要
因为目录决定作用域,而 Session 决定交互主体:
- 目录决定这次协作围绕哪个本地项目。
- Session 决定当前时间线、上下文和后续动作。
如果你想进一步理解这个边界,继续看 目录、项目与会话。
下一步建议
- 想理解目录级状态和 Session 的关系:看 目录、项目与会话。
- 启动成功但还不能调用模型:看 Provider 与模型。
- 想快速确认默认行为:看 常见问题。