2026-09-23·by Sijie Wang#standmeet#architecture#design

connector-diagram-coverage

连接器 — 图示覆盖(注册侧 vs 调用侧)

父级:connector

连接器模块是共享一个包的两套设计注册侧(连接器如何被安装、授予凭据、激活)和调用侧(消费者如何在完全看不到提供方或凭据的情况下调用一个类别动词)。用一张图恰好会模糊掉这个模块存在的意义所系的那条边界——所以,画两张。

1 · 注册侧 — 安装、凭据、激活

注册侧是凭据以明文形式存在的唯一地方,而且只是暂时的。Hub.Resolve 下游的一切看到的都只是一个 Connector——名称、类别、是否已连接;别无其他。

2 · 调用侧 — 类别动词,没有提供方,没有凭据

调用方的世界里没有提供方名称,也没有凭据——代理接口(proxy interfaces)就是全部词汇。AuthInjector 是在包内部按调用时构造的;消费者甚至无法叫出它的名字。

覆盖清单(防遗漏关卡)

类型 / 区域图示位置已验证
Hub、Connector、Verifier本页 §1✓ 代码
connector.Service 的职责(2026-07-26 之前叫 connectorsvc,1bc9ba8b0)本页 §1✓ 名称,☐ 完整签名
cryptobox / owner_connectors本页 §1✓ 机制,☐ 字段列表
CalendarProxy / MailProxy + DTO本页 §2,connector-plugins✓ 代码
openapi Runtime / AuthInjector / StatusError本页 §2✓ 代码
DepProvider / DepRegistry / RequiresDepsconnector-deps✓ 代码
摄取(spec 解析、binding 校验)☐ 尚未图示
egress guard 类型connector-egress-guard(散文形式)☐ 无类图
about this entry

One of sijie's wiki entries. The AI on this site is grounded in the same corpus and answers in sijie's voice, with citations back to entries like this one — answering costs sijie money, so it waits behind a code: enter an access code →

connector-diagram-coverage