创建、挂载并确认最小插件

1. 1

   确认 dsh 在运行。若未运行，在项目目录启动本地 Web UI：

   sh

   npx @deepseek-ai/dsh web

2. 2

   新建插件目录 hello-service，在其中创建 package.json，用 dsh 字段声明它指向自己的 bundle 补丁文件：

   json

   {
     "name": "hello-service",
     "version": "0.1.0",
     "dsh": {
       "bundle": "./cordis.bundle.yml"
     }
   }

3. 3

   编写插件入口：在 apply 中向上下文注册一个服务，并在日志中打印服务名。下面的代码是示意，具体 API 签名以 docs 的 Services 页为准：

   ts

   import { Context } from 'cordis'
   
   export const name = 'hello-service'
   
   export function apply(ctx: Context) {
     ctx.provide('hello', { greet: () => 'hi' })
     ctx.logger('hello').info('service registered: hello')
   }

4. 4

   把插件挂进配置树：在 profile 的 cordis.patch.yml 插入一行，或用 --patch 覆盖层。补丁按 id 定位一行并整体替换其配置，或插入新行；行 id 与字段名以生成的 config catalog 为准。

5. 5

   让配置树重新生效（按你的运行方式重载或重启）。层序固定：profile 的 cordis.patch.yml → home 级补丁 → --patch 覆盖层。

6. 6

   确认结果：日志出现服务注册信息，运行中的上下文/注册表里能查到 hello 服务名。随后移除补丁行，再确认该服务随插件卸载自动消失。