核心用法
Plaud API Skill 用于访问 Plaud 智能录音笔的数据，涵盖音频文件（MP3）、完整转录文本（含说话人分离）以及 AI 生成的摘要。核心操作依赖于 plaud_client.py 客户端脚本，该脚本封装了认证、错误处理和响应解析，不推荐直接调用原始 API。
凭证配置流程
使用前需从 Plaud Web App 提取凭证：
1. 登录 https://web.plaud.ai
2. 打开 Chrome DevTools（F12 / Cmd+Option+I）
3. 进入 Application → Local Storage → https://web.plaud.ai
4. 复制 tokenstr（含 "bearer " 前缀）和 plaud_user_api_domain
5. 创建 .env 文件配置 PLAUD_TOKEN 和 PLAUD_API_DOMAIN
6. 执行 python plaud_client.py list 验证
常用操作
- 列出录音：
list/list --json - 获取详情（含转录）：
details <file_id> - 下载音频：
download <file_id> -o <path> - 批量下载：
download-all -o <dir> - 提取纯转录文本：配合
jq过滤.data.trans_result.segments[].text
显著优点
- 客户端封装完善：
plaud_client.py自动处理认证头、错误重试和 JSON 解析，降低使用门槛 - 数据维度丰富：一次调用可获取音频、转录、AI 摘要三重数据
- 支持批量操作：
download-all和 JSON 输出便于自动化流程集成 - Token 有效期长：约 10 个月，维护成本低
- n8n 工作流就绪：提供现成自动化模板（
plaud-to-second-brain.json）
潜在缺点与局限性
- 凭证提取繁琐：需手动操作浏览器 DevTools，无程序化 OAuth 流程，对非技术用户不友好
- Token 无自动刷新：过期需人工重新提取，无 SDK 级自动处理
- 地区化 API 域名：欧盟用户（
api-euc1）与其他地区可能不同，配置错误导致连接失败 - 依赖第三方逆向工程：
plaud_client.py来自社区逆向仓库（plaud-api-reveng），非官方 SDK，存在 API 变更后失效风险 - 无细粒度权限控制：获取到的 Token 拥有完整账户访问权限，无法限制只读或单文件范围
适合人群
- 已购买 Plaud 硬件设备的个人用户
- 需要将录音数据自动化导入知识库/笔记系统的效率工具用户
- 具备基础命令行和浏览器 DevTools 操作能力的开发者
- n8n/Zapier 等自动化平台用户（借助提供的工作流模板）
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **Token 泄露** | `.env` 文件中的长有效期 Token 若被窃取，可导致账户完全暴露 | 将 `.env` 加入 `.gitignore`，使用密码管理器存储 |
| **数据隐私** | 转录和 AI 摘要可能包含敏感信息，传输依赖 HTTPS | 确认 API 域名使用 HTTPS，避免公共网络明文传输 |
| **逆向工程依赖** | 非官方客户端可能随 Plaud 官方 API 更新而失效 | 关注上游仓库更新，保留手动提取数据的备用方案 |
| **地域限制** | 错误配置 API 域名导致服务不可用 | 严格按 DevTools 中显示的域名配置，勿假设默认值 |
| **转录准确性** | AI 摘要和说话人分离存在误差，关键场景需人工复核 | 重要内容建议下载原始音频交叉验证 |