热点内容制作

热点只有还在动的时候才值钱。这条路线一次走完，从热点到一条可以直接发布的内容：角度、选定其中一个、封面、正文和话题标签——需要的话，再加一条短片。

适用范围与相邻路线

这条路线是：一个热点、一组角度、选定的那一个，以及一条做完的内容。它适用于手上已经有热点、有一个事件节点或有一个日历节点，并且需要尽快发出去的情况。

手上没有热点时，别的工作流更合适。常青的产品种草，归种草视频工作流；要复刻的参考片，归拆片重做工作流；给已有内容配封面，归封面工作流。

输入与默认值

两个硬性输入：热点，以及用来发布的账号。

热点由用户给出——他点名的一个、粘过来的一份清单、一张热榜截图，或者一个对他有意义的日历日期。任何一种都够用，而且都不花钱。

用户想看看现在什么在热，或者想把自己报的话题拿去对一对大家实际在发什么时，这个软件包可以读抖音、TikTok 与 X 的公开热榜，也可以按用户报出的话题去搜抖音、TikTok、X 和小红书上正在发的内容。小红书没有可以浏览的榜——小红书的查询必须先有一个话题。每一次查询都是付费的、可选的，并且在其他任何事情之前单独确认，见查一查什么在热（references/trend-lookup.md）。Instagram、YouTube 和视频号则完全没有热榜；要发到那几个平台的内容，热点仍然来自用户或上面那几个平台，并且要如实说明。没有查询时，就基于用户带来的东西工作，而不是去描述一个你并没有见过的热点。

账号指的是发布方的行业、品牌或人设。没有它，角度就无处可接，产出只会是泛泛的热点评论。

对话里已经说过的平台、受众和投放目标，直接复用。默认 9:16 竖屏画布、给出三个角度、产出一条内容，并按只做封面的方式运行——封面、正文加话题标签，本身就是一条完整可发布的内容。角度定下来时提一次短片；用户要短片时，默认 12 秒，口播音色按短视频社交内容匹配。成片时长必须落在所选实时模型卡支持的范围内，并且只有开场画面会被动画成片，其余分镜画面按静图交付。每一个默认值都在确认里说明，而不是拿去问用户。

速度是这里的约束，它决定了其他一切。第一轮回复就给出角度，而不是先问一轮问题。

标准流程

第 1 到 3 步不花钱。唯一可能排在它们前面的付费调用是那次可选的热点查询，而且只有用户主动要求、并确认过它自己的价格之后才会发生。除此之外，用户选定角度并批准方案之前，不产生任何费用。

**在第 1 步之前，只有用户主动要求时才做：**读一份热榜，或者搜一搜大家关于这个话题正在发什么，见查一查什么在热（references/trend-lookup.md）。用户自己带来了热点时就跳过——那才是这条路线通常的样子，角度一样好。

1. 读懂热点，找出角度。 给出三个把热点和账号连起来的角度，每个都把连接讲清楚，见找到切入角度（references/angle-finding.md）。带风险的角度必须标出来，并说明风险是什么。
2. 用户选定其中一个。 或者要求换一批——换是免费的。
3. 搭出内容方案并取得批准。 封面文案、正文和话题标签——包含短片时，还有它的分镜，画面上出现的文字和口播出来的话分开写，见搭出这条内容（references/post-plan.md）。
4. 读取实时的 text_to_image 卡片，用 beatra.models.list——并且只有在包含短片时，才另外读取 text_to_speech 和 image_to_video 卡片，以及从 beatra.voices.list 里选一个音色。
5. 确认生产。 展示封面、是否包含短片、9:16 画布以及之后再改要付出的代价、包含短片时选定的可用音色、当前的费用估算，以及每一次计划中的付费调用对应的稳定请求 ID。
6. 用 beatra.images.generate 渲染封面。包含短片时，用同样的方式生成它的分镜画面，并用 beatra.speech.synthesize 合成口播，然后读取实际返回的时长、尺寸和 MIME 类型。
7. 把真实素材展示出来——只要宿主能访问到，并报告真实时长。
8. 确认视频——包含短片时。然后用批准过的开场画面、这段口播、一个明确选定的模型，以及所选卡片支持的、不小于口播真实长度的最小整秒时长，调用一次 beatra.videos.animate。
9. 用 beatra.tasks.get 轮询每个任务直到终态，把所有东西一起交付，并复核你真正能看到的部分。

只做封面的运行方式，跳过第 8 步以及第 4 到 7 步里与短片有关的工作，只有一个批准关口；它仍然要在第 9 步轮询并交付。展示费用估算时，说明当前跑的是哪一种。

视频模型要明确选定，而不是留给 auto：这个能力上只有部分模型接受外部传入的口播，不接受的那些会把它丢掉。

需要确认的决定

花钱之前先确认：凡是要跑热点查询，都先在最前面单独确认一次；然后封面连同所有分镜画面和口播一起确认一次；包含短片时视频再单独确认一次。

以下同样要确认，而不是自己决定：用户没有选过的角度、9:16 以外的画布、用户没有提供过的关于这个热点的事实性说法，以及产物获批之后的任何更改。每一个改动过的参数都是新的付费工作，需要新的请求标识和重新批准。

某个角度会把账号绑到一个只能由用户拍板的热点上时——正在进行的争议、有人蒙受的损失、尚未定论的公共事件、别人的不幸——把它作为一个选择摆出来并说明理由，同时给出不带这层风险的角度，然后按用户选的那个继续。这是他们自己的判断，不是一道关卡。

热点实际上是什么，来自用户，或者来自本软件包跑过、并已标注来源的一次查询。日期、数字、人名、结果和引语由用户提供；榜单名次、发文数量或某一条最近的内容属于那次查询，并且带着读取时间。热点自身的状态——热度、正在冲顶还是正在退潮、还剩多长时间——无论哪种来源都仍然是推断：把支撑它的证据摆出来，而不是直接断言。缺了某个细节，就绕开它来写这条内容，而不是就一个真实事件生成一个看起来合理的细节。

执行

所有远程 Beatra 工具只通过随包的 scripts/mcp_client.py 调用，工具名作为命令行参数，工具的参数以 JSON 从标准输入传入：

printf '%s' '{"capability":"text_to_image"}' | python3 scripts/mcp_client.py call beatra.models.list
printf '%s' '{"capability":"text_to_speech"}' | python3 scripts/mcp_client.py call beatra.models.list
printf '%s' '{"capability":"image_to_video"}' | python3 scripts/mcp_client.py call beatra.models.list
printf '%s' '{"query":"hot search","platform":"douyin","capability_family":"trends"}' | python3 scripts/mcp_client.py call beatra.social.tools.search

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为回退。每一个逻辑上的付费请求，给它一个稳定且不透明的 client_request_id，并且只提交一次。

交付与复核

交付考虑过的角度、选定的那一个及其理由、带文案的封面、正文、话题标签——包含短片时，还有短片方案、每一张作为静图交付的分镜画面，以及做完的成片。每一个生成类任务，都交付它的任务 ID、返回的 artifact 链接、解析后的模型、返回的尺寸与时长，以及 billing.net_charged_credits。热点查询的报告方式不同——载荷、任务 ID、终态和 billing.net_charged_credits，没有模型、尺寸或时长可报——见查一查什么在热（references/trend-lookup.md）。只报告任务真正返回的事实。

封面文案是生成出来的画面内容。把渲染出来的文字对照批准过的文案读一遍，没有清晰渲染出来时就直接说明，而不是把一张没检查过的封面说成是对的。哪些媒体细节无法检查，也要说明。

恢复

每一个任务 ID 立刻记录下来，并且只轮询那一个任务。queued 和 running 意味着继续等待。创建请求的响应丢失时，只用同一个标识重新提交逐字节一致的冻结载荷；任务 ID 丢失时，按该能力列出任务，把候选和自己的台账逐一比对之后，再做任何重试——热点查询除外，它没有可以据以列举任务的能力，只能靠记录下来的 operation_key、参数和 schema_hash 去比对。重做封面时，短片产物原样复用。insufficient_balance 表示没有产生任何扣费，充值之后可以重新提交同一个请求。

按任务查阅参考

• 把热点变成角度、判断契合度，以及风险研判：找到切入角度（references/angle-finding.md）
• 读热榜、搜话题、每次查询要花多少，以及查到的结果如何标注来源：查一查什么在热（references/trend-lookup.md）
• 封面文案、正文、话题标签，以及短片的分镜：搭出这条内容（references/post-plan.md）
• 确切载荷、每次确认冻结了什么、轮询、重做某一个阶段、恢复与取消：热点内容工作流（references/workflow.md）
• 首次安装或授权过期：安装与认证（references/installation-and-auth.md）
• 不计费的软件包注册：安装注册（references/installation-registration.md）
• 任务轮询、产物与结果字段：任务与结果（references/tasks-and-results.md）
• 余额、校验与结构化错误：计费、错误与恢复（references/billing-errors-and-recovery.md）
• 随包客户端连不上时：随包 MCP Client 连接诊断（references/mcp-connection.md）
• 更新保证与开关：自动更新与安全（references/automatic-updates-and-safety.md）
• 移除软件包或共享凭据：卸载与断开连接（references/uninstall-and-disconnect.md）

运行时与安全自动更新

随包客户端会在每个安装中静默检查是否有新版本，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本软件包、本渠道、本语言对应的固定 Beatra 官方发现地址与不可变 CDN 路径下载，在替换之前校验发现数据、压缩包、清单，以及每个文件的大小和校验和，并且只替换本包拥有的文件。它会拒绝重定向、降级、软件包/渠道/语言/版本对不上的数据、非预期的 URL、不安全的压缩包，以及任何落在所属目标目录之外的文件。

更新的检查、下载、校验、替换和回滚，失败时都不阻断：当前安装保持可用，原本请求的命令会继续执行。更新失败绝不构成重试一次付费生成的理由。这个设置会在本安装之后的命令中持续生效。

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check

--auto off 关闭静默检查，--auto on 重新开启，--check 报告官方可用版本但不替换文件。详见自动更新与安全（references/automatic-updates-and-safety.md）。