---
name: roan-folio-host-onboarding
description: Prepare a merchant product for ROAN AI Live Selling; verify waitlist availability, guide manual operator intake, and optionally prepare licensed media without calling unavailable APIs or generating paid media.
metadata:
  version: "0.1.0"
---

# ROAN merchant agent preparation / 货主 agent 准备

You are an agent working for a merchant. Read /llms.txt and /hosts/spec v0.2 first. Start with a product URL and sourced facts; finished media is optional. Current MVP: verify the waitlist form is live, then the merchant leaves a link and email for manual operator review/generation. If absent, keep everything local. Merchant product/operations APIs and MCP are **not yet available**; the staging receive-only media supply preview is documented below. Never call internal operator APIs or invent room/chapter IDs. The following v0.1 workflow applies only when finished media is supplied; it does not limit ROAN to media suppliers.


# ROAN AI host onboarding / AI 主播接入

Current stage: staging; a **receive-only supply preview** is available to authorized agents at `POST /v1/agent/supply-submissions` (status: `GET /v1/agent/supply-submissions/{submission_id}`). Media-only preparation profile; completed videos are reviewed by the platform before scheduling. No traffic, sales or income promises. Production submission is unavailable. / 当前staging，已向获授权 agent 开放只供片预览端点；平台审核后决定排播，不承诺流量销量收益，正式环境不可提交。

## Commercial terms summary / 商业条款摘要

Current platform policy (2026-11-11 23:21Z; may change) sells compute and a runtime environment. A live minute means one minute of approved host video that goes live; scripting, voiceover, review and looped playback are included. No commission; pay only for compute. / 平台现行政策（2026-11-11 23:21Z，可能调整）：出售算力与运行环境。「直播分钟」指通过审核并上播的一分钟主播视频，含脚本、配音、审片与循环播放。不抽成，只为算力付费。

| Option / 方式 | Policy / 政策 |
|---|---|
| Join a platform host room / 加入平台主播直播间 | Shared platform queue generates the product chapter; no installation. 1 minute of video free; free chapter plays for 14 days. Then $2.99/minute, prepaid, $20 minimum top-up. / 平台共享队列代为生成商品章节，无需安装；1 分钟视频免费，免费章节播14天；之后$2.99/分钟，最低充值$20。 |
| Own room, local / 自己的直播间·本地版 | Download the host engine; keep the computer on for generation and live interaction. Software free; compute $2.99/minute. / 下载主播引擎；电脑需开着才能生成与实时互动；软件免费，算力$2.99/分钟。 |
| Own room, cloud / 自己的直播间·云端托管 | $249/month: a 24/7 cloud VM (Cloud Claw), 15 minutes live video, 15 minutes live interaction, 45 minutes short dramas (30 episodes of 1.5 minutes); excess $2.99/minute. / $249/月：24小时云端虚拟机（Cloud Claw）、15分钟直播、15分钟互动、45分钟短剧（每集1分半，共30集）；超出$2.99/分钟。 |

Matched and newly generated hosts belong to the platform; matched hosts may serve multiple sellers. New hosts join the pool by default, with paid exclusivity available under the announced agreement. Supplier-provided likeness remains the supplier's and does not join the pool; supplier is responsible for permission. Platform still records declarations, AI disclosure and moderation/revocation. / 匹配及新生成主播归平台；匹配主播可带多家货，新生成默认入池、可按协议付费独占。自带形象归货主、不入池，授权由货主负责；平台仍留存声明、AI标识并处理投诉下架与凭证吊销。

Free chapter expiry after 14 days exposes viewing/click data; exhausted model credit stops answers about that product and displays unanswered questions. Short-drama distribution is included only in cloud hosting. Current implementation scope is accounting and display only: no payment collection or real charging; automatic expiry removal defaults off. These are policy terms, not proof that generation, hosting, downloads, allowances or billing are available on staging. The receive-only supply preview is the only documented staging submission; verify the released capability and use its authorized agent credential. Do not generate paid media or spend allowance automatically. / 免费章节14天到期后展示观看与点击数据；模型额度耗尽停止回答该商品提问，并展示未回答数。短剧导流仅云端托管档包含。本期只记账展示，不接支付、不真实扣费，到期自动下播默认关闭。以上是政策，不代表staging已开放生成、托管、下载、赠额或计费；只供片预览仅按已发布端点与授权凭据提交，不据此自动付费生成。

Sellers with inventory fulfill their own orders; participants without inventory use the platform catalogue and dropshipping when operational access is announced. No traffic, sales or income guarantees. / 有货卖家自发货，无货参与方待操作入口公布后使用平台货盘代发；不保证流量、销量或收入。

ROAN · AI Live Selling. AI hosts that sell for you. Paste a product link to match or generate an AI host for round-the-clock selling.

This is the product positioning; capability checks below determine what is currently executable. / 此为产品定位，具体可执行能力以以下前置检查为准。

## Preconditions / 前置检查

Read the current [specification](https://arvia-staging.rogerwu188.workers.dev/hosts/spec), [schema](https://arvia-staging.rogerwu188.workers.dev/hosts/spec.json), [terms](https://arvia-staging.rogerwu188.workers.dev/hosts/terms) and [overview](https://arvia-staging.rogerwu188.workers.dev/hosts). If unavailable, report the missing document and stop before any submission. Check current availability from the specification; do not assume the documentation being online opens intake. / 先读规范Schema条款与介绍；文档不可用或入口未开放时停止提交。

Confirm the user's authority to supply likeness/voice/materials and responsibility for spoken claims. Have the authorized representative explicitly accept published terms through approved intake when available; never tick acceptance on their behalf or treat reading as acceptance. Keep rights evidence private. Do not request platform shared/admin credentials. / 确认授权及事实责任，接入时由授权代表明确接受条款，不代勾、不公开授权文件、不索取共享token。

## Prepare and self-check / 准备与自检

1. Prepare Host fields using schema #/$defs/host. Record actual consent.attested_at/attested_by and optional release_url. Existing voice fields remain required; if the supplier has no applicable timbre_ref_url/tts_voice_id, report the media-only profile blocker, never invent them. / 按现有Host准备，缺必填声音资料就报告阻断，不编造。
2. Probe final MP4s locally: measured duration >0 and ≤120s, 720×1280 primary plus480×854 low, H.264/AAC-LC as applicable, aligned keyframes, actual hashes/bytes. Supply real timed WebVTT and language, AI disclosure and signed AI marking per rendition. Validate signatures/trust with an available trusted verifier; tool unavailable means unverified, not passed. / 实测规格hash字幕与AI签名；不能验证则标未验证。
3. For product clips verify approved catalogue SKU/variant, appearance, packaging text and sourced claims. Product-free null is allowed only by the chosen existing kind. Flag uncertain or unreadable packaging for review. / 对照真实SKU与包装文字；不确定即待审。
4. Prepare local candidate materials and a truthful final manifest only when all required QA evidence actually exists. Schema #/$defs/clip_manifest is final registration format, not a pending-upload format. source_tasks provider is only giggle/mock; non-Giggle production provenance is currently unsupported. Never relabel, invent tasks, set passed=true without evidence, or forge reports. / 未审核资料与最终片单分开；第三方来源未支持时停止，不伪造QA与任务号。
5. Validate JSON locally using Draft2020-12 plus format checking; cross-check host/room/is_test and referenced files. Report validation findings with affected asset IDs, without secrets. / 本地校验字段、关联及实际文件。

## Submit → review → room / 提交→审核→上房

Use only the documented staging supply endpoint after the authorized bearer credential and terms have been issued. A successful response is `pending_scheduling`, not approval or playback; retain the returned submission ID and poll only its documented status path. Do not submit to guessed paths, POST to unrelated contact pages, call operator registration APIs or claim that a pending receipt is live. / 仅使用已授权的 staging 只供片端点；回执是待排播，不是审核通过或已播，不能猜路径或冒充上线。

After the platform publicly announces an approved external endpoint and terms are accepted, use only its documented authentication and request shape; re-read the released contract instead of extrapolating this version. Save returned receipts, poll only a returned/documented status URI with bounded retries and honor retry guidance. Stop on authorization error, rejection, withdrawal or deadline; give corrections to the user. Never automatically regenerate paid media. / 未来仅按正式新契约提交，保存真实回执并有限轮询；拒收鉴权失败撤回超时即停，不自动付费重做。

Only platform approval enables test-room registration and scheduling. Verify real decoded frames, subtitles/audio, AI disclosure and product card/SKU alignment, then save playback evidence. An accepted HTTP request or now_playing event alone does not prove live playback. Do not mark live yourself or bypass review. / 仅平台可审核排播；测试房须实证出画字幕音频AI标识与SKU一致；HTTP成功不等于已播。

## Output / 输出

Summarize prepared assets, measured checks, rights/terms status, provenance limitations, required platform actions and current stage (`prepared` or `awaiting_manual_intake` locally). These stage labels are local workflow notes, not new contract fields or server responses. / 输出准备结果、实测检查、授权条款状态、来源限制和平台下一步；本地状态不能冒充服务端回执。
