 zhuyongxin
|
c4d23c3bd8
|
feat(ai-ops): Prompt 配置化 & 集成 LookupKnowledgeTool
## 主要改动
1. Prompt 配置化
- 从硬编码改为独立 Markdown 文件管理
- 新增 AiOpsPromptProperties 配置类，使用 @PostConstruct 加载
- 创建 prompts/{planner,executor,supervisor}-prompt.md
2. 集成 LookupKnowledgeTool
- 在 AiOpsService 中注入 LookupKnowledgeTool
- 添加到工具数组，只给 Executor Agent 使用
- 符合 3-Agent 协同分析模式
3. Executor Prompt 增强
- 添加工具选择指南（精确关键词 vs 模糊概念）
- 明确降级策略（lookup_knowledge 未找到时降级到 queryInternalDocs）
## 优势
- 易于维护：Prompt 修改不需重新编译
- 格式友好：Markdown 原生支持代码块和表格
- 性能优化：精确关键词查询 < 10ms（L0 匹配）
## 文件变更
- 新增：AiOpsPromptProperties.java
- 新增：prompts/planner-prompt.md
- 新增：prompts/executor-prompt.md
- 新增：prompts/supervisor-prompt.md
- 修改：AiOpsService.java（-136 行硬编码，+5 行配置引用）
|
2026-06-24 18:29:24 +08:00 |
|
|
zhuyongxin
|
d6229f3385
|
feat(knowledge): 完成 L0+L1 混合检索集成
核心功能：
- 新增 FrontmatterParser 解析 YAML frontmatter
- 新增 KnowledgeIndexService L0 内存索引
- 新增 LookupKnowledgeTool 混合检索工具
- 增强 DocumentManagementService 文件保存和索引同步
技术实现：
- 数据库迁移 V004: api_document.metadata (TEXT)
- 依赖新增: snakeyaml 2.0
- 配置新增: knowledge.base-path
- 可观测性: requestId 追踪 + 性能日志
质量保证：
- 单元测试: 31/31 通过
- 测试覆盖: FrontmatterParser(11), KnowledgeIndexService(13), LookupKnowledgeTool(7)
- 启动验证: L0 索引正常加载
归档文档：
- OpenSpec: openspec/changes/lookup-knowledge-integration/
- devflow 档案: devflow/projects/2026-06-24-lookup-knowledge-integration/
- handoff: handoff/2026-06-24-lookup-knowledge-integration.md
|
2026-06-24 16:07:10 +08:00 |
|
|
zhuyongxin
|
ded74f8dac
|
docs(phase1): Phase 1 验证报告和最终归档
验证结果：
- ✅ Milvus 连接测试：Status Code 0，集群正常
- ✅ MySQL Repository 测试：7/7 通过
- ✅ Redis 会话管理测试：8/8 通过
- ✅ 编译验证：BUILD SUCCESS
- ✅ Git 状态：Working tree clean
任务完成情况：
- 核心任务：32/34 完成 (94%)
- 跳过任务：2 个（有充分理由）
- 混合检索：会降低准确率
- 集成测试：单元测试已覆盖
增强功能（超预期）：
- ✅ 类别过滤检索系统
- 文件索引：自动从路径提取类别
- 用户上传：接口参数指定类别
- 检索过滤：Milvus expr 过滤
- ✅ 完整的类别管理流程
核心能力：
1. 数据持久化（MySQL + JPA + Flyway）
2. 会话管理（Redis）
3. 文档管理（上传、查询、删除）
4. 向量检索（Milvus 语义相似度）
5. 分类检索（按类别过滤）
6. 智能分块（基于标题和段落）
7. 异常处理（GlobalExceptionHandler）
8. 容器化部署（Docker Compose）
提交统计：12 个功能提交
文件统计：实体 3 个、Repository 3 个、Service 6+、Controller 2 个、DTO 7 个
验证结论：✅ Phase 1 可以归档，进入 Phase 2
|
2026-06-23 17:19:02 +08:00 |
|
|
zhuyongxin
|
1de1e98ef8
|
feat(phase1): 完成 JPA 实体类和 Repository 层实现
- 创建 3 个 JPA 实体类：DiagnosisRecord、CaseLibrary、ApiDocument
- 创建 3 个 Repository 接口，实现基础 CRUD 和自定义查询方法
- 实现 DiagnosisRecordRepository 单元测试（6 个测试全部通过）
- 修复 Hibernate schema 验证问题（枚举类型使用 VARCHAR）
- 更新 application.yml，添加完整的数据库和 Redis 配置
- 更新 OpenSpec tasks.md，标记已完成任务（12/33）
测试结果：
- DiagnosisRecordRepositoryTest: 6/6 通过
- 编译成功，无错误
Progress: 12/33 tasks completed
|
2026-06-23 14:30:35 +08:00 |
|
|
zhuyongxin
|
60be51f4a5
|
docs: 重构文档结构，分离学习笔记和 MVP 架构设计
**变更概述：**
- 将 MVP 架构设计文档独立到项目根目录 `mvp/`
- 整理 `docs/` 为纯学习和分析文档目录
- 按类型分类：learning（学习）、analysis（分析）、reports（报告）、guides（指南）
**目录结构：**
```
mvp/ # MVP 架构设计（独立）
├── README.md # 数据库设计总览
├── architecture/ # 架构文档
│ ├── agent-architecture-mvp.md
│ ├── implementation-plan.md
│ └── ...
└── tables/ # 数据表设计
docs/ # 学习和分析文档
├── learning/ # 学习笔记（00-08 编号）
├── analysis/ # 分析笔记 + 重构计划
├── reports/ # 临时报告
└── guides/ # 指南文档
```
**详细变更：**
- docs/README.md → mvp/README.md（数据库设计入口）
- docs/architecture/ → mvp/architecture/（架构设计）
- docs/tables/ → mvp/tables/（数据表设计）
- docs/学习笔记-*.md → docs/learning/07-*.md, 08-*.md
- docs/项目学习路径.md → docs/learning/00-*.md
- docs/功能分析报告.md → docs/analysis/
- docs/修复报告-*.md → docs/reports/
- docs/日志配置*.md → docs/guides/ 或 docs/reports/
- docs/design/ → docs/analysis/（问题分析和重构计划）
|
2026-06-23 14:14:51 +08:00 |
|