dsh-superinput 0.0.0-stage → 0.12.1

package/modules/prompts.js

@@ -0,0 +1,370 @@
+/**
+ * dsh-superinput · prompts 模块（提示词模板库）
+ *
+ * prompts 是手动保存的常用模板（划选正文可一键存入）。
+ * 支持 {{变量}} 占位符，插入时由前端弹窗填值；服务端只存原文，不做替换。
+ *
+ * 存储 ~/.dsh/storages/dsh-superinput/prompts.json（结构 { items: [...] }）。
+ */
+import Schema from '@deepseek-ai/schemastery'
+import { createUserMessage } from '@deepseek-ai/dsh-llm'
+import { readFileSync, writeFileSync, renameSync, mkdirSync, appendFileSync } from 'node:fs'
+import { randomUUID } from 'node:crypto'
+import { homedir } from 'node:os'
+import { join, dirname } from 'node:path'
+
+export const inject = []
+
+const STORE_DIR = join(homedir(), '.dsh', 'storages', 'dsh-superinput')
+const STORE_PATH = join(STORE_DIR, 'prompts.json')
+const CLIENT_DIAG = join(homedir(), '.dsh', 'superinput-debug.log')
+
+/* 划选上下文：客户端把「选段 + 评论」暂存到这里，下一轮 pre-step 一次性
+ * 注入成一条 sourced UserMessage，随后立即删除（只影响紧接着的一次发送）。 */
+const CONTEXT_MAX_ITEMS = 8
+const CONTEXT_TEXT_MAX = 4000
+const CONTEXT_COMMENT_MAX = 600
+const CONTEXT_TTL_MS = 10 * 60_000
+const pendingContext = new Map()
+
+function renderSelectionContext(items) {
+  const lines = [
+    '以下是我从对话中选中的上下文，按顺序附带我的评论。回答时请优先参考这些内容，并针对评论中的问题作答。',
+  ]
+  items.forEach((item, index) => {
+    lines.push(`【选段 ${index + 1}】\n${item.text}${item.comment ? `\n我的评论：${item.comment}` : ''}`)
+  })
+  return lines.join('\n\n')
+}
+
+export const Config = Schema.object({
+  enabled: Schema.boolean().default(true).description('启用提示词模板库'),
+  maxItems: Schema.number().default(500).description('最多保存多少条模板（收藏不计入上限）'),
+})
+
+function createStore(maxItems) {
+  let state = { items: [] }
+  let dirty = false
+  let timer = null
+
+  const load = () => {
+    try { state = JSON.parse(readFileSync(STORE_PATH, 'utf8')) } catch { /* 首次或损坏：空库 */ }
+    if (!state || !Array.isArray(state.items)) state = { items: [] }
+  }
+
+  const flush = () => {
+    if (!dirty) return
+    try {
+      mkdirSync(STORE_DIR, { recursive: true })
+      const tmp = `${STORE_PATH}.${process.pid}.tmp`
+      writeFileSync(tmp, JSON.stringify(state), 'utf8')
+      renameSync(tmp, STORE_PATH)
+      dirty = false
+    } catch (error) {
+      console.error('[dsh-superinput] prompts flush failed:', error?.message ?? error)
+    }
+  }
+
+  const schedule = () => {
+    dirty = true
+    if (timer) return
+    timer = setTimeout(() => { timer = null; flush() }, 500)
+    timer.unref?.()
+  }
+
+  return {
+    load,
+    dispose() { if (timer) { clearTimeout(timer); timer = null } flush() },
+    list() { return state.items },
+
+    /** 新建或更新。title 为空时用正文前 40 字兜底，避免列表里出现无标题条目。 */
+    save({ id, title, body, tags }) {
+      const cleanBody = String(body ?? '').replace(/\0/g, '')
+      if (!cleanBody.trim()) return { ok: false, reason: 'empty-body' }
+      const cleanTitle = String(title ?? '').trim().slice(0, 80) || cleanBody.trim().slice(0, 40)
+      const cleanTags = Array.isArray(tags)
+        ? tags.map((tag) => String(tag).trim()).filter(Boolean).slice(0, 8)
+        : []
+
+      if (id) {
+        const item = state.items.find((entry) => entry.id === id)
+        if (!item) return { ok: false, reason: 'not-found' }
+        item.title = cleanTitle
+        item.body = cleanBody
+        item.tags = cleanTags
+        item.at = Date.now()
+        schedule()
+        return { ok: true, id, created: false }
+      }
+
+      const newId = randomUUID()
+      state.items.unshift({
+        id: newId,
+        title: cleanTitle,
+        body: cleanBody,
+        tags: cleanTags,
+        at: Date.now(),
+        pinned: false,
+      })
+      // 收藏条目不占上限
+      const overflow = state.items.filter((item) => !item.pinned).length - maxItems
+      if (overflow > 0) {
+        const drop = new Set(state.items.filter((item) => !item.pinned).slice(-overflow).map((item) => item.id))
+        state.items = state.items.filter((item) => !drop.has(item.id))
+      }
+      schedule()
+      return { ok: true, id: newId, created: true }
+    },
+
+    remove(id) {
+      const before = state.items.length
+      state.items = state.items.filter((item) => item.id !== id)
+      if (state.items.length !== before) schedule()
+      return state.items.length !== before
+    },
+
+    pin(id, pinned) {
+      const item = state.items.find((entry) => entry.id === id)
+      if (!item) return false
+      item.pinned = !!pinned
+      schedule()
+      return true
+    },
+
+    /** 使用计数：面板点插入时调用，列表按最近使用排序。 */
+    use(id) {
+      const item = state.items.find((entry) => entry.id === id)
+      if (!item) return false
+      item.usedAt = Date.now()
+      item.uses = (item.uses ?? 0) + 1
+      schedule()
+      return true
+    },
+
+    /** 是否注册为 / 斜杠命令（客户端按此标记同步 commandUi）。 */
+    slash(id, on) {
+      const item = state.items.find((entry) => entry.id === id)
+      if (!item) return false
+      item.slash = !!on
+      schedule()
+      return true
+    },
+
+    /**
+     * 导入：按 id 合并；同 id 冲突保留 at（更新时间）较新的一方。
+     * id 不在库中则原 id 收编（跨机重复导入可去重），缺 id 才新分配。
+     */
+    import(items) {
+      let added = 0
+      let updated = 0
+      for (const raw of items.slice(0, 5000)) {
+        const body = String(raw?.body ?? '').replace(/\0/g, '')
+        if (!body.trim()) continue
+        const incoming = {
+          title: String(raw?.title ?? '').trim().slice(0, 80) || body.trim().slice(0, 40),
+          body,
+          tags: Array.isArray(raw?.tags)
+            ? raw.tags.map((tag) => String(tag).trim()).filter(Boolean).slice(0, 8)
+            : [],
+          at: Number.isFinite(raw?.at) ? raw.at : Date.now(),
+          pinned: raw?.pinned === true,
+          slash: raw?.slash === true,
+          usedAt: Number.isFinite(raw?.usedAt) ? raw.usedAt : undefined,
+          uses: Number.isFinite(raw?.uses) ? Math.max(0, Math.round(raw.uses)) : 0,
+        }
+        const existing = raw?.id ? state.items.find((entry) => entry.id === raw.id) : null
+        if (existing) {
+          if (incoming.at > (existing.at ?? 0)) {
+            Object.assign(existing, incoming)
+            updated++
+          }
+          continue
+        }
+        state.items.unshift({ id: raw?.id ? String(raw.id).slice(0, 64) : randomUUID(), ...incoming })
+        added++
+      }
+      const overflow = state.items.filter((item) => !item.pinned).length - maxItems
+      if (overflow > 0) {
+        const drop = new Set(state.items.filter((item) => !item.pinned).slice(-overflow).map((item) => item.id))
+        state.items = state.items.filter((item) => !drop.has(item.id))
+      }
+      if (added + updated > 0) schedule()
+      return { added, updated }
+    },
+  }
+}
+
+export function apply(ctx, config) {
+  // 运行时可变副本：POST /settings 改这里，立即生效；显式改过的键持久化
+  // 到 storages、启动时回放（没改过的键继续跟随宿主配置）。回放必须在
+  // createStore 之前，重启后上次的 maxItems 才对裁剪生效。
+  const live = { ...config }
+  if (!live.enabled) return
+
+  // 设置持久化：只落与 config 不同的键，防抖 400ms 原子写。
+  const SETTINGS_KEYS = ['maxItems']
+  const SETTINGS_PATH = join(homedir(), '.dsh', 'storages', 'dsh-superinput', 'prompts.settings.json')
+  try {
+    const saved = JSON.parse(readFileSync(SETTINGS_PATH, 'utf8'))
+    for (const key of SETTINGS_KEYS) if (saved?.[key] !== undefined) live[key] = saved[key]
+  } catch { /* 无存档：全部跟随配置 */ }
+  let settingsTimer = null
+  const persistSettings = () => {
+    if (settingsTimer) return
+    settingsTimer = setTimeout(() => {
+      settingsTimer = null
+      try {
+        mkdirSync(dirname(SETTINGS_PATH), { recursive: true })
+        const out = {}
+        for (const key of SETTINGS_KEYS) if (live[key] !== config[key]) out[key] = live[key]
+        const tmp = `${SETTINGS_PATH}.tmp`
+        writeFileSync(tmp, JSON.stringify(out, null, 2))
+        renameSync(tmp, SETTINGS_PATH)
+      } catch { /* ignore */ }
+    }, 400)
+  }
+
+  const store = createStore(Math.max(20, Math.round(live.maxItems ?? 500)))
+  store.load()
+  ctx.effect(() => store.dispose(), 'dsh-superinput: prompts store')
+
+  // 划选上下文注入：挂在 pre-step 最前面，先让下游（含提示词增强）处理完，
+  // 再把上下文作为一条独立的 sourced 用户消息追加到本轮送模消息末尾。
+  ctx.on('agent/pre-step', async ({ agent, step, signal }, next) => {
+    const decision = await next()
+    if (decision.kind === 'reject' || signal?.aborted) return decision
+    const rawSession = agent?.session
+    const sessionId = typeof rawSession === 'string'
+      ? rawSession
+      : rawSession?.id === undefined ? '' : String(rawSession.id)
+    const pending = sessionId ? pendingContext.get(sessionId) : undefined
+    if (step !== 1 || !pending) return decision
+    pendingContext.delete(sessionId)
+    if (pending.items.length === 0 || Date.now() - pending.at > CONTEXT_TTL_MS) return decision
+    const text = renderSelectionContext(pending.items)
+    try {
+      appendFileSync(CLIENT_DIAG, `${new Date().toISOString()} context injected session=${sessionId.slice(0, 50)} items=${pending.items.length}\n`, 'utf8')
+    } catch { /* 日志失败不影响注入 */ }
+    return {
+      ...decision,
+      messages: [...decision.messages, createUserMessage({
+        content: [{ type: 'text', text }],
+        source: {
+          kind: 'dsh-superinput-selection',
+          form: 'snapshot',
+          sections: [{ name: 'selection-context', text }],
+        },
+      })],
+    }
+  }, { prepend: true })
+
+  ctx.inject(['webServer'], (webCtx) => {
+    webCtx.effect(() => webCtx.webServer.register({
+      kind: 'prefix',
+      path: '/api/dsh-superinput/prompts',
+      handler: async (req, res) => {
+        const send = (status, body) => {
+          res.statusCode = status
+          res.setHeader('content-type', 'application/json')
+          res.end(JSON.stringify(body))
+        }
+        const path = (req.url ?? '').split('?')[0].replace(/^\/api\/dsh-superinput\/prompts/, '')
+        const readBody = async () => {
+          let body = ''
+          for await (const chunk of req) body += chunk
+          try { return JSON.parse(body) } catch { return {} }
+        }
+
+        if (path === '/settings' && req.method === 'GET') {
+          send(200, { ...live })
+          return
+        }
+        // 运行时改参数：只接受白名单字段，其余忽略（provider/model 这类
+        // 改了要重建路由，运行时改无效，不如不给入口）。
+        if (path === '/settings' && req.method === 'POST') {
+          let raw = ''
+          for await (const chunk of req) raw += chunk
+          let body
+          try { body = JSON.parse(raw) } catch { send(400, { error: 'invalid-json' }); return }
+          if (body.maxItems !== undefined) { const v = Number(body.maxItems); if (Number.isFinite(v)) live.maxItems = Math.min(5000, Math.max(20, Math.round(v))) }
+          persistSettings()
+          send(200, { ...live })
+          return
+        }
+        // 套件客户端统一诊断通道（0.4.0 起从 snippets 迁来）：落
+        // ~/.dsh/superinput-debug.log，与服务端 trace 同文件便于一次排查。
+        if (path === '/diag' && req.method === 'POST') {
+          let raw = ''
+          for await (const chunk of req) raw += chunk
+          try {
+            let message = raw
+            try { message = JSON.parse(raw).message ?? raw } catch { /* 纯文本也收 */ }
+            mkdirSync(dirname(CLIENT_DIAG), { recursive: true })
+            appendFileSync(CLIENT_DIAG, `${new Date().toISOString()} ${String(message).slice(0, 500)}\n`, 'utf8')
+          } catch { /* 落盘失败不影响应答 */ }
+          send(200, { ok: true })
+          return
+        }
+        // 划选上下文暂存：items 为空表示清除；真正的注入在 agent/pre-step。
+        if (path === '/context' && req.method === 'POST') {
+          const body = await readBody()
+          const sessionId = String(body.sessionId ?? '').trim().slice(0, 200)
+          if (!sessionId) { send(400, { error: 'missing-session' }); return }
+          const items = Array.isArray(body.items)
+            ? body.items.slice(0, CONTEXT_MAX_ITEMS).map((item) => ({
+              text: String(item?.text ?? '').replace(/\0/g, '').trim().slice(0, CONTEXT_TEXT_MAX),
+              comment: String(item?.comment ?? '').replace(/\0/g, '').trim().slice(0, CONTEXT_COMMENT_MAX),
+            })).filter((item) => item.text.length > 0)
+            : []
+          if (items.length === 0) pendingContext.delete(sessionId)
+          else pendingContext.set(sessionId, { items, at: Date.now() })
+          send(200, { ok: true, count: items.length })
+          return
+        }
+        if (path === '/list' && req.method === 'GET') {
+          send(200, { items: store.list() })
+          return
+        }
+        if (path === '/save' && req.method === 'POST') {
+          send(200, store.save(await readBody()))
+          return
+        }
+        if (path === '/remove' && req.method === 'POST') {
+          const body = await readBody()
+          send(200, { ok: store.remove(String(body.id ?? '')) })
+          return
+        }
+        if (path === '/pin' && req.method === 'POST') {
+          const body = await readBody()
+          send(200, { ok: store.pin(String(body.id ?? ''), body.pinned === true) })
+          return
+        }
+        if (path === '/use' && req.method === 'POST') {
+          const body = await readBody()
+          send(200, { ok: store.use(String(body.id ?? '')) })
+          return
+        }
+        if (path === '/slash' && req.method === 'POST') {
+          const body = await readBody()
+          send(200, { ok: store.slash(String(body.id ?? ''), body.slash === true) })
+          return
+        }
+        if (path === '/export' && req.method === 'GET') {
+          send(200, { version: 1, exportedAt: Date.now(), items: store.list() })
+          return
+        }
+        // 兼容两种载荷：导出文件原样（{items:[...]}）和裸数组。
+        if (path === '/import' && req.method === 'POST') {
+          const body = await readBody()
+          const items = Array.isArray(body) ? body : Array.isArray(body?.items) ? body.items : null
+          if (!items) { send(400, { error: 'invalid-payload' }); return }
+          send(200, { ok: true, ...store.import(items) })
+          return
+        }
+        send(404, { error: 'not-found' })
+      },
+    }), 'dsh-superinput: prompts endpoints')
+  })
+}
+
+export default { Config, apply }

package/modules/voice.js

@@ -0,0 +1,17 @@
+/* 由 scripts/build-suite.mjs 从 dsh-siri-voice/index.js 机械生成；勿手改，重跑脚本再生成。 */
+/**
+ * dsh-siri-voice — 服务端半（无逻辑）。
+ *
+ * 这个插件只做 web 客户端的视觉层，但 dsh 的客户端模块扫描是从 Host 的
+ * loader entries 出发的，所以包仍然需要一个可被加载的服务端入口：
+ * 声明 `dsh.bundle.patch` 把一行插件插进 profile，`dsh.client.platform = 'web'`
+ * 让 web 宿主把 client.js 挂到页面里。
+ */
+
+const name = 'siri-voice'
+
+/** 不注册任何服务；所有效果都在客户端。 */
+export function apply() {}
+
+import Schema from '@deepseek-ai/schemastery'
+export const Config = Schema.object({ enabled: Schema.boolean().default(true).description('启用') })

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "dsh-superinput",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.12.1",
+  "description": "Super input box suite for the DeepSeek Harness (dsh): model & effort picker, prompt enhancement, follow-up suggestions, full cost engine (billing, backfill, price sync, forecast, usage heatmap, Coding Plan quotas, bilingual UI), voice input, prompt template manager, inline selection reference chips with comments, a compaction ring and a settings hub — one plugin, eight modules with per-module failure isolation.",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js"
+  },
+  "files": [
+    "index.js",
+    "server.js",
+    "client.js",
+    "modules/*.js",
+    "scripts",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build-suite.mjs",
+    "check": "node --check index.js && node --check server.js && node --check client.js",
+    "test": "node scripts/smoke.mjs"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "deepseek",
+    "composer",
+    "cost",
+    "picker",
+    "suite"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/saul-dsh/dsh-superinput.git"
+  },
+  "homepage": "https://github.com/saul-dsh/dsh-superinput#readme",
+  "bugs": {
+    "url": "https://github.com/saul-dsh/dsh-superinput/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-llm": ">=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/dsh-tools": ">=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/schemastery": "*"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  }
+}