--- title: 版本更新记录 description: 记录开放平台文档和接口版本的重要变更，便于追踪历史演进。 sidebar_position: 1 --- # 版本更新记录 本页用于记录开放平台文档、版本策略和接入规则的重要更新。 这里记录的是影响接入理解、版本判断和文档结构的关键节点，不逐条展开所有接口字段级微调。 ## 当前状态 截至目前，开放平台的版本口径如下： - 当前对外稳定开放版本：`2.0` - 当前公开文档默认对应版本：`2.0` - 后续新增实现与能力演进：进入 `3.0` 如需理解版本边界与兼容原则，建议同时阅读 [版本与变更策略](/doc/platform-rules/version-and-change-policy)。 ## 更新记录 ### 2026 年 4 月 10 日 #### 文档结构补充与目录重组 - 文档中心新增 `开始接入`、`平台规则`、`解决方案`、`能力说明`、`常见问题`、`更新日志` 等分组 - 顶层导航增加 `接口能力` 聚合层，用于收拢原有能力目录，减少首页一级目录数量 - 文档侧边栏改为直接读取当前 `content/docs` 内容源，开发环境支持热读取文档结构与内容 #### 平台介绍与接入文档拆分 - 原 `接口概述` 调整为 [平台介绍](/doc/intro) - 接入基础说明拆分为 [快速开始与接入流程](/doc/getting-started/quick-start-and-integration-flow)、[认证与调用约定](/doc/getting-started/authentication-and-calling-conventions)、[请求示例与调试](/doc/getting-started/request-examples-and-debugging) - 文档中心开始区分 `平台介绍`、`接入准备`、`平台规则` 与具体接口能力，降低首次阅读成本 #### 新增规则与方案类页面 - 新增 [平台规则总览](/doc/platform-rules/platform-rules-overview)、[版本与变更策略](/doc/platform-rules/version-and-change-policy)、[合规与使用边界](/doc/platform-rules/compliance-and-usage-boundaries) - 新增 [药品对码标准化方案](/doc/solutions/drug-mapping-standardization-solution)、[智能导诊与问病方案](/doc/solutions/smart-triage-and-consultation-solution)、[医院机构搜索与建档方案](/doc/solutions/hospital-search-and-profiling-solution) - 新增 [接入 FAQ 与错误排查](/doc/faq/integration-faq-and-troubleshooting)，用于整理常见联调问题和错误码排查路径 #### 文案与展示规范补充 - 文档文案开始统一收敛表达方式，减少口语化称谓。 - 方案类文档中的中文引号统一改为直角引号，减少展示风格不一致问题 - 平台介绍页补充了能力概览、适用场景、阅读路径和版本入口说明 ### 2025 年 10 月 24 日 #### `2.0` 冻结 自 2025 年 10 月 24 日起，`2.0` 进入冻结维护状态，后续不再承接新的核心能力演进。 冻结后的维护范围主要包括： - 文档勘误和表述修正 - 参数说明补充 - 示例优化 - 不改变既有语义的缺陷修复 原则上，以下内容不再直接进入 `2.0`： - 新能力 - 新主流程 - 会改变字段语义或返回模型的调整 - 会影响旧客户端理解的行为变化 ### 2025 年 10 月 24 日之后 #### `3.0` 作为后续演进版本线 在 `2.0` 冻结之后，后续新增实现与能力演进统一进入 `3.0` 规划。 这意味着： - 现有 `/doc/*` 路径继续代表 `2.0` - `2.0` 继续服务已接入和正在接入的合作方 - 新的能力设计、字段结构调整和结果模型升级，默认归入 `3.0` ## 记录口径 后续新增记录时，建议按下面的口径维护： 1. 只记录影响接入判断、版本理解、文档结构或合作方使用方式的关键更新 2. 单纯错别字修正或细小文案润色，一般不单独记入版本记录 3. 若某次变更涉及版本边界调整，应明确写出日期、适用范围和影响对象 如需查看当前适用的接入规则，可继续阅读 [平台规则总览](/doc/platform-rules/platform-rules-overview)。