- insert:       - id: hello           name: dsh-hello

// index.mjs — dsh-hello 宿主端入口const name = 'hello'/** * @param {object} ctx - cordis 上下文，插件的"总插座" */export async function apply(ctx) {  // —— 1. 注册斜杠命令 /hello ——  // inject(['commands'], ...) 表示：等 'commands' 服务就绪后再执行回调  ctx.inject(['commands'], (cmdCtx) => {    cmdCtx.commands.register({      name: 'hello',      description: '打个招呼',      input: { hint: '[名字]' },      async handler(invocation) {        const who = String(invocation.rawInput || '').trim() || '世界'        return { kind: 'success', text: `你好，${who}！这是来自 dsh-hello 的问候。` }      },    })  })  // —— 2. 注册 HTTP 接口 GET /api/hello ——  ctx.inject(['webServer'], (wsCtx) => {    wsCtx.webServer.register({      kind: 'exact',      path: '/api/hello',      handler: async (req, res) => {        res.writeHead(200, { 'content-type': 'application/json' })        res.end(JSON.stringify({ ok: true, message: 'hello from dsh-hello' }))      },    })  })}export { name }

// 可选服务：agents 服务不在就安静跳过function injectPromptToAllAgents(ctx, config) {  const agents = ctx.get('agents')  if (!agents || typeof agents.list !== 'function') return  for (const agent of agents.list()) {    try {      agent.inject(/* … */)    } catch (err) {      /* … */    }  }}// 副作用清理：插件卸载/重载时自动执行清理函数ctx.effect(() => {  const disposeSection = spCtx.systemPrompt.section({ /* … */ })  return () => disposeSection?.() // 返回清理函数}, 'dsh-soul: system prompt section')

ctx.inject(['webServer'], (wsCtx) => {  wsCtx.webServer.register({    kind: 'exact', // 精确匹配路径    path: '/api/hello',    handler: async (req, res) => {      // 原生 Node.js req/res      // 读 POST body 的写法：      // let raw = ''      // for await (const chunk of req) raw += chunk      // const body = JSON.parse(raw)      res.writeHead(200, { 'content-type': 'application/json' })      res.end(JSON.stringify({ ok: true }))    },  })})

ctx.inject(['commands'], (cmdCtx) => {  cmdCtx.commands.register({    name: 'hello', // /hello    description: '打个招呼',    input: { hint: '[show|reset|名字]' }, // 输入框里的灰色提示    async handler(invocation) {      const raw = String(invocation.rawInput || '').trim()      if (raw === 'show') {        return { kind: 'success', text: '当前配置：…' }      }      return { kind: 'error', text: `未知参数：${raw}` }    },  })})

ctx.inject(['systemPrompt'], (spCtx) => {  const disposeSection = spCtx.systemPrompt.section({    name: 'hello:rules', // 分区名，用 '插件:用途' 命名避免冲突    order: 0, // 数字越小越靠前    text: () => '【插件注入】回答时保持专业严谨。', // 每次请求时调用  })})

// 注意：@deepseek-ai/dsh-tools 是可选依赖且 ABI 敏感，// 真实插件用"动态 import + 守卫"防止宿主版本不匹配时整个插件挂掉ctx.inject(['tools'], (toolsCtx) => {  import('@deepseek-ai/dsh-tools').then(({ defineTool, TOOL_RUNTIME_SCHEDULER }) => {    if(typeof TOOL_RUNTIME_SCHEDULER !== 'symbol') {      throw new Error('requires @deepseek-ai/dsh-tools ^0.1.0-rc.6')    }    toolsCtx.tools.register(defineTool({      name: 'set_persona',      description: '调整当前个性化人设。当用户明确要求改变称呼、语气或风格时使用。',      parameters: {        nickname: { type: 'string', description: '用户昵称。' },        style: {          type: 'string',          enum: ['professional', 'casual'],          description: '回复风格：professional=专业严谨，casual=轻松自然。',        },      },      output: {        schema: {          type: 'object',          additionalProperties: false,          required: ['ok'],          properties: {            ok: { type: 'boolean' },            message: { type: 'string' },          },        },      },      async execute(args) {        // args 即模型按 parameters 传来的参数        return { ok: true, message: `昵称已设为 ${args.nickname}` }      },    }))  }).catch((err) => {    toolsCtx.logger?.warn?.('[dsh-hello] tool not registered: ' + err.message)  })})

import { createUserMessage } from '@deepseek-ai/dsh-llm'functioninjectToAllAgents(ctx, text) {  const agents = ctx.get('agents')  if(!agents) return  for(const agent of agents.list()) {    try {      agent.inject(createUserMessage({        content: [{ type: 'text', text }],        source: {          // 标记消息来源（惯例，便于追溯）          kind: 'plugin',          plugin: 'dsh-soul',          form: 'snapshot',          sections: [{ name: 'soul:persona', text }],        },      }))    } catch {      /* 单个失败不影响其他会话 */    }  }}

import { readFile, writeFile, mkdir } from 'node:fs/promises'import { join } from 'node:path'import { homedir } from 'node:os'function configPath() {  // $DSH_HOME/my-plugin-config.json；未设置 DSH_HOME 时用 ~/.dsh  return join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'hello-config.json')}async function saveConfig(config) {  await mkdir(join(configPath(), '..'), { recursive: true })  await writeFile(configPath(), JSON.stringify(config, null, 2), 'utf8')}

// client/index.mjs — dsh-hello Web UI 插件window.__ModuleLoader__.load({  id: 'dsh-hello',  factory: (require) => {    const module = { exports: {} }    // ① 拿 React（17+ 的 jsx-runtime 约定）    const { jsx: h, jsxs: hs, Fragment } = require('react/jsx-runtime')    const React = require('react')    // ② 拿官方 UI 组件库（按钮、输入框、开关等）    const ui = require('@deepseek-ai/dsh-client-ui-primitives')    // ③ jsx-runtime 的"坑"：h(type, props, child) 的第三个参数是 key，    //    直接这样传 child 会被当成 key 丢掉！用一个包装函数统一把 children 塞进 props：    const e = (type, props, ...children) => {      const p = props || {}      if (children.length === 0) return h(type, p)      if (children.length === 1) return h(type, { ...p, children: children[0] })      return hs(type, { ...p, children })    }    // —— 你的 React 组件 ——    function HelloPanel(props) {      const [text, setText] = React.useState('')      return e('div', { style: { padding: 12 } },        e('div', null, 'Hello 面板'),        e(ui.Input ?? 'input', {          value: text,          onChange: (ev) => setText(ev.target?.value ?? ev),        }),        e('p', null, `你输入了：${text}`),      )    }    // ④ cordis 装配：inject 声明硬依赖的服务，apply 里注册 UI    const inject = ['slots', 'locale']    function apply(ctx) {      // 多语言词典（可选）      ctx.effect(() => ctx.locale.register('hello', {        zh: { 'panel.title': '打招呼' },        en: { 'panel.title': 'Say Hello' },      }), 'dsh-hello: dictionaries')      // 把组件注册进"设置页栏目"槽位      ctx.slots.inject('settings.section', () => ctx.slots.register({        name: 'settings.section',        id: 'hello-settings', // 全局唯一        order: 60, // 栏目排序        label: () => '打招呼', // 左侧导航文字        locale: 'hello',      }, HelloPanel))    }    exports.apply = apply    exports.inject = inject    return module.exports  },})

// client/index.mjs — dsh-hello Web UI 插件window.__ModuleLoader__.load({  id: 'dsh-hello',  factory: (require) => {    const module = { exports: {} }    // ① 拿 React（17+ 的 jsx-runtime 约定）    const { jsx: h, jsxs: hs, Fragment } = require('react/jsx-runtime')    const React = require('react')    // ② 拿官方 UI 组件库（按钮、输入框、开关等）    const ui = require('@deepseek-ai/dsh-client-ui-primitives')    // ③ jsx-runtime 的"坑"：h(type, props, child) 的第三个参数是 key，    //    直接这样传 child 会被当成 key 丢掉！用一个包装函数统一把 children 塞进 props：    const e = (type, props, ...children) => {      const p = props || {}      if (children.length === 0) return h(type, p)      if (children.length === 1) return h(type, { ...p, children: children[0] })      return hs(type, { ...p, children })    }    // —— 你的 React 组件 ——    function HelloPanel(props) {      const [text, setText] = React.useState('')      return e('div', { style: { padding: 12 } },        e('div', null, 'Hello 面板'),        e(ui.Input ?? 'input', {          value: text,          onChange: (ev) => setText(ev.target?.value ?? ev),        }),        e('p', null, `你输入了：${text}`),      )    }    // ④ cordis 装配：inject 声明硬依赖的服务，apply 里注册 UI    const inject = ['slots', 'locale']    function apply(ctx) {      // 多语言词典（可选）      ctx.effect(() => ctx.locale.register('hello', {        zh: { 'panel.title': '打招呼' },        en: { 'panel.title': 'Say Hello' },      }), 'dsh-hello: dictionaries')      // 把组件注册进"设置页栏目"槽位      ctx.slots.inject('settings.section', () => ctx.slots.register({        name: 'settings.section',        id: 'hello-settings', // 全局唯一        order: 60, // 栏目排序        label: () => '打招呼', // 左侧导航文字        locale: 'hello',      }, HelloPanel))    }    exports.apply = apply    exports.inject = inject    return module.exports  },})

const createSnapshotStore = (init) => {  let state = init  const listeners = new Set()  const notify = () => {    for (const fn of [...listeners]) fn()  }  return {    getSnapshot: () => state,    subscribe: (fn) => {      listeners.add(fn)      return () => listeners.delete(fn)    },    update: (mutator) => {      const next = { ...state }      mutator(next)      state = next      notify()    },    set: (next) => {      state = next      notify()    },  }}// 组件里使用：function useStore(store) {  return React.useSyncExternalStore(store.subscribe, store.getSnapshot)}

window.__ModuleLoader__.load({  id: 'dsh-hello',  factory: () => {    const exports = {}    exports.inject = []    exports.apply = function () {}    return exports  },})