核心用法
Pocket Transcripts 是一个针对 Pocket AI 硬件录音设备的第三方数据访问工具，通过逆向工程官方 Web API 实现录音转录文本、智能摘要和行动项的检索功能。
主要功能：
get_recordings()- 按时间范围列出录音，支持分页过滤get_recording_full()- 获取完整数据（转录文本 + 摘要 + 行动项）search_recordings()- 文本搜索历史录音- 数据模型涵盖录音元信息（时长、位置、标签、说话人数量）及结构化摘要
技术实现：
- 依赖 Chrome 浏览器用户配置文件启动
- 从
app.heypocket.com登录状态中提取 Firebase Bearer Token - Token 有效期仅1小时，需手动刷新
- 调用
production.heypocketai.com/api/v1端点
显著优点
- 硬件生态整合：直接对接 Pocket AI 专用录音设备，填补官方 API 开放度不足
- 结构化输出：提供 Markdown 格式摘要、行动项列表等即用型数据
- 元数据丰富：包含地理定位、说话人识别、自动标签等维度
- 搜索能力：支持跨录音内容检索
潜在缺点与局限性
1. 认证脆弱性：依赖浏览器手动登录 + Token 提取，流程繁琐且 Token 仅1小时有效期
2. 非官方方案：逆向工程 API 可能随时失效，无稳定性保障
3. 隐私风险：Token 存储于本地明文文件 ~/.pocket_token.json
4. 环境依赖：必须保持 Chrome 浏览器持续运行且登录状态有效
5. 无官方 SLA：数据访问受限于官方服务可用性
适合人群
- 已购买 Pocket AI 硬件设备的用户
- 需要将录音数据导入其他工作流（笔记、CRM、任务管理）的自动化需求者
- 能接受非官方方案风险的技术用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 服务中断 | 官方 API 变更将导致功能失效 |
| 数据安全 | Token 本地明文存储，存在泄露风险 |
| 隐私合规 | 录音内容涉及第三方时需注意 consent 合规 |
| 授权争议 | 逆向工程可能违反服务条款 |
> ⚠️ 此技能未经过正式安全扫描，实际部署前建议审查 scripts/reader.py 中的网络请求实现及 Token 存储机制。