deepseek-harness/website/zh-CN/api/cordis/service.md

Service

Service 基类，用于创建对外暴露能力的插件。

基本用法

import { Service, type Context } from 'cordis'

declare module 'cordis' {
  interface Context {
    myService: MyService
  }
}

export default class MyService extends Service {
  constructor(ctx: Context) {
    super(ctx, 'myService')
  }

  // 公开方法
  doSomething() {
    // ...
  }
}

加载后，其他插件可通过 ctx.myService 访问。

构造函数

new Service(ctx, name)

• ctx: Context 上下文
• name: string 服务名（注册到 ctx[name]）

实例属性

service.ctx

• 类型: Context

该服务绑定的上下文。

service[Service.tracker]

• 类型: object

服务追踪信息（名称、绑定状态等）。

生命周期

Service 子类可以覆写以下方法：

start()

服务激活时调用。在这里初始化资源。

stop()

服务停用时调用。在这里释放资源。

静态属性

Service.inject

• 类型: string[] | { required?: string[], optional?: string[] }

声明本服务依赖的其他服务。

与 inject 的关系

当一个 Service 被加载：

1. 框架为该服务名创建声明 (ctx.provide)
2. 实例赋值到 ctx[name]
3. 依赖该服务的所有 Fiber 从 PENDING 转为 LOADING

当 Service 被卸载：

1. ctx[name] 被置为 undefined
2. 依赖它的 Fiber 被 dispose
3. 当新的 provider 出现时，dependant Fiber 重新加载

示例：Harness 中的 Service

// dsh-tools 的 ToolRegistry 就是一个 Service
export class ToolRegistry extends Service {
  constructor(ctx: Context) {
    super(ctx, 'tools')
  }

  register(tool: ToolDefinition): () => void {
    // ...注册逻辑
    return dispose
  }
}