前言¶
在 DSH 里做会议、访谈或语音笔记相关的工作流时，常见做法是录完再在电脑上整理：要么用本机麦克风重录，要么手动拷贝录音文件再上传。若日常已经用实体 BLE 录音卡采集，更自然的路径是「卡上录完 → 在对话里选文件 → 导入 Host 本地 → 可选转写与归档」，而不是绕开硬件另开一条链路。dsh-recorder-card 面向这类场景：在 DSH Host 上通过蓝牙拉取兼容录音卡上的音频，支持按需导入、本地归档校验，以及可选的语音识别（含 DSH 侧识别器或云 ASR）。插件由 SynSwarm 维护，归类为模型推理相关能力；当前为第三方开发预览版（package.json 标注 0.6.0）。
这是什么¶
dsh-recorder-card 是 DeepSeek Harness 插件，把物理 BLE 录音卡上的录音带入 DSH 工作流：在对话中选录音、经 BLE 导入、可选转写并写入带指纹关联的 Markdown 归档。实现遵循上游 AI recorder card open protocol；具体卡片与固件是否兼容需自行核实，产品名相同并不保证可用。
音频路径为：录音卡 → BLE → Host bundled Python CLI → 本地音频 → 可选 transcript 与归档。连接图标与八个 Agent 工具共用持久化 Host 服务，不依赖 Web Bluetooth，也无需单独 checkout 上游仓库。
核心功能¶
以下能力均来自项目 README 与发布说明，「已实现」指代码存在，部分硬件与长录音场景仍标注待验证。
连接与设备
- 点击录音卡图标或让 Agent 调用
recorder_connect连接设备；唯一设备会自动记住，多候选时需选择。 - 图标上下文菜单可切换设备；也可对
recorder_connect传空地址重新扫描。高级场景可用deviceAddress配置作为兜底。
列表与导入
- 通过
recorder_list列出卡上录音；0.5.0 起支持recorder_import({ "filename": "列表中的精确文件名" })，省略filename时导入列表第一项。默认不开启转写；多条录音需顺序调用，遇传输错误应停止。 - 导入时做 PCM 完整性检查，不覆盖已有音频；录音保留在卡上。
- 音频默认落在 Host 的
~/.dsh-recorder-card/archive/audio/，应使用工具返回的绝对路径。
转写与归档
- 转写与导入分离调用。优先使用已配置的 DSH 识别器；云回落（如 Doubao ASR）需显式转写意图并配置凭证。仅扫描与导入不需要 ASR 凭证。
- 简介中提到的 hash 校验本地归档、可选 SenseVoice 转写与 README 中「fingerprint-linked Markdown archive」一致，具体字段见项目文档。
Agent 工具与诊断
- 注册八个
recorder_*设备工具，与连接图标共享 Host 服务。 - 0.5.0 起传输诊断（阶段耗时、帧/字节计数等）写入
dataDir/recorder-diagnostics.json，不含音频、文件名或设备标识；中断时区分RECORDER_DEVICE_DISCONNECTED与RECORDER_TRANSFER_INTERRUPTED，需检查设备后从头重试该文件（不支持断点续传）。
环境要求
- DSH Host：Python 3.11+、蓝牙硬件与权限；若
python不在 DSH PATH，需在插件python字段配置解释器绝对路径。 - 远程 Host 使用远端机器自己的蓝牙；卡片与 Host 需在同一可连接范围内。
安装与启用¶
官方安装方式（面向 0.4.0 及以后；插件内已 bundled 固定版本 CLI，无需 repoRoot 或 git clone）：
dsh plugin add dsh-recorder-card
python -m pip install bleak requests
也可在安装目录用同一解释器执行：
python -m pip install -r vendor/upstream/tools/requirements.txt
依赖检查（无需蓝牙）：
python -B runtime/recorder_cli.py --check-deps
若 DSH/pnpm 配置了 minimumReleaseAge=1440，新版本可能在发布后 24 小时内不可用，需等待而非关闭该策略。升级前建议备份当前 profile 的 cordis.patch.yml 与 package.json，升级后核对自定义项与所选模型、语音服务。
典型用法¶
- 唤醒录音卡并断开其他蓝牙客户端。点击界面录音图标，或在对话中请 Agent 调用
recorder_connect。 - 在对话中请 Agent 调用
recorder_list，从返回列表中选定授权使用的文件名。 - 调用
recorder_import，例如指定精确文件名（0.5.0+）：
recorder_import({ "filename": "exact name from list" })
省略 filename 则导入第一项。使用工具返回的本地音频绝对路径进行后续分析或单独请求转写。
4. 需要换设备时，用图标菜单或 recorder_connect 空地址扫描；断开连接也可在对话中说明或由 Agent 调用相应工具。
连接清理失败时，图标会保留「未确认释放」类警告；有待处理设备任务时会先失败再访问 BLE，应检查卡片后再显式重试。仅进程断开不能证明设备侧已正确释放。
适用场景与注意¶
适合谁
- 已用兼容 BLE 录音卡做会议、访谈、语音笔记，希望在 DSH 对话里点选导入、本地归档并可选转写的人。
- 采集在卡片上完成，本插件不要求通过电脑麦克风录音。
务必注意
- 插件以当前 DSH 进程权限在 Host 上运行，会访问蓝牙与本地目录；安装前应阅读 GitHub 仓库 源码与 MIT 许可证，并确认卡片协议兼容。
- 项目自述为第三方开发预览：短测试录音已在真实 DSH 导入与音频检查中通过；非首条、长录音、中断恢复与远端录音控制等仍不完全验证。云 ASR 上传音频需明确转写意图。
- 社区目录页 SkillHub - dsh-recorder-card 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文介绍的是社区插件之一。
结尾¶
dsh-recorder-card 把录音卡 BLE 导入、本地归档与可选转写收进 DSH 同一套对话与 Agent 工具里，适合已有硬件、希望少手工拷文件的用户。细节、架构与验收记录见仓库 README、architecture 与 import-recovery。
- 目录页：https://www.skillhub.cn/plugins/SynSwarm/dsh-recorder-card
- GitHub：https://github.com/SynSwarm/dsh-recorder-card
