# KnowHub Milestones

## Milestone 1: Foundation (Current — 完成基础功能)

**目标：** 一个可用的 agent memory & knowledge console，连接真实 git service 后端。

### ✅ 已完成
- [x] Login 页面（Token + Device Flow，默认 git.clawmem.ai）
- [x] Dashboard（vault 列表、活动流、统计）
- [x] Vault 详情（5 tabs：Overview / Memories / Conversations / Knowledge / Skills）
- [x] Memories tab（流式列表、动态 filter、detail panel）
- [x] Conversations tab（session 列表、点击查看聊天记录）
- [x] Knowledge tab（文件浏览器）
- [x] Skills tab（卡片网格、详情面板）
- [x] 写操作：Delete / Upload / Edit / Comment on Memory
- [x] Share Vault（分享 token 方案 A）
- [x] API Proxy（解决 CORS，支持任意 git service 后端）
- [x] 真实数据验证（git.clawmem.ai + 本地 agent-git-service）
- [x] 零 mock 数据

### 🔲 未完成（M1 收尾）
- [ ] 统一 Vault 概念：去掉 "Shared Spaces" 独立分区，用 🔒/🌐 区分 private/shared
- [ ] Settings 页面：AI Configuration tab（provider/key/model 配置 UI）
- [ ] 基础 AI 路由：`POST /api/ai/invoke`（统一 AI 调用入口）
- [ ] Smart Upload：上传文件时 AI 自动提取 metadata（如果配置了 LLM）
- [ ] 清理和稳定性：修复已知 UI 问题，确保所有页面在真实后端上正常

---

## Milestone 2: Knowledge Distillation Engine (Next)

**愿景：** From conversations to expertise. Not storage — distillation.

KnowHub 从"存储控制台"进化为"知识蒸馏引擎"。核心是实现知识沉淀的生命周期：

```
Conversation (2000 tokens, 原始对话)
    ↓ EXTRACT
Memory (50 tokens, 原子化观察)
    ↓ STRUCTURE
Knowledge (300 tokens, 结构化参考)
    ↓ CRYSTALLIZE
Skill (300 tokens, 可执行能力)
```

### M2 功能清单

**蒸馏核心（3 个 transition feature）：**
- [ ] **Consolidate Memories → Knowledge**：选择一组 memories → AI 生成结构化文档 → split-view 编辑 → 保存
- [ ] **Extract from Conversation → Memory**：AI 扫描对话 → 发现 agent 遗漏的 memories → 一键提取
- [ ] **Promote Knowledge → Skill**：程序性文档 → AI 转化为 SKILL.md 格式 → 审核保存

**AI 辅助管理（5 个 AI feature）：**
- [ ] Skill Analyzer：分析 skill 质量（清晰度/完整度/具体性/效率 1-5 分）
- [ ] Memory Hygiene：检测重复和矛盾的 memories
- [ ] Skill Identifier：判别上传内容是 skill 还是 knowledge
- [ ] Staleness Check：标记过时的 knowledge 文档

**蒸馏仪表盘（V1.2）：**
- [ ] Overview tab 增加蒸馏健康指标
- [ ] Pipeline 可视化：Conversations → Memories → Knowledge → Skills 各层数据量
- [ ] 知识密度评分

### M2 设计文档
- `docs/distillation-design.md` — 蒸馏生命周期设计
- `docs/ai-features-design.md` — 5 个 AI 功能规格
- `docs/ai-implementation.md` — AI 实现架构（统一路由、prompt 模板、缓存策略）
- `docs/knowledge-skills-v3.md` — Knowledge/Skills V3 redesign