@deepseek-ai/dsh-typert-protocol

English | 中文

该包提供不依赖编译器的声明，由业务包、生成的 Typert 产物、宿主网关和客户端 API 共享。它负责 Remote 服务基类、装饰器、显式绑定回退、可通过声明合并扩展的协议映射、调用描述符、编解码器和提供方约定；它不执行 TypeScript 分析，也不注册具体 Cordis 服务。

Remote 声明

@Remote 将公开实例方法标记为可在其注册的 Cordis 服务上直接调用。
@RemoteScope(key) 标记接收者选自合并声明的作用域 Context 类型的方法。
TypertRemoteService 将传给 super(ctx, serviceKey, options?) 的 Cordis 键绑定到同一默认协议命名空间。
bindTypertRemote(this, serviceKey, options?) 为无法继承 TypertRemoteService 的服务提供同样可见且冻结的绑定。
remoteMethods(service) 返回按声明顺序排列、与内部状态分离的快照，供 Gateway 的 SRC 回退路径使用。

宿主方法通过将 signal: AbortSignal 声明为最后一个参数来启用协作式取消。InvocationDescriptor.cancellation 记录这个保留的注入点；该信号绝不会成为 JSON 参数或查找字段。SRC 识别末位参数名，严格生成还会校验它是否具有全局 AbortSignal 类型。

装饰器初始化器将标记保存在以服务原型为键的模块私有 WeakMap 中。它们不会在构造函数上添加符号，也不会添加原型属性、参数元数据或运行时反射字段。TypertRemoteService 会暴露与显式辅助函数相同的公开只读 typertRemote 绑定。

Typert 协议

业务包扩展 TypertLookupMap 和 TypertContextMap，以关联宿主对象或作用域 Context 与其协议身份。生成的产物扩展 TypertRemoteMap、TypertRemoteScopeMap 和 TypertRemoteNamespaceMap，使客户端导入后仅暴露选定的 Remote 方法。InvocationDescriptor 是供注册表、网关和客户端 Remote 使用的共享运行时形式。

Host 装配以转发给消费端的 Cordis 事件扩展 TypertRemoteEventSelection，从而收窄 ctx.remote.$on 的键面。TypertForwardableEvent 接受无作用域且返回 void 的通知，以及最后一个 next() 回调返回事件结果类型的异步作用域 waterfall。TypertClientEventListener 从同一条 Events 成员派生 Client listener：在 TypertLookupMap 与 TypertContextMap 中使用同名 key 声明的 Host subject 类型会变为 Client Context，同时保留 AbortSignal、可选与只读对象字段、数组、回调和结果类型。TypertClientRemote 只公开 $mount() 与 $on()；事件传输由 Gateway 私有持有。

查找包与 Context 包同时负责该约定的两侧：声明合并提供静态关联，运行时提供方向 ctx.typert 注册身份解析。Host 与 Client Context adapter 都提供 Context -> wire identity 和 wire identity -> Context；Host adapter 还提供稳定的 wire 声明，Host 组合可以覆盖其同步或异步 resolver。策略拒绝可用 TypertLookupFailure 携带由边界适配器拥有的失败值。严格编解码器携带生成的 schema；src-json 编解码器标识约束更弱的源码启动路径。

模型体验

无，因为该协议包声明应用反射，不注册任何面向模型的内容。

KV Cache 影响

无直接影响。

已知限制与暂缓事项

装饰器标记仅包含方法名，以及直接调用或 Context 调用模式。参数、结果、查找和 schema 反射需要 Typert 构建流水线。
Remote 装饰器只接受具有字符串名称的公开、非静态实例方法。SRC 执行无法表示重载签名，以及包含解构参数、默认参数或剩余参数的方法签名。

README.zh.md 3.7 KB 文件歷史 原始文件