@weibaohui/dsh-plugin-kit 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @weibaohui/dsh-plugin-kit
+
+[![npm version](https://img.shields.io/npm/v/@weibaohui/dsh-plugin-kit)](https://www.npmjs.com/package/@weibaohui/dsh-plugin-kit)
+
+# @weibaohui/dsh-plugin-kit
+
+[![npm version](https://img.shields.io/npm/v/@weibaohui/dsh-plugin-kit)](https://www.npmjs.com/package/@weibaohui/dsh-plugin-kit)
+
+dsh 插件共享工具箱。把系列插件中重复的「AI 动作按钮」能力收拢为一处：
+
+- **宿主**：`createShareRunJob` —— 把提示词交给真实 agent 会话执行（进程内 agents 服务优先流式，缺失降级 headless spawn；30 分钟超时 + 输出截断），任务状态由调用方轮询
+- **client**：`PluginKit.ActionShareDialog` —— ntd ActionButton 同款交互（可编辑提示词 + 参数预览 + 复制 + 执行 + 实时输出），全内联样式，消费者无需自带 CSS
+
+## 消费方式
+
+```jsonc
+// 插件 package.json
+"dependencies": { "@weibaohui/dsh-plugin-kit": "github:weibaohui/dsh-plugin-kit" }
+```
+
+`dsh plugin add` 安装插件时作为传递依赖一次性装上。
+
+### 宿主
+
+```js
+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：
+
+```js
+const ShareDialog = PluginKit.makeActionShareDialog(__React)
+// h(ShareDialog, { title, hint, rows, initialPrompt, run, poll, labels, onClose })
+```
+
+## 设计决策
+
+- **构建期内联而非运行时插件**：kit 不进 profile 的 bundle 图，无降级逻辑；消费者构建时把 client 源码打进自己的 bundle，`dsh plugin add` 时宿主代码经 npm 传递依赖装齐——一次性装上，无挖坑
+- **协议无关**：run/poll 以函数注入，提示词模板归各插件自有（业务层），kit 只收骨架

package/client/source.js

@@ -0,0 +1,102 @@
+/**
+ * @weibaohui/dsh-plugin-kit — client source（由消费者构建脚本内联进 bundle，
+ * 不经 loader 运行时加载）。对外暴露 PluginKit：
+ *
+ *   PluginKit.substituteParams(template, params)   — {{key}} 模板插值
+ *   PluginKit.makeActionShareDialog(React, opts)   — 返回 ActionShareDialog 组件
+ *
+ * ActionShareDialog props：
+ *   title / hint / rows: [[label, value], ...] / initialPrompt
+ *   run: async (prompt) => { jobId }      — 发起执行
+ *   poll: async (jobId) => { status, output, code }
+ *   labels: { copy, copied, run, running, done, failed, outputLabel, close }
+ *   onClose
+ *
+ * 全部样式内联（主题 token + 回退值），消费者无需自带 CSS。
+ */
+var PluginKit = (function () {
+  function substituteParams(template, params) {
+    var out = String(template || '')
+    for (var key in (params || {})) out = out.split('{{' + key + '}}').join(String(params[key]))
+    return out
+  }
+
+  function makeActionShareDialog(React, options) {
+    options = options || {}
+    var h = React.createElement
+    var useState = React.useState
+    var useEffect = React.useEffect
+    var doFetch = options.fetch || (typeof fetch !== 'undefined' ? fetch : null)
+    var inputStyle = { width: '100%', minHeight: 190, resize: 'vertical', fontFamily: 'var(--dsw-font-family)', lineHeight: 1.6, fontSize: 12, background: 'var(--dsw-alias-bg-layer-2,transparent)', color: 'inherit', border: '1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.3))', borderRadius: '8px', padding: '10px', boxSizing: 'border-box' }
+    var btnStyle = { background: 'transparent', color: 'inherit', border: '1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.3))', borderRadius: '8px', padding: '5px 12px', fontSize: 13, cursor: 'pointer', font: 'inherit' }
+    var primaryStyle = Object.assign({}, btnStyle, { background: 'var(--dsw-alias-brand-primary,#4a7dff)', borderColor: 'var(--dsw-alias-brand-primary,#4a7dff)', color: '#fff' })
+
+    return function ActionShareDialog(props) {
+      var title = props.title
+      var hint = props.hint
+      var labels = props.labels || {}
+      var _p = useState(props.initialPrompt || '')
+      var prompt = _p[0]; var setPrompt = _p[1]
+      var _j = useState(null)
+      var job = _j[0]; var setJob = _j[1]
+      var _b = useState(false)
+      var busy = _b[0]; var setBusy = _b[1]
+      var _c = useState(false)
+      var copied = _c[0]; var setCopied = _c[1]
+      var _e = useState('')
+      var error = _e[0]; var setError = _e[1]
+      var _d = useState(false)
+      var dirty = _d[0]; var setDirty = _d[1]
+
+      // initialPrompt 异步到位（如宿主先要下发真实路径）时跟随刷新；用户编辑过则不打断
+      useEffect(function () {
+        if (!dirty) setPrompt(props.initialPrompt || '')
+      }, [props.initialPrompt])
+
+      useEffect(function () {
+        if (job === null || job.status !== 'running' || typeof props.poll !== 'function') return
+        var timer = setInterval(function () {
+          props.poll(job.jobId).then(function (d) {
+            setJob({ jobId: job.jobId, status: d.status, output: d.output || '', code: d.code !== undefined ? d.code : null, sessionId: d.sessionId })
+          }).catch(function () {})
+        }, 1500)
+        return function () { clearInterval(timer) }
+      }, [job !== null && job.jobId])
+
+      var doRun = function () {
+        if (typeof props.run !== 'function') return
+        setBusy(true); setError('')
+        props.run(prompt).then(function (r) {
+          setJob({ jobId: r.jobId, status: 'running', output: '', code: null })
+        }).catch(function (e) { setError(String(e && e.message)) }).finally(function () { setBusy(false) })
+      }
+      var copy = function () {
+        if (typeof navigator !== 'undefined' && navigator.clipboard && navigator.clipboard.writeText) {
+          navigator.clipboard.writeText(prompt).then(function () { setCopied(true); setTimeout(function () { setCopied(false) }, 1500) }).catch(function () {})
+        }
+      }
+      var statusText = job === null ? '' : job.status === 'running' ? (labels.running || 'running') : job.status === 'done' ? (labels.done || 'done') : (labels.failed || 'failed') + (job.code != null ? ' (' + job.code + ')' : '')
+
+      return h('div', { onClick: function (e) { if (e.target === e.currentTarget && props.onClose) props.onClose() }, style: { position: 'fixed', inset: 0, zIndex: 2147483000, background: 'rgba(0,0,0,.45)', display: 'flex', alignItems: 'center', justifyContent: 'center' } },
+        h('div', { style: { width: 'min(640px,92vw)', maxHeight: '86vh', overflow: 'auto', background: 'var(--dsw-alias-bg-layer-1,#fff)', border: '1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.3))', borderRadius: '16px', padding: '20px', display: 'flex', flexDirection: 'column', gap: 12, color: 'var(--dsw-alias-label-primary,inherit)', font: 'var(--dsw-font-family,inherit)' } },
+          h('div', { style: { display: 'flex', alignItems: 'center', gap: 10 } },
+            h('div', { style: { fontSize: 17, fontWeight: 600 } }, title || ''),
+            h('button', { onClick: props.onClose, style: Object.assign({}, btnStyle, { marginLeft: 'auto', width: 28, height: 28, padding: 0, borderRadius: 28 }) }, '✕')),
+          hint ? h('div', { style: { fontSize: 12, opacity: .7 } }, hint) : null,
+          (props.rows || []).length > 0 ? h('div', { style: { display: 'flex', flexDirection: 'column', gap: 4, fontSize: 13 } },
+            props.rows.map(function (r, i) {
+              return r[1] ? h('div', { key: i }, h('b', null, r[0] + '：'), h('span', null, r[1])) : null
+            })) : null,
+          h('textarea', { value: prompt, onChange: function (e) { setDirty(true); setPrompt(e.target.value) }, spellCheck: false, style: inputStyle }),
+          error !== '' ? h('div', { style: { fontSize: 12, color: 'var(--dsw-alias-state-error,#c75050)' } }, error) : null,
+          job !== null ? h('div', null,
+            h('div', { style: { fontSize: 12, opacity: .7, margin: '4px 0' } }, (labels.outputLabel || 'Output') + ' · ' + statusText),
+            h('pre', { style: { maxHeight: 220, margin: 0, overflow: 'auto', whiteSpace: 'pre-wrap', fontSize: 12, background: 'var(--dsw-alias-bg-layer-2,transparent)', border: '1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.2))', borderRadius: '8px', padding: '8px' } }, job.output || '…')) : null,
+          h('div', { style: { display: 'flex', gap: 8 } },
+            h('button', { onClick: copy, style: btnStyle }, copied ? (labels.copied || 'Copied') : (labels.copy || 'Copy')),
+            h('button', { onClick: doRun, disabled: busy || (job !== null && job.status === 'running'), style: primaryStyle }, job !== null && job.status === 'running' ? (labels.running || 'Running…') : (labels.run || 'Run')))))
+    }
+  }
+
+  return { substituteParams: substituteParams, makeActionShareDialog: makeActionShareDialog }
+})()

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@weibaohui/dsh-plugin-kit",
+  "version": "0.1.0",
+  "description": "dsh 插件共享工具箱：AI 动作分享抽屉（ntd ActionButton 同款交互）+ 宿主任务执行器，供系列插件复用",
+  "license": "MIT",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./client/source.js": "./client/source.js"
+  },
+  "files": [
+    "src",
+    "client",
+    "README.md"
+  ],
+  "scripts": {
+    "check": "node --check src/index.js && node --check client/source.js",
+    "test": "node --test test/*.test.mjs",
+    "prepublishOnly": "npm run check && npm test"
+  },
+  "engines": {
+    "node": ">=22.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weibaohui/dsh-plugin-kit.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis",
+    "plugin",
+    "dsh-plugin",
+    "ui",
+    "kit"
+  ],
+  "homepage": "https://github.com/weibaohui/dsh-plugin-kit#readme",
+  "bugs": {
+    "url": "https://github.com/weibaohui/dsh-plugin-kit/issues"
+  }
+}

package/src/index.js

@@ -0,0 +1,101 @@
+'use strict'
+
+/**
+ * @weibaohui/dsh-plugin-kit — host half.
+ *
+ * createShareRunJob：把一段提示词交给一个真实 agent 会话执行（分享/提交类
+ * 动作的通用执行器）。优先使用同进程 agents 服务（输出流式可见）；服务缺失
+ * 的组合降级为 headless spawn（`<binary> --profile headless <prompt>`，cwd
+ * 为目标目录）。30 分钟超时 + 输出尾部截断，job 状态由调用方轮询。
+ */
+
+const { spawn } = require('node:child_process')
+
+const SHARE_RUN_TIMEOUT_MS = 30 * 60 * 1000
+const SHARE_RUN_OUTPUT_CAP = 256 * 1024
+
+function createShareRunJob({ binary = 'dsh', prompt, dir, jobs, logger, services }) {
+  const id = 'sr' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8)
+  const job = { id, status: 'running', startedAt: new Date().toISOString(), dir, promptHead: String(prompt || '').slice(0, 80), output: '', code: null }
+  jobs.set(id, job)
+  if (services && services.agents && services.agentDefaultModel) {
+    runShareInProcess(services, { prompt, dir, job, logger })
+      .catch(e => { job.status = 'error'; job.output = (job.output + '\n' + String(e && e.message)).slice(-SHARE_RUN_OUTPUT_CAP) })
+    return job
+  }
+  let child
+  try {
+    child = spawn(binary, ['--profile', 'headless', prompt], { cwd: dir })
+  } catch (e) {
+    job.status = 'error'
+    job.output = String(e && e.message)
+    return job
+  }
+  const append = (chunk) => {
+    job.output = (job.output + String(chunk)).slice(-SHARE_RUN_OUTPUT_CAP)
+  }
+  child.stdout && child.stdout.on('data', append)
+  child.stderr && child.stderr.on('data', append)
+  const timer = setTimeout(() => {
+    try { child.kill('SIGKILL') } catch {}
+    job.status = 'error'
+    job.output += '\n[killed: timeout]'
+  }, SHARE_RUN_TIMEOUT_MS)
+  if (typeof timer.unref === 'function') timer.unref()
+  child.on('error', (e) => { clearTimeout(timer); job.status = 'error'; append('\n' + String(e && e.message)) })
+  child.on('close', (code) => {
+    clearTimeout(timer)
+    job.status = code === 0 ? 'done' : 'failed'
+    job.code = code
+    logger.info && logger.info(`dsh-plugin-kit: share run ${id} ${job.status} (code ${code})`)
+  })
+  return job
+}
+
+async function runShareInProcess(services, { prompt, dir, job, logger }) {
+  const { randomUUID } = await import('node:crypto')
+  const selection = services.agentDefaultModel.currentSelection()
+  const sessionId = 'session-' + randomUUID()
+  job.sessionId = sessionId
+  const { agent } = await services.agents.create({
+    sessionId,
+    // 标准预设：不带显式选择会继承用户默认（如 Solo Thinking 只有 thinking/notify
+    // 工具），读文件/调 API 都做不了
+    meta: { cwd: dir, agentPreset: 'standard' },
+    agentOptions: { provider: selection.provider, model: selection.model },
+  })
+  await agent.whenIdle()
+  const firstSeq = agent.session.seq
+  const seen = new Set()
+  const liveLine = (text) => {
+    job.output = (job.output + text).slice(-SHARE_RUN_OUTPUT_CAP)
+  }
+  const pump = () => {
+    for (const ev of agent.session.events) {
+      if (ev.seq < firstSeq || seen.has(ev.seq)) continue
+      seen.add(ev.seq)
+      const d = ev.data || {}
+      if (ev.type === 'assistant/chunk' && d.chunk && d.chunk.type === 'text' && d.chunk.text) {
+        liveLine(d.chunk.text)
+      } else if (ev.type === 'tool/call') {
+        liveLine('\n[tool] ' + d.name + ' ')
+      } else if (ev.type === 'assistant/message') {
+        liveLine('\n')
+      }
+    }
+  }
+  const timer = setInterval(pump, 300)
+  if (typeof timer.unref === 'function') timer.unref()
+  try {
+    agent.followup({ content: [{ type: 'text', text: prompt }], source: { kind: 'user' } })
+    await agent.whenIdle()
+  } finally {
+    clearInterval(timer)
+    pump()
+  }
+  try { await services.sessions.flush(agent.session) } catch {}
+  job.status = 'done'
+  logger.info && logger.info(`dsh-plugin-kit: share run ${job.id} done`)
+}
+
+module.exports = { createShareRunJob, runShareInProcess, SHARE_RUN_TIMEOUT_MS, SHARE_RUN_OUTPUT_CAP }