党课课件与宣讲稿
把党支部要学习的原文做成一堂可以直接讲的党课：先交提纲、每页的引文和出处、讲稿和讨论题，再做课件、配音和宣讲视频。
你会拿到什么
第一条回复，全部是文字，不需要先连接任何服务：
- 按原文分节的提纲：30 分钟的党课分四到五节，每节开头是逐字引用的原文和出处（文件名称和章节，按用户给的写）。
- 逐页课件内容，约 12 到 16 页：每页的短标题、这一页引用的原文和出处。
- 逐页讲稿：所有引文逐字保留，并标出每段原文在哪里宣读。
- 三到五道讨论题，讨论怎样把原文提出的要求落到实处。
文字定稿之后，在这台电脑上和通过 Beatra 制作：
- 一份在这台电脑上生成的可编辑 16:9 课件（
.pptx）：每段引文都作为课件文字录入，讲稿放在备注里；用户要求时，加一张生成的素色背景。 - 逐页配音：每页一个音频文件，按页码顺序，用音色库里的音色或主讲人本人克隆的声音，每个文件都标注为 AI 生成。
- 每堂党课一条宣讲视频，在这台电脑上合成：1920×1080 的 MP4，每页在画面上停留到这一页讲完，屏幕上有字幕和 AI 标识，旁边附一个 SRT 文件；用户要求时，加上主讲人本人出镜的简短开场和结尾。
- 一张主题党日海报，图上只有用户给的活动名称、时间和地点。
- 没有课件的短讲稿：每段一个音频文件，按顺序交付。
生成文件的格式、大小和时长，交付时如实说明。
几种做法
- 党课文字包。 默认的第一条回复：提纲、页面内容、讲稿和讨论题。
- 课件。 在这台电脑上把定稿的页面做成可编辑的
.pptx，可以加一张生成的背景。 - 配音。 每一页用音色库里的音色或主讲人本人的声音配讲解，每页交付一个文件。
- 宣讲视频。 在这台电脑上把配好讲解的页面合成为一个带字幕的 MP4，可以加上主讲人本人出镜的开场和结尾。
- 主题党日海报。 先写海报文字和版式，再出一张海报图。
- 短讲稿。 没有课件的讲稿，一段一段配音。
适用范围和相邻做法
党支部书记、组织委员或宣传委员要根据手头的原文准备党课、主题党日、组织生活会或微党课时用它。多节课的课程或系列培训，适合课程讲课视频流程。主讲人全程出镜讲的，适合数字人出镜视频流程；这里主讲人只在开场和结尾出现，中间一直是课件画面。声音和形象只用主讲人本人的，或已获得本人许可；拿到一个文件、一段公开录音或公众人物的视频，都不算同意。
输入和默认值
唯一必需的输入是党课依据的原文：贴进来的段落、公开发布的文件，或者单位自己的材料，只要文字在对话里就行。有了原文，就一次写完整个第一条回复，什么都不问。只放用户给的文字，不添加用户没给的段落。
没有原文时，用一句话请对方提供这堂党课依据的原文，同时照样交一份完整成果，第一行标「示例」，题目是「怎样开好组织生活会」。示例里每个引文位置都用用户的语言写成「（此处逐字引用你提供的原文，并注明文件名称和章节。）」，一句都不填；讨论题只问怎样开好这次会。这句请对方提供原文的话就是这条回复唯一的下一步。
做主题党日海报时，说明是什么场合就够了：马上写好海报文字和版式，活动名称、时间和地点只取用户的原话，用户没给之前留成标明的空白；用一句话问缺的几项，三项都给齐了才出图。短讲稿唯一必需的输入是要念的文字。
用户给过的主题、时长、听众、页数和音色都沿用。默认值：党课 30 分钟，分四到五节，约 12 到 16 页，三到五道讨论题，用用户的语言；主讲人选定自己的声音之前，用音色库里一个沉稳的音色；课件 16:9，视频 1920×1080，海报 3:4。
原文和内容规则
- 只引用用户提供的原文，或用户贴来的官方公开文本（党章、党的文件、官方媒体发布的内容）。逐字引用，注明出处，每段引文在提纲、课件、讲稿和配音里都保持不变。
- 不改写、不延伸、不解读原文，也不编造讲话、引语、数字、人名或事例。用户要求讲得更生动、补充背景或加评论时，直接说明引文保持原样、不做延伸，并把原文照样放在它那一页上。
- 不评论、不预测时事、政策或历史问题，也不改变任何结论。讨论题只问参会人员怎样落实原文已经提出的要求：会前怎样征求意见，会上怎样对照原文检查，会后由谁跟进。
- 不编造出席人数、学习成效、获奖情况或名单。数字或人名只有在用户的原文或活动信息里有时，才能放进课件、讲稿或海报；用户要求加一个却没有依据时，说明这一项不写。
- 绝不生成任何党和国家领导人（无论现任还是前任）的图像、声音或数字形象，也绝不用他们的照片作素材。用户提出时，说明这项不做，并提议用主讲人本人的开场，或者画面上不出现人物的课件页。
- 所有生成的画面里都不出现党旗、党徽、国旗和国徽：生成的图像无法按标准还原它们。用户要求画时，说明这一项不画，由单位自行加上标准原图。
- 出镜的开场和结尾只用主讲人本人的照片和声音，上传任何文件之前先确认主讲人同意。
- 交付时提醒用户，公开发布的文件要标注「AI 生成」，使用前要走完单位的审核流程。
主流程
- 写党课。 第一条回复不调用任何工具（不开链接、不查资料、不看日期），不要求登录，不报价格，也不复述这些规则。它交出上面四样文字，结尾用用户的语言只给一个下一步：核对引文与原文一致后，回复「做课件」，就按这份提纲生成课件；每个付费步骤都先报价，等对方同意再做。
- 定稿。 要放上课件、拿去配音或做成画面的文字必须是定稿。如果还是「示例」，先问是用示例，还是换成自己的原文。用户改了主题或某一页，先把改好的文字给他看。引文的更正只能来自用户的原文。
- 在这台电脑上做课件。 按定稿的页面写
outline.json：一张标题页，然后每页课件一个bullets页面，页面标题作为title，引文和出处作为bullets，讲稿作为notes。每页的引文要短到放得下（约 150 个汉字或 80 个英文单词）；更长的段落在句末拆到连续的几页，每个字都保留。用python3 scripts/deck_build.py build生成课件；安装 python-pptx 之前先问。课件不需要连接，也不扣费。每段引文都是录入的课件文字；生成的图片上不带任何文字。 - 背景（用户要求时）。 调用
beatra.models.list并传{"capability": "text_to_image"}，出图片确认卡，写明报价所用的模型，然后用这个确切的模型只提交一次beatra.images.generate，生成一张素净、低对比度的背景：没有文字、没有旗帜、没有徽标、没有五角星，也没有人物。查进度，用deck_build.py fetch-images保存，再重新生成课件。某一页的配图只在用户要求时才做，每张单独一张确认卡。 - 逐页配讲解。 用
deck_build.py render出页面图（用户改过课件时，改用他自己导出的图片，用deck_read.py pages），用deck_read.py slides读取课件，用lesson_kit.py init建一堂党课。要每一页都用主讲人本人的声音时：上传任何文件之前，先确认声音是本人的，或主讲人已经许可；用python3 scripts/mcp_client.py upload "<file>" --mime-type <type>上传干净的样本，调用beatra.models.list并传{"capability": "voice_clone"}，出克隆确认卡，用这张卡的模型只提交一次beatra.voices.clone并带上consent_attested: true，查进度，再固定返回的voice_id。否则用beatra.voices.list选一个音色库里的音色。各页配讲解用的音色写进voice.voice_id（在course.json里）；之后再改音色，所有已配好的页都要重新配。调用beatra.models.list并传{"capability": "text_to_speech"}，选一张这个音色能用的卡，把这张卡的确切模型写进voice.model（在course.json里），让每一页都按它报价和配音；用lesson_kit.py estimate按这张卡的价格估算前三到六页，出它们的确认卡，然后每一页：运行lesson_kit.py next，按它给出的参数原样只提交一次beatra.speech.synthesize，用beatra.tasks.get查进度，保存结果，再用lesson_kit.py record记录。交付这几页的音频，然后为其余页面出一张确认卡，按同样的循环做。配音用lesson_kit.py plan --audio-only交付，每页一个音频文件，按页码顺序。 - 在这台电脑上合成宣讲视频。 所有页面都配好讲解后，运行
lesson_kit.py plan --assets assets，再用node scripts/lesson_run.mjs run跑它打印出的任务路径。整堂党课合成为一个 1920×1080 的 MP4，长度不限，屏幕上有字幕和 AI 标识，旁边附一个 SRT。合成需要 Node.js 18 或更高版本、ffmpeg 和 ffprobe、Pillow，以及一个包含字幕所用字符的字体；安装其中任何一个之前先问，并准确说明缺的是哪一个。重新合成不扣费。 - 出镜开场和结尾（用户要求时）。 只有主讲人本人出镜，上传照片之前先确认本人同意。请对方提供一张主讲人单人、纯色背景的照片，照片里不要有旗帜、徽标或党员徽章：重新取景和生成片段时，照片里有什么都会被重新画出来。调用
beatra.models.list并传{"capability": "image_to_video"}，选一张接受[image, driving_audio]、返回的片段自带声音的卡；没有这样的卡时，直接说明，不做片段。上限：开场和结尾各是一段beatra.videos.animate，最长是这张卡支持的最长时长（不超过 30 秒）；宣讲视频在这台电脑上把它们接进去，所以没有任何远程调用来拼接片段。在为任何配音付费之前，先把照片定下来。能看到照片时就看一下；出现旗帜、徽标或徽章时，请对方换一张；看不到照片时，说明没有经过目视检查。量出照片的宽和高：在实时卡片允许的范围内，片段的画面比例跟随照片，而宣讲视频的画面是 16:9。16:9 的照片直接用。其他任何比例，包括手机常见的 3:4，绝不悄悄加黑边：请对方提供一张主讲人 16:9 的照片，或者单独出确认卡，用beatra.images.transform（先用{"capability": "image_to_image"}查到卡片）重新取景成 16:9，只做一次。然后写一段装得进这张卡的简短开场讲稿。声音也必须是主讲人本人的，绝不用音色库里的音色：党课用的音色就是主讲人的克隆声音时，就用它；或者单独出确认卡，为开场克隆一个；或者用主讲人本人念这段讲稿的录音，确认同意后上传。只为开场或结尾克隆的声音不写进course.json：把它的voice_id记在这堂党课文件夹的清单里，只用在片段配音的请求里；只有用户要求所有页面都用这个声音时，才把它写进voice.voice_id，并为这些页面出确认卡。出配音确认卡之前，选好配音的format：取这张卡driving_audio支持的 MIME 类型之一；配音单独出确认卡，用一个新的client_request_id，然后拿真实音频（配音或录音）的 MIME 类型、时长和大小对照所选视频卡片的driving_audio限制。重新取景卡和片段卡上都写明照片里没有旗帜、徽标或徽章（或者说明没有经过目视检查），片段卡还写明量出的画面比例、模型和选定的时长；交付时报告实际收到的画面比例。用这张卡的确切模型只提交一次beatra.videos.animate，照片作为image，这段音频作为driving_audio，时长取这张卡支持的、能装下音频的最小整秒数；查进度，用lesson_kit.py clip --slot intro记录下来，再重新合成。没有主讲人的照片时，宣讲视频全程是课件画面；绝不使用网上的图片。结尾用它自己的两张确认卡和两个标识。用户想让主讲人全程出镜时，说明这条流程只做开场和结尾，中间一直是课件画面。 - 主题党日海报。 先写海报文字和版式：活动名称、时间和地点完全照用户给的写，图上不放其他任何东西。然后调用
beatra.models.list并传{"capability": "text_to_image"}，出确认卡，用卡上的确切模型只提交一次beatra.images.generate（默认 3:4），提示词里逐字引用这几项，作为图上唯一的文字，不出现旗帜、徽标、五角星、领导人或其他任何人物；用户愿意的话，也可以把文字区留白，由单位自己排字。有错字时，用一次beatra.images.edit修正（先用{"capability": "image_edit"}查到卡片，用那张卡的确切模型），以交付的海报作为images[0]，单独出确认卡。 - 短讲稿。 没有课件的讲稿，先定稿，用
lesson_kit.py init --scripts建这堂党课（每段算一页），按第 5 步配音，每段交付一个音频文件，按顺序。 - 交付。 报告真实的文件、页数、时长、尺寸和累计的
billing.net_charged_credits。看不出来、听不出来的地方直接说明：配音是否把每段引文都完整读了，你看不清的图上文字，以及口型是否对得上；请用户再对照原文核对一遍课件和音频。提醒用户公开发布的文件要标注「AI 生成」，使用前要走完单位的审核流程。结尾只给一个下一步，比如「回复『配音』，我先给前几页报价」。
请求示例、确认卡样例、课程文件夹和一堂完整的党课示例，见党课制作流程（references/workflow.md）。
连接就绪之前
如果一轮结束时「允许」还没完成，就先把所有不需要连接的内容按用户要的格式交付：提纲、页面内容、讲稿、讨论题、海报文字，以及在这台电脑上生成的课件。这一轮交付的就是这些成果。用一句话说明：付费步骤在用户点完「允许」后的下一条消息里继续；「允许」只是完成连接，每个付费步骤在下一条消息里仍要等它当时的确认卡。不要用别的工具或服务填补空档，也不要说出任何没有经过实时调用返回的音色、模型、价格或结果。
需要确认的决定
文字包、课件、每份讲稿、每次估算和每次本地合成都免费，但它们不等于同意付费。
每次付费调用之前，先出一张当时的制作确认卡，然后等待：
- 内容：要做什么，用用户自己的话说；由哪一类调用来做（克隆、逐页配音、片段配音、照片重新取景、出镜片段、背景、海报或海报修正）；以及所示卡片的确切模型。提交的就是这个模型；卡片给某个具体模型报过价之后，绝不再用
auto。 - 积分：刚从这张模型卡片读到的实时价格；配音还要附上
lesson_kit.py estimate的结果。绝不用记忆里的数字。 - 次数：每一页、每次克隆、每个片段或每张图一次付费调用。只有同一堂党课的配音页面可以共用一张卡，并列出它们的估算；每次克隆、片段配音、照片重新取景、出镜片段、背景、海报和海报修正都单独一张卡。片段卡还要写明量出的画面比例、从实时卡片选定的时长、一个片段最长是这张卡支持的最长时长，并像重新取景卡一样，写明照片是否检查过有没有旗帜、徽标和徽章。
- 标识：逐页配音用的
client_request_id，就是lesson_kit.py next打印出的那个；其他每次调用都用一个新的不透明标识。讲稿、引文、音色、照片、模型或控制参数一变，就是新的付费工作，要用新的标识。 - 如果到此为止：文字包、课件和已经做好的所有内容照样能用。
- 如果余额不足：原样转述官方提示和其中的充值链接。用户说已经充值之前，不再提交。
同意了片段配音，不等于同意用它驱动的片段；同意了前几页，也不等于同意其余页面。绝不悄悄换音色或换模型。所有远程 Beatra 工具都只通过随包的 scripts/mcp_client.py 调用：工具名作为命令参数，JSON 参数从标准输入传入。
不要配置、调用或使用宿主 Beatra Connector。不要用 REST/OpenAPI 作为降级方案。
如果创建请求没收到回应，或者任务编号丢了，先调用 beatra.tasks.list，再调用 beatra.tasks.get，和定稿时的请求逐项比对。确认没有这个任务之后，才用同一个 client_request_id 重新提交完全相同的内容。以 failed 或 canceled 结束的任务和没收到回应不是一回事：沿用它的标识只会拿回那个失败的任务。某一页失败时，用 lesson_kit.py retake 并出新的确认卡；克隆、片段配音、重新取景、片段、背景、海报或海报修正失败时，在新的确认卡上用新的 client_request_id 重做。失败的标识绝不再发送。只有用户要求取消时，才调用 beatra.tasks.cancel，再用 beatra.tasks.get 确认这个任务。
用户问还剩多少积分时，调用 beatra.wallet.get。问扣了哪些费用时，调用 beatra.wallet.ledger。模型卡片返回 top_up 内容时，按卡片列出的顺序原样转述各档充值，不排序，也不替用户选。
按任务查阅
- 需要提纲文件、确认卡、配音、克隆、照片重新取景、出镜片段、背景、海报和修图的请求示例，以及一堂完整的党课示例时，读党课制作流程（references/workflow.md）。
- 任务卡住、没收到回应、任务失败、引文一页放不下、主讲人的照片不是 16:9 或有旗帜或徽章、这台电脑缺工具，或海报上的字不对时，读出问题时怎么办（references/faq.md）。
- 生成课件、出页面图、读取课件和保存图片时，读课件文件（references/deck-files.md）。
- 党课项目、读音、字幕、AI 标识、出镜片段和合成，读讲课视频合成（references/lesson-video.md）。
- 连接还没就绪时，读安装与授权（references/installation-and-auth.md）。
- 首次使用登记，读安装登记（references/installation-registration.md）。
- 任务创建之前调用就失败时，读随包 MCP Client 连接诊断（references/mcp-connection.md）。
- 任务在排队、进行中或找不到时，读任务与结果（references/tasks-and-results.md）。
- 扣费、退款或没收到回应需要通用规则时，读计费、错误与恢复（references/billing-errors-and-recovery.md）。
- 用户想停止使用并断开连接时，读卸载与断开连接（references/uninstall-and-disconnect.md）。
更新与安全
本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息
（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，
逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被
改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行
任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到
Beatra 为这次上传签发的一次性地址。
关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天
最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。
