本页面收集了在起草 index.md、setup.md、tools.md 和 examples.md 时发现的缺失参数。
若要查看直接向产品/API 所有者确认的问题，请参阅 confirmation-questions.md。
已确认的数值
| 领域 / 模块 | 已确认的数值 |
|---|
| MCP 端点 | https://dev.deckflow.com/mcp/v1/ |
| 身份验证 | 仅限 API 密钥 |
| 首批客户端 | Claude Code, Claude 网页端/桌面端, Manus, OpenAI/ChatGPT |
| 输出交付 | 临时下载链接 |
连接配置
| 参数 / 概念 | 待确定的定义 |
|---|
| MCP 端点 | 确定 https://dev.deckflow.com/mcp/v1/ 是生产环境还是开发/测试环境，以及确定环境发布、区域和版本控制策略。 |
| 传输协议 | 仅限远程 HTTP、支持 SSE、stdio/本地服务器支持，或支持多种模式。 |
| 服务器名称 | 规范的配置键名：deckflow、DeckFlow 或其他名称。 |
| 能力发现 | 是否提供 get_deckflow_capabilities 工具，以及它的返回结果结构。 |
身份验证与权限
| 参数 / 概念 | 待确定的定义 |
|---|
| 身份验证方式 | 已确认仅使用 API 密钥。仍需确定密钥创建页面 URL、请求头或环境变量名称，以及针对特定客户端的密钥处理方式。 |
| API 密钥权限范围 | 如果存在分层级权限密钥，需要确定：文件上传、任务创建、任务读取、工作区读取、术语表读取、Brand DNA 读取、计费读取等范围。 |
| 工作区范围 | 确定是个人账户、团队工作区、组织还是项目级别。 |
| 令牌生命周期 | 确定过期、刷新、重新连接、注销及撤销逻辑。 |
| 域名/应用白名单 | 自定义智能体是否需要域名白名单或应用注册流程。 |
| 用户身份识别工具 | 当前用户/账户查询的最终工具名称和响应结构。 |
文件输入
| 参数 / 概念 | 待确定的定义 |
|---|
| 文件引用模型 | file_id、asset_id、签名上传 URL、客户端附件 ID、外部 URL 或内联内容。 |
| 上传限制 | 最大大小、每次任务最大文件数、总批量大小、页数、幻灯片数、视频时长。 |
| 支持的 MIME 类型 | 针对每个工作流的规范 MIME 和扩展名列表。 |
| URL 导入 | 仅支持公开 URL、经身份验证的 URL、允许的域名、爬取深度和超时时间。 |
| 内联内容 | 粘贴的 HTML、Markdown、文本和提示词字段的最大长度。 |
| 保留策略 | 上传的输入文件存储多长时间以及何时删除。 |
通用任务生命周期
| 参数 / 概念 | 待确定的定义 |
|---|
| 任务 ID | 格式、稳定性、工作区可见性和过期时间。 |
| 状态枚举 | 排队中、处理中、成功、失败、已取消和已过期的规范状态。 |
| 进度 | 百分比、阶段标签、预估剩余时间 (ETA)、当前步骤，或不提供进度。 |
| 取消操作 | 哪些工具支持取消以及何时允许取消。 |
| 重试行为 | 客户端重试规则、幂等性键支持以及重复任务预防。 |
| Webhook | MCP 任务是可以注册回调，还是仅支持轮询。 |
| 错误 Schema | 错误代码、错误消息、可重试标志、字段级校验错误以及支持追踪 ID。 |
输出交付
| 参数 / 概念 | 待确定的定义 |
|---|
| 结果模型 | 文件、预览图、元数据、警告、日志和嵌套资产。 |
| 下载 URL | 临时签名 URL 的有效时间、访问控制、文件名和内容类型。 |
| 多个输出 | PPTX + PDF 或图片批次是如何表示的。 |
| ZIP 打包 | 多文件输出何时打包为 ZIP 以及用户如何请求。 |
| 工作区持久化 | 输出是否会出现在 DeckFlow 网页端应用/项目库中。 |
| 结果过期 | 输出在多长时间内保持可下载状态。 |
Create（生成）
| 参数 / 概念 | 待确定的定义 |
|---|
source_type | 文件、URL、文本、Markdown、主题或混合源的枚举值。 |
source | 文件引用、URL、内联内容或多个数据源。 |
prompt | 最大长度、必填/选填行为以及提示词安全规则。 |
output_format | PPTX、PDF、HTML、图片，或者多种输出格式。 |
slide_count | 精确的幻灯片数、最小/最大范围，或由智能体评估的默认值。 |
aspect_ratio | 支持的长宽比和默认值。 |
brand_profile_id | 品牌 DNA ID 格式和默认品牌配置行为。 |
template_id | 模板目录、兼容性和预览支持。 |
language | 语言代码标准和自动检测行为。 |
| 复杂元素处理 | 公式、图表、示意图、图像、表格和嵌套结构的默认处理方式。 |
Revamp（焕新）
| 参数 / 概念 | 待确定的定义 |
|---|
| 输入格式 | PPTX、Keynote、PDF，以及是否接受 PPT。 |
style_mode | 模板、品牌 DNA、自定义指令或自动样式。 |
template_id | 模板列表、筛选、预览和兼容性。 |
brand_profile_id | 品牌 DNA 的可用性、选择和回退。 |
preserve_content | 内容保留是强制执行的还是可配置的。 |
| 批量焕新 | 最大文件数、排序方式、输出打包和单个文件失败处理。 |
| 输出格式 | 与输入相同、仅 PPTX、PDF、Keynote 或是多种格式。 |
Translate（翻译）
| 参数 / 概念 | 待确定的定义 |
|---|
| 支持的语言 | 规范列表、语言代码、区域变体以及从右至左 (RTL) 书写支持。 |
source_language | 选填、必填或自动检测。 |
target_language | 必填字段格式。 |
| 术语表模型 | glossary_id、内联词条、CSV 上传、词条大小写敏感度及优先级。 |
| 排版保留 | 当翻译后的文本无法放下的默认和警告行为。 |
| 同格式输出 | 是否始终保留输入格式，还是可以更改。 |
| 图片文本翻译 | 图片内的 OCR 文本是否默认翻译。 |
| 演讲者备注/批注 | 是否翻译备注和批注。 |
转换器工具
| 参数 / 概念 | 待确定的定义 |
|---|
operation 枚举 | 13 个转换操作的最终名称。 |
| HTML 渲染选项 | 视口、缩放比例、等待时间、外部资源、字体和页面高度行为。 |
| PPT/视频选项 | 每张幻灯片的持续时间、动画处理、过渡处理、分辨率、FPS。 |
| 图片输出选项 | PNG/JPEG/WebP、缩放比例、页面范围、ZIP 打包和命名。 |
| 传统 PPT 处理 | 传统 PPT 输入是直接转换，还是先规范化为 PPTX。 |
提取器工具
| 参数 / 概念 | 待确定的定义 |
|---|
| OCR 语言 | 自动检测、语言提示和支持的文字系统。 |
| OCR 输出 | 纯文本、JSON 块、坐标、置信度、阅读顺序。 |
| PPTX 字体输出 | 字体族、样式、粗细、幻灯片使用情况、缺失字体检测。 |
| PPTX 文本输出 | 形状 ID、幻灯片编号、坐标、样式元数据、演讲者备注。 |
| 范围参数 | 统一为 page_range、slide_range 还是 ranges。 |
合并与拆分器
| 参数 / 概念 | 待确定的定义 |
|---|
| 合并顺序 | 上传顺序、显式顺序数组或按文件名排序。 |
| 排版保留 | 主题、母版、字体和重复资源的处理方式。 |
| 拆分策略 | 拆分每张幻灯片、选择的范围、固定块大小或命名小节。 |
| HTML 播放器包 | 画布大小、标题、描述、导航和资源打包。 |
| 部分失败 | 某个输入文件校验失败时的行为。 |
优化器
| 参数 / 概念 | 待确定的定义 |
|---|
| 压缩质量 | 预设值、数值范围、默认值和最低质量。 |
| 目标大小 | 用户是否可以请求最大的 MB 输出以及无法满足时的处理。 |
| 图片调整大小 | 宽度/高度规则、长宽比锁定、放大策略、输出类型。 |
| 字体嵌入 | 字体文件上传、许可警告、子集化和字体选择。 |
| 视频压缩 | 编解码器、码率、分辨率、FPS、音频处理和目标格式。 |
限制与计费
| 参数 / 概念 | 待确定的定义 |
|---|
| 套餐访问权限 | 哪些 DeckFlow 套餐可以使用 MCP。 |
| 额度扣减 | 任务如何消耗额度，以及失败/取消的任务如何收费。 |
| 速率限制 | 每分钟请求数、每小时任务数、并发作业数、批量限制。 |
| 免费额度 | 是否提供 MCP 以及相应的限制。 |
| 用量报告 | 智能体是否可以查询剩余额度或历史任务记录。 |
文档发布清单
- 确认
https://dev.deckflow.com/mcp/v1/ 是最终的生产端点还是开发/测试端点。 - 确认最终工具名称并移除“规划中/建议的”措辞。
- 添加最终的 JSON Schema 或链接到生成的参考页面。
- 仅在集成完成后添加真实的客户端屏幕截图。
- 与产品/法务确认安全、数据保留、计费和套餐的措辞。
- 在发布前对照可运行的 MCP 服务器验证示例。