finance-news-warmap

金融创新作战地图（Finance News War Map）

一个「真实数据驱动 + 单一离线 HTML」的新闻情报地图工作流。它把 WebSearch 搜来的真实国内新闻按城市经纬度落点，用 ECharts 地理散点呈现，并带一个数据驱动的右侧「建议区」（自动总结趋势 + 给银行/保险/金融科技高管建议）。

核心立场（来自用户强约束）：只用真实搜索新闻，绝不编造；每个细分领域搜满目标条数；长字段写足；产出必须离线可双击打开。

---

〇、启动前需向用户确认的问题（Question Flow）

运行本 skill 前，按顺序确认以下问题；标注「默认不询问」的按默认值直接执行，标注「必问」的必须拿到答案再跑。

角色（#6）是唯一必须主动问的一项；其余一律默认，除非用户另行指定。角色决定建议区"高管建议"那一段的视角，命中种子场景用种子文案，否则按关键词从 DIRECTION_INSIGHTS 动态生成并固化。

---

〇·五、环境前置检查（调用时强制第一步 · Gate）

本 skill 的整个数据流依赖真实联网搜索——没有可工作的 WebSearch，后续 search→compile→fill 全部失去意义，且会直接触碰"只用真实新闻、绝不编造"的硬底线。因此在做任何搜索 / 编译 / 构建之前，必须先确认环境具备联网搜索能力；确认通过才进入 Step 1，不通过则立即中止。

检查步骤（agent 在调用 skill 时执行）：

1. 先按 Question Flow 向用户问清必要项（其中 #6 角色必问；其余默认）。
2. 探测：执行一次轻量 WebSearch（如查询 金融科技 创新 新闻 2026 或任何与任务相关的真实关键词，freshness 用 d7）。
3. 判定：
   • ✅ 成功返回 ≥1 条真实结果（有标题 / 链接 / 摘要）→ 环境可用，继续 Step 1。
   • ❌ 工具不可用 / 调用被拒 / 沙箱网络被阻断 / 返回空或报错 / 只返回"无法访问"之类占位 → 立即中止。
4. 中止处置：明确告知用户——"本环境当前不支持联网搜索（WebSearch 不可用 / 网络受限）。按硬规则『只用真实新闻、绝不编造』，无法执行后续流程。"然后停止。不要尝试用训练记忆编造新闻，也不要改用离线占位数据蒙混。可建议用户：
   • 开启联网 / 搜索工具后重试；或
   • 改为仅基于用户已提供的本地新闻文件（news.xlsx 或传入的 JSON）做 build（此时需用户明确认可"只用本地既有数据、不再补新搜"，且仍遵守长字段≥100字 / 去重等规则）。

注意：WebSearch 是 agent 侧的服务器工具；脚本内的 pipeline.py search 只打印查询供人工 / agent 去搜，本身不联网。所以"是否支持联网搜索"只能在 agent 调用 skill 时由上述探测判定，不能靠脚本断言。

---

〇·六、数据安全与对外传输声明（透明性 · 回应供应链/外传审查）

本 skill 是纯本地生成器，不存在隐藏或自动化的对外网络调用。所有对外传输都需用户显式触发并自带凭据：

1. 联网搜索（WebSearch）由调用方 agent 执行，不是 skill 代码联网：build.py / pipeline.py / template.html 在运行时不发起任何 WebSearch 或互联网请求——pipeline.py search 只把查询打印出来供人工/agent 去搜。
2. 离线单文件是强制硬指标（无 CDN / 无外部字体）：template.html 不再引用任何外部 https:// 的 或。ECharts 库、world/china GeoJSON、xlsx 导出库全部随技能分发于 assets/ 并在构建时内联进 HTML；字体仅用系统字体栈回退（Microsoft YaHei / PingFang SC 等）。生成的 HTML 双击离线可用，不经过任何第三方服务器。
3. 远程同步（Supabase pull/push）完全可选 + 显式 + 用户凭据：
   • 仅当用户主动运行 build.py pull / push / build --source supabase 时才会发生；
   • 需要用户在本地 config.toml 显式填入自己的 Supabase url/key/table，缺文件即报错中止，绝不静默连接；
   • 默认 build（无 --source）只读写本地 news.xlsx，完全不触碰任何远程；
   • 不存在自动上传、环境变量 harvesting、文件系统枚举用于外传等行为。
4. 不编造 / 不做离线占位：WebSearch 不可用且用户未提供本地数据时，按规则立即中止，绝不用记忆编造或离线占位数据蒙混（见「〇·五」）。

说明：本 skill 的「只用真实新闻、绝不编造」「调用即探测 WebSearch」等是对调用 agent 的流程约束（指令），由 agent 在调用时落实，而非由 skill 代码在运行时做断言式强制。agent 应如实向用户说明当前环境是否具备联网搜索能力。

---

一、何时用这个 skill

• 用户想做 Palantir 风格的「新闻作战地图 / 情报地图 / 创新动态地图」：散点落点 + 可筛选 + 可悬停 + 中国/世界切换。
• 用户想做「搜新闻 → 编译 JSON → 去重并入 → 自动补满每个细分领域 N 条」的流水线（杜绝虚拟/占位数据）。
• 用户想要一个「建议区 / 洞察面板」，从实时新闻数据自动总结趋势与高管可执行建议（不是写死的模板话术）。
• 用户要「双击可打开、可邮件分享」的单一离线 HTML（库与地图数据全部内联，不依赖 CDN/网络）。

---

二、硬规则（默认开启，除非用户明确授权跳过）

1. 联网搜索能力前置 Gate（最先执行）：调用本 skill 时第一步先探测当前环境是否支持真实联网搜索（WebSearch 可用且能返回真实结果）。不支持则立即中止整个流程，绝不退化为"用记忆编造新闻"或"离线占位数据蒙混"。详见下一节「环境前置检查」。
2. 只用真实新闻：全部来自 WebSearch（默认 freshness=d7 最近一周），绝不编造、绝不虚构事件/链接。
3. 每细分领域搜满目标条数（默认 TARGET=5）：不足时只报缺口，不编造占位补齐。
4. 时间窗口默认最近一周（freshness=d7）：直接默认，不询问用户；如需其他窗口（近 1 月/指定日期）才单独确认。
5. 长字段写足：每条新闻的 event / why / innovation / learn 四个字段各 ≥ 100 字。注意去重保留首次出现，所以必须在 fill 前补全，否则合并后无法覆盖。
6. 离线单文件：产出 HTML 必须把 echarts 库与 world/china GeoJSON 全部内联，双击即可打开、可邮件分享。
7. 去重不重复：已存在新闻按 norm_key 去重，合并时 existing 在前，绝不重复存储。

---

三、架构（单一离线 HTML + 占位符模板）

template.html  ──(占位符替换)──►  金融创新全球作战地图.html   ← 双击离线打开
build.py      读 news.xlsx（可编辑数据源）注入 __NEWS__ / __SUGGESTIONS__
pipeline.py   分类法真理源 + 搜索/状态/补满 流水线
assets/       echarts.min.js + world.json + china.json（34 省）← 构建时内联

template.html 用 6 个占位符，由 build.py 替换：

references/ 目录里是可直接复用的脚手架（自包含，无需联网下载额外文件）：

references/
├── template.html          # Palantir 风三栏地图模板（含占位符，离线单文件目标）
├── build.py               # 生成器：init/build/merge/replace + 建议区计算 + 去重
├── pipeline.py            # 20 子领域 taxonomy 驱动的 search/status/fill/rebuild 补满流水线
├── news_sample.json       # 内置示例数据源（11 条，init/build 缺 xlsx 时回退用）
├── db.py                  # Supabase 读写（可选，pull/push 用；凭据走本地 config.toml）
├── config.example.toml    # Supabase 配置样例
└── assets/               # 离线单文件必需，已随技能分发
    ├── echarts.min.js     # ~1MB，内联进 HTML
    ├── world.json         # ~1MB，世界地图边界
    └── china.json         # 中国 34 省边界

三·5、环境准备（依赖与目录约定）

1. 装依赖：pip install -r requirements.txt（核心只要 openpyxl；supabase 仅 pull/push 时需要）。
2. 数据/产物落在「当前工作目录（CWD），不污染技能安装目录——这是本 skill 的可分发约定：
   • 只读资产（template.html / assets/ / news_sample.json）随技能分发，安装后不应改动；
   • build.py 把 news.xlsx（数据源）与 金融创新全球作战地图.html（产物）写到你运行命令时所在的目录；
   • 所以在你自己的项目目录里运行 build.py / pipeline.py 即可，不要在技能安装目录内直接写。
3. 快速开始（在你自己的项目目录执行）：

   python build.py init          # 用内置示例生成 news.xlsx（可编辑数据源）
   python build.py build         # 读 news.xlsx -> 生成离线单文件 HTML 到当前目录
   # 或跳过 init，直接 build（缺 news.xlsx 时自动回退示例）
   python build.py build --role "浙江省分行行长"   # 指定建议区视角后固化进 HTML
   

4. 联网能力前置（Gate）：本 skill 的「新闻」来自真实 WebSearch，必须先按「〇·五、环境前置检查」探测 WebSearch 可用；不可用时立即停止，绝不编造/占位。

---

四、数据 schema（13 列，news.xlsx 与 JSON 通用）

time / category / direction / company / city / lng / lat / title / link / event / why / innovation / learn

• JSON 用 coord:[经度,纬度]；xlsx 用 lng/lat 两列（build.news_to_xlsx / xlsx_to_news 自动互转）。
• event/why/innovation/learn 各 ≥ 100 字——这是用户的硬指标。
• category 取值示例：银行 / 保险 / 金融科技（对应配色 cyan / violet / amber）。

---

五、工作流（端到端）

1. 环境前置检查（Gate，必须最先执行）：按「〇·五、环境前置检查」做 WebSearch 探测。不可用 → 立即中止并告知用户，不进入后续任何步骤。可用 → 继续。
2. 定义分类法 TAXONOMY（唯一真理源）：(大类, 方向, 搜索查询) 三元组列表——图例、筛选、补满标准都以它为准。示例 20 项：银行(存款理财/公募私募/银保/信托/个人信用贷款/信用卡分期/汽融/个人房贷/个人房地产抵押贷款/小微企业主贷款) 10 项 + 金融科技(产品创新/模式创新/技术创新/需求走向/权益升级) 5 项 + 保险(寿险/财险/健康险/养老险/普惠保险) 5 项。
3. 搜索：对每个子方向 WebSearch（默认 freshness d7 最近一周，不询问），收集真实国内新闻候选。
4. 编译 JSON：每条含 13 字段；coord=[经度,纬度]；link 用真实 URL；四长字段写足 ≥100 字。
5. 去重并入：pipeline.py fill （或 build.py merge ），existing 在前 → 不重复 → 重写 news.xlsx + 重建 HTML。
6. 查缺口：pipeline.py status 列出每类 当前 vs 目标，打印缺口方向。
7. 补满：对缺口方向再搜、再 fill，循环直到每类达标。
8. 确定视角/角色（问用户，不写死）：在 build 前问用户「你是什么角色/视角？」（如"浙江省分行行长""零售条线总监""合规官"）。该角色通过 build.py build --role "角色名" 固化进 HTML 的建议区——不在浏览器里做角色输入框或切换器。
9. 重建：每次改完 news.xlsx 后 build.py build [--role ...] 重生成单文件 HTML。
10. 校验：占位符无残留、JSON 合法、每子方向计数、分类值在 {银行,保险,金融科技} 内。

---

六、关键代码模式（直接复用）

去重主键（保证已存在不重复存储）

import re
def norm_key(n):
    link = (n.get("link") or "").strip().lower()
    if link:
        return re.sub(r"[?#].*$", "", link)        # 链接去 ?# 参数后小写
    return re.sub(r"\s+", "", (n.get("title") or ""))  # 否则标题去空格兜底

def dedup(news, keep_first=True):
    seen, out = set(), []
    for n in news:
        k = norm_key(n)
        if not k or k in seen:
            continue
        seen.add(k); out.append(n)
    return out

数据驱动「建议区」（build 时实时算，非写死）

build_suggestions(news, role=None) 返回结构（role 由 --role 在 build 时传入，默认 金融高管视角）：

• total / span[起,止] / catCounts（大类分布条）
• trends：取出现频次 ≥2 的子方向 Top6，每条带 trend(趋势判断)+advice(高管动作)+evidence(2 条真实标题)
• execAdvice：单一角色块（不再是浏览器里的多受众切换）。命中 ROLE_ADVICE 种子（金融高管视角/银行高管/保险高管/金融科技负责人/分行行长等）用种子文案；否则按 ROLE_KEYWORDS 关键词匹配最相关业务方向，从 DIRECTION_INSIGHTS 动态生成 4 条建议并固化。角色不在浏览器交互选择——只在 build 时由 --role 决定，默认 金融高管视角。

趋势/建议文案放两张常量表，由数据驱动选取，避免模板话术：

• DIRECTION_INSIGHTS[方向] = {trend, advice}（每个子方向一条实战洞察）
• ROLE_ADVICE[角色] = {color, icon, points:[...]}（种子场景，可增删改；任意未命中角色由关键词动态生成，绝不写死受众集）

文案要「真判断、敢拆穿伪创新」，不要包装式空话。例如银保写「从趸交理财转向期交保障+养老，银行渠道从通道变客户经营伙伴」；AI 写「从 PoC 到生产，先建数据底座与 AI 中台，重定义可计算的非结构化资产」。

占位符替换 + 断言无残留

out = (tpl
  .replace("__ECHARTS_LIB__", echarts).replace("__WORLD_JSON__", world.strip())
  .replace("__CHINA_JSON__", china.strip()).replace("__NEWS__", news_js)
  .replace("__SAMPLE__", "true" if is_sample else "false")
  .replace("__SUGGESTIONS__", sugg_js))
for tok in ("__ECHARTS_LIB__","__WORLD_JSON__","__CHINA_JSON__","__NEWS__","__SAMPLE__","__SUGGESTIONS__"):
    assert tok not in out, f"占位符未替换: {tok}"

光点按时间「挨个闪烁」（非齐闪）

animationDelay: function(idx){ return order.indexOf(idx)*160; }，其中 order 是按 time 排序后的原始下标序列。

---

七、性能与体验要点

• 大体积 GeoJSON 解析后置：首屏先画界面框架，window.onload 后再 initMap()，避免阻塞首屏。
• 扫描/动画从简：去掉开机动画、扫描线；用 effectScatter 涟漪即可，保持清爽（用户明确嫌扫描特效丑、嫌慢）。
• 字体：仅用系统字体栈回退（Microsoft YaHei / PingFang SC / Hiragino Sans GB 等），不再引用任何外部字体 CDN，离线打开即生效，体感无明显塌方即可。

---

八、地图合规

• 用官方/标准 china.json（含 34 省级行政区边界），不要自绘、不要缺省省份。
• 中国为默认视图，center:[105,36]、zoom:1.5；世界视图 center:[68,22]、zoom:1.25。

---

九、常见坑（已踩过）

• Windows schannel 证书：git/网络若报 CRYPT_E_NO_REVOCATION_CHECK，curl 加 --ssl-no-revoke、git http.sslVerify false（仅本仓库）。
• WebSearch 无 URL（标 Untitled）：部分长文/聚合页无有效链接 → 编译 JSON 时改用同领域其他带 URL 结果，避免 norm_key 碰撞或无效链接。
• 短字段：dedup 保首次，短字段必须在 fill 前补全（可用 expand.py 批量把 <100 字字段补到 ≥100 字，基于该条的 company/city/title/direction 写具体不泛化的内容）。
• 分类错配：深圳建行「经营贷」应归「个人房地产抵押贷款」而非「个人房贷」；分类必须严格对齐 TAXONOMY，否则计数错位、建议区错配。
• NEWS[0].time 空：stats() 里 NEWS[0]?NEWS[0].time.slice(0,10):... 要兜底，避免首屏报错。

---

十、交付物清单

• 金融创新全球作战地图.html —— 离线单文件（库+地图内联），双击即开、可邮件分享。
• finance-map/news.xlsx —— 可编辑数据源，用户可直接改表、再 build 重建。
• references/ —— 可复用脚手架：template.html / build.py / pipeline.py。

注：build.py 依赖 assets/echarts.min.js、assets/world.json、assets/china.json、assets/xlsx.full.min.js 四个文件，均已随技能分发、置于脚本同级的 assets/ 目录，构建时全部内联进 HTML。不依赖任何运行时 CDN——离线双击即可打开。xlsx 导出库用于浏览器端"导出当前数据为 .xlsx"功能。