河图知识管理与智能生成平台

Hetu Knowledge Management & Intelligent Generation Platform

基于 Open Notebook 框架扩展，实现河图体系四层架构的企业级知识管理解决方案。

四层架构

┌────────────────────────────────────────────────────────┐
│  Layer 4: 翼展节点 (Wing Extension Nodes)               │
│  专利生成 | KM生成 | arXiv采集 | GitHub Trending        │
├────────────────────────────────────────────────────────┤
│  Layer 3: 星阵总线 (Star Array Bus)                     │
│  专利→代码 | KM→PPT | 形态转换器                        │
├────────────────────────────────────────────────────────┤
│  Layer 2: 双态引擎 (Dual-State Engine)                  │
│  灵犀引擎(研究) | 天工引擎(代码)                        │
├────────────────────────────────────────────────────────┤
│  Layer 1: 觉醒核 (Awakening Core)                       │
│  SurrealDB 向量数据库 | 知识图谱 | 语义搜索             │
└────────────────────────────────────────────────────────┘

快速开始

1. 启动所有服务

# 终端 1: 启动 Docker 服务 (Open Notebook + SurrealDB)
docker compose up -d

# 终端 2: 启动河图 API
PYTHONPATH=.:open-notebook uvicorn test_hetu_api:app --port 8080

# 终端 3: 启动河图 Portal
cd hetu-portal && npm run dev

2. 访问地址

服务	地址	说明
河图 Portal	http://localhost:3000	演示平台入口
知识库 (Open Notebook)	http://localhost:8502	知识管理界面
API 文档	http://localhost:8080/docs	Swagger UI

项目结构

OpenNotebook/
├── hetu-portal/         # 河图 Portal 前端 (Next.js 16)
│   ├── src/app/         # 页面路由
│   └── src/components/  # React 组件
├── open-notebook/       # Open Notebook 基础框架 (知识库)
├── hetu/               # 河图后端模块
│   ├── api/            # REST API (FastAPI)
│   ├── engines/        # 双态引擎
│   │   ├── lingxi/     # 灵犀引擎 - 深度研究 (41 测试)
│   │   ├── tiangong/   # 天工引擎 - 代码生成 (37 测试)
│   │   └── generators/ # 内容生成器 (48 测试)
│   ├── bus/            # 星阵总线
│   │   └── transformers/ # 形态转换器 (34 测试)
│   └── nodes/          # 翼展节点
│       └── collectors/ # 采集器 (82 测试)
├── config/             # 配置文件
├── tests/              # 单元测试 (296 个通过)
└── docker-compose.yml  # Docker 配置

Portal 页面

页面	路径	功能
首页	/	四层架构可视化
专利生成	/patent	生成专利文档
KM 生成	/km	生成技术文章
知识采集	/collect	arXiv + GitHub
专利→代码	/transform/patent-code	转换专利为代码
KM→PPT	/transform/km-ppt	转换文章为 PPT

API 端点

翼展节点 (Layer 4)

端点	方法	说明
/api/hetu/patent/generate	POST	生成专利文档
/api/hetu/patent/analyze	POST	分析技术方案
/api/hetu/km/generate	POST	生成 KM 文章
/api/hetu/km/categories	GET	获取 KM 分类
/api/hetu/collect/arxiv/search	POST	搜索 arXiv 论文
/api/hetu/collect/github/trending	POST	GitHub Trending

星阵总线 (Layer 3)

端点	方法	说明
/api/hetu/transform/patent-to-code	POST	专利→代码
/api/hetu/transform/km-to-ppt	POST	KM→PPT

技术栈

• Portal 前端: Next.js 16 + TypeScript + Tailwind CSS + Lucide Icons
• 知识库 UI: Next.js + React (Open Notebook)
• 后端 API: FastAPI + Python 3.9+
• 数据库: SurrealDB (向量搜索 + 全文索引)
• AI 框架: LangChain + Esperanto
• 多模型支持: Claude / GPT / Gemini / 腾讯混元

开发进度

已完成 ✅

Phase	模块	测试数
Phase 1	多模型路由器 + Markdown 导入器	25
Phase 2	灵犀引擎 + 天工引擎	78
Phase 2	专利生成器 + KM 生成器	48
Phase 3	arXiv + GitHub + 调度器	82
Phase 4	专利→代码 + KM→PPT 转换器	34
Phase 5	翼展节点 REST API	29
Phase 6	河图 Portal 前端	-
Phase 7	LLM 统一调用接口	-
Phase 8	LLM 深度集成	-
Phase 9	超级科学家 Step 1-3	136
总计		432

Phase 9: 超级科学家平台 ✅

借鉴 Kosmos 论文，构建假设-验证循环的自主研究系统。

已完成:

• hetu/engines/scientist/models.py - 数据模型
• hetu/core/world_model.py - 结构化世界模型 (SWM)
• hetu/core/knowledge_graph.py - 知识图谱
• hetu/engines/scientist/cycle_engine.py - 假设-验证循环引擎
• hetu/engines/scientist/collaboration.py - 灵犀-天工协作协议
• hetu/engines/scientist/human_interface.py - 人机交互接口
• hetu-portal/src/app/scientist/page.tsx - Portal 超级科学家页面

Phase 7-8: LLM 集成 ✅

• LLMHelper (hetu/core/llm_helper.py): 统一调用接口，支持 Claude/GPT/Gemini/混元
• 已集成模块:
  • PatentAnalyzer (技术特征提取)
  • ClaimsGenerator (权利要求生成)
  • OutlineGenerator (大纲生成)
  • SpecWriter (说明书撰写)
  • ContentWriter (KM 章节)
  • ArchitectInferrer (架构推断)
  • SlideWriter (PPT 演讲稿)

待开发 📋

• 端到端测试场景
• API 路由端点完善

测试

# 运行所有测试
python3 -m pytest tests/unit/ -v

# 运行特定模块测试
python3 -m pytest tests/unit/test_hetu_api.py -v

开发文档

详细开发文档请参阅 dev-docs/PROJECT_CONTEXT.md

参考资源

• Open Notebook - 基础框架
• Esperanto - 多模型抽象库
• LangGraph - Agent 框架

License

MIT