Slidecraft

Slidecraft 将源材料转化为精美、可编辑的 PowerPoint 演示文稿，就在您已经使用的代理应用中。代理负责规划和指导工作，而 Slidecraft 则组织项目文件、视觉资源、图像生成、幻灯片理解和 PowerPoint 构建。

当前 alpha 版本已准备好通过 Codex、Claude Code、GitHub Copilot 以及其他兼容 MCP 的代理应用用于本地项目。发布进度在 发布就绪 中跟踪。

安装

安装 Python 3.10 或更高版本以及当前的 Node.js LTS 版本，然后运行引导式安装程序。

macOS 和 Linux

curl -fsSL https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | python3 -

Windows PowerShell

irm https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | py -3 -

安装程序会创建隔离的运行时，安装日常演示功能，准备可编辑的 PowerPoint 构造器，验证安装，并连接检测到的代理应用。当 Slidecraft 更新时，可以安全地再次运行。

有关运行前检查选项、所选代理设置、GitHub Copilot 工作区设置、安装位置和故障排除，请参阅 安装。

贡献者可以使用相同的引导流程从克隆的检出中安装。

git clone https://github.com/henryhyw/slidecraft.git
cd slidecraft
python3 install.py --source .

安装程序完成时会打印确切的仪表板命令。其形式如下。

/path/to/Slidecraft/app/bin/slidecraft console

仪表板显示项目、样式设置、共享资源集合、提供程序配置和运行时健康状况。项目和库文件夹可以直接在操作系统文件浏览器中打开。

Related MCP server: PPTX MCP Server

Agent 集成

Slidecraft 在进程内、通过其 CLI 以及通过 MCP 提供相同的功能。

slidecraft agent-capabilities
slidecraft-mcp

您的代理应用管理对话。Slidecraft 记录项目决策、来源、进度和交付物，以便任何新会话都可以从同一项目继续。仪表板将这些文件和设置集中呈现。

捆绑的 Agent 技能可在 integrations/skills/slidecraft/SKILL.md 获取。完整的主机契约记录在 Agent 集成 中。

MCP 服务器是自描述的，并在 Codex、Claude Code、 GitHub Copilot Chat 以及其他支持 MCP 的主机中作为本地 STDIO 工具服务器工作。主机特定的设置示例可在 Agent 快速入门 中找到。

在新会话中，命名项目并描述您的需求。代理会找到其保存的进度，继续工作，或返回所请求的演示文稿工件。请参阅 Agent 快速入门。

基于 Shell 的 Agent 主机可以直接使用相同的名称优先入口点。

slidecraft project resolve "Market Growth"
slidecraft project show "Market Growth"

项目与资源

项目可以位于用户选择的目录中，或位于 Slidecraft 管理的数据目录中。

project/
  slidecraft.project.json
  sources/           user material and direct-use visual assets
  deliverables/      editable presentations, previews, and reports
  .slidecraft/       durable Agent evidence and resource assignments

视觉灵感、规范图标和可重用的可编辑组件位于共享的本地集合中。在聊天或仪表板中做出的选择会保留在项目中，并在项目再次打开时准备就绪。

配置遵循打包默认值、用户配置、可选的项目覆盖、环境变量和显式运行时参数。使用这些命令检查每个解析值及其来源。

slidecraft config path
slidecraft config show
slidecraft config validate
slidecraft config explain

请参阅 配置、指导配置文件 和 文档地图。

流水线

Agent 通过演示文稿工作流进行推理，并组合这些可重用的能力。

1. 规范化多模态源材料和硬约束。

2. 规划演示文稿的故事线和幻灯片特定的语义意图。

3. 搜索视觉灵感、规范图标和可重用组件，然后在上下文中选择有用的资源。

4. 为承载信息的幻灯片组装并执行图像生成简报。

5. 使用 Agent 视觉推理将有意义的渲染实体和关系映射到权威源内容。

6. 使用 OpenCV 测量文本、形状和布局，并在 SAM 2 提供有用边界细节时用于不规则填充区域。

7. 编写重建路径和细化意图，然后编译可编辑的 PowerPoint 场景。

8. 对 Agent 识别的排版组、对齐方式、图标槽和连接器拓扑应用确定性的有界规范化。

9. 渲染可编辑的演示文稿并保留重建报告。

系统契约记录在 框架流水线 中。连接器推理记录在 连接器契约 中。细化约束记录在 规范化契约 中。

仓库布局

src/slidecraft/       installable Python package and dashboard
js/                   portable PowerPoint constructor
scripts/              installed worker and platform integration scripts
config/               versioned framework and design-policy examples
src/slidecraft/guidance_profiles/ reusable communication profiles
schemas/              interchange contracts
integrations/         Agent integration packages
tests/                automated tests
tools/historical_regression/  architecture-slide regression utilities excluded from the runtime
vendor/               upstream development sources for bundled resources
workspace/            ignored local projects, caches, and generated evidence

顶层 AGENTS.md 为具有仓库感知能力的 Agent 提供了简洁的入口契约。共享框架代码从不依赖于 workspace/ 下的项目或测试夹具。

在仓库开发期间，实时演示文稿项目和生成的输出保留在 workspace/ 下，并被 Git 排除。打包的入门资源位于 src/slidecraft/starter_resources/ 下。

每个新项目都会在其隐藏的 .slidecraft/ 目录下获得一个打包的演示文稿设计基线。封面、议程、章节分隔页、陈述、结尾和附录分隔页使用共享的确定性布局。承载信息的幻灯片使用图像生成路径。最终组装要求所有计划中的幻灯片按演示文稿顺序排列，并在导出前检查冻结的设计、重复的排版角色、连接器策略、规范资产、画布和演示文稿装饰。

开发

.venv/bin/python -m pytest -q
.venv/bin/python -m ruff check src tests tools
.venv/bin/python -m build

OpenCV 处理普通文本、连接器和线条艺术测量。安装 segmentation 附加组件以添加 SAM 2 边界检测，用于不规则填充对象。

许可证

Slidecraft 根据 MIT 许可证 发布。捆绑的第三方资源保留其自己的声明。