名称： pocket-transcripts
描述： 读取来自 Pocket AI（heypocket.com）录音设备的转录文本和摘要。当用户需要检索、搜索或分析其 Pocket 录音、转录文本、摘要或行动项时使用。触发条件为涉及 Pocket 设备数据、对话转录、会议录音或音频笔记检索的请求。

Pocket 转录文本

通过逆向工程 API 读取 Pocket AI 设备的转录文本和摘要。

快速参考

设置（一次性）

1. 使用用户配置文件启动 Chrome

~/.factory/skills/browser/start.js --profile
# 或
~/.claude/skills/browser/start.js --profile

2. 登录 Pocket

导航至并登录：

~/.factory/skills/browser/nav.js https://app.heypocket.com

3. 提取令牌

python3 scripts/reader.py extract

令牌将保存至 ~/.pocket_token.json，有效期为 1 小时。

使用方法

列出录音

from pathlib import Path
import sys
sys.path.insert(0, str(Path.home() / '.claude/skills/pocket-transcripts/scripts'))
from reader import get_recordings, get_recording_full

recordings = get_recordings(days=30, limit=20)
for r in recordings:
    print(f"{r.recorded_at:%Y-%m-%d} | {r.duration_str} | {r.title}")

获取完整转录文本和摘要

full = get_recording_full(recording_id)

print(f"转录文本（{len(full['transcript'])} 字符）：")
print(full['transcript'][:500])

print(f"\n摘要（Markdown 格式）：")
print(full['summary'])

print(f"\n行动项：{len(full['action_items'])}")
for item in full['action_items']:
    print(f"  - {item}")

搜索录音

results = search_recordings("会议", days=90)
for r in results:
    print(f"{r.title} - {r.description[:100]}")

API 详情

基础 URL：https://production.heypocketai.com/api/v1

认证：来自浏览器 IndexedDB 的 Firebase Bearer 令牌

关键端点：
- GET /recordings - 列出录音（支持分页和筛选）
- GET /recordings/{id}?include=all - 获取包含转录文本/摘要的完整数据

数据结构：
- 转录文本：data.transcription.transcription.text
- 摘要：data.summarizations[id].v2.summary.markdown
- 行动项：data.summarizations[id].v2.actionItems.items

令牌刷新

Firebase 令牌有效期为 1 小时。过期后：

1. 确保 Chrome 正在以 --profile 参数运行
2. 确认已登录 app.heypocket.com
3. 重新运行：python3 scripts/reader.py extract

数据模型

PocketRecording

• id、title、description
• duration（秒）、duration_str（人类可读格式）
• recorded_at、created_at
• has_transcription、has_summarization
• num_speakers
• latitude、longitude（若启用位置）
• tags（字符串列表）

PocketSummarization

• summary（Markdown 格式）
• action_items（列表）
• transcript（原始文本）