Presenton 0.9.12-beta · 本机部署说明（远影归灯实测 2026-11-17，CPU 机器）
================================================================================
路线：本机 Ollama（qwen2.5:3b）写中文大纲和幻灯片，关掉配图，导出可编辑 PPTX。
全程不需要任何云端 API Key。

一、准备
  1. Docker（本篇用官方镜像 presenton:v0.9.12-beta）。仓库里也可以用 docker-compose 从源码构建；
     本篇从源码构建时，安装 Chromium 那一步失败，改用同一版本的官方镜像。不要用未钉版本的 latest。
  2. 本机已安装 Ollama，并拉取模型：ollama pull qwen2.5:3b（约 1.9 GB）
     验证：curl http://127.0.0.1:11434/api/tags
     不要在容器里再启动一份 Ollama（START_OLLAMA 保持 false）。
  3. 建议准备 JDK / Node 不是必须，走镜像即可。

二、配置（建议复制为 .env，不要把口令写进截图或发给别人）
  LLM=ollama
  OLLAMA_URL=http://host.docker.internal:11434
  OLLAMA_MODEL=qwen2.5:3b
  DISABLE_IMAGE_GENERATION=true
  MEM0_ENABLED=false
  DISABLE_ANONYMOUS_TRACKING=true
  PRESENTON_COMMUNITY_ENABLED=false
  PRESENTON_PUBLIC_URL=http://127.0.0.1:5001
  START_OLLAMA=false

  Ollama 地址注意：
  - 用 Docker 端口映射时，容器里不要写 localhost（会指到容器自己），应写
    http://host.docker.internal:11434，并加 --add-host host.docker.internal:host-gateway。
    请确认 host.docker.internal 确实指向本机，不要指向过滤代理，否则对话接口会返回 500。
  - 如果改成 host 网络，把 OLLAMA_URL 写成 http://127.0.0.1:11434。

三、启动（推荐端口映射，只绑本机）
  docker run --name presenton \
    -p 127.0.0.1:5001:80 \
    --add-host host.docker.internal:host-gateway \
    --env-file .env \
    -v "$PWD/app_data:/app_data" \
    presenton:v0.9.12-beta

  入口：http://127.0.0.1:5001
  首次打开会注册本地账号，第一个账号就是管理员。可用 AUTH_USERNAME / AUTH_PASSWORD 预置，
  但不要把口令写进文章或截图。登录页若有预填，先清空再截图。

  若 Docker 网桥不通、必须用 host 网络：不要去抢本机 80 端口。把镜像内 Nginx 的监听改成
  127.0.0.1:5001，网页走 http://127.0.0.1:5001。注意：导出 PPTX 时，内部工具仍可能访问
  http://127.0.0.1/pdf-maker（80 端口）。本篇在 host 网络下遇到过连接被拒绝；把本机
  127.0.0.1:80 临时转到 5001 之后，导出在约 9 秒内完成。所以能用端口映射时，优先不要改 host 网络。

四、出一份中文 PPT
  1. 打开设置，文本提供商选 Ollama，模型选 qwen2.5:3b，点 Check models，应提示 Connected to Ollama。
  2. 回到创建页，模式选 Standard，页数选 4～5，语言选简体中文。
  3. 模板优先选偏文字排版的，例如 Executive。不要选带人物照片的预览（如 Dynamic、Standard、Signal）。
  4. 输入一句自己的中文主题，生成大纲，再继续生成幻灯片。
  5. 编辑器里能看到中文页面后，点 Export → PPTX，用 LibreOffice 或其他软件打开检查。

五、实测数据（8 核 CPU、无显卡，qwen2.5:3b）
  - 主题：如何在本机用 Ollama 做课设答辩 PPT
  - 模板：Executive，5 页，简体中文，Standard 模式，已关闭配图
  - 大纲生成约 44 秒
  - 从点 Continue 到编辑器里 Export 按钮可用：约 236 秒（约 4 分钟）
  - 从点生成到 5 页幻灯片完成：约 4 分钟
  - 导出 PPTX：约 9 秒（在导出接口可达的前提下）
  - 用 python-pptx 读取 5 页文本，并用 LibreOffice 转成 PDF/PNG 核对：第 2～5 页中文可见；
    第 1 页出现了英文占位和乱码式内容。3B 小模型处理复杂版式不稳定，生成后务必自己改。

六、支持但本篇未实测
  配图（Pexels / Pixabay / 生图）、Mem0 记忆、在线社区模板、联网检索、上传文档转 PPT、
  ChatGPT / Cloud 登录、Electron 桌面版、MCP、多用户工作区、企业版 SSO / Helm。
  这些不要理解成这份开源包里已经配好就能用的能力。

七、踩坑
  - 必须用本机已有的 Ollama，不要在容器里 START_OLLAMA=true。
  - 容器访问 Ollama 的地址不能写错，见第二节。
  - 设置页的 Check models 有时会把地址改回 host.docker.internal，保存前再看一眼。
  - 3B 小模型可能吐出表情符号或非法字符，流式生成会中断；提示词里写「不要使用表情符号」，失败就换文字型模板或重试。
  - 第一次启动会有几秒开屏动画，页面要等表单出来再操作。

八、字体与模板图片
  - 前端打包字体主要是 Inter、Lato、Noto、Merriweather、Montserrat、Open Sans 等开源字体。
    请保留 fonts 目录里的 OFL / License 文件（本包约 95 份）。
  - 已处理的模板图片（换成纯文字占位图，避免来源不明的摄影和人物出镜）：
    templates/dynamic/static/thumbnail.png
    templates/dynamic/static/image1-8f0be57474f1.jpeg
    templates/dynamic/static/image6-67ec4cfdc5cc.jpeg
    templates/dynamic/static/image4-677532a3decf.jpeg
    templates/editorial/static/thumbnail.png（原为火灾照片）
    templates/general/static/thumbnail.png（办公室人物）
    templates/standard/static/thumbnail.png（办公桌前人物）
    templates/standard/static/image8-1bc3f07c9b32.png（人物背影）
    templates/signal/static/thumbnail.png（使用笔记本的人物）
  - 未替换、需要知情的摄影类素材：horizon / landmark 模板缩略图含建筑照片，
    modern 模板缩略图含公路风景。正文配图没有使用它们。

九、合规
  仅供学习。如果把 AI 生成的幻灯片拿去答辩或公开发布，内容要自己核对，不要直接当原创课件。
  协议是 Apache-2.0，请保留 LICENSE 和 NOTICE。

十、打包说明
  - 源码钉在 0.9.12-beta（与 package.json 一致），不是后续仍写同一版本号的最新提交。
  - 已保留：LICENSE、NOTICE、fonts 下的开源字体许可。
  - 已排除：官方宣传素材（readme_assets、Standard.mp4、loading.gif）、app_data（含账号哈希和生成文件）、
    node_modules、.git、运行日志、密钥、以及约 90 MB 的 fastembed 嵌入模型缓存。
    若你从源码启动并启用相关功能，首次可能会自动下载该缓存。
  - 不要把 app_data 和 .env 里的口令打进压缩包。端口只绑 127.0.0.1。
