# 本地经济活跃性代理：计算口径与研究决策

**日期：2026-10-03。状态：已采用；网页已采用双视角，默认显示本地成本加权商业集聚。**  
本文是门店力地图的独立阅读版说明。当前主指标由前期“每家门店等权密度”修正为“成本加权商业集聚”，保留共同 5 km 的观察尺度、H3 网格精度和已完成的数值实验；等权密度作为对照继续展示。下文提及的研究归档文件供项目复现使用，不随本说明下载。

## 1. 纠正目标替换

用户要衡量的是**当地经济活跃性**，不是单纯数门店。上一版为了获得容易解释的量，把主指标收缩成设施密度；透明计数不代表它更适合原来的经济目标。等权本身也是假设，并不比成本权重天然更客观。

同样需要纠正实验解释：等权、成本平方根、成本权重的共址表现接近，只说明它们在“不同品牌是否聚在一起”这个检查上差异不大。**共址不是经济真值，不能据此判定经济权重应当相同，也不能认定成本信息没有价值。**

## 2. 为什么成本有意义，但不等于经济贡献

在其他经营条件相近时，更高的建店投入意味着更高的资金门槛；一家能够持续经营的高投入门店，可能对当地市场承载力提供更强信号。这是合理的经济机制假设，不是本数据已经验证的因果结论。当前快照也不能证明每家门店已经持续盈利。

成本还包括面积、设备、业态和装修差异；品牌布局也受扩张策略、供应链和加盟模式影响。[百胜中国关于店型与扩张策略的原始披露](https://ir.yumchina.com/news-releases/news-release-details/yum-china-unveils-rgm-30-strategy-and-three-year-financial/) 因此：

- **给予高投入门店更高权重，有目标上的理由。**
- **300 万元投入不等于 25 万元投入的 12 倍真实经济活跃性。**
- 麦当劳数量少本身不足以证明信息更强；不额外乘以“稀缺系数”。稀缺可能来自经营策略，不能直接用全国门店数的倒数当作经济权重。

## 3. 当前采用的可解释先验

复用已经算出的共同 5 km、H3 res8、归一化线性核品牌密度：

```text
D_b(x) = 3 / (π × 5²) × Σ max(0, 1 − 门店距离_km / 5)
I(x) = 300 × D_麦当劳(x) + 150 × D_肯德基(x) + 25 × D_蜜雪(x)
```

成本采用用户提供的假设，单位为万元；`D` 是各品牌门店/km²。结果单位为“万元建店成本假设当量/km²”。建议产品名称为 **经济活跃性代理：成本加权商业集聚**，不能直接标为 GDP、营收、人流、实际资产或已验证的经济活跃度。

相对权重为 **12∶6∶1**。同距离下，相当于 **1 家麦当劳 = 2 家肯德基 = 12 家蜜雪**。这是明确可质疑的模型取舍，不是假装由现有数据学出的真实经济换算关系。

| 部分 | 当前定位 |
|---|---|
| 成本加权商业集聚 | 主视角：用商业投入门槛代理当地消费市场承载与集聚 |
| 每店等权密度 | 对照：区分“很多低投入门店”和“较多高投入门店” |
| 三品牌分项 | 解释主分数由谁支撑，不把全部结构藏进一个总分 |
| 旧 40 km 模型 | 区域辐射背景，不冒充当前位置的经济活动 |

空间距离仍对三品牌一视同仁。**更高成本提高贡献权重，不再同时扩大辐射半径**，避免把远处门店算成本地活动，也避免重复加权。5 km 仍只是已声明的局部观察折衷，不是真实消费服务圈。

## 4. 现有数据能看出的差异

以下是具体行政参考点所在 H3 格子，不是整座城市的排名：

| 参考格 | 每店等权密度（门店/km²） | 成本信号（万元假设当量/km²） |
|---|---:|---:|
| 北京 | 2.2922 | 364.09 |
| 郑州 | 2.4015 | 139.70 |
| 上海 | 3.2517 | 624.14 |
| 新乡 | 0.9897 | 40.02 |
| 仙桃 | 0.4803 | 36.33 |
| 大厂 | 0.1966 | 18.89 |

等权时，北京、郑州两个格子的设施密度相近；成本加权后，门店结构差异被表达出来。**这说明模型回答的问题变了，不构成经济真值验证，也不是为了迎合熟悉的城市次序而调权重。**

## 5. 结果及参照同步修正

不用重新计算空间距离，直接复用原研究中已存在的品牌分项。旧等权结果完整保留为基线，不悄悄改写它的字段含义。

- 当前主指标说明（项目研究归档：`economic-activity.json`）：成本假设、公式、单位、参照分位点、文件哈希。
- 当前主指标全国格子（项目研究归档：`economic-activity-grid.npz`）：与原 1,294,315 个非零格相同的 H3 集合，另存成本信号和自己的百分位。
- 当前主指标行政参考点（项目研究归档：`economic-activity-points.json`）：3,218 条参考点结果，同时保留等权密度对照。

继续使用同一快照的 43,915 个有店 res8 格作参照，但**重新计算成本信号的中秩经验分布**，不能沿用原等权百分位。连续原始值为主，不强制分十级；正值处于 0 百分位仍不是无信号。

成本参考百分位 `P = 100 × (低于当前成本分数的参照格数 + 0.5 × 同分参照格数) / 参照格数`。它描述该格在已观察到门店地点中的相对位置，不是人口分位或城市排名。

复现需要项目中的既有研究数据：共同 5 km、H3 res8 的各品牌归一化门店密度及行政参考点结果；在此基础上生成成本指标：

```sh
uv run scripts/export_economic_activity.py
```

网页已采用双视角，落地方式见第 8 节。原 `recommended-grid.npz` 的 `density` 仍指等权密度；当前主指标读取 `economic-activity-grid.npz` 的 `score`。坐标、品牌密度和计数可按相同 H3 索引从原表获取。

## 6. 能承诺什么

这是**更贴合经济承载假设**的主代理，不是已证明比等权更准确的经济测量。三品牌餐饮主要反映消费商业一侧，无法完整观察工业生产、出口、物流、金融、线上经济等活动；也不能从一次门店快照推断经济增长速度。

后续若有独立营业额、人流、就业、租金或更广业态数据，应在留出区域校准成本权重和观察尺度。当前先采用用户明确提供的成本关系，不再用没有经济标签的共址实验替经济权重作裁决。

## 7. 补充审计：5 km 会留下多少空白

针对覆盖范围的追问，逐个还原现有 1,294,315 个正值 res8 格，将几何投影到与原分析相同的 Albers 等积投影，并对边境/海岸格按内地边界裁剪。没有用格子数量乘全球平均面积。

| 土地面积口径 | 审计结果 |
|---|---:|
| 5 km 正值格的内地面积 | 794,509.22 km² |
| 占项目统计内地土地面积 | 8.3747% |
| 正值格之外的土地面积占比 | 91.6253% |
| 原网页品牌半径 40/28.28/11.55 km 的正值格面积占比 | 36.1089% |

所以**从全国土地面积看，确实绝大部分区域没有 5 km 三品牌信号**。这些数字是格中心采样后所代表的裁剪格面积，不是连续空间中 5 km 圆盘并集的严格面积，更不是人口或经济活动覆盖率。原网页与新结果的尺度、网格分辨率不同，旧值只作范围背景对照。

另一种口径是现有行政参考点：5 km 下，城市参考点 368/369 有值（99.73%），县区参考点 2,797/2,849 有值（98.17%）。扩大到 10/20 km 后，县区参考点有值数变为 2,805/2,811。它们只描述项目已有参考坐标所在格，不表示整个城市或县域都被覆盖；来源列表也不能当作严格的人口或内地行政抽样框。

**解释上的约束：5 km 是本地消费商业集聚观察层，不足以独自描绘全国所有形式的经济活跃性。** 全国视角可并列较大尺度的区域背景，不能把远处贡献静默当成本地活动，也不能仅为填满地图而扩大半径。空白应标为“5 km 内无三品牌近邻信号”，不能标为“经济活动为零”。所有品牌成本权重均为正，所以从等权改成本加权只改变分数强弱，不会改变这一零/非零覆盖范围。

面积审计结果与来源哈希（项目研究归档：`coverage-footprint.json`）；复现命令：`uv run scripts/audit_scoring_footprint.py`。该次审计完成时只补充范围结果，未调整模型参数或网页；随后网页落地采用下面的双视角方案。

## 8. 网页落地：本地为主，区域背景另看

网页默认展示**本地经济活跃性代理**：三品牌共同 5 km、H3 res8、成本相对权重 12∶6∶1。主分数为连续成本当量密度，详情保留每店等权密度、三品牌贡献，以及成本参照分布的中秩经验百分位。参照仍是同一快照 43,915 个有门店格，百分位不是城市等级或人口排名。本地视角提供 0–100 整数百分位双滑块和精确输入，按详情中的同一成本参考百分位筛选；区间包含两端，1%–3% 只保留该范围，其余完全隐藏。默认全部，可一键恢复；P0 的正信号可用 0%–0% 单独选择，零信号不填色，模型原分和参考 CDF 均不变。

保留共同 5 km 是为了保持“本地”的观察含义，而不是把地图填满。更大的半径会把远处门店贡献带入当前位置；因此较大范围的结果另设为**区域辐射背景**：默认麦当劳 40 km、H3 res6，其余品牌按成本等面积缩放，仍允许 1–60 km 基准半径调整与十级多选过滤。切换视角不会把两个模型合成同一分数，区域参数也不改变本地 5 km。

两个范围口径在网页上同时说明：本地正值格的大陆土地足迹为 8.3747%，县级参考点有信号比例为 98.17%；前者不是人口覆盖，后者不代表整个县域。空白统一解释为“5 km 内无三品牌近邻信号”，不把缺少这些门店解释为经济活动为零。

### 连续指标与有限颜色

原始分数和百分位不强制分级。颜色按 `log1p(分数)` 连续映射，显示上限取**成本参照分布 P99**；超过上限时只让颜色饱和，详情仍显示真实分数及百分位，不截断结果。为减轻静态地图负载，将填色量化为 64 个色阶；只合并 `colorBin`、`floor(P)`、`ceil(P)` 均相同的相邻 H3 面，保证整数闭区间筛选不夹带区间外的同色格。这只是渲染近似，不是新造的 64 个经济等级，也不改变分析单元、计算值或参照分布。

### 静态发布与复现

约 129 万个正值 res8 格的填色几何离线导出为静态 MVT，由浏览器按视口请求，避免全量解析全国格子。瓦片最大级别为 9、extent 为 8192，近景继续使用父级矢量瓦片显示；点选与悬停按所选 res8 格中心计算原始值，不从瓦片色阶反推分数。默认不显示 H3 边线，只在选中时描出相应格子的边界。新增 gzip 元数据 `economic-store-percentiles.json.bin` 保存研究结果中的权威门店格百分位，门店点位与其所属格的点选详情共用该值，避免筛选阈值不一致。

在已有成本研究结果、面积审计和区域分析边界的基础上运行：

```sh
npm ci
uv run scripts/export_economic_web.py
```

该导出不重做前期研究。它读取 `economic-activity-grid.npz`、`economic-activity-points.json`、`coverage-footprint.json` 等已有研究归档，发布成本摘要、边境裁剪几何和 `economic-tiles/{z}/{x}/{y}.pbf`。没有新增生产依赖：离线 Node.js 瓦片器复用 MapLibre 锁定依赖中的 `@maplibre/geojson-vt` 与 `vt-pbf`，无需运行时服务器或数据库。网页可下载的独立口径说明随静态资源发布。