Service

CordisService 是长期服务的生命周期基类：应用 ready 时启动，所属 scope 回收时停止。 C# 把“生命周期”和“以哪个键发布”分开；服务通常按接口 Type 显式注册。

对照基准是 dsh dsh-v0.1.1-rc.1 的 Service 参考页 与 service.ts。 C# 实现见 Service.cs。

TS → C# 逐项对照

CordisService

public abstract class CordisService
{
    protected CordisService(Context context);

    public Context Context { get; }
    public virtual ValueTask StartAsync();
    public virtual ValueTask StopAsync();
}

构造函数建立两条 scope-bound 生命周期注册：

• 根尚未 ready：通过 context.Once("ready", StartAsync) 登记一次性启动；根 StartAsync() 会等待它；
• 根已经 ready：立即发起 StartAsync()；由于构造函数不能 await，失败以 contained 方式报告到 internal/error，source 为 service/start；
• 无论哪种路径，都通过 context.OnDispose(StopAsync) 登记停止动作。

StopAsync() 属于 scope cleanup，失败不会阻止其它 disposer 运行；最终由 EffectScope.DisposeAsync() 以 AggregateException 报告。直接 dispose CordisService 实例没有意义，它没有独立 DisposeAsync()； 所有权在构造它的 Context scope。

CordisService 本身也不实现 IPlugin。常见做法是在 provider plugin 的 apply 中创建服务，使它与该 activation 同寿命。

CordisService<TSelf>

public abstract class CordisService<TSelf> : CordisService
    where TSelf : CordisService<TSelf>
{
    protected CordisService(Context context);
}

这个变体在构造时额外执行：

context.Provide<TSelf>((TSelf)(object)this);

因此它只按具体类型自动注册，适合契约本来就是具体服务类的情况：

public sealed class MetricsService(Context ctx)
    : CordisService<MetricsService>(ctx)
{
    public override ValueTask StartAsync() => ConnectAsync();
    public override ValueTask StopAsync() => DisconnectAsync();
}

插件可随后 ctx.Require<MetricsService>()。泛型自注册同样采用 apply 期间预留发布、exact-scope owner 和依赖收敛规则。

推荐：按接口发布

能力 seam 通常定义在独立 Service Definition 程序集，因此更常见的写法是继承非泛型基类并显式提供接口：

public interface IClock
{
    DateTimeOffset UtcNow { get; }
}

public sealed class SystemClockService : CordisService, IClock
{
    public SystemClockService(Context ctx) : base(ctx)
        => ctx.Provide<IClock>(this);

    public DateTimeOffset UtcNow => DateTimeOffset.UtcNow;
}

public sealed class ClockProviderPlugin : Plugin
{
    protected override void Apply(Context ctx)
        => _ = new SystemClockService(ctx);
}

消费方只引用 IClock，组合 preset 可以替换 provider 而不改引用；服务实例、它的 StopAsync() 和接口注册都由 同一个 plugin activation scope 回收。

这与 TS ctx.<name> 的属性式访问不同：

IClock clock = ctx.Require<IClock>();
Console.WriteLine(clock.UtcNow);

发布与启动不是同一件事

CordisService 管启动 / 停止，Context.Provide 管 Registry 可见性：

• 在 plugin apply 内构造服务时，接口注册先预留，直到整个 apply 成功才公开；
• 根尚未 ready 时，服务可以已经发布，但 StartAsync() 要等根启动；
• 根已 ready 时，构造函数立即发起 start，服务发布仍遵循当前 activation 的事务边界；
• ServiceRegistration.Completion 观察依赖插件与 service 事件收敛，不代表 StartAsync() 的独立健康状态。

服务若必须“启动成功后才可见”，应由 provider plugin 先 await 初始化，再调用 Provide，而不是在 CordisService.StartAsync() 内假定 Registry 会延迟发布。

TS symbol hooks 的 .NET 对应方式

TS Service 依赖一组 unique symbol，在 Context proxy 上实现 callable service、intercept config 和 tracing。 C# 不需要复制这些元编程入口：

失败传播