单Agent运行时安全诊断框架 · v4.0 MVP
认知导航是为单个AI Agent设计的运行时安全诊断系统，提供实时健康度评估、全链路追踪和会话级上下文压缩能力。
v4.0 核心新增：V4.0 上下文压缩引擎（Loop 2），实现智能分级裁剪，在保留诊断功能的前提下，显著降低 Token 成本。
认知导航以轻量级 Hook 形式嵌入 Agent 执行循环，在三个关键节点进行实时诊断：
flowchart TD
A[Agent 接收任务] --> B{决策前诊断}
B -->|S值健康| C[执行动作]
B -->|S值异常| D[导航指令干预]
D -->|NARROW_SCOPE| C
D -->|HALT| E[暂停并请求人工介入]
C --> F{执行后诊断}
F -->|T消耗合理| G[验证结果]
F -->|T消耗异常| H[记录操作代价]
G --> I{验证后诊断}
I -->|S值改善| J[继续下一轮]
I -->|S值下降| K[触发 RESET_CONTEXT]
K --> L[V4.0 上下文裁剪]
L --> J
J --> A
Hook 注入点说明：
- ① 决策前：当前S值是否健康？决定是否允许执行。
- ② 执行后：T消耗是否合理？记录操作代价。
- ③ 验证后：S值是否改善？判断操作是否有效。
认知导航以轻量级 Hook 形式嵌入 Agent 执行循环，在三个关键节点进行实时诊断：
flowchart TD
A[Agent 接收任务] --> B{决策前诊断}
B -->|S值健康| C[执行动作]
B -->|S值异常| D[导航指令干预]
D -->|NARROW_SCOPE| C
D -->|HALT| E[暂停并请求人工介入]
C --> F{执行后诊断}
F -->|T消耗合理| G[验证结果]
F -->|T消耗异常| H[记录操作代价]
G --> I{验证后诊断}
I -->|S值改善| J[继续下一轮]
I -->|S值下降| K[触发 RESET_CONTEXT]
K --> L[V4.0 上下文裁剪]
L --> J
J --> A
Hook 注入点说明：
- ① 决策前：当前S值是否健康？决定是否允许执行。
- ② 执行后：T消耗是否合理？记录操作代价。
- ③ 验证后：S值是否改善？判断操作是否有效。
| 能力 | 说明 |
|---|---|
| 实时诊断 | T/C/D/S 健康度计算 + 四色警戒区 + 导航指令 |
| Langfuse 追踪 | 全链路 Trace 自动上报，实时可视化 |
| V4.0 上下文压缩 | 智能分级裁剪，大幅降低 Token 成本 |
| 多轮会话记忆 | session_id 实现多轮对话上下文保持 |
| 多会话隔离 | 不同 session 完全隔离，互不干扰 |
| S_memory 监控 | 记忆健康度实时反馈 |
| FastAPI 服务 | RESTful API + Swagger 文档 |
| 批量诊断 | /batch-diagnosis 接口 |
| 测试场景 | 关键信息保留率 | Token 压缩 | 对齐率 |
|---|---|---|---|
| 客服长会话（50轮） | >90% | ~60% | 100% |
| 编程协作（8 Agent） | — | ~40% | 100% |
核心结论：V4.0 与实时诊断无缝连接，在保留核心诊断输出的前提下，实现显著的 Token 成本优化。
git clone https://github.com/wwreixi/agent-trace-diagnostics.git
cd agent-trace-diagnosticspython -m venv venv
source venv/bin/activate # Windows: venv\Scripts�ctivate
pip install -r requirements.txtcp .env.example .env
# 编辑 .env，填入你的 API Keyuvicorn main:app --reload --host 0.0.0.0 --port 8000curl -X POST "http://localhost:8000/diagnosis" -H "Content-Type: application/json" -d '{"query": "2026年AI安全法规有哪些最新进展？", "session_id": "test_001"}'http://localhost:8000/docs
- AI群协作导航 — 多Agent群协作合规质量验证与实时干预
MIT
- 作者：wwreixi
- 邮箱：wwreixi@163.com
- GitHub：@wwreixi