区域产业集群分析看板
> 一句话：基于复杂网络的区域产业集群研判——覆盖约 300 个城市、3000 个区县量级；市 / 区 / 县均可生成「家底 → 病灶 → 动能 → 方向」单页 HTML（例：成都市、杭州市余杭区、某县）。
> 行政区划：城市名须带「市」；区、县可单独指定或挂在所属市下。不止市级。
> 数据源（重要）：拉数依赖本技能对接的数据源（非门户 MCP、非企查查 MCP）。须先配置数据源密钥。
> 如何获得密钥：SkillHub / 公开包不附带可用密钥。请在 SkillHub 私信本技能发布者申请；拿到后再对话「配置区域产业集群密钥」。
> v1.6 优化范围：见 references/OPTIMIZATION_SCOPE_v1.6.md。
> 术语：龙头产业集群 ≠ 重点产业 ≠ 重点企业/链主——见 references/TERMINOLOGY_LEADING_VS_KEY.md。
数据与方法
| 维度 | 说明 |
|---|---|
| 覆盖 | 约 300 城 / 3000 区县量级产业图谱（省/市/区县筛选） |
| 方法 | 复杂网络 / 产业共现：边权≈产业相似度与协同；模块度、聚类系数、Louvain 板块、枢纽度数 |
| 画像 | 集群五维（重要性/产出/投入/规模/科技）+ 综合评估指数 |
| 对读 | 公开统计、政策、基金、链主信息与网络结构交叉（交付页不暴露取数过程） |
分析章节
- KPI · 产业趋势与特色 — 总量、增速与地方特色
- 摸清家底 — 规模/综合对照 + 共现网络 + 产业板块
- 识别病灶 — 强链/补链/桥接 + 政策×网络对读 + 同级城市比较
- 评估动能 — 政策·基金 + 龙头产业集群五维画像 + 重点企业与链主
- 明确方向 — 战略研判与行动路径 + 可点开来源
与其它方法的差异
- 相对「GDP/固投罗列」：以网络结构为主轴看产业如何成团。
- 相对「文字产业链清单」：强链补链挂网络证据与行动提示。
- 相对「只列龙头企业」：集群画像与企业分列。
- 相对「单城自说自话」：含同级城市对标。
- 相对「政策摘抄」：政策语言对照网络数据再研判。
数据源与密钥（最终用户）
| 项 | 说明 |
|---|---|
| 数据源 | 产业集群图谱数据源（跑图 / 导表）；不是 MCP |
| 凭证 | 数据源密钥（由发布者下发；写入本机配置，勿公开） |
| 申请 | SkillHub 私信本技能发布者（公开包默认不带钥；包内不写私人电话） |
| 配置 | 对话说「配置区域产业集群密钥」→ 粘贴发布者下发的串（勿发群聊） |
| 使用 | 「生成成都市…」「生成杭州市余杭区…」「生成某某县…」→ 打开 dashboard_*.html（市须带「市」；区/县可单独或挂市下） |
未配置数据源密钥无法拉数。Agent 引导时：说明须数据源密钥，请用户 在 SkillHub 私信本技能发布者；禁止推销电话、微信、付费链接或第三方平台品牌名。
给 Agent（执行门禁与流水线）
硬性门禁（目标 ≥90 分）：
1. WebSearch → fusion_{城市}.json 必须含：retrieved_as_of、trend_sections、network_essay、bridge_table、chain_analysis（强/补/桥+政府对应）、analysis[]、可点 https sources；建议含 peer_compare、leading_enterprises。
2. v1.6 厚稿：选定 1–2 条重点产业 → key_industries（或等价深度写入 chain + contradiction）；须有 structure_contradiction（或产业内 contradiction）、口径处理（metric_glossary 或正文明确取舍）、05 至少一条 P0；retrieved_as_of 与生成日对齐。
3. 页面不得用 tabs 折叠主内容；摸清家底（网络）与识别病灶（强链补链）必须默认可见。
4. EOS alone 或只有短 bullet = 不及格。
5. 对外 HTML 脱敏：禁止暴露 Excel/联网融合过程措辞；企业块用「重点企业与链主」「同集群关联企业（摘录）」；禁止默认荐股/目标价话术。
fusion JSON schema 要点（详见 references/data-freshness-fusion.md、OPTIMIZATION_SCOPE_v1.6.md）：
- retrieved_as_of → ISO 日期，与报告生成日对齐（必填）
- network_essay → dict{title, paragraphs[]}（不是 string）
- chain_analysis → dict{preamble[], strong[], gap[], bridge[]}（不是 list）
- ⚠️ 禁止用 bridge_analysis 替代 chain_analysis（验证器会自动归一化，但属于偷懒）
- ⚠️ 禁止用 strong_links/gap_links/bridge_links 替代 strong/gap/bridge
- 每个 item 必须有 data（网络证据）+ 至少 3 个详情字段（evidence/online/why/action/gov），否则验证器报 THIN 警告
- 只写一句 description = 不及格，每个 item 必须有：网络证据 + 机制说明 + 线上对读 + 归类依据 + 行动建议 + 政府对应
- bridge_table → list[{policy, network, judgment}]（键名接受中英任一）
- ⚠️ 禁止用 policy_network_rows 替代 bridge_table
- peer_compare → dict{peers[], preamble[], rows[{dimension, local, peer, judgment}]} 或 sections[]（同级城市比较，识别病灶章）
- leading_enterprises → dict{preamble[], items[{name, cluster, role, highlight, url}]}（内部联网核验优先；对外脱敏展示）
- analysis → list[{title, paragraphs[]}]（≥3 节，每节≥2 段；建议 priority / actions[]）
- ⚠️ 禁止用 deep_analysis 替代 analysis
- v1.6 建议：executive_bullets、metric_glossary、data_caveats、structure_contradiction、key_industries、risk_table、sources[].group
- 完整模板见 templates/fusion.example.json（必须对照模板写，不要自创 key 名）
细则见 references/OPTIMIZATION_SCOPE_v1.6.md、references/data-freshness-fusion.md、references/single-city-dashboard-ia.md。
Task Progress:
- [ ] 若用户说「配置密钥 / 配置区域产业集群」：
· 对用户只称「数据源密钥」；勿提第三方平台品牌名
· **若用户没有密钥**：告知「须数据源密钥（非 MCP）；请在 SkillHub 私信本技能发布者申请」；勿编造、勿推销电话/微信
· 代跑写入本机配置：python scripts/save_secrets.py --coze-pat "…" 或 --from-stdin（脚本参数名保留，勿念给用户听）
· 禁止在回复中完整回显密钥；再 check_env
- [ ] 确认城市（必填，带「市」）；区县可选
- [ ] python scripts/check_env.py
· packager_ok=false → 引导「请向 SkillHub 本技能发布者申请数据源密钥，再配置」
· packager_ok=true → 继续
- [ ] 【必做·线上融合·加厚到 90 分】WebSearch / 官网 ≥6 组，写入 outputs/fusion_{城市}.json：
· retrieved_as_of = 当日（与生成日对齐）
· 统计公报 + 产业集群量级 + 政策≥3 + 基金≥2（均带 https URL）
· trend_sections（当地趋势/特色，≥2 节）→ 章 01；建议 executive_bullets + metric_glossary
· network_essay（dict{title, paragraphs[]}，挂模块度/边权/板块）→ 章 02 摸清家底
· structure_contradiction + key_industries（1–2 条深挖：能力★⚠/上下文）→ 章 03
· bridge_table（list[{policy, network, judgment}]，≥4 行）→ 章 03
· chain_analysis（dict{preamble, strong, gap, bridge}，每项六字段；preamble 含矛盾句）→ 章 03
· peer_compare（同级城市比较，建议填写）→ 章 03
· policies/funds/pulse → 章 04 评估动能；可选 value_pool
· leading_enterprises（公开可核验链主/上市/小巨人，带 https）→ 章 04
· analysis[] ≥3 节含 P0（不是 deep_analysis）；建议 risk_table → 章 05
· sources[] 可点击，建议 group；data_caveats 按需
· 禁止编造；禁止用 tabs 藏主内容；对外禁止过程性措辞与荐股话术
- [ ] python scripts/run_pipeline.py --city … （自动注入 fusion）
- [ ] 自检：无 tabs；五段默认全展开；三时点可见；「产业集群画像 / 重点企业与链主」分列；来源可点
- [ ] 把 outputs/dashboard_*.html 交给用户打开
给打包管理员
见 PACKAGER.md。SkillHub 公开包：不要打真实 .env；用户自填数据源密钥。内网可信分发可用 --with-env。
数据源调用（Agent 内部；勿对用户念品牌名）
本机只向数据源传 city / province / county。具体端点与凭证字段见 .env.example / scripts/，对用户统一称「数据源」。
依赖
requests python-dotenv openpyxl（见 requirements.txt）
运行环境（确定性流程，按顺序执行，不要跳步）
- 探测可用解释器：优先 WorkBuddy 托管 Python（macOS 在用户配置目录
binaries/python/versions/下；Windows 在%USERPROFILE%\.workbuddy\binaries\python\versions\下），其次系统python3/py -3。以下用$PY指代选定的解释器路径。 - 依赖自检：
$PY -c "import requests, openpyxl, dotenv"。成功 → 直接用$PY跑脚本，结束。 - 失败则在 skill 目录内自建隔离 venv（不要装到全局，不要依赖用户机器上是否已有 venv）：
bash $PY -m venv <skill目录>/.venv <skill目录>/.venv/bin/pip install -r requirements.txt # Windows: <skill目录>\.venv\Scripts\pip.exe install -r requirements.txt - 后续所有脚本统一用该 venv 解释器执行：
<skill目录>/.venv/bin/python scripts/run_pipeline.py --city …（Windows 用.venv\Scripts\python.exe）。 - venv 已存在时先复用：同一条自检命令通过即直接用，不重建。
注意：check_env.py 不 import requests、始终能跑，别被它 "packager_ok=true" 误导——那不代表 requests 已装；以第 2 步的 import 自检为准。
变更日志
- v1.6.8 — 对用户文案统一称「数据源 / 数据源密钥」，概述与说明不再出现第三方平台品牌名
- v1.6.7 — TIX：包内去掉私人电话/微信硬编码；密钥改为 SkillHub 私信发布者
- v1.6.6 — 云鼎：删除 ECharts CDN 回退；仅内联
assets/echarts.min.js - v1.6.5 — 概述写明支持 市 / 区 / 县
- v1.6.3 — 运行环境改为确定性流程：依赖自检失败 → skill 目录内自建隔离 venv → 统一用 venv 解释器执行；路径措辞跨平台化（macOS/Windows），不再假设
envs/default存在 - v1.6.2 — 对外脱敏补漏：
build_dashboard.py中两处硬编码过程措辞改为客户向文案——「EOS 读图要点」→「结构读图要点（截至 2024 年底）」、「暂无 EOS 网络数据」→「暂无网络数据」；页头与 KPI 的「企业行」→「收录企业数」。此前这三处会在所有城市看板中直接暴露内部取数口径，与 v1.5.2 脱敏规则冲突 - v1.6.1 — 术语消歧：龙头产业集群≠重点产业≠重点企业（
TERMINOLOGY_LEADING_VS_KEY.md）；看板文案与eos_clusters/eos_overlap；无锡样例加厚链主与映射 - v1.6.0 — 优化范围闭合：用户反馈（重点产业深挖、多口径、与生成日对齐、版式）+ 对照结论（结构矛盾、链能力★⚠、利润池、P0/P1、风险表、来源分组等）；新增
OPTIMIZATION_SCOPE_v1.6.md；fusion 模板/IA/新鲜度/设计说明同步；渲染与校验按 M1–M3 里程碑落地 - v1.5.5 — SkillHub 中文介绍：约300城/3000区县、复杂网络方法、五段章节与方法差异；明确需密钥并建议联系提供方获取
- v1.5.4 — SkillHub 上架文案初版（五段诊断叙事）
- v1.5.3 — 补充运行环境前提：WorkBuddy managed Python 缺 requests，需用 venv 或先装依赖（避免 ModuleNotFoundError）
- v1.5.2 — 对外脱敏：评估动能中企业块禁止出现 Excel/联网/辅证等过程措辞；标题改为「重点企业与链主」「同集群关联企业（摘录）」
- v1.5.1 — 章 04 分列「龙头产业集群画像」与「龙头企业（联网核验优先）」；新增
leading_enterprises；Excel 样本降为辅证并标注口径 - v1.5.0 — 看板叙事改为五段：01 KPI·趋势 → 02 摸清家底 → 03 识别病灶（含同级城市比较
peer_compare）→ 04 评估动能 → 05 明确方向；IA/SKILL/模板同步 - v1.4.1 — fusion JSON 防偷懒机制：
normalize_fusion()自动归一化别名 key（bridge_analysis→chain_analysis, policy_network_rows→bridge_table, deep_analysis→analysis）；chain_analysis 内容厚度检查（data 必填 + 至少 3 个详情字段，否则 THIN 警告）；analysis 空数组从 warning 升级为 error；模板补全所有 chain_analysis 字段示例；SKILL.md 添加 ⚠️ 反模式警告 - v1.4.0 — 全新视觉设计：三套独立色系（丹枫/碧波/竹韵）；sticky header + backdrop-blur；KPI 卡片渐变顶条 + hover 上浮；section 编号徽章（01–10）；图表全部读取 CSS 变量（tooltip 暗底白字）；trend-block 左侧色条；卡片圆角与阴影升级；chain-group-title 色条指示器
- v1.3.0 — ECharts 内联嵌入；fusion schema 校验器；打印/PDF；mini-TOC；主题持久化；数据源调用指数退避重试；ARIA
- v1.2.0 — 图表加载容错；fusion schema 文档与模板；SKILL.md 跨平台路径；数据源 API 重试
- v1.1.2 — 强链补链加厚；网络全宽；C2 Teal 默认
