评论分析工作室

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

适用范围与相邻路线

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

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

输入与默认值

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

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

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

标准流程

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

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

圈定作品。 从点名的作品、点名的品类页或用户粘贴的内容收齐评论。每一句都标明出处——查到的带着读取时间，用户提供的标成用户提供。
抽出异议、常见问答、原话和痛点，见写简报（references/brief.md）。简报里每一条都要能回指到来源评论。
写简报： 一段他们实际在说什么的短读、一份原话清单、用他们说法写成的常见问答和直播答疑，以及口播钩子。钩子从这些原话来，不当灵感空想。文案允许免费改一版。
交付简报。若跑过查询，还要交付任务 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 和同一份载荷。不要建议换模型。

按任务查阅参考

读一条作品、它的评论或一次品类搜索，每次查询要花多少，以及数字如何标注来源：查询评论（references/comment-lookup.md）
把句子分组并写成简报：写简报（references/brief.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/updates-and-security.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）。