docs: update TKG, profile, identity module docs with trace management and external_id fix

- 15_tkg.md: external_id format changed to trace_N, added trace management section (delete/restore/merge)
- 18_profile.md: note external_id matching fix
- 07_identity.md: note bind/unbind external_id fix
- regenerated user docs (doc/)
This commit is contained in:
Accusys
2026-07-21 03:22:09 +08:00
parent 52bec30c90
commit 644516769c
7 changed files with 237 additions and 29 deletions
+27 -16
View File
@@ -310,34 +310,45 @@ curl<span class="w"> </span>-s<span class="w"> </span>-X<span class="w"> </span>
<td>6</td>
<td><code>face</code></td>
<td>—</td>
<td>Face detection &amp; embedding</td>
<td>Face detection &amp; embedding (8Hz sampling)</td>
</tr>
<tr>
<td>7</td>
<td><code>pose</code></td>
<td>—</td>
<td>Pose estimation</td>
<td><code>face_trace</code></td>
<td>face</td>
<td>Face tracking (IoU + embedding, assigns trace_id)</td>
</tr>
<tr>
<td>8</td>
<td><code>visual_chunk</code></td>
<td>yolo</td>
<td>Visual scene chunks</td>
<td><code>pose</code></td>
<td>face_trace</td>
<td>Pose expansion from face traces, inherits trace_id</td>
</tr>
<tr>
<td>9</td>
<td><code>story</code></td>
<td>asr, asrx, cut, yolo, face</td>
<td>Scene summaries (template)</td>
</tr>
<tr>
<td>10</td>
<td><code>5w1h</code></td>
<td>story</td>
<td>5W1H analysis (Gemma4 LLM)</td>
<td><code>appearance</code></td>
<td>pose</td>
<td>Appearance expansion from pose traces, inherits trace_id</td>
</tr>
</tbody>
</table>
<p><strong>Key Concepts:</strong>
- <strong>Face</strong> = Identity anchor (who is this person?) — requires high-quality embedding
- <strong>Pose</strong> = Tracking (where is this person?) — extends tracking when face is occluded
- <strong>Appearance</strong> = Tracking (what do they look like?) — extends tracking when pose is occluded</p>
<p><strong>Trace ID Inheritance:</strong></p>
<div class="codehilite"><pre><span></span><code><span class="n">Face</span><span class="w"> </span><span class="n">trace</span><span class="w"> </span><span class="p">(</span><span class="n">identity</span><span class="w"> </span><span class="err">anchor</span><span class="p">)</span>
<span class="w"> </span><span class="err">↓</span><span class="w"> </span><span class="n">inherits</span><span class="w"> </span><span class="n">trace_id</span>
<span class="n">Pose</span><span class="w"> </span><span class="n">expansion</span><span class="w"> </span><span class="p">(</span><span class="n">tracking</span><span class="w"> </span><span class="err">continuity</span><span class="p">)</span>
<span class="w"> </span><span class="err">↓</span><span class="w"> </span><span class="n">inherits</span><span class="w"> </span><span class="n">trace_id</span>
<span class="n">Appearance</span><span class="w"> </span><span class="n">expansion</span><span class="w"> </span><span class="p">(</span><span class="n">tracking</span><span class="w"> </span><span class="err">continuity</span><span class="p">)</span>
</code></pre></div>
<p><strong>Frame Count Relationship:</strong></p>
<div class="codehilite"><pre><span></span><code>face frames ≤ pose frames ≤ appearance frames
</code></pre></div>
<p>(Each level expands outward from the previous level's traces)</p>
<p>All processors except <code>story</code> and <code>5w1h</code> run concurrently when their dependencies are met. Story and 5W1H run sequentially after their prerequisites.</p>
<h4>Example</h4>
<div class="codehilite"><pre><span></span><code>curl<span class="w"> </span>-s<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$API</span><span class="s2">/api/v1/progress/</span><span class="nv">$FILE_UUID</span><span class="s2">&quot;</span><span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;X-API-Key: </span><span class="nv">$KEY</span><span class="s2">&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span><span class="s1">&#39;{overall_progress, processors: [.processors[] | {name, status}]}&#39;</span>