# 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