A股资金雷达 · Cloudflare Pages 数据接入版 v2.0

一、如何上传
1. Cloudflare 控制台 → Workers & Pages → 打开原 Pages 项目。
2. 创建新的部署，选择生产环境（Production），上传本 ZIP。
3. 必须上传新版全部文件：index.html、app.js、style.css、_worker.js、_routes.json 等都在 ZIP 根目录。
4. 部署完成后访问“生产域名”，不要继续使用旧部署的预览地址。
5. 打开 https://你的域名/api/health，应看到 ok:true 和 version:2.0.0。
6. 打开 https://你的域名/api/latest，应看到 schema_version:2 及 index/margin/etf。
7. 刷新首页。旧版安装到主屏幕的页面请关闭后重新打开；必要时强制刷新一次。

本包使用 Pages advanced mode 的 _worker.js。Cloudflare 官方支持通过控制台拖拽上传此文件，不需要安装 Python、Node 服务，也不需要配置 API Key、KV、D1 或额外服务器。不要把 _worker.js 改名，也不要只上传 index.html。
官方说明：https://developers.cloudflare.com/pages/get-started/direct-upload/#functions

二、本版实际提供什么
- 上证指数：东方财富/腾讯证券双源，采用先成功且校验通过的已收盘日线，显示具体来源和日期，不当作实时行情。
- 沪深融资余额：取同一交易日 H_RZYE + S_RZYE，仅融资，不含融券、不含北交所；优先显示最近完整日期。
- 单日与20交易日变化：以指数日线给出的对应交易日作为基线；缺基线时不计算，不用更早的记录冒充。
- 宽基ETF样本净申购估算：固定8只沪市上市宽基ETF，使用上交所日度份额及天天基金同日单位净值。
- 每个数据源的错误状态、数据日期、样本明细、覆盖率与口径限制。

ETF样本：510300、510310、510330、510050、510500、510580、512100、588000。
估算公式：Σ[(当日份额 − 上一交易日份额) × 当日单位净值] / 100000000，单位亿元。
上交所 TOT_VOL 单位为“万份”，计算前乘10000；这与净值元/份匹配。
不将成交金额、“主力净流入”、基金市值变化冒充净申购。
任一只样本不完整，整篮子估算暂停显示；明细仍显示各自原因。
异常份额变化、净值与涨跌幅不一致及分红/折算标记会被剔除。未完成全部公司行为核验，结果始终标为估算。

三、仍不能声称具备的内容
- 不是“全市场宽基ETF净申购”；样本覆盖率不是全市场资产覆盖率。
- 原包未提供评分模型、权重或阈值，因此综合评分是“未配置”，不会凭空造分。
- 没有新增政策新闻采集、国家队识别、买卖信号或自动交易功能。
- 公开数据接口无可用性承诺，可能限流、变更或限制云节点访问；不能保证 Cloudflare 每个节点均可访问。
- 商用/公开分发前需核对上游数据授权和使用条款；本包不提供数据转授权。

四、自动更新与缓存
页面打开后每5分钟检查一次；后端按访问触发采集，边缘缓存15分钟。
没有访问时不主动采集（不是定时Cron）。无人访问也要持续留存历史，需要另外部署调度和存储，不是本 ZIP 默认功能。
首次访问没有缓存，会等待采集。过期缓存会先返回且明确标为“后台正在更新”，同时刷新，页面约45秒后再检查。
缓存按 Cloudflare 节点保存，可能被提前淘汰；不是可靠数据库。失败时尽量保留上次成功值，标记 stale 和原日期。
失败响应也短时缓存，避免页面刷新不停打上游。刷新按钮不会绕过15分钟缓存。
若当天仅有沪市融资，显示上次沪深都完整的日期，而不是把深市缺失当0。周末自然沿用最近交易日。
北京时间15:15前不把当日日线当成收盘价。指数超过4个自然日会提示核验；长假需另行核对交易日历。

五、排错
/api/health 返回 HTML 或404：_worker.js没有运行，检查完整上传、新生产部署、部署日志。
/api/health 正常、/api/latest 有 error：查看 index.error、margin.error、etf.error，属于上游不可用/字段变化，不是前端缓存。
数据有日期但不是今天：可能为休市、收盘前、上游尚未发布或某市场未补齐，查看来源与状态。
ETF部分基金缺失：查看样本行；不得手工填0、把旧日期值改成今天。
平台额度用尽：查看 Workers & Pages 用量；API属于动态函数请求，受账户计划额度限制。
本版API仅允许GET/HEAD，只代理固定的数据源，没有任意URL代理、上传、密钥或交易操作。

六、数据来源
东方财富上证指数：https://quote.eastmoney.com/zs000001.html
腾讯证券上证指数：https://gu.qq.com/sh000001/zs
东方财富两融汇总：https://data.eastmoney.com/rzrq/
上交所ETF规模：https://www.sse.com.cn/assortment/fund/etf/list/scale/
天天基金历史净值：https://fundf10.eastmoney.com/

非实时行情，仅作研究数据展示；不构成投资建议。