huhan3000/visualization/README.md

146 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# K/Y/M三链理论可视化工具
## 概述
本可视化工具为"权力符号考古学"理论提供交互式探索界面通过动态图表和实时分析帮助用户深入理解K/Y/M三链理论的核心概念和应用。
## 功能特性
### 🎯 核心功能
- **三链权重调节**实时调整K链秩序、Y链道德、M链信仰的权重比例
- **文明类型选择**:预设多种历史文明的三链配置模式
- **多维度可视化**:提供四种不同类型的图表展示
### 📊 可视化图表
1. **三链功能关系图**:三角形图表展示三链平衡关系
2. **三链权重雷达图**:雷达图展示各维度权重分布
3. **文明发展时间线**:时间轴展示不同文明的三链演变
4. **符号关联网络**:力导向图展示符号间的关联关系
### 🔍 诊断分析
- 实时生成文明健康度诊断
- 三链功能平衡性评估
- 历史文明对比分析
## 快速开始
### 方法一直接打开HTML文件
```bash
# 在浏览器中直接打开
open visualization/kym_interactive.html
# 或双击文件图标
```
### 方法二使用Python本地服务器
```bash
# 进入可视化目录
cd /home/ben/code/huhan3000/visualization
# 启动本地服务器
python -m http.server 8000
# 在浏览器中访问
# http://localhost:8000/kym_interactive.html
```
### 方法三:集成到现有项目
如果项目中已有HTTP服务器直接将HTML文件部署到静态资源目录即可。
## 使用指南
### 基本操作
1. **权重调节**:使用滑块调整三链权重,观察图表实时变化
2. **文明选择**:点击文明按钮加载预设配置
3. **图表交互**:鼠标悬停查看详细信息,部分图表支持缩放
### 预设文明模式
- **商朝**K链主导秩序建立
- **周朝**Y链主导道德实践
- **玛雅**M链主导信仰体系
- **印加**Y链特色山地道德
- **罗马**K链过度秩序复杂化
- **均衡发展**:三链平衡(理想模式)
### 诊断解读
- **绿色状态**:三链均衡,文明韧性良好
- **黄色警告**:存在一定失衡,需要注意调整
- **红色警报**:严重失衡,文明面临挑战
## 技术架构
### 前端技术栈
- **HTML5/CSS3**:响应式界面设计
- **JavaScript**:交互逻辑实现
- **D3.js**:数据可视化核心库
- **Plotly.js**:高级图表库
### 数据模型
```javascript
// 三链数据结构
{
k: 0.33, // K链权重秩序
y: 0.33, // Y链权重道德
m: 0.34, // M链权重信仰
name: "文明名称",
desc: "文明描述"
}
```
## 扩展开发
### 添加新文明
在`chainData`对象中添加新的文明配置:
```javascript
const chainData = {
// 现有配置...
newCivilization: {
k: 0.4,
y: 0.3,
m: 0.3,
name: "新文明",
desc: "文明描述"
}
};
```
### 自定义诊断逻辑
修改`generateDiagnosis`函数实现自定义分析逻辑。
### 添加新图表类型
参考现有图表实现,在`updateCharts`函数中添加新的图表更新逻辑。
## 相关文件
- `kym_interactive.html` - 主可视化界面
- `kym_chain_visualizer.py` - Python版可视化工具
- `../KYM三链理论与符号传承整合.md` - 理论文档
- `../理论应用案例库.md` - 应用案例
## 理论背景
本工具基于"权力符号考古学"理论,该理论提出:
- **K链秩序**:宇宙的"主程序",负责空间秩序建立
- **Y链道德**"执行者",负责道德和物理操作
- **M链信仰**"信仰",负责时间预测和救赎
通过三链的平衡与失衡分析,可以诊断文明的健康度和发展方向。
## 贡献指南
欢迎提交改进建议和新功能开发:
1. Fork项目仓库
2. 创建功能分支
3. 提交更改
4. 发起Pull Request
## 许可证
本项目采用MIT许可证详见LICENSE文件。
---
**开发团队**:胡汉三千年项目组
**最后更新**2024年
**版本**v1.0