insightflow/STATUS.md

InsightFlow 开发状态

最后更新: 2026-02-18

当前阶段

Phase 3: 记忆与生长 - 已完成 ✅

已完成

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: 记忆与生长 ✅

多文件图谱融合

• ✅ 支持上传多个音频文件到同一项目
• ✅ 系统自动对齐实体，合并图谱
• ✅ 实体提及跨文件追踪
• ✅ 文件选择器切换不同转录内容
• ✅ 转录列表 API 返回文件类型

实体对齐算法优化

• ✅ 新增 entity_aligner.py 模块
• ✅ 使用 Kimi API embedding 进行语义相似度匹配
• ✅ 余弦相似度计算
• ✅ 自动别名建议
• ✅ 批量实体对齐 API
• ✅ 实体对齐回退机制（字符串匹配）

PDF/DOCX 文档导入

• ✅ 新增 document_processor.py 模块
• ✅ 支持 PDF、DOCX、TXT、MD 格式
• ✅ 文档文本提取并参与实体提取
• ✅ 文档上传 API (/api/v1/projects/{id}/upload-document)
• ✅ 文档类型标记（audio/document）

项目知识库面板

• ✅ 全新的知识库视图
• ✅ 侧边栏导航切换（工作台/知识库）
• ✅ 统计面板：实体数、关系数、文件数、术语数
• ✅ 实体网格展示（带提及统计）
• ✅ 关系列表展示
• ✅ 术语表管理（添加/删除）
• ✅ 文件列表展示（区分音频/文档）

术语表功能

• ✅ 术语表数据库表 (glossary)
• ✅ 添加术语 API
• ✅ 获取术语列表 API
• ✅ 删除术语 API
• ✅ 前端术语表管理界面

数据库更新

• ✅ transcripts 表新增 type 字段
• ✅ entities 表新增 embedding 字段
• ✅ 新增 glossary 表
• ✅ 新增索引优化查询性能

技术债务

• 听悟 SDK fallback 到 mock 需要更好的错误处理
• 前端需要状态管理（目前使用全局变量）
• 需要添加 API 文档 (OpenAPI/Swagger)
• Embedding 缓存需要持久化
• 实体对齐算法需要更多测试

部署信息

• 服务器: 122.51.127.111
• 项目路径: /opt/projects/insightflow
• 端口: 18000
• Docker 镜像: insightflow:phase3

下一步 (Phase 4)

• 知识推理与问答
• 实体属性扩展
• 时间线视图
• 导出功能（PDF/图片）