可交互的宋代沿河街市画卷。沿河行走、饮茶、乘船，在夜景与时雨中游览街市，或参与虹桥过船并留下画稿。

在线体验 · Vercel · Cloudflare · 作者 X

无需安装或登录，支持电脑与手机浏览器。插画为生成与编辑后的再创作，不是《清明上河图》原画扫描。

沿河灯火	城门货市

需要 Python 3；开发、测试和构建使用 Node.js 22 或更新版本。

python3 scripts/preview.py

macOS 也可双击 打开清明上河.command。不要直接以 file:// 打开 HTML：浏览器会限制模块与画布资源读取。

npm ci
npm test
npm run build
npm run check

• npm test：运行全部测试，当前数量以执行结果为准。
• npm run build：生成 dist/，验证页面、模块、样式和素材引用。
• npm run check：构建并校验 Cloudflare 配置，不发布。
• npm run dev：构建后启动 Wrangler 本地服务；修改源文件后需重新构建。

index.html / sunyang.html  页面入口
src/                      前端逻辑
styles/                   样式
assets/                   网站使用的图片、音频、字体
art-source/               原稿与历史候选，不进入网站发布包
tests/                    自动化测试
scripts/                  构建、预览、资源白名单和检查工具
docs/                     操作、实现、验证与制作记录
vendor/                   本地第三方库及其许可证
migrations/               Cloudflare D1 数据库迁移
worker.js                 访问计数 API

新增运行时素材时，同步更新 scripts/public-assets.json 和 素材清单。X 长文与宣传图保存在项目之外，不纳入仓库。

三种部署均以 dist/ 为网站内容。不要直接发布仓库根目录，避免把原稿和开发文档一并发布。

• GitHub Pages：仓库 Settings → Pages → Source 设为 GitHub Actions。工作流对 PR 执行测试与构建，master 分支检查通过后发布 dist/。这是从原来的分支根目录发布方式迁移所需的一次性设置。
• Vercel：vercel.json 已配置构建命令与 dist/ 输出目录；访问计数转发到 Cloudflare。
• Cloudflare：npm run deploy。首次部署到自己的账号，需要在 wrangler.jsonc 配置自己的 D1 数据库，并执行迁移。仓库中的数据库标识不是访问密钥，也不能替代账号授权。

验证发布包可运行 python3 -m http.server 8765 --directory dist，然后打开本机地址。

• 操作说明 · 实现说明 · 项目缘起
• 更新与历史验证记录 · 发布检查
• 素材清单与待确认授权 · 插画制作记录

本项目目前公开供展示和查阅，未额外授予代码与项目素材的复用或商业使用许可。第三方库与字体遵循各自许可证，详见 LICENSE。复用与商业合作请通过 X 联系维护者。

中秋街道暂时关闭，代码和素材继续保留；恢复方法见 季节场景说明。