Presentia 文档

Presentia 主要通过仪表盘使用：从提示词、文档、数据集或 markdown 创建幻灯片；在编辑器中微调（带 AI 助手）；导出为 PPTX 或 PDF。本页涵盖这个 fork 自有的功能和 API；日常编辑器的工作方式与其上游一致，符合你的预期。

Markdown 转幻灯片（Gamma 模式）

Markdown 页面提供完整的编辑器——工具栏、精确展示文本如何拆分为卡片的实时预览、卡片计数器、拖放——外加模板、语言、图片来源／风格与导出选择器。每个由 --- 或 #/## 标题分隔的区段都变成一张卡片。

`text_mode`	发生什么
`preserve`	你的文本逐字进入幻灯片——AI 只负责挑选版式和生成图片。
`condense`	AI 概括每张卡片，同时保留其结构。
`generate`	AI 重写并扩展每张卡片。

同样的能力也通过 API 提供：

curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate-from-markdown \
  -H "Content-Type: application/json" \
  -d '{
        "markdown": "# Q3 Review\nIntro...\n\n---\n\n## Results\n- Revenue up 20%",
        "text_mode": "preserve",
        "template": "general",
        "export_as": "pptx"
      }'

从真实数据生成图表

POST /api/v1/ppt/presentation/generate-from-data 从 CSV、TSV 或 JSON 数据集构建幻灯片（multipart：file，外加 content、n_slides、language、template、 instructions、export_as）。反幻觉防护会根据数据集检查每一个图表数字—— 只允许精确值或精确的列聚合值（求和、平均、最小、最大、计数）。数字有误时给一次带反馈的重试，若模型执迷不悟则予以拒绝。

curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate-from-data \
  -F "file=@monthly_summary.csv" \
  -F "content=Monthly reconciliation report" \
  -F "n_slides=6" -F "language=English" -F "export_as=pdf"

数据集应当是预先聚合过的；行数上限是 DATASET_MAX_ROWS（默认 200）。默认模板是 Report，它携带图表版式。

成本与模型

两个上游没有的仪表盘页面：

模型——文本与图像模型的目录，带精选质量圆点、每百万 token 的综合价格、根据你的密钥计算的可用性以及推荐徽章。点击卡片即可切换；有了 OpenRouter 密钥，几乎所有模型都会立刻点亮。
成本——汇总卡片（调用次数、输入／输出 token、估算成本）以及按阶段、幻灯片和模型的逐演示文稿明细，外加提供商比较表。定价来自仓库中带版本的价格目录，因此成本历史可以审计。

Escriba 套件集成

Presentia 可独立运行——没有这些变量时，它的行为与原版 Presenton 完全一致。每项集成都是可选启用且相互独立的；仓库的 docker-compose.yml 为所有集成附带已注释的服务块。

Escriba——带 OCR 的文档解析。ESCRIBA_ENABLED=true + ESCRIBA_URL 将文档 → markdown 转换委托给一个 Escriba 服务（扫描版 PDF、旋转的页面、图像、 20 多种格式）。若 Escriba 宕机或对某个文件失败，Presentia 会自动回退到其本地解析器。
Anonimal——LLM 之前的 PII 匿名化。ANONIMAL_ENABLED=true + ANONIMAL_URL 会在用户提示词和提取的文档文本传给 LLM 提供商之前将其匿名化。失败即关闭：若该服务没有应答，生成会停止并给出清晰的错误，而不是发送原始 PII。原始文本永不离开你的主机。
Searchgirl——私密网页搜索。WEB_SEARCH_PROVIDER=searchgirl + SEARCHGIRL_BASE_URL 通过你自己的元搜索实例（可选 Bearer 令牌）为生成提供依据，而不是通过第三方 API。

模板、主题与语言

内置模板家族（General、Modern、Standard、Swift、带图表的 Report、es-AR 的 Institucional）、由你自己的 PPTX 生成的自定义模板、完整的主题编辑器（颜色、字体、标识），以及按模板的 style_instructions 来塑造写作语气。整套界面提供 7 种语言——English、Español、Français、Português、Italiano、中文、日本語—— 可从侧边栏切换，并按浏览器记忆。

开发

docker compose up -d --build development   # hot reload for both servers
cd servers/fastapi && python -m pytest tests/unit   # the fork adds 100+ unit tests

在 GitHub 上查看