| name | yoooclaw-recording-translation |
| description | 将文本文件和录音转录文件翻译为指定目标语言。支持两阶段翻译（提取术语表后翻译），保留时间戳标记，输出 Markdown sidecar 文件。当用户要求"翻译录音""翻译成[语言]""翻译文件""查看我的转录文件""用[语言]整理"时激活。基于录音时用 yoooclaw CLI 定位文件；yoooclaw 是 openclaw 手机录音插件的独立 CLI 形态，数据在 ~/.yoooclaw 下。 |
yoooclaw 多语言翻译（Agent-Native）
命令名 yoooclaw，短别名 yc 完全等价。所有命令支持 --format json|pretty|table|ndjson，本 Skill 取结构化对象用 --format json。
录音数据在 ~/.yoooclaw 下，查询纯读磁盘、不需要 daemon 在跑；定位/读写文件用你自己的文件工具，不要假设目录。
1. 初始化与定位
若用户请求中包含明确文件路径：
若未提供文件路径：
不要假设录音目录。调用以下命令获取存储路径：
yoooclaw recording storage-path --format json
后续所有文件操作以返回的 path 为根目录：
- 转写文件：来自
recording status 的 transcriptFile，即 <path>/<transcriptFile>。
- 翻译输出：
<path>/translation/<date>_<brief_summary>_translation_<lang>.md
2. 意图解析与列表定位
若已在 Step 1 获得明确文件路径，跳过本节，直接进入 Step 3。
2.1 确定目标语言与范围
从用户请求中识别以下信息：
目标语言 (lang_code)：
- 识别
en (英文), ja (日语), ko (韩语), fr (法语), es (西班牙语), de (德语) 等。
- 若未指定：直接询问用户。
目标录音范围：
- 具体 ID/名称 -> 精确匹配。
- "刚才"、"最新" -> 取最近 1 条（可直接用
yoooclaw recording +latest --format json）。
- "最近 N 条" -> 取最近 N 条。
- "全部" -> 全量处理。
- 若未提及：执行 2.2 展示列表。
2.2 获取列表与交互选择
yoooclaw recording list --status transcribed --format json
过滤与排序：
- 只保留
status = "transcribed" 且 has_transcript = true 的录音。
- 按
created_at 倒序。
交互选择：
若范围不明确，按序号展示过滤后的列表：
1. [名称] ([时间], [时长])
等待用户输入序号（支持 1,3 或 1-3 或 all）。
若用户表示找不到某条录音，说明该录音可能仍在转录中，告知用户稍后再试。
用户追问「到底卡在哪一步」时，用 yoooclaw recording events --since 24h --format json（或 --id <recording_id>）看状态事件流：synced 及之前是音频还在传，transcribing 才是正在转写，transcribe_failed 为转写失败。
3. 读取文件内容
来自录音系统（recording list 流程）：根据选定的 recording_id 获取具体路径：
yoooclaw recording status <recording_id> --format json
读取返回 recording.transcriptFile 对应的 <path>/<transcriptFile>。
若文件不存在或读取失败，告知用户：「转写文件尚未生成，对应的音频可能正在转写中，请稍后再试。」
- 单条录音：终止处理。
- 批量处理：跳过该条，继续处理其余录音。
来自用户指定路径：直接读取该文件。若文件不存在，告知用户该文件未找到，对应的音频可能仍在转写中，请稍后再试。
注意：必须完整保留 **[关键点 MM:SS]** 标记，用于后续翻译校对。
4. 两阶段翻译流程
4.1 第一阶段：上下文与术语提取
若文本 > 50 字，先提取背景。
提示词要点：
- 提取
domain (领域), tone (语气), glossary (术语表)。
- 术语表应包含人名、公司名、专业名词及缩写。
- 返回纯 JSON。
4.2 第二阶段：全文翻译
使用第一阶段的上下文和术语表进行翻译。
强制规则：
- 严禁修改
**[关键点 MM:SS]** 标记。
- 翻译元数据标签（如 "录音名称"），但保留时间/日期数值。
- 保持 Markdown 结构（标题、引用块、分隔线）。
- 术语一致性：必须严格遵守提取的术语表。
5. 写入与反馈
5.1 写入翻译文件
用你自己的文件写入工具直接写出：
来自录音系统：写入 <path>/translation/<date>_<brief_summary>_translation_<lang>.md
来自用户指定文件：写入源文件同目录，如 /path/to/<basename>_translation_<lang>.md
若已存在，直接覆盖并在反馈中说明。
5.2 任务汇报
简洁汇报处理结果：
- 翻译语言及处理数量。
- 每条录音的领域、术语识别数及输出文件名。
- 若上下文提取失败，注明"已使用基础模式"。
边界处理
- 源语言=目标语言：提示无需翻译并终止。
- 存储路径无效：若用户未指定文件路径，告知录音功能不可用；若已指定路径则不受影响。
- 转写内容过短：跳过术语提取，直接执行翻译。
- 路径缺失：若
transcriptFile 为空，跳过并记录。
