 aruo
|
d5902a0499
|
docs: update mvp architecture snapshot
|
2026-07-05 13:56:51 +08:00 |
|
|
zhuyongxin
|
2a7164288f
|
chore(docs): 补充 ISS-001 架构设计文档到 mvp
- 新增 mvp/architecture/session-dedup-knowledge-map.md
- 更新 mvp/README.md 文档导航
- ISS-001 issue 关联架构文档
|
2026-07-01 18:28:19 +08:00 |
|
|
zhuyongxin
|
a1c896ebda
|
chore(docs): 归档 ISS-001 session-dedup-knowledge-map + ISS-002 mvp 文档
- 移动 session-dedup-knowledge-map OpenSpec 到 archive 目录
- 提交 ISS-001 遗留的 devflow 档案文件
- 更新 ISS-002 状态为已修复
- 新增 mvp/architecture/action-memory-relevance.md 设计文档
- 更新 mvp/README.md 文档导航
- 更新 devflow/index.md OpenSpec 链接指向 archive
|
2026-07-01 18:27:04 +08:00 |
|
|
zhuyongxin
|
e438df4355
|
feat(knowledge): Executor 行动记忆 + 归一化质量等级解决 ISS-002 重复检索
- RetrievedDocTracker 升级为域级+文档级双层记录（Map<sessionId, Map<domain, Set<filePath>>>）
- LookupKnowledgeTool 新增 Min-Max 归一化层（BGE-M3 L2 距离→[0,1] similarity）
- 三等级 relevanceLevel：PRECISE / HIGHLY_RELEVANT / REFERENCE + completenessHint 兜底信号
- LookupResult 新增 relevanceLevel、completenessHint、retrievedDomainsThisSession
- Executor prompt 重写：4 条检索约束 + 合法出口不查全不追责，重复检索才惩罚
- 入库可观测性：V010 迁移 + retrieval_details JSON 扩展
- 归档 executor-action-memory-relevance change
|
2026-07-01 18:24:41 +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
|
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 |
|