xtc-backend / Dockerfile
a3216's picture
sync from GitHub c486f76: fix(chat): 带附件时附件正文只发一遍 + 修 CESU-8 导致的整段乱码与附件丢失
e09ed53 verified
Raw History Blame Contribute Delete
3.05 kB
FROM python:3.11-slim
WORKDIR /app
# 系统依赖:
# - libheif:用于 HEIC/HEIF 解码(图片修正增强)
# - ffmpeg:听歌识曲 AMR→PCM 转码
# - nodejs + npm:公式渲染侧车(MathJax + resvg)、以及 afp.wasm 指纹脚本
# - fonts-noto-cjk:公式里 \text{中文} 需要的字形。
# MathJax 的 SVG 输出把数学字形全部转成 <path>,不依赖字体;
# 只有 CJK 文本(中文/全角)才需要真实字体文件,所以装一个就够。
RUN apt-get update && apt-get install -y --no-install-recommends \
libheif1 libheif-dev \
ffmpeg \
nodejs npm \
fonts-noto-cjk \
&& rm -rf /var/lib/apt/lists/*
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt \
&& pip install --no-cache-dir pillow-heif
# 公式渲染侧车依赖(mathjax-full + @resvg/resvg-js)。
# 单独一层:只改 Python 代码不会触发 npm 重装。
# 注意:仓库里的 formula-mj/node_modules 被 .dockerignore 排除,
# 所以下面 `COPY . .` 不会覆盖掉这一层装好的依赖。
COPY formula-mj/package*.json /app/formula-mj/
RUN cd /app/formula-mj && npm install --omit=dev --no-audit --no-fund
COPY . .
# 构建期自检:侧车必须能把「用户报过的 13 条公式 + 化学式 \ce{} + aligned 环境 + 中文
# \text{}」全部渲染出来,且单张 PNG 不超过端上 50KB 上限。
# 断言失败直接让镜像构建失败,避免部署出一个「公式静默不渲染」的后端。
RUN node /app/formula-mj/selftest.js > /tmp/tex-selftest.log 2>&1 \
|| (cat /tmp/tex-selftest.log && exit 1)
# 构建期自检:生图链路的纯逻辑(optimize_prompt 布尔解析、附件不顶替用户提示词、
# 优化上下文构造、伪流式 TTL 必须大于端上轮询窗口)。同样是「静默失效」类问题,
# 卡在构建期比让用户猜「优化到底有没有生效」便宜得多。
RUN python /app/_imagegen_selftest.py > /tmp/imagegen-selftest.log 2>&1 \
|| (cat /tmp/imagegen-selftest.log && exit 1)
# 构建期自检:带附件的聊天链路(multipart 解析 / 小天才 CESU-8 乱码还原 /
# 同一份附件正文只发一遍 / file_names 不能当附件正文)。这三个都是「不报错但
# 内容错」的问题——重复发两遍、其中一遍是乱码、含 emoji 的附件正文直接丢失,
# 在构建期断言比等用户发现 token 翻倍便宜得多。
RUN python /app/_chat_attach_selftest.py > /tmp/chat-attach-selftest.log 2>&1 \
|| (cat /tmp/chat-attach-selftest.log && exit 1)
ENV PORT=7860
ENV PYTHONUNBUFFERED=1
ENV XTC_DB_PATH=/data/xtc.db
# 公式侧车:中文字体(fonts-noto-cjk 装的路径)+ 并发 worker 数
ENV XTC_TEX_CJK_FONT=/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc
ENV XTC_TEX_WORKERS=2
EXPOSE 7860
# 持久化目录(HF Spaces 自动挂载 /data;本地 docker run 时可 -v 挂载)
RUN mkdir -p /data
VOLUME ["/data"]
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "1"]