insightflow/README.md

InsightFlow - Audio to Knowledge Graph Platform

InsightFlow 是一个音频转知识图谱平台，支持将音频、文档转换为结构化的知识图谱，并提供强大的分析和推理能力。

功能特性

Phase 1-3: 基础功能 ✅

• 音频上传与转录（阿里云听悟 ASR）
• 实体提取与关系抽取
• 知识图谱可视化（D3.js）
• 多文件图谱融合
• PDF/DOCX 文档导入
• 实体对齐与别名管理
• 项目知识库面板

Phase 4: Agent 助手与知识溯源 ✅

• AI 助手对话（RAG 问答）
• 实体操作指令执行
• 知识溯源（关系来源追踪）
• 实体悬停卡片
• 置信度提示

Phase 5: 高级功能 ✅

• 知识推理 - 因果/对比/时序/关联推理
• 时间线视图 - 实体演变追踪
• 实体属性扩展 - 自定义属性模板
• Neo4j 图数据库 - 复杂图查询、最短路径、社区发现
• 导出功能 - SVG/PNG/Excel/CSV/PDF/JSON

Phase 6: API 开放平台 ✅

• API Key 管理 - 创建、撤销、权限控制
• Swagger/OpenAPI 文档 - 在线 API 文档
• 限流控制 - 滑动窗口限流、调用统计
• 调用日志 - 详细调用记录和分析

技术栈

• 后端: FastAPI + SQLite
• 前端: 原生 HTML/JS + D3.js
• ASR: 阿里云听悟
• LLM: Kimi API
• 图数据库: Neo4j
• 文档处理: PyPDF2, python-docx

快速开始

本地开发

# 克隆仓库
git clone https://git.sivdead.cn/claw/insightflow
cd insightflow

# 安装依赖
cd backend
pip install -r requirements.txt

# 运行开发服务器
python -m uvicorn main:app --reload --host 0.0.0.0 --port 8000

Docker 部署

# 构建镜像
docker build -t insightflow:latest .

# 运行容器
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 \
  -e INSIGHTFLOW_MASTER_KEY=your_master_key \
  insightflow:latest

Docker Compose 部署（推荐）

# 启动所有服务（含 Neo4j）
docker-compose up -d

API 认证

从 Phase 6 开始，API 需要认证才能访问：

# 1. 创建 API Key（需要 Master Key）
curl -X POST http://localhost:18000/api/v1/api-keys \
  -H "X-API-Key: your_master_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "My App", "permissions": ["read", "write"]}'

# 2. 使用 API Key 访问受保护端点
curl http://localhost:18000/api/v1/projects \
  -H "X-API-Key: ak_live_xxxxx"

API 文档

• Swagger UI: http://122.51.127.111:18000/docs
• ReDoc: http://122.51.127.111:18000/redoc

部署信息

• 服务器: 122.51.127.111:18000
• Neo4j: 122.51.127.111:7474 (HTTP), 122.51.127.111:7687 (Bolt)
• Git 仓库: https://git.sivdead.cn/claw/insightflow

开发状态

详见 STATUS.md

项目文档

• PRD v2.0 - 产品需求规格说明书
• STATUS.md - 详细开发状态跟踪

许可证

MIT

---

Phase 7: 智能化与生态扩展 - 进行中 🚧

Phase 7 任务清单

任务	状态	完成时间
1. 智能工作流自动化	✅ 已完成	2026-02-23
2. 多模态支持	✅ 已完成	2026-02-23
3. 数据安全与合规	✅ 已完成	2026-02-23
4. 协作与共享	✅ 已完成	2026-02-24
5. 智能报告生成	📋 待开发	-
6. 高级搜索与发现	📋 待开发	-
7. 插件与集成	✅ 已完成	2026-02-23
8. 性能优化与扩展	📋 待开发	-

已完成功能 ✅

1. 智能工作流自动化 ✅

   • 工作流管理模块 workflow_manager.py
   • 定时任务调度（APScheduler）
   • Webhook 通知器（飞书/钉钉/Slack）
   • 自动分析新上传文件
   • 自动实体对齐和关系发现

2. 多模态支持 ✅

   • 视频处理模块（音频提取 + 关键帧 + OCR）
   • 图片处理模块（OCR + 图片描述）
   • 跨模态实体关联
   • 多模态实体画像
   • 多模态时间线生成

3. 数据安全与合规 ✅

   • 安全模块 security_manager.py
   • 审计日志系统
   • 端到端加密（AES-256-GCM）
   • 数据脱敏（手机号、邮箱、身份证）
   • 数据访问策略
   • 访问审批流程

4. 协作与共享 ✅

   • 协作管理模块 collaboration_manager.py
   • 项目分享链接（只读/评论/编辑/管理员权限）
   • 评论和批注系统（实体/关系/转录文本）
   • 变更历史追踪
   • 团队成员管理（多角色权限控制）

5. 插件与集成 ✅

   • 插件管理模块 plugin_manager.py
   • Chrome 扩展支持
   • 飞书/钉钉机器人
   • Zapier/Make Webhook 集成
   • WebDAV 同步

待开发任务 📋

5. 智能报告生成 - 待开发

   • 一键生成 PDF/Word 报告
   • 会议纪要提取
   • 自定义报告模板

6. 高级搜索与发现 - 待开发

   • 全文搜索
   • 语义搜索
   • 实体关系路径发现
   • 知识缺口识别

7. 性能优化与扩展 - 待开发

   • Redis 缓存层
   • 数据库分片
   • CDN 加速
   • 异步任务队列（Celery）