SonicNote 妙记助手

让 AI 读写用户的 SonicNote 妙记录音数据：录音列表、详情、AI 总结、转写文本、笔记。

通过内置脚本直接调用妙记 HTTP API，无需配置 MCP server。用户只需提供一个 API Key。

运行环境检测（首次执行一次，记住结果）

本 skill 提供两套功能等价的脚本。按顺序检测解释器，选定一个后整个会话都用它：

node --version        # 成功（输出 v18 或更高）→ 用 scripts/sonicnote.js
python3 --version     # 否则尝试；成功 → 用 scripts/sonicnote.py
python --version      # 再否则；成功 → 用 scripts/sonicnote.py

三者都不可用 → 告诉用户：请安装 Node.js 18+ 或 Python 3 后重试。

脚本路径相对于本 skill 目录。选定解释器后，下文 <run> 代指：

• Node：node scripts/sonicnote.js
• Python：python3 scripts/sonicnote.py（或 python，取决于上一步）

所有命令输出统一 JSON：成功 {"ok":true,"data":{...}}（退出码 0），失败 {"ok":false,"error":"...","code":...}（退出码 1）。

首次使用：登录

若无 ~/.sonicnote/config.json 或用户尚未提供 API Key，先登录：

1. 向用户索取 API Key（格式 sk-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx，在妙记 App → 我的 → API Key 管理中创建）
2. 执行：

<run> login --api-key sk-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

登录成功后 token 缓存到 ~/.sonicnote/config.json，后续命令自动复用，token 失效会自动重登一次。

命令速查

| 命令 | 用途 | 关键参数 | |------|------|---------| | login | 登录（首次） | --api-key（必填） | | recordings | 录音列表 | --keyword（可选搜索）、--page、--size（默认 10） | | detail | 录音详情 | --audio-id（必填） | | note-get | 读取笔记（只读） | --audio-id（必填） | | transcript | 转写文本（说话人+时间戳） | --audio-id（必填） | | summary | AI 总结内容 | --audio-id（必填） |

典型调用顺序

查"上次某会议讲了什么"：

recordings --keyword 产品评审          # 找到目标 audioId
summary --audio-id <id>                # 读 AI 总结
transcript --audio-id <id>             # 需要细节时读转写

回顾最近会议：

recordings --size 5                    # 拿最近 5 条
summary --audio-id <id>                # 逐条读总结

audioId 从哪来

所有需要 --audio-id 的命令，audioId 必须先从 recordings 的返回项中获取。不要凭空猜测 audioId。

输出呈现建议

• 总结优先：先呈现 summary.summaryContent，用户需要细节再取转写。
• 转写归纳：transcript.segments 按说话人归类呈现，长对话可只摘关键发言，完整内容折叠或按需展示。
• 录音列表用表格：audioId、名称、时长、转录/总结状态、录音时间。
• 状态字段：transcriptStatus / summaryStatus 已翻译为中文（未转录/转录中/已完成/失败 等）。

注意事项

• 本 skill 只读录音数据，不会修改或删除用户的录音、笔记、文件。
• 网络或服务端错误时，脚本返回 {"ok":false,"error":...}，向用户转述 error 内容即可。
• 详细参数、返回字段与错误码见 references/commands.md。