架构与数据契约

本模块收纳 BridgeSession、ChannelChat、运行时边界、数据 schema、安全模型和后端状态相关文档。

阅读路径

1. 当前架构：BridgeSession、ChannelChat、运行时、Mirror 等核心设计。
2. 生命周期与解耦评估：本地进程拓扑、Bridge 生命周期、stream/mirror 边界和后续解耦建议。
3. 模块边界审计：文件粒度、功能聚合、多跳查阅热点和改进建议。
4. 后端状态：后端模块、状态文件和运行期数据概览。
5. 运行时命令作用域：slash 命令、运行时配置和 Bridge 配置边界。
6. 新增 Agent / Runtime 接入边界：新增 Codex/Claude/Kimi 同级 agent 时必须接入的配置、/t、mirror、history、turn 和 E2E 边界。
7. 配置系统说明：当前配置来源、TOML shape、多级覆盖、统一查询 API 和迁移兼容边界。
8. JSON Schema 与升级契约：本地数据文件 schema 和迁移边界。
9. 桥接安全模型：授权、输入校验、限流、权限回调和审计日志。
10. 流式卡片：本地镜像、投递计划、碎片投递抑制、长连接刷新、底层飞书 API 和性能观测。
11. Codex TUI 工具状态渲染分析：Codex 当前工具调用状态、底部状态行、快捷键和 Default/Plan 模式渲染链路。
12. 工具调用卡片统一展示 Proposal：跨 Codex/Claude/Kimi 的公共中间层、分组折叠、默认输出策略和验收矩阵。
13. Codex 工具调用适配：Codex session JSONL 到公共工具事件的数据流、GPT-5.6 exec wrapper 静态归一化和安全边界。
14. tmux Runtime 生命周期：Claude/Kimi/Codex 共享输入状态机、session/tmux 启动、选择提示和发送时机。