@weibaohui/dsh-plugin-kit

@weibaohui/dsh-plugin-kit

dsh 插件共享工具箱。把系列插件中重复的「AI 动作按钮」能力收拢为一处：

• 宿主：createShareRunJob —— 把提示词交给真实 agent 会话执行（进程内 agents 服务优先流式，缺失降级 headless spawn；30 分钟超时 + 输出截断），任务状态由调用方轮询
• client：PluginKit.ActionShareDialog —— ntd ActionButton 同款交互（模板参数输入 + 可编辑提示词 + 参数预览 + 复制 + 执行 + 实时输出 + 完成态插槽），全内联样式，消费者无需自带 CSS

消费方式

// 插件 package.json（npm 源；dsh plugin add 时作为传递依赖一次性装上）
"dependencies": { "@weibaohui/dsh-plugin-kit": "^0.1.0" }

dsh plugin add 安装插件时作为传递依赖一次性装上。

宿主

const { createShareRunJob } = require('@weibaohui/dsh-plugin-kit')
const job = createShareRunJob({ binary: 'dsh', prompt, dir, jobs: shareRunJobs, logger: ctx.logger, services: shareServices })

client（构建期内联）

client/index.js 顶部声明，构建脚本把 client/source.js 内联进 bundle：

const ShareDialog = PluginKit.makeActionShareDialog(__React)
// 分享态（最小用法）
// h(ShareDialog, { title, hint, rows, initialPrompt, run, poll, labels, onClose })
// 创建/生成态（模板参数 + 完成态插槽，ntd ExpertCreateModal 同款）
// h(ShareDialog, {
//   title, hint,
//   params: [{ key: 'description', label: '描述', multiline: true }],   // {{description}} 实时替换进 prompt
//   initialPrompt: TEMPLATE,
//   run, poll,
//   completedView: ({ job, output, close, retry }) => node,             // job done 后由插槽接管渲染
//   labels, onClose,
// })

params 值实时替换进 prompt，用户手改过 prompt 后参数变化不再覆盖（脏跟踪）； completedView 接管后 Dialog footer 置空，确认/重试/关闭按钮由插槽自承。

共享事件推送枢纽（0.4.0+）

解决：dsh web 网关是 HTTP/1.1，浏览器对同一源只允许 ~6 条并发连接；每个 需要实时事件的插件各自开一条永久 SSE，插件一多首页所有请求排队超时。 本工具箱提供全页面唯一一条事件 SSE 的协调与分发：

宿主侧（插件 src/index.js，进程内协调，第一个调用者注册唯一路由）：

const { ensureHostHub } = require('@weibaohui/dsh-plugin-kit')

const broadcast = (payload) => {
  const hub = ensureHostHub(ctx, { webServer: ctx.webServer, connection: ctx.connection })
  if (hub) hub.publish('dsh-fireworks', payload)   // 软查找：枢纽可多插件复用
  // ……保留各插件自有 SSE 作为回退通道
}

客户端侧（构建脚本把 @weibaohui/dsh-plugin-kit/client/source.js 内联进 bundle，PluginKit.connectEvents 即为裸名可用）：

const off = PluginKit.connectEvents('dsh-fireworks', (data, frame) => {
  // data = publish 的 payload；连接断开自动重连
}, (state) => { liveState = state })

降级次序：枢纽不可用（未安装本包 / EventSource 缺席）时 connectEvents 返回 null，调用方回退自有 SSE 或短轮询——各插件保持独立可安装。 已在 fireworks / matrix / kite 三个插件落地，页面长连接数从 N 降到 1。

设计决策

• 构建期内联而非运行时插件：kit 不进 profile 的 bundle 图，无降级逻辑；消费者构建时把 client 源码打进自己的 bundle，dsh plugin add 时宿主代码经 npm 传递依赖装齐——一次性装上，无挖坑
• 协议无关：run/poll 以函数注入，提示词模板归各插件自有（业务层），kit 只收骨架

版本兼容性

本插件与 DeepSeek Harness（@deepseek-ai/dsh）的版本对应关系：

发版约定：每次发布新版本时，请在上表追加一行，记录该插件版本实际验证所用的 @deepseek-ai/dsh 版本。package.json 的 engines.dsh 声明最低支持版本；本表记录实际验证版本，二者配合使用。