tever
太微网络
TEVER — 数字事件中枢
文档阅读区

v0.5 – LLM 作为"解释器/写作者"（只读 AI，低风险）

版本: v0.5.0
日期: 2025-12-17
状态: 规划中

一、v0.5 定位

v0.5 的核心：LLM 作为生产力工具，生成草稿，需要人工确认。

关键原则：

  • AI 一律"受控"：模型/agent/rag 都是 Core 的 Action/Tool Provider
  • 先只读，后闭环执行，且全审计
  • 不允许模型直接改 Task/Rule/Config
  • 输出只写 ai_insights/docs_drafts，并发 ai.* 事件

二、v0.5 关键升级

2.1 Core v0.5 升级内容

1. Prompt Registry（+ PromptPack）✅ 新增

  • 支持按 App/用途管理 prompt：project.*、ops.*
  • 版本化、回滚、启用状态
  • 每个 prompt 绑定 output_schema（结构化输出，JSON Schema）

2. LLM Gateway（统一接入）✅ 新增

  • 限流/缓存/重试
  • 结构化输出校验（JSON Schema）
  • 关键：输入只用引用（eventIds/alertIds/entityIds/timeRange/viewPreset），由 Core Query API 组装 context pack

3. AI Actions（只读）✅ 新增

  • invoke_llm_summary：对 alert / event thread 做摘要、建议
  • invoke_llm_report：日报/周报
  • invoke_llm_generate_doc：会议纪要/PRD/里程碑草案/任务拆解输出为"草稿"

关键约束：

  • ❌ 禁止：模型直接改 Task/Rule/Config
  • ✅ 允许：输出只写 ai_insights/docs_drafts，并发 ai.* 事件
  • ✅ 必须：人工确认后才能落地为真实实体

4. 审计增强（必须）✅ 扩展

  • tool_call 记录增强：
    • prompt 版本
    • 模型版本
    • 引用对象（eventIds/alertIds/entityIds）
    • 输出 hash
    • tokens（输入/输出/总计）
    • 耗时
    • 校验是否通过（output_schema 校验）

2.2 project-mngt v0.5 升级重点

定位：工作中枢 + 文档中枢

核心对象与事件

  • 新增对象：todo、milestone、resource、document、meeting、document_draft、ai_insight
  • 新增事件：project.milestone.*、project.meeting.*、project.doc.*、project.worklog.submitted、ai.*

v0.5 的 AI 用法（只读草稿，不自动落地）

  1. 任务拆解草稿：从"目标描述/需求文档"生成 tasks+里程碑草案（写入 drafts）
  2. 会议纪要草稿：从 meeting notes/事件流生成 minutes（写入 drafts）
  3. 周报/进展摘要：从本周 project events 自动生成周报（写入 reports）
  4. 风险提示：从延期/阻塞/工作量偏差做"解释+建议"（写入 insights）

关键：草稿→落地工作流

  • UI 上必须体现：AI Draft（待确认）→ 用户一键"采纳"→ 产生真实 Task/Milestone/Doc 事件
  • 采纳动作是普通业务动作（可审计），不是模型直接写库

2.3 os-assistant v0.5 升级重点

定位：运行哨兵 + 智能建议（只读）

Probe（探针）继续做强

  • 指标/日志摘要事件化：os.metric_sampled、os.log_anomaly_detected、os.agent_heartbeat
  • Dashboard 展示、告警聚合、趋势视图

专家规则建议（RuleEngine）

  • 规则库识别异常（阈值+聚合）→ 产出 alert
  • v0.5 加上：LLM 对告警做解释/排查建议（但不执行修复）
  • invoke_llm_summary：事故时间线、可能原因、建议查看哪些指标/日志

禁止执行（v0.5 明确禁止）

  • ❌ 自动重启
  • ❌ kill 进程
  • ❌ 改配置
  • ❌ 任何修改系统的操作

三、两个最小闭环（v0.5 验收标准）

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

流程：

  1. 告警产生 → ops.alert.created 事件
  2. 规则触发 → invoke_llm_summary Action
  3. 生成 ai_insight → ai.insight.created 事件
  4. Alert Detail 展示 AI 洞察

验收标准：

  • ✅ 告警产生时自动生成 AI 摘要
  • ✅ 审计可追溯：引用了哪些 eventIds/alertId、prompt 版本、模型版本
  • ✅ 前端正确展示 AI 洞察

闭环 B：Meeting/Project Events → AI Minutes/Weekly Report → Draft → 人工采纳（project-mngt）

流程：

  1. 会议记录/事件流 → project.meeting.completed 事件
  2. 规则触发 → invoke_llm_generate_doc Action
  3. 生成 document_draft → ai.document_draft.created 事件
  4. 用户查看草稿 → 可以编辑
  5. 用户点击"采纳" → project.document.created 事件

验收标准：

  • ✅ 会议完成后自动生成会议纪要草稿
  • ✅ 用户可以在 UI 中查看、编辑、采纳草稿
  • ✅ 采纳后创建真实 Document 实体
  • ✅ 审计可追溯：引用了哪些 eventIds、prompt 版本、模型版本

四、文档结构

核心文档

参考文档

  • v0.4/94-v0.5-v0.6-v0.7-roadmap.md - 升级路线图（v0.5 → v0.6 → v0.7）
  • v0.4/95-feature-comparison.md - 功能对比（已有 vs 需要新增）

五、与 v0.4 的关系

v0.4 已冻结

  • v0.4 文档已移至 docs/legacy/v0.4/
  • v0.4 功能保持稳定，不再新增功能

v0.5 基于 v0.4

  • 继承 v0.4 的所有能力（事件/规则/告警/审计）
  • 在 v0.4 基础上新增 AI 能力（只读）
  • 保持向后兼容

六、后续版本规划

  • v0.6：Agent + 处置闭环（受控执行，中风险）
  • v0.7：RAG Flow（检索可控 + 证据链，低风险）

详见：v0.4/94-v0.5-v0.6-v0.7-roadmap.md

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