| name | yoooclaw-recording-query |
| description | 用 yoooclaw CLI 查询本地长录音记录和转写内容。当用户说"有哪些录音""查一下录音""找最近的录音""这段录音说了什么""根据录音回答问题""查看录音摘要/转写""搜索录音内容"等需求时激活。必须通过 yoooclaw recording storage-path 与 recording list 定位录音，严禁假设录音目录。yoooclaw 是 openclaw 手机录音插件的独立 CLI 形态，数据在 ~/.yoooclaw 下，纯读磁盘、不需要 daemon 在跑。 |
yoooclaw 长录音查询（Agent-Native）
yoooclaw CLI 自身就是工具表：所有命令都支持 --format json|pretty|table|ndjson。本 Skill 取结构化对象一律用 --format json。
命令名 yoooclaw，短别名 yc 完全等价。下文用 yoooclaw。
录音数据在 ~/.yoooclaw 下，查询纯读磁盘、不需要 daemon 在跑。
定位到转写文件后，用你的文件读取工具直接读 <path>/<transcriptFile>，不要假设目录。
多 profile 时所有命令可加 --profile <name> 查指定 profile。
1. 初始化（不要假设录音目录）
yoooclaw recording storage-path --format json
后续所有文件操作以返回的 path 为根目录：
- 转写文件优先查找：
<path>/<transcriptFile>（transcriptFile 来自 recording status）。
- AI 总结文件按需查找：
<path>/<summaryFile>。
- 若命令失败或
ok != true，告知用户当前无法定位录音存储目录，终止查询。
2. 获取录音列表
yoooclaw recording list --format json
返回示例：
{
"ok": true,
"total": 2,
"recordings": [
{
"id": "7E901C59-8B98-4AA3-9DE1-AE86E34A1A37",
"name": "2026-05-11 10_31_43",
"duration_sec": 66,
"status": "transcribed",
"file_size_bytes": 191283,
"has_audio": true,
"has_transcript": true,
"created_at": "2026-05-11T10:31:43+08:00",
"updated_at": "2026-05-11T02:33:19.805Z",
"error": null
}
]
}
status 取值是一条完整的传输 → 转写流水线，不是只有 transcribed：
receiving → pending_oss_upload → uploading_oss → oss_uploaded → synced → transcribing → transcribed，
另有两个失败态 receiving_failed（传输失败）与 transcribe_failed（转写失败）。
向用户解释「为什么还没有转写」时按实际状态说：synced 及之前是音频还在传，transcribing 才是正在转写。
处理规则：
- 若
ok != true，说明录音列表不可用，简短说明错误后终止。
- 若
recordings 为空，回复当前没有录音记录。
- 默认按
created_at 倒序展示或筛选。
- 查询转写内容时，只保留
status = "transcribed" 且 has_transcript = true 的录音。
- 若用户只是查询录音列表，可以展示所有录音，并标出未转写/失败状态。
3. 意图判断
识别用户目标：
- 列表查询：如"有哪些录音"、"列一下录音"。展示录音列表，不读取全文。
- 范围查询：如"最新一条"、"今天的"、"最近 N 条"、"全部"。按范围锁定录音。"最新一条"可直接用快捷命令
yoooclaw recording +latest --format json。
- 精确查询：用户给出 ID、名称、时间。按
id、name、created_at、文件名片段精确或模糊匹配。
- 内容问答/搜索：如"这段录音说了什么"、"有没有提到 X"、"总结一下最新录音"。锁定录音后读取转写文件回答。
若目标录音不明确且存在多条候选，展示候选列表并暂停等待用户选择：
1. [name] ([created_at], [duration])
2. [name] ([created_at], [duration])
询问："请问要查询哪一条录音？可以回复序号、ID、名称，或 all。"
支持用户回复 1,3、1-3、all。
4. 定位文件
对每条选中的录音，调用：
yoooclaw recording status <recording_id> --format json
返回的 recording 对象含 transcriptFile / summaryFile / srtFile / audioFile 等字段（均为相对 storage-path 的路径）。优先使用 transcriptFile，读取：
<path>/<transcriptFile>
若 transcriptFile 为空或文件不存在，告知用户该录音的转写文件尚未生成或已被删除。
AI 总结文件按需读取：
- 当用户明确问"总结文件"、"AI 总结"、"摘要文件"时，读取
<path>/<summaryFile>。
- 普通内容问答优先读取
transcriptFile 转写文件。
5. 回答方式
列表查询
输出精简列表：
1. 名称：...
ID：...
时间：...
时长：...
状态：...
转写：有/无
不要输出大段 JSON，除非用户明确要求原始数据。
内容查询
读取锁定的 Markdown 转写文件后，根据用户问题回答：
- 优先基于转写原文，不要凭记忆或外部搜索补全。
- 可引用少量原文片段，但不要整段复制长转写。
- 若录音中未提到相关信息，明确说明"转写中未找到"。
- 多条录音查询时，按录音分组回答，并标明录音名称或 ID。
摘要查询
若读取的是 summaryFile 总结文件，说明来源是总结文件；若没有总结文件但读取了转写文件，则基于转写生成简短摘要，并说明"未找到已有总结文件，以下根据转写整理"。
6. 排查「转写迟迟不出来」
用户追问进度、或某条录音长期停在非 transcribed 状态时，查状态事件流（JSONL，纯读磁盘）：
yoooclaw recording events --since 1h --format json
yoooclaw recording events --id <recording_id> --format json
yoooclaw recording events --since 24h --limit 500 --format json
--since 接受 10m / 1h / 24h / 7d 形式；返回 {ok, path, total, events}。
根据事件里最后一次流转判断卡在哪一环，再据此回复用户（还在传 / 正在转写 / 已失败及原因）。
若所有录音都从未进入 transcribing，多半是 ASR 没配置，提示用户运行：
yoooclaw recording setup-asr
本 Skill 只查询，不要替用户执行 setup-asr（它会写配置），告知命令即可。
7. 边界处理
- 未转写：
status != "transcribed" 或 has_transcript != true 时，按第 2 节的状态语义告知当前进展并建议稍后再试；需要细节时用 recording events 佐证。
- 转写失败：
status = "transcribe_failed"，展示 error 字段中的失败原因。
- 文件不存在：说明索引存在但本地文件缺失，可能被删除或尚未同步完成。
- 大量录音：若用户请求"全部"且数量很多，先展示数量并询问是否继续读取全文；列表查询不需要确认。
- 只读约束：本 skill 只查询和读取文件，不写入、不删除、不重命名录音。
- 错误 schema：命令失败统一输出
{"ok":false,"error":{"code":"YOOOCLAW_...","message":"...","hint":"..."}} 并以非零退出码结束，按 message / hint 处理。
