Adapter 指南
如何编写适配器
这篇解决什么工程问题?
Section titled “这篇解决什么工程问题?”写作提示:
- 解释 Adapter 在 Proto UI 里到底负责什么。
- 解释适配器如何在不重定义协议语义的前提下,把原型落到宿主。
主要读者是谁?
Section titled “主要读者是谁?”写作提示:
- 给想理解适配层责任的读者。
- 给未来可能编写适配器的人,但不必把它写成逐步实操教程。
写作提示:
- 指向
Whitepaper / 翻译层:Adapter / Compiler - 指向
Specifications / Core与相关能力规范 - 指向
Runtime 架构
核心结构 / 机制
Section titled “核心结构 / 机制”写作提示:
- 解释适配器的责任模型、翻译边界、与 runtime / host-cap 的协作方式。
- 解释哪些问题属于适配器必须处理的,哪些不应由适配器擅自重定义。
关键 API / SPI
Section titled “关键 API / SPI”写作提示:
- 只列实现适配层真正关键的接口与扩展点。
常见误解或边界
Section titled “常见误解或边界”写作提示:
- 区分“宿主最佳实践适配”与“协议语义重解释”。
- 区分“允许有损翻译”与“允许任意破坏一致性”。
下一步读什么?
Section titled “下一步读什么?”写作提示:
- 如果想看宿主能力边界:前往
Host Caps - 如果想看模块分层与扩展点:前往
模块与扩展架构