chore: 初始化仓库

中华文明全图鉴——文物全图系统(PC Web 地图 + NestJS API + 管理后台)。
含三大 IP(文物南迁北归 / 国宝海外回归 / 博物馆手艺人)、AI 文物对话、
文物地图与详情、以及 demo-video-kit 演示视频生成工具。
This commit is contained in:
selfrelease
2026-06-13 20:55:44 +08:00
commit 2d847e154f
161 changed files with 22629 additions and 0 deletions
+507
View File
@@ -0,0 +1,507 @@
# 中华文明全图鉴——文物全图系统详细方案
> **一句话定位**:做一张"活着的"中华文明全图,每一件文物无论在家还是离家,都有完整的一生、鲜明的角色、可衍生的故事。
---
## 一、系统概述
### 1.1 项目名称
**中华文明全图鉴**(简称:文物全图)
### 1.2 核心目标
- **解决"在哪里"**:建立全球文物精确/模糊位置数据库,国内机构直供,海外众包发现
- **解决"是谁"**:为每件文物建立角色卡、故事档案、语音人格
- **解决"能做什么"**:通过结构化标签体系,驱动故事、视频、VR、研学等衍生内容生产
### 1.3 用户画像
| 用户类型 | 需求 | 使用场景 |
|----------|------|----------|
| 普通公众 | 逛博物馆、了解国宝 | 打开APP看附近有什么文物,听AI讲解 |
| 学生/家长 | 研学教育 | 完成"文物守护人"任务链,生成研学报告 |
| 海外华人/留学生 | 情感连接 | 标记海外博物馆里的中国文物,成为"发现者" |
| 文博从业者 | 数据查询、学术研究 | 检索文物位置、流转历史、查看数字资产 |
| 内容创作者 | 素材获取 | 基于标签筛选文物,获取故事脚本、3D模型、高清图 |
---
## 二、核心数据架构
### 2.1 数据模型总览
```
┌─────────────────────────────────────────────┐
│ 文物全图(统一入口) │
├─────────────────┬───────────────────────────┤
│ 国内现有文物 │ 流失海外文物 │
│ (机构直供) │ (众包发现) │
├─────────────────┼───────────────────────────┤
│ · 精确到展厅展柜 │ · 精确到博物馆/模糊区域 │
│ · 实时展出状态 │ · 位置历史轨迹 │
│ · 官方数字资产 │ · 发现者署名 │
│ · 机构认证蓝V │ · 三级审核 │
│ · 预约/导览入口 │ · 追索进度 │
└─────────────────┴───────────────────────────┘
```
### 2.2 文物主表(`artifacts`
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | UUID | 全图唯一标识 |
| `name` | String | 文物名称 |
| `category` | Enum | 门类:青铜/书画/陶瓷/玉器/金银器/漆器/织绣/石刻/木雕/敦煌/古籍/其他 |
| `dynasty` | String | 年代(精确到年或朝代) |
| `level` | Enum | 级别:一级/二级/三级/一般/未定级 |
| `material` | String | 材质 |
| `dimensions` | String | 尺寸 |
| `current_status` | Enum | 在家/离家/在途(回归中)/未知 |
| `home_institution_id` | UUID | 原属/现属国内机构 |
| `unified_map_id` | String | 全图唯一编码(如:CN-2026-001234 |
| `created_at` | Timestamp | 入系统时间 |
### 2.3 位置表(`artifact_locations`
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | UUID | 位置记录ID |
| `artifact_id` | UUID | 关联文物 |
| `location_type` | Enum | domestic(国内)/ overseas(海外)/ unknown(未知)/ in_transit(在途) |
| `institution_id` | UUID | 关联机构(国内必填) |
| `coordinates` | GeoJSON | GPS坐标或模糊区域 |
| `precision` | Enum | exact_room(展厅)/ exact_building(建筑)/ city(城市)/ country(国家)/ region(区域) |
| `floor_plan_ref` | String | 展厅平面图编号(国内精确到展柜) |
| `display_status` | Enum | 在展/库藏/外借/修复中/巡展中 |
| `source_type` | Enum | institution_feed(机构直供)/ user_report(用户报告)/ expert_verify(专家验证) |
| `discoverer_user_id` | UUID | 发现者(流失文物) |
| `verified_at` | Timestamp | 审核通过时间 |
| `valid_until` | Timestamp | 位置有效期(外借/巡展到期自动更新) |
| `created_at` | Timestamp | 记录创建时间 |
### 2.4 位置历史轨迹
一件文物可拥有多条位置记录,地图上只显示**最新有效位置**,但用户可查看**完整轨迹时间轴**:
```
创作地(北宋汴京)→ 清宫收藏(北京故宫)→ 南迁(乐山)→ 北归(北京故宫)→ 外借(台北故宫)→ 当前位置(北京故宫武英殿)
```
---
## 三、标签体系(核心创新)
### 3.1 标签设计原则
- **机器可读**:结构化标签,支持筛选、检索、推荐
- **人可理解**:中文标签名,面向用户展示
- **故事驱动**:每个标签背后对应一套叙事模板和内容衍生逻辑
- **可扩展**:支持动态新增标签,不改动底层结构
### 3.2 标签分类体系
#### 第一类:基础属性标签(静态)
| 标签名 | 类型 | 示例 |
|--------|------|------|
| 门类 | 单选 | 青铜/书画/陶瓷/玉器/金银器/漆器/织绣/石刻/木雕/敦煌/古籍/其他 |
| 年代 | 单选 | 商/周/秦/汉/魏晋南北朝/唐/宋/元/明/清/民国/当代 |
| 级别 | 单选 | 一级/二级/三级/一般/未定级 |
| 材质 | 多选 | 青铜/陶/瓷/玉/金/银/木/纸/绢/麻/石/漆 |
| 功能 | 多选 | 礼器/兵器/日用/祭祀/装饰/文书/乐器/服饰/建筑构件 |
| 尺寸规模 | 单选 | 微型(<10cm/小型/中型/大型/巨型(>2m |
#### 第二类:流转经历标签(核心故事标签)
| 标签名 | 类型 | 说明 | 内容衍生方向 |
|--------|------|------|-------------|
| **流失状态** | 单选 | 从未流失/曾流失已回归/仍流失海外/流失位置未知 | 决定故事基调和地图颜色 |
| **回归状态** | 单选 | 未回归/已回归/回归中/部分回归(如兽首) | 触发"回归大典"叙事 |
| **南迁北归** | 布尔 | 是否参与抗战时期文物南迁 | 触发《北归记》IP联动 |
| **修复经历** | 布尔 | 是否经历过重大修复 | 触发"匠人修复"VR内容 |
| **外借经历** | 布尔 | 是否曾被外借至其他机构展出 | 触发"文物旅行"轻故事 |
| **巡展经历** | 布尔 | 是否参与过国内外巡展 | 触发"万人空巷"当代故事 |
| **数字化经历** | 布尔 | 是否已完成3D扫描/高清数字化 | 触发数字藏品/VR体验 |
| **争议事件** | 布尔 | 是否涉及真伪争议/归属争议/修复争议 | 触发"文物侦探"推理内容 |
| **名人关联** | 多选 | 与哪些历史人物/当代人物有直接关联 | 触发人物传记联动内容 |
| **入藏方式** | 单选 | 传世/出土/捐赠/征集/拨交/追索返还/回购/罚没 | 触发"如何来到这个家"故事 |
#### 第三类:情感属性标签(面向用户)
| 标签名 | 类型 | 说明 |
|--------|------|------|
| **情绪主调** | 单选 | 悲壮/自豪/治愈/悬疑/浪漫/神秘/日常 |
| **适合年龄** | 多选 | 幼儿/小学/中学/成人/全龄 |
| **体验时长** | 单选 | 5分钟轻体验/15分钟深度/30分钟沉浸 |
| **互动类型** | 多选 | 观看/对话/修复/解谜/创作/打卡 |
### 3.3 标签驱动的内容衍生矩阵
```
标签组合 → 自动匹配内容模板 → 生成衍生内容
示例1
标签:南迁北归=true + 流失状态=曾流失已回归 + 修复经历=true
→ 匹配模板:"守护者的接力"
→ 衍生内容:
· 故事:缘起→南迁→北归→修复→现状(五幕剧)
· 视频:AI生成"如果文物会说话"30秒短片
· VR"南迁路线AR实景"(故宫→南京→乐山→北京)
· 研学:"我是南迁队员"任务链(5个关卡)
示例2
标签:流失状态=仍流失海外 + 名人关联=乾隆
→ 匹配模板:"皇帝的遗憾"
→ 衍生内容:
· 故事:乾隆题跋→流失→海外现状→民间追索
· 视频:数字人"乾隆"与文物隔空对话
· VR:"海外展厅里的中国角落"虚拟参观
· 研学:"跨国谈判模拟"角色扮演
示例3
标签:数字化经历=true + 争议事件=true + 情绪主调=悬疑
→ 匹配模板:"文物侦探"
→ 衍生内容:
· 故事:真伪之谜→科技检测→学术论战→定论
· 视频:纪录片风格"谁在说谎"
· VR"X光下的秘密"透视体验
· 研学:"我是文物鉴定师"推理游戏
```
### 3.4 标签管理后台
- **机构端**:机构为自家文物打基础标签,可申请新增标签
- **编辑端**:系统编辑维护流转标签和情感标签,确保叙事一致性
- **AI辅助**:LLM自动识别文物描述文本,推荐标签组合,人工确认
---
## 四、故事层:结构化叙事体系
### 4.1 四层故事模板(每件文物的必填档案)
| 章节 | 内容规范 | 字数限制 | 适用标签 |
|------|----------|----------|----------|
| **缘起** | 何时、何地、何人、为何而创 | 300字 | 基础属性标签 |
| **流转** | 历代收藏、迁移、事件 | 400字 | 流转经历标签 |
| **精彩故事** | 与这件文物相关的传奇、争议、当代事件 | 500字 | 名人关联、争议事件 |
| **现状** | 现在在哪里、展出频率、保存状态、如何参观 | 200字 | 当前位置、数字化经历 |
**特殊章节**
- **流失文物**:增加"离家"章节(何时、何地、经何人之手、以何方式离开)
- **南迁文物**:增加"南迁北归"章节(路线、人物、事件)
- **回归文物**:增加"归途"章节(回归过程、接回仪式、公众反响)
### 4.2 角色设定卡(文物人格化)
基于标签组合自动生成角色基底,编辑微调:
```json
{
"artifact_id": "CN-2026-001234",
"name": "千里江山图",
"persona": {
"identity": "18岁的天才少年留下的唯一作品",
"personality": "骄傲、敏感、略带孤独",
"voice_tone": "年轻男性,清亮,偶尔叹息",
"catchphrase": "我只画了一次,但一千年后,你们还在排队看我。",
"taboo_topics": ["王希孟后来去哪了"],
"emotional_anchor": "自豪中带着一丝遗憾——我太好,好到没人敢让我多见光"
},
"story_tags": ["南迁北归=false", "流失状态=从未流失", "修复经历=true", "名人关联=宋徽宗/乾隆"],
"content_templates": ["守护者的孤独", "天才的绝唱"]
}
```
**角色卡来源**
- 国内文物:机构提供初稿,系统编辑润色
- 流失文物:系统编辑团队撰写,基于学术文献
- 所有角色卡需经过**文物专家+文学编辑**双重审核
---
## 五、地图层:视觉与交互设计
### 5.1 统一图例系统
| 视觉元素 | 含义 | 适用对象 |
|----------|------|----------|
| **实心蓝点** | 国内在展(精确到展厅) | 机构直供 |
| **实心蓝点+小房子** | 国内库藏(不对外展出) | 机构直供 |
| **空心蓝圈** | 国内外借/巡展中 | 机构直供 |
| **实心红点** | 海外精确坐标(博物馆/已知收藏) | 审核通过 |
| **半透明橙圈** | 海外模糊区域 | 审核通过 |
| **灰色问号** | 位置未知 | 待发现 |
| **金色箭头** | 在途(回归中) | 特殊事件 |
| **绿色星标** | 近期新标记/新展出 | 7天内更新 |
| **紫色光环** | 南迁北归文物 | 标签触发 |
### 5.2 分层渲染策略
```
缩放级别 1-5(全球):
→ 国家/城市级热力聚合
→ 数字徽章:"中国有XX件,海外XX件,南迁文物XX件"
缩放级别 6-10(城市):
→ 具体机构/博物馆图标
→ 点击展开文物列表
缩放级别 11-15(建筑物):
→ 国内机构切换室内平面图
→ 海外机构显示精确楼层(如有数据)
缩放级别 16+(街景):
→ 街景/AR实景导航
```
### 5.3 对比视图
用户可一键切换视图:
```
┌─────────────────────────────────────────┐
│ [切换按钮] 全图 | 在家 | 离家 | 南迁路线 │
├─────────────────────────────────────────┤
│ 全图:蓝点+红点同时显示,中华文明全景 │
│ 离家:仅显示红点+灰问号,聚焦流失文物 │
│ 在家:仅显示蓝点,发现身边的国家宝藏 │
│ 南迁:仅显示紫色光环,显示南迁路线动画 │
└─────────────────────────────────────────┘
```
**南迁路线视图**
- 显示1933-1949年文物南迁的完整路线(故宫→南京→上海→汉口→长沙→贵阳→安顺→乐山→峨眉→巴县→南京→北京)
- 每件南迁文物在路线上显示"当时我在哪里"
- 点击路线节点,播放该节点的历史影像/AI还原场景
---
## 六、审核与数据可信体系
### 6.1 双轨审核机制
#### 国内文物:机构自审 + 系统备案
```
机构提交 → 系统自动校验格式 → 24小时内上线
用户举报信息错误
系统发回机构复核 → 机构确认或修正
```
**原则**:机构对自己藏品的信息有**最终解释权**,系统只校验格式和坐标合理性。
#### 流失文物:三级审核
```
用户标记 → AI初筛 → 专家复核 → 社区公示 → 上线
```
| 级别 | 机制 | 时效 |
|------|------|------|
| **AI初筛** | 查重、来源可信度评分、反常识检测 | 秒级 |
| **专家复核** | 地域分组+门类分组,2人通过或1+1仲裁 | 24-72小时 |
| **社区公示** | 7天虚线显示,接受质疑 | 7天 |
### 6.2 发现者署名体系
审核通过的位置信息,在文物详情页**永久展示**:
```
┌─────────────────────────────┐
│ 现藏地:大英博物馆33号展厅 │
│ [地图小窗] │
│ ───────────────────────── │
│ 📍 位置确认:A级(官方公开) │
│ 🔍 发现者:@文物侦探_老王 │
│ 📅 标记时间:2026.03.15 │
│ ✅ 审核专家:张教授(敦煌组) │
│ 🏆 贡献值:+50(精确坐标) │
└─────────────────────────────┘
```
**贡献值体系**
- 精确坐标(A级来源):+50分
- 模糊区域(B级来源):+20分
- 补充修正已有错误坐标:+30分
- 累计分数解锁称号:见习侦探 → 文物巡护员 → 国宝守夜人 → 文明守望者
---
## 七、技术架构
### 7.1 系统架构图
```
┌─────────────────────────────────────────┐
│ 展示层:交互地图(用户看到的) │
│ 精确坐标/模糊区域 · 发现者署名 · 可信度色标 │
├─────────────────────────────────────────┤
│ 内容层:故事+角色+标签(编辑维护) │
│ 缘起 · 流转 · 精彩故事 · 现状 · 角色卡 │
├─────────────────────────────────────────┤
│ 标签层:结构化标签引擎 │
│ 基础标签 · 流转标签 · 情感标签 → 内容衍生 │
├─────────────────────────────────────────┤
│ 审核层:三级验证(系统的命根子) │
│ AI初筛 → 专家复核 → 社区公示 │
├─────────────────────────────────────────┤
│ 数据层:双轨制(权威+众包) │
│ 种子数据库(官方/学术)+ 用户发现标记 │
└─────────────────────────────────────────┘
```
### 7.2 关键技术栈
| 模块 | 技术选型 | 说明 |
|------|----------|------|
| **地图引擎** | Mapbox GL JS / Leaflet | 自定义文博风格化地图,支持室内平面图 |
| **地理数据库** | PostGIS | 存储GPS坐标和模糊区域GeoJSON |
| **文物知识库** | Milvus + RAG | 私有化部署,文物专用LLM,避免胡说 |
| **数字人引擎** | 口型驱动 + 情感语音 | 文物角色对话 |
| **AIGC引擎** | 文生图/文生视频 | 衍生内容生成 |
| **3D引擎** | Three.js / Unity WebGL | 全息建模、AR叠加 |
| **区块链** | 联盟链 | 存证、数字藏品、发现者证书 |
| **审核后台** | 自研Web后台 | 专家审核、标签管理、内容发布 |
### 7.3 数据安全与隐私
- **私人收藏地址**:模糊区域渲染,精确坐标仅专家后台可见
- **机构数据**:签署数据授权协议,机构可随时撤回或更新
- **用户数据**:发现者信息默认匿名,可选实名展示
---
## 八、内容衍生引擎(基于标签)
### 8.1 衍生内容类型
| 内容类型 | 触发标签 | 生产模式 | 输出示例 |
|----------|----------|----------|----------|
| **AI短剧** | 任意组合 | AIGC视频生成 | "如果文物会说话"30秒竖版视频 |
| **VR体验** | 南迁北归=true / 数字化经历=true | 3D场景还原 | "南迁路线AR实景"室内体验 |
| **研学课程** | 适合年龄=中学 + 互动类型=解谜 | 人工设计+AI辅助 | "我是文物侦探"5关卡推理游戏 |
| **数字藏品** | 回归状态=已回归 / 争议事件=true | 区块链存证 | "回归碎片"限量数字徽章 |
| **有声故事** | 情绪主调=悲壮/治愈 | AI语音+人工剪辑 | 文物角色自述音频专辑 |
| **文创设计** | 门类=青铜/陶瓷 + 功能=礼器 | AI辅助设计 | 基于文物纹样的现代文创 |
| **纪录片脚本** | 争议事件=true + 名人关联 | 人工撰写 | "谁在说谎:XX文物真伪之谜" |
| **社交海报** | 任意 | AIGC+模板 | 用户定制"我与国宝"分享海报 |
### 8.2 内容衍生流程
```
标签组合输入
内容模板库匹配(预置100+模板)
AI生成初稿(故事/脚本/视频/音频)
编辑审核(确保史实准确、情感恰当)
发布至内容池(按标签关联至文物档案页)
用户消费(观看/体验/分享/购买)
数据回流(用户行为反哺标签权重优化)
```
---
## 九、实施路径
### 9.1 第一阶段:种子数据(0-3个月)
**目标**:建立可信数据基底
| 周次 | 动作 | 产出 |
|------|------|------|
| 1-2 | 签约5-10家一级博物馆(故宫、国博、上博、陕历博、河南博物院等) | 合作协议 |
| 3-4 | 录入500-1000件重点文物(精确到展厅),打基础标签 | 种子数据库 |
| 5-6 | 开发机构直供API和后台录入系统 | 机构端MVP |
| 7-8 | 设计并上线"在家视图"MVP(微信小程序) | 可演示产品 |
| 9-10 | 内部测试、机构反馈、数据修正 | 修正版 |
| 11-12 | 发布"中华文明全图鉴"1.0(国内版) | 上线运营 |
### 9.2 第二阶段:流失数据接入(3-6个月)
**目标**:打通海外数据,建立众包发现机制
| 周次 | 动作 | 产出 |
|------|------|------|
| 1-2 | 整理100件高知名度流失文物(精确坐标/模糊区域) | 流失种子库 |
| 3-4 | 开发用户标记系统和三级审核后台 | UGC系统 |
| 5-6 | 招募首批200名"文物侦探"(海外留学生、博物馆志愿者) | 种子发现者 |
| 7-8 | 上线"离家视图"和"全图对比" | 双轨地图 |
| 9-10 | 上线南迁路线视图( purple光环 + 路线动画) | 南迁专题 |
| 11-12 | 发布"中华文明全图鉴"2.0(全球版) | 上线运营 |
### 9.3 第三阶段:内容衍生(6-12个月)
**目标**:标签驱动内容生产,形成自运转生态
| 周次 | 动作 | 产出 |
|------|------|------|
| 1-4 | 开发标签引擎和内容模板库(100+模板) | 衍生引擎 |
| 5-8 | 上线AI短剧、VR体验、研学课程首批内容 | 内容矩阵 |
| 9-12 | 开放内容创作者入驻(基于标签筛选文物获取素材) | 创作者生态 |
| 持续 | 数据回流优化:根据用户行为调整标签权重和内容推荐 | 智能推荐 |
---
## 十、关键成功指标(KPI
| 维度 | 指标 | 6个月目标 | 12个月目标 |
|------|------|-----------|------------|
| **数据覆盖** | 国内文物精确坐标 | 1,000件 | 10,000件 |
| | 海外文物位置标记 | 100件 | 1,000件 |
| | 机构接入数量 | 10家 | 100家 |
| **用户活跃** | 月活用户(MAU | 5万 | 50万 |
| | 发现者注册数 | 200人 | 5,000人 |
| | 用户标记提交数 | 500条 | 10,000条 |
| **内容衍生** | 标签覆盖文物比例 | 100% | 100% |
| | AI短剧生成数 | 50条 | 1,000条 |
| | VR体验上线数 | 3个 | 20个 |
| **数据可信** | 审核通过率 | 60% | 70% |
| | 用户举报纠错率 | <5% | <3% |
| | 机构数据更新频率 | 月度 | 实时 |
---
## 十一、风险与对策
| 风险 | 对策 |
|------|------|
| **私人收藏地址泄露** | 模糊区域渲染,精确坐标仅专家后台可见,前端显示城市级热力圈 |
| **假拍卖/假新闻** | 拍卖行数据必须附图录页码+拍卖日期,媒体报道仅作C级参考 |
| **重复标记** | AI查重+坐标聚类,同一博物馆同一展厅自动合并 |
| **政治敏感** | 追索主张由官方机构发声,系统只记录"现状",不主动发起UGC倡议 |
| **故事编造** | 故事层编辑审核制,UGC仅限"位置情报",不开放"故事创作" |
| **机构数据更新滞后** | 建立API自动同步机制,设置"数据 freshness"提醒 |
| **标签体系膨胀** | 标签分级管理,基础标签固定,流转标签和情感标签每季度评审 |
---
## 十二、团队配置建议
| 角色 | 人数 | 职责 |
|------|------|------|
| **产品经理** | 1 | 全图系统规划、标签体系设计、机构对接 |
| **后端工程师** | 2 | 数据库、API、审核后台、地图引擎 |
| **前端工程师** | 2 | 微信小程序、APP、地图交互、室内平面图 |
| **AI工程师** | 2 | LLM知识库、数字人、AIGC内容生成、标签推荐 |
| **内容编辑** | 3 | 故事撰写、角色卡设计、标签维护、审核专家协调 |
| **文物专家顾问** | 5(兼职) | 审核流失文物标记、故事史实校验、机构关系 |
| **运营** | 2 | 机构拓展、发现者招募、社区运营、事件策划 |
| **UI/UX设计师** | 1 | 地图视觉、文物档案页、角色形象 |
---
## 十三、结语
> **文物全图不是一张静态地图,而是中华文明的数据基础设施。**
>
> 每一件文物都有一个身份(标签)、一段人生(故事)、一种性格(角色)。当这些元素被结构化、被连接、被激活,它们就能自动生长出无穷无尽的内容——短剧、VR、研学、文创、纪录片——而不需要为每一件文物单独创作。
>
> **标签是种子,故事是土壤,AI是阳光,用户是园丁。**
>
> 先花3个月把1000件种子数据的坐标钉死、标签打准、故事写稳。后面的南迁路线、海外寻踪、AI短剧、VR体验,都是这套基础设施的自然生长。