184 lines
4.2 KiB
Markdown
184 lines
4.2 KiB
Markdown
# InsightFlow - Audio to Knowledge Graph Platform
|
||
|
||
## Phase 3: Memory & Growth - Completed ✅
|
||
|
||
### 新增功能
|
||
|
||
#### 1. 多文件图谱融合 ✅
|
||
- 支持上传多个音频文件到同一项目
|
||
- 系统自动对齐实体，合并图谱
|
||
- 实体提及跨文件追踪
|
||
- 文件选择器切换不同转录内容
|
||
|
||
#### 2. 实体对齐算法优化 ✅
|
||
- 新增 `entity_aligner.py` 模块
|
||
- 支持使用 Kimi API embedding 进行语义相似度匹配
|
||
- 余弦相似度计算
|
||
- 自动别名建议
|
||
- 批量实体对齐 API
|
||
|
||
#### 3. PDF/DOCX 文档导入 ✅
|
||
- 新增 `document_processor.py` 模块
|
||
- 支持 PDF、DOCX、TXT、MD 格式
|
||
- 文档文本提取并参与实体提取
|
||
- 文档类型标记（音频/文档）
|
||
|
||
#### 4. 项目知识库面板 ✅
|
||
- 全新的知识库视图
|
||
- 统计面板：实体数、关系数、文件数、术语数
|
||
- 实体网格展示（带提及统计）
|
||
- 关系列表展示
|
||
- 术语表管理（添加/删除）
|
||
- 文件列表展示
|
||
|
||
### 技术栈
|
||
- 后端: FastAPI + SQLite
|
||
- 前端: 原生 HTML/JS + D3.js
|
||
- ASR: 阿里云听悟
|
||
- LLM: Kimi API
|
||
- 文档处理: PyPDF2, python-docx
|
||
|
||
### 部署
|
||
|
||
```bash
|
||
# 构建 Docker 镜像
|
||
docker build -t insightflow:phase3 .
|
||
|
||
# 运行容器
|
||
docker run -d \
|
||
-p 18000:8000 \
|
||
-v /opt/data:/app/data \
|
||
-e KIMI_API_KEY=your_key \
|
||
-e ALIYUN_ACCESS_KEY_ID=your_key \
|
||
-e ALIYUN_ACCESS_KEY_SECRET=your_secret \
|
||
insightflow:phase3
|
||
```
|
||
|
||
### API 文档
|
||
|
||
#### 新增 API
|
||
|
||
**文档上传**
|
||
```
|
||
POST /api/v1/projects/{project_id}/upload-document
|
||
Content-Type: multipart/form-data
|
||
file: <文件>
|
||
```
|
||
|
||
**知识库查询**
|
||
```
|
||
GET /api/v1/projects/{project_id}/knowledge-base
|
||
```
|
||
|
||
**术语表管理**
|
||
```
|
||
POST /api/v1/projects/{project_id}/glossary
|
||
GET /api/v1/projects/{project_id}/glossary
|
||
DELETE /api/v1/glossary/{term_id}
|
||
```
|
||
|
||
**实体对齐**
|
||
```
|
||
POST /api/v1/projects/{project_id}/align-entities?threshold=0.85
|
||
```
|
||
|
||
### 数据库 Schema 更新
|
||
- `transcripts` 表新增 `type` 字段（audio/document）
|
||
- `entities` 表新增 `embedding` 字段
|
||
- 新增索引优化查询性能
|
||
|
||
---
|
||
|
||
## Phase 4: Agent 助手与知识溯源 - 已完成 ✅
|
||
|
||
### 已完成功能
|
||
|
||
1. **Agent 助手后端 API** ✅
|
||
- 对话指令解析接口 `/agent/command`
|
||
- RAG 问答接口 `/agent/query`
|
||
- 实体操作指令执行
|
||
|
||
2. **Agent 助手前端面板** ✅
|
||
- 可折叠聊天面板
|
||
- 消息历史展示
|
||
- 指令快捷按钮
|
||
|
||
3. **知识溯源功能** ✅
|
||
- 关系来源追踪 `/relations/{id}/provenance`
|
||
- 提及位置高亮
|
||
- 跨文档关联显示
|
||
|
||
4. **术语卡片** ✅
|
||
- 悬停卡片 UI
|
||
- 实体详情展示
|
||
- 快捷编辑入口
|
||
|
||
5. **置信度系统** ✅
|
||
- LLM 返回置信度
|
||
- 低置信度标记
|
||
- 人工确认流程
|
||
|
||
6. **Neo4j 集成** - 待开发 ⏳
|
||
- 图谱数据同步
|
||
- 复杂图查询支持
|
||
|
||
## Phase 5: 高级功能 - 已完成 ✅
|
||
|
||
### 已完成功能 ✅
|
||
|
||
1. **知识推理与问答增强** ✅
|
||
- 后端推理引擎 `knowledge_reasoner.py`
|
||
- 因果/对比/时序/关联推理
|
||
- 智能项目总结 API
|
||
- 实体关联路径发现
|
||
- 前端推理面板 UI
|
||
|
||
2. **时间线视图** ✅
|
||
- 项目时间线 API
|
||
- 实体演变追踪
|
||
- 时间线可视化面板
|
||
|
||
3. **实体属性扩展** ✅
|
||
- 数据库层: `entity_attributes`, `attribute_templates`, `attribute_history` 表
|
||
- 后端 API: 属性模板管理、实体属性 CRUD、属性历史查询
|
||
- 支持属性类型: text, number, date, select, multiselect, boolean
|
||
- 属性筛选搜索 API
|
||
|
||
### 待开发任务 📋
|
||
|
||
无 - Phase 5 已完成
|
||
|
||
## Phase 6: 企业级功能 - 规划中 📋
|
||
|
||
1. **API 开放平台**
|
||
- RESTful API 文档
|
||
- API Key 管理
|
||
- 调用统计和限流
|
||
|
||
2. **数据安全增强**
|
||
- 端到端加密
|
||
- 数据脱敏
|
||
- 审计日志
|
||
|
||
3. **性能优化**
|
||
- 数据库分片
|
||
- 缓存层（Redis）
|
||
- CDN 加速
|
||
|
||
## 暂不开发功能 ⏸️
|
||
|
||
- **协作功能** - 多用户支持、项目权限管理、评论批注（当前版本暂不实现）
|
||
|
||
---
|
||
|
||
## 项目文档
|
||
|
||
- [PRD v2.0](docs/PRD-v2.0.md) - 产品需求规格说明书
|
||
- [STATUS.md](STATUS.md) - 详细开发状态跟踪
|
||
|
||
## 部署信息
|
||
|
||
- **服务器**: 122.51.127.111:18000
|
||
- **项目路径**: /opt/projects/insightflow
|
||
- **Git 仓库**: https://git.sivdead.cn/claw/insightflow
|