AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
docs(sponsorship): add skill-local sponsor references
hugohe31c700693eb75
diff --git a/SPONSORING.md b/SPONSORING.mdnew file mode 100644index 00000000..a8aa7605--- /dev/null+++ b/SPONSORING.md@@ -0,0 +1,86 @@+# Sponsor PPT Master++English | [中文](SPONSORING_CN.md)++PPT Master is a free, open-source workflow for turning documents or topics into native, editable PowerPoint decks. It is independently maintained and remains provider-agnostic. Sponsorship helps fund maintenance, compatibility work, examples, documentation, and the infrastructure used by the project.++Sponsorship is considered selectively. A partnership must be useful to PPT Master users and must not compromise the project's technical independence or user trust.++## Partnership Placements++### Lead Sponsor++A prominent placement for one primary partner whose product has a strong fit with PPT Master's users.++Potential placement includes:++- The expanded sponsor block near the top of `README.md` and `README_CN.md`.+- The lead position in [`skills/ppt-master/SPONSORS.md`](skills/ppt-master/SPONSORS.md), which travels with standalone Skill distributions.+- A relevant, clearly disclosed mention at an existing user decision point.++### Service Partner++For services that solve a real need in the PPT Master workflow, such as agent or model access, AI image generation, narration, cloud infrastructure, or hosted execution.++Potential placement includes:++- A listing in the repository and standalone Skill sponsor pages.+- A context-specific mention in existing setup or troubleshooting documentation.+- A dedicated referral link, promotion code, or user benefit supplied by the partner.++### Technical Integration Partner++For providers whose API or hosted service is genuinely supported by an existing PPT Master integration boundary.++Technical integration requires compatibility review and must remain optional. Sponsorship alone does not make a provider a default, bypass validation, or justify provider-specific behavior inside the presentation workflow.++### Supporting Sponsor++A compact logo and link placement for organizations that support ongoing maintenance without requiring a workflow integration.++## Partnership Requirements++Partners should provide:++- An accurate product description and approved brand assets.+- A stable destination URL, preferably with a trackable referral parameter.+- A concrete benefit for PPT Master users when applicable.+- A current contact for operational or content updates.+- Prompt notice when pricing, availability, branding, or promotional terms change.++All promotional claims remain subject to review. Expired, misleading, unavailable, or technically incompatible offers may be corrected or removed.++## Project Boundaries++Sponsorship does not include:++- Influence over the project roadmap or quality gates.+- Access to user files, prompts, generated presentations, or usage data.+- Advertising inside exported PPTX files.+- Automatic selection of a sponsor's service without user choice.+- Custom development, private deployment, or a commercial support SLA.+- An endorsement beyond the exact placement and wording agreed for the partnership.++## Current Sponsor Surfaces++- The sponsor block near the top of [README.md](README.md) and [README_CN.md](README_CN.md).+- Contextual model-access guidance in the installation and FAQ documentation.+- The standalone Skill sponsor page at [`skills/ppt-master/SPONSORS.md`](skills/ppt-master/SPONSORS.md).+- The sponsor and individual-support section near the end of both README files.++## Contact++To discuss sponsorship, email **[email protected]** with:++- Company and product name.+- The service offered to PPT Master users.+- Target regions and supported tools or providers.+- Proposed user benefit, referral link, or promotion code.+- Requested placement and sponsorship period.+- Brand assets and approved description.++Terms, placement, and duration are agreed individually. Please do not open a public bug report for sponsorship discussions.++## Individual Support++Individual users can support the project through [PayPal](https://paypal.me/hugohe3) or the Alipay QR code shown in [README_CN.md](README_CN.md#赞助与支持).diff --git a/SPONSORING_CN.md b/SPONSORING_CN.mdnew file mode 100644index 00000000..48e7570c--- /dev/null+++ b/SPONSORING_CN.md@@ -0,0 +1,86 @@+# 赞助 PPT Master++[English](SPONSORING.md) | 中文++PPT Master 是一套免费开源的演示文稿工作流,可以将文档或主题转化为原生可编辑的 PowerPoint。项目由个人独立维护,并始终保持 Provider 中立。赞助将用于项目维护、兼容性改进、示例、文档和基础设施。++项目会选择性接受赞助。合作必须真正帮助 PPT Master 用户,也不得影响项目的技术独立性和用户信任。++## 合作展示类型++### 首席赞助商++面向与 PPT Master 用户高度契合的一家主要合作伙伴,提供最醒目的展示位置。++可能包含:++- `README.md` 和 `README_CN.md` 顶部展开的赞助商区域。+- 随独立 Skill 分发的 [`skills/ppt-master/SPONSORS_CN.md`](skills/ppt-master/SPONSORS_CN.md) 首要位置。+- 在已有且相关的用户决策节点中,进行明确标注的展示。++### 服务合作伙伴++适用于解决 PPT Master 工作流真实需求的服务,例如 Agent 或模型接入、AI 生图、演示旁白、云基础设施或托管运行。++可能包含:++- 在仓库和独立 Skill 的赞助商页面中展示。+- 在现有配置或故障排查文档的相关位置中说明。+- 展示合作方提供的专属链接、优惠码或用户福利。++### 技术集成合作伙伴++适用于其 API 或托管服务已经能够通过 PPT Master 现有接入边界真实使用的 Provider。++技术集成必须经过兼容性检查,并始终保持可选。赞助本身不会使某个 Provider 成为默认选项,也不会绕过校验,更不能成为在演示工作流中加入供应商特有行为的理由。++### 支持赞助商++适用于支持项目持续维护、但不需要工作流集成的组织,提供简洁的 Logo 与链接展示。++## 合作要求++合作方应提供:++- 准确的产品介绍和经过批准的品牌素材。+- 稳定的目标链接,最好带有可追踪的推广参数。+- 在适用时,为 PPT Master 用户提供明确福利。+- 用于运营或内容更新的有效联系人。+- 在价格、可用性、品牌或推广条款发生变化时及时通知。++所有推广声明均需经过审核。过期、误导、不可用或技术不兼容的内容可能被修正或移除。++## 项目边界++赞助不包含:++- 影响项目路线图或质量门禁。+- 访问用户文件、提示词、生成的演示文稿或使用数据。+- 在用户导出的 PPTX 中投放广告。+- 未经用户选择自动启用赞助商服务。+- 定制开发、私有化部署或商业支持 SLA。+- 超出双方约定展示位置和文案范围的背书。++## 当前赞助展示位置++- [README.md](README.md) 和 [README_CN.md](README_CN.md) 顶部的赞助商区域。+- 安装与常见问题文档中的模型接入说明。+- [`skills/ppt-master/SPONSORS_CN.md`](skills/ppt-master/SPONSORS_CN.md) 独立 Skill 赞助商页面。+- 两份 README 底部附近的企业赞助与个人支持区域。++## 联系方式++如需洽谈赞助,请发送邮件至 **[email protected]**,并提供:++- 公司与产品名称。+- 面向 PPT Master 用户提供的服务。+- 目标地区以及支持的工具或 Provider。+- 拟提供的用户福利、推广链接或优惠码。+- 希望获得的展示位置和赞助周期。+- 品牌素材与经过批准的产品介绍。++具体条款、展示位置和周期单独协商。请勿通过公开 Bug Issue 洽谈赞助。++## 个人赞助++个人用户可以通过 [PayPal](https://paypal.me/hugohe3) 或 [README_CN.md](README_CN.md#赞助与支持) 中的支付宝收款码支持项目。diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex 16fbc9b2..9900b6a4 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -60,3 +60,4 @@ PPT Master is a routed presentation workflow. This entry owns global execution d- Keep required workflow, reference, script, and template documentation inside this Skill directory.- Repository-level documents may point into the package; package runtime files must not depend on repository-level instructions.- On Windows, if a documented `python3 ...` command is unavailable, rerun the same command with `python`.+- Sponsor information is optional reference material. Read the matching [`SPONSORS.md`](SPONSORS.md) or [`SPONSORS_CN.md`](SPONSORS_CN.md) only when the user explicitly requests a model, AI image model, API/provider, or hosted-service recommendation. Never surface sponsor or model recommendations proactively during normal generation, troubleshooting, or quality review.diff --git a/skills/ppt-master/SPONSORS.md b/skills/ppt-master/SPONSORS.mdnew file mode 100644index 00000000..29282a7a--- /dev/null+++ b/skills/ppt-master/SPONSORS.md@@ -0,0 +1,61 @@+# Sponsors and User Benefits++English | [中文](SPONSORS_CN.md)++PPT Master is free and open source. The sponsors below help fund its ongoing maintenance and provide optional benefits for PPT Master users. Sponsorship does not change the project's provider-agnostic design: use any compatible agent, model, or service you prefer.++Want to support the project or discuss a partnership? See the [sponsorship guide](https://github.com/hugohe3/ppt-master/blob/main/SPONSORING.md).++## Current Model Recommendation++For the best results, use **[Kimi K3](https://www.kimi.com/code/?aff=ppt-master)** (or Claude) to drive the workflow, paired with **`gpt-image-2`** (OpenAI) or **`gemini-3.1-flash-image`** (Google) for AI image generation. If model capability is limiting output quality, upgrade the driving model before weakening the workflow or its quality requirements.++## Kimi++<p align="center">+ <a href="https://www.kimi.com/code/?aff=ppt-master"><img src="https://gcdn.moonshot.cn/growth-cdn/sponsor/kimi-en.png" alt="Kimi" width="100%"></a>+</p>++Thanks to [Kimi](https://www.kimi.com/code/?aff=ppt-master) for sponsoring PPT Master. [Kimi K3](https://platform.kimi.ai/docs/guide/kimi-k3-quickstart) is the world's first open 3T-class model, featuring native vision and a 1-million-token context window. With PPT Master, K3 can understand PDFs, DOCX files, web pages, and other source material, structure the narrative, and generate a natively editable PPTX.++**Try [Kimi Code](https://www.kimi.com/code/?aff=ppt-master), or access the API through the Kimi Open Platform ([中文站](https://platform.kimi.com?aff=ppt-master) | [Global](https://platform.kimi.ai?aff=ppt-master)).**++## Model Access Partners++### PackyCode++<a href="https://www.packyapi.com/register?aff=ppt-master"><img src="https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/sponsors/packycode.png" alt="PackyCode" width="150"></a>++[PackyCode](https://www.packyapi.com/register?aff=ppt-master) provides relay access to Claude Code, Codex, Gemini, and other services. Register through the dedicated link and enter the promo code **`ppt-master`** during recharge to receive 10% off.++### APIKEY.FUN++<a href="https://apikey.fun/register?aff=PPT-MASTER"><img src="https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/sponsors/apikey-fun.png" alt="APIKEY.FUN" width="150"></a>++[APIKEY.FUN](https://apikey.fun/register?aff=PPT-MASTER) provides enterprise-grade access to Claude, OpenAI, Gemini, and other mainstream models. Register through the dedicated link to receive up to a permanent 5% discount on top-ups.++### RunAPI++<a href="https://runapi.co/register?aff=WMLJ"><img src="https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/sponsors/runapi.png" alt="RunAPI" width="150"></a>++[RunAPI](https://runapi.co/register?aff=WMLJ) provides access to 150+ models, including OpenAI, Claude, Gemini, DeepSeek, and Grok, through one API key. Register through the dedicated link and contact an administrator to claim **¥7 in free credit**.++### YouYun ZhiSuan++<a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY-git_pptmaster0624"><img src="https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/sponsors/youyun.png" alt="YouYun ZhiSuan" width="150"></a>++[YouYun ZhiSuan](https://www.compshare.cn/coding-plan?ytag=GPU_YY-git_pptmaster0624), UCloud's AI cloud platform, provides domestic and international model APIs, CodingPlan packages, enterprise concurrency, technical support, and invoicing. Register through the dedicated link to receive up to **¥10 in free trial credit**. PPT Master is also available there as a hosted Agent for users who do not want to deploy it locally.++## Infrastructure Support++<a href="https://m.do.co/c/547f129aabe1"><img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/PoweredByDO/DO_Powered_by_Badge_blue.svg" alt="Powered by DigitalOcean" height="40"></a>++Thanks to [DigitalOcean](https://m.do.co/c/547f129aabe1) for supporting the project's infrastructure.++## Individual Support++If PPT Master has been useful to you, individual support of any amount helps keep the project moving and free.++<a href="https://paypal.me/hugohe3"><img src="https://img.shields.io/badge/PayPal-Sponsor-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="Sponsor via PayPal"></a>++[Alipay QR code](https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/alipay-qr.jpg)diff --git a/skills/ppt-master/SPONSORS_CN.md b/skills/ppt-master/SPONSORS_CN.mdnew file mode 100644index 00000000..4ec96a94--- /dev/null+++ b/skills/ppt-master/SPONSORS_CN.md@@ -0,0 +1,61 @@+# 赞助商与用户福利++[English](SPONSORS.md) | 中文++PPT Master 始终免费开源。以下赞助方共同支持项目的持续维护,并为 PPT Master 用户提供可选福利。赞助不会改变项目不绑定 Provider 的设计:你仍可自由选择任何兼容的 Agent、模型或服务。++希望支持项目或洽谈合作?请查看[赞助合作说明](https://github.com/hugohe3/ppt-master/blob/main/SPONSORING_CN.md)。++## 当前模型推荐++追求最佳效果,语言模型选 **[Kimi K3](https://www.kimi.com/code/?aff=ppt-master)**(或 Claude)驱动流程,搭配 AI 生图模型 **`gpt-image-2`**(OpenAI)或 **`gemini-3.1-flash-image`**(Google)。如果模型能力正在拖累产出质量,应先升级驱动模型,而不是削弱工作流或质量要求。++## Kimi++<p align="center">+ <a href="https://www.kimi.com/code/?aff=ppt-master"><img src="https://gcdn.moonshot.cn/growth-cdn/sponsor/kimi-zh.png" alt="Kimi" width="100%"></a>+</p>++感谢 [Kimi](https://www.kimi.com/code/?aff=ppt-master) 赞助 PPT Master。[Kimi K3](https://platform.kimi.com/docs/guide/kimi-k3-quickstart) 是全球首个开源 3T 级模型,拥有原生视觉能力与 100 万 Token 上下文。搭配 PPT Master,K3 可以理解 PDF、DOCX、网页等原始资料,梳理演示逻辑并生成原生可编辑的 PPTX。++**立即体验 [Kimi Code](https://www.kimi.com/code/?aff=ppt-master),或通过 Kimi 开放平台([中文站](https://platform.kimi.com?aff=ppt-master)|[Global](https://platform.kimi.ai?aff=ppt-master))使用 API。**++## 模型接入合作伙伴++### PackyCode++<a href="https://www.packyapi.com/register?aff=ppt-master"><img src="https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/sponsors/packycode.png" alt="PackyCode" width="150"></a>++[PackyCode](https://www.packyapi.com/register?aff=ppt-master) 提供 Claude Code、Codex、Gemini 等服务的中转接入。通过专属链接注册,并在充值时填写优惠码 **`ppt-master`**,即可享受 9 折优惠。++### APIKEY.FUN++<a href="https://apikey.fun/register?aff=PPT-MASTER"><img src="https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/sponsors/apikey-fun.png" alt="APIKEY.FUN" width="150"></a>++[APIKEY.FUN](https://apikey.fun/register?aff=PPT-MASTER) 提供 Claude、OpenAI、Gemini 等主流模型的企业级接入服务。通过专属链接注册,最高可享永久充值 95 折优惠。++### RunAPI++<a href="https://runapi.co/register?aff=WMLJ"><img src="https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/sponsors/runapi.png" alt="RunAPI" width="150"></a>++[RunAPI](https://runapi.co/register?aff=WMLJ) 通过一个 API Key 提供 OpenAI、Claude、Gemini、DeepSeek、Grok 等 150+ 主流模型。通过专属链接注册并联系管理员,即可领取 **¥7 免费额度**。++### 优云智算++<a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY-git_pptmaster0624"><img src="https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/sponsors/youyun.png" alt="优云智算" width="150"></a>++[优云智算](https://www.compshare.cn/coding-plan?ytag=GPU_YY-git_pptmaster0624) 是 UCloud 旗下 AI 云平台,提供国内外模型 API、CodingPlan 套餐、企业级并发、技术支持和开票服务。通过专属链接注册,最高可获得 **¥10 免费体验金**。平台还提供无需本地部署的 PPT Master Agent。++## 基础设施支持++<a href="https://m.do.co/c/547f129aabe1"><img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/PoweredByDO/DO_Powered_by_Badge_blue.svg" alt="Powered by DigitalOcean" height="40"></a>++感谢 [DigitalOcean](https://m.do.co/c/547f129aabe1) 为项目基础设施提供支持。++## 个人赞助++如果 PPT Master 帮到了你,任何金额的个人赞助都能帮助项目持续更新、保持免费开源。++<a href="https://paypal.me/hugohe3"><img src="https://img.shields.io/badge/PayPal-赞助-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="通过 PayPal 赞助"></a>++[支付宝收款码](https://raw.githubusercontent.com/hugohe3/ppt-master/main/docs/assets/alipay-qr.jpg)diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 679cdcbd..429a924e 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -16,7 +16,7 @@},"file_budgets": {"AGENTS.md": 2350,- "skills/ppt-master/SKILL.md": 800,+ "skills/ppt-master/SKILL.md": 850,"skills/ppt-master/references/executor-base.md": 7250,"skills/ppt-master/references/executor-structured.md": 5300,"skills/ppt-master/references/executor-chart.md": 3100,@@ -45,7 +45,23 @@"skills/ppt-master/SKILL.md","skills/ppt-master/workflows/routing.md"],- "max_tokens": 5350+ "max_tokens": 5425+ },+ "support.sponsor-recommendation.en": {+ "description": "English sponsor context for explicit user requests for model, AI image model, API/provider, or hosted-service recommendations.",+ "scope": "incremental",+ "files": [+ "skills/ppt-master/SPONSORS.md"+ ],+ "max_tokens": 1250+ },+ "support.sponsor-recommendation.zh": {+ "description": "Chinese sponsor context for explicit user requests for model, AI image model, API/provider, or hosted-service recommendations.",+ "scope": "incremental",+ "files": [+ "skills/ppt-master/SPONSORS_CN.md"+ ],+ "max_tokens": 1250},"route.create-template.brand": {"description": "Create Brand path; it authors no SVG and does not activate Template_Designer or SVG modules.",@@ -77,7 +93,7 @@"skills/ppt-master/templates/README.md","skills/ppt-master/templates/decks/README.md"],- "max_tokens": 57400+ "max_tokens": 57475},"route.create-template.layout": {"description": "Create Layout path through Template_Designer, SVG core, and the structured PPTX interface.",@@ -95,7 +111,7 @@"skills/ppt-master/templates/README.md","skills/ppt-master/templates/layouts/README.md"],- "max_tokens": 57600+ "max_tokens": 57675},"route.enhance-native-pptx": {"description": "Finished-PPTX native enhancement route.",@@ -106,7 +122,7 @@"files": ["skills/ppt-master/workflows/native-enhance-pptx.md"],- "max_tokens": 8300+ "max_tokens": 8375},"route.fill-native-pptx": {"description": "Raw-PPTX native fill route.",@@ -117,7 +133,7 @@"files": ["skills/ppt-master/workflows/template-fill-pptx.md"],- "max_tokens": 11000+ "max_tokens": 11075},"route.generate.planning": {"description": "Generate-PPTX planning through Strategist, including reference-first whole-document authoring and representative multi-source custom mode/style synthesis; schemas and optional scaffolds are tool-consumed.",@@ -306,7 +322,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 82200+ "max_tokens": 82275},"route.generate.flat-ai-two-types": {"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",@@ -319,7 +335,7 @@"stage.generate.image.ai-two-types"],"files": [],- "max_tokens": 122350+ "max_tokens": 122425},"route.generate.flat-in-hand-image": {"description": "Generate-PPTX context with provided, placeholder, or formula images and no acquisition role.",@@ -331,7 +347,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 95650+ "max_tokens": 95725},"route.generate.flat-web-image": {"description": "Generate-PPTX context with web image acquisition.",@@ -344,7 +360,7 @@"stage.generate.image.web"],"files": [],- "max_tokens": 102950+ "max_tokens": 103025},"route.enhance-native-pptx.audio": {"description": "Enhance Native PPTX with the shared narration-audio stage.",@@ -354,7 +370,7 @@"stage.shared.generate-audio"],"files": [],- "max_tokens": 11050+ "max_tokens": 11125},"route.generate.beautify-flat-no-image": {"description": "Generate-PPTX 1:1 beautify profile on the flat no-image path.",@@ -364,7 +380,7 @@"profile.generate.beautify-pptx"],"files": [],- "max_tokens": 89050+ "max_tokens": 89125},"route.generate.flat-no-image-chart": {"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",@@ -377,7 +393,7 @@"stage.generate.verify-charts"],"files": [],- "max_tokens": 106200+ "max_tokens": 106275},"route.generate.brand-flat-no-image": {"description": "Brand-preset flat Generate-PPTX path without image acquisition.",@@ -389,7 +405,7 @@"stage.generate.template.brand"],"files": [],- "max_tokens": 89200+ "max_tokens": 89275},"route.generate.deck-structured-no-image": {"description": "Deck-preset structured Generate-PPTX path without image acquisition.",@@ -401,7 +417,7 @@"stage.generate.template.deck"],"files": [],- "max_tokens": 99100+ "max_tokens": 99175},"route.generate.layout-structured-no-image": {"description": "Layout-preset structured Generate-PPTX path without image acquisition.",@@ -413,7 +429,7 @@"stage.generate.template.layout"],"files": [],- "max_tokens": 99600+ "max_tokens": 99675},"route.generate.topic-only-flat-no-image": {"description": "Topic research followed by the default flat no-image Generate-PPTX path.",@@ -423,7 +439,7 @@"route.generate.flat-no-image"],"files": [],- "max_tokens": 83600+ "max_tokens": 83675},"stage.generate.executor.flat": {"description": "Incremental flat Executor core with representative multi-source custom mode/style execution.",@@ -533,7 +549,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 58700+ "max_tokens": 58775},"stage.generate.topic-research": {"description": "Gap-targeted factual intake stage.",@@ -661,7 +677,7 @@"stage.generate.strategist.template"],"files": [],- "max_tokens": 60000+ "max_tokens": 60075},"route.generate.planning-template-ai": {"description": "Explicit template workspace plus confirmed AI-image planning.",@@ -671,7 +687,7 @@"route.generate.planning-ai"],"files": [],- "max_tokens": 72200+ "max_tokens": 72275},"stage.generate.executor.chart": {"description": "Conditional chart/table page execution rules.",