@clize/clize 0.10.1 → 0.11.0

package/dist/cli.js

@@ -1,40 +1,34 @@
 #!/usr/bin/env node
 // ============================================================
-//  clize CLI —— 两种模式共用一套命令面:
-//   • 本地(self-host):自带 Cloudflare token,命令跑本地 core,直连你自己的 CF。
-//   • 托管(remote):配置里有 CLIZE_API_KEY(由 `clize login --api` 写),命令改走
-//     HTTP 调 clize 控制面后端;用户永不接触 CF。后端已就绪的命令见 remote.ts;
-//     其余命令在 remote 模式给友好报错。
-//  判定:remote.loadRemote() 非空 = 托管模式。
+//  clize CLI —— 纯托管瘦客户端:
+//   • CLI 不含 core 业务逻辑、不直连 CF/Vercel/OpenAI;所有真实动作经 clize 控制面 worker。
+//   • 登录态 = 配置/env 里有 CLIZE_API_KEY(由 `clize login` 写)。未登录则需凭证的命令引导去登录。
+//   • 客户端仅保留「读盘 / 落盘 / 本地 lint / 本地预览」这类不碰云的活儿
+//     (站点文件读取、知识文件读取、媒体落盘、蓝图校验、serve)。
 // ============================================================
 import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";
 import { Command } from "commander";
-import { createLocalContext } from "./context.js";
 import * as githubClient from "./github.js";
-import * as domainsCore from "./core/domains.js";
-import * as emailCore from "./core/email.js";
-import * as siteCore from "./core/site.js";
 import * as addressesCore from "./core/addresses.js";
-import * as handleCore from "./core/handle.js";
 import * as sitesCore from "./core/sites.js";
 import * as setupCore from "./core/setup.js";
-import * as projectsCore from "./core/projects.js";
-import * as billingCore from "./core/billing.js";
 import * as installCore from "./core/install.js";
 import * as mediaCore from "./core/media.js";
 import * as videoCore from "./core/video.js";
 import * as serveCore from "./core/serve.js";
-import { selfcheck } from "./selfcheck.js";
 import * as remoteClient from "./remote.js";
 import { VERSION } from "./version.js";
-// 托管模式探测(配置里有 CLIZE_API_KEY 即启用)。
+// 托管模式探测(配置里有 CLIZE_API_KEY 即登录态)。
 const remote = remoteClient.loadRemote();
-// 本地 ctx 惰性构造:remote 模式下完全不碰 CF / FileStore。
-let _ctx;
 let projectOverride; // -p <slug>:覆盖当前目录检出(clize.json)
-const ctx = () => (_ctx ??= createLocalContext({ projectSlug: projectOverride }));
+/** 取登录态 RemoteConfig;未登录直接报错引导登录(纯托管:无凭证就没法干活)。 */
+function rc() {
+    if (!remote)
+        throw new Error("未登录:先 clize login(网页用 GitHub / Google / 邮箱授权)");
+    return remote;
+}
 /** 统一输出:成功打印美化 JSON(字符串原样),失败 → stderr + 退出码 1。 */
 async function emit(value) {
     try {
@@ -165,10 +159,10 @@ function splitRefs(spec) {
         : [];
 }
 /** 托管模式异步生成(视频 / 音乐):提交 →(默认)long-poll 到完成并落盘 /(--async)返 job id。 */
-async function remoteGenAsync(rc, modality, body, opts) {
+async function remoteGenAsync(rcfg, modality, body, opts) {
     const submit = (await (modality === "video"
-        ? remoteClient.api.genVideo(rc, body)
-        : remoteClient.api.genMusic(rc, body)));
+        ? remoteClient.api.genVideo(rcfg, body)
+        : remoteClient.api.genMusic(rcfg, body)));
     if (!opts.confirm)
         return submit; // 只报价
     if (submit.state !== "running" || !submit.id)
@@ -182,7 +176,7 @@ async function remoteGenAsync(rc, modality, body, opts) {
         await new Promise((r) => setTimeout(r, 6000));
         let st;
         try {
-            st = (await remoteClient.api.genStatus(rc, id));
+            st = (await remoteClient.api.genStatus(rcfg, id));
         }
         catch {
             continue; // 轮询偶发出错:不判失败,继续等到超时
@@ -211,7 +205,7 @@ const inCommandTree = (cmd, name) => {
             return true;
     return false;
 };
-// 全局 -p:命令动作前从该命令的 --project 选项取值 → 本地进 ctx.projectSlug,remote 由 call() 统一注入 ?project=。
+// 全局 -p:命令动作前从该命令的 --project 选项取值 → 由 remote call() 统一注入 ?project=。
 program.hook("preAction", (_thisCmd, actionCmd) => {
     // build 树(及 design 兼容别名树)排除:--project 在 build site start 下是「设计项目名」
     // (给方法后端做记录),不是资源项目 slug。build clip render 仍要 -p(挂了 withProject,
@@ -229,37 +223,27 @@ program
     .description("Clize —— 给 agent 的真实世界能力层:域名 / 邮箱 / 部署 / 媒体")
     .version(VERSION)
     .showHelpAfterError();
-// 「未登录」闸:既没有 clize key(托管)也没有 Cloudflare 凭证(自带-CF)时,
-// 任何需要凭证的命令都直接引导去 `clize login`,而不是吐底层 Cloudflare 错误。
+// 「未登录」闸:没有 clize key 时,任何需要凭证的命令都引导去 `clize login`(纯托管:动作经控制面)。
 const NO_AUTH_CMDS = new Set(["login", "signup", "init", "install", "update", "help"]);
 program.hook("preAction", (_thisCmd, actionCmd) => {
     if (NO_AUTH_CMDS.has(actionCmd.name()))
         return;
-    // 生成式媒体(gen *):本地只需自带 OPENAI / GEMINI key(由 core 自检),不要求 CF / clize 凭证。
-    if (actionCmd.name() === "gen" || actionCmd.parent?.name() === "gen")
-        return;
     // 作品域(build *,含 design 兼容别名树):hosted 方法命令自带比通用闸更准的登录引导;
-    // build clip check 纯本地零凭证、render 同 gen 由 core 自检。
+    // build clip check 纯本地零凭证(蓝图机械校验,不碰云)。
     if (inCommandTree(actionCmd, "build") || inCommandTree(actionCmd, "design"))
         return;
-    if (remote || remoteClient.hasLocalCfCreds())
+    if (remote)
         return;
     console.error("❌ 未登录。\n" +
-        "   登录即用(免配任何 key):clize login        # GitHub 授权,资源跑在 clize 托管\n" +
-        "   (已有 Cloudflare 想自托管?进阶:clize login --help)");
+        "   登录即用(免配任何 key):clize login        # GitHub / Google / 邮箱授权,资源跑在 clize 托管\n" +
+        "   CI / headless:clize login --token <clize key> --api <url>");
     process.exit(1);
 });
 // ───────── 总览 / 自检 / 审计 ─────────
 withProject(program
     .command("status")
     .description("工作空间总览:域名、邮箱 / 站点状态、本月开销;--assets 加到期巡检")
-    .option("--assets", "含注册商处真实到期列表(资产健康)")).action((opts) => emit(remote
-    ? opts.assets
-        ? remoteClient.api.statusAssets(remote)
-        : remoteClient.api.status(remote)
-    : opts.assets
-        ? domainsCore.assetsHealth(ctx())
-        : domainsCore.workspaceStatus(ctx())));
+    .option("--assets", "含注册商处真实到期列表(资产健康)")).action((opts) => emit(opts.assets ? remoteClient.api.statusAssets(rc()) : remoteClient.api.status(rc())));
 program
     .command("signup")
     .description("注册一个 clize 托管账户:开租户 + 发 API key(随后用 clize login --api 登录)")
@@ -269,15 +253,12 @@ program
 program
     .command("login")
     .description("登录:默认在网页用 GitHub / Google / 邮箱任一授权(托管);--github 走 device flow;--token 手动")
-    .option("--token <token>", "手动凭证(托管=clize key;本地=Cloudflare API token)")
+    .option("--token <token>", "手动塞 clize key(CI / headless)")
     .option("--github", "走 GitHub device flow(只认 GitHub、不想开网页时的捷径)")
     .option("--api <url>", "托管控制面地址")
-    .option("--account <id>", "账户 id(本地模式:Cloudflare Account ID)")
     .action((opts) => {
     if (opts.token)
-        return emit(opts.api
-            ? setupCore.saveRemoteLogin(opts.api, opts.token)
-            : setupCore.saveLogin(opts.token, opts.account));
+        return emit(setupCore.saveRemoteLogin(opts.api ?? remoteClient.DEFAULT_API_URL, opts.token));
     return emit(opts.github ? githubLogin(opts.api) : pairingLogin(opts.api));
 });
 program
@@ -297,16 +278,14 @@ const projects = program
 projects
     .command("list", { isDefault: true })
     .description("列出你的所有项目(各带域名数)")
-    .action(() => emit(remote ? remoteClient.api.projectsList(remote) : projectsCore.listProjects(ctx())));
+    .action(() => emit(remoteClient.api.projectsList(rc())));
 projects
     .command("new <name>")
     .description('新建项目(名字带空格用引号,如 "Shop A";slug 缺省由名字规整)')
     .option("--slug <slug>", "项目标识(租户内唯一,CLI/URL 友好)")
     .option("--use", "建完顺手把当前目录检出到它(写 ./clize.json)")
     .action((name, opts) => emit((async () => {
-    const rec = (remote
-        ? await remoteClient.api.projectCreate(remote, name, opts.slug)
-        : await projectsCore.createProject(ctx(), { name, slug: opts.slug }));
+    const rec = (await remoteClient.api.projectCreate(rc(), name, opts.slug));
     // 输出瘦身:slug/name 足矣(id/tenantId/createdAt 是内部细节,不进 transcript)。
     const lean = { slug: rec?.slug, name: rec?.name };
     if (opts.use && rec?.slug)
@@ -322,29 +301,23 @@ projects
 projects
     .command("move <domain> <project>")
     .description("把域名挪进某项目(它的邮箱地址跟着走;媒体资产不动)")
-    .action((d, p) => emit(remote ? remoteClient.api.projectMove(remote, d, p) : projectsCore.moveDomain(ctx(), d, p)));
+    .action((d, p) => emit(remoteClient.api.projectMove(rc(), d, p)));
 projects
     .command("rename <slug>")
     .description("改项目显示名 / 标识(default 不能改标识)")
     .option("--name <name>", "新显示名")
     .option("--slug <newSlug>", "新标识(检出过旧标识的目录要重新 clize use)")
-    .action((slug, opts) => emit(remote
-    ? remoteClient.api.projectRename(remote, slug, { name: opts.name, slug: opts.slug })
-    : projectsCore.renameProject(ctx(), slug, { name: opts.name, slug: opts.slug })));
+    .action((slug, opts) => emit(remoteClient.api.projectRename(rc(), slug, { name: opts.name, slug: opts.slug })));
 projects
     .command("rm <slug>")
     .description("删项目(default 不可删;非空项目必须 --into 指定资源去向,绝不级联删资源)")
     .option("--into <project>", "把项目下资源(域名 + 媒体资产)归并到哪个项目,如 default")
-    .action((slug, opts) => emit(remote
-    ? remoteClient.api.projectRemove(remote, slug, opts.into)
-    : projectsCore.removeProject(ctx(), slug, { into: opts.into })));
+    .action((slug, opts) => emit(remoteClient.api.projectRemove(rc(), slug, opts.into)));
 program
     .command("use <project>")
     .description("把当前目录切到某个项目(此后本目录的命令默认作用于它;写 ./clize.json)")
     .action((project) => emit((async () => {
-    const list = (remote
-        ? await remoteClient.api.projectsList(remote)
-        : await projectsCore.listProjects(ctx()));
+    const list = (await remoteClient.api.projectsList(rc()));
     if (!Array.isArray(list) || !list.some((p) => p.slug === project))
         throw new Error(`没有叫 "${project}" 的项目;先看看有哪些:clize projects(新建:clize projects new "<名字>")`);
     return setupCore.useProject(project);
@@ -371,69 +344,55 @@ program
 program
     .command("check [domain]")
     .description("连通性自检:验证凭证 / 账户 / 域名查价(只读,不花钱)")
-    .action((domain) => remote ? emit(remoteClient.check(remote)) : selfcheck(ctx(), domain));
+    .action(() => emit(remoteClient.check(rc())));
 withProject(program
     .command("audit")
     .description("查花钱 / 对外动作的审计记录(检出项目时只看该项目的花钱动作)")
-    .option("-n, --limit <n>", "返回条数", "20")).action((opts) => emit(remote
-    ? remoteClient.api.audit(remote, Number(opts.limit))
-    : domainsCore.auditLog(ctx(), Number(opts.limit))));
+    .option("-n, --limit <n>", "返回条数", "20")).action((opts) => emit(remoteClient.api.audit(rc(), Number(opts.limit))));
 program
     .command("balance")
-    .description("查 clize 余额 + 最近流水(托管模式;本地自带-CF 模式无余额概念)")
-    .action(() => emit(remote ? remoteClient.api.balance(remote) : billingCore.balance(ctx())));
+    .description("查 clize 余额 + 流水")
+    .action(() => emit(remoteClient.api.balance(rc())));
 program
     .command("recharge")
-    .description("充值 clize 余额(托管模式,最低 $25):自动打开 Stripe 付款页,付完余额自动到账")
+    .description("充值 clize 余额(最低 $25):自动打开 Stripe 付款页,付完余额自动到账")
     .requiredOption("--amount <usd>", "充值金额(美元)")
     .option("--no-open", "不自动打开浏览器,只返回付款链接(headless / agent 用)")
-    .action((opts) => {
-    if (!remote)
-        return emit(Promise.reject(new Error("充值仅托管模式可用;本地自带-CF 模式费用直接走你的 Cloudflare 账户。")));
-    return emit((async () => {
-        const r = (await remoteClient.api.rechargeSession(remote, Number(opts.amount)));
-        const opened = opts.open !== false && !!r.checkoutUrl;
-        if (opened)
-            openBrowser(r.checkoutUrl);
-        return {
-            ...r,
-            opened,
-            message: opened
-                ? "已在浏览器打开付款页;没弹出就手动打开上面的 checkoutUrl。付完 `clize balance` 查看。"
-                : "在浏览器打开 checkoutUrl 完成支付;付完 `clize balance` 查看。",
-        };
-    })());
-});
+    .action((opts) => emit((async () => {
+    const r = (await remoteClient.api.rechargeSession(rc(), Number(opts.amount)));
+    const opened = opts.open !== false && !!r.checkoutUrl;
+    if (opened)
+        openBrowser(r.checkoutUrl);
+    return {
+        ...r,
+        opened,
+        message: opened
+            ? "已在浏览器打开付款页;没弹出就手动打开上面的 checkoutUrl。付完 `clize balance` 查看。"
+            : "在浏览器打开 checkoutUrl 完成支付;付完 `clize balance` 查看。",
+    };
+})()));
 const pay = program.command("pay").description("代客收费(托管):连接你的 Stripe,向你的客户收款");
 pay
     .command("connect")
     .description("连接你的 Stripe 账户(开浏览器授权;之后即可向客户收款)")
     .option("--no-open", "不自动打开浏览器,只返回授权链接(headless / agent 用)")
-    .action((opts) => {
-    if (!remote)
-        return emit(Promise.reject(new Error("代客收费仅托管模式可用;先 clize login。")));
-    return emit((async () => {
-        const r = (await remoteClient.api.connectStart(remote));
-        const opened = opts.open !== false && !!r.authorizeUrl;
-        if (opened)
-            openBrowser(r.authorizeUrl);
-        return {
-            ...r,
-            opened,
-            message: opened
-                ? "已在浏览器打开 Stripe 授权页;授权后回来跑 `clize pay status`。"
-                : "在浏览器打开 authorizeUrl 授权;完成后 `clize pay status` 查看。",
-        };
-    })());
-});
+    .action((opts) => emit((async () => {
+    const r = (await remoteClient.api.connectStart(rc()));
+    const opened = opts.open !== false && !!r.authorizeUrl;
+    if (opened)
+        openBrowser(r.authorizeUrl);
+    return {
+        ...r,
+        opened,
+        message: opened
+            ? "已在浏览器打开 Stripe 授权页;授权后回来跑 `clize pay status`。"
+            : "在浏览器打开 authorizeUrl 授权;完成后 `clize pay status` 查看。",
+    };
+})()));
 pay
     .command("status")
     .description("查看你的收款账户状态(是否已连接 / 可收款)")
-    .action(() => {
-    if (!remote)
-        return emit(Promise.reject(new Error("代客收费仅托管模式可用;先 clize login。")));
-    return emit(remoteClient.api.connectStatus(remote));
-});
+    .action(() => emit(remoteClient.api.connectStatus(rc())));
 pay
     .command("link")
     .description("生成一条收款链接,发给你的客户付款(--mode direct=进你的 Stripe / balance=进 clize 余额)")
@@ -441,25 +400,17 @@ pay
     .option("--mode <mode>", "direct=进你的 Stripe(默认,需先 connect)| balance=进 clize 余额", "direct")
     .option("--to <ref>", "客户标识(邮箱 / 备注,仅记录展示)")
     .option("--for <purpose>", "收款事由(发票号 / 订单 / 询价 id)")
-    .action((opts) => {
-    if (!remote)
-        return emit(Promise.reject(new Error("代客收费仅托管模式可用;先 clize login。")));
-    return emit(remoteClient.api.payLink(remote, {
-        amountUsd: Number(opts.amount),
-        mode: opts.mode,
-        customerRef: opts.to,
-        purpose: opts.for,
-    }));
-});
+    .action((opts) => emit(remoteClient.api.payLink(rc(), {
+    amountUsd: Number(opts.amount),
+    mode: opts.mode,
+    customerRef: opts.to,
+    purpose: opts.for,
+})));
 pay
     .command("list")
     .description("列出你开出的收款单(最新在前)")
     .option("--limit <n>", "条数(默认 20)")
-    .action((opts) => {
-    if (!remote)
-        return emit(Promise.reject(new Error("代客收费仅托管模式可用;先 clize login。")));
-    return emit(remoteClient.api.payList(remote, opts.limit ? Number(opts.limit) : undefined));
-});
+    .action((opts) => emit(remoteClient.api.payList(rc(), opts.limit ? Number(opts.limit) : undefined)));
 const billing = program.command("billing").description("计费:绑卡 / 自动续充(托管模式)");
 billing
     .command("card")
@@ -467,12 +418,10 @@ billing
     .option("--remove", "移除已绑卡(同时关闭自动续充)")
     .option("--no-open", "不自动打开浏览器,只返回绑卡链接(headless / agent 用)")
     .action((opts) => {
-    if (!remote)
-        return emit(Promise.reject(new Error("自动续充仅托管模式可用;本地自带-CF 模式费用直接走你的 Cloudflare 账户。")));
     if (opts.remove)
-        return emit(remoteClient.api.billingCardRemove(remote));
+        return emit(remoteClient.api.billingCardRemove(rc()));
     return emit((async () => {
-        const r = (await remoteClient.api.billingSetupSession(remote));
+        const r = (await remoteClient.api.billingSetupSession(rc()));
         const opened = opts.open !== false && !!r.checkoutUrl;
         if (opened)
             openBrowser(r.checkoutUrl);
@@ -492,8 +441,6 @@ billing
     .option("--off", "关闭自动续充")
     .option("--amount <usd>", "每次自动续充额(美元,>=最低充值额)")
     .action((opts) => {
-    if (!remote)
-        return emit(Promise.reject(new Error("自动续充仅托管模式可用;本地自带-CF 模式费用直接走你的 Cloudflare 账户。")));
     if (opts.on && opts.off)
         return emit(Promise.reject(new Error("--on 和 --off 不能同时用。")));
     const patch = {};
@@ -505,21 +452,19 @@ billing
         patch.amountUsd = Number(opts.amount);
     if (patch.enabled === undefined && patch.amountUsd === undefined)
         return emit(Promise.reject(new Error("指定 --on / --off / --amount 之一。")));
-    return emit(remoteClient.api.billingAutopay(remote, patch));
+    return emit(remoteClient.api.billingAutopay(rc(), patch));
 });
 withProject(program
     .command("context [address]")
-    .description("会话开头 rehydrate:某地址的 身份+知识+操作规约 → 进 agent 的 system prompt(无地址=列地址)")).action((address) => emit(remote ? remoteClient.api.context(remote, address) : addressesCore.addressContext(ctx(), address)));
+    .description("会话开头 rehydrate:某地址的 身份+知识+操作规约 → 进 agent 的 system prompt(无地址=列地址)")).action((address) => emit(remoteClient.api.context(rc(), address)));
 withProject(program
     .command("claim <slug>")
     .description("占一个免费 handle <slug>.clize.app(先到先得;默认自动开 support@ 收信;归当前检出项目)")
-    .option("--no-email", "只占名,不自动开邮箱")).action((slug, opts) => emit(remote
-    ? remoteClient.api.claim(remote, slug)
-    : handleCore.claimHandle(ctx(), slug, { provisionEmail: opts.email })));
+    .option("--no-email", "只占名,不自动开邮箱")).action((slug) => emit(remoteClient.api.claim(rc(), slug)));
 program
     .command("release <slug>")
     .description("释放自己的免费 handle(删 DNS + 身份,腾出名字;best-effort 拆站点绑定)")
-    .action((slug) => emit(remote ? remoteClient.api.release(remote, slug) : handleCore.releaseHandle(ctx(), slug)));
+    .action((slug) => emit(remoteClient.api.release(rc(), slug)));
 // ───────── 域名 ─────────
 const domain = program.command("domain").description("域名:查可注册 / 买 / 接入 / 列表");
 domain
@@ -528,38 +473,25 @@ domain
     .option("--tld <tld>", "顶级域(query 不含点时用)", "com")
     .action((query, opts) => {
     const domains = query.map((q) => (q.includes(".") ? q : `${q}.${opts.tld}`));
-    return emit(remote ? remoteClient.api.domainSearch(remote, domains) : domainsCore.searchDomains(ctx(), domains));
+    return emit(remoteClient.api.domainSearch(rc(), domains));
 });
 domain
     .command("tlds")
-    .description("列出 domain search 支持的后缀(其余返回 extension_not_supported_via_api)")
-    .action(() => emit({
-    supportedTlds: domainsCore.SUPPORTED_TLDS,
-    note: "Cloudflare 注册商 beta;.co / .io / .ai / .consulting / .agency 等暂不支持。",
-}));
+    .description("列出可注册后缀(CF 直注 + Vercel 补充;按 TLD 自动选注册商)")
+    .action(() => emit(remoteClient.api.listSupportedTlds(rc())));
 withProject(domain
     .command("buy <domain>")
     .description("注册域名(💰 花钱:必须 --confirm;缺则只返报价;归当前检出项目)")
     .option("--confirm", "确认花钱注册")
-    .option("--no-auto-renew", "关闭自动续费(默认开,防过期)")).action((d, opts) => {
-    if (remote)
-        return emit(remoteClient.api.domainBuy(remote, d, !!opts.confirm, opts.autoRenew));
-    if (!opts.confirm) {
-        return emit(domainsCore.searchDomains(ctx(), [d]).then((quote) => ({
-            quote,
-            message: `这是报价。确认后加 --confirm 才会真注册:clize domain buy ${d} --confirm`,
-        })));
-    }
-    return emit(domainsCore.registerDomain(ctx(), d, { autoRenew: opts.autoRenew }));
-});
-withProject(domain.command("import <domain>").description("接入已有域名(迁 NS 托管,幂等;新接入归当前检出项目)")).action((d) => emit(remote ? remoteClient.api.domainImport(remote, d) : domainsCore.importDomain(ctx(), d)));
-withProject(domain.command("list").description("列出本租户的域名(检出项目时只列该项目)")).action(() => emit(remote ? remoteClient.api.domainList(remote) : domainsCore.listDomains(ctx())));
+    .option("--no-auto-renew", "关闭自动续费(默认开,防过期)")).action((d, opts) => emit(remoteClient.api.domainBuy(rc(), d, !!opts.confirm, opts.autoRenew)));
+withProject(domain.command("import <domain>").description("接入已有域名(迁 NS 托管,幂等;新接入归当前检出项目)")).action((d) => emit(remoteClient.api.domainImport(rc(), d)));
+withProject(domain.command("list").description("列出本租户的域名(检出项目时只列该项目)")).action(() => emit(remoteClient.api.domainList(rc())));
 // ───────── 邮箱 ─────────
 const email = program.command("email").description("邮箱:配置 / 发信 / 收信");
 email
     .command("setup <domain>")
     .description("配自定义域收发链路(MX / SPF + 发信域名验证)")
-    .action((d) => emit(remote ? remoteClient.api.emailSetup(remote, d) : emailCore.setupEmail(ctx(), d)));
+    .action((d) => emit(remoteClient.api.emailSetup(rc(), d)));
 withProject(email
     .command("send")
     .description("发信(📨 身份对外硬闸:默认只出草稿,加 --confirm 才真发)"))
@@ -576,31 +508,13 @@ withProject(email
         ? String(opts.to).split(",").map((s) => s.trim())
         : opts.to;
     const attachments = loadAttachments(opts.attach);
-    // 托管模式:from 缺省同样从本地 clize.json 推导(CLI 在用户机器上跑,读得到);
-    // confirm 透传给后端裁决草稿/真发。
-    if (remote) {
-        const rSender = opts.from
-            ? { from: opts.from, replyTo: undefined }
-            : setupCore.projectSender();
-        if (!rSender?.from)
-            return emit(Promise.reject(new Error("需 --from <地址>,或先 `clize init --handle <slug>` 绑定项目以自动带出发件人")));
-        return emit(remoteClient.api.emailSend(remote, {
-            from: rSender.from,
-            to,
-            subject: opts.subject,
-            text: opts.text,
-            html: opts.html,
-            replyTo: rSender.replyTo,
-            attachments,
-            confirm: !!opts.confirm,
-            allowDuplicate: !!opts.allowDuplicate,
-        }));
-    }
-    // from 缺省时从项目(clize.json)带出发件人 + 回信地址
-    const sender = opts.from ? { from: opts.from, replyTo: undefined } : setupCore.projectSender();
+    // from 缺省同样从本地 clize.json 推导(CLI 在用户机器上跑,读得到);confirm 透传给后端裁决草稿/真发。
+    const sender = opts.from
+        ? { from: opts.from, replyTo: undefined }
+        : setupCore.projectSender();
     if (!sender?.from)
         return emit(Promise.reject(new Error("需 --from <地址>,或先 `clize init --handle <slug>` 绑定项目以自动带出发件人")));
-    const msg = {
+    return emit(remoteClient.api.emailSend(rc(), {
         from: sender.from,
         to,
         subject: opts.subject,
@@ -608,17 +522,9 @@ withProject(email
         html: opts.html,
         replyTo: sender.replyTo,
         attachments,
-    };
-    if (!opts.confirm)
-        return emit({
-            // 草稿里把附件 base64 折叠成「文件名 (类型, ~大小)」摘要,不污染 transcript。
-            draft: {
-                ...msg,
-                attachments: attachments?.map((a) => `${a.filename} (${a.contentType ?? "?"}, ~${Math.round((a.content.length * 0.75) / 1024)}KB)`),
-            },
-            message: "📨 这是草稿,还没发。把它给用户看、确认后加 --confirm 才真发:clize email send … --confirm",
-        });
-    return emit(emailCore.sendEmail(ctx(), msg, { allowDuplicate: !!opts.allowDuplicate }));
+        confirm: !!opts.confirm,
+        allowDuplicate: !!opts.allowDuplicate,
+    }));
 });
 email
     .command("inbox <domain>")
@@ -626,19 +532,13 @@ email
     .option("-n, --limit <n>", "返回条数", "20")
     .option("--wait-for <pattern>", "轮询等待直到出现 subject/from/正文 含该串的信(如验证码)")
     .option("--timeout <sec>", "等待上限秒数(配 --wait-for)", "120")
-    .action((d, opts) => emit(remote
-    ? opts.waitFor
-        ? remoteClient.waitForInboxRemote(remote, d, opts.waitFor, {
-            timeoutSec: Number(opts.timeout),
-        })
-        : remoteClient.api.emailInbox(remote, d, Number(opts.limit))
-    : opts.waitFor
-        ? emailCore.waitForInbox(ctx(), d, opts.waitFor, { timeoutSec: Number(opts.timeout) })
-        : emailCore.checkInbox(ctx(), d, Number(opts.limit))));
+    .action((d, opts) => emit(opts.waitFor
+    ? remoteClient.waitForInboxRemote(rc(), d, opts.waitFor, { timeoutSec: Number(opts.timeout) })
+    : remoteClient.api.emailInbox(rc(), d, Number(opts.limit))));
 email
     .command("show <domain> <id>")
     .description("读单封邮件全文")
-    .action((d, id) => emit(remote ? remoteClient.api.emailShow(remote, d, id) : emailCore.getMessage(ctx(), d, id)));
+    .action((d, id) => emit(remoteClient.api.emailShow(rc(), d, id)));
 email
     .command("thread <contactOrDomain> [contact]")
     .description("读与某联系人的往来。init 过的目录单参即可:email thread <对方地址>;双参 = <收信域> <对方地址>")
@@ -648,25 +548,21 @@ email
     const contact = b ?? a;
     if (!domain)
         return emit(Promise.reject(new Error("没绑定收信域:clize email thread <domain> <contact>,或先 clize init 绑定本目录后单参使用")));
-    return emit(remote ? remoteClient.api.emailThread(remote, domain, contact) : emailCore.emailThread(ctx(), domain, contact));
+    return emit(remoteClient.api.emailThread(rc(), domain, contact));
 });
 email
     .command("inbox-setup <address>")
     .description("开启 agent 自持收信(Email Worker 接住入站,存收件箱)")
     .option("--forward <to>", "同时转发到个人邮箱")
-    .action((address, opts) => emit(remote
-    ? remoteClient.api.emailInboxSetup(remote, address, opts.forward)
-    : emailCore.setupInbox(ctx(), address, opts.forward)));
+    .action((address, opts) => emit(remoteClient.api.emailInboxSetup(rc(), address, opts.forward)));
 email
     .command("route <from> <to>")
     .description("配转发规则:发往 from 的邮件转发到 to")
-    .action((from, to) => emit(remote ? remoteClient.api.emailRoute(remote, from, to) : emailCore.routeEmail(ctx(), from, to)));
+    .action((from, to) => emit(remoteClient.api.emailRoute(rc(), from, to)));
 email
     .command("webhook <address> <url>")
     .description("配置入站推送:来信时 POST 信封到 url(与 status pull 并存)")
-    .action((address, url) => emit(remote
-    ? remoteClient.api.emailWebhook(remote, address, url)
-    : emailCore.setEmailWebhook(ctx(), address, url)));
+    .action((address, url) => emit(remoteClient.api.emailWebhook(rc(), address, url)));
 // 地址:tag + knowledge(客服等场景;无 build / 角色 / 记忆)
 const address = email.command("address").description("邮箱地址:加 / 改(tag + knowledge)");
 address
@@ -674,77 +570,49 @@ address
     .description("加一个地址(--tag 分类;--knowledge 挂静态知识,作答时进 system prompt)")
     .option("--tag <t>", "标签,如 客服")
     .option("--knowledge <path>", "知识文件或目录")
-    .action((addr, opts) => emit(remote
-    ? remoteClient.api.emailAddressAdd(remote, {
-        address: addr,
-        tag: opts.tag,
-        knowledge: opts.knowledge ? addressesCore.readKnowledge(opts.knowledge) : undefined,
-    })
-    : addressesCore.addAddress(ctx(), addr, { tag: opts.tag, knowledgePath: opts.knowledge })));
+    .action((addr, opts) => emit(remoteClient.api.emailAddressAdd(rc(), {
+    address: addr,
+    tag: opts.tag,
+    knowledge: opts.knowledge ? addressesCore.readKnowledge(opts.knowledge) : undefined,
+})));
 address
     .command("update <addr>")
     .description("改地址的 tag / knowledge(未传的不动)")
     .option("--tag <t>", "标签")
     .option("--knowledge <path>", "知识文件或目录")
-    .action((addr, opts) => emit(remote
-    ? remoteClient.api.emailAddressUpdate(remote, {
-        address: addr,
-        tag: opts.tag,
-        knowledge: opts.knowledge ? addressesCore.readKnowledge(opts.knowledge) : undefined,
-    })
-    : addressesCore.updateAddress(ctx(), addr, { tag: opts.tag, knowledgePath: opts.knowledge })));
+    .action((addr, opts) => emit(remoteClient.api.emailAddressUpdate(rc(), {
+    address: addr,
+    tag: opts.tag,
+    knowledge: opts.knowledge ? addressesCore.readKnowledge(opts.knowledge) : undefined,
+})));
 address
     .command("remove <addr>")
     .description("删一个地址配置(收件箱历史邮件不动)")
-    .action((addr) => emit(remote
-    ? remoteClient.api.emailAddressRemove(remote, addr)
-    : addressesCore.removeAddress(ctx(), addr)));
-withProject(email.command("list").description("列出所有地址 + tag(检出项目时只列该项目域名下的)")).action(() => emit(remote ? remoteClient.api.emailListAddresses(remote) : addressesCore.listAddresses(ctx())));
+    .action((addr) => emit(remoteClient.api.emailAddressRemove(rc(), addr)));
+withProject(email.command("list").description("列出所有地址 + tag(检出项目时只列该项目域名下的)")).action(() => emit(remoteClient.api.emailListAddresses(rc())));
 // ───────── 部署 ─────────
 withProject(program
     .command("deploy <path>")
-    .description("部署:目录 + <slug>.clize.app → 免费 handle 多文件站;或 <名> --html 内联单页")
-    .option("--domain <domain>", "目标域(<slug>.clize.app 走免费 handle)")
-    .option("--html <html>", "内联 HTML(单页 worker,不读目录)")
-    .option("--html-file <file>", "从文件读 HTML")).action((p, opts) => {
+    .description("部署:目录 + <slug>.clize.app → 免费 handle 多文件站")
+    .option("--domain <domain>", "目标域(<slug>.clize.app 走免费 handle)")).action((p, opts) => {
     // 缺 --domain 时从 ./clize.json 推导(clize init 绑过的目录免显式传参,与 email send 推 from 对称)。
     const domain = opts.domain ?? setupCore.projectDomain();
-    if (remote) {
-        let dir = false;
-        try {
-            dir = fs.statSync(p).isDirectory();
-        }
-        catch {
-            /* 非路径 */
-        }
-        if (!dir)
-            return emit(Promise.reject(new Error(`${p} 不是存在的目录 —— 先生成站点文件再 deploy(托管模式只支持目录部署;--html 内联单页暂仅本地模式)`)));
-        if (!domain)
-            return emit(Promise.reject(new Error("缺目标域:clize deploy <目录> --domain <已 claim 的 host>,或先 clize init --handle <slug> 绑定本目录免传 --domain")));
-        const files = sitesCore.readDirFiles(p);
-        const bytes = files.reduce((n, f) => n + Math.ceil(f.base64.length * 0.75), 0);
-        if (bytes > 25 * 1024 * 1024)
-            return emit(Promise.reject(new Error(`站点约 ${(bytes / 1048576).toFixed(1)}MB,超过托管部署上限 25MB;请精简`)));
-        return emit(remoteClient.api.deploy(remote, domain, files));
-    }
-    let isDir = false;
+    let dir = false;
     try {
-        isDir = fs.statSync(p).isDirectory();
+        dir = fs.statSync(p).isDirectory();
     }
     catch {
-        /* 非路径:仅显式 --html/--html-file 时才允许当 worker 名走内联(否则下面报"目录不存在") */
-    }
-    if (isDir) {
-        if (!domain)
-            return emit(Promise.reject(new Error("目录(多文件)部署需要 --domain <域名>(需已 claim / buy / import),或先 clize init 绑定本目录")));
-        return emit(sitesCore.deployToHandle(ctx(), domain, p));
+        /* 非路径 */
     }
-    // 路径不存在且没给内联 HTML:大概率是站点还没生成 / 路径打错 —— 直接说清,
-    // 绝不带着错参数去打 CF(那会报回毫不相干的 workers.dev 错误,误导排查方向)。
-    if (!opts.html && !opts.htmlFile)
-        return emit(Promise.reject(new Error(`${p} 不是存在的目录 —— 先生成站点文件再 deploy;内联单页要显式 --html "<...>" 或 --html-file <path>`)));
-    const html = opts.htmlFile ? fs.readFileSync(opts.htmlFile, "utf8") : opts.html;
-    return emit(siteCore.deploySite(ctx(), { workerName: p, html, domain: opts.domain }));
+    if (!dir)
+        return emit(Promise.reject(new Error(`${p} 不是存在的目录 —— 先生成站点文件再 deploy(托管部署支持目录部署)`)));
+    if (!domain)
+        return emit(Promise.reject(new Error("缺目标域:clize deploy <目录> --domain <已 claim 的 host>,或先 clize init --handle <slug> 绑定本目录免传 --domain")));
+    const files = sitesCore.readDirFiles(p);
+    const bytes = files.reduce((n, f) => n + Math.ceil(f.base64.length * 0.75), 0);
+    if (bytes > 25 * 1024 * 1024)
+        return emit(Promise.reject(new Error(`站点约 ${(bytes / 1048576).toFixed(1)}MB,超过托管部署上限 25MB;请精简`)));
+    return emit(remoteClient.api.deploy(rc(), domain, files));
 });
 // ───────── 本地预览(serve:deploy 的本地对偶)─────────
 // 起一个支持 Range + 媒体不灌 no-store 的静态 server —— 预览含 <video> 的站点 / 片子用它,
@@ -774,8 +642,7 @@ program
     }
 });
 // ───────── 生成式媒体(gen:图 / 视频 / 音乐)─────────
-// G1 = 本地算力 + 你自带的 model key,与 clize 登录模式无关(remote 登录也在本地跑、写本地盘);
-// 托管(clize 代付 + R2 托管)是 G2,所以这里不按 remote 分流。
+// 纯托管:平台代付 + 字节回 CLI 落盘(G2);提交 / 报价 / 轮询全经控制面,CLI 只负责读参考图、落盘成品。
 const gen = program
     .command("gen")
     .description("生成式媒体:你写 prompt,clize 产字节落盘(图 / 视频 / 音乐;蓝图批量 = check + render)");
@@ -790,51 +657,30 @@ withProject(gen
     .option("--out <path>", "落盘路径(默认 ./clize-assets/<id>_<i>.png)")
     .option("--confirm", "确认花钱生成")
     .action((prompt, opts) => {
-    if (remote) {
-        if (opts.ref || opts.mask)
-            return emit(Promise.reject(new Error("托管模式暂不支持参考图 / 蒙版(--ref/--mask);用纯文生图,或切本地模式。")));
-        return emit(remoteClient.api
-            .genImage(remote, {
-            prompt,
-            model: opts.model,
-            n: Number(opts.n),
-            size: opts.size,
-            confirm: !!opts.confirm,
-        })
-            .then((r) => mediaCore.materializeRemote(r, opts.out)));
-    }
-    return emit(mediaCore.genImage(ctx(), {
+    if (opts.ref || opts.mask)
+        return emit(Promise.reject(new Error("托管模式暂不支持参考图 / 蒙版(--ref/--mask);用纯文生图。")));
+    return emit(remoteClient.api
+        .genImage(rc(), {
         prompt,
         model: opts.model,
         n: Number(opts.n),
         size: opts.size,
-        refs: opts.ref
-            ? String(opts.ref)
-                .split(",")
-                .map((s) => s.trim())
-            : undefined,
-        mask: opts.mask,
-        out: opts.out,
-    }, { confirm: !!opts.confirm }));
+        confirm: !!opts.confirm,
+    })
+        .then((r) => mediaCore.materializeRemote(r, opts.out)));
 });
 withProject(gen
     .command("list")
     .description("列已生成资产(id / 模型 / prompt / 路径 / 花费;检出项目时只列该项目)")
-    .option("--modality <m>", "只看某模态:image | video | music")).action((opts) => emit(remote ? remoteClient.api.genList(remote, opts.modality) : mediaCore.listAssets(ctx(), opts.modality)));
+    .option("--modality <m>", "只看某模态:image | video | music")).action((opts) => emit(remoteClient.api.genList(rc(), opts.modality)));
 gen
     .command("show <id>")
     .description("看单个生成任务 / 资产全貌")
-    .action((id) => emit(remote ? remoteClient.api.genShow(remote, id) : mediaCore.getAsset(ctx(), id)));
+    .action((id) => emit(remoteClient.api.genShow(rc(), id)));
 gen
     .command("budget [set] [usd]")
     .description("设 / 查生成预批额度:额度内免逐次 --confirm(clize gen budget set 2.00 / clize gen budget)")
-    .action((setOrUsd, usd) => {
-    if (remote)
-        return emit(Promise.reject(new Error("gen budget 托管模式暂未支持(二期);托管下每次生成用 --confirm 逐次确认即可。")));
-    const raw = setOrUsd === "set" ? usd : setOrUsd;
-    const amount = raw != null && raw !== "" && !Number.isNaN(Number(raw)) ? Number(raw) : undefined;
-    return emit(amount != null ? mediaCore.setGenBudget(ctx(), amount) : mediaCore.genBudget(ctx()));
-});
+    .action(() => emit(Promise.reject(new Error("gen budget 托管模式暂未支持(二期);托管下每次生成用 --confirm 逐次确认即可。"))));
 withProject(gen
     .command("video <prompt>")
     .description("文生视频 / 图生视频(长任务:默认等到完成,--async 后台返 job id)"))
@@ -848,27 +694,16 @@ withProject(gen
     .option("--timeout <sec>", "默认等待上限(秒)", "300")
     .option("--confirm", "确认花钱生成")
     .action((prompt, opts) => {
-    if (remote) {
-        // 托管:参考图在 CLI 端读盘转 data URI 上传(首帧排第一,与本地 core 同序)。
-        const paths = [...new Set([opts.fromImage, ...splitRefs(opts.ref)].filter(Boolean))];
-        return emit((async () => remoteGenAsync(remote, "video", {
-            prompt,
-            model: opts.model,
-            refs: paths.length ? refsToDataUris(paths) : undefined,
-            durationSec: opts.duration ? Number(opts.duration) : undefined,
-            aspect: opts.aspect,
-            confirm: !!opts.confirm,
-        }, { confirm: !!opts.confirm, async: !!opts.async, out: opts.out, timeout: opts.timeout }))());
-    }
-    return emit(mediaCore.genVideo(ctx(), {
+    // 托管:参考图在 CLI 端读盘转 data URI 上传(首帧排第一,与后端同序)。
+    const paths = [...new Set([opts.fromImage, ...splitRefs(opts.ref)].filter(Boolean))];
+    return emit((async () => remoteGenAsync(rc(), "video", {
         prompt,
         model: opts.model,
-        fromImage: opts.fromImage,
-        refs: splitRefs(opts.ref),
+        refs: paths.length ? refsToDataUris(paths) : undefined,
         durationSec: opts.duration ? Number(opts.duration) : undefined,
         aspect: opts.aspect,
-        out: opts.out,
-    }, { confirm: !!opts.confirm, async: !!opts.async, timeoutSec: Number(opts.timeout) }));
+        confirm: !!opts.confirm,
+    }, { confirm: !!opts.confirm, async: !!opts.async, out: opts.out, timeout: opts.timeout }))());
 });
 withProject(gen
     .command("music <prompt>")
@@ -880,37 +715,24 @@ withProject(gen
     .option("--async", "后台生成,只返 job id(默认等到完成)")
     .option("--timeout <sec>", "默认等待上限(秒)", "300")
     .option("--confirm", "确认花钱生成")
-    .action((prompt, opts) => {
-    if (remote) {
-        return emit(remoteGenAsync(remote, "music", {
-            prompt,
-            model: opts.model,
-            instrumental: !!opts.instrumental,
-            durationSec: opts.duration ? Number(opts.duration) : undefined,
-            confirm: !!opts.confirm,
-        }, { confirm: !!opts.confirm, async: !!opts.async, out: opts.out, timeout: opts.timeout }));
-    }
-    return emit(mediaCore.genMusic(ctx(), {
-        prompt,
-        model: opts.model,
-        instrumental: !!opts.instrumental,
-        durationSec: opts.duration ? Number(opts.duration) : undefined,
-        out: opts.out,
-    }, { confirm: !!opts.confirm, async: !!opts.async, timeoutSec: Number(opts.timeout) }));
-});
-withProject(gen.command("jobs").description("列生成任务(running 置顶;断会话后重连长任务用;检出项目时只列该项目)")).action(() => emit(remote ? remoteClient.api.genJobs(remote) : mediaCore.genJobs(ctx())));
+    .action((prompt, opts) => emit(remoteGenAsync(rc(), "music", {
+    prompt,
+    model: opts.model,
+    instrumental: !!opts.instrumental,
+    durationSec: opts.duration ? Number(opts.duration) : undefined,
+    confirm: !!opts.confirm,
+}, { confirm: !!opts.confirm, async: !!opts.async, out: opts.out, timeout: opts.timeout })));
+withProject(gen.command("jobs").description("列生成任务(running 置顶;断会话后重连长任务用;检出项目时只列该项目)")).action(() => emit(remoteClient.api.genJobs(rc())));
 gen
     .command("status <id>")
     .description("查单任务:running 则向 provider 轮询一次(可能就此完成落盘)")
-    .action((id) => emit(remote
-    ? remoteClient.api
-        .genStatus(remote, id)
-        .then((r) => mediaCore.materializeRemote(r, undefined))
-    : mediaCore.genJobStatus(ctx(), id)));
+    .action((id) => emit(remoteClient.api
+    .genStatus(rc(), id)
+    .then((r) => mediaCore.materializeRemote(r, undefined))));
 gen
     .command("rm <id>")
     .description("删任务记录 + 本地文件")
-    .action((id) => emit(remote ? remoteClient.api.genRm(remote, id) : mediaCore.genRm(ctx(), id)));
+    .action((id) => emit(remoteClient.api.genRm(rc(), id)));
 // ───────── build:作品域(端到端做一个作品;方法 + 校验免费,成品步骤花钱带闸)─────────
 // taxonomy:gen = 原子生成 + 任务池(引擎),build = 作品编排门面(方法 → 你创作 → 校验 → 成品)。
 // 第 N 种作品 = build 加子域(方法三件套 + 该作品特有的校验/成品命令),顶级命令面零膨胀。
@@ -926,32 +748,32 @@ function siteBuildCommands() {
         .argument("<brief...>")
         .description("开工:返回工作流(7 步 + 反 slop)+ 风格目录 + 针对 brief 的推荐")
         .option("--project <name>", "项目名")
-        .action((brief, opts) => hostedBuild((rc) => remoteClient.api.buildSiteStart(rc, brief.join(" "), opts.project)));
+        .action((brief, opts) => hostedBuild((rcfg) => remoteClient.api.buildSiteStart(rcfg, brief.join(" "), opts.project)));
     const recommend = new Command("recommend")
         .argument("<brief...>")
         .description("按 brief 推荐:风格 + 调色板 + 字体对 + 反模式")
         .option("--project <name>", "项目名")
-        .action((brief, opts) => hostedBuild((rc) => remoteClient.api.buildSiteRecommend(rc, brief.join(" "), opts.project)));
+        .action((brief, opts) => hostedBuild((rcfg) => remoteClient.api.buildSiteRecommend(rcfg, brief.join(" "), opts.project)));
     const list = new Command("list")
         .description("列出全部风格宪法(slug + 一句话 best-for)")
-        .action(() => hostedBuild((rc) => remoteClient.api.buildSiteList(rc)));
+        .action(() => hostedBuild((rcfg) => remoteClient.api.buildSiteList(rcfg)));
     const get = new Command("get")
         .argument("<slug>")
         .description("取某风格的完整宪法(色 / 字 / 形 / 签名手法)+ imagery 配图契约 + 调色板 / 字体对 + DESIGN.md 模板")
-        .action((slug) => hostedBuild((rc) => remoteClient.api.buildSiteGet(rc, slug)));
+        .action((slug) => hostedBuild((rcfg) => remoteClient.api.buildSiteGet(rcfg, slug)));
     const stack = new Command("stack")
         .argument("<stack>")
         .argument("[query...]")
         .description("取某技术栈实现指南(React/Next/SwiftUI/Flutter/shadcn… 惯用法 + 行为规则;跨栈 UI 指南)")
-        .action((stackName, query) => hostedBuild((rc) => remoteClient.api.buildSiteStack(rc, stackName, (query || []).join(" "))));
+        .action((stackName, query) => hostedBuild((rcfg) => remoteClient.api.buildSiteStack(rcfg, stackName, (query || []).join(" "))));
     const search = new Command("search")
         .argument("<query...>")
         .description("查 UUPM 库(ux/color/chart/landing/product/typography/icons…;默认自动判域)")
         .option("--domain <d>", "限定域")
-        .action((query, opts) => hostedBuild((rc) => remoteClient.api.buildSiteSearch(rc, query.join(" "), opts.domain)));
+        .action((query, opts) => hostedBuild((rcfg) => remoteClient.api.buildSiteSearch(rcfg, query.join(" "), opts.domain)));
     const review = new Command("review")
         .description("取合并自审清单(anti-slop + DESIGN.md 保真 + UX 行为)")
-        .action(() => hostedBuild((rc) => remoteClient.api.buildSiteReview(rc)));
+        .action(() => hostedBuild((rcfg) => remoteClient.api.buildSiteReview(rcfg)));
     return [start, recommend, list, get, stack, search, review];
 }
 const buildSite = build
@@ -980,34 +802,8 @@ function readBlueprint(file) {
         throw new Error(`蓝图不是合法 JSON:${e instanceof Error ? e.message : String(e)}`);
     }
 }
-/** render 后端(本地):探价走 provider.quote;提交/轮询走 core/media(任务进 gen jobs 体系)。 */
-function localRenderBackend() {
-    return {
-        quote: (p) => mediaCore.quoteVideo(ctx(), p),
-        submit: async (p) => {
-            const r = (await mediaCore.genVideo(ctx(), { ...p }, { confirm: true, async: true }));
-            if (!r.id)
-                throw new Error(`提交未返回任务 id${r.message ? `:${String(r.message)}` : ""}`);
-            return { id: String(r.id), state: String(r.state ?? "running") };
-        },
-        poll: async (id, outPath) => {
-            const r = (await mediaCore.genJobStatus(ctx(), id));
-            if (r.state === "succeeded") {
-                const src = r.files?.[0]?.path;
-                if (src && path.resolve(src) !== path.resolve(outPath)) {
-                    fs.mkdirSync(path.dirname(outPath), { recursive: true });
-                    fs.copyFileSync(src, outPath);
-                }
-                return { state: "succeeded" };
-            }
-            if (r.state === "failed")
-                return { state: "failed", error: r.error ? String(r.error) : undefined };
-            return { state: "running" };
-        },
-    };
-}
 /** render 后端(托管):参考图逐镜转 data URI 上传;confirm=false 探价是后端契约(永不生成)。 */
-function remoteRenderBackend(rc) {
+function remoteRenderBackend(rcfg) {
     const body = (p, confirm) => ({
         prompt: p.prompt,
         model: p.model,
@@ -1018,20 +814,20 @@ function remoteRenderBackend(rc) {
     });
     return {
         quote: async (p) => {
-            const r = (await remoteClient.api.genVideo(rc, body(p, false)));
+            const r = (await remoteClient.api.genVideo(rcfg, body(p, false)));
             const est = r?.quote?.estUsd;
             if (typeof est !== "number")
                 throw new Error("探价未返回 quote(后端响应异常)");
             return est;
         },
         submit: async (p) => {
-            const r = (await remoteClient.api.genVideo(rc, body(p, true)));
+            const r = (await remoteClient.api.genVideo(rcfg, body(p, true)));
             if (!r.id)
                 throw new Error(`提交未返回任务 id${r.message ? `:${String(r.message)}` : ""}`);
             return { id: String(r.id), state: String(r.state ?? "running") };
         },
         poll: async (id, outPath) => {
-            const r = (await remoteClient.api.genStatus(rc, id));
+            const r = (await remoteClient.api.genStatus(rcfg, id));
             if (r.state === "succeeded") {
                 await mediaCore.materializeRemote(r, outPath);
                 return { state: "succeeded" };
@@ -1049,15 +845,15 @@ const buildClip = build
 buildClip
     .command("start <brief...>")
     .description("开工:返回方法(4 阶段 + 蓝图 schema + 反穿帮清单)+ 风格目录 + 针对 brief 的推荐")
-    .action((brief) => hostedBuild((rc) => remoteClient.api.buildClipStart(rc, brief.join(" "))));
+    .action((brief) => hostedBuild((rcfg) => remoteClient.api.buildClipStart(rcfg, brief.join(" "))));
 buildClip
     .command("list")
     .description("列出全部视频风格(id + 一句话适用场景)")
-    .action(() => hostedBuild((rc) => remoteClient.api.buildClipList(rc)));
+    .action(() => hostedBuild((rcfg) => remoteClient.api.buildClipList(rcfg)));
 buildClip
     .command("get <slug>")
     .description("取某风格完整包(资产图模板 + 视频视觉词汇 + strict 后端替换行)")
-    .action((slug) => hostedBuild((rc) => remoteClient.api.buildClipGet(rc, slug)));
+    .action((slug) => hostedBuild((rcfg) => remoteClient.api.buildClipGet(rcfg, slug)));
 buildClip
     .command("check <blueprint>")
     .description("蓝图机械校验(本地、免费、零凭证):防穿帮 lint + 台词覆盖 + 时长公式 + 结构;error 清零才 render")
@@ -1069,7 +865,7 @@ withProject(buildClip
     .option("--out-dir <dir>", "输出目录(默认 clize-video/<title>)")
     .option("--timeout <sec>", "轮询总时限(秒)", "1800")
     .option("--confirm", "确认花钱生成(报价见无 --confirm 的输出)")
-    .action((file, opts) => emit(videoCore.renderBlueprint(remote ? remoteRenderBackend(remote) : localRenderBackend(), readBlueprint(file), {
+    .action((file, opts) => emit(videoCore.renderBlueprint(remoteRenderBackend(rc()), readBlueprint(file), {
     confirm: !!opts.confirm,
     candidates: Number(opts.candidates) || 1,
     outDir: opts.outDir,