asabovetech-pocket-ai

跨会议与通话的语音转录、语义搜索与会议智能，通过 Pocket AI API 检索记忆与行动项。

## 概述（中文）

跨会议与通话的语音转录、语义搜索与会议智能，通过 Pocket AI API 检索记忆与行动项。

## 技能正文

# Pocket AI Skill

**跨所有对话的语音录音转录、语义搜索和会议智能。**

Pocket AI 通过可穿戴设备捕获你的会议、通话和想法，然后转录并索引所有内容以进行语义搜索。

## 快速参考

| 项目 | 值 |
|------|-------|
| API Base | `https://public.heypocketai.com/api/v1` |
| API Key | `~/.config/pocket-ai/api_key` |
| Auth | Bearer token |
| Docs | https://docs.heypocketai.com/docs/api |

## 核心能力

### 1. 语义搜索（最强大）
按含义而非仅按关键字跨所有录音进行搜索。

```bash
curl -s -X POST \
  -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  -H "Content-Type: application/json" \
  -d '{"query": "your company manufacturing decisions"}' \
  "https://public.heypocketai.com/api/v1/public/search"
```

**返回：**
- `userProfile.dynamicContext[]` — 由 AI 从所有录音构建的洞察
- `relevantMemories[]` — 匹配的转录文本、行动项、会议章节
- 说话人识别、时间戳、相关性分数

### 2. 行动项提取
Pocket AI 自动从会议中提取行动项。搜索它们：

```bash
curl -s -X POST \
  -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  -H "Content-Type: application/json" \
  -d '{"query": "action items tasks follow up"}' \
  "https://public.heypocketai.com/api/v1/public/search"
```

### 3. 列出标签
```bash
curl -s -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  "https://public.heypocketai.com/api/v1/public/tags"
```

### 4. 列出录音
```bash
curl -s -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  "https://public.heypocketai.com/api/v1/public/recordings"
```

### 5. 获取录音详情
```bash
curl -s -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  "https://public.heypocketai.com/api/v1/public/recordings/{recording_id}"
```

### 6. 下载音频
```bash
curl -s -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  "https://public.heypocketai.com/api/v1/public/recordings/{recording_id}/audio"
```

---

## 高价值查询模式

### 联系人上下文
*“与 [某人] 讨论过什么？”*
```json
{"query": "conversations with Dylan Acquisition.com"}
{"query": "Adrienne intercompany invoices discussion"}
{"query": "meetings with Charlene"}
```

### 业务决策
*“关于 [某主题] 做了什么决策？”*
```json
{"query": "your company manufacturing team restructuring decisions"}
{"query": "entity streamlining strategy"}
{"query": "trading system rules discussed"}
```

### 行动项与跟进
*“需要做什么？”*
```json
{"query": "action items tasks todo follow up"}
{"query": "scheduled meetings upcoming"}
{"query": "things to review or approve"}
```

### 个人洞察
*“我关于 [某主题] 说过什么？”*
```json
{"query": "trading psychology patience discipline"}
{"query": "family financial planning kids college"}
{"query": "team performance frustrations"}
```

### 会议摘要
*“在 [某类会议] 中发生了什么？”*
```json
{"query": "your company staff meeting summary"}
{"query": "financial review discussion"}
{"query": "geopolitical analysis conversation"}
```

---

## 响应结构

### 搜索响应
```json
{
  "success": true,
  "data": {
    "userProfile": {
      "dynamicContext": [
        "AI-built insight from recordings...",
        "Another pattern detected..."
      ],
      "staticFacts": []
    },
    "relevantMemories": [
      {
        "content": "Transcript segment or action item...",
        "metadata": {"source": "turbopuffer", "sources": ["transcript_segment", "action_item"]},
        "recordingDate": "2026-01-28 01:16:14",
        "recordingId": "uuid",
        "recordingTitle": "Untitled Recording",
        "relevanceScore": 8.19,
        "speakers": "SPEAKER_00, SPEAKER_01",
        "transcriptionId": "uuid"
      }
    ],
    "total": 8,
    "timing": 490
  }
}
```

### 记忆内容类型
- **转录片段：** `[timestamp] SPEAKER_XX: actual words spoken`
- **行动项：** `Action item: Do the thing`
- **会议章节：** `(start-end) Section Title - Summary of what was discussed`

---

## 集成点

### Athena（家庭代理）
- 查询会议上下文以了解你的可用精力
- “我有空吗？” → 检查最近的录音是否显示繁重的承诺
- 将会议洞察输入排程决策

### 每日简报
- 拉取昨天会议中的行动项
- 总结所做的关键决策
- 标记紧急的跟进事项

### 任务管理
- 自动将行动项浮现为潜在任务
- 与现有待办列表交叉引用
- 跟踪那些被提及但尚未付诸行动的事项

### 运营频道
- 将重要决策发布到 #operations
- 对关键讨论（团队变更、财务决策）发出警报

---

## 标签（你的类别）

当前标签：`ai`、`business`、`call`、`economy`、`finance`、`game`、`geopolitics`、`hockey`、`outlook`、`personal`、`sales`、`summary`、`test`、`victory`、`weather`、`work`

使用标签来过滤或归类查询。

---

## 心跳集成

在心跳期间，可选地检查新的行动项：

```python
# Check for recent action items (last 24h)
query = "action items from today"
# Parse response for new follow-ups
# Surface anything urgent
```

---

## 隐私与安全

- 所有录音端到端加密
- 存储在美国服务器上
- API 密钥应保留在 `~/.config/pocket-ai/api_key`
- 切勿将完整转录文本记录到公共频道

---

## 故障排查

**录音列表为空？**
- 录音可能需要设备同步后才能通过 API 访问
- 改用搜索端点（适用于已同步的转录文本）

**认证错误？**
- 检查 Bearer token 格式：`Authorization: Bearer pk_xxx`
- 验证 `~/.config/pocket-ai/api_key` 中的密钥

**搜索返回空？**
- 尝试更宽泛的查询词
- 检查录音是否最近已同步

---

## 辅助脚本

### search.sh
```bash
#!/bin/bash
# Usage: ./search.sh "your query"
API_KEY=$(cat ~/.config/pocket-ai/api_key)
curl -s -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\": \"$1\"}" \
  "https://public.heypocketai.com/api/v1/public/search"
```

### Python 辅助脚本
完整的 Python 集成见 `pocket_api.py`。