dsh-asr-plugin

dsh-asr-plugin

English | [简体中文](README.zh-CN.md)

[Project site](https://huliux.github.io/dsh-asr-plugin/) ·

[Getting started](https://huliux.github.io/dsh-asr-plugin/start.html)

Unofficial local meeting transcription plugin for DeepSeek Harness (DSH) on Apple Silicon macOS.

The plugin imports WAV, M4A and MP3 files, records microphone and system audio,

and produces transcripts with timestamps and speaker labels. Meetings can be

referenced explicitly in DSH messages for reading and export.

This example uses a fictional, speech-synthesized meeting. While recording

continues, an @ reference lets the configured DeepSeek model read the live draft

and generate an interim summary. The summary is a user-requested snapshot and can

change as the draft evolves. See the [workflow screenshots](assets/screenshots/README.md)

for the full example and environment details.

[Official community showcase](https://github.com/deepseek-ai/deepseek-harness/discussions/9125).

Compatibility

| Component | Requirement |

| --- | --- |

| Host | DSH 0.2.0-rc.2, 0.2.1-rc.2, 0.2.1-rc.3, 0.2.1-rc.5, or the 0.2.2 series from rc.1 |

| Runtime | Node.js 24 |

| Platform | macOS, Apple Silicon (darwin / arm64) |

| Microphone API | macOS 13.5 or later |

| System audio and dual-track APIs | macOS 14.2 or later |

These macOS versions specify API availability; they are not a tested OS matrix.

DSH desktop and Web modes both process audio on the Mac running DSH.

Windows, Linux and Intel Macs are unsupported.

Installation

Install @huliux/dsh-asr-plugin from the DSH Plugins page. Web profiles also

support the CLI:

dsh plugin --profile web add --ignore-scripts @huliux/dsh-asr-plugin@0.1.6

For DSH 0.2.2-rc.1 and later releases in the 0.2.2 series, use plugin 0.1.6.

In the desktop Plugins page,

choose Add plugin and enter @huliux/dsh-asr-plugin@0.1.6; Web users can

rerun the command above. Restart DSH if requested. Supported hosts load this

version without a compatibility exemption. If the desktop installer reports

that the package is already installed, download the versioned .tgz and

SHA256SUMS from [GitHub Releases](https://github.com/huliux/dsh-asr-plugin/releases/tag/v0.1.6),

verify the checksum, then enter the archive's absolute path in Add plugin.

This update route preserves the existing plugin configuration and meeting data.

The package includes native add-ons and an ad-hoc signed recording Helper.

The Helper is not notarized; macOS may require permission or security approval

at installation and after updates. Keep system security protections enabled.

Desktop and Web profiles share the default meeting store. Run one plugin host

per data directory. Preserve meeting and model data when replacing a package.

For package verification, local archive installation and release channels, see

[distribution](docs/distribution.md). Source downloads require the complete

[source build](docs/development.md) before recording. Report installation problems

through [GitHub Issues](https://github.com/huliux/dsh-asr-plugin/issues), including

the plugin, DSH, Node.js and macOS versions without meeting data or credentials.

Model preparation

In plugin settings, download the base models (approximately 278 MiB).

Optional punctuation models require approximately 274 MiB and apply automatically

to new recordings, imports and retranscriptions after verified installation.

Existing tasks and transcripts retain their processing mode. A damaged installed

punctuation pack must be repaired before starting new tasks.

Models are downloaded from pinned upstream revisions and verified by size and

SHA-256 before installation. Weights are excluded from Git, npm and GitHub Releases.

Enabling the plugin does not initiate a model download. Downloads support

cancellation and retry; complete verified files can be reused after failure.