# InsightFlow 开发状态

**最后更新**: 2026-02-19

## 当前阶段

Phase 4: Agent 助手与知识溯源 - **开发中 🚧**

## 已完成

### Phase 1-3 (已完成 ✅)
- FastAPI 项目框架搭建
- SQLite 数据库设计
- 阿里云听悟 ASR 集成
- OSS 上传模块
- 实体提取与对齐逻辑
- 关系提取
- 项目 CRUD API
- 音频上传与分析 API
- D3.js 知识图谱可视化
- 实体列表展示
- 转录文本中实体高亮显示
- 图谱与文本联动

### Phase 4 - Agent 助手 (已完成 ✅)
- ✅ 创建 llm_client.py - Kimi API 客户端
  - 支持流式/非流式聊天
  - 带置信度的实体提取
  - RAG 问答功能
  - Agent 指令解析
  - 实体演变分析
- ✅ 更新 db_manager.py - 新增方法
  - `get_relation_with_details()` - 获取关系详情
  - `get_entity_with_mentions()` - 获取实体及提及
  - `search_entities()` - 搜索实体
  - `update_entity()` - 更新实体
  - `get_project_summary()` - 项目摘要
  - `get_transcript_context()` - 转录上下文
- ✅ 更新 main.py - Agent API 端点
  - `POST /api/v1/projects/{id}/agent/query` - RAG 问答
  - `POST /api/v1/projects/{id}/agent/command` - 指令执行
  - `GET /api/v1/projects/{id}/agent/suggest` - 智能建议
  - `GET /api/v1/relations/{id}/provenance` - 关系溯源
  - `GET /api/v1/entities/{id}/details` - 实体详情
  - `GET /api/v1/entities/{id}/evolution` - 实体演变分析
  - `GET /api/v1/projects/{id}/entities/search` - 实体搜索
  - `PATCH /api/v1/entities/{id}` - 更新实体
- ✅ 更新 workbench.html - Agent 面板 UI
  - 可折叠的 Agent 助手面板
  - 聊天界面
  - 实体悬停卡片
  - 关系溯源弹窗
- ✅ 更新 app.js - 前端功能
  - Agent 聊天功能
  - 指令执行（合并实体、编辑定义）
  - RAG 问答
  - 实体卡片悬停显示
  - 关系点击溯源
  - 低置信度实体标黄

### Phase 4 - 知识溯源 (已完成 ✅)
- ✅ 点击关系连线显示来源文档
- ✅ 实体详情显示所有提及位置
- ✅ 证据文本展示

### Phase 4 - 术语卡片悬停 (已完成 ✅)
- ✅ 鼠标悬停实体显示卡片
- ✅ 卡片包含：名称、定义、提及次数、关系数

### Phase 4 - 置信度提示 (已完成 ✅)
- ✅ LLM 提取返回置信度分数
- ✅ 低置信度实体在文本中标黄

## 待完成

### Phase 4 - Neo4j 集成 (可选)
- [ ] 将图谱数据同步到 Neo4j
- [ ] 支持复杂图查询

### Phase 5 - 高级功能 (进行中 🚧)
- [x] 知识推理与问答增强 ✅ (2026-02-19 完成)
  - 后端 API: `/api/v1/projects/{id}/reasoning/query`
  - 支持因果/对比/时序/关联推理
  - 智能项目总结 (全面/高管/技术/风险)
  - 实体关联路径发现
  - 前端推理面板 UI
- [ ] 实体属性扩展
- [x] 时间线视图 ✅ (2026-02-19 完成)
- [ ] 导出功能
- [ ] 协作功能

## 技术债务

- 听悟 SDK fallback 到 mock 需要更好的错误处理
- 实体相似度匹配目前只是简单字符串包含，需要 embedding 方案
- 前端需要状态管理（目前使用全局变量）
- 需要添加 API 文档 (OpenAPI/Swagger)

## 部署信息

- 服务器: 122.51.127.111
- 项目路径: /opt/projects/insightflow
- 端口: 18000

## 最近更新

### 2026-02-19
- 完成 Phase 5 时间线视图功能
  - 后端 API: `/api/v1/projects/{id}/timeline`
  - 前端时间线面板，支持按日期分组显示
  - 实体提及和关系建立事件可视化
  - 实体筛选功能
  - 统计卡片展示
- 修复静态文件路由覆盖 API 路由的问题
- 修复模块导入路径问题
- 部署到服务器: 122.51.127.111:18000
- 更新 README 开发清单