 zhuyongxin
|
9b52afce07
|
docs: 合并 .docs/mvp 到根 mvp 目录并更新文档
- 删除 .docs/mvp 目录，内容合并到根目录 mvp/
- 更新 session-storage-design.md 实现变更记录
- 修复引用路径
|
2026-06-26 17:29:27 +08:00 |
|
|
zhuyongxin
|
a74ccea5be
|
feat(knowledge): breadcrumb分块上下文 & LookupKnowledgeTool日志优化
- DocumentChunk新增breadcrumb字段，分块时构建完整标题层级路径
- DocumentChunkService splitByHeadings维护标题层级栈算法
- VectorIndexService 将breadcrumb写入Milvus metadata
- LookupKnowledgeTool日志替换为结构化摘要，替代原始MD预览
- L0返回策略：唯一匹配用正文摘要，多匹配+L1有结果仅元数据（不读文件）
- 新增buildCompactSummary / buildMetadataOnlySummary方法
- 安装frontend-design skill
- 创建mvp/文档目录（架构设计+会话存储方案）
- 更新测试适配新逻辑
|
2026-06-26 13:56:10 +08:00 |
|
|
zhuyongxin
|
553d1d1faf
|
refactor(ai-ops): 重构 Executor Prompt - 强化行为准则和证据驱动
## 主要改动
1. 重构为更清晰的三段式结构
- 角色定位：明确"诊断流程的执行者"
- 核心行为准则：严格按步执行、必须调用工具、证据综合分析
- 任务执行规范：每步产出要求、最终报告格式
2. 强化关键约束
- 永远不要凭记忆回答错误码含义、接口定义、排障步骤
- 结论必须基于至少两个独立证据源
- 提供证据链格式示例
3. 简化 lookup_knowledge 说明
- 修正参数名：query_text → query
- 简化返回字段说明（保留核心信息）
- 保留三级使用规则（必须/必须/建议）
## 设计理念
- 从"技术细节"转向"行为准则"
- 从"字段说明"转向"证据驱动"
- 提供具体的输出格式示例，减少 Agent 的不确定性
## 参考
基于 mvp/discuss/Executor_Prompt.md 微调
|
2026-06-24 18:53:42 +08:00 |
|
|
zhuyongxin
|
36abfc4675
|
docs(mvp): 添加知识库检索架构和使用文档
新增文档：
- mvp/architecture/knowledge-retrieval-architecture.md
* 架构位置和数据流说明
* L0+L1 混合检索流程图
* 核心组件详细设计
* 与现有架构的集成方式
* 性能指标和可观测性
- mvp/architecture/knowledge-retrieval-usage.md
* 快速开始指南
* 文档格式要求和最佳实践
* 使用场景和示例
* 故障排查和性能优化
* 维护知识库的完整流程
更新文档：
- mvp/README.md - 添加知识库检索文档入口
完善 MVP 架构文档，为后续开发和维护提供完整参考
|
2026-06-24 16:26:15 +08:00 |
|
|
zhuyongxin
|
c86045b33f
|
archive: Phase 1 基础设施搭建归档
归档信息：
- 变更名称：phase-1-infrastructure
- 工作流：spec-driven
- 归档位置：openspec/changes/archive/2026-06-23-phase-1-infrastructure/
完成情况：
- ✅ 所有产物完成（proposal, design, specs, tasks）
- ✅ 任务完成：33/35 (94%)
- ⚠️ 2 个任务跳过（混合检索、集成测试，有充分理由）
验收结果：
- ✅ 静态验证：编译通过
- ✅ 脚本验证：16/16 单元测试通过
- ✅ 端到端验证：上传→索引→检索→删除完整流程
Delta Specs：
- 跳过同步（用户选择）
- functional-specs.md 保留在归档目录中
devflow 档案：
- ✅ 已完整回填（brief, evidence, decisions, acceptance）
- ✅ devflow/index.md 状态更新为 archived
|
2026-06-23 19:20:05 +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 |
|