文档阅读区

04 · Implementation Plan (v0.5 Upgrade)

v0.4 已经把事件采集链路 + schema/规则包 + 合规审计搭起来。v0.5 的升级主线是：
LLM 作为"解释器/写作者"（只读 AI，低风险）。

Phase 0 – 冻结 v0.4（必须先做）

把 v0.4 文档整体移动到：docs/legacy/v0.4/（只读冻结）
新建：docs/v0.5/（包含所有 v0.5 文档）
在 Core CI 中保留 v0.4 的回归用例（安装示范 App 跑通）

Phase 1 – Prompt Registry（v0.5 核心）

目标：Core 提供 Prompt 模板管理系统。

1.1 数据模型

新增：prompt_templates 表
字段：id, app_id, name, version, template, variables, output_schema, status, created_at, updated_at

1.2 API

GET /api/v1/prompts/templates - 查询 Prompt 模板列表
GET /api/v1/prompts/templates/{id} - 查询 Prompt 模板详情
POST /api/v1/prompts/templates - 创建 Prompt 模板
PUT /api/v1/prompts/templates/{id} - 更新 Prompt 模板
DELETE /api/v1/prompts/templates/{id} - 删除 Prompt 模板
POST /api/v1/prompts/render - 渲染 Prompt（变量替换）
POST /api/v1/prompts/validate - 验证输出是否符合 schema

1.3 PromptPack 支持

实现 PromptPack 加载逻辑
实现 PromptPack 安装逻辑
处理版本冲突

Phase 2 – LLM Gateway（v0.5 核心）

目标：Core 提供统一 LLM 接入层。

2.1 LLM Provider 抽象

定义 LLM Provider 接口
实现 OpenAI Provider
实现 Dify Provider
实现本地模型 Provider（可选）
Provider 配置管理

2.2 Context Pack 组装

实现 Context Pack 组装逻辑
集成 Query API
支持 eventIds/alertIds/entityIds/timeRange/viewPreset

2.3 LLM Gateway 核心

实现 LLM Gateway API
实现限流（按租户/App/用户）
实现缓存（相同输入缓存结果）
实现重试机制
实现结构化输出校验

Phase 3 – AI Actions（v0.5 核心）

目标：在规则中支持 AI Actions（只读）。

3.1 AI Actions 实现

在 Action Executor 中实现 invoke_llm_summary
在 Action Executor 中实现 invoke_llm_report
在 Action Executor 中实现 invoke_llm_generate_doc
集成 LLM Gateway
实现输出写入逻辑（ai_insight/document_draft）
实现事件生成逻辑（ai.* 事件）
实现约束检查（禁止直接改实体）

3.2 类型定义

定义 ai_insight 类型
定义 document_draft 类型
定义 ai.* 事件类型
测试类型安装

Phase 4 – 审计增强（v0.5 必须）

目标：tool_call 记录增强。

4.1 数据库迁移

扩展 tool_calls 表（添加新字段）
字段：prompt_template_id, prompt_version, model_provider, model_name, model_version, context_refs, input_tokens, output_tokens, total_tokens, output_hash, validation_passed, execution_time_ms

4.2 审计记录增强

更新 ToolCall 模型
更新审计记录逻辑
实现输出 hash 计算
实现 tokens 统计

Phase 5 – App 升级（并行）

project-mngt：

基础功能（Phase 1-4）：新增对象、视图、规则
AI 功能（Phase 5）：任务拆解、会议纪要、周报、风险提示

os-assistant：

基础功能（Phase 1-3）：Probe Agent、异常识别规则、Dashboard
AI 功能（Phase 4）：AI 告警分析、AI 排查建议

Phase 6 – 最小闭环验证（v0.5 验收）

闭环 A：Alert → AI Summary → View（os-assistant）

时间：Phase 2 完成后
验收：告警产生时自动生成 AI 摘要，前端正确展示

闭环 B：Meeting → AI Minutes → Draft → 人工采纳（project-mngt）

时间：Phase 3 + project-mngt Phase 5 完成后
验收：会议完成后自动生成会议纪要草稿，用户可查看/编辑/采纳

文档版本: v1.0
最后更新: 2025-12-17