# HistoricalCloud

**Repository Path**: dingling1890/historical-cloud

## Basic Information

- **Project Name**: HistoricalCloud
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-19
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HistoricalCloud — 华夏历史图卷

中国历史朝代、皇帝、年号、大事记、诗人与诗词的可视化应用。

## 快速启动

**不要直接双击 `index.html`**（会空白）。请用下面方式：

### 方式一：双击启动（推荐）

```
双击 start-3d.bat
```

浏览器打开 http://localhost:5173

### 方式二：命令行

```powershell
cd frontend
npm install
npm run dev
```

### 方式三：静态构建 + Python 预览

```powershell
cd frontend
npm install
npm run build
py scripts/serve_3d.py
```

打开 http://127.0.0.1:8080

## 目录结构

```
HistoricalCloud/
├── data/                       # 源数据（皇帝、事件、诗人等 JSON）
├── frontend/
│   ├── public/data/            # 前端运行时数据（timeline、诗云星图等）
│   └── src/                    # 历史图卷 / 诗云界面
├── scripts/
│   └── serve_3d.py           # 可选：构建后静态预览
├── start-3d.bat
└── README.md
```

## 数据说明

- **前端直接使用** `frontend/public/data/` 下的 JSON（如 `timeline.json`、`verse_graph.json`、`verse_poets/`）
- **手工维护源数据** 可编辑 `data/*.json`；改完后需自行同步到 `frontend/public/data/`（本项目已不再包含爬取与 CSV 导出流水线）

## 说明

- 诗作创作年份多为估算，名篇见 `data/poem_years.json`
- 诗人关系来自文学史常识整理
- 如需增删诗人，编辑 `data/poets.json` 并同步到前端数据目录