docs/technical/index.md
Last updated: 2026-07
本目录包含 Chatbox Pro 的系统设计与技术决策文档，面向工程师和技术负责人。
如需了解产品功能概述（面向非技术人员），请参阅 docs/product/。
| 文档 | 描述 |
|---|---|
| 跨平台架构 | 应用整体架构、平台抽象层、进程模型、模块划分 |
| AI 供应商系统 | 模型供应商注册表、OAuth 登录集成、模型类层级、能力声明、自建供应商 |
| 思考控制（Reasoning Control） | 思考控制支持条件判定（provider + 写死 model id）、effectiveProvider/apiStyle 映射、参数流转与请求侧兜底 |
| Gemini 工具调用 Thought Signatures | Gemini 3 function calling 的 signature 规则、并行工具调用历史序列化、25 次暂停继续问题复盘 |
| Gemini 流式错误拦截与重试安全 | mid-stream 错误帧检测、MidStreamApiError 重试安全分类、网关范围决策与依赖升级维护清单 |
| 会话管理系统 | 数据模型、模块拆分、新会话机制、线程历史、消息分叉 |
| 存储架构 | 混合存储策略、跨平台方案、版本迁移历史 |
| 数据备份归档 | ZIP v2 格式、资源范围、流式导入导出、事务恢复与安全限制 |
| Token 估算系统 | 异步队列架构、优先级调度、Real Context 一致性 |
| 上下文管理系统 | 上下文构建流程、AttachmentResolver 抽象、Compaction 机制 |
| 知识库（RAG 系统） | 向量数据库、文档索引、语义搜索、跨平台限制 |
| Session Attachment RAG 评测 | 大文件问答 RAG 的模型工具调用评测、真实 Chatbox 流程与 fixture 策略 |
| 工具与集成系统 | MCP 服务器、Web 搜索、内置工具集、Tool 构建 |
| Chatbox Virtual CLI | 内置 Skill 的应用操作命令、权限边界、异步生图与会话 follow-up |
| Agent Skills 技术设计 | Skills 发现/解析、IPC 通道、上下文注入与会话级配置 |
| Chat 代码执行 | Agent Mode、Code Execution 工具集、SandboxProvider 抽象、会话隔离 |
| Windows 原生代码执行 | Windows 代码执行根因分析、SRT/Codex 方案对比、当前最小原生支持（放弃隔离）与未来强隔离演进 |
| 状态管理 | 三层状态体系（Jotai/Zustand/React Query）、协作关系 |
| 构建与部署 | 构建工具链、依赖管理、签名打包、CI/CD |
| 自动更新系统 | electron-updater 机制、状态管理、Feed URL Fallback、本地测试方法 |
| Sentry 错误上报 | 错误覆盖范围、统一分类、采样降噪、去重与隐私规则 |
| 关键技术决策记录 | 14 项关键决策、替代方案分析、权衡理由 |
docs/technical/）：怎样设计的？技术架构与决策记录docs/product/）：做什么？产品功能说明，面向非技术人员docs/）：怎样实现的？开发指南和代码规范每个文档都包含 Last updated: YYYY-MM 标记。当系统设计发生变化时：
Last updated 时间戳