mcpField
A
apple-voice-memos

apple-voice-memos

github.com/jessedc生产力19140 次安装15 周前更新
代码仓库

关于 apple-voice-memos

apple-voice-memos 是用于查找和处理通过 iCloud 同步的 Apple Voice Memos 转录文本的技能，面向需要整理录音内容的用户。它提供元数据筛选和从音频文件提取带时间戳文本的脚本。

主要功能

  1. 01查询录音元数据并输出 CSV
  2. 02按关键词或日期筛选录音
  3. 03从 .m4a 文件提取转录文本
  4. 04整理时间戳、段落与填充词

适用场景

  1. 01查找特定主题或时间段的录音
  2. 02提取录音转录文本供后续处理

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jessedc/apple-voice-memos --skill apple-voice-memos

安装后在 Claude Code 中输入/apple-voice-memos确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

PROMPT.md
scripts/
extract-apple-voice-memos-metadata
extract-apple-voice-memos-transcript

详细介绍

Apple Voice Memos

从通过 iCloud 同步的 Apple Voice Memos 中提取并处理转录文本。

前提条件

Voice Memos 必须已在 macOS 上与 iCloud 同步。

工具

此技能在其 scripts/ 目录中包含两个脚本。本文档中的脚本路径相对于此技能所在目录——你的工作目录可能在其他位置，因此请使用绝对路径调用脚本（例如：python3 <skill-dir>/scripts/extract-apple-voice-memos-metadata）。

  • extract-apple-voice-memos-metadata — 查询 CloudRecordings.db SQLite 数据库（只读），并输出包含以下列的 CSV：title、date、duration、path、has_transcript。支持可选标志：--limit N（默认值为 10）、--offset N、--search TERM、--after YYYY-MM-DD、--before YYYY-MM-DD。
  • extract-apple-voice-memos-transcript — 从 .m4a 文件的 tsrp atom 中提取嵌入的转录文本。输出带时间戳的文本，其中已去除填充词、添加智能换行，并在自然停顿处换段。

第 1 步：选择语音备忘录

运行元数据脚本以找到合适的录音。根据用户的请求选择标志：

  • 没有具体请求 → 不带标志运行（返回最近的 10 条）
  • 用户提到主题或关键词 → 使用 --search TERM
  • 用户提到时间段 → 使用 --after YYYY-MM-DD 和／或 --before YYYY-MM-DD
  • 用户想查看更多结果 → 使用 --offset N 翻页，或使用 --limit N 增加每批结果数

标志可以组合使用，例如：--search work --after 2026-01-01 --limit 5。

python3 scripts/extract-apple-voice-memos-metadata [flags]

如果用户的请求明确指向单条备忘录（例如“我最新的语音备忘录”，或搜索结果只有一条），则直接处理该备忘录，无需询问。否则，以编号列表形式展示结果，列出标题、日期和时长——对于 has_transcript = no 的备忘录，标记为“（无转录文本）”——并询问用户想处理哪条备忘录。

错误处理：

  • “Database not found” → 此 Mac 上未启用 Voice Memos 的 iCloud 同步。

第 2 步：提取并处理转录文本

启动一个具有全新上下文的子 Agent 来提取并处理转录文本。不要先自行运行转录脚本——让子 Agent 提取，可避免完整转录文本进入主对话上下文。子 Agent 的提示词必须包含：

  1. 所选录音的 title 和 path 值（来自元数据输出）
  2. 此技能的 scripts/extract-apple-voice-memos-transcript 脚本和 PROMPT.md 的绝对路径
  3. 以下说明：使用录音路径运行转录脚本，读取 PROMPT.md，在 ## Memo Title 标题后附上备忘录标题，并在 ## Transcript 标题后附上转录文本，然后遵循完整提示词并返回生成的 Markdown 文档。

如果你的环境没有子 Agent 或任务工具，请自行完成相同工作：运行转录脚本，读取 PROMPT.md，并直接按照其中的说明处理提取出的转录文本。

只有在用户明确要求查看带时间戳的原始转录文本时，才直接运行转录脚本：

python3 scripts/extract-apple-voice-memos-transcript "<FILENAME>.m4a"

错误处理（由子 Agent 报告）：

  • “tsrp atom not found” → 此录音没有嵌入转录文本。Apple 会在设备上生成转录文本，并非所有录音都有。
  • File not found → 录音文件可能尚未同步到此 Mac。

步骤 3：呈现输出

子 Agent 将生成一份 Markdown 文档，开头为 # <Memo Title> 标题，后面依次是叙述性摘要、详细备注、补充说明和行动事项。在标题下方直接插入元数据块，然后向用户呈现输出：

# <Memo Title>

- **Date:** <date from the metadata output>
- **Duration:** <duration from the metadata output>
- **Source:** <FILENAME>.m4a

呈现输出后，询问用户是否要将其保存为 Markdown 文件。建议使用 YYYY-MM-DD-slugified-title.md 格式的文件名，该文件名根据备忘录的标题和日期生成（例如，2026-02-04-the-soul-of-a-new-machine.md）。默认保存到当前工作目录。用户可以接受建议、提供其他名称或路径、先要求调整内容，或跳过保存。

评论

支持 Markdown