Files
jinzuanwork/给协作者的说明.md
Suda 82cbd2ff36 fix: 资源改用相对路径,页面在任意目录/本地都能正常打开
- 门户/下单页的 assets/tokens.css 由 /assets/... 改为相对路径
  (绝对路径只在部署在域名根目录时成立,本地打开或挂在子目录下样式会整个丢)
- 门户的 view_stats.json / hit 上报同改相对路径
- 下单页补一份 order/assets/tokens.css,两个子目录各自自足
- 说明文档新增「怎么在本地打开」一节(静态服务器 + 下单单开是半残属正常 + 反复重载要找 Console)
2026-10-05 11:25:16 +08:00

5.6 KiB
Raw Permalink Blame History

给协作者 AI 的说明

这是什么

两个页面的前端,想请你从前端美化角度改一版。都是单文件 HTML (HTML + CSS + JS 内联,无构建工具、无框架依赖,浏览器直接打开就能看):

  • portal/index.html —— 门户首页(另有 fonts/ 自托管字体、icons/ 图标)
  • order/index.html —— 自助下单页

画展部分的原始作品、客户/创作者昵称与外链都已从交付副本移除; 只保留 portal/exhibition/渲染与动画/20240229/没有图片.webp 这一张占位图, 用于让你看画廊卡片的排版结构。

另附《设计思路(仅供参考).md》:它只解释原页面的出发点,不是约束; 你可以完全采用自己的方案。

⚠️ 先看这条:怎么在本地打开(不然会踩坑)

这两个页面是单文件 HTML(CSS / JS 都内联在里面),但页面里的资源引用是相对路径 (assets/tokens.css、fonts/*.woff2、icons/* 这些)。所以:

  • 别直接双击打开 html(file:// 下字体、图、styles 都可能读不到,页面看着像坏了);
  • 别把它挂到别的子目录下、再按"从根目录开始"的路径去访问。
  • 最省事:在包的根目录起一个静态服务器,再按下面两个地址开:
python3 -m http.server 8000
# 门户 → http://localhost:8000/portal/index.html
# 下单 → http://localhost:8000/order/index.html
  • 门户页本地能完整看:版面、动效、配色都出得来。
  • 下单页要有后端数据才是完整的。本地单开时会停在"没连上"的状态 —— 这是正常的,不是坏了; 你要调的是样式,把状态条 / 卡片 / 按钮 / 弹窗的样子改好就行。
  • 本地打开时,页面里所有 fetch(...) / sendBeacon(...) 都会失败,控制台可能有红字,属正常。 只有一种情况要报我:页面自己反复刷新 / 反复重载。这批前端里没有写任何"自动重载"的代码, 如果真出现,八成是打开方式或开发工具(比如编辑器的 Live Server 自动刷新)造成的 —— 把浏览器 Console 的报错截图发过来,一看就知道。

你可以改:样式(完全自由发挥)

布局、配色、字体、间距、圆角、阴影、动效、交互手感——不用问想要什么风格, 按你自己的判断来。唯一要求:改完功能照样能用。

请在「关于」里加一笔

门户页里有一块**「制作者 / 鸣谢」**(在代码里搜 ab-kicker 或「制作者」能找到)。 现在署名只有一个人 —— 改完之后请补成:

苏达 · 空枝

⚠️ 别动:JS 逻辑与接口调用

只改样式,不要改 JS 逻辑和接口调用 —— 逻辑一动整站就废了。 下面这些是页面在用的接口(都是相对路径,代码里会拼一个基址在前面):

下单页 order/index.html

接口 干什么
/submit 提交订单
/status 渲染机状态
/tick/<单号> 轻量心跳(轮询进度)
/order/<单号> 订单详情
/code/<卡密> 查卡密
/dl/<单号>/<序号> 下载成品
/receipt/<单号> 小票文字
/accept 确认收货
/redo 免费重渲
/add-skin 加皮肤
/call 呼叫站长
/feedback 反馈
/zip/<单号> 打包下载
/gift 福利券
/gift/claim 领券
/my-coupons 我的券
/payinfo 付款信息
/paid 付款回执

门户 portal/index.html

接口 干什么
view_stats.json 页面访问计数(静态文件)
hd_cache/manifest.json 素材清单(静态文件)

推送位置(改完后由你推送)

本次允许推送的唯一远端是:

https://git.lingll.icu/public/jinzuanwork.git

请将这份脱敏后的交付目录和你的改动推送到这里;不要把原始线上目录、备份、个人素材、 账号信息、密钥或其它本机文件混进去,也不要镜像到其它远端。

推送后,在 交接说明.md 里写明:仓库地址、分支名、提交哈希,以及 git status 是否干净。

改完要交回的内容(请一并写在交接说明里)

不要只丢一份代码。请随改动附一份 交接说明.md,至少写清:

  1. 改了哪些文件:逐个列相对路径;没有改的明确说没改。
  2. 做了什么:按页面分项说清楚视觉/交互上分别改了什么,以及为什么这么改。
  3. 没有动什么:明确写「没有改 JS 业务逻辑、没有改接口路径/请求参数」; 如果确实不得不动了,必须逐项说明原因、改前改后是什么。
  4. 怎么验证的:列出实际打开/点击过的页面和结果;不能实际验证的如实标「未验证」,不要猜测说已通过。
  5. 待确认/风险:不确定的地方、需要原项目方补资源或补接口的地方,单列出来。
  6. 交付方式:保留原目录结构;不要带入 .git/、备份、调试截图、构建缓存、账号信息或任何新密钥。

回报写短也没关系,但必须让接手的人一眼知道:改了什么、有没有动逻辑、实测到哪一步、还卡着什么。

其它注意

  • 页面里的 example.com、123456789、备案号(已移除)、(本机路径) 是脱敏后的占位值,请保持原样,不要换成真实地址。
  • 这两份是脱敏后的协作副本;只允许推送到上面指定的仓库,不要外传、镜像或发布到其它位置。
  • 有看不懂的地方,先问再改,别猜。