系统如何工作
用一页文档理解 Web、SDK、Server 和 Engine 如何把一次 prompt 变成可见反馈。
这页不是内部工程细节大全，而是对外用户理解 KCode 工作方式的最短版本。你只需要先记住一条主链路，就能理解为什么 KCode 不只是一个网页。
一条最值得先记住的链路
用户在 Web 输入 prompt
-> web 组装请求
-> sdk 发起请求
-> server 加载目录级状态
-> engine 驱动模型与工具调用
-> server 把 runtime 事件翻译成业务事件
-> web 收敛状态并更新界面每层分别负责什么
Web
- 提供路由、输入区、Session 时间线和状态同步界面。
- 不直接负责模型调用本身。
SDK
- 负责把 Web 到 Server 的调用整理成稳定契约。
- 是前后端之间的连接层，而不是最终业务层。
Server
- 暴露 HTTP 和 SSE。
- 管理目录级项目状态。
- 创建或复用 Runtime。
- 把底层事件翻译成前端能消费的业务事件。
Engine
- 驱动 Agent 推理循环。
- 管理模型调用和工具系统。
- 负责审批模式、运行时事件和执行内核。
为什么这条链路对使用者重要
因为它解释了两个关键事实：
- KCode 不只是一个前端页面，它背后有独立的本地服务和运行时内核。
- 你在 Web 里看到的 Session、Todo、Diff 和问题请求，都是由这条链路里的状态与事件慢慢收敛出来的。
相关阅读
- 想理解 Session 为什么是交互主体：看 目录、项目与会话。
- 想知道 Provider 与模型在哪一层起作用：看 Provider 与模型。
- 想确认启动入口和命令形态：看 CLI 参考。