@flowingspring/dsh-voco 0.3.11 → 0.3.12

package/README.en.md

@@ -0,0 +1,156 @@
+# dsh-voco
+
+English | [中文](README.md)
+
+`dsh-voco` is a voice conversation plugin for the DeepSeek Harness (DSH) Web UI. Speak a request naturally and work that needs project tools is delegated to a background Agent. The complete task report stays in the DSH task UI while Voice speaks a concise result.
+
+The plugin uses SiliconFlow cloud speech recognition and Edge TTS. It is not a standalone browser extension and does not require a separate background service.
+
+## Prerequisites
+
+- Node.js 22.19 or newer (used by the DSH CLI).
+- A DSH Web profile that can start successfully.
+- A SiliconFlow API key. Voco uses the currently free [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra) speech-to-text model, but every user still needs their own key. Current availability and pricing are governed by the SiliconFlow model page.
+- A modern browser with microphone support.
+
+Install the DSH CLI first if it is not already available:
+
+```powershell
+npm install -g @deepseek-ai/dsh
+```
+
+## Option 1: Install from npm (recommended)
+
+This is the intended path for regular users. It installs the one public plugin package without downloading or editing this repository:
+
+```powershell
+dsh plugin --profile web add @flowingspring/dsh-voco
+```
+
+Start the DSH Web UI:
+
+```powershell
+dsh web
+```
+
+Open the local URL printed by DSH, click the microphone in a session, and allow microphone access in the browser.
+
+## Option 2: Install from a GitHub Release
+
+GitHub Releases provide the same prebuilt plugin package as npm. No source checkout or pnpm development environment is required:
+
+```powershell
+dsh plugin --profile web add https://github.com/lgquan/dsh-voco/releases/download/v0.3.12/flowingspring-dsh-voco-0.3.12.tgz
+```
+
+Release page: [v0.3.12](https://github.com/lgquan/dsh-voco/releases/tag/v0.3.12)
+
+Whichever installation method you choose, start the Web UI through DSH:
+
+```powershell
+dsh web
+```
+
+## Configure the SiliconFlow API key
+
+The only required secret is `SILICONFLOW_API_KEY`. Get your own key from the [SiliconFlow console](https://siliconflow.cn/). Speech-to-text uses SiliconFlow's currently free [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra) model; current availability and pricing are governed by the model page. Never put a real key in source code, commit it to GitHub, or share it with other users.
+
+### Recommended: DSH settings
+
+After starting DSH, open **Settings → Plugins → Plugin configuration**, expand **Voice Assistant (Voco)**, enter the API key, and save. The key is written to the DSH credentials store rather than the regular settings file, and the UI never reads the secret back. Start or reconnect Voice after saving.
+
+Environment variables and `.env` remain supported for automation and existing deployments.
+
+### Temporary: current PowerShell session
+
+Set the variable in the same terminal that starts DSH:
+
+```powershell
+$env:SILICONFLOW_API_KEY = "sk-your-api-key"
+dsh web
+```
+
+The value disappears when that terminal closes.
+
+### Persistent: DSH user environment file
+
+Create `.env` in the DSH user directory. On Windows the default path is `%USERPROFILE%\.dsh\.env` (or `$DSH_HOME/.env` when `DSH_HOME` is set):
+
+```dotenv
+SILICONFLOW_API_KEY=sk-your-api-key
+```
+
+You may also create `.env` in the directory from which you run `dsh web`. The DSH credentials service reads these environment layers, and the plugin resolves `SILICONFLOW_API_KEY` through that service for each new voice connection. Do not enter the npm installation directory or edit files under `node_modules`.
+
+An already inherited environment variable takes precedence, followed by the DSH credentials store and then `.env` fallbacks. Restart `dsh web` after changing `.env`, because the environment is loaded once per process.
+
+## After installation
+
+1. Run `dsh web` and open the DSH Web UI.
+2. Create or select a session.
+3. Click the microphone and grant browser permission.
+4. Speak naturally. About 1.5 seconds of continuous silence ends an utterance and sends it to cloud recognition. You can also hold the microphone for about 400 ms to use push-to-talk; release it to submit only that utterance. A disconnected session stays muted after a push-to-talk submission so its spoken reply can arrive.
+5. Ordinary conversation is handled in the frontend; work that needs project files, Shell, or other tools is delegated to the background Agent.
+
+Voice sessions support interruption, reconnects, and history restoration. Each Voice Session keeps its own background Agent Session binding. When the context rotation threshold is reached, Voco creates a new child session for later tasks while keeping it under the same Voice Session.
+
+## Update
+
+Update from npm:
+
+```powershell
+dsh plugin --profile web add @flowingspring/dsh-voco
+```
+
+You can also install a specific GitHub Release `.tgz` URL. Restart `dsh web` after updating.
+
+## Uninstall
+
+```powershell
+dsh plugin --profile web remove @flowingspring/dsh-voco
+```
+
+Uninstalling the plugin does not remove a saved API key. To remove it completely, delete `SILICONFLOW_API_KEY` from `refs` in `%USERPROFILE%\.dsh\.credentials.yaml` (or `$DSH_HOME/.credentials.yaml` when configured), and remove the same name from the process environment or any `.env` file.
+
+Uninstalling the plugin does not delete existing DSH sessions or Voice history. Confirm the relevant data directory before removing any stored data manually.
+
+## Highlights
+
+- SiliconFlow's free [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra) cloud speech-to-text model.
+- Edge TTS `zh-CN-XiaoxiaoNeural` voice output.
+- Voice, typed messages, and background Agent tasks in one DSH session.
+- Immediate acknowledgement before delegation; full reports remain in the task UI.
+- Voice binding survives navigation, reconnects, and DSH restarts.
+- Optional integration with `@flowingspring/dsh-workspace-memory` for Workspace memory.
+
+## Troubleshooting
+
+### Missing API key when clicking the microphone
+
+Make sure the DSH process can read `SILICONFLOW_API_KEY`. After creating or changing `.env`, stop the old DSH process and run `dsh web` again.
+
+### No microphone or audio output
+
+Check browser microphone permission and the system input device. Use the page served by `dsh web`; do not open an HTML file directly.
+
+### Recognition fails or takes a long time
+
+Speech recognition needs network access to SiliconFlow. Check connectivity, key validity, account quota, and the latency of the selected model and provider.
+
+### Tuning silence detection
+
+Advanced settings live in the plugin profile's `cordis.patch.yml`, including `silenceDurationMs`, `speechThreshold`, `minSpeechDurationMs`, and `maxUtteranceMs`. Most users can keep the defaults.
+
+## Optional Workspace Memory
+
+Workspace Memory is not required by Voco. Install `@flowingspring/dsh-workspace-memory` separately when needed; Voco also works by itself. See that project's documentation for its own installation and configuration.
+
+## Development and support
+
+- Source and issues: [GitHub](https://github.com/lgquan/dsh-voco)
+- npm package: [`@flowingspring/dsh-voco`](https://www.npmjs.com/package/@flowingspring/dsh-voco)
+- Architecture notes: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -1,108 +1,156 @@
-# `@flowingspring/dsh-voco`
+# dsh-voco
 
-[![npm version](https://img.shields.io/npm/v/@flowingspring/dsh-voco.svg)](https://www.npmjs.com/package/@flowingspring/dsh-voco)
-[![license](https://img.shields.io/npm/l/@flowingspring/dsh-voco.svg)](https://github.com/lgquan/dsh-voco/blob/master/LICENSE)
+[English](README.en.md) | 中文
 
-English | [中文](README.zh.md)
+`dsh-voco` 是面向 DeepSeek Harness（DSH）Web UI 的语音对话插件。它让你用自然语言说出需求，并将需要项目工具的工作委派给后台 Agent；完整任务报告仍保留在 DSH 会话中，语音只播报简洁结果。
 
-Recoverable, interruptible voice conversations for the DeepSeek Harness (DSH) Web UI. Voco uses SiliconFlow cloud speech recognition and Edge TTS, and delegates work that needs tools to a background Agent.
+插件使用硅基流动云端语音识别和 Edge TTS。它不是独立的浏览器扩展，也不需要单独运行一个后台服务。
 
-## Install
+## 安装前准备
 
-### npm (recommended)
+- Node.js 22.19 或更高版本（安装 DSH CLI 时使用）。
+- 一个已经可以运行的 DSH Web profile。
+- 一个硅基流动 API Key。插件使用当前免费的语音转文字模型 [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra)，但仍需用户自行申请 Key；免费状态和使用规则以硅基流动模型页面为准。
+- 支持麦克风的现代浏览器。
 
-Install the DSH CLI first:
+如果还没有 DSH CLI，先安装：
 
 ```powershell
 npm install -g @deepseek-ai/dsh
 ```
 
-Add the plugin to the Web profile and start it:
+## 方式一：从 npm 安装（推荐）
+
+这是普通用户最简单的安装方式。只安装公开的单一插件包，不需要下载或修改本仓库源码：
 
 ```powershell
 dsh plugin --profile web add @flowingspring/dsh-voco
+```
+
+安装完成后启动 DSH Web：
+
+```powershell
 dsh web
 ```
 
-### GitHub Release
+打开终端显示的本地地址，在会话中点击麦克风并允许浏览器使用麦克风即可。
+
+## 方式二：通过 GitHub Release 安装
 
-GitHub Releases provide a prebuilt plugin package; no source checkout or pnpm installation is required:
+GitHub Release 提供和 npm 相同的预构建插件包，不需要 clone 源码或准备 pnpm 开发环境：
 
 ```powershell
-dsh plugin --profile web add https://github.com/lgquan/dsh-voco/releases/download/v0.3.11/flowingspring-dsh-voco-0.3.11.tgz
+dsh plugin --profile web add https://github.com/lgquan/dsh-voco/releases/download/v0.3.12/flowingspring-dsh-voco-0.3.12.tgz
 ```
 
-Release page: [v0.3.11](https://github.com/lgquan/dsh-voco/releases/tag/v0.3.11)
+Release 页面：[v0.3.12](https://github.com/lgquan/dsh-voco/releases/tag/v0.3.12)
+
+无论选择哪种安装方式，最后都通过 DSH 启动 Web UI：
+
+```powershell
+dsh web
+```
+
+## 配置硅基流动 API Key
+
+插件只需要一个密钥：`SILICONFLOW_API_KEY`。请先在[硅基流动控制台](https://siliconflow.cn/)申请自己的 API Key。语音转文字使用硅基流动当前免费的 [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra)；免费状态和使用规则以后续模型页面为准。不要把真实密钥写进源码、提交到 GitHub，或发送给其他人。
 
-## Configure the API key
+### 推荐配置：DSH 设置页面
 
-Speech recognition requires your own [SiliconFlow API key](https://siliconflow.cn/). The only configuration name is `SILICONFLOW_API_KEY`. Speech-to-text uses SiliconFlow's currently free [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra) model; current availability and pricing are governed by the model page. Edge TTS does not require a key.
+启动 DSH 后打开“设置 → 插件 → 插件配置”，展开“语音助手（Voco）”，填写 API Key 并保存。密钥写入 DSH 的凭据库，不会写进普通设置文件，界面也不会读回密钥明文。保存后重新开启或重连语音即可生效。
 
-The recommended path is **Settings → Plugins → Plugin configuration** in DSH. Expand **Voice Assistant (Voco)**, enter the API key, and save. The key is stored in DSH credentials rather than the regular settings file. Start or reconnect Voice after saving.
+下面的环境变量和 `.env` 方式继续保留，适合自动化或已有部署。
 
-Environment variables and `.env` remain supported for compatibility and automation.
+### 临时配置：当前 PowerShell 会话
 
-For a temporary setting, use the same PowerShell session that starts DSH:
+在启动 DSH 的同一个终端中设置：
 
 ```powershell
 $env:SILICONFLOW_API_KEY = "sk-your-api-key"
 dsh web
 ```
 
-For a persistent setting, create `.env` in the DSH user directory: `%USERPROFILE%\.dsh\.env` on Windows, or `$DSH_HOME/.env` when `DSH_HOME` is set:
+关闭该终端后，变量会失效。
+
+### 持久配置：DSH 用户环境文件
+
+可以创建 DSH 用户目录下的 `.env`。默认位置是 Windows 的 `%USERPROFILE%\.dsh\.env`（如果设置了 `DSH_HOME`，则使用 `$DSH_HOME/.env`）：
 
 ```dotenv
 SILICONFLOW_API_KEY=sk-your-api-key
 ```
 
-You may also put `.env` in the directory from which you run `dsh web`. Restart DSH after changing it. Never edit the npm installation directory or files under `node_modules`, and never commit a real key to GitHub.
+也可以在执行 `dsh web` 的当前目录创建 `.env`。DSH 凭据服务会读取这些环境层，插件在每次新建语音连接时通过凭据服务解析 `SILICONFLOW_API_KEY`。无需进入 npm 安装目录，也不要修改 `node_modules` 中的文件。
+
+如果同时设置了系统环境变量、DSH 凭据库和 `.env`，已经继承的环境变量优先，其次是 DSH 凭据库。修改 `.env` 后请重启 `dsh web`，因为环境在进程启动时读取一次。
+
+## 安装后怎么使用
 
-## First use
+1. 运行 `dsh web` 并打开 DSH Web UI。
+2. 新建或选择一个会话。
+3. 点击麦克风按钮并允许浏览器权限。
+4. 直接说话；连续静音约 1.5 秒后，当前语句会提交给云端识别。也可以长按麦克风约 400 毫秒按住说话，松手后只提交这一段；未连接时长按会在提交后保持静音，以便接收语音回复。
+5. 普通聊天由前台处理，需要读写项目或运行工具的工作会交给后台 Agent。
 
-1. Run `dsh web` and open the DSH Web UI.
-2. Create or select a session, click the microphone, and grant browser permission.
-3. Speak naturally. About 1.5 seconds of continuous silence submits an utterance.
-4. Ordinary conversation is answered in the frontend; work that needs project tools is delegated to the background Agent.
+语音会话可以被打断、断线重连和恢复历史。每个语音会话会持续绑定自己的后台 Agent Session；上下文达到轮换阈值时，插件会为后续任务创建新的子会话，但仍归属于同一语音会话。
 
-Each Voice Session keeps its own background Agent Session binding. When the context rotation threshold is reached, later tasks automatically use a new child session that remains associated with the original Voice Session.
+## 更新
 
-## Update
+使用 npm 更新到最新版本：
 
 ```powershell
 dsh plugin --profile web add @flowingspring/dsh-voco
 ```
 
-You can also install a specific GitHub Release. Restart `dsh web` after updating.
+也可以改用指定的 GitHub Release `.tgz` 地址。更新后重启 `dsh web`。
 
-## Uninstall
+## 卸载
 
 ```powershell
 dsh plugin --profile web remove @flowingspring/dsh-voco
 ```
 
-Uninstalling does not delete DSH sessions or Voice history.
+卸载插件不会自动删除已经保存的 API Key。需要彻底清除时，从 `%USERPROFILE%\.dsh\.credentials.yaml`（设置了 `DSH_HOME` 时为 `$DSH_HOME/.credentials.yaml`）的 `refs` 下删除 `SILICONFLOW_API_KEY`，并同时清理系统环境变量或 `.env` 中的同名配置。
+
+卸载插件不会删除已经保存的 DSH 会话和语音历史；如需清理数据，请先确认对应数据目录后再手动处理。
+
+## 主要能力
+
+- SiliconFlow 免费模型 [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra) 云端语音转文字。
+- Edge TTS `zh-CN-XiaoxiaoNeural` 中文语音回复。
+- 语音、文字和后台 Agent 任务可以在同一 DSH 会话中协作。
+- 委派前即时播报确认语，完整报告保留在任务界面。
+- 页面切换、断线重连和 DSH 重启后恢复语音会话绑定。
+- 可选接入 `@flowingspring/dsh-workspace-memory`；语音主会话和每个完成的委派子任务都会进入同一个 Workspace 长期记忆范围。
+
+## 常见问题
+
+### 点击麦克风提示缺少 API Key
+
+确认启动 DSH 的进程能读到 `SILICONFLOW_API_KEY`。如果刚创建或修改了 `.env`，先停止旧的 DSH 进程，再重新运行 `dsh web`。
+
+### 浏览器没有声音或无法录音
+
+检查当前页面是否获得麦克风权限、系统输入设备是否正常，并确认使用的是 `dsh web` 提供的页面，而不是直接打开 HTML 文件。
+
+### 识别失败或等待时间较长
 
-It also leaves a saved API key in place. To remove the key completely, delete `SILICONFLOW_API_KEY` from `refs` in `%USERPROFILE%\.dsh\.credentials.yaml` (or `$DSH_HOME/.credentials.yaml` when configured), and remove the same name from the process environment or any `.env` file.
+语音识别需要访问硅基流动网络服务。请检查网络、API Key 有效期、账户额度，以及所选模型和 Provider 的响应延迟。
 
-## Features
+### 想调整静音和起音阈值
 
-- SiliconFlow's free [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra) cloud speech-to-text model.
-- Edge TTS `zh-CN-XiaoxiaoNeural` voice responses.
-- Interruption, navigation, reconnects, and restored history.
-- Immediate acknowledgement before delegation; full reports remain in the DSH task UI.
-- Optional `@flowingspring/dsh-workspace-memory` integration for both the source Voice Session and every completed delegated child task.
+高级参数位于插件 profile 的 `cordis.patch.yml`，包括 `silenceDurationMs`、`speechThreshold`、`minSpeechDurationMs` 和 `maxUtteranceMs`。普通用户通常不需要修改这些参数。
 
-## Troubleshooting
+## 可选 Workspace Memory
 
-- **Missing API key**: verify that `SILICONFLOW_API_KEY` is visible to the DSH process; restart `dsh web` after changing `.env`.
-- **Microphone unavailable**: check browser permission and the system input device, and make sure the page is served by `dsh web`.
-- **Recognition fails or is slow**: check network access, key validity, SiliconFlow quota, and model/provider latency.
+长期记忆不是 Voco 的必需依赖。需要时另外安装 `@flowingspring/dsh-workspace-memory`；只安装 Voco 也可以独立使用。安装 Memory 后，完成的委派任务会提交用户原始请求和最终可见结果，不会提交 reasoning、工具日志或注入上下文。Memory 插件的安装和配置请参阅其项目文档。
 
-## Links
+## 开发与反馈
 
-- [GitHub source and issues](https://github.com/lgquan/dsh-voco)
-- [npm package](https://www.npmjs.com/package/@flowingspring/dsh-voco)
+- 源码与问题反馈：[GitHub](https://github.com/lgquan/dsh-voco)
+- npm 包：[`@flowingspring/dsh-voco`](https://www.npmjs.com/package/@flowingspring/dsh-voco)
+- 架构说明：[`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
 
-## License
+## 许可证
 
 [MIT](LICENSE)

package/cordis.patch.yml

@@ -1,29 +1,29 @@
-# Voice interaction mode layered after dsh-base and dsh-web-app.
-- insert:
+# Voice interaction mode layered after dsh-base and dsh-web-app.
+- insert:
     - id: llm-tool-call-compat
       name: '@flowingspring/dsh-voco/llm-tool-call-compat'
 
     - id: voice
       name: '@flowingspring/dsh-voco/voice'
-      config:
-        provider: local
-
+      config:
+        provider: local
+
     - id: voice-local
       name: '@flowingspring/dsh-voco/voice-local'
-      config:
-        interactionMode: frontend-agent
-        inputSampleRate: 16000
-        outputSampleRate: 48000
-        ttsRate: '+20%'
-        silenceDurationMs: 1500
-        speechThreshold: 0.015
-        minSpeechDurationMs: 250
-        maxUtteranceMs: 60000
-
+      config:
+        interactionMode: frontend-agent
+        inputSampleRate: 16000
+        outputSampleRate: 48000
+        ttsRate: '+20%'
+        silenceDurationMs: 1500
+        speechThreshold: 0.015
+        minSpeechDurationMs: 250
+        maxUtteranceMs: 60000
+
     - id: voice-assistant
       name: '@flowingspring/dsh-voco/voice-assistant'
-      config:
-        maxPendingObservations: 64
+      config:
+        maxPendingObservations: 64
         restoreConversation: true
         memoryRecallTimeoutMs: 250
         maxRestoredUtterances: 24
@@ -32,16 +32,16 @@
         taskSessionRotationReserveTokens: 2048
         taskSessionHandoffMaxChars: 12000
         completedAnnouncement: 任务已完成。
-        failedAnnouncement: 任务失败了，请查看屏幕上的错误信息。
-        cancelledAnnouncement: 任务已取消。
-        interruptedAnnouncement: 上次任务因服务关闭而中断，没有自动重放。你可以告诉我是否继续。
-
+        failedAnnouncement: 任务失败了，请查看屏幕上的错误信息。
+        cancelledAnnouncement: 任务已取消。
+        interruptedAnnouncement: 上次任务因服务关闭而中断，没有自动重放。你可以告诉我是否继续。
+
     - id: voice-web
       name: '@flowingspring/dsh-voco/voice-web'
-      inject: [webRuntime]
-      config:
-        trustedHosts: !!js ctx.webRuntime.trustedHosts
-        maxAudioFrameBytes: 65536
-
+      inject: [webRuntime]
+      config:
+        trustedHosts: !!js ctx.webRuntime.trustedHosts
+        maxAudioFrameBytes: 65536
+
     - id: ui-voice
       name: '@flowingspring/dsh-voco'

package/package.json

@@ -1,7 +1,7 @@
-{
+{
   "name": "@flowingspring/dsh-voco",
   "description": "Persistent voice conversations for DSH with cloud speech recognition, Edge TTS, and background Agent delegation",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -15,65 +15,55 @@
   "bugs": {
     "url": "https://github.com/lgquan/dsh-voco/issues"
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lgquan/dsh-voco.git",
-    "directory": "packages/voice-app"
-  },
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
-  "exports": {
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lgquan/dsh-voco.git"
+  },
+  "type": "module",
+  "main": "packages/voice-app/lib/index.js",
+  "types": "packages/voice-app/lib/types/index.d.ts",
+  "exports": {
     ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
+      "types": "./packages/voice-app/lib/types/index.d.ts",
+      "default": "./packages/voice-app/lib/index.js"
     },
     "./client": {
-      "default": "./lib/client.js"
+      "default": "./packages/voice-app/lib/client.js"
     },
     "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
+      "types": "./packages/voice-app/lib/types/invariant.d.ts",
+      "default": "./packages/voice-app/lib/invariant.js"
     },
-    "./llm-tool-call-compat": "./lib/plugins/llm-tool-call-compat.js",
-    "./voice": "./lib/plugins/voice.js",
-    "./voice-local": "./lib/plugins/voice-local.js",
-    "./voice-assistant": "./lib/plugins/voice-assistant.js",
-    "./voice-web": "./lib/plugins/voice-web.js",
+    "./llm-tool-call-compat": "./packages/voice-app/lib/plugins/llm-tool-call-compat.js",
+    "./voice": "./packages/voice-app/lib/plugins/voice.js",
+    "./voice-local": "./packages/voice-app/lib/plugins/voice-local.js",
+    "./voice-assistant": "./packages/voice-app/lib/plugins/voice-assistant.js",
+    "./voice-web": "./packages/voice-app/lib/plugins/voice-web.js",
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json"
-  },
-  "files": [
-    "lib/index.js",
-    "lib/invariant.js",
-    "lib/client.js",
-    "lib/client.js.map",
-    "lib/plugins/*.js",
-    "cordis.patch.yml",
-    "lib/types/**/*.d.ts"
-  ],
-  "license": "MIT",
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-settings-plugins",
-        "@deepseek-ai/dsh-client-ui-conversation",
-        "@deepseek-ai/dsh-client-ui-layout",
-        "@deepseek-ai/dsh-client-ui-sidebar"
-      ],
-      "platform": "web"
-    }
   },
+  "packageManager": "pnpm@11.7.0",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b && pnpm --dir packages/voice-app exec tsdown",
+    "prepare": "pnpm run build",
+    "test": "vitest run",
+    "typecheck": "tsc -b"
+  },
+  "files": [
+    "cordis.patch.yml",
+    "packages/voice-app/lib/index.js",
+    "packages/voice-app/lib/invariant.js",
+    "packages/voice-app/lib/client.js",
+    "packages/voice-app/lib/client.js.map",
+    "packages/voice-app/lib/plugins/*.js",
+    "packages/voice-app/lib/types/**/*.d.ts"
+  ],
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
     "node-edge-tts": "1.2.10",
@@ -107,39 +97,30 @@
     "react": "^18.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-brand": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-layout": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-credentials": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.1",
-    "@deepseek-ai/dsh-workspace": "^0.1.1-rc.1",
-    "@flowingspring/dsh-client-ui-voice": "workspace:*",
-    "@flowingspring/dsh-llm-tool-call-compat": "workspace:*",
-    "@flowingspring/dsh-voice": "workspace:*",
-    "@flowingspring/dsh-voice-assistant": "workspace:*",
-    "@flowingspring/dsh-voice-local": "workspace:*",
-    "@flowingspring/dsh-voice-web": "workspace:*",
-    "@types/react": "~18.3.1",
-    "@types/ws": "^8.18.1",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0"
-  }
+    "@types/node": "^22.20.0",
+    "jsdom": "^30.0.1",
+    "lightningcss": "^1.32.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT"
 }

package/{lib → packages/voice-app/lib}/client.js

@@ -19,11 +19,11 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var VoiceControl_module_css_default = {
-			"voice-pulse": "TFZsua_voice-pulse",
-			"active": "TFZsua_active",
-			"controls": "TFZsua_controls",
 			"button": "TFZsua_button",
-			"interruptButton": "TFZsua_interruptButton"
+			"interruptButton": "TFZsua_interruptButton",
+			"controls": "TFZsua_controls",
+			"active": "TFZsua_active",
+			"voice-pulse": "TFZsua_voice-pulse"
 		};
 		//#endregion
 		//#region ../ui-voice/src/client/VoiceControl.tsx
@@ -222,23 +222,23 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var VoiceNodeViews_module_css_default = {
-			"taskDetails": "Kt2smW_taskDetails",
-			"taskUpdate": "Kt2smW_taskUpdate",
-			"utterance": "Kt2smW_utterance",
-			"miniWave": "Kt2smW_miniWave",
-			"voiceBadge": "Kt2smW_voiceBadge",
-			"taskCard": "Kt2smW_taskCard",
 			"taskTitle": "Kt2smW_taskTitle",
-			"taskChevron": "Kt2smW_taskChevron",
-			"bubble": "Kt2smW_bubble",
-			"taskDot": "Kt2smW_taskDot",
-			"taskInput": "Kt2smW_taskInput",
 			"taskStatus": "Kt2smW_taskStatus",
+			"taskUpdate": "Kt2smW_taskUpdate",
+			"taskDot": "Kt2smW_taskDot",
 			"taskSummary": "Kt2smW_taskSummary",
+			"taskCancel": "Kt2smW_taskCancel",
+			"taskActions": "Kt2smW_taskActions",
+			"voiceBadge": "Kt2smW_voiceBadge",
+			"taskInput": "Kt2smW_taskInput",
+			"bubble": "Kt2smW_bubble",
 			"taskLink": "Kt2smW_taskLink",
+			"taskDetails": "Kt2smW_taskDetails",
+			"taskCard": "Kt2smW_taskCard",
+			"miniWave": "Kt2smW_miniWave",
 			"meta": "Kt2smW_meta",
-			"taskCancel": "Kt2smW_taskCancel",
-			"taskActions": "Kt2smW_taskActions"
+			"utterance": "Kt2smW_utterance",
+			"taskChevron": "Kt2smW_taskChevron"
 		};
 		//#endregion
 		//#region ../ui-voice/src/client/VoiceNodeViews.tsx
@@ -377,10 +377,10 @@ window.__ModuleLoader__.load({
 		}
 		var VoiceOverlay_module_css_default = {
 			"root": "GPPB2G_root",
-			"status": "GPPB2G_status",
-			"wave": "GPPB2G_wave",
 			"voice-wave": "GPPB2G_voice-wave",
-			"stop": "GPPB2G_stop"
+			"wave": "GPPB2G_wave",
+			"stop": "GPPB2G_stop",
+			"status": "GPPB2G_status"
 		};
 		//#endregion
 		//#region ../ui-voice/src/client/VoiceOverlay.tsx
@@ -439,8 +439,8 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var VoiceSessionMarkers_module_css_default = {
-			"marker": "_0brRca_marker",
-			"slot": "_0brRca_slot"
+			"slot": "_0brRca_slot",
+			"marker": "_0brRca_marker"
 		};
 		//#endregion
 		//#region ../ui-voice/src/client/VoiceSessionMarkers.tsx
@@ -550,30 +550,30 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var VocoSettingsCard_module_css_default = {
-			"readOnly": "G5LlXq_readOnly",
-			"body": "G5LlXq_body",
-			"fieldHead": "G5LlXq_fieldHead",
+			"headText": "G5LlXq_headText",
+			"providerDetail": "G5LlXq_providerDetail",
+			"badgeMuted": "G5LlXq_badgeMuted",
 			"failed": "G5LlXq_failed",
+			"providerDetails": "G5LlXq_providerDetails",
 			"chevron": "G5LlXq_chevron",
+			"card": "G5LlXq_card",
 			"pending": "G5LlXq_pending",
-			"discard": "G5LlXq_discard",
-			"name": "G5LlXq_name",
-			"footer": "G5LlXq_footer",
-			"cardOpen": "G5LlXq_cardOpen",
+			"label": "G5LlXq_label",
 			"save": "G5LlXq_save",
-			"headText": "G5LlXq_headText",
-			"chevronOpen": "G5LlXq_chevronOpen",
-			"header": "G5LlXq_header",
-			"badgeMuted": "G5LlXq_badgeMuted",
+			"cardOpen": "G5LlXq_cardOpen",
+			"body": "G5LlXq_body",
+			"readOnly": "G5LlXq_readOnly",
 			"hint": "G5LlXq_hint",
-			"providerDetail": "G5LlXq_providerDetail",
-			"badge": "G5LlXq_badge",
-			"input": "G5LlXq_input",
-			"providerDetails": "G5LlXq_providerDetails",
-			"field": "G5LlXq_field",
-			"card": "G5LlXq_card",
 			"description": "G5LlXq_description",
-			"label": "G5LlXq_label"
+			"footer": "G5LlXq_footer",
+			"header": "G5LlXq_header",
+			"chevronOpen": "G5LlXq_chevronOpen",
+			"input": "G5LlXq_input",
+			"discard": "G5LlXq_discard",
+			"fieldHead": "G5LlXq_fieldHead",
+			"name": "G5LlXq_name",
+			"badge": "G5LlXq_badge",
+			"field": "G5LlXq_field"
 		};
 		//#endregion
 		//#region ../ui-voice/src/client/VocoSettingsCard.tsx

package/README.i18n.yaml

@@ -1,6 +0,0 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
-#   pnpm run verify-translation-pairing --write packages/bundle/voice-app/README.md
-README.md: 3582129953c75938c6c08caa11526d5179f0631f
-README.zh.md: f7253637cf50cf5b9677bee512e45fdadd8cc712

package/README.zh.md

@@ -1,108 +0,0 @@
-# `@flowingspring/dsh-voco`
-
-[![npm version](https://img.shields.io/npm/v/@flowingspring/dsh-voco.svg)](https://www.npmjs.com/package/@flowingspring/dsh-voco)
-[![许可证](https://img.shields.io/npm/l/@flowingspring/dsh-voco.svg)](https://github.com/lgquan/dsh-voco/blob/master/LICENSE)
-
-[English](README.md) | 中文
-
-面向 DeepSeek Harness（DSH）Web UI 的可恢复、可打断语音对话插件。它使用硅基流动云端语音识别和 Edge TTS，并把需要工具的工作委派给后台 Agent。
-
-## 安装
-
-### npm 安装（推荐）
-
-先安装 DSH CLI：
-
-```powershell
-npm install -g @deepseek-ai/dsh
-```
-
-将插件加入 Web profile 并启动：
-
-```powershell
-dsh plugin --profile web add @flowingspring/dsh-voco
-dsh web
-```
-
-### GitHub Release 安装
-
-GitHub Release 提供已经构建好的插件包，不需要下载源码或安装 pnpm：
-
-```powershell
-dsh plugin --profile web add https://github.com/lgquan/dsh-voco/releases/download/v0.3.11/flowingspring-dsh-voco-0.3.11.tgz
-```
-
-Release 页面：[v0.3.11](https://github.com/lgquan/dsh-voco/releases/tag/v0.3.11)
-
-## 配置 API Key
-
-语音识别需要你自己的[硅基流动 API Key](https://siliconflow.cn/)，配置名只有一个：`SILICONFLOW_API_KEY`。语音转文字使用硅基流动当前免费的 [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra)；免费状态和使用规则以模型页面为准。Edge TTS 不需要 API Key。
-
-推荐在 DSH 中打开“设置 → 插件 → 插件配置”，展开“语音助手（Voco）”，填写 API Key 并保存。密钥保存在 DSH 凭据库中，不写入普通设置文件；保存后重新开启或重连语音即可生效。
-
-环境变量和 `.env` 仍作为兼容与自动化配置方式保留。
-
-在启动 DSH 的同一个 PowerShell 中临时设置：
-
-```powershell
-$env:SILICONFLOW_API_KEY = "sk-your-api-key"
-dsh web
-```
-
-要持久保存，可创建 DSH 用户环境文件 `%USERPROFILE%\.dsh\.env`（设置了 `DSH_HOME` 时使用 `$DSH_HOME/.env`）：
-
-```dotenv
-SILICONFLOW_API_KEY=sk-your-api-key
-```
-
-也可在运行 `dsh web` 的当前目录放置 `.env`。修改后重启 DSH；不要修改 npm 安装目录或 `node_modules` 中的文件，也不要把真实密钥提交到 GitHub。
-
-## 首次使用
-
-1. 运行 `dsh web` 并打开 DSH Web UI。
-2. 新建或选择会话，点击麦克风并允许浏览器权限。
-3. 直接说话，连续静音约 1.5 秒后提交一句话；也可以长按麦克风约 400 毫秒按住说话，松手后提交这一段。
-4. 普通聊天由前台回答，需要项目工具的工作会委派给后台 Agent。
-
-每个语音会话持续绑定自己的后台 Agent Session。上下文达到轮换阈值后，后续任务会自动进入新的子会话，但仍与原语音会话绑定。
-
-## 更新
-
-```powershell
-dsh plugin --profile web add @flowingspring/dsh-voco
-```
-
-也可以安装指定的 GitHub Release。更新后重启 `dsh web`。
-
-## 卸载
-
-```powershell
-dsh plugin --profile web remove @flowingspring/dsh-voco
-```
-
-卸载不会自动删除 DSH 会话或语音历史。
-
-卸载也不会删除已经保存的 API Key。需要彻底清除时，从 `%USERPROFILE%\.dsh\.credentials.yaml`（设置了 `DSH_HOME` 时为 `$DSH_HOME/.credentials.yaml`）的 `refs` 下删除 `SILICONFLOW_API_KEY`，并同时清理系统环境变量或 `.env` 中的同名配置。
-
-## 功能
-
-- SiliconFlow 免费模型 [`XingChenAGI/XingChenASR-V3.2-Ultra`](https://cloud.siliconflow.cn/models?target=XingChenAGI/XingChenASR-V3.2-Ultra) 云端语音转文字。
-- Edge TTS `zh-CN-XiaoxiaoNeural` 语音回复。
-- 语音打断、页面切换、断线重连和历史恢复。
-- 委派前即时确认，完整报告保留在 DSH 任务界面。
-- 可选接入 `@flowingspring/dsh-workspace-memory`，让语音主会话和每个完成的委派子任务共享同一 Workspace 长期记忆范围。
-
-## 排查
-
-- **缺少 API Key**：确认 `SILICONFLOW_API_KEY` 在启动 DSH 的进程中可见；修改 `.env` 后重启 `dsh web`。
-- **无法录音**：检查浏览器麦克风权限和系统输入设备，并确认页面来自 `dsh web`。
-- **识别失败或较慢**：检查网络、Key 有效期、硅基流动账户额度及模型/Provider 延迟。
-
-## 链接
-
-- [GitHub 源码与问题反馈](https://github.com/lgquan/dsh-voco)
-- [npm 包](https://www.npmjs.com/package/@flowingspring/dsh-voco)
-
-## 许可证
-
-[MIT](LICENSE)