AI Harness 开发路线图
用户文档见 AI 智能引擎（Harness）。
进度总览
| 阶段 | 状态 |
|---|---|
| Step 0～5：Pipeline · Memory · Skills · UI · Loop · 打包 | ✅ 已完成 |
| Step 6：incident → guard/skill 半自动建议 | ✅ 已完成 |
Step 6 说明
generateAiHarnessSuggestionsApi：聚合最近 incident，规则生成 guard/skill 建议applyAiHarnessSuggestionApi：用户确认后写入护栏或 Skill（不自动静默修改）- 工作台：智能引擎 → 事件日志 → 生成建议 → 应用
性能优化清单
| 优化 | 说明 |
|---|---|
| Embedding LRU 缓存 | 同文本 5min 内不重复请求 |
| Embedding 超时 | 默认 8s，避免阻塞 LLM |
| 记忆召回缓存 | session+query 60s 复用召回块 |
| 跳过 tool feedback 轮 | BizApi loop 中间轮不调 embedding |
| 单次 vec 检索 | session + global 合并查询 |
| Brute 降级 SQL 过滤 | scope=global OR session |
| 经验/事件异步写入 | setImmediate 不阻塞 autoexec |
| Skills 内存缓存 | beforeLlm 无 DB IO |
| 会话摘要异步 | SessionSummarizer 不阻塞 LLM |
| ctx.harnessCfg | beforeLlm 单次读配置 |
| sessionMemory 预取 | compact + state 少一次 DB |
| 护栏正则编译缓存 | guard 变更时 invalidate |
| SQL prepare 复用 | AiMemoryStore 预编译语句 |
| catalog 热路径 | 已加载则 getBizApiDocCatalog() 同步读 |
关键文件索引
| 路径 | 职责 |
|---|---|
src/main/ai/harness/incident/analyzeHarnessIncidents.ts | 事件规则聚合 |
src/main/ai/harness/incident/AiHarnessSuggestionService.ts | 建议生成与应用 |
src/main/ai/harness/AiHarnessPipeline.ts | 编排 |
docs/guide/ai-harness.md | 用户文档 |