协议 schema、共享类型与生成契约
协议 schema、共享类型与生成契约 stage-18（横切基础设施）
这一阶段是全系统的幕后“合同库”，不负责开机、主循环或关机，而是先规定大家怎么说话、数据长什么样。核心协议像通用词典，统一会话、权限、工具结果等说法；app-server schema 规定前端和服务器的消息信封；后端 OpenAPI、protobuf 把远程接口也对齐；扩展、hook、MCP、跟踪 schema 给插件、工具和流水账定格式；宏则在编译时自动补检查。这样各零件传话、存档、调用工具时不容易说岔。
子阶段
18.1核心共享协议与领域类型46 个文件18.2app-server 协议 schema 与传输契约43 个文件18.3生成的后端与 protobuf 契约24 个文件18.4API、扩展、hook、MCP 与跟踪 schema60 个文件18.5API 注解宏和编译期契约支持1 个文件
本阶段涉及的状态6
reg-conversation-history每条线程里的用户消息、模型回复、工具调用、文件改动和审批记录等对话历史。reg-model-catalog系统当前知道有哪些模型、各模型有什么能力、来自哪个提供方以及能不能选用的模型清单。reg-permissions-approvals用户已经允许、拒绝或需要确认的命令、文件、联网、MCP 调用等权限和审批状态。reg-tool-registry模型这一轮能看到和调用的工具集合，包括内置工具、动态工具、插件工具、MCP 工具和搜索工具。reg-hook-lifecycle-state钩子在配置、回合、工具调用和审批过程里会触发什么、传什么上下文、返回什么结果的共享状态。reg-prompt-fragment-registry内置提示词模板、上下文片段来源、扩展提示词贡献及其组装顺序的登记状态。