md2video-audio-skill 1.0.0__tar.gz

md2video_audio_skill-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: 自动发布到 PyPI
+
+on:
+  release:
+    types: [published] # 只有当你在 GitHub 网页上真正点击“发布新版本”时才触发
+
+jobs:
+  build-n-publish:
+    name: 编译并安全上传至 PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # 这个核心权限必须开启，用于和 PyPI 官方进行无密钥安全握手
+
+    steps:
+      - name: 拉取代码
+        uses: actions/checkout@v4
+
+      - name: 设置 Python 环境
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: 安装现代打包工具
+        run: pip install build
+
+      - name: 编译出静态包
+        run: python -m build
+
+      - name: 通过免密认证发布到 PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1 # 官方受信任的发布插件

md2video_audio_skill-1.0.0/.gitignore

@@ -0,0 +1,39 @@
+# =========================
+# macOS 系统自动生成文件
+# =========================
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# 缩略图与图标
+Icon?
+._*
+
+# 临时文件与网络卷垃圾桶
+.Trashes
+.Spotlight-V100
+.TemporaryItems
+
+# 敏感配置文件
+.env
+
+# =========================
+# Python 编译、打包与虚拟环境缓存（新增）
+# =========================
+# 过滤本地运行 python -m build 生成的发布压缩包目录
+dist/
+build/
+
+# 过滤 Python 自动生成的元数据描述文件夹
+*.egg-info/
+.eggs/
+
+# 过滤 Python 运行时自动生成的字节码缓存（杜绝 __pycache__ 污染）
+__pycache__/
+*.py[cod]
+*$py.class
+
+# 过滤你本地可能用到的 Python 虚拟环境目录
+.venv/
+venv/
+env/

md2video_audio_skill-1.0.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

md2video_audio_skill-1.0.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.5
+Name: md2video-audio-skill
+Version: 1.0.0
+Summary: One Markdown file + a one-click command = professional-grade talking-head videos. ｜ 一个 Markdown 文件 + 一键命令 = 专业级口播视频。
+Project-URL: Homepage, https://github.com/70v-Yoyo/md2video-audio-skill
+Project-URL: Bug-Tracker, https://github.com/70v-Yoyo/md2video-audio-skill
+Project-URL: Repository, https://github.com/70v-Yoyo/md2video-audio-skill
+Author: 70v-Yoyo
+License: Apache-2.0
+License-File: LICENSE
+Keywords: ai-agent,claude-code,markdown-to-video,mcp,text-to-speech,video-generation
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Video :: Conversion
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+[![Downloads](https://static.pepy.tech/badge/md2video-audio-skill)](https://pepy.tech/projects/md2video-audio-skill)  [![README Views](https://visitor-badge.laobi.icu/badge?page_id=70v-Yoyo.md2video-audio-skill&left_text=README%20Views)](https://github.com/70v-Yoyo/md2video-audio-skill) [![License](https://img.shields.io/github/license/70v-Yoyo/md2video-audio-skill?style=flat-square)](https://github.com/70v-Yoyo/md2video-audio-skill/blob/main/LICENSE) 
+
+---
+
+能被你 `git clone` 或是阅读，是作为作者最开心的事！如果它解决了你的问题，不妨点亮右上角的小星星，不仅防止找不到仓库，还能动态推送追更哦。
+
+💖 **用一个免费的 ⭐ Star 帮我加速吧！Thank You !** 
+
+---
+
+# md2video-audio-skill
+
+One Markdown file + a one-click command = professional-grade talking-head videos. ｜ 一个 Markdown 文件 + 一键命令 = 专业级口播视频。
+
+- ✨ `/md2video-audio` 是什么神仙技能？
+
+这是一个**完全免费**的 Markdown 转视频技能，能把你的 `.md` 文件直接编译成带真人配音的 MP4 视频：
+
+```
+Markdown 文档 → Marp 幻灯片 + Edge-TTS 配音 → 成品 MP4
+```
+
+- 🔥 核心亮点
+
+| 特性           | 说明                                      |
+| -------------- | ----------------------------------------- |
+| 💰 **零成本**   | 不用 OpenAI、不用阿里云、不用任何付费 API |
+| 🎙️ **真人配音** | 微软 Edge-TTS 音色，自然到以为是真人录的  |
+| 🖼️ **自动配图** | Marp 渲染精美幻灯片作为讲解画面           |
+| ⚡ **一键生成** | 一条命令搞定全部流程                      |
+| **标准输出**   | 直接产出可上传抖音/B 站/YouTube 的 MP4    |
+
+---
+
+## 🚀 怎么用？超简单！
+
+```bash
+#安装方法
+#1 npx安装
+npx skills add https://www.modelscope.cn/skills/nihaoModelscope/md2video-audio-skill
+#2 SDK安装
+pip install --upgrade modelscope
+modelscope skills add nihaoModelscope/md2video-audio-skill
+#3 bash安装
+curl -fsSL https://www.modelscope.cn/skills/install.sh | bash -s -- nihaoModelscope/md2video-audio-skill
+
+#使用方法
+# 在 Claude Code 里输入： 其他agent也可轻松适配
+/md2video-audio your-presentation.md
+```
+
+就这样。没有复杂配置，没有 API 密钥，没有第三方依赖。
+
+----
+
+- 适合什么场景？
+
+-  **知识分享**：技术教程、读书笔记、概念讲解
+-  💼 **工作汇报**：项目复盘、数据分析、进度同步  
+-  **在线课程**：课件转视频、微课制作
+-  📢 **营销内容**：产品介绍、功能演示、活动预告
+-  **个人 IP**：日更视频、观点输出、经验总结
+
+---
+
+- 💡 为什么推荐它？
+
+1. **真的免费** —— 很多类似工具最后都要你买积分、充会员，这个是纯本地方案
+2. **质量靠谱** —— 目前最自然的中文 TTS 免费配音
+3. **门槛极低** —— 会写 Markdown 就会用，不用学 Premiere
+4. **可控性强** —— 文案改 MD 就行，不用重新录制
+
+-----
+
+
+
+# md2video-audio-skill- EN
+
+One Markdown file + a one-click command = professional-grade talking-head videos.
+
+✨ What kind of magical skill is `/md2video-audio`?
+
+This is a completely free Markdown-to-video skill that directly compiles your `.md` files into MP4 videos with realistic human-like voiceovers:
+
+Markdown Document → Marp Slides + Edge-TTS Voice → Finished MP4
+
+🔥 Core Highlights
+
+| **Feature**              | **Description**                                              |
+| ------------------------ | ------------------------------------------------------------ |
+| 💰 Zero Cost              | No OpenAI, no Alibaba Cloud, no paid APIs required.          |
+| 🎙️ Realistic Voiceover    | Powered by Microsoft Edge-TTS voice, so natural it sounds like a real person. |
+| 🖼️ Auto-Generated Visuals | Uses Marp to render stunning slides as presentation visuals. |
+| ⚡ One-Click Generation   | Complete the entire workflow with a single command.          |
+| 📦 Standard Output        | Directly produces MP4 videos ready to upload to TikTok, Bilibili, or YouTube. |
+
+🚀 How to use? Super simple!
+
+- Installation Methods
+
+1. npx installation
+
+`npx skills add https://www.modelscope.cn/skills/nihaoModelscope/md2video-audio-skill`
+
+2. SDK installation
+
+`pip install --upgrade modelscope modelscope skills add nihaoModelscope/md2video-audio-skill`
+
+3. bash installation
+
+`curl -fsSL https://www.modelscope.cn/skills/install.sh | bash -s -- nihaoModelscope/md2video-audio-skill`
+
+## Usage
+
+- Type in Claude Code (easily adaptable for other agents):
+
+`/md2video-audio your-presentation.md`
+
+That's it. No complicated setup, no API keys, no third-party dependencies.
+
+- Suitable Scenarios?
+
+  - Knowledge Sharing: Tech tutorials, reading notes, concept explanations
+
+  - 💼 Work Reports: Project reviews, data analysis, progress updates
+
+  - Online Courses: Slide-to-video conversion, micro-lesson production
+
+  - 📢 Marketing Content: Product introductions, feature demos, event announcements
+
+  - Personal Branding: Daily video updates, opinion publishing, experience summaries
+
+- 💡 Why recommend it?
+
+  - Truly Free: Many similar tools eventually require buying credits or memberships; this is a purely local solution.
+
+  - Reliable Quality: free and  natural TTS options available.
+
+  - Extremely Low Barrier: If you can write Markdown, you can use it—no Premiere required.
+
+  - High Controllability: Just edit the Markdown text to make changes, no need to re-record.
+
+---
+
+# Attribution
+
+Based on [md2video-audio-skill](https://github.com/70v-Yoyo/md2video-audio-skill) by 70v-Yoyo.
+
+Derivative works and redistributions must retain attribution to 70v-Yoyo and include the original repository address.

md2video_audio_skill-1.0.0/README.md

@@ -0,0 +1,149 @@
+[![Downloads](https://static.pepy.tech/badge/md2video-audio-skill)](https://pepy.tech/projects/md2video-audio-skill)  [![README Views](https://visitor-badge.laobi.icu/badge?page_id=70v-Yoyo.md2video-audio-skill&left_text=README%20Views)](https://github.com/70v-Yoyo/md2video-audio-skill) [![License](https://img.shields.io/github/license/70v-Yoyo/md2video-audio-skill?style=flat-square)](https://github.com/70v-Yoyo/md2video-audio-skill/blob/main/LICENSE) 
+
+---
+
+能被你 `git clone` 或是阅读，是作为作者最开心的事！如果它解决了你的问题，不妨点亮右上角的小星星，不仅防止找不到仓库，还能动态推送追更哦。
+
+💖 **用一个免费的 ⭐ Star 帮我加速吧！Thank You !** 
+
+---
+
+# md2video-audio-skill
+
+One Markdown file + a one-click command = professional-grade talking-head videos. ｜ 一个 Markdown 文件 + 一键命令 = 专业级口播视频。
+
+- ✨ `/md2video-audio` 是什么神仙技能？
+
+这是一个**完全免费**的 Markdown 转视频技能，能把你的 `.md` 文件直接编译成带真人配音的 MP4 视频：
+
+```
+Markdown 文档 → Marp 幻灯片 + Edge-TTS 配音 → 成品 MP4
+```
+
+- 🔥 核心亮点
+
+| 特性           | 说明                                      |
+| -------------- | ----------------------------------------- |
+| 💰 **零成本**   | 不用 OpenAI、不用阿里云、不用任何付费 API |
+| 🎙️ **真人配音** | 微软 Edge-TTS 音色，自然到以为是真人录的  |
+| 🖼️ **自动配图** | Marp 渲染精美幻灯片作为讲解画面           |
+| ⚡ **一键生成** | 一条命令搞定全部流程                      |
+| **标准输出**   | 直接产出可上传抖音/B 站/YouTube 的 MP4    |
+
+---
+
+## 🚀 怎么用？超简单！
+
+```bash
+#安装方法
+#1 npx安装
+npx skills add https://www.modelscope.cn/skills/nihaoModelscope/md2video-audio-skill
+#2 SDK安装
+pip install --upgrade modelscope
+modelscope skills add nihaoModelscope/md2video-audio-skill
+#3 bash安装
+curl -fsSL https://www.modelscope.cn/skills/install.sh | bash -s -- nihaoModelscope/md2video-audio-skill
+
+#使用方法
+# 在 Claude Code 里输入： 其他agent也可轻松适配
+/md2video-audio your-presentation.md
+```
+
+就这样。没有复杂配置，没有 API 密钥，没有第三方依赖。
+
+----
+
+- 适合什么场景？
+
+-  **知识分享**：技术教程、读书笔记、概念讲解
+-  💼 **工作汇报**：项目复盘、数据分析、进度同步  
+-  **在线课程**：课件转视频、微课制作
+-  📢 **营销内容**：产品介绍、功能演示、活动预告
+-  **个人 IP**：日更视频、观点输出、经验总结
+
+---
+
+- 💡 为什么推荐它？
+
+1. **真的免费** —— 很多类似工具最后都要你买积分、充会员，这个是纯本地方案
+2. **质量靠谱** —— 目前最自然的中文 TTS 免费配音
+3. **门槛极低** —— 会写 Markdown 就会用，不用学 Premiere
+4. **可控性强** —— 文案改 MD 就行，不用重新录制
+
+-----
+
+
+
+# md2video-audio-skill- EN
+
+One Markdown file + a one-click command = professional-grade talking-head videos.
+
+✨ What kind of magical skill is `/md2video-audio`?
+
+This is a completely free Markdown-to-video skill that directly compiles your `.md` files into MP4 videos with realistic human-like voiceovers:
+
+Markdown Document → Marp Slides + Edge-TTS Voice → Finished MP4
+
+🔥 Core Highlights
+
+| **Feature**              | **Description**                                              |
+| ------------------------ | ------------------------------------------------------------ |
+| 💰 Zero Cost              | No OpenAI, no Alibaba Cloud, no paid APIs required.          |
+| 🎙️ Realistic Voiceover    | Powered by Microsoft Edge-TTS voice, so natural it sounds like a real person. |
+| 🖼️ Auto-Generated Visuals | Uses Marp to render stunning slides as presentation visuals. |
+| ⚡ One-Click Generation   | Complete the entire workflow with a single command.          |
+| 📦 Standard Output        | Directly produces MP4 videos ready to upload to TikTok, Bilibili, or YouTube. |
+
+🚀 How to use? Super simple!
+
+- Installation Methods
+
+1. npx installation
+
+`npx skills add https://www.modelscope.cn/skills/nihaoModelscope/md2video-audio-skill`
+
+2. SDK installation
+
+`pip install --upgrade modelscope modelscope skills add nihaoModelscope/md2video-audio-skill`
+
+3. bash installation
+
+`curl -fsSL https://www.modelscope.cn/skills/install.sh | bash -s -- nihaoModelscope/md2video-audio-skill`
+
+## Usage
+
+- Type in Claude Code (easily adaptable for other agents):
+
+`/md2video-audio your-presentation.md`
+
+That's it. No complicated setup, no API keys, no third-party dependencies.
+
+- Suitable Scenarios?
+
+  - Knowledge Sharing: Tech tutorials, reading notes, concept explanations
+
+  - 💼 Work Reports: Project reviews, data analysis, progress updates
+
+  - Online Courses: Slide-to-video conversion, micro-lesson production
+
+  - 📢 Marketing Content: Product introductions, feature demos, event announcements
+
+  - Personal Branding: Daily video updates, opinion publishing, experience summaries
+
+- 💡 Why recommend it?
+
+  - Truly Free: Many similar tools eventually require buying credits or memberships; this is a purely local solution.
+
+  - Reliable Quality: free and  natural TTS options available.
+
+  - Extremely Low Barrier: If you can write Markdown, you can use it—no Premiere required.
+
+  - High Controllability: Just edit the Markdown text to make changes, no need to re-record.
+
+---
+
+# Attribution
+
+Based on [md2video-audio-skill](https://github.com/70v-Yoyo/md2video-audio-skill) by 70v-Yoyo.
+
+Derivative works and redistributions must retain attribution to 70v-Yoyo and include the original repository address.

md2video_audio_skill-1.0.0/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: md2video-audio
+description: 将指定Markdown文件一键转换为带免费真人配音和讲解画面的 MP4 视频。零成本。当用户要求把 markdown 转成视频、制作口播视频或音视频合成时自动触发。
+---
+
+# Markdown 免费口播视频生成技能 (md2video-audio)
+
+- 作用：将本地Markdown 文件自动转化为包含画面与免费语音的 MP4 视频。
+
+## 1. 全局核心铁律 (Core Rules)
+
+**必须严格遵守以下原则，任何情况下不得违背：**
+
+- **原则一**：**不改原稿**，依次按步骤串行，从原稿到排版与优化稿到展示稿到口播稿，前项生成后项，最终输出视频。
+- **原则二**：严禁擅自安装删除依赖、删除文件、调用脚本及交互输入，不确定时必须向用户确认。
+
+## 2. 串行工作流 (Core Workflow)
+
+- 本任务为严格的串行工作流，共分为以下几个阶段。你必须**按顺序推进**，在当前阶段未完成或未通过校验前，**严禁跳跃到后续阶段**。
+
+### 1. 环境依赖检查与安装
+
+对应子文件`references/enviroment.md`
+
+### 2. 生成优化稿
+
+- 不改原文件。
+- 操作对象：保存成`new-原名前缀-时间戳`的新md文件
+- 原稿原文内容文字和逻辑不动，只做必要分段分块、增加彩色、前后增加自然引导过渡语。对应子文件`references/newscript.md`
+
+### 3. 生成展示稿
+
+- 操作对象：保存成`show-原名前缀-时间戳`的新md文件。
+- 将上个步骤得到的md文件`new-原名前缀-时间戳`拆分为逻辑自然的展示稿，要求:
+    1. Markdown 文件最顶部加上几行配置。这里暂停询问用户要用哪种Marp风格展示，以及是否加入`allowHtml: true`，如果选默认风格见``references/showscript.md`。
+    2. 将HTML标签尽可能都转换为markdown形式表示，如`<img>`转换为`![]()`而里面参数不变
+    3. 根据语义逻辑、md段落结构，用 `---` 分隔每页 PPT。
+- 检查展示稿每页是否符合内容分页规则（如下3条）：
+    1. 判断单页内容是否超出页面安全容量（为marp单页高度的85%）：展示稿每页内容按不同样式统计行数，结合顶部YAML Front Matter里的style得到不同样式每行内容所占高度，动态估算。如果超过安全容量边界内，则拆分为几个逻辑小单元各占1页（保证每页内容都不超页面安全容量且布局排版好看情况下，数量应尽可能少）
+    2. 判断单块内容所占高度是否超350px：可拆分的（如表格、代码块）将其内部按接近于350px且逻辑自然拆分成多个块。
+    3. 当代码一行过长时按逻辑自然插入换行
+- 检查通过则进入下一阶段，否则根据要求修改不通过地方，直到检查通过。若修改3次仍不通过，则提示用户手动修改后再继续。
+
+### 4. 生成口播稿
+
+- 操作对象：保存成`speaking-原名前缀-时间戳`的新md文件
+- 根据展示稿，生成逻辑自然的口播稿：
+    1. 口播稿最开头第一行先加上两个 `---`，换行再写第一页的口播。
+    2. 去掉除分隔符外的乱七八糟的表情图标等仅供展示的念出来不自然的字符。
+- 检查口播稿和展示稿的 `---` 页分隔符数量必须保持一致：正则表达式执行`grep -E '^---[[:space:]]*$' your_file.md | wc -l`。若数量对不上，修改口播稿，每页内容对齐展示稿，一般是在口播稿最开头加入。检查通过则进入下一阶段，否则根据要求修改不通过地方，直到检查通过。若修改3次仍不通过，则提示用户手动修改后再继续。
+
+### 5. 用Python 脚本一键打包成视频
+
+- 用上述阶段中生成的2个中间结果md文件，分别是口播稿和展示稿作为输入，调用执行本skill目录下名为`ai-2md2marp2av.py`，`python ai-2md2marp2av.py 展示稿.md 口播稿.md`。注意脚本中有交互输入，必须让用户手动输入。
+- 脚本逻辑为用 Marp 生成的高颜值 PPT 图片后，把图片和 Edge-TTS 生成的语音按对应页数拼起来即可。
+
+### 6. 降级方案
+
+- 若生成视频失败，则调用降级方案：执行本skill目录下名为`md2marp2av.py`脚本。若仍失败则执行本skill目录下名为`md2video.py`脚本

md2video_audio_skill-1.0.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "md2video-audio-skill"
+version = "1.0.0"
+description = "One Markdown file + a one-click command = professional-grade talking-head videos. ｜ 一个 Markdown 文件 + 一键命令 = 专业级口播视频。"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "Apache-2.0" }
+authors = [
+    { name = "70v-Yoyo" }
+]
+keywords = [
+    "ai-agent",
+    "mcp",
+    "claude-code",
+    "markdown-to-video",
+    "text-to-speech",
+    "video-generation"
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Multimedia :: Video :: Conversion",
+]
+
+[project.urls]
+Homepage = "https://github.com/70v-Yoyo/md2video-audio-skill"
+Bug-Tracker = "https://github.com/70v-Yoyo/md2video-audio-skill"
+Repository = "https://github.com/70v-Yoyo/md2video-audio-skill"
+
+[tool.hatch.build.targets.wheel]
+# 强行让 PyPI 打包当前目录下的所有核心文件，确保 scripts、SKILL.md 和所有 .md 笔记不被过滤
+packages = ["."]
+
+[project.scripts]
+md2video = "scripts.ai_2md2marp2av:main"

md2video_audio_skill-1.0.0/references/enviroment.md

@@ -0,0 +1,20 @@
+- 检查是否具备相关依赖，若缺失则请求安装：
+
+```bash
+pip install edge-tts moviepy markdown
+
+#安装一整套完美对齐、针对 Mermaid 优化的新一代测试版全家桶
+npm install @marp-team/marp-cli@latest \
+  @marp-team/marp-core@next \
+  shiki \
+  beautiful-mermaid \
+  katex \
+  @mathjax/src \
+  @mathjax/mathjax-bbm-font-extension \
+  @mathjax/mathjax-bboldx-font-extension \
+  @mathjax/mathjax-dsfont-font-extension \
+  @mathjax/mathjax-mhchem-font-extension
+
+```
+
+(注：若系统提示缺少 ffmpeg，需引导或自动通过 `apt-get install -y ffmpeg` 进行安装)

md2video_audio_skill-1.0.0/references/newscript.md

@@ -0,0 +1,5 @@
+- 语义审阅与排版优化：检查该文件是否用markdown结构化符号按逻辑分段。如果不满足则 **逻辑分段与排版优化**
+    - 检查并补全文章的层级标题（确保有 `#` 和 `##` 等作为自然的视觉分镜切换点），每个自然逻辑段用单独行`---`划分
+- 内容优化：
+    1. 合适位置自然放置彩色表情/图标（如emoji）但要保证系统兼容性、HTML能正常渲染出来。
+    2. 代码块里：一行过长按逻辑换行、行数>8则按逻辑拆分成多个行数<8的代码块。代码块外前后补充自然过渡引导语。md文件里正常写mermaid没有报错则不用动它。

md2video_audio_skill-1.0.0/references/showscript.md

@@ -0,0 +1,103 @@
+````markdown
+---
+marp: true
+theme: gaia
+_class: default
+paginate: true
+allowHtml: true
+mermaid: true
+style: |
+  section {
+    /* ===== 全局基准 ===== 
+    YAML block scalar（style: |）禁止用 Tab 做缩进
+    */
+    font-size: 25px;
+    line-height: 1.4;
+    /* ===== 页面布局 ===== */
+    grid-template-columns: 88%; 
+    margin: 0 auto;
+    padding: 20px;
+    display: grid;
+    align-content: center;
+    justify-content: center; /* 水平居中 */
+  }
+    /* ===== 代码块 ===== */
+  pre {
+    font-size: 1em;
+    line-height: 1.35;
+    margin: 0.5em 0;
+    /* 关键：允许内部代码在达到 max-width 时自动换行 */
+  	white-space: pre-wrap !important; 
+ 		word-break: break-word;
+  }
+
+  pre code {
+    font-size: 1em;
+    white-space: pre-wrap !important; /* 允许在长单词、长行内自动换行 */
+  	word-break: break-all;
+  }
+
+  /* ===== 标题体系 ===== */
+  h1 {
+    font-size: 1.8em;
+    line-height: 1.15;
+    margin: 0 0 0.5em;
+  }
+  h2 {
+    font-size: 1.4em;
+    line-height: 1.2;
+    margin: 0 0 0.4em;
+  }
+  h3 {
+    font-size: 1.2em;
+    line-height: 1.25;
+    margin: 0 0 0.3em;
+  }
+  
+  /* ===== 正文体系 ===== */
+  p {
+    margin: 0.5em;
+  }
+  ul,
+  ol {
+    margin-top: 0.3em;
+    margin-bottom: 0.3em;
+  }
+  li {
+    margin-bottom: 0.25em;
+  }
+  
+  /* ===== 图片 ===== */
+  img {
+    margin:0.1em auto;
+  }
+  img[alt="mylogo"] {
+    display:block;
+    width: 130px ;
+    height:130px ;
+    border-radius: 50%;
+    object-fit: contain;
+  }
+---
+
+# 核心架构解析
+
+## hi
+
+---
+
+## 章节一：背景介绍
+
+- 向量检索与索引平衡
+    - HNSW 索引平衡速度和精度
+    - IVF_PQ 算法加速
+
+---
+
+## 章节二：核心代码示例
+
+```python
+def hello():
+    print("hi")
+```
+````

md2video_audio_skill-1.0.0/scripts/ai_2md2marp2av.py

@@ -0,0 +1,194 @@
+import os
+import asyncio
+import re
+from datetime import datetime
+import edge_tts
+from moviepy import ImageClip, AudioFileClip, concatenate_videoclips
+import time
+import random
+from aiohttp.client_exceptions import ClientConnectorError
+import webbrowser
+
+VOICE = "zh-CN-YunxiNeural" #女声"zh-CN-XiaoxiaoNeural"
+FPS = 24
+
+async def generate_audio(text, output_path):
+    communicate = edge_tts.Communicate(text, VOICE)
+    await communicate.save(output_path)
+
+def build_video_from_files(slide_md_path, script_md_path):
+    if not os.path.exists(slide_md_path):
+        raise FileNotFoundError(f"找不到画面 Markdown 文件: {slide_md_path}")
+    if not os.path.exists(script_md_path):
+        raise FileNotFoundError(f"找不到口播稿文件: {script_md_path}")
+    
+    # 获取输出路径（基于画面 md 所在的目录和名称）
+    dir_name = os.path.dirname(slide_md_path)
+    base_name = os.path.splitext(os.path.basename(slide_md_path))[0]
+    
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    output_mp4 = os.path.join(dir_name, f"{base_name}_{timestamp}.mp4") if dir_name else f"{base_name}_{timestamp}.mp4"
+
+    # ============================================================
+    # 1. 先导出 HTML，方便检查 Marp 最终生成的 HTML/CSS
+    # ============================================================
+    print(f"1. 正在调用 Marp 将 Markdown [{slide_md_path}] 导出为 HTML...")
+
+    html_path = os.path.join(
+        dir_name if dir_name else ".",
+        f"{base_name}_preview_{timestamp}.html"
+    )
+
+    with open(slide_md_path, "r", encoding="utf-8") as f:
+        content = f.read()
+    print(content[:3000])
+
+    html_cmd = (
+        f'marp --engine @marp-team/marp-core/full '
+        f'--allow-local-files '
+        f'--html '
+        f'-o "{html_path}" '
+        f'"{slide_md_path}"'
+    )
+
+    exit_code = os.system(html_cmd)
+
+    if exit_code != 0:
+        print("错误: Marp HTML 导出失败，请检查 marp-cli 是否正常安装。")
+        return
+
+    print(f"HTML 预览文件已生成：{html_path}")
+
+    # ============================================================
+    # 2. 自动打开 HTML
+    # ============================================================
+    print("2. 正在打开 HTML 预览...")
+    html_abs_path = os.path.abspath(html_path)
+    webbrowser.open(f"file://{html_abs_path}")
+
+    # ============================================================
+    # 3. 等待用户确认
+    # ============================================================
+    while True:
+        confirm = input(
+            "\n请检查浏览器中的 HTML 预览。\n"
+            "确认无误，请输入 ok 继续导出图片：\n" \
+            "如果不导出图片，请输入 no 终止程序：\n"
+        ).strip().lower()
+
+        if confirm == "ok":
+            break
+        elif confirm == "no":
+            print("用户选择不导出图片，程序终止。")
+            return
+        else:
+            print("输入无效，请重新输入。")
+
+    # ============================================================
+    # 4. 用户确认后，再导出 PNG
+    # ============================================================
+
+    print(f"1. 正在调用 Marp 将画面 Markdown [{slide_md_path}] 渲染为 PPT 高清图片...")
+    # 核心：让 Marp 针对画面 md 生成图片
+    exit_code = os.system(f"npx marp --engine @marp-team/marp-core/full --allow-local-files --html --images png --image-scale 2 {slide_md_path}")
+
+    if exit_code != 0:
+        print("错误: Marp 渲染失败，请检查是否安装了 marp-cli 及谷歌浏览器内核。")
+        return
+    
+    # 去画面 md 所在的目录下精准搜寻生成的 .png 图片
+    target_dir = dir_name if dir_name else "."
+    all_files = os.listdir(target_dir)
+    
+    slide_images = sorted([
+        os.path.join(target_dir, f) for f in all_files 
+        if f.startswith(base_name) and f.endswith(".png")
+    ])
+
+    if not slide_images:
+        print(f"错误: 在目录 '{target_dir}' 下未找到 Marp 生成的幻灯片图片！")
+        return      
+
+    print(f"成功生成 {len(slide_images)} 页幻灯片画面。")
+
+    # 2. 读取独立的【AI口播稿文件】
+    with open(script_md_path, "r", encoding="utf-8") as f:
+        script_content = f.read()
+    
+    # 假设口播稿也是按 --- 分割成对应的页数段落
+    script_content_body = re.sub(r'^---[\s\S]*?---', '', script_content)
+    speech_sections = [s.strip() for s in script_content_body.split("---") if s.strip()]
+
+    clip_list = []
+    temp_audio_files = []
+
+    print("3. 正在读取独立口播稿，为每一页生成对应的 AI 语音并对齐画面...")
+    # 按页数进行 zip 匹配（有多少张 PPT 图片就处理多少段口播）
+    for i, img_file in enumerate(slide_images):
+        page_num = i + 1
+        print(f"正在处理第 {page_num}/{len(slide_images)} 页...")
+
+        # 优先使用口播稿中对应的段落，如果口播稿段落不够则用默认提示
+        if i < len(speech_sections):
+            raw_speech = speech_sections[i]
+        else:
+            raw_speech = f"这是第 {page_num} 部分的内容。"
+
+        # 清理口播稿中的 markdown 标记，让朗读更自然
+        speech_clean = re.sub(r'#+|\*\*|\*|`|```[\s\S]*?```|<[^>]+>', '', raw_speech).strip()
+        if not speech_clean:
+            speech_clean = f"请看屏幕上的第 {page_num} 页展示。"
+
+        audio_path = os.path.join(target_dir, f"temp_audio_{base_name}_{page_num}.mp3")
+        temp_audio_files.append(audio_path)
+        
+        max_retries = 10  # 最大重试次数
+        for attempt in range(max_retries):
+            try:
+                # 执行原本的生成命令
+                asyncio.run(generate_audio(speech_clean, audio_path))
+                
+                # 💡 成功后，随机冷却 2~4 秒，防止连续请求被微软识别为爬虫
+                time.sleep(random.uniform(2.0, 4.0))
+                break  # 成功生成，跳出重试循环
+                
+            except (ClientConnectorError, ConnectionResetError) as e:
+                if attempt < max_retries - 1:
+                    # 💡 失败后，成倍延长等待时间（指数退避策略），等待 10s, 20s, 30s...
+                    wait_time = (attempt + 1) * 10
+                    print(f"⚠️ 微软限流或网络断连，将在 {wait_time} 秒后进行第 {attempt + 1} 次重试...")
+                    time.sleep(wait_time)
+                else:
+                    print("❌ 连续多次重试失败，请检查代理网络。")
+                    raise e
+
+
+        audio_clip = AudioFileClip(audio_path)
+        duration = max(audio_clip.duration, 2.5) # 每页至少停留 2.5 秒
+
+        # 用标准高颜值图片生成视频片段
+        image_clip = ImageClip(img_file).with_duration(duration)
+        image_clip = image_clip.with_audio(audio_clip)
+        clip_list.append(image_clip)
+
+    print("4. 正在无缝拼接最终视频...")
+    final_video = concatenate_videoclips(clip_list)
+    final_video.write_videofile(output_mp4, fps=FPS, codec="libx264", audio_codec="aac")
+
+    # 清理临时文件（音频及图片）
+    print("正在清理临时文件...")
+    for f in temp_audio_files:
+        if os.path.exists(f): os.remove(f)
+    for f in slide_images:
+        if os.path.exists(f): os.remove(f)
+
+    print(f"🎉 完美！使用独立画面与独立口播稿合成的视频已生成: {output_mp4}")
+
+if __name__ == "__main__":
+    import sys
+    # 接收两个参数：第一个是画面 md，第二个是口播稿 md
+    # 例如：python marp_to_video.py slide.md script.md
+    slide_file = sys.argv[1] if len(sys.argv) > 1 else "slide.md"
+    script_file = sys.argv[2] if len(sys.argv) > 2 else "script.md"
+    
+    build_video_from_files(slide_file, script_file)

md2video_audio_skill-1.0.0/scripts/md2marp2av.py

@@ -0,0 +1,102 @@
+import os
+import asyncio
+import re
+from datetime import datetime
+import edge_tts
+from moviepy import ImageClip, AudioFileClip, concatenate_videoclips
+
+# Marp 渲染需要无头 Chromium。本机 chromium 在 /usr/bin/chromium，
+# 通过 CHROME_PATH 显式指定给 marp-cli（避免其自行探测失败）。
+os.environ.setdefault("CHROME_PATH", "/usr/bin/chromium")
+
+VOICE = "zh-CN-XiaoxiaoNeural"
+FPS = 24
+
+async def generate_audio(text, output_path):
+    communicate = edge_tts.Communicate(text, VOICE)
+    await communicate.save(output_path)
+
+def build_video_from_marp_images(md_file_path):
+    if not os.path.exists(md_file_path):
+        raise FileNotFoundError(f"找不到文件: {md_file_path}")
+    
+    # 获取输入 md 的绝对或相对路径信息
+    dir_name = os.path.dirname(md_file_path)
+    base_name = os.path.splitext(os.path.basename(md_file_path))[0]
+    
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    output_mp4 = os.path.join(dir_name, f"{base_name}_{timestamp}.mp4") if dir_name else f"{base_name}_{timestamp}.mp4"
+
+    print("1. 正在调用 Marp 将 Markdown 渲染为 PPT 高清图片...")
+    # --images png 会把每一页切成独立的高清 PNG 图片
+    exit_code = os.system(f"marp '{md_file_path}' --images png")
+    if exit_code != 0:
+        print("错误: Marp 渲染失败，请检查是否安装了 marp-cli 及谷歌浏览器内核。")
+        return
+    
+    # 去 md 所在的目录下精准搜寻生成的 .png 图片
+    target_dir = dir_name if dir_name else "."
+    all_files = os.listdir(target_dir)
+    
+    # 筛选出以该 markdown 文件名为前缀且以 .png 结尾的图片
+    slide_images = sorted([
+        os.path.join(target_dir, f) for f in all_files 
+        if f.startswith(base_name) and f.endswith(".png")
+    ])
+
+    if not slide_images:
+        print(f"错误: 在目录 '{target_dir}' 下未找到 Marp 生成的幻灯片图片！")
+        return      
+
+    print(f"成功生成 {len(slide_images)} 页幻灯片画面。")
+
+    # 简单提取每一页的文字用于生成对应语音（这里读取 md 按 --- 分割）
+    with open(md_file_path, "r", encoding="utf-8") as f:
+        content = f.read()
+    
+    # 过滤掉 frontmatter
+    content_body = re.sub(r'^---[\s\S]*?---', '', content)
+    slides_text = [s.strip() for s in content_body.split("---") if s.strip()]
+
+    clip_list = []
+    temp_audio_files = []
+
+    print("2. 正在为每一页生成对应的 AI 口播语音并对齐画面...")
+    for i, img_file in enumerate(slide_images):
+        page_num = i + 1
+        print(f"正在处理第 {page_num}/{len(slide_images)} 页...")
+
+        # 获取当前页对应的文本，如果没有配对文字则用默认提示
+        raw_text = slides_text[i] if i < len(slides_text) else f"这是第 {page_num} 页"
+        speech_clean = re.sub(r'#+|\*\*|\*|`|```[\s\S]*?```|<[^>]+>', '', raw_text)
+        speech_text = f"接下来我们看第 {page_num} 部分。{speech_clean}".strip()
+
+        audio_path = f"temp_audio_{page_num}.mp3"
+        temp_audio_files.append(audio_path)
+        
+        asyncio.run(generate_audio(speech_text, audio_path))
+
+        audio_clip = AudioFileClip(audio_path)
+        duration = max(audio_clip.duration, 2.5) # 每页至少停留 2.5 秒
+
+        # 用标准高颜值图片生成视频片段
+        image_clip = ImageClip(img_file).with_duration(duration)
+        image_clip = image_clip.with_audio(audio_clip)
+        clip_list.append(image_clip)
+
+    print("3. 正在无缝拼接最终视频...")
+    final_video = concatenate_videoclips(clip_list)
+    final_video.write_videofile(output_mp4, fps=FPS, codec="libx264", audio_codec="aac")
+
+    # 清理临时文件（音频及图片）
+    for f in temp_audio_files:
+        if os.path.exists(f): os.remove(f)
+    for f in slide_images:
+        if os.path.exists(f): os.remove(f)
+
+    print(f"🎉 完美！高级 PPT 风格视频已生成: {output_mp4}")
+
+if __name__ == "__main__":
+    import sys
+    target_md = sys.argv[1] if len(sys.argv) > 1 else "processed_input.md"
+    build_video_from_marp_images(target_md)

md2video_audio_skill-1.0.0/scripts/md2video.py

@@ -0,0 +1,195 @@
+import asyncio
+import os
+import re
+from datetime import datetime
+import edge_tts
+from moviepy import TextClip, AudioFileClip, CompositeVideoClip, ColorClip, concatenate_videoclips
+
+VOICE = "zh-CN-XiaoxiaoNeural"  
+WIDTH, HEIGHT = 1280, 720
+FPS = 24
+
+def sanitize_text_for_display(text):
+    """
+    清洗文本：
+    1. 将 <br> / <br/> 转换为真实的换行符 \n
+    2. 移除其他 HTML 标签（如 <b>, </span> 等）
+    3. 过滤掉会导致中文字体渲染出方块叉的 Emoji 及特殊符号（已修正原始字符串与十六进制范围）
+    """
+    if not text:
+        return ""
+    
+    # 1. 智能转换 HTML 换行标签为真实换行
+    text = re.sub(r'<br\s*/?>', '\n', text, flags=re.IGNORECASE)
+    
+    # 2. 移除其他常见的 HTML 标签
+    text = re.sub(r'</?[a-zA-Z]+[^>]*>', '', text)
+    
+    # 3. 过滤 Emoji 和特殊符号区块（注意前面加了 r 变成原始字符串，防止转义报错）
+    emoji_pattern = re.compile(
+        r"["
+        r"\U0001f000-\U0001faf9"  
+        r"\U0001f300-\U0001f5ff"
+        r"\U0001f600-\U0001f64f"
+        r"\U0001f680-\U0001f6ff"
+        r"\U0001f900-\U0001f9ff"
+        r"\u2600-\u26ff"          
+        r"\u2700-\u27bf"          
+        r"]+", flags=re.UNICODE
+    )
+    cleaned = emoji_pattern.sub('', text)
+    
+    # 清理多余的水平空格，但保留换行符 \n
+    cleaned = re.sub(r'[ \t]+', ' ', cleaned)
+    return cleaned.strip()
+
+def parse_markdown_by_chapters(md_file_path):
+    """
+    按 Markdown 章节结构（以 # 或 ## 标题分割）聚合内容。
+    """
+    if not os.path.exists(md_file_path):
+        raise FileNotFoundError(f"找不到文件: {md_file_path}")
+    
+    with open(md_file_path, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    chapters_raw = re.split(r'(?m)^(#+\s+.+)', content)
+    
+    sections = []
+    current_title = "开场简介"
+    current_body = []
+
+    for part in chapters_raw:
+        part = part.strip()
+        if not part:
+            continue
+        if part.startswith('#'):
+            if current_body:
+                sections.append((current_title, "\n".join(current_body)))
+                current_body = []
+            current_title = re.sub(r'#+\s*', '', part).strip()
+        else:
+            current_body.append(part)
+            
+    if current_body or current_title:
+        sections.append((current_title, "\n".join(current_body)))
+
+    if not sections and content.strip():
+        sections.append(("全文概览", content.strip()))
+
+    formatted_sections = []
+    for title, body in sections:
+        # 口播用的文本（去掉 markdown 和 html 标签，保持语气自然）
+        speech_clean = re.sub(r'#+|\*\*|\*|`|```[\s\S]*?```|<[^>]+>', '', body)
+        speech_clean = f"接下来我们讲解：{title}。{speech_clean}".strip()
+        
+        # 画面展示文本：清洗 HTML 标签、Emoji 及特殊符号
+        safe_title = sanitize_text_for_display(title)
+        safe_body = sanitize_text_for_display(body)
+        
+        if speech_clean:
+            formatted_sections.append((speech_clean, safe_title, safe_body))
+            
+    return formatted_sections
+
+async def generate_audio_with_retry(text, output_audio_path, retries=3):
+    for attempt in range(retries):
+        try:
+            communicate = edge_tts.Communicate(text, VOICE)
+            await communicate.save(output_audio_path)
+            if os.path.exists(output_audio_path) and os.path.getsize(output_audio_path) > 0:
+                return True
+        except Exception as e:
+            print(f"  [重试 {attempt+1}/{retries}] 语音生成遇到波动: {e}")
+            await asyncio.sleep(2)
+        await asyncio.sleep(0.5)
+    return False
+
+def create_video_from_md(md_file_path):
+    dir_name = os.path.dirname(md_file_path)
+    base_name = os.path.splitext(os.path.basename(md_file_path))[0]
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    output_mp4 = os.path.join(dir_name, f"{base_name}_{timestamp}.mp4") if dir_name else f"{base_name}_{timestamp}.mp4"
+
+    print("正在按极简 PPT 规范解析并清洗 Markdown（已适配 <br> 标签转换）...")
+    sections = parse_markdown_by_chapters(md_file_path)
+    
+    if not sections:
+        print("未提取到有效内容！")
+        return
+
+    clip_list = []
+    print(f"共划分为 {len(sections)} 个 PPT 页面，开始高质量渲染...")
+
+    for i, (speech_text, title_text, body_text) in enumerate(sections):
+        print(f"正在处理第 {i+1}/{len(sections)} 页 PPT...")
+        temp_audio = f"temp_sec_{i}.mp3"
+        
+        success = asyncio.run(generate_audio_with_retry(speech_text, temp_audio))
+        if not success:
+            print(f"警告: 第 {i+1} 页语音生成失败，跳过。")
+            continue
+            
+        audio_clip = AudioFileClip(temp_audio)
+        duration = max(audio_clip.duration, 2.5) 
+        
+        # 现代极简微乳白/浅灰色底板 (Slate-50: RGB 248, 250, 252)
+        background = ColorClip(size=(WIDTH, HEIGHT), color=(248, 250, 252), duration=duration)
+        
+        clips_on_page = [background]
+
+        try:
+            # 顶部区域：增加左右边距，防止左右截断（两侧各留白 120px，总宽度 1280 - 240 = 1040）
+            title_clip = TextClip(
+                text=title_text if title_text else "核心内容",
+                font="Hiragino Sans GB",
+                font_size=34,
+                color='#1E3A8A',
+                size=(WIDTH - 240, 80),
+                method='caption',
+            ).with_duration(duration).with_position((120, 70))
+            clips_on_page.append(title_clip)
+
+            # 下方区域：同步调整宽度与左边距，确保正文两侧安全
+            body_fontsize = 22 if len(body_text) > 250 else 26
+            body_clip = TextClip(
+                text=body_text if body_text else "（本章节暂无正文内容）",
+                font="Hiragino Sans GB",
+                font_size=body_fontsize,
+                color='#334155',
+                size=(WIDTH - 240, HEIGHT - 220),
+                method='caption',
+            ).with_duration(duration).with_position((120, 165))
+            clips_on_page.append(body_clip)
+
+        except Exception as e:
+            print(f"警告: 页面文字排版失败，降级处理。错误: {e}")
+
+        sub_video = CompositeVideoClip(clips_on_page)
+        sub_video = sub_video.with_audio(audio_clip)
+        clip_list.append(sub_video)
+        
+        import time
+        time.sleep(0.3)
+
+    if not clip_list:
+        print("错误: 没有成功生成任何有效的视频页面！")
+        return
+
+    print("正在合成最终的极简 PPT 风格视频...")
+    final_video = concatenate_videoclips(clip_list)
+    
+    print(f"正在导出最终视频到 {output_mp4}...")
+    final_video.write_videofile(output_mp4, fps=FPS, codec="libx264", audio_codec="aac")
+    
+    for i in range(len(sections)):
+        tmp = f"temp_sec_{i}.mp3"
+        if os.path.exists(tmp):
+            os.remove(tmp)
+            
+    print(f"🎉 极简 PPT 风格口播视频生成成功！已保存至: {output_mp4}")
+
+if __name__ == "__main__":
+    import sys
+    target_md = sys.argv[1] if len(sys.argv) > 1 else "processed_input.md"
+    create_video_from_md(target_md)