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

121 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 给协作者 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 都可能读不到,页面看着像坏了);
- **别把它挂到别的子目录下、再按"从根目录开始"的路径去访问**。
- 最省事:**在包的根目录起一个静态服务器**,再按下面两个地址开:
```bash
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` | 素材清单(静态文件) |
## 推送位置(改完后由你推送)
本次允许推送的唯一远端是:
```text
https://git.lingll.icu/public/jinzuanwork.git
```
请将**这份脱敏后的交付目录**和你的改动推送到这里;不要把原始线上目录、备份、个人素材、
账号信息、密钥或其它本机文件混进去,也不要镜像到其它远端。
推送后,在 `交接说明.md` 里写明:仓库地址、分支名、提交哈希,以及 `git status` 是否干净。
## 改完要交回的内容(请一并写在交接说明里)
不要只丢一份代码。请随改动附一份 `交接说明.md`,至少写清:
1. **改了哪些文件**:逐个列相对路径;没有改的明确说没改。
2. **做了什么**:按页面分项说清楚视觉/交互上分别改了什么,以及为什么这么改。
3. **没有动什么**:明确写「没有改 JS 业务逻辑、没有改接口路径/请求参数」;
如果确实不得不动了,必须逐项说明原因、改前改后是什么。
4. **怎么验证的**:列出实际打开/点击过的页面和结果;不能实际验证的如实标「未验证」,不要猜测说已通过。
5. **待确认/风险**:不确定的地方、需要原项目方补资源或补接口的地方,单列出来。
6. **交付方式**:保留原目录结构;不要带入 `.git/`、备份、调试截图、构建缓存、账号信息或任何新密钥。
回报写短也没关系,但必须让接手的人一眼知道:**改了什么、有没有动逻辑、实测到哪一步、还卡着什么。**
## 其它注意
- 页面里的 `example.com`、`123456789`、`备案号(已移除)`、`(本机路径)`
是**脱敏后的占位值**,请**保持原样**,不要换成真实地址。
- 这两份是脱敏后的协作副本;**只允许推送到上面指定的仓库**,不要外传、镜像或发布到其它位置。
- 有看不懂的地方,先问再改,别猜。