地缘政治精英网络图谱工具。适用于分析特定议题下的精英集团/派系网络（政治派系、财阀、军工集团、资源控制方），通过系统性调研构建利益关系网络，输出带置信度编码的交互式 HTML 图谱查看器 + 文字分析报告。触发词：「地缘政治图谱」「精英网络」「elite network」「geopolitical mapping」「权力网络分析」。
系统性生成指定地缘政治议题下的精英网络图谱。通过 6 个阶段的工作流，完成议题框架确认、行为体发现、关系网络调研、置信度审计、可视化输出和分析报告生成。
核心特点：
当用户需要对一个地缘政治议题进行精英网络分析时使用：
不适用：纯历史事件叙述（无网络结构）。
用户提供一个地缘政治议题关键词或描述："中东石油地缘政治" / "印太安全同盟" / "全球半导体供应链权力博弈"
output/[Topic]_EliteNetwork_Viewer.html — 交互式图谱查看器（置信度编码进视觉，内置纪元筛选器）output/[Topic]_EliteNetwork_Report.md — 文字分析报告（行为体简介 + 置信度审计表 + 关系验证 + 分析结论）generate_elite_network.py — 图谱生成脚本（可复现、可迭代修改）节点类型表、边类型表、置信度规则详见 data_schema.md 四级置信度系统（判定标准 + 证据要求 + 视觉编码）详见 confidence_spec.md 可视化节点配色/边样式/置信度视觉编码/Legend 规范详见 visual_spec.md 关系类型判定标准 + 边界案例详见 relation_types.md 地缘政治分析框架详见 analysis_framework.md
在任何需要执行网页搜索的步骤中，按以下流程选择工具：
1. 尝试调用 tavily-search 技能
2. IF tavily-search 调用成功 → 使用结果
3. IF tavily-search 未安装 OR 调用报错（ImportError / HTTP 错误 / 超时）:
→ 记录降级原因
→ 调用系统原生 search_web 工具（相同 query）
→ 使用 search_web 结果
4. IF search_web 也失败 → 标记该搜索步骤为「未完成」，继续下一步
[!CAUTION] 严格按照 Phase 0 → 1 → 2 → 3 → 4 → 5 的顺序执行。每个 Phase 完成后，在内部检查输出质量，再进入下一个 Phase。
[!CAUTION] 强制机制 #1：Phase 0 未经用户明确确认，禁止进入 Phase 1。 强制机制 #2：Phase 3 中，任何无置信度标注的节点/边将被拒绝进入 Phase 4。
目的：理解用户需求，与用户确认分析的精确边界，生成定制化的分析框架。
[!CAUTION] ⛔ 强制机制：本 Phase 必须与用户完成至少一轮确认交互。禁止跳过。禁止自行假设议题边界。
步骤：
议题解析：基于用户输入，分析以下维度并生成 issue_profile 草案：
{
"issue": "中东石油地缘政治",
"scope": {
"geographic": ["中东", "波斯湾", "北非"],
"thematic": ["石油定价权", "运输通道控制", "产油国联盟"],
"excluded": ["南美石油", "天然气（除非直接相关）"]
},
"time_range": {
"start": "1973（石油危机）",
"end": "2025",
"focus_period": "2010-2025（重点关注）"
},
"granularity": {
"level": "faction",
"description": "以国家级派系/集团为主要节点，关键个人作为辅助标注",
"expected_node_count": "20-40"
},
"known_anchor_actors": [
"OPEC", "沙特王室（MBS 派系）", "美国页岩油集团",
"俄罗斯能源集团", "伊朗革命卫队经济体系"
],
"narrative_competition": [
"\"石油武器\"叙事 vs \"市场驱动\"叙事",
"\"什叶vs逊尼\" vs \"民族国家利益\"框架"
],
"data_opacity_warning": [
"沙特内部派系关系不透明",
"伊朗革命卫队经济活动数据有限",
"非公开军售关系"
],
"search_templates": {
"actor_discovery": "[议题] key actors stakeholders power brokers",
"relation_discovery": "[actor A] [actor B] trade investment conflict alliance",
"treaty_discovery": "[议题] treaty agreement pact framework",
"ideology_discovery": "[议题] ideology doctrine school of thought influence"
}
}
与用户确认 ⛔（强制，不可跳过）：
issue_profile 摘要根据用户反馈修正 issue_profile：如用户要求修改，更新后再次确认。
纪元划分确认 ⚠️：基于议题时间范围，向用户提议 3-5 个关键纪元划分，并确认：
Phase 0 交付物：issue_profile（议题框架 + 纪元划分方案 + 搜索策略 + 锚点列表），经用户明确确认。
目的：系统性发现议题相关的核心精英集团、派系和关键行为体。
步骤：
搜索核心国家行为体：使用 search_templates.actor_discovery，查找议题中的关键国家及其内部权力派系。
搜索非国家行为体：
搜索关键人物：掌握决策权的核心个人（国家领导人、企业领袖、军事指挥官）。
搜索思想/意识形态节点：影响议题走向的意识形态和理论框架。
构建时间线：提取议题中的 3-7 个关键转折点/事件年份。
Wikidata 辅助查询：使用 scripts/wikidata_geopolitics_client.py 查询政治实体的 Wikidata 条目，获取正式名称、成立时间、成员国等结构化信息。
互动确认 ⚠️：向用户展示已发现的行为体列表 + 时间线，等待补充。
Phase 1 交付物：Actor 列表（15-40 个节点） + 事件时间线，经用户确认。
目的：调研所有行为体之间的关系，区分主边（利益关系）和注释层（条约、思想谱系），并为每条关系标注初步置信度。
⚠️ 关系类型规则：所有关系必须按 relation_types.md 分类。主边和注释层使用不同的视觉编码。
步骤：
调研主边关系（利益关系）：
调研注释层关系：
初步置信度评估：在调研过程中，为每条关系标注初步置信度：
叙事竞争标注：当同一关系存在竞争性叙事时（如"A 入侵了 B" vs "A 发起了防御性行动"），必须在关系注释中标注两种叙事，不选边站。
交叉验证：对关键关系使用多源交叉验证。特别注意：
关系完整性检查：逐一检查行为体，确保核心行为体之间的关键关系不被遗漏。
纪元标注 ⚠️：为每个节点和每条边标注 era 字段（所属纪元 ID 列表）：
label 设置为字典格式，以定义每个纪元特有的事件。
{"era1": "...", "era3": "..."}Phase 2 交付物：关系边列表（含初步置信度 + 证据来源 + 纪元标注） + 叙事竞争标注清单。
目的：对所有节点和边进行严格的置信度审计，清洗数据质量。
[!CAUTION] ⛔ 强制机制：本 Phase 结束时，所有节点和边都必须有明确的置信度标注。任何无标注项禁止进入 Phase 4。
步骤：
置信度终审：对每个节点和每条边，按 confidence_spec.md 进行最终置信度判定：
节点剪枝：
边剪枝：
聚类分组：按利益阵营/地理区域/议题维度聚合为 3-8 个阵营或利益集群。
置信度完整性检查 ⛔：逐一扫描——
Phase 3 交付物：审计后的 graph 数据（nodes + edges + groups + confidence_audit），所有节点/边均有置信度标注。
目的：将图数据转化为高质量、带置信度视觉编码的交互式 HTML 图谱查看器。
技术方案：在 generate_elite_network.py 中用 Python 数据结构定义节点、边、阵营、纪元，调用 export_html() 将数据注入 viewer_template.html，生成纯前端可交互的 Cytoscape.js 查看器。无需安装 Graphviz 或任何额外依赖。
步骤：
创建/更新 generate_elite_network.py，定义以下数据结构：
NODES：节点列表，每个节点含 id、label、type、group、confidence、era、desc 等字段EDGES：边列表，每条边含 source、target、rel、label、confidence、era 等字段GROUPS：阵营列表（势力框），含 id、label、color 字段ERAS：纪元列表，含 id、label、range、desc 字段置信度视觉编码 ⚠️（核心差异点）— 严格遵守 confidence_spec.md + visual_spec.md：
置信度通过节点/边的 confidence 字段传入，由 viewer_template.html 的 Cytoscape.js 样式自动渲染：
节点边框置信度编码：
| 置信度 | 边框样式 | 边框宽度 | 效果 |
|---|---|---|---|
| HIGH | 实线 | 粗 | 传达高确定性 |
| MED | 实线 | 中等 | 中等确定性 |
| LOW | 虚线 | 细 | 提示不确定性 |
| INFERRED | 点线 | 极细 | 明确标注为推断 |
边置信度编码：
| 置信度 | 线型 | 线宽 | 效果 |
|---|---|---|---|
| HIGH | 实线 | 粗 | 传达高确定性 |
| MED | 实线 | 中等 | 中等确定性 |
| LOW | 虚线 | 细 | 提示不确定性 |
| INFERRED | 点线 | 极细 | 明确标注为推断 |
节点配色、边样式 — 严格遵守 visual_spec.md 和
Phase 4 交付物：output/[Topic]_EliteNetwork_Viewer.html 交互式查看器 + 生成脚本。
export_html() 自动生成，内置纪元筛选器 + 时间线控件目的：生成地缘政治分析报告，让用户了解图谱的可信度、完整度和分析结论。
步骤：
生成分析报告 (output/[Topic]_EliteNetwork_Report.md)：
报告结构（必须包含所有章节）：
| 行为体 | 类型 | 阵营 | 置信度 | 简介 | 关键来源 |
| 行为体 A | 行为体 B | 关系类型 | Source 1 (URL) | Source 2 (URL) | 置信度 | 叙事竞争? |
质量统计：
Phase 5 交付物：
output/[Topic]_EliteNetwork_Viewer.html — 交互式图谱查看器（Phase 4 生成，Phase 5 最终确认）output/[Topic]_EliteNetwork_Report.md — 文字分析报告（含置信度审计 + 关系验证表 + 局限性声明）| 技能 | 用途 | 必需 |
|---|---|---|
tavily-search | 首选搜索：环境缺失则降级为 search_web | 可选（有 fallback） |
| 脚本 | 用途 |
|---|---|
scripts/wikidata_geopolitics_client.py | 查询 Wikidata 政治实体信息（组织、条约、政治人物） |
| 文档 | 内容 |
|---|---|
| data_schema.md | 节点/边类型定义、置信度标注规则 |
| confidence_spec.md | 四级置信度系统（判定标准 + 证据要求 + 视觉编码） |
| visual_spec.md | Graphviz 节点配色、边样式、置信度视觉编码、Legend 规范 |
| relation_types.md | 关系类型判定标准 + 边界案例 |
| analysis_framework.md | 地缘政治分析框架（权力结构、冲突热点、脆弱节点） |
调用 export_html() 生成查看器：
export_html(nodes=NODES, edges=EDGES, groups=GROUPS, eras=ERAS,
title="议题名称", output_path="output/[Topic]_EliteNetwork_Viewer.html")
布局验证 — 生成查看器后按 调试 checklist 检查