floatboatai/OpenMinutes

选用指南

AI 根据 README 整理 · 2026/10/29 03:01:48

使用方式

作为 Floatboat 桌面端的工作台包运行，由 Host 装载，不是独立 Node 服务；通过 pnpm 安装 UI 依赖，由 Floatboat 执行构建和更新。

查看 README 依据

| 能力 | 说明 | | --- | --- | | 三种接入入口 | 目录扫描导入、设备文件清单登记、BLE 直连拉取（依赖本机 Python + `bleak` + 真实设备） | | 流式转录 | `ffmpeg` 解码为 16 kHz 单声道 PCM16，经 Host ASR 流式识别，落库全文与分段时间轴 | | AI 归类 | Host LLM 结构化输出标题、摘要、分类、标签、要点、待办、重要度，并支持人工修正 | | 检索复盘 | 全文搜索（正文 + 标题 + 摘要）、分类/标签/阶段筛选、时间排序、批量处理 | | 详情播放 | HTTP Range 分段播放、按句时标跳转、AI 结论与执行记录三分区 | | 分类管理 | 新增、就地改名、改色、删除 | | 设备接入页 | 环境自检（python / `bleak` / SDK / ffmpeg）、路径设置、SDK 指令参考库、手动登记 | ## 快速上手 本应用运行在 **Floatboat 桌面端的工作台运行时**中 —— 它不是独立的 Node 服务，而是一个由 Host 装载的工作台包： - Host 负责依赖准备、strict TypeScript 检查、server 编译与 UI 打包（产物落在 `dist/`，不入库）；

- SQLite 迁移由 Host 在打开工作台时应用（`migrations/` 只追加，不回改）； - ASR 与 LLM 通过 Host 能力调用，本仓库不包含、也不需要任何模型密钥。 ```bash pnpm install # 仅安装 UI 依赖（react / react-dom / lucide-react） ``` 之后由 Floatboat 执行 `check_workbench_project` 完成类型检查与构建，`workbench_runtime open` 应用更新。 ### 运行时依赖 | 依赖 | 用途 | 缺失时行为 | | --- | --- | --- | | `ffmpeg` | 音频探测与解码 | 转录不可用，页面如实提示 | | `python` + `bleak` + `memotalk-sdk` | BLE 拉取设备录音 | 设备页报告「未就绪」，目录导入路径仍可用 | 工具路径按「设置值 → Floatboat 内置工具 → `PATH` → 命令名」逐级探测，不依赖进程 `PATH`。 ## 目录结构 ``` src/ contracts/ 跨端 DTO（app.ts）与不可信输入校验（input.ts） server/ Node 服务端：装配、路由、领域逻辑

部署要求

需要 ffmpeg 用于音频解码，转录功能依赖；BLE 拉取需要 Python、bleak 和 memotalk-sdk，缺失时目录导入仍可用。

查看 README 依据

- SQLite 迁移由 Host 在打开工作台时应用（`migrations/` 只追加，不回改）； - ASR 与 LLM 通过 Host 能力调用，本仓库不包含、也不需要任何模型密钥。 ```bash pnpm install # 仅安装 UI 依赖（react / react-dom / lucide-react） ``` 之后由 Floatboat 执行 `check_workbench_project` 完成类型检查与构建，`workbench_runtime open` 应用更新。 ### 运行时依赖 | 依赖 | 用途 | 缺失时行为 | | --- | --- | --- | | `ffmpeg` | 音频探测与解码 | 转录不可用，页面如实提示 | | `python` + `bleak` + `memotalk-sdk` | BLE 拉取设备录音 | 设备页报告「未就绪」，目录导入路径仍可用 | 工具路径按「设置值 → Floatboat 内置工具 → `PATH` → 命令名」逐级探测，不依赖进程 `PATH`。 ## 目录结构 ``` src/ contracts/ 跨端 DTO（app.ts）与不可信输入校验（input.ts） server/ Node 服务端：装配、路由、领域逻辑

已知限制

BLE 通道未就绪、音频无法播放、ASR 上游失败时，页面会如实报告，不伪造成功。

查看 README 依据

| `GET` | `/api/device` · `/summary` · `/capabilities` | 设备记录、概览、SDK 指令参考库 | | `POST` | `/api/device/check` · `/list` · `/download` · `/status` | 环境自检、读清单、BLE 拉取、状态 | | `GET`·`POST` | `/api/live` · `/live/start` · `/live/stop` | 实时字幕 | | `GET`·`POST` | `/api/categories`；`PATCH`·`DELETE` `/api/categories/:id` | 分类管理 | | `GET`·`PATCH` | `/api/settings` | 路径、转录与归类开关、热词与语言 | 响应统一为 `{ ok: true, data }` / `{ ok: false, error: { code, message } }` 信封。 ## 设计原则（节选） - **不伪造成功**：BLE 通道未就绪、音频无法播放、ASR 上游失败，页面一律如实报告，并把失败态变成可继续的动作。 - **状态双编码**：一律「文字 + 颜色」，不只靠颜色区分；动画尊重 `prefers-reduced-motion`。