Archived
snowy-yang
da3d013e9c
模板/样式/脚本的注释里散落着「第 N 条」「F59」「P3-43」这类编号，它们指向的 修复验收台账与交接文档已在本轮删除——留着既检索不到、也对不上号，还让后来读 注释的人以为存在一份可查的编号清单。本次只动注释，正文零改动。 覆盖范围（全仓一致）： - templates/index.html 163 处、static/site_auth.js 55 处，共 218 处编号整段摘除 （含「第 N 条（Px）：」前缀与「（Fxx 短标签）」括号）。 - 容器/配置 16 处：docker-compose.yml、entrypoint.sh（F59 / 第 93 条 / 第 97 条）、 Dockerfile（T7 / 第 97 条）、.dockerignore（T1 / 第 97 条 / 第 55 条 / P2-9）、 .env.example（F59 / 第 100 条 / 「详见交接文档 F11」这条失效指引）、.gitignore（P3-41）。 - Python 4 处：core/config.py（D-1）、services/tasks.py（O-5×2）、services/_shared.py（O-5） ——上一轮 Python 侧清理的漏网。 为什么规则要收窄（两类误伤，实测踩到）： 1. 标签首字母不能用泛化的 [A-Z]：X5 是 QQ 浏览器内核、ES5 是 JS 版本，都不是编号。 泛化后会把「微信 XWeb/X5、QQ 内置」改成「微信 XWeb/、QQ 内置」，把 「Chromium <87 的老 X5 不识别 inset」改成「老 不识别」。现按本仓真实用过的 任务族白名单收窄（A B C D F O P R S T U），X5/ES5 原样保留。 2. 括号内「编号 + 长说明」不能整段删：「（F51 只防了切歌，这里补同歌翻页）」 整段删掉会连说明一起丢；现只摘编号、保留说明文字。 为什么同步改黄金契约快照：题头注释属于模板内容，改了注释首页字节数必然变 （466261 → 464333），tests/golden/responses.json 的 index 条目按既定流程刷新 html_len/html_sha256；并在 tests/test_golden.py 补一段说明，写清该条目记的是 「当前模板」而非 Flask 期数值、以及有意改模板后如何重算 （html_len = 文件字节数 - 1，sha256 = 文件去掉末尾换行后的哈希）。 验证（全部通过）： - 与 HEAD 比对：剥离全部注释后的正文逐行一致（唯一差异是删掉了一处行尾空注释）， 行数不变、每行半角括号/引号数量不变 → 代码与字符串零改动； - node --check 通过（静态 JS + index.html 内联脚本），<style> 块花括号平衡； - 真实 uvicorn 冒烟：/health /user/status /api/topen → 200、/admin/site/backup/list → 403， /static/site_auth.js 响应体与本地文件 sha1 相同，/ 无「第 N 条」残留； - ruff All checks passed；pyright 0 errors / 0 warnings；pytest 144 passed。
26 lines
1.3 KiB
Docker
26 lines
1.3 KiB
Docker
# 基础镜像 Python 3.12（3.9 已于 2025-10 EOL）；alpine + ffmpeg 组合保持不变
|
||
FROM python:3.12-alpine3.21
|
||
WORKDIR /app
|
||
# 使用阿里云 apk 镜像源加速安装 ffmpeg
|
||
# 补 tzdata——alpine 无 zoneinfo，ENV TZ=Asia/Shanghai 不装它不生效
|
||
# （容器内日志/展示本地时间差 8 小时；计费/会话全部 epoch 秒不受影响）
|
||
RUN sed -i 's|dl-cdn.alpinelinux.org|mirrors.aliyun.com|g' /etc/apk/repositories && \
|
||
apk add --no-cache tzdata ffmpeg
|
||
# 依赖由 uv 从 uv.lock 精确安装（可复现构建）；uv 二进制仅存在于构建阶段
|
||
COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
|
||
ENV UV_PROJECT_ENVIRONMENT=/usr/local UV_COMPILE_BYTECODE=1 UV_LINK_MODE=copy
|
||
COPY pyproject.toml uv.lock ./
|
||
RUN uv sync --frozen --no-dev
|
||
COPY . .
|
||
RUN chmod +x /app/entrypoint.sh
|
||
# 非 root 运行（容器安全基线）。注：挂载卷 ./downloads ./data 的宿主机目录
|
||
# 需对 UID 10001 可写（见 docker-compose.yml 注释），否则下载与数据库写入会失败
|
||
RUN adduser -D -u 10001 appuser && chown -R appuser:appuser /app
|
||
USER appuser
|
||
ENV TZ=Asia/Shanghai
|
||
EXPOSE 5000
|
||
# 容器健康检查（/health 为轻量本地端点，不触发上游请求）
|
||
HEALTHCHECK --interval=60s --timeout=5s --start-period=20s --retries=3 \
|
||
CMD wget -qO- http://127.0.0.1:5000/health || exit 1
|
||
CMD ["/app/entrypoint.sh"]
|