JishuDB 的 Plaud 录音导入

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install jishudb-plaud-import
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 jishudb-plaud-import。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Plaud Recording Import 是一套 Openclaw Skills 工作流，用于将选定的 Plaud 录音或明确指定的本地导出文件存档到 JishuDB。它会分别保存原始音频、带时间戳的转录文本和会议摘要，将相关内容关联到稳定的来源身份，并在报告完成前验证已保存的内容。
此技能可通过协调已有文档、检查处理状态和记录来源信息，谨慎地重新运行并恢复中断的导入。根据请求，它还可以将导入的会议资料与选定的项目证据进行比较，并提供引用。它不会控制录音硬件，也无法访问尚未同步、仅存于设备上的录音。

应用场景

将选定的 Plaud 会议及其可用的原始音频或现有转录文本存档到 JishuDB 知识库。
导入明确选定的本地 Plaud 音频、转录文本或摘要导出文件，同时记录其获取途径。
恢复中断的导入，并确认哪些内容形式及来源记录已经保存。
在重复导入时保留音频、转录文本和摘要之间的关联。
将导入的会议内容与选定的项目文档进行比较，并引用检索到的证据。
让会议记录可在 JishuDB 中搜索，同时不将摘要误当作转录文本，也不悄然遗漏所要求的音频。

工作原理

确定所选录音或本地导出文件、请求的内容形式、目标知识库和输出目录；获取任何缺少的传输授权。
连接到指定的 JishuDB 服务，验证其实时工具和目标限制；若从 Plaud 获取内容，则确认已授权的账户并选择目标录音。
为来源和目标生成稳定身份，检查其来源记录 Note，并协调现有 JishuDB 文档，以避免重复导入或意外覆盖。
仅获取已批准的资料。对于音频，在下载实际字节前确认直接上传能力和要求；对于文本，仅检索已批准的转录文本或摘要，并保留时间戳和说话人标签。
将来源文件保存在获批的输出目录中，计算内容哈希，并使用共享的来源关联上传每种内容形式。跟踪上传任务，并在重试前核查状态不确定的完成操作。
验证处理和索引状态，读回已保存的文档，并创建或更新来源记录 Note。将 Note 关联到知识库，并验证关联的文档。
如果有此请求，则搜索选定的知识库，并将导入资料与现有证据进行比较。报告带引用的发现，并准确说明完成状态：COMPLETE、PARTIAL、USER_ACTION_REQUIRED、BLOCKED 或 FAILED。

配置指南

提供已授权的 JishuDB MCP 写入权限，以及已授权的 Plaud MCP 来源工具或明确选定的本地导出文件。
尽可能复用可用的 JishuDB 连接。如需设置，请按照随附指南 references/jishudb-setup/setup.md 操作；从 references/jishudb-setup/ 运行其中的平台辅助工具。无需单独安装 JishuDB Skill 或从 ClawHub 下载。
对于云端获取，通过现有连接器授权 Plaud，并确认目标账户。不要提供或暴露连接器令牌。
对于音频导入，请确保 JishuDB 在 direct 模式下公布 mcp.upload.audio.enabled，支持请求的扩展名和文件大小或时长，并且主机能够通过 HTTP 传输实际二进制字节。请分别检查语音和压缩解码器的就绪状态。
录音身份辅助工具需要 Node.js 20 或更高版本，且没有依赖项。音频不能退回到文本上传或服务器端路径上传；如果无法直接传输，请先解决此能力问题，再承诺导入音频。
此技能未指定通用安装命令。请使用打包的设置指南和主机实时工具架构，不要臆测命令名称或配置值。
JishuDB 的 Plaud 录音导入 数据架构与分类体系
此技能会分别保存不同内容形式，并将它们关联到稳定的来源身份。
数据或元数据 用途
来源范围和录音 ID 标识已授权的 Plaud 录音；本地导出文件使用独立的 local-export 范围和获批的稳定来源 ID。
知识库 ID 将导入绑定到实际选定的 JishuDB 目标位置。
externalAssetId 将音频和每种文本内容形式关联到同一来源。
manifestNoteId 定位此次导入的持久来源记录 Note。
内容形式和内容 SHA-256 区分音频、转录文本和摘要内容，并协调未更改或已修订的资料。原始音频使用 audio.originalSha256。
JishuDB 文档和任务 ID 跟踪已保存文档、上传处理，以及状态不确定或中断操作的恢复情况。
来源记录 Note 字段 记录来源关联和导入详情；Note 更新使用 updatedAt 实现乐观并发控制。
下载或导出的原始文件会保存在获批的输出目录中，不会覆盖现有文件。采集时间和导入状态不会写入不可变的来源文本载荷，以免重复运行造成虚假的内容修订。默认情况下，变更内容会作为带标签的修订追加；旧文档不会自动覆盖或删除。签名 URL 和凭据属于临时信息，不得存储在来源记录中。

高级特性

稳定身份辅助工具使用非机密账户范围、来源 ID、知识库 ID、内容形式和内容哈希，支持安全协调与重试。
重复导入和中断恢复会在重试前检查来源记录 Note、分页文档列表、文档内容哈希和上传任务描述符。
直接二进制音频上传与受支持的文本上传分开处理，并明确检查能力、扩展名、大小和时长。
音频处理状态按不同阶段报告，包括原始文件保留、播放或标准化、转录和索引。
有界任务轮询、保留任务 ID 和根据原因进行重试，有助于避免重复传输；仅需重试索引时可复用现有转录结果。
来源记录 Note 支持乐观并发控制、知识库关联，以及验证关联文档是否可读。
按请求进行的后续比较会使用 JishuDB 搜索结果；在可用时引用文档或区块 ID 及来源时间戳，同时保留不同意见并指出缺失证据。
同意与范围控制可防止未经授权的来源访问、硬件控制、外部任务创建，或在未另行授权主机自动化的情况下进行定期导入。

name: jishudb-plaud-import description: >- 将选定的 Plaud 录音、原始音频、带时间戳的转写或会议纪要导入 JishuDB，
适用于会议归档、本地导出导入、保留来源关联及导入后的会议对比。 /
Archive selected Plaud recordings, audio, timestamped transcripts, or meeting
summaries in JishuDB from an authorized connector or local export. Preserve
source associations and compare imported meetings with cited project evidence;
not for recording-device control.
compatibility: Requires authorized JishuDB MCP write tools and either authorized Plaud MCP source tools or an explicitly selected local export. Audio additionally requires HTTP direct upload, the advertised JishuDB audio capability, and a host able to transfer actual binary bytes. The identity helper uses Node.js 20 or later without dependencies. JishuDB setup is included in this package.