海风(kele551)四款 Windows 单文件工具的统一门面页,线上地址:
https://kele551-apps.pages.dev/
本仓库是私有的,只当「发布管道」用;公开的是上面那个网站。仓库不出现在主页列表里,别人打开是 404。
改 index.html → git push main → GitHub Actions → Cloudflare Pages(Direct Upload)→ 线上更新
- 工作流:
.github/workflows/deploy.yml - 发布脚本:
tools/deploy_pages.py(纯 REST,不需要 node / wrangler) - 密钥:仓库 Secret
CLOUDFLARE_API_TOKEN(权限 Account → Cloudflare Pages → Edit) - 只有
index.html/og-cover.png/tools/deploy_pages.py/ 工作流变动才触发; 改 README 或generator/里的源码不触发部署。 - 发布末尾会回读生产地址比对 sha256,不一致就让这次 Actions 红掉(部署成功不等于能打开)。
页面本体由本地脚本生成(四款 app 的图标、界面截图、数字快照都内联进 index.html)。
生成器源码已随仓库备份在 generator/(含 shots\ 截图与 icons\ 图标副本,
路径可配置、能独立运行);但日常活版本仍是 E:\Qdoer\落地页-样稿\build_page.py,
只改 generator/ 不会自动上线,两边要保持同步。改法:
- 在本地
E:\Qdoer\落地页-样稿\build_page.py里改文案 / 链接 / 卡片顺序; - 跑
python build_page.py。它会:问徽章后端取这次的下载 / 浏览数(取不到时换 shields.io 缓存键再取一次, 仍失败用SNAPSHOT兜底); 从 GitHub API 读每款最新 tag 与 exe 资产名,自动解析下载直链(见下一节); 探 hiwiki 镜像是否真上线,只挂上线的;最后产出index.html与 1200x630 的og-cover.png; - 把
index.html和og-cover.png一起覆盖到本仓库,git commit && git push; - Actions 跑完,线上就变了(约 1 分钟)。
shots\ 里是四款真实界面截图:狐径 / 桌面壁纸 / 热点新闻从各自仓库 docs/demo/*.mp4 抽帧,
LIVE直播源用仓库自带的 docs/screenshot.png。生成器把它们内联成 webp data URI,
所以 index.html 仍是单文件;og-cover.png 是唯一额外上传的资产,由发布脚本自动带上。
generator/ 的代码产物默认写在它自己的目录,不会覆盖根目录发布文件;
路径可用 PAGE_OUT_DIR / PAGE_REPO_ROOT 等环境变量覆盖,详见 generator/README.md。
主按钮不再指向发行版列表页,而是指到 exe 本身,省掉「选版本 → 点附件」两步。
生成器优先拼 gitcode.com/<owner>/<repo>/releases/download/<tag>/<资产名>,
探不通再回退 GitHub releases/latest/download/<资产名>(并在按钮下如实标注)。
两个实测出来的坑(2026-11-10):
- GitCode
latest/download/...返回的是 HTML 不是文件,必须带 tag; - 探测只能用
curl --range 0-0这种 1 字节 GET,成功码206+application/octet-stream才算真附件。HEAD 会被 GitCode 回 401, 完整 GET 又会白下 8–15 MB。--offline时不联网,用DL_STATIC里已实测的链接。
Cloudflare Pages 的资产键不是文件字节的 blake3,而是:
blake3( base64(文件内容) + 扩展名(不带点) ).hex()[:32]
(wrangler 的 hashFile)传错不会报错:上传成功、哈希登记成功、部署状态 success,
但线上每个资源都取不到(500)。细节见 tools/deploy_pages.py 顶部注释。
- 数据口径:下载 = GitHub Releases 附件数 + GitCode 下载统计;浏览 = 各平台 hits.sh 计数合计;
由 Cloudflare Worker
kele551-badge算,页面经img.shields.io中转取(*.workers.dev在境内被污染)。 - 本地工作副本与档案:
F:\Harness\projects\作品页\(README / logs / snapshots)。