wavecap-search

majiayu000 的头像作者 majiayu000

使用文本查询和过滤器搜索 WaveCap 转录。当用户想要查找特定转录、搜索关键字或查询转录历史记录时使用。

📖 中文导读:使用文本查询和过滤器搜索 WaveCap 转录。当用户想要查找特定转录、搜索关键字或查询转录历史记录时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: wavecap-search description: Search WaveCap transcriptions with text queries and filters. Use when the user wants to find specific transcriptions, search for keywords, or query transcription history.

WaveCap Search Skill

Use this skill to search through transcription history in WaveCap.

Search Transcriptions for a Stream

curl -s "http://localhost:8000/api/streams/{STREAM_ID}/transcriptions?search=fire&limit=20" | jq

Search Parameters

Parameter Type Default Description
search string - Text to search for in transcriptions
limit int 100 Maximum results to return
before ISO8601 - Get transcriptions before this timestamp
after ISO8601 - Get transcriptions after this timestamp
order string desc Sort order: asc or desc

Search with Time Range

# Search in the last hour
AFTER=$(date -u -v-1H +"%Y-%m-%dT%H:%M:%SZ")
curl -s "http://localhost:8000/api/streams/{STREAM_ID}/transcriptions?search=emergency&after=$AFTER" | jq
# Search within a specific date range
curl -s "http://localhost:8000/api/streams/{STREAM_ID}/transcriptions?search=incident&after=2025-01-15T00:00:00Z&before=2025-01-16T00:00:00Z" | jq

Pagination

The response includes pagination hints:

{
  "transcriptions": [...],
  "hasMoreBefore": true,
  "hasMoreAfter": false
}

To get the next page:

# Get the timestamp of the last result, then use it as 'before'
LAST_TIMESTAMP="2025-01-15T12:30:00Z"
curl -s "http://localhost:8000/api/streams/{STREAM_ID}/transcriptions?before=$LAST_TIMESTAMP&limit=20" | jq

Search Across All Streams

To search across all streams, first get the stream list, then query each:

# Get all stream IDs
STREAMS=$(curl -s "http://localhost:8000/api/streams?includeTranscriptions=false" | jq -r '.[].id')

# Search each stream
for STREAM_ID in $STREAMS; do
  echo "=== Stream: $STREAM_ID ==="
  curl -s "http://localhost:8000/api/streams/$STREAM_ID/transcriptions?search=YOUR_QUERY&limit=5" | jq '.transcriptions[] | {timestamp, text}'
done

Format Search Results

Show just text and timestamps

curl -s "http://localhost:8000/api/streams/{STREAM_ID}/transcriptions?search=fire" | \
  jq '.transcriptions[] | "\(.timestamp): \(.text)"' -r

Show with confidence scores

curl -s "http://localhost:8000/api/streams/{STREAM_ID}/transcriptions?search=ambulance" | \
  jq '.transcriptions[] | {time: .timestamp, text, confidence: (.confidence * 100 | floor | tostring + "%")}'

Filter by confidence threshold

curl -s "http://localhost:8000/api/streams/{STREAM_ID}/transcriptions?limit=50" | \
  jq '[.transcriptions[] | select(.confidence > 0.8)] | length'

Transcription Fields

Each transcription contains:

{
  "id": "uuid",
  "streamId": "stream-id",
  "text": "transcribed text",
  "timestamp": "2025-01-15T12:30:00Z",
  "confidence": 0.95,
  "duration": 30.5,
  "segments": [...],
  "recordingUrl": "/recordings/file.wav",
  "reviewStatus": "pending",
  "correctedText": null,
  "alerts": [...]
}

Tips

  • The search is case-insensitive
  • Use order=asc to get oldest results first (useful for timeline analysis)
  • Combine after and before for precise time windows
  • Large result sets should use pagination to avoid timeouts