geopolitical-elite-mapping

KO | EN

gitlite — search

#hacktoberfest #llm #golang #machine-learning #linux #macos #java #windows #cli #kubernetes #awesome-list #pytorch #openai #open-source

geopolitical-elite-mapping

(★ 52)

Map geopolitical power networks with AI — from automated research to an evolving personal knowledge graph.

geopolitical-elite-mapping Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 可编辑地缘政治关系图谱工具 (Geopolitical Network Mapping)

[English](README.en.md)

*AI 驱动的地缘政治权力网络分析与可视化平台*

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/katarism/geopolitical-elite-mapping/main/LICENSE)
[![Python 3.8+](https://img.shields.io/badge/Python-3.8%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/)

> **最近更新 (2026-03-28)**：可视化编辑器与 AI 辅助生成流程已完善。

让 AI 替您完成繁重的信息梳理，生成一张地缘政治权力关系的初始图谱；此后由您亲手持续更新——添加新人物、调整关系、记录最新动态，将它变成一张真正属于自己、会随时间生长的知识地图。

| 目的 | 使用方式 |
|------|----------|
| 快速生成某个议题的权力关系图谱 | 模块一：AI 自动化建模 |
| 在图谱基础上持续补充、积累个人知识 | 模块二：交互式可视化编辑器 |

**[Agentic Workflow 生成示例 Live Demo](https://katarism.github.io/geopolitical-elite-mapping/Examples/MiddleEastOil/MiddleEastOil_EliteNetwork_Viewer.html)**（中东石油地缘政治精英网络，由 AI 自动生成）

**[分析报告示例](https://github.com/katarism/geopolitical-elite-mapping/blob/main/Examples/MiddleEastOil/MiddleEastOil_EliteNetwork_Report.md)**

**模块一：AI 自动生成的交互式图谱**
<img width="1429" height="665" alt="AI 自动生成的地缘政治精英网络图谱，展示节点阵营分布与关系连线" src="https://github.com/user-attachments/assets/6dd00815-90cf-45c9-8316-01543ec6684d" />

*AI 自动生成的地缘政治精英网络图谱，展示节点阵营分布与关系连线*

**模块二：可视化编辑器**
<img width="1419" height="650" alt="交互式可视化编辑器界面，支持节点增删、连线管理与备注编辑，并可通过 Git 仓库云端保存修改" src="https://github.com/user-attachments/assets/4a8ef27e-135d-4ae6-bb76-9a85a2d7fde9" />

*交互式可视化编辑器界面，支持节点增删、连线管理与备注编辑，并可通过 Git 仓库云端保存修改，实现跨设备同步（PC/手机/平板等）*

*可搜索两个节点间的最短路径，发现隐藏关系*

## 目录

1. [环境要求](#环境要求)
2. [模块一：AI 自动化建模](#模块一ai-自动化建模-agentic-workflow)
3. [模块二：交互式可视化编辑器](#模块二交互式可视化编辑器-visual-editor)
4. [项目结构](#项目结构)

## 环境要求

| 依赖 | 用途 | 安装方式 |
|------|------|----------|
| Python 3.8+ | 图谱生成脚本 | [python.org](https://www.python.org/) |
| AI IDE（推荐） | 运行 Agentic Workflow | [Cursor](https://www.cursor.com/) / Google Antigravity |

> **注**：可视化编辑器（`Editor/editor.html`）无需上述依赖，直接在浏览器中打开即可使用。

## 模块一：AI 自动化建模 (Agentic Workflow)

基于本项目内置的 `SKILL.md` 实现的端到端生成流程，推荐配合 **Cursor** 或 **Google Antigravity** 等 AI IDE 使用。

### 快速开始

1. **获取仓库**：
   ```bash
   git clone https://github.com/katarism/geopolitical-elite-mapping.git
   cd geopolitical-elite-mapping
   ```

2. **在 AI IDE 中打开仓库**：使用 Cursor (用终端载入claude code或使用cursor内置coding agent)或 Google Antigravity 打开该文件夹。

3. **向 AI 提问**：输入一个地缘政治议题关键词，AI 将自动完成以下 6 个阶段：

```
   议题确认 → 行为体发现 → 关系调研 → 置信度审计 → 可视化输出 → 报告生成
   ```

### 输入示例

> "中东石油地缘政治" / "印太安全同盟" / "全球半导体供应链权力博弈"

### 输出产物

| 文件 | 说明 |
|------|------|
| `output/[Topic]_EliteNetwork_Viewer.html` | 交互式图谱查看器，可直接在浏览器中浏览，也是导入 Editor 的源文件 |
| `output/[Topic]_EliteNetwork_Report.md` | 分析报告（行为体简介、置信度审计表、关系验证、分析结论） |
| `generate_elite_network.py` | 图谱生成脚本，可复现与手动迭代 |

## 模块二：交互式可视化编辑器 (Visual Editor)

AI 生成的图谱是起点，而非终点。编辑器让您将其转化为**持续生长的个人知识网络**——增补新行为体、修订关系判断、融入最新动态，随着您对议题理解的深入不断积累新知。编辑器为纯前端单文件应用，无需构建或本地服务器。

- **右键即刻编辑**：在空白处右键新增节点，在节点上右键修改阵营、备注或头像。
- **直观的连线管理**：通过侧边栏的"搜索+下拉"框，轻松建立人物间的复杂联系。
- **自动阵营吸附**：随意拖拽，系统会自动将节点划入对应的势力范围（阵营框）。
- **Git 云端同步**：修改通过 GitHub API 实时同步到您的仓库，确保数据安全。

### 开始使用

1. **获取 Token**：前往 [GitHub Token 申请页](https://github.com/settings/tokens?type=beta)，创建一个 `Fine-grained Token`（需勾选 `Contents: Read and Write` 权限）。

**方式一：本地打开（桌面端）**

在文件浏览器（macOS 用 Finder，Windows 用文件资源管理器）中双击 `Editor/editor.html`，浏览器将自动打开，输入 Token 和仓库名，导入 Agentic Workflow 生成的 `[Topic]_EliteNetwork_Viewer.html` 即可开始。

**方式二：GitHub Pages 托管（推荐，支持移动端）**

本地直接打开 HTML 文件在移动端无法渲染（iOS/Android 浏览器不支持 `file://` 协议加载本地资源）。推荐将编辑器托管到 GitHub Pages，获得可在任何设备访问的稳定链接：

1. 在 GitHub 上新建一个 **public 仓库**（例如命名为 `gem-editor`）
2. 将 `Editor/editor.html` 上传至该仓库根目录
3. 进入仓库 **Settings → Pages**，Source 选择 `Deploy from a branch`，Branch 选 `main`，目录选 `/ (root)`，保存
4. 稍等片刻，编辑器即可通过以下地址访问：
   ```
   https://[你的用户名].github.io/gem-editor/editor.html
   ```
5. 将此链接添加到手机主屏幕，即可像 App 一样随时打开使用(web app项不要勾选)

## 项目结构

```
geopolitical-elite-mapping/
├── SKILL.md                           # AI 核心指令集（6 阶段分析方法论）
├── generate_elite_network.py          # 图谱生成核心脚本
├── viewer_template.html               # Cytoscape.js 交互查看器模板
├── index.html                         # 项目主页 / 查看器入口
├── cytoscape.min.js                   # Cytoscape.js 图形库（已打包）
├── Editor/
│   └── editor.html                    # 可视化编辑器（纯前端单文件应用）
├── Examples/
│   └── MiddleEastOil/                 # 中东石油政治案例（报告 + 查看器）
├── references/                        # 规范文档
│   ├── data_schema.md                 # 数据 Schema（节点/边类型定义）
│   ├── confidence_spec.md             # 置信度标注规范（HIGH / MED / LOW / INFERRED）
│   ├── visual_spec.md                 # 可视化样式规范
│   ├── relation_types.md              # 关系类型定义
│   └── analysis_framework.md          # 地缘政治分析框架说明
└── scripts/
    └── wikidata_geopolitics_client.py # Wikidata SPARQL 查询客户端
```

---

**Geopolitical Elite Mapping** — 开源地缘政治分析工具

[MIT 许可证](LICENSE) &nbsp;|&nbsp; [在线演示](https://katarism.github.io/geopolitical-elite-mapping/Examples/MiddleEastOil/MiddleEastOil_EliteNetwork_Viewer.html) &nbsp;|&nbsp; [提交 Issue](https://github.com/katarism/geopolitical-elite-mapping/issues)

</div>

geopolitical-elite-mapping

geopolitical-elite-mapping Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

geopolitical-elite-mapping

geopolitical-elite-mapping Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README