shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

单元导图组·单元转分页

按用户提供的单元要点，按页做成单元转分页静帧。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

单元导图组·单元转分页

按用户已经提供的要点，为每个点名的页面或步骤做成一张课堂导图静帧。某个单元需要按页排列的导图页时用本 Skill，而不是四到八张商品套图，也不是美术示范页。

套图、生活图和细节图转到 ecommerce-listing-image-set。亚马逊详情模块组在 amazon-a-plus-module-pack 已安装时转到该包。作画步骤示范页转到 art-demo-set。基金说明书分页转到 fund-page-set。不要到公开帖子里补缺失的单元要点。不要给学生作业评分或打等第，也不要承诺考试结果。

收集已提供的分页

硬输入是准确的单元或课次名称，以及将印在图上、由用户提供的分页或步骤要点。不要为了填满一页去编造缺失分支、样例分数、量表分或学生完成稿。复用对话里已有的投放位置（讲义、板书、投屏）、语言和必须保留项。

只补问会改页面的事实：

  • 准确的单元或课次名称；
  • 用户要印上的分页或步骤标题；
  • 用户已经同意印在每一页上的单元要点；
  • 投放面和语言；
  • 需要跟教师样张看起来一致时，可选的教师样张静帧。

扫描件或照片是视觉参考，不是缺失要点的来源。上传只是让 Beatra 拿到媒体，并不检查内容。宿主看不到文件时，保留用户声明的用途。

默认每个点名的页面或步骤一张图。多页就是多张图，各用自己的事实表。缺事实的那一行先空着，并写在计划里，方便用户以后补。

先做免费分页清单

任何付费出图前，先写好带标注的分页清单。每一页记下将印刷的行、语言、版式（标题、分支或正文要点、可选页脚）、画幅，以及可选参考图的角色。这份清单就是免费可见结果。规划不是批准。

在确定具体模型、画幅、出图数量或价格之前，读取当前的 beatra.models.list 卡片，能力为 text_to_image。保持 model 为 auto，每一页的 count 为 1。用户要另一张候选图时，另开一页并批准那次新工作。

仅在用户接受某页并要求局部修正时使用 beatra.images.edit，把已接受的图放在 images[0]。

写载荷或找回任务时，读 单元导图分页工作流（references/workflow.md）。

确认一次，按页出图

规划不收费。第一笔计费调用前，出示一张当前生产卡并等待：

  1. 做什么 — 每个点名的页面或步骤一张课堂导图静帧，一次生成调用（beatra.images.generate）。
  2. 积分 — 刚读到的 text_to_image 价格。不要复用记忆中的数字。
  3. 几笔 — 每一页静帧一次付费调用。不要把多页塞进同一个 count。
  4. 身份 — 每一页一个新的不透明 client_request_id。提示词、事实行、文件、模型或画幅变了就换新标识。
  5. 若停在这里 — 带标注的分页清单仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接（https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。用户说已充值之前不要重试。不要推荐 ¥198。

只通过随包 scripts/mcp_client.py 提交一次。用 beatra.tasks.get 轮询。交付实际字节和 billing.net_charged_credits。不要承诺预估就是最终扣费。

批准后每一页只提交一次。同一连接上同时进行的生成任务不超过两个。

审图、交付与恢复

对照已确认分页清单核对印刷行。只报告宿主实际看得见的文字。把生成的小字当作审阅项，不当作已评分样张或承诺分数。

按页序交付静帧、分页清单、观察到的尺寸和格式、任务标识、解析后的模型，以及返回的 billing.net_charged_credits。局部修正是新的付费工作，要换新卡和新标识。

拿到 task_id 后轮询该任务。创建响应丢失时，只用原来的标识重试完全相同的冻结载荷。任务标识缺失时，先用 beatra.tasks.list 再用 beatra.tasks.get 核对候选，然后再提交。只有用户要求时才调用 beatra.tasks.cancel。

执行

每个远程 Beatra 操作都只通过本包随附的 scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。

python3 scripts/mcp_client.py call beatra.models.list

{"capability": "text_to_image"}

printf '%s' '{"prompt":"Create the approved classroom unit mind-map still for the named page. Print only the confirmed unit points.","model":"auto","count":1,"canvas":{"type":"preset","tier":"2K","aspect":"3:4"},"client_request_id":"opaque-unit-map-01"}' | python3 scripts/mcp_client.py call beatra.images.generate

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。

按任务查阅的参考

  • 分页清单、载荷、确认、轮询、恢复和审图，读 单元导图分页工作流（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 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。

更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费出图的理由。这个设置会在本安装中持续生效。见 自动更新与安全（references/automatic-updates-and-safety.md）。

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