评论分析工作室

交付物是一份用观众自己的话写成的简报：异议、原话、购买顾虑、常见问答、直播答疑和口播钩子。一次完全不查询的运行也是完整运行——粘贴过来的评论就够用。

适用范围与相邻路线

这条路线是：一条作品或一个品类、一页评论、一份分组简报。适用于需要观众已经用过的说法，而不是从零写一份新稿。

完整的账号诊断，归账号拆解工作流。复刻一条爆款片子，归拆片重做工作流。整场直播带货口播稿，归直播脚本工作流。

输入与默认值

硬输入是作品链接或评论原文。不要从一大批未圈定的帖子起步，也不要盲扫全站。只有用户已经点名一个品类时才允许按品类搜索，不能拿它顶替缺失的作品。

对话里已经说过的平台、商品，以及这份简报用来干什么，直接复用。默认读一页一级评论、不展开楼中楼，简报固定四块：异议、原话、常见问答、口播钩子。把这些默认值说出来，而不是拿去问。

用户想从一条公开作品或一次搜索里读评论时，这个软件包可以在抖音、TikTok、小红书、Instagram、YouTube 和 X 上查询，见查询评论。每一次查询都是付费的、可选的，并且在跑之前单独确认。平台的白名单里没有评论操作，就没有查询——用用户粘过来的内容继续。没有查询时，就根据粘贴的评论写简报，而不是去编造观众的说法。

标准流程

用户带来的评论就能免费写成简报。唯一的付费调用是一次可选查询，而且只有用户主动要求、并确认过它自己的价格之后才会发生。

**在写简报之前，只有用户主动要求时才做：**读一条公开作品和它的一页评论，或者按点名的品类搜一页作品，再读用户挑中的那一条的评论，见查询评论。用户已经粘贴了评论时就跳过查询。

圈定作品。 从点名的作品、点名的品类页或用户粘贴的内容收齐评论。每一句都标明出处——查到的带着读取时间，用户提供的标成用户提供。
抽出异议、常见问答、原话和痛点，见写简报。简报里每一条都要能回指到来源评论。
写简报： 一段他们实际在说什么的短读、一份原话清单、用他们说法写成的常见问答和直播答疑，以及口播钩子。钩子从这些原话来，不当灵感空想。文案允许免费改一版。
交付简报。若跑过查询，还要交付任务 ID、终态，以及 billing.net_charged_credits。查询没有模型、尺寸或时长可报。

需要确认的决定

每一次查询都在跑之前单独确认，没有例外。说明将要读什么、对应哪一个操作、beatra.social.tools.get 刚刚返回的积分价格，以及计划里一共几次查询，每一页算一次。停在这里，用户已经粘过来的内容仍然能写出一份能用的简报。

以下同样要确认，而不是自己决定：第二页评论、一条楼中楼、一次 60 积分的抖音或小红书搜索，以及查询已经跑过之后的任何改动。每一个改动过的参数都是新的付费工作，需要新的请求标识和重新批准。

查到的数字标成查到的，并带上读取日期。用户提供的数字继续标成用户提供。缺的数量就说缺，不要估算、插值，也不要从“类似作品通常怎样”里补。某句为什么表现好仍然是推断——标成推断，并给出证据。

执行

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

printf '%s' '{"query":"comments","platform":"douyin","capability_family":"comments"}' | python3 scripts/mcp_client.py call beatra.social.tools.search

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

交付与复核

交付分组简报、原话、常见问答、直播答疑和口播钩子。若跑过查询，交付返回的载荷、task_id、终态，以及 billing.net_charged_credits。不要去找解析后的模型或生成出来的媒体文件。只报告任务真正返回的事实。

恢复

任务 ID 丢失时，用 beatra.tasks.list 列出可能的任务，用 beatra.tasks.get 核对匹配项，然后在同一个 client_request_id 下重放逐字节一致的参数。只写重放这一半，就等于授权一次重复扣费。

查询失败时，保留 error.code，并阅读 error.message 里的平台措辞。只有当那条消息点名了某个字段或 ID 时才改参数，然后换一个新的 client_request_id。否则保持同一个 ID 和同一份载荷。不要建议换模型。

按任务查阅参考

读一条作品、它的评论或一次品类搜索，每次查询要花多少，以及数字如何标注来源：查询评论
把句子分组并写成简报：写简报
确切载荷、确认、翻页与恢复：评论简报工作流
首次安装或授权过期：安装与认证
不计费的软件包注册：安装注册
任务轮询、产物与结果字段：任务与结果
余额、校验与结构化错误：计费、错误与恢复
随包客户端连不上时：随包 MCP Client 连接诊断
更新保证与开关：自动更新与安全
移除软件包或共享凭据：卸载与断开连接

运行时与安全自动更新

随包客户端会在每个安装中静默检查是否有新版本，最多每 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 报告官方可用版本但不替换文件。详见自动更新与安全。