admin/momentry_core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update docs_v1.0/ documentation

Browse Source 
- Fix markdown lint issues (MD030, MD047, MD051, MD028, MD005)
- Update AI agents, architecture, implementation docs
- Add new identity, face recognition, and API documentation
- Remove deprecated face/person API guides
This commit is contained in:
Warren
2026-04-30 15:10:41 +08:00
parent 8f05a7c188
commit 4d75b2e251
185 changed files with 21071 additions and 1605 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs_v1.0/AI_AGENTS/CONTEXT/METADATA_PROCESSORS.md
View File

@@ -193,7 +193,7 @@ GROUP BY metadata_version;
| `person_id` | varchar(255) | 人物唯一 ID (如 person_001) |
| `name` | varchar(255) | 人物名稱 (可確認) |
| `speaker_id` | varchar(255) | 對應的說話者 ID |
| `video_uuid` | varchar(255) | 影片 UUID |
| `file_uuid` | varchar(255) | 影片 UUID |
| `face_identity_id` | integer | 對應的 global identity |
| `appearance_count` | integer | 出現次數 |
| `first_appearance_time` | double | 首次出現時間 |
@@ -264,13 +264,13 @@ Step 4: Global Matching
-- 取得影片中的人物列表
SELECT person_id, name, speaker_id, appearance_count
FROM dev.person_identities
WHERE video_uuid = '384b0ff44aaaa1f1'
WHERE file_uuid = '384b0ff44aaaa1f14cb2cd63b3fea966'
ORDER BY appearance_count DESC;
-- 取得 chunk 的人物
SELECT c.chunk_id, pi.name, pi.speaker_id
FROM dev.chunks c
JOIN dev.person_identities pi ON c.uuid = pi.video_uuid
JOIN dev.person_identities pi ON c.uuid = pi.file_uuid
WHERE c.chunk_id = 'sentence_0001';
```
@@ -280,7 +280,7 @@ WHERE c.chunk_id = 'sentence_0001';
-- 取得某 chunk 的人物
SELECT pi.name, pi.speaker_id, pi.appearance_count
FROM dev.person_identities pi
JOIN dev.chunks c ON c.uuid = pi.video_uuid
JOIN dev.chunks c ON c.uuid = pi.file_uuid
WHERE c.chunk_id = 'sentence_0001';
```
@@ -484,19 +484,19 @@ SELECT COUNT(*) FROM dev.chunks WHERE visual_stats IS NOT NULL;"
```bash
# Step 1: ASRX 執行說話者分離
python scripts/asrx_processor.py --uuid 384b0ff44aaaa1f1
python scripts/asrx_processor.py --uuid 384b0ff44aaaa1f14cb2cd63b3fea966
# Step 2: Face 執行臉部偵測
python scripts/analyze_video_faces.py --uuid 384b0ff44aaaa1f1
python scripts/analyze_video_faces.py --uuid 384b0ff44aaaa1f14cb2cd63b3fea966
# Step 3: Auto-identify 建立影片級人物
python scripts/auto_identify_persons.py --uuid 384b0ff44aaaa1f1
python scripts/auto_identify_persons.py --uuid 384b0ff44aaaa1f14cb2cd63b3fea966
# Step 4: 全局 Identity 比對 (需累積一定數量的 face_identities)
python scripts/match_faces_to_identities.py
# Step 5: 重新生成 chunk 5W1H (包含新的 identity 資訊)
python scripts/generate_chunk_summaries.py --uuid 384b0ff44aaaa1f1
python scripts/generate_chunk_summaries.py --uuid 384b0ff44aaaa1f14cb2cd63b3fea966
```
### 檢查待處理狀態
@@ -515,7 +515,7 @@ WHERE face_ids IS NOT NULL AND array_length(face_ids, 1) > 0;"
# 檢查 person_identities
psql -h localhost -U accusys -d momentry -c "
SELECT COUNT(*) FROM dev.person_identities
WHERE video_uuid = '384b0ff44aaaa1f1';"
WHERE file_uuid = '384b0ff44aaaa1f14cb2cd63b3fea966';"
# 檢查 face_identities (全局)
psql -h localhost -U accusys -d momentry -c "
@@ -560,4 +560,4 @@ SELECT COUNT(*) FROM dev.face_identities;"
2. **face_ids** → 進入 `chunk_identity.faces`
3. **person_identities** → 進入 `chunk_identity.person_name`
確保 LLM 產生的 5W1H 包含最新的角色資訊。
確保 LLM 產生的 5W1H 包含最新的角色資訊。