这个项目能做什么

DeckTools 是 Deckflow 任务自动化的 pnpm monorepo,旨在云端大规模处理 deck 文件。仓库包含三个主要包:TypeScript SDK(`@deckflow/decktools-sdk`),用于 Node.js 和浏览器中的文件上传和任务 API;Go SDK,提供相同 API;以及 Node.js CLI(`decktools`),用于命令行使用。 使用 pnpm 安装和构建很简单:运行 `pnpm install`、`pnpm build`、`pnpm typecheck` 和 `pnpm test` 来设置工作区。CLI 可以通过 `pnpm --filter decktools build` 后跟 `node apps/node-cli/dist/cli.js --help` 在本地构建和运行。 CLI 支持登录、配置管理和文件转换命令。快速入门涉及运行 `decktools login`、`decktools config show` 和 `decktools convert slides.pptx --to pdf` 来将 PowerPoint 文件转换为 PDF。 TypeScript SDK 提供 `createDeck` 函数,接受令牌、空间 ID 和可选 API 根地址(默认为 `https://app.deckflow.com/v1`)。认证通过 `X-Auth-Token` 头(用于令牌)或 `Authorization: Bearer`(用于 API 密钥)处理。SDK 暴露方法如 `convertPptToPdf` 用于文件转换,以及 `tasks.wait` 用于轮询任务完成。 工作区结构支持未来在 `sdks/python`、`sdks/java` 或 `sdks/rust` 下添加 SDK,表明计划覆盖更广泛的语言。每个包都有自己的 README,包含安装、配置和使用示例的详细文档。