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，先登录：
- 向用户索取 API Key（格式
sk-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx，在妙记 App → 我的 → API Key 管理中创建） - 执行：
<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。
