语音与文档助手 lishize20040802-rgb/useful-dsh-plugins

useful-dsh-plugins

DeepSeek Harness 的社区插件集合，与 DeepSeek 官方无隶属关系。需要 Node.js 24 或更新版本；本地已验证环境为 Windows、DSH 0.1.5-rc.2 和 Node.js 24.18。DSH 仍在开发预览阶段，升级本体后需要重新核对兼容性。

| 插件 | 功能 |
| 语音输入 | 按住录音，使用本机 SenseVoiceSmall 识别；浏览器支持时关闭音频处理。 |
| 上传按钮 | 通过 DSH 输入与文件服务添加附件。 |
| 图像读取 | 图片输入和调用已配置模型服务的 vision 工具。 |
| 文档伴侣 | 文档展示、提取和搜索。 |
| 插件管理器 | 管理当前 profile 中的第三方插件，不管理官方本体插件。 |

插件功能

语音输入：把口述内容变成输入框草稿

- 按住输入框的麦克风按钮或配置的快捷键说话，松开后识别文字并追加到草稿；可以修改后再发送。
- 使用本机 CPU 运行 SenseVoiceSmall，支持中文、英文、日文、韩文和粤语。首次下载模型与引擎后，可离线识别，不需要云端语音识别账号。

上传按钮：给对话添加文件附件

- 点击输入框工具栏的上传按钮，选择一个或多个文件，以附件卡片预览，不打断正在编辑的文字；发送失败时保留卡片，便于重试。单文件默认上限为 64 MiB，可配置。
- 支持发送前撤销附件、相同内容去重，以及在聊天记录中点击附件打开文件。上传负责传递文件，读取文档内容可配合文档伴读插件。

图像读取：让 agent 看图并分析图片

- 在对话中粘贴图片时自动保存本地副本，同时保留消息中的原图；支持 PNG、JPEG、WebP、GIF，每次最多 10 张。
- 提供独立的 vision 工具，可按图片路径和问题调用已配置的视觉模型，适合截图分析、图片文字识别和图表解释。此功能使用模型服务，主对话模型也需要支持图片输入。

文档伴读：边看文档，边向 agent 提问

- 点击输入框工具栏的书本按钮，在聊天旁边打开阅读面板。支持 PDF、DOCX、XLSX、CSV、TXT、MD，以及连续滚动、单页阅读和调整面板宽度。
- 当前阅读位置会同步给 agent，可围绕当前页提问、读取指定页或块、检索已提取文字、跳转位置和切换文档。默认使用视觉模型读取 PDF 页面，需要配置可用的模型服务。

插件管理器：管理第三方插件及 DSH 更新

- 在 设置 → 插件 → 管理 查看第三方插件的版本、运行状态和数据位置，启用、停用或恢复由管理器停用的插件；宿主与插件支持时可即时生效。
- 为受支持的 npm 来源插件检查更新和重装；本套插件通过统一安装命令更新。另提供标准 npm 全局安装的 DSH 本体更新 入口。官方插件不纳入普通插件启停管理，替换包代码或升级本体后仍需重启。

Rigor 4 用于记录需求、计划、执行证据、子任务和独立审阅，帮助核对 agent 的完成声明。它使用独立仓库和安装流程，不包含在上述五个插件的集合安装中。

安装与卸载

已安装 DSH 和 pnpm 后，执行一条命令。Windows 上替换或卸载包前先关闭 DSH，避免原生依赖文件被占用；完成后运行 dsh web。

npx --yes useful-dsh-plugins@0.5.1 setup

同一份安装器也可直接从公开的 GitHub Release 获取：

npx --yes --package=https://github.com/lishize20040802-rgb/useful-dsh-plugins/releases/download/v0.5.1/useful-dsh-plugins-0.5.1.tgz useful-dsh-plugins setup

可先使用 setup --preview 查看计划。安装器校验发布包摘要，将压缩包和解压后的插件统一收录到 /third-party/，备份 profile 清单，再调用官方 DSH CLI 注册五个插件。DSH 仍在 profiles//node_modules 内进行原生依赖解析，不修改本体安装。再次运行对应版本命令可修复或更新整套插件；已有自定义数据路径会保留。

/
third-party/
archives/ 下载并校验的插件安装包 packages/ 按版本保存的解压插件 sources/ 可选的开发源码 data/ 语音引擎、模型和管理器恢复记录 backups/ 本地安装恢复记录 profiles/web/ DSH 原生插件注册与运行依赖

整套卸载：npx --yes useful-dsh-plugins@0.5.1 uninstall，保留个人数据。支持 --profile、--dsh-home、--dsh-package、--store-dir。迁移时移除旧聚合包注册，避免重复加载；新的 npm 包是无依赖安装器。

单独安装时，将安装包放入相同第三方目录，再执行下面的原生命令。

从 Releases 下载插件 .tgz 安装包，使用官方命令安装：

dsh plugin --profile web add ./dsh-plugin-voice-input-0.3.0.tgz
dsh web

卸载：

dsh plugin --profile web remove dsh-plugin-voice-input

其他插件替换对应包名即可。DSH 根据包中的 dsh.bundle 自动注册和移除插件。安装、更新、删除包文件后重启 DSH；临时启用/停用是另一种操作，其即时生效条件见管理器说明。

Windows 可在仓库目录执行 ./install.ps1 -Preview 查看全部五个插件的操作，执行 ./install.ps1 安装，或 ./install.ps1 -Uninstall 卸载。支持 -Profile 、-StoreDir ，内部调用同一套官方命令。卸载代码保留文档、附件、配置和已下载模型。

npm 安装器与 GitHub 安装包使用相同的内部目录布局，Windows 包装脚本也调用同一安装器。

本地语音模型

模型发布页 包含 SenseVoiceSmall INT8 ONNX 权重（239,233,841 字节）、词表、上游模型许可和 SHA256 校验值。插件首次准备环境时下载，之后在本机识别。模型目录独立于 DSH 安装目录，升级本体不会删除模型。来源和许可说明。

自动安装推理引擎目前支持 Windows x64；其他平台需提供兼容的 sherpa-onnx 程序和路径，尚未验证。

新安装默认使用 /third-party/data/voice-input；兼容已有旧模型目录及显式绝对路径。插件配置中的相对路径以 DSH 数据目录为基准，不随终端启动位置变化；插件自带资源相对于插件自身目录定位。

开发和升级 DSH

标准 npm 全局安装的 DSH 可以在 设置 → 插件 → 管理 → DSH 本体更新 中直接更新。管理器检查官方版本、保存旧版宿主安装包，在界面确认后执行更新；完成后重启 DSH。普通第三方插件操作仍排除所有官方模块。支持的安装方式及恢复范围见管理器说明。

先安装仓库根目录开发依赖，再在各插件目录执行 npm install --legacy-peer-deps 安装开发依赖。根目录执行 npm run build、npm test、npm run check:release，最后执行 npm run pack:plugins。安装包输出到 artifacts/，包含构建后的 JavaScript。DSH SDK 由宿主运行时提供，不复制进插件。文档测试样本从固定内容生成，仓库不包含个人文件或录音。

本地开发可通过 dsh plugin --profile web add link:./dsh-upload-button 链接已构建的插件；修改源码后重新构建。即使 profile patch 支持实时重载，包代码、浏览器 bundle 和宿主升级仍可能需要重启 DSH 并刷新网页。

升级前在本地备份 profile 清单和插件安装包，在独立 profile 验证新宿主，运行插件检查。只有取得验证证据后才更新开发 SDK 版本与 testedDSHVersions。插件使用公开包导出和 profile bundle，不修改官方安装源码。详见兼容性与生命周期。

隐私与许可证

插件代码使用 MIT；模型权重和下载的推理引擎遵守各自上游许可。语音识别在本机完成；图片处理会使用用户配置的模型服务，发送的图片或文档内容受相应服务的数据处理规则约束。不要提交个人配置、凭证、会话、附件、录音。发布检查仅输出可疑文件位置，不打印秘密内容；它需要配合代码复核，不能证明不存在任何形式的秘密。