跳到正文

兼容性 ​

当前团队适配协议主版本为 API 1,Schema 版本为 1.0,输出上下文版本为 1。核心包校验、规则计算、方案修订和资源存储由 Tidoc 核心负责。DOCX 和材料 PDF 由独立打印组件渲染。

缺少打印组件时,条目整理及核心 Excel、附件包功能仍可用。Word 和材料 PDF 会报告所需组件或能力。打包含 DOCX 的适配包要求安装打印依赖并完成模板校验及 fixture 渲染。

打印进程支持旧 BITFSAE IPC v1 转换和 IPC v2 请求。v1 固定字段只留在兼容转换器,业务输出按包声明运行。v1 请求先转换为稳定输出上下文,再进入同一 v2 校验和渲染器。--capabilities 报告实际资源及能力,缺少旧模板或组织设置时不宣称支持 v1。

核心和组件共用唯一的 context.schema.json 及共享字段目录。核心四类输出的预检均校验完整上下文;打印 IPC 在实际渲染前再次校验,v1 转换结果、源码和外部进程都执行同一检查。Schema 校验与资源路径、主体隔离和模板字段权限检查分别执行。校验诊断只给 JSON Pointer 和约束,不回显无效值。

Schema 通过 $defs 复用结构;export.options 和 completeness 拒绝未声明属性。运行时传入的数据不能扩大公共字段权限,内部投影也必须通过同一检查。

打印组件实际依赖 requirements-print.txt 中的 jsonschema。缺少该依赖或 context Schema、Schema 损坏时,能力查询报告缺项,并停用 DOCX、PDF 以及相关 IPC 和上下文能力,自检返回失败。核心自检也检查 context Schema。组件必须打包共享 Schema、字段目录、旧模板和组织设置;具体路径见更新说明。它不依赖核心数据库、API 或 adapters.registry。

打印自检通过正式 IPC 实际生成并检查 DOCX 和两页材料 PDF,从而核验依赖加载及真实渲染。模块可被定位、但运行库无法加载时也会报告 COMPONENT_SELF_TEST_FAILED;能力查询须配合自检结果判断。

打印组件的版本号用于更新通知,协议及渲染支持仍按实际能力查询判断。

CI 运行适配样例和打印协议测试。源码测试不能代替成品检查:安装包安装、旧组件组合、升级后数据保留和办公软件里的版式需要在 Windows 和 macOS 成品上另行确认,步骤见发布与更新机制。

未来协议主版本变化时,需提供迁移说明和转换路径。兼容能力按协议和组件公开能力判断,不能只比较软件版本号。