# DeckFlow 开发者文档 (中文版)

> DeckFlow 开发者 API 接口、开发者指南、CLI 工具及 MCP 服务文档合集。

## 开发者指南 (Guides)

- [API 密钥](https://deckflow.com/docs/zh/guide/authentication.html): 在设置中生成您的 DeckFlow API 密钥。使用它来对 API 请求、MCP 集成、CLI 工作流和服务器端自动化进行身份验证。
- [核心概念](https://deckflow.com/docs/zh/guide/core-concepts.html): DeckFlow 开发者平台的核心架构、三大产品工作流及领域实体模型的详细介绍。
- [示例](https://deckflow.com/docs/zh/guide/examples.html): 包含可运行的 API、CLI 和 MCP 代码示例，帮助您快速上手 DeckFlow 后端开发。
- [限制与错误](https://deckflow.com/docs/zh/guide/limits-errors.html): DeckFlow 开发者平台的文件大小限制、API 错误状态码定义及故障重试策略。
- [定价与计费](https://deckflow.com/docs/zh/guide/pricing-billing.html): 了解 DeckFlow 开发者使用额度的消耗方式。在运行转换、提取、压缩和优化任务前，预估 Tools 任务成本。
- [快速开始](https://deckflow.com/docs/zh/guide/quick-start.html): DeckFlow 开发者快速入门指南，带您一步步完成 API 密钥配置、任务提交、状态获取的最短调用路径。
- [Webhook / 异步任务与实时订阅](https://deckflow.com/docs/zh/guide/webhooks-async-jobs.html): DeckFlow 异步任务模型、状态订阅方式（SSE 实时流与 API 轮询）及 Webhook 回调机制的优缺点与代码实现。

## API 参考 (API Reference)

- [提交生成任务 (Generation)](https://deckflow.com/docs/zh/api/create.html): 使用复杂文档、文本提示词或网页链接生成专业的演示文稿幻灯片 (PPTX)。
- [get-generation-result](https://deckflow.com/docs/zh/api/get-generation-result.html)
- [查询生成任务](https://deckflow.com/docs/zh/api/get-generation-task.html): 查询演示文稿生成任务的执行进度及最终下载链接。
- [查询焕新任务](https://deckflow.com/docs/zh/api/get-revamp-task.html): 查询演示文稿焕新任务的执行进度及最终下载链接。
- [get-translation-result](https://deckflow.com/docs/zh/api/get-translation-result.html)
- [查询翻译任务](https://deckflow.com/docs/zh/api/get-translation-task.html): 查询演示文稿翻译任务的执行进度及最终下载链接。
- [提交焕新任务 (Revamp)](https://deckflow.com/docs/zh/api/revamp.html): 升级演示文稿排版、配色以及品牌样式，同时保留幻灯片的原始文本内容。
- [文件转换器](https://deckflow.com/docs/zh/api/tools-converter.html): 文件转换器 (File Converter) 后端接口及具体任务参数规范，支持 HTML、Image、Keynote、Markdown、PDF、PPT/PPTX, Word 等格式之间的转换。
- [提取器](https://deckflow.com/docs/zh/api/tools-extractor.html): 提取器 API 规格和任务参数，支持图片 OCR 文本识别、PPTX 字体检测和文本提取。
- [合并与拆分器](https://deckflow.com/docs/zh/api/tools-merger-splitter.html): 合并与拆分器 API 规格和任务参数，支持合并多个 PPTX 文件、将 HTML 页面打包为独立播放器、或拆分 PPTX 演示文稿。
- [优化器](https://deckflow.com/docs/zh/api/tools-optimizer.html): 优化器 API 规格和任务参数，支持文件压缩、图像尺寸修改、PPTX 字体嵌入以及视频大小压缩。
- [提交翻译任务 (Translation)](https://deckflow.com/docs/zh/api/translate.html): 在保持排版格式和视觉设计的前提下翻译演示文稿文件（PPTX、PDF 等）。

## CLI 工具 (CLI Tool)

- [CLI 命令](https://deckflow.com/docs/zh/cli/commands.html): deckuse 命令作用于本地 PPTX 工作区。deckops 命令作用于 DeckFlow 云端任务。
- [CLI 示例](https://deckflow.com/docs/zh/cli/examples.html): 本地修改 PPTX 结构请使用 DeckUse。如果任务需要云端 DeckFlow 后端处理，请使用 DeckOps。
- [CLI 安装指南](https://deckflow.com/docs/zh/cli/install.html): 本地编辑 PPTX 结构请安装 DeckUse，使用 DeckFlow 云端任务请安装 DeckOps。这两个包均要求 Node.js 18 或更高版本。

## MCP 服务 (MCP Servers)

- [Claude Code](https://deckflow.com/docs/zh/mcp/claude-code.html): 通过 MCP 将 DeckFlow 连接到 Claude Code，使基于终端的智能体可以直接创建、翻新、翻译、转换、提取、合并、拆分和优化演示文稿文件。
- [Claude 网页端 / 桌面端](https://deckflow.com/docs/zh/mcp/claude-web.html): 通过自定义 MCP 连接器将 DeckFlow 连接到 Claude，使用户可以直接在 Claude 聊天会话中调用演示文稿和文件处理工作流。
- [MCP 示例场景](https://deckflow.com/docs/zh/mcp/examples.html): AI 智能体使用 DeckFlow MCP 的提示词示例与期望工具调用流。
- [Manus](https://deckflow.com/docs/zh/mcp/manus.html): 将 DeckFlow 连接到 Manus 智能体，使自动化的工作流可以直接创建、翻新、翻译、转换和优化演示文稿文件，无需人工手动交接。
- [OpenAI / ChatGPT](https://deckflow.com/docs/zh/mcp/open-ai.html): 将 DeckFlow 添加到 ChatGPT 或 OpenAI 智能体界面，使用户可以直接在对话中调用演示文稿和文件处理工作流。
- [MCP 接入配置](https://deckflow.com/docs/zh/mcp/setup.html): 在 AI 客户端中配置 DeckFlow MCP，使智能体能够直接从聊天、代码或自动化智能体进程中调用演示文稿和文件处理工作流。