深入阅读

这一页不复制仓库里所有设计文档，而是告诉你什么时候该看哪一份原始文档。

如果你只是想把 NeoCode 跑起来并稳定使用，请先看 开始使用；只有当你要改实现、查边界或做架构决策时，再回到这里。

运行时与上下文

• Runtime / Provider 事件流
  • 适合在你想理解 Provider 流式响应怎样进入 Runtime、事件怎样发给 UI 时阅读。
• Context Compact 说明
  • 适合在你要调整压缩策略、自动压缩阈值或理解 micro compact 时阅读。
• Session 持久化设计
  • 适合在你要理解会话恢复、状态落盘和会话模型边界时阅读。

Gateway 与安全

• Gateway 集成参考
  • 适合在你要做外部集成前先判断是否需要阅读底层设计。
• Gateway 详细设计
  • 适合在你关注 JSON-RPC、ACL、Silent Auth、网络访问面与流式中继时阅读。
• Tools 与 TUI 集成
  • 适合在你要理解工具调用如何经过 Runtime / TUI 协同展示时阅读。

配置与扩展

• 配置指南
  • 这里是主配置和 custom provider 的事实来源。
• 扩展 Provider
  • 适合在你要新增内置 Provider 或接入 OpenAI-compatible 网关时阅读。
• MCP 配置指南
  • 适合在你准备配置 MCP server 时阅读。
• Config 管理详细设计
  • 适合在你要改配置加载、校验和选择修正逻辑时阅读。

Skills 与其他主题

• Skills 设计与使用
  • 适合在你要理解 Skills 的发现、激活和执行边界时阅读。
• Provider Schema 策略
  • 适合在你关注 Provider schema、请求格式和兼容策略时阅读。
• 更新与升级
  • 适合在你要核对静默更新行为时阅读。

建议

如果你只是想使用 NeoCode，请优先返回 开始使用；只有当你需要修改实现、排查边界或补测试时，再打开这些设计文档。