@goodandready/dsh-voice 0.8.37 → 0.9.0

package/README.md

@@ -217,6 +217,8 @@ Registers `transcribe_audio(file_path, language?)` in `ctx.tools`, allowing agen
 * `POST /dsh-voice/transcribe` — `{ dataBase64, mimeType, mode }` → `{ ok, text, provider, tookMs }`
 * `POST /dsh-voice/polish` — `{ text }` → `{ ok, text }`
 * `GET /dsh-voice/status` — Returns daemon status, active chains, SenseVoice.
+* `GET /dsh-voice/config` — Returns live plugin configuration snapshot.
+* `PUT /dsh-voice/config` — Updates and persists plugin configuration across network.
 
 ---
 

package/README.zh.md

@@ -129,6 +129,16 @@ v0.8.18 质量审查后的修复批次（Gitea #79–#87，PR #88）：
 
 ---
 
+## 🤖 智能体工具与 HTTP 端点
+
+* `POST /dsh-voice/transcribe` — 音频转写：`{ dataBase64, mimeType, mode }` → `{ ok, text, provider, tookMs }`
+* `POST /dsh-voice/polish` — 文本模型润色：`{ text }` → `{ ok, text }`
+* `GET /dsh-voice/status` — 查询后端状态、服务商健康度与 SenseVoice
+* `GET /dsh-voice/config` — 获取插件运行时配置快照
+* `PUT /dsh-voice/config` — 跨网络安全持久化更新插件配置
+
+---
+
 ## 📦 安装指南
 
 ```bash

package/lib/client.js

@@ -1222,6 +1222,15 @@ window.__ModuleLoader__.load({
         if (event.repeat) return
         // A modifier hotkey does not fight the text field: modifiers do not
         // type. A plain letter key must not be hijacked while typing.
+        const target = event.target
+        const isEditable = target && (
+          target.tagName === 'INPUT' ||
+          target.tagName === 'TEXTAREA' ||
+          target.isContentEditable ||
+          (typeof target.getAttribute === 'function' && target.getAttribute('contenteditable') === 'true')
+        )
+        if (isEditable && !['Control', 'Alt', 'Shift'].includes(keyName)) return
+
         if (hotkeyMatches(event, keyName)) beginHold(mode)
       }
       const up = (event) => {
@@ -2174,6 +2183,25 @@ window.__ModuleLoader__.load({
       const [draft, setDraft] = React.useState(null)
       const [saved, setSaved] = React.useState(false)
       const [err, setErr] = React.useState('')
+      const [serverConfig, setServerConfig] = React.useState(null)
+      const [configLoading, setConfigLoading] = React.useState(true)
+
+      React.useEffect(() => {
+        let alive = true
+        fetch('/dsh-voice/config', { cache: 'no-store' })
+          .then((r) => r.json())
+          .then((data) => {
+            if (alive && data && data.ok && data.config) {
+              setServerConfig(data.config)
+              setDraft((curr) => curr || deepClone(data.config))
+            }
+          })
+          .catch(() => {})
+          .finally(() => {
+            if (alive) setConfigLoading(false)
+          })
+        return () => { alive = false }
+      }, [])
 
       // Hotkey picker: not a name field — press the key you want.
       const [catching, setCatching] = React.useState(false)
@@ -2207,9 +2235,9 @@ window.__ModuleLoader__.load({
           .catch(() => {})
       }, [])
 
-      const ready = !!snap && snap.status === 'ready'
-      const value = ready && snap.value ? snap.value : {}
-      const writable = ready && snap.writable !== false
+      const ready = !!serverConfig || (!!snap && snap.status === 'ready')
+      const value = (snap && snap.status === 'ready' && snap.value) ? snap.value : (serverConfig || {})
+      const writable = ready
 
       React.useEffect(() => {
         if (ready) return undefined
@@ -2455,7 +2483,7 @@ window.__ModuleLoader__.load({
       }, [checkUpdater])
 
       if (!ready) {
-        const waiting = !snap || snap.status === 'loading'
+        const waiting = configLoading || (!snap || snap.status === 'loading')
         return React.createElement('div', { className: 'cb-page' },
           React.createElement('div', { className: 'dvs-wait' }, waiting
             ? t('loadingSettings')
@@ -2476,13 +2504,40 @@ window.__ModuleLoader__.load({
         setErr(''); setSaved(false)
         if (!draft) return
 
-        const failed = []
-        for (const k of Object.keys(draft)) {
-          try {
-            await scope.set(k, draft[k])
-          } catch (e) {
-            failed.push(k + ': ' + String(e && e.message ? e.message : e))
+        let httpOk = false
+        let httpError = null
+        try {
+          const res = await fetch('/dsh-voice/config', {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ config: draft }),
+          })
+          const data = await res.json()
+          if (res.ok && data && data.ok) {
+            httpOk = true
+            if (data.config) {
+              setServerConfig(data.config)
+            }
+          } else {
+            httpError = data?.error?.message || data?.error || res.statusText || 'Save failed'
           }
+        } catch (e) {
+          httpError = e?.message || String(e)
+        }
+
+        if (scope && typeof scope.set === 'function') {
+          for (const k of Object.keys(draft)) {
+            try {
+              await scope.set(k, draft[k])
+            } catch (e) {
+              /* best effort on loopback */
+            }
+          }
+        }
+
+        if (!httpOk) {
+          setErr(t('saveFailed') + ': ' + httpError)
+          return
         }
 
         const d = draft || {}
@@ -2501,11 +2556,17 @@ window.__ModuleLoader__.load({
           noiseGateDb: Number(d.noiseGateDb !== undefined ? d.noiseGateDb : -45),
           contextGlossary: d.contextGlossary !== false,
           visualizerStyle: d.visualizerStyle || 'liquid-wave',
+          gatedTurnTaking: d.gatedTurnTaking !== false,
+          autoSendVisualRing: d.autoSendVisualRing !== false,
+          voiceActions: d.voiceActions !== false,
+          techJargonCorrection: d.techJargonCorrection !== false,
+          liveInterimPreview: d.liveInterimPreview !== false,
+          structuredPromptVoice: d.structuredPromptVoice !== false,
         })
         try { window.dispatchEvent(new CustomEvent('dsh-voice:settings-saved')) } catch (noEvents) { /* nobody */ }
 
-        if (failed.length) { setErr(t('saveFailed') + ' ' + failed.join('; ')); return }
-        setSaved(true); setTimeout(() => setSaved(false), 2000)
+        setSaved(true)
+        setTimeout(() => setSaved(false), 2000)
         fetchStatus()
       }
 
@@ -3047,7 +3108,7 @@ window.__ModuleLoader__.load({
           React.createElement('div', { className: 'cb-section-desc' }, t('versionHint')),
           React.createElement('div', { className: 'cb-row', style: { alignItems: 'center', gap: '12px' } },
             React.createElement('span', { className: 'cb-badge cb-badge-ok' },
-              'v' + ((updaterStatus && updaterStatus.currentVersion) || '0.8.32')
+              'v' + ((updaterStatus && updaterStatus.currentVersion) || '0.9.0')
             ),
             updaterStatus && updaterStatus.updateAvailable
               ? React.createElement('span', { className: 'cb-badge cb-badge-warn' },

package/lib/config-routes.js

@@ -0,0 +1,135 @@
+// lib/config-routes.js — Host route for plugin configuration persistence over network.
+// Solves DSH network limitation where client-side persistence is blocked in non-loopback environments (Gitea #149).
+
+import { writeJson, readBody, isTrustedCaller } from './http-util.js'
+
+export function registerConfigRoutes(ctx, {
+  NS,
+  live,
+  getSettingsService,
+  getScope,
+  validateConfig,
+  triggerAutostart,
+}) {
+  return ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-voice/config',
+    handler: async (req, res) => {
+      // 1. Method check: only GET, PUT, POST allowed
+      if (req.method !== 'GET' && req.method !== 'PUT' && req.method !== 'POST') {
+        writeJson(res, 405, { ok: false, error: { code: 'method', message: 'GET, PUT, or POST only' } })
+        return
+      }
+
+      // 2. Security check: loopback or same-origin
+      if (!isTrustedCaller(req)) {
+        writeJson(res, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden source origin' } })
+        return
+      }
+
+      // 3. GET: return live configuration snapshot
+      if (req.method === 'GET') {
+        writeJson(res, 200, { ok: true, config: live() })
+        return
+      }
+
+      // 4. PUT / POST: check settings service availability
+      const settingsService = getSettingsService?.()
+      const scope = getScope?.()
+      if (!settingsService && !scope) {
+        writeJson(res, 503, { ok: false, error: { code: 'unavailable', message: 'settings service not ready' } })
+        return
+      }
+
+      // 5. Read request body
+      let raw
+      try {
+        raw = await readBody(req, 1024 * 1024)
+      } catch (e) {
+        writeJson(res, 400, { ok: false, error: { code: 'body', message: e.message } })
+        return
+      }
+
+      // 6. Parse JSON payload
+      let payload
+      try {
+        payload = JSON.parse(raw.toString('utf8') || '{}')
+      } catch {
+        writeJson(res, 400, { ok: false, error: { code: 'json', message: 'invalid json' } })
+        return
+      }
+
+      const rawConfig = payload && typeof payload.config === 'object' && payload.config !== null
+        ? payload.config
+        : payload
+
+      if (!rawConfig || typeof rawConfig !== 'object' || Array.isArray(rawConfig)) {
+        writeJson(res, 400, { ok: false, error: { code: 'body', message: 'body must be a JSON object' } })
+        return
+      }
+
+      // 7. Validate and merge configuration
+      let merged
+      try {
+        const current = live() || {}
+        const candidate = {
+          ...current,
+          ...rawConfig,
+          dictation: { ...(current.dictation || {}), ...(rawConfig.dictation || {}) },
+          message: { ...(current.message || {}), ...(rawConfig.message || {}) },
+        }
+        merged = validateConfig ? validateConfig(candidate) : candidate
+      } catch (err) {
+        writeJson(res, 400, { ok: false, error: { code: 'validation', message: String(err?.message || err) } })
+        return
+      }
+
+      // 8. Persist to host settings
+      try {
+        let saved = false
+        if (settingsService) {
+          let rev
+          try {
+            rev = settingsService.describe?.()?.find?.((r) => r.ns === NS)?.revision
+          } catch { /* ignore revision lookup errors */ }
+
+          if (typeof settingsService.replace === 'function') {
+            await settingsService.replace(NS, merged, rev)
+            saved = true
+          } else if (typeof settingsService.update === 'function') {
+            await settingsService.update(NS, merged, rev)
+            saved = true
+          }
+        }
+
+        if (scope) {
+          if (typeof scope.replace === 'function') {
+            await scope.replace(merged)
+            saved = true
+          } else if (typeof scope.patch === 'function') {
+            await scope.patch(merged)
+            saved = true
+          } else if (typeof scope.set === 'function') {
+            for (const [k, v] of Object.entries(merged)) {
+              await scope.set(k, v).catch(() => {})
+            }
+            saved = true
+          }
+        }
+
+        if (!saved) {
+          writeJson(res, 503, { ok: false, error: { code: 'unavailable', message: 'failed to persist settings' } })
+          return
+        }
+
+        if (typeof triggerAutostart === 'function') {
+          triggerAutostart()
+        }
+
+        writeJson(res, 200, { ok: true, config: live() })
+      } catch (err) {
+        writeJson(res, 500, { ok: false, error: { code: 'save', message: String(err?.message || err) } })
+      }
+    },
+  })
+}

package/lib/index.js

@@ -29,6 +29,7 @@ import { buildProviderOrder, sessionCommand } from './transcribe-core.js'
 import { registerPluginUpdater } from './updater.js'
 import { registerSensevoiceInstaller } from './sensevoice-installer.js'
 import { createConfigReader } from './config-compat.js'
+import { registerConfigRoutes } from './config-routes.js'
 
 function isAutoLang(lang) {
   return !lang || lang === 'auto' || String(lang).includes(',')
@@ -214,19 +215,10 @@ export function apply(ctx, baseConfig) {
   // while caching unwrapped values across requests.
   const readEntryConfig = createConfigReader(baseConfig, ctx)
   let scope = null
+  let settingsService = null
   let getConfig = readEntryConfig
   const live = () => BaseConfig(structuredClone(getConfig() ?? {})) ?? readEntryConfig()
 
-  ctx.inject(['settings'], (sctx) => {
-    try {
-      scope = sctx.settings.register(NS, Config, { base: baseConfig })
-      if (scope && typeof scope.get === 'function') {
-        getConfig = () => scope.get() ?? readEntryConfig()
-      }
-    } catch { /* modern DSH handles settings via SettingsForms */ }
-    sctx.effect(() => () => { getConfig = readEntryConfig; scope = null })
-  })
-
   async function resolveKey(ref) {
     try {
       const resolved = await ctx.credentials.resolve(credentialRef(ref))
@@ -269,12 +261,27 @@ export function apply(ctx, baseConfig) {
         stdoutMaxBytes: 4 * 1024 * 1024,
       })
       child = ctx.shell.start(spec)
-      for (let i = 0; i < 20; i++) {
+      if (child && typeof child.on === 'function') {
+        child.on('error', (err) => {
+          whisperError = err?.message || String(err)
+        })
+        child.on('exit', (code) => {
+          if (code !== 0 && code !== null) {
+            whisperError = `whisper server process exited with code ${code}`
+          }
+        })
+      }
+      // Wait for it to become healthy (up to 30s for cold model loading on Metal/CPU).
+      for (let i = 0; i < 60; i++) {
         await new Promise((r) => setTimeout(r, 500))
         if (await whisperAlive()) {
           whisperError = null
           return true
         }
+        if (child && child.exitCode !== null && child.exitCode !== undefined) {
+          whisperError = `whisper server process exited prematurely with code ${child.exitCode}`
+          return false
+        }
       }
       whisperError = 'whisper server process started but failed health check on port 8001'
       return false
@@ -285,8 +292,6 @@ export function apply(ctx, baseConfig) {
     finally { startingWhisper = false }
   }
 
-  startWhisper().catch(() => {})
-
   // SenseVoice-ONNX / Sherpa-ONNX: autostart and health check.
   let sensevoiceChild = null
   let sensevoiceError = null
@@ -325,12 +330,27 @@ export function apply(ctx, baseConfig) {
         stdoutMaxBytes: 4 * 1024 * 1024,
       })
       sensevoiceChild = ctx.shell.start(spec)
-      for (let i = 0; i < 20; i++) {
+      if (sensevoiceChild && typeof sensevoiceChild.on === 'function') {
+        sensevoiceChild.on('error', (err) => {
+          sensevoiceError = err?.message || String(err)
+        })
+        sensevoiceChild.on('exit', (code) => {
+          if (code !== 0 && code !== null) {
+            sensevoiceError = `sensevoice process exited with code ${code}`
+          }
+        })
+      }
+      // Wait for it to become healthy (up to 30s).
+      for (let i = 0; i < 60; i++) {
         await new Promise((r) => setTimeout(r, 500))
         if (await sensevoiceAlive()) {
           sensevoiceError = null
           return true
         }
+        if (sensevoiceChild && sensevoiceChild.exitCode !== null && sensevoiceChild.exitCode !== undefined) {
+          sensevoiceError = `sensevoice process exited prematurely with code ${sensevoiceChild.exitCode}`
+          return false
+        }
       }
       sensevoiceError = 'sensevoice process started but failed health check'
       return false
@@ -341,7 +361,39 @@ export function apply(ctx, baseConfig) {
     finally { startingSensevoice = false }
   }
 
-  startSensevoice().catch(() => {})
+  function triggerAutostart() {
+    startWhisper().catch((err) => {
+      ctx.logger?.debug?.('whisper autostart failed: %s', err?.message || err)
+    })
+    startSensevoice().catch((err) => {
+      ctx.logger?.debug?.('sensevoice autostart failed: %s', err?.message || err)
+    })
+  }
+
+  ctx.inject(['settings'], (sctx) => {
+    settingsService = sctx.settings
+    try {
+      scope = sctx.settings.register(NS, Config, { base: baseConfig })
+      if (scope && typeof scope.get === 'function') {
+        getConfig = () => scope.get() ?? readEntryConfig()
+      }
+      if (scope && typeof scope.watch === 'function') {
+        scope.watch(() => {
+          triggerAutostart()
+        })
+      }
+    } catch { /* modern DSH handles settings via SettingsForms */ }
+    sctx.effect(() => () => { getConfig = readEntryConfig; scope = null; settingsService = null })
+    triggerAutostart()
+  })
+
+  if (typeof ctx.on === 'function') {
+    ctx.on('loader/volatile-update', () => triggerAutostart())
+    ctx.on('settings/document-updated', () => triggerAutostart())
+    ctx.on('config', () => triggerAutostart())
+  }
+
+  triggerAutostart()
 
   // Provider health and latency stats (Latency & Health Dashboard).
   const statsTracker = createStatsTracker()
@@ -615,5 +667,14 @@ export function apply(ctx, baseConfig) {
     },
     startSensevoice,
   }), 'dsh-voice: sensevoice installer route')
+
+  ctx.effect(() => registerConfigRoutes(ctx, {
+    NS,
+    live,
+    getSettingsService: () => settingsService,
+    getScope: () => scope,
+    validateConfig: (val) => BaseConfig(structuredClone(val)),
+    triggerAutostart,
+  }), 'dsh-voice: config route')
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-voice",
-  "version": "0.8.37",
+  "version": "0.9.0",
   "description": "Voice input for DeepSeek Harness: dictation chunked by pauses and voice messages, each with its own provider fallback chain (Deepgram, Groq, HuggingFace, local whisper.cpp, plus any OpenAI-compatible API of your own).",
   "license": "MIT",
   "type": "module",