dsh-meeting-notepad 0.0.0-stage → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-meeting-notepad contributors
+
+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/README.md

@@ -1,3 +1,79 @@
-# Temporary Holding Version
+# 会议记事本 · dsh-meeting-notepad
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Harness（dsh）插件：**录音 → 本地转写 → 按发言人整理 → AI 总结**，全部落在同一条会议记录里。
+
+> 录音时点一下当前发言人（或按数字键 `1`–`9`），转写按停顿自动分段并记到这个人名下；停止后自动写入会议记录并保存；最后用当前默认模型生成结构化纪要。识别使用 DSH 自带的 SenseVoice（CPU），音频不上传。
+
+## 功能
+
+- **录音模式**：浏览器采集麦克风，按停顿自动切段（静音约 0.7 秒、单段最长 15 秒）。
+- **本地转写**：SenseVoiceSmall INT8 / ONNX，本机 CPU 推理，断网也能用（模型就绪后）。
+- **谁在说**：录音中点发言人名字或数字键切换；转写行可逐行改文字、改发言人；双击名字重命名。
+- **自动归档**：停止后把「时间 + 发言人 + 内容」插入记录正文并立即保存；同一条记录可多次追加。
+- **AI 总结**：当前默认模型生成「会议要点 / 关键结论 / 待办事项 / 风险与待确认」，可重复生成（覆盖上一次总结）。
+- **检索**：按日期、标签、关键词筛选，支持 JSON 导出。
+- 数据保存在浏览器 `localStorage`，不需要账号或云端。
+
+## 安装
+
+市场里搜索 **会议记事本**，或：
+
+```bash
+dsh plugin --profile web add dsh-meeting-notepad
+```
+
+本地开发（直接链接源码目录）：
+
+```bash
+dsh plugin --profile web add link:/path/to/dsh-meeting-notepad
+```
+
+安装后重启 dsh web（或刷新页面）。
+
+## 前置条件：启用语音 Bundle
+
+本插件不内置语音服务。请先在 **插件管理** 里启用官方的 **语音输入（Voice Input）** Bundle，
+它提供 `speechToText` 服务与本地 SenseVoice Provider；启用后刷新页面。
+
+> 如果插件列表里找不到它，说明当前 dsh 版本没有附带这个实验性 Bundle，
+> 需要升级到带 `@deepseek-ai/dsh-experimental-voice-input-bundle` 的版本。
+
+## 首次使用
+
+1. 打开「会议记事本」→ 新建/打开一条记录 →「录音」。
+2. 首次会提示准备语音模型（约 239 MB，只需下载一次，缓存在 `~/.dsh/speech-to-text/sensevoice`）。
+3. 点「准备模型」，完成后即可录音。
+
+> 模型从 `huggingface.co` / `hf-mirror.com` 下载。访问不了这两个站点的网络会看到失败卡片和本地目录提示，可手动放入 `model.int8.onnx`、`tokens.txt`、`silero_vad.onnx` 后点「重试准备」。
+
+## 使用
+
+1. 点「录音」→ 开始说话；换人时点名字或按数字键。
+2. 「停止并插入记录」→ 转写自动写入并保存。
+3. 需要纪要时点「AI 总结」。
+
+## 隐私
+
+- 录音片段只用于当次转写，不落盘、不上传；模型推理在本机完成。
+- 只有点「AI 总结」时，记录正文才会发给当前默认模型。
+- 会议记录存在浏览器 `localStorage`（键 `dsh.meeting-notes.v1`）。
+
+## 已知限制
+
+- **不是声纹自动分离**：本地 SenseVoice 只输出文字，不带说话人。插件采用「当前发言人跟随」，换人时点一下，准确、可控；不做基于音色的自动聚类。
+- 推理用 CPU，长会议会排队逐段识别；录音时显示「识别中…」。
+- 需要麦克风权限；Web GUI 走环回地址（`127.0.0.1`）满足安全上下文要求。
+- 依赖 DSH 自带的实验性语音包（`@deepseek-ai/dsh-experimental-speech-to-text` 与 SenseVoice Provider），要求 dsh `>=0.2.0-rc.2 <0.3.0-0`。
+
+## 结构
+
+| 文件 | 作用 |
+| --- | --- |
+| `index.js` | Host 半边：`speechStatus` / `prepareSpeech` / `transcribe` / `summarize`，经 Typert Remote 暴露为 `ctx.remote.meetingNotes` |
+| `client.js` | Client 半边：面板、录音引擎（Web Audio + 能量 VAD + WAV 编码）、转写队列、编辑器 |
+| `cordis.patch.yml` | 插入本地语音服务、SenseVoice Provider 与本插件三行 |
+| `locale/` | 插件市场里的标题与简介 |
+
+## License
+
+MIT