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 输出把数学字形全部转成 ,不依赖字体; # 只有 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"]