Namespace KernLab.Cell.Runtime
Classes
- CellBootArgs
引导参数(C301 CLI 契约——
dotnet KernLab.Cell.Runtime.dll --pack <dll> --startup <类型全名> --parent-pid <pid> --mode dynamic|aot)。
- CellCallbackBridge
回调桥客户端(§6.4 容器侧——容器 → 宿主的反向调用原语): 使用方经服务键调宿主服务;Callback 帧 requestId 多路复用,await 期间并发发起安全 (关联域寄存于容器通道的注册表——结果帧按 requestId 分派回此桥)。
- CellContainerRuntime
容器宿主循环(C303——进程画像:引导→自报端点→握手三步→Ready→循环→drain→退出)。 容器侧帧收发泵与 socket 载体自足(D2 两侧互不引用——线材与编解码取自 Contracts)。
- CellOrphanWatch
零孤儿看门狗(§6.1——
--parent-pid1s 轮询,父死回调)。 单一实现:CLI 引导器与消费侧自有 exe 壳(嵌入 RunAsync(CellBootArgs, TextWriter?, TextWriter?, CellRuntimeOptions?, CancellationToken),§13 映射) 同路径——宿主形态不二份实现,孤儿策略不随宿主形态漂移。
- CellRuntimeOptions
容器运行时选项(嵌入 RunAsync(CellBootArgs, TextWriter?, TextWriter?, CellRuntimeOptions?, CancellationToken) 的消费侧面——CLI 路径零感知)。
- CellTelemetryEgress
遥测出口(§6.4/§3.3——best-effort:有界队列丢最旧,永不阻塞调用路径); 心跳档:无记录时段按心跳间隔发空批次兼做活性信号(§5.2)。
- ContainerNamedPipeTransport
容器侧命名管道载体(D2 边界内必然自足——宿主侧实现不可引用;仅 Windows)。 判例正确形态铁律与宿主侧同源:InOut+Byte+Asynchronous+显式 64KB 缓冲(NpProbe 复验形态)。
- ContainerShmTransport
shm 载体(容器侧接入形态——D2 自足,不引用宿主侧内核):Windows 按名 Open; Unix 匿名段经 bootstrap UDS 接收描述符(1 段 + 4 门铃,槽位序 = 段, Bell0..Bell3—— Tier ShmRing §7 契约)后 Open。接入端用 B 端(写 B→A 回执域,读 A→B 调用域)。
- ContainerSocketTransport
容器侧 socket 载体(D2 边界内的必然自足——宿主侧实现不可引用;仅 tcp/uds)。 形态与宿主侧同构:socket→内存管道桥,小内核缓冲让有界管道主导背压; 终端 Close=出站排空后收 socket——对端先见帧、后见 EOF。
- FramePump
容器侧帧泵(单点串行写——结构上多写者不可能交错,§3.6;读=硬解析分帧,§3.1)。 线材取自 Contracts(CellFraming/CellFrameCodec)——容器侧自足,不引用宿主侧内核(D2)。
- LoadedPack
一个 pack 的装载上下文(collectible——可卸载)。
- PackLoadContext
pack 专用 collectible ALC(②③——契约单源第一规则+AssemblyDependencyResolver)。
- PackLoadDiagnostic
ALC 解析诊断事件(§6.2 诊断面——取证不静默)。
- PackLoadManager
ALC 管理五件(总体设计 §6.2——容器内的核心机器,缺一件即偏离):
①隔离拓扑:容器自身+契约=默认 ALC;每 pack 一个 collectible ALC。
②契约单源解析(第一规则):契约程序集一律落默认 ALC——杜绝契约类型跨边界分裂。
③解析策略:AssemblyDependencyResolver(.deps.json 私有依赖目录);全程无 GetTypes 遍历。
④Resolving 事件兜底=计数+取证事件,禁静默 fallback——解析失败=装载错误(ExitCode 11)。
⑤卸载确认:Unload+WeakReference 探活+超时窗;挂起不阻塞容器(取证事件+容器照常服务)。
- RuntimeTestHooks
测试钩子(ALC 卸载挂起取证注入点——默认 ALC 静态槽;生产零使用)。
Enums
- CellLoadMode
装载模式声明(§6.2 模式声明——与运行时事实不符=启动失败,不自欺)。