npm - dsh-recorder-card - Versions diffs - 0.1.0 → 0.1.1 - Mend

dsh-recorder-card 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +97 -95
package/README.zh.md +97 -95
package/client.js +3 -0
package/package.json +14 -1
package/vendor/LICENSE +21 -0
package/vendor/recorder-protocol.js +2 -0

package/README.md CHANGED Viewed

@@ -1,95 +1,97 @@
-# dsh-recorder-card
-[中文](README.zh.md) · [Contributing](CONTRIBUTING.md) · [Roadmap](ROADMAP.md) · [Architecture](docs/architecture.md) · [Changelog](CHANGELOG.md)
-**`dsh-recorder-card`** is a third-party **DeepSeek Harness (DSH)** plugin under development for connecting **AI recorder cards** over BLE.
-> **Development preview:** the repository contains a plugin skeleton and browser card implementation. Import, transcription, and archive integration are not complete. DSH compatibility and hardware behavior still need verification. The manifest version is `0.1.0`; it is not evidence of a published release.
-## Purpose
-The intended workflow is to record meetings, interviews, or notes on a dedicated device, transfer audio over BLE, and archive it with a transcript in DSH. Hardware recording does not use the computer's microphone.
-The implementation follows the [upstream AI recorder card protocol](https://github.com/nextproto1024/ai-recorder-card-open-protocol). Support for a particular card or firmware must be verified; a shared product name alone does not establish compatibility.
-## Current status
-“Implemented” means code exists, not that it has passed DSH or hardware testing. No verified compatibility baseline is recorded yet.
-| Capability | Implementation | Verification / remaining work |
-|---|---|---|
-| Bundle manifest and Skill provider | Implemented; local contract/package checks pass | Verify loading and Skill discovery in DSH |
-| Browser connection, battery, recording state and controls | Implemented | Verify in the target browser with a real card |
-| Browser file listing | Implemented | Verify multi-frame lists and completion handling |
-| Browser file import | Placeholder | Button only displays a message; transfer and Host persistence are missing |
-| Host Python CLI calls | Wrapper implemented | CLI is not bundled; configuration and execution need verification |
-| `recorder_*` Agent tools and Client–Host communication | Not implemented | Registration and transport APIs need confirmation |
-| Transcription providers and archive integrity | Planned | No complete plugin workflow or verified default provider |
-See [ROADMAP.md](ROADMAP.md) for acceptance criteria.
-Local regressions cover notification parsing, session/list cleanup, incomplete-list timeout warnings, and serialized session writes using simulated hooks and BLE. Run `npm test`; see [local checks](CONTRIBUTING.md#local-checks-without-hardware) for coverage and limits. These checks do not replace DSH or real-device verification.
-After a list timeout, write failure, or unconfirmed end response, disconnect and reconnect before reading the list again. Same-session retries are blocked to avoid treating late responses as a new complete list. Received entries remain explicitly unconfirmed; status and recording controls remain available.
-## Installation status
-There is currently no verified end-user installation procedure documented here.
-- **Local development:** follow the candidate DSH loading procedure in [CONTRIBUTING.md](CONTRIBUTING.md), then record the exact runtime version and results.
-- **npm:** the manifest now sets `private: false`, limits package contents, and declares DSH peer versions. Local package preflight passes; publication, registry availability, and end-user installation have not been verified.
-- **GitHub / Web UI installation:** bundle installation and activation have not been verified. User instructions will follow release acceptance.
-## Development requirements
-- A DSH environment exposing plugin development capabilities; supported versions/profiles are not established yet.
-- For browser experiments: Chrome or Edge with `navigator.bluetooth` available, Bluetooth access, and a protocol-compatible card. Record the actual browser/OS combination tested.
-- Node.js for syntax checks; the minimum version remains to be established with the target DSH runtime.
-- For Host CLI experiments only: a separate upstream checkout, Python, and that checkout's declared dependencies. This repository contains no `tools/` directory or Python requirements file.
-## First development check
-1. Follow the local checks and candidate DSH loading procedure in [CONTRIBUTING.md](CONTRIBUTING.md).
-2. Verify that the card renders and the bundled Skill is discoverable.
-3. With a real device, verify connection, status, recording controls, and file listing separately.
-4. Record failures and environment details. Import and transcription are future acceptance steps, not working quick-start commands.
-## Architecture
-| Component | File | Current role |
-|---|---|---|
-| Host | [index.js](index.js) | Skill registration and internal Python CLI wrapper; tools/transport pending |
-| Client | [client.js](client.js) | React card using browser BLE; import placeholder |
-| Skill | [skill/SKILL.md](skill/SKILL.md) | Capability checks, resource locations, and device constraints |
-| Protocol | [vendor/recorder-protocol.js](vendor/recorder-protocol.js) | CRC, frames, parsers, and command primitives |
-| Loader | [cordis.patch.yml](cordis.patch.yml) | Plugin loader entry |
-See [architecture and open decisions](docs/architecture.md) for BLE ownership, external CLI configuration, and planned data flow.
-## Transcription plan
-The selected default integration target is DSH speech-to-text; Doubao, an OpenAI-compatible ASR endpoint, and local SenseVoice ONNX are optional future backends. These are not supported provider options today. The Host method only invokes an external script; it does not implement the DSH backend, provider selection, or a `transcriptionProvider` setting. M4 implements and validates the selected default before expanding support.
-## Data plan
-```text
-archive/audio/    # intended destination for imported audio
-archive/corpus/   # intended destination for transcript Markdown
-```
-The intended relationship uses `audio_sha256` to associate transcripts with audio and prevent unsafe reuse. This repository does not yet implement or validate that storage contract. Relative output paths in the Host wrapper resolve under its configured `repoRoot`, which may be an external checkout.
-Keep audio, transcripts, device addresses, and credentials out of version control. See [.gitignore](.gitignore); check external checkouts' ignore rules too.
-## Contributing
-For AI-assisted collaboration, start with [AGENTS.md](AGENTS.md) and the [developer](docs/roles/open-source-developer.md) or [QA](docs/roles/qa.md) role. These documents are shared across tools; `.cursor/rules/` is an optional Cursor adapter. See [role setup](CONTRIBUTING.md#development-and-qa-roles) for explicit loading instructions when a tool does not discover the entry point automatically.
-Read [CONTRIBUTING.md](CONTRIBUTING.md). Keep this README and [README.zh.md](README.zh.md) aligned when behavior or status changes. Completed changes belong in [CHANGELOG.md](CHANGELOG.md); future work belongs in [ROADMAP.md](ROADMAP.md).
-## License and related projects
-[MIT](LICENSE) © 2026 SynSwarm DAO.
-- [AI recorder card open protocol](https://github.com/nextproto1024/ai-recorder-card-open-protocol): external protocol and CLI source.
-- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): intended host runtime.
+# dsh-recorder-card
+[中文](README.zh.md) · [Contributing](CONTRIBUTING.md) · [Roadmap](ROADMAP.md) · [Architecture](docs/architecture.md) · [Changelog](CHANGELOG.md)
+**`dsh-recorder-card`** is a third-party **DeepSeek Harness (DSH)** plugin under development for connecting **AI recorder cards** over BLE.
+> **Development preview:** the repository contains a plugin skeleton and browser card implementation. Import, transcription, and archive integration are not complete. DSH compatibility and hardware behavior still need verification. Published on npm as `dsh-recorder-card@0.1.0` (development preview).
+## Purpose
+The intended workflow is to record meetings, interviews, or notes on a dedicated device, transfer audio over BLE, and archive it with a transcript in DSH. Hardware recording does not use the computer's microphone.
+The implementation follows the [upstream AI recorder card protocol](https://github.com/nextproto1024/ai-recorder-card-open-protocol). Support for a particular card or firmware must be verified; a shared product name alone does not establish compatibility.
+## Current status
+“Implemented” means code exists, not that it has passed DSH or hardware testing. No verified compatibility baseline is recorded yet.
+| Capability | Implementation | Verification / remaining work |
+|---|---|---|
+| Bundle manifest and Skill provider | Implemented; local contract/package checks pass | Verify loading and Skill discovery in DSH |
+| Browser connection, battery, recording state and controls | Implemented | Verify in the target browser with a real card |
+| Browser file listing | Implemented | Verify multi-frame lists and completion handling |
+| Browser file import | Placeholder | Button only displays a message; transfer and Host persistence are missing |
+| Host Python CLI calls | Wrapper implemented | CLI is not bundled; configuration and execution need verification |
+| `recorder_*` Agent tools and Client–Host communication | Not implemented | Registration and transport APIs need confirmation |
+| Transcription providers and archive integrity | Planned | No complete plugin workflow or verified default provider |
+See [ROADMAP.md](ROADMAP.md) for acceptance criteria.
+Local regressions cover notification parsing, session/list cleanup, incomplete-list timeout warnings, and serialized session writes using simulated hooks and BLE. Run `npm test`; see [local checks](CONTRIBUTING.md#local-checks-without-hardware) for coverage and limits. These checks do not replace DSH or real-device verification.
+After a list timeout, write failure, or unconfirmed end response, disconnect and reconnect before reading the list again. Same-session retries are blocked to avoid treating late responses as a new complete list. Received entries remain explicitly unconfirmed; status and recording controls remain available.
+## Installation status
+There is currently no verified end-user installation procedure documented here.
+- **Local development:** follow the candidate DSH loading procedure in [CONTRIBUTING.md](CONTRIBUTING.md), then record the exact runtime version and results.
+- **npm:** published as `dsh-recorder-card@0.1.0`; install spec `dsh plugin add dsh-recorder-card`. End-user installation and activation in DSH have not been verified yet.
+- **GitHub / Web UI installation:** bundle installation and activation have not been verified. User instructions will follow release acceptance.
+## Development requirements
+- A DSH environment exposing plugin development capabilities; supported versions/profiles are not established yet.
+- For browser experiments: Chrome or Edge with `navigator.bluetooth` available, Bluetooth access, and a protocol-compatible card. Record the actual browser/OS combination tested.
+- Node.js for syntax checks; the minimum version remains to be established with the target DSH runtime.
+- For Host CLI experiments only: a separate upstream checkout, Python, and that checkout's declared dependencies. This repository contains no `tools/` directory or Python requirements file.
+## First development check
+1. Follow the local checks and candidate DSH loading procedure in [CONTRIBUTING.md](CONTRIBUTING.md).
+2. Verify that the card renders and the bundled Skill is discoverable.
+3. With a real device, verify connection, status, recording controls, and file listing separately.
+4. Record failures and environment details. Import and transcription are future acceptance steps, not working quick-start commands.
+## Architecture
+| Component | File | Current role |
+|---|---|---|
+| Host | [index.js](index.js) | Skill registration and internal Python CLI wrapper; tools/transport pending |
+| Client | [client.js](client.js) | React card using browser BLE; import placeholder |
+| Skill | [skill/SKILL.md](skill/SKILL.md) | Capability checks, resource locations, and device constraints |
+| Protocol | [vendor/recorder-protocol.js](vendor/recorder-protocol.js) | CRC, frames, parsers, and command primitives |
+| Loader | [cordis.patch.yml](cordis.patch.yml) | Plugin loader entry |
+See [architecture and open decisions](docs/architecture.md) for BLE ownership, external CLI configuration, and planned data flow.
+## Transcription plan
+The selected default integration target is DSH speech-to-text; Doubao, an OpenAI-compatible ASR endpoint, and local SenseVoice ONNX are optional future backends. These are not supported provider options today. The Host method only invokes an external script; it does not implement the DSH backend, provider selection, or a `transcriptionProvider` setting. M4 implements and validates the selected default before expanding support.
+## Data plan
+```text
+archive/audio/    # intended destination for imported audio
+archive/corpus/   # intended destination for transcript Markdown
+```
+The intended relationship uses `audio_sha256` to associate transcripts with audio and prevent unsafe reuse. This repository does not yet implement or validate that storage contract. Relative output paths in the Host wrapper resolve under its configured `repoRoot`, which may be an external checkout.
+Keep audio, transcripts, device addresses, and credentials out of version control. See [.gitignore](.gitignore); check external checkouts' ignore rules too.
+## Contributing
+For AI-assisted collaboration, start with [AGENTS.md](AGENTS.md) and the [developer](docs/roles/open-source-developer.md) or [QA](docs/roles/qa.md) role. These documents are shared across tools; `.cursor/rules/` is an optional Cursor adapter. See [role setup](CONTRIBUTING.md#development-and-qa-roles) for explicit loading instructions when a tool does not discover the entry point automatically.
+Read [CONTRIBUTING.md](CONTRIBUTING.md). Keep this README and [README.zh.md](README.zh.md) aligned when behavior or status changes. Completed changes belong in [CHANGELOG.md](CHANGELOG.md); future work belongs in [ROADMAP.md](ROADMAP.md).
+## License and related projects
+[MIT](LICENSE) © 2026 SynSwarm DAO.
+The vendored protocol and its inline copy in `client.js` include code from NextProto's AI recorder card open protocol, © 2026 NextProto, under the [upstream MIT license](vendor/LICENSE). This notice is included in the npm package.
+- [AI recorder card open protocol](https://github.com/nextproto1024/ai-recorder-card-open-protocol): external protocol and CLI source.
+- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): intended host runtime.

package/README.zh.md CHANGED Viewed

@@ -1,95 +1,97 @@
-# dsh-recorder-card
-[English](README.md) · [贡献指南](CONTRIBUTING.md) · [路线图](ROADMAP.md) · [架构](docs/architecture.md) · [更新记录](CHANGELOG.md)
-**`dsh-recorder-card`** 是一个开发中的第三方 **DeepSeek Harness (DSH)** 插件，用于通过 BLE 接入 **AI 录音卡**。
-> **开发预览：** 当前仓库包含插件骨架和浏览器卡片实现，导入、转写和归档尚未打通。DSH 兼容性及实机行为仍待验证。清单版本为 `0.1.0`，不代表已经发布。
-## 项目用途
-目标流程是：用专用设备记录会议、采访或笔记，通过 BLE 传回音频，再在 DSH 中归档并转写。硬件录音不使用电脑麦克风。
-实现依据[上游 AI 录音卡协议](https://github.com/nextproto1024/ai-recorder-card-open-protocol)。具体卡片和固件是否兼容，需要实测确认；产品名称相同不代表协议兼容。
-## 当前状态
-“已有实现”仅表示存在代码，不代表已经通过 DSH 或硬件测试。目前尚未记录经过验证的兼容环境基线。
-| 能力 | 实现状态 | 验证情况 / 剩余工作 |
-|---|---|---|
-| Bundle 清单和 Skill provider | 已有实现，本地合约与包检查通过 | 待验证 DSH 加载和 Skill 发现 |
-| 浏览器连接、电量、录音状态与控制 | 已有实现 | 待目标浏览器及实机验证 |
-| 浏览器文件列表 | 已有实现 | 待验证多帧列表和结束处理 |
-| 浏览器文件导入 | 占位 | 按钮仅显示提示，尚缺传输和 Host 落盘 |
-| Host 调用 Python CLI | 已有封装 | 未随包提供 CLI，配置及执行待验证 |
-| `recorder_*` Agent 工具和前后端通信 | 未实现 | 待确认注册及通信接口 |
-| 转写后端和归档完整性 | 规划中 | 尚无插件完整流程或已验证的默认后端 |
-验收标准见 [ROADMAP.md](ROADMAP.md)。
-本地回归测试通过模拟 hooks 和 BLE，覆盖通知解析、会话和列表请求清理、列表超时与不完整结果提示，以及会话内串行写入。运行 `npm test`；覆盖范围和限制见[本地检查](CONTRIBUTING.md#local-checks-without-hardware)。这些检查不能替代 DSH 或实机验证。
-列表超时、写入失败或结束响应未确认成功后，需先断开并重新连接，再读取列表。当前连接禁止列表重试，避免把迟到响应当作新请求的完整结果。已收到的条目仍明确标为未确认，状态刷新和录音控制可继续使用。
-## 安装状态
-目前尚无已验证的最终用户安装流程。
-- **本地开发：** 按[贡献指南](CONTRIBUTING.md)中的候选 DSH 加载流程验证，并记录准确的运行时版本和结果。
-- **npm：** 清单已设置 `private: false`、发布文件范围和 DSH peer 版本。本地包预检通过；发布、注册表可用性及最终用户安装仍未验证。
-- **GitHub / Web 界面安装：** 尚未验证 bundle 安装和启用；通过发布验收后再补充用户安装步骤。
-## 开发环境要求
-- 提供插件开发能力的 DSH 环境；支持的版本及 profile 尚未确定。
-- 浏览器实验需要 Chrome 或 Edge、可用的 `navigator.bluetooth`、蓝牙访问权限，以及协议兼容的录音卡。需记录实际测试的浏览器和系统组合。
-- 本地语法检查需要 Node.js；最低支持版本待结合目标 DSH 运行时确定。
-- 仅 Host CLI 实验需要：单独获取的上游仓库、Python，以及该版本上游声明的依赖。本仓库不包含 `tools/` 目录或 Python 依赖清单。
-## 首次开发验证
-1. 完成[贡献指南](CONTRIBUTING.md)中的本地检查和候选 DSH 加载流程。
-2. 确认录音卡片能够显示，内置 Skill 能被发现。
-3. 使用实机分别验证连接、状态、录音控制和文件列表。
-4. 记录失败项及环境信息。导入和转写属于后续验收项，目前没有可用的快速开始命令。
-## 架构
-| 组件 | 文件 | 当前职责 |
-|---|---|---|
-| Host | [index.js](index.js) | Skill 注册和内部 Python CLI 封装；工具及通信待接入 |
-| Client | [client.js](client.js) | 使用浏览器 BLE 的 React 卡片；导入为占位 |
-| Skill | [skill/SKILL.md](skill/SKILL.md) | 能力检查、资源定位及设备操作约束 |
-| 协议 | [vendor/recorder-protocol.js](vendor/recorder-protocol.js) | CRC、组帧、解析及命令原语 |
-| 加载配置 | [cordis.patch.yml](cordis.patch.yml) | 插件加载条目 |
-BLE 连接归属、外部 CLI 配置及规划中的数据流见[架构与待决事项](docs/architecture.md)。
-## 转写规划
-默认接入目标已确定为 DSH 内置语音转写；豆包、OpenAI 兼容 ASR 接口和本地 SenseVoice ONNX 为后续可选后端。目前它们不是已支持的 provider 选项。现有 Host 方法只调用外部脚本，没有实现 DSH 后端、provider 选择或 `transcriptionProvider` 配置。M4 先实现并验证既定默认后端，再扩展支持范围。
-## 数据规划
-```text
-archive/audio/    # 计划存放导入的音频
-archive/corpus/   # 计划存放转写 Markdown
-```
-计划使用 `audio_sha256` 指纹关联音频与转写，避免错误复用。当前仓库尚未实现或验证这一存储约定。Host 封装中的相对输出路径以配置的 `repoRoot` 为基准，该位置可能是外部仓库。
-音频、转写、设备地址和密钥不得提交到版本库。参见 [.gitignore](.gitignore)；使用外部仓库时，也需检查其忽略规则。
-## 贡献
-使用 AI 工具协作时，从 [AGENTS.md](AGENTS.md) 进入，再读取[开发者](docs/roles/open-source-developer.md)或 [QA](docs/roles/qa.md) 职责。这些文档供不同工具共用，`.cursor/rules/` 仅为可选的 Cursor 适配层。工具未自动发现入口时，按[角色使用说明](CONTRIBUTING.md#development-and-qa-roles)显式要求读取。
-请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。行为或状态变化时，同步维护本文件和 [README.md](README.md)。已完成的变化写入 [CHANGELOG.md](CHANGELOG.md)，未来工作放入 [ROADMAP.md](ROADMAP.md)。
-## 许可证与相关项目
-[MIT](LICENSE) © 2026 SynSwarm DAO。
-- [AI 录音卡开放协议](https://github.com/nextproto1024/ai-recorder-card-open-protocol)：外部协议与 CLI 来源。
-- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)：目标宿主运行时。
+# dsh-recorder-card
+[English](README.md) · [贡献指南](CONTRIBUTING.md) · [路线图](ROADMAP.md) · [架构](docs/architecture.md) · [更新记录](CHANGELOG.md)
+**`dsh-recorder-card`** 是一个开发中的第三方 **DeepSeek Harness (DSH)** 插件，用于通过 BLE 接入 **AI 录音卡**。
+> **开发预览：** 当前仓库包含插件骨架和浏览器卡片实现，导入、转写和归档尚未打通。DSH 兼容性及实机行为仍待验证。已发布到 npm：`dsh-recorder-card@0.1.0`（开发预览版）。
+## 项目用途
+目标流程是：用专用设备记录会议、采访或笔记，通过 BLE 传回音频，再在 DSH 中归档并转写。硬件录音不使用电脑麦克风。
+实现依据[上游 AI 录音卡协议](https://github.com/nextproto1024/ai-recorder-card-open-protocol)。具体卡片和固件是否兼容，需要实测确认；产品名称相同不代表协议兼容。
+## 当前状态
+“已有实现”仅表示存在代码，不代表已经通过 DSH 或硬件测试。目前尚未记录经过验证的兼容环境基线。
+| 能力 | 实现状态 | 验证情况 / 剩余工作 |
+|---|---|---|
+| Bundle 清单和 Skill provider | 已有实现，本地合约与包检查通过 | 待验证 DSH 加载和 Skill 发现 |
+| 浏览器连接、电量、录音状态与控制 | 已有实现 | 待目标浏览器及实机验证 |
+| 浏览器文件列表 | 已有实现 | 待验证多帧列表和结束处理 |
+| 浏览器文件导入 | 占位 | 按钮仅显示提示，尚缺传输和 Host 落盘 |
+| Host 调用 Python CLI | 已有封装 | 未随包提供 CLI，配置及执行待验证 |
+| `recorder_*` Agent 工具和前后端通信 | 未实现 | 待确认注册及通信接口 |
+| 转写后端和归档完整性 | 规划中 | 尚无插件完整流程或已验证的默认后端 |
+验收标准见 [ROADMAP.md](ROADMAP.md)。
+本地回归测试通过模拟 hooks 和 BLE，覆盖通知解析、会话和列表请求清理、列表超时与不完整结果提示，以及会话内串行写入。运行 `npm test`；覆盖范围和限制见[本地检查](CONTRIBUTING.md#local-checks-without-hardware)。这些检查不能替代 DSH 或实机验证。
+列表超时、写入失败或结束响应未确认成功后，需先断开并重新连接，再读取列表。当前连接禁止列表重试，避免把迟到响应当作新请求的完整结果。已收到的条目仍明确标为未确认，状态刷新和录音控制可继续使用。
+## 安装状态
+目前尚无已验证的最终用户安装流程。
+- **本地开发：** 按[贡献指南](CONTRIBUTING.md)中的候选 DSH 加载流程验证，并记录准确的运行时版本和结果。
+- **npm：** 已发布 `dsh-recorder-card@0.1.0`，安装 spec 为 `dsh plugin add dsh-recorder-card`。DSH 内的最终用户安装和启用尚未验证。
+- **GitHub / Web 界面安装：** 尚未验证 bundle 安装和启用；通过发布验收后再补充用户安装步骤。
+## 开发环境要求
+- 提供插件开发能力的 DSH 环境；支持的版本及 profile 尚未确定。
+- 浏览器实验需要 Chrome 或 Edge、可用的 `navigator.bluetooth`、蓝牙访问权限，以及协议兼容的录音卡。需记录实际测试的浏览器和系统组合。
+- 本地语法检查需要 Node.js；最低支持版本待结合目标 DSH 运行时确定。
+- 仅 Host CLI 实验需要：单独获取的上游仓库、Python，以及该版本上游声明的依赖。本仓库不包含 `tools/` 目录或 Python 依赖清单。
+## 首次开发验证
+1. 完成[贡献指南](CONTRIBUTING.md)中的本地检查和候选 DSH 加载流程。
+2. 确认录音卡片能够显示，内置 Skill 能被发现。
+3. 使用实机分别验证连接、状态、录音控制和文件列表。
+4. 记录失败项及环境信息。导入和转写属于后续验收项，目前没有可用的快速开始命令。
+## 架构
+| 组件 | 文件 | 当前职责 |
+|---|---|---|
+| Host | [index.js](index.js) | Skill 注册和内部 Python CLI 封装；工具及通信待接入 |
+| Client | [client.js](client.js) | 使用浏览器 BLE 的 React 卡片；导入为占位 |
+| Skill | [skill/SKILL.md](skill/SKILL.md) | 能力检查、资源定位及设备操作约束 |
+| 协议 | [vendor/recorder-protocol.js](vendor/recorder-protocol.js) | CRC、组帧、解析及命令原语 |
+| 加载配置 | [cordis.patch.yml](cordis.patch.yml) | 插件加载条目 |
+BLE 连接归属、外部 CLI 配置及规划中的数据流见[架构与待决事项](docs/architecture.md)。
+## 转写规划
+默认接入目标已确定为 DSH 内置语音转写；豆包、OpenAI 兼容 ASR 接口和本地 SenseVoice ONNX 为后续可选后端。目前它们不是已支持的 provider 选项。现有 Host 方法只调用外部脚本，没有实现 DSH 后端、provider 选择或 `transcriptionProvider` 配置。M4 先实现并验证既定默认后端，再扩展支持范围。
+## 数据规划
+```text
+archive/audio/    # 计划存放导入的音频
+archive/corpus/   # 计划存放转写 Markdown
+```
+计划使用 `audio_sha256` 指纹关联音频与转写，避免错误复用。当前仓库尚未实现或验证这一存储约定。Host 封装中的相对输出路径以配置的 `repoRoot` 为基准，该位置可能是外部仓库。
+音频、转写、设备地址和密钥不得提交到版本库。参见 [.gitignore](.gitignore)；使用外部仓库时，也需检查其忽略规则。
+## 贡献
+使用 AI 工具协作时，从 [AGENTS.md](AGENTS.md) 进入，再读取[开发者](docs/roles/open-source-developer.md)或 [QA](docs/roles/qa.md) 职责。这些文档供不同工具共用，`.cursor/rules/` 仅为可选的 Cursor 适配层。工具未自动发现入口时，按[角色使用说明](CONTRIBUTING.md#development-and-qa-roles)显式要求读取。
+请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。行为或状态变化时，同步维护本文件和 [README.md](README.md)。已完成的变化写入 [CHANGELOG.md](CHANGELOG.md)，未来工作放入 [ROADMAP.md](ROADMAP.md)。
+## 许可证与相关项目
+[MIT](LICENSE) © 2026 SynSwarm DAO。
+协议副本及 `client.js` 中的内联副本包含 NextProto AI 录音卡开放协议的代码，© 2026 NextProto，遵循[上游 MIT 许可证](vendor/LICENSE)。该声明随 npm 包分发。
+- [AI 录音卡开放协议](https://github.com/nextproto1024/ai-recorder-card-open-protocol)：外部协议与 CLI 来源。
+- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)：目标宿主运行时。

package/client.js CHANGED Viewed

@@ -3,6 +3,9 @@
 // Protocol primitives inlined from the upstream sdk/javascript/qs668-protocol.js
 // (MIT) so the card needs no extra module-format resolution. Canonical copy is
 // vendor/recorder-protocol.js.
+// Copyright (c) 2026 NextProto (upstream protocol portions).
+// Full upstream copyright and permission notice: vendor/LICENSE
+// https://github.com/nextproto1024/ai-recorder-card-open-protocol
 //
 // DSH constraints (from cordis-plugin-development references):
 //   - register into a slot with ctx.slots.inject / ctx.slots.register

package/package.json CHANGED Viewed

@@ -1,6 +1,19 @@
 {
   "name": "dsh-recorder-card",
-  "version": "0.1.0",
+  "version": "0.1.1",
+  "description": "Development-preview DSH plugin for AI recorder cards, with browser BLE control and file-listing code. DSH and hardware verification pending; audio import and transcription integration are planned.",
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "recorder",
+    "recording-card",
+    "voice-recorder",
+    "ble",
+    "bluetooth",
+    "audio",
+    "ai-recorder"
+  ],
   "private": false,
   "type": "module",
   "scripts": {

package/vendor/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 NextProto
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/recorder-protocol.js CHANGED Viewed

@@ -1,5 +1,7 @@
 // Vendored from nextproto1024/ai-recorder-card-open-protocol (MIT License).
 // https://github.com/nextproto1024/ai-recorder-card-open-protocol
+// Copyright (c) 2026 NextProto
+// Full upstream copyright and permission notice: ./LICENSE
 export const UUIDS = Object.freeze({
   service: "0000ae20-0000-1000-8000-00805f9b34fb",