provenance

name	provenance
description	收集系统全链路操作日志，生成可追溯的执行证据链与向量索引，是多智能体系统可观测性与安全审计的底座。
assign_when	该 Worker 负责记录每一次分发、扫描、解析与卡片生成事件，为系统提供端到端留痕与可观测能力。

Provenance 留痕 Skill（太史阁）

使用方式

• 由各官署在关键操作节点调用（或通过事件总线异步推送），写入证据链。
• 提供按 trace_id / 时间窗 / 官署维度的检索接口，支撑审计面板与回滚定位。

输入（Input）

• event：操作事件，含 actor（官署名）、action、target、timestamp、trace_id
• payload：（可选）与事件关联的结构化产物引用

输出（Output）

• evidence_chain：按 trace_id 串联的可追溯证据链
• vector_index：用于语义检索的向量索引条目
• query_api：按条件检索历史证据的接口描述

依赖（Dependencies）

• Qdrant（向量存储，经 MCP 接入）
• SQLite（结构化事件落地，本地兜底）
• 各官署的事件上报协议（统一 schema）

失败处理（Failure Handling）

• 向量库写入失败 → 本地 SQLite 缓存事件，恢复后异步补写，不阻塞主流程。
• 单条事件 schema 非法 → 记录并丢弃该条，不影响整链写入。
• 检索超时 → 返回最近一次成功快照并标注 stale。

复用价值（Reuse Value）

• 可观测性底座：任何多 Agent 系统都能直接挂载，获得开箱即用的审计与回放能力。
• 契合评审：Agent Infra 赛道「工程落地与运行验证及安全审计（20%）」维度的天然得分点。

复赛代码包执行（runnable package）

• 真实入口：scripts/run_provenance.py
• 执行等价于 core.runtime.AgentSession.run_stage("provenance")，调用 memory.taishige.TaiShiGeAgent.writeback（把全链路事件与四色卡片回流证据链，纯 Python 可离线）。
• 运行：python skills/provenance/scripts/run_provenance.py
• 产物：examples/snse_survey/provenance/（trace.jsonl + trace_summary.json，含每一条军机处派发与官署执行事件）。