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:
@@ -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 & embedding</td>
|
||||
<td>Face detection & 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">"</span><span class="nv">$API</span><span class="s2">/api/v1/progress/</span><span class="nv">$FILE_UUID</span><span class="s2">"</span><span class="w"> </span>-H<span class="w"> </span><span class="s2">"X-API-Key: </span><span class="nv">$KEY</span><span class="s2">"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span><span class="s1">'{overall_progress, processors: [.processors[] | {name, status}]}'</span>
|
||||
|
||||
Reference in New Issue
Block a user