# InsightFlow 开发状态

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

## 当前阶段

Phase 2: 交互与纠错工作台 - **已完成 ✅**

## 已完成

### Phase 1: 骨架与单体分析 (MVP) ✅

#### 后端 (backend/)
- ✅ FastAPI 项目框架搭建
- ✅ SQLite 数据库设计 (schema.sql)
- ✅ 数据库管理模块 (db_manager.py)
- ✅ 阿里云听悟 ASR 集成 (tingwu_client.py)
- ✅ OSS 上传模块 (oss_uploader.py)
- ✅ 实体提取与对齐逻辑
- ✅ 关系提取（LLM 同时提取实体和关系）
- ✅ 项目 CRUD API
- ✅ 音频上传与分析 API
- ✅ 实体列表 API
- ✅ 关系列表 API
- ✅ 转录列表 API
- ✅ 实体提及位置 API
- ✅ transcripts 表数据写入
- ✅ entity_mentions 表数据写入
- ✅ entity_relations 表数据写入

#### 前端 (frontend/)
- ✅ 项目管理页面 (index.html)
- ✅ 知识工作台页面 (workbench.html)
- ✅ D3.js 知识图谱可视化
- ✅ 音频上传 UI
- ✅ 实体列表展示
- ✅ 转录文本中实体高亮显示
- ✅ 图谱与文本联动（点击实体双向高亮）

### Phase 2: 交互与纠错工作台 ✅

#### 后端 API 新增
- ✅ 实体编辑 API (PUT /api/v1/entities/{id})
- ✅ 实体删除 API (DELETE /api/v1/entities/{id})
- ✅ 实体合并 API (POST /api/v1/entities/{id}/merge)
- ✅ 手动创建实体 API (POST /api/v1/projects/{id}/entities)
- ✅ 关系创建 API (POST /api/v1/projects/{id}/relations)
- ✅ 关系删除 API (DELETE /api/v1/relations/{id})
- ✅ 转录编辑 API (PUT /api/v1/transcripts/{id})

#### 前端交互功能
- ✅ 实体编辑器模态框（名称、类型、定义、别名）
- ✅ 右键菜单（编辑实体、合并实体、标记为实体）
- ✅ 实体合并功能
- ✅ 关系管理（添加、删除）
- ✅ 转录文本编辑模式
- ✅ 划词创建实体
- ✅ 文本与图谱双向联动

#### 数据库更新
- ✅ update_entity() - 更新实体信息
- ✅ delete_entity() - 删除实体及关联数据
- ✅ delete_relation() - 删除关系
- ✅ update_relation() - 更新关系
- ✅ update_transcript() - 更新转录文本

## Phase 3 计划 (记忆与生长) - **即将开始**

- 多文件图谱融合
- 实体对齐算法优化
- PDF/DOCX 文档导入
- 项目知识库面板

## 技术债务

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

## 部署信息

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