huawei-cloud-maas-setup

name	huawei-cloud-maas-setup
description	引导用户完成华为云 MaaS 服务购买和 API 配置。脚本自动完成授权更新、API Key 创建、模型开通；用户只需完成登录、充值、选择要开通的模型。整个流程预计 3-5 分钟。 适用于首次运行配置、华为云 MaaS 服务开通、API 凭证获取、模型服务配置等场景。 当用户提到华为云、MaaS、Maas、开通模型服务、配置 API、首次配置、引导配置、 一键配置等意图时触发。
allowed_tools	["bash","ask_user"]
version	4.0.0

华为云 MaaS 一键配置

设计原则：脚本做自动化（授权、Key、模型开通、弹窗关闭、实名检测），用户做决策（登录、 充值+认证、选哪个模型、最终确认）。整个流程预计 3-5 分钟。

• 脚本自动：跳转 URL、自动关闭引导弹窗、自动检测实名认证状态、自动检测授权、 自动创建 Key 并提取、自动开通模型
• 用户决策：登录（涉及账号）、充值+认证（涉及个人信息和支付）、选择要开通的模型（业务决策）、最终确认
• 价值：规避 DOM 选择器脆弱性、避开 LLM ReAct 慢路径、保留用户掌控感

流程概览

步骤	Skill 动作	用户动作	脚本
0	确保浏览器已启动	-	ensure_browser.py
1	跳转到费用中心首页	登录	navigate.py
2	检测账号状态 + 引导充值/认证	充值 + 实名认证	check_account.py
3	跳转 + 自动同意声明 + 自动授权	-	navigate.py + auto_authorize.py
4	跳转 + 自动创建 Key	-	navigate.py + auto_create_apikey.py
5	跳转 + 自动批量开通模型	-	navigate.py + auto_open_model.py
6	写入配置（直接执行）	-	config_writer.py add
7	设置引导完成标志	-	Python 命令
8	完成提示	-	自然语言

步骤 1 落地费用中心页，登录后页面不变，无需额外跳转。 步骤 2 通过 check_account.py 自动关闭引导弹窗 + 检测实名状态（window.myRoleTags）， 据此决定 ask_user 文案：已认证只引导充值，未认证引导充值+认证（充值会触发认证引导）。 步骤 4 保留 realname_required / insufficient_balance 懒检测作为兜底。

公共说明

脚本位置

所有脚本位于 <skill_dir>/scripts/：

• navigate.py - 通用 URL 跳转
• ensure_browser.py - 启动浏览器
• check_account.py - 关闭引导弹窗 + 检测实名认证状态
• auto_authorize.py - 自动同意 MaaS 服务声明 + 自动完成委托授权
• auto_create_apikey.py - 自动创建 API Key（含欠费/未实名检测）
• auto_open_model.py - 自动批量开通预置模型
• config_writer.py - 写入配置（追加，不设默认）

公共参数

所有脚本支持：

• --cdp-url <URL> - CDP endpoint，留空自动从 profiles.json 解析
• --json - JSON 格式输出

模型列表配置

模型列表统一定义在 <skill_dir>/models.json 中，修改该文件即可调整开通和写入的模型：

{
  "models": [
    {"display_name": "Qwen3-30B-A3B", "api_name": "qwen3-30b-a3b", "alias": "huawei-qwen", "description": "主力对话模型"},
    {"display_name": "GLM-5.2", "api_name": "glm-5.2", "alias": "huawei-glm", "description": "备选对话模型"},
    {"display_name": "DeepSeek-V4-Flash", "api_name": "deepseek-v4-flash", "alias": "huawei-deepseek", "description": "快速推理模型"}
  ]

字段	用途	用于步骤
display_name	控制台显示名称，用于勾选开通	步骤 5
api_name	API 调用标识，写入 config.yaml	步骤 6
alias	jiuwenswarm 中的模型别名	步骤 6
description	模型描述，用于完成提示	步骤 8

步骤 5 和步骤 6 默认从 models.json 读取，也支持 --model 参数逐个指定（优先级更高）。

失败与降级策略

• 任意脚本返回 {"ok": false, "stage": "...", "error": "..."} 时：
  • 通过 ask_user 提示用户在浏览器中手动完成对应步骤（遵循「窗口切换提示约定」）
  • 用户手动完成后，单独重试该步骤的脚本（不重头开始）
• 步骤 4（Key）未实名认证时 -> 复用步骤 2 的实名认证引导 -> 重新执行步骤 4
• 步骤 4（Key）欠费时 -> 复用步骤 2 的充值引导 -> 重新执行步骤 4
• 步骤 4（Key）提取失败时，用户可手动粘贴 Key，仍走步骤 6-7
• 步骤 5（模型开通）部分失败时，跳过失败模型，仅写入成功的模型
• 任意步骤可让用户"完全手动配置"，引导至「设置 -> 模型」手动填入

窗口切换提示约定

当步骤需要用户在浏览器中操作时，必须遵循三层模式：

1. ask_user 之前输出加粗正文，且与 ask_user 调用同轮发出（先输出正文作为本条回复内容， 再在同一回复内调用 ask_user，禁止分两轮：先发纯文本正文、等下一轮推理再调用）：

   浏览器已在后台打开了一个新窗口。请切换到浏览器窗口完成 XXX，完成后回到此窗口继续。

2. ask_user prompt 使用统一视觉标记：

   🔔 浏览器已打开 XXX 页面，请在浏览器中完成以下操作。
   
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   ▶ 切换到浏览器窗口，完成：
   ▸ 具体操作步骤...
   ▸ ...
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   ◀ 完成后回到此会话窗口，选择下方选项继续
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   
   请选择：
   ○ ✅ 已在浏览器完成 XXX，回到会话继续
   ○ ⚠️ 遇到问题，我先去浏览器处理
   ○ 取消配置
   

3. 选项文案：已完成类加 ✅ 前缀，需处理类加 ⚠️ 前缀。

正文输出约定（避免把正文切碎）

背景：前端会把连续的「思考+工具」折叠成一条"已完成 X 次思考，X 次工具调用"的折叠条， 且每发一段 assistant 正文都会触发一次折叠，在两段正文之间冒出一条折叠条。若每跑一个 脚本都夹一段进度正文，正文会被这些折叠条切成碎片。

1. 连续自动调用之间不夹进度正文：步骤 0、3、4、5、6、7 这类纯自动脚本调用，禁止在每次 调用前都输出"▶ 步骤 N/8：..."进度正文。开头说一句开场白即可，然后连续发起所有自动脚本 调用（允许同轮并列多个 bash，或前一脚本返回后立即调用下一脚本、中间不补正文），让它们 合并进同一个折叠段。一旦夹了进度正文，就会触发折叠，把正文打成一段段。
2. 仅在这些时机发正文：
   • 需要 ask_user 用户决策时（步骤 1 登录、步骤 2 充值/认证、步骤 4 欠费/未实名/提取失败降级）：正文与 ask_user 必须同轮发出（先写正文，再在同一回复内调用 ask_user，禁止分两轮）。
   • 失败降级提示时，按「窗口切换提示约定」用 ask_user 一并呈现（正文与 ask_user 同轮）。
   • 步骤 8 完成提示（用自然语言收尾）。
3. 结果摘要并入下一步，不单开一轮：脚本结果正常时，不要为单个脚本单独发一条"✅ 结果摘要" 正文；如有必要展示，并入下一个 ask_user 正文或步骤 8 的完成提示。仅当失败降级或需用户 决策时才单独发正文（且与 ask_user 同轮）。

步骤 0：确保浏览器已启动

python <skill_dir>/scripts/ensure_browser.py --json

期望输出：

{"ok": true, "stage": "browser_started" | "browser_ready",
 "cdp_url": "http://127.0.0.1:9333", "browser_family": "edge", "started_now": true}

若 ok=false, stage=no_browser -> 提示用户安装 Edge/Chrome/Chromium 后重试。

步骤 1：跳转到费用中心首页 + 等待登录

python <skill_dir>/scripts/navigate.py --json --cdp-url "<CDP_URL>" \
  --url "https://account.huaweicloud.com/usercenter/?region=cn-southwest-2#/userindex/allview"

先输出加粗正文，再 ask_user：

浏览器已在后台打开了一个新窗口。请切换到浏览器窗口完成登录，完成后回到此窗口继续。

🔔 浏览器已打开华为云费用中心，请在浏览器中完成以下操作。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▶ 切换到浏览器窗口，完成：
▸ 【登录】用您的华为云账号登录（首次使用需先注册 https://reg.huaweicloud.com/）
▸ 完成后页面应显示费用中心首页，右上角能看到您的账号
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◀ 完成后回到此会话窗口，选择下方选项继续
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

请选择：
○ ✅ 已在浏览器完成登录，回到会话继续
○ 取消配置

设计目的：费用中心作为登录落地页，登录后页面不变，步骤 2 直接在当前页面检测账号状态， 无需额外跳转。

步骤 2：检测账号状态 + 引导充值/认证

用户确认登录后，运行 check_account.py 自动关闭引导弹窗并检测实名认证状态：

python <skill_dir>/scripts/check_account.py --json --cdp-url "<CDP_URL>"

期望输出（已认证）：

{
  "ok": true,
  "stage": "check_account",
  "realname_authenticated": true,
  "popups_closed": 1,
  "realname_auth_url": "https://account.huaweicloud.com/usercenter/?locale=zh-cn#/accountindex/realNameAuth"
}

期望输出（未认证）：

{
  "ok": true,
  "stage": "check_account",
  "realname_authenticated": false,
  "popups_closed": 1,
  "realname_auth_url": "https://account.huaweicloud.com/usercenter/?locale=zh-cn#/accountindex/realNameAuth"
}

根据检测结果决定 ask_user 文案

重要：此步骤不需要额外执行 navigate.py 跳转。用户已在步骤 1 打开费用中心页面， 该页面已显示余额信息和充值入口。check_account.py 只做检测和关弹窗，不导航。 直接根据检测结果发 ask_user，引导用户在当前页面操作。

情况 A：realname_authenticated=true（已认证） — 只引导充值：

先输出加粗正文，再 ask_user：

检测到您的账号已完成实名认证。请在费用中心页面完成充值，完成后回到此窗口继续。

🔔 浏览器当前已显示费用中心页面，请在页面上完成充值。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▶ 在当前费用中心页面，完成：
▸ 找到页面上的"充值"按钮或入口
▸ 充值方式：微信 / 支付宝 / 银行转账
▸ 建议金额：≥ 5 元即可
▸ MaaS 按调用量计费，不使用不产生费用
▸ 如已有余额可直接跳过
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◀ 完成后回到此会话窗口，选择下方选项继续
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

请选择：
○ ✅ 已完成充值（或已有余额），回到会话继续
○ 跳过充值，稍后再说
○ 取消配置

情况 B：realname_authenticated=false（未认证） — 引导充值+认证：

先输出加粗正文，再 ask_user：

检测到您的账号尚未完成实名认证。请在费用中心页面完成充值和实名认证，完成后回到此窗口继续。

🔔 浏览器当前已显示费用中心页面，请在页面上完成以下操作。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▶ 在当前费用中心页面，完成：
▸ 【充值】找到页面上的"充值"按钮，充值几元（微信 / 支付宝 / 银行转账）
▸ 充值时系统会提示您完成实名认证
▸ 选择"个人支付宝认证"，扫码完成人脸识别即可
▸ 仅支持持有中国大陆居民身份证的用户，外籍人士请选择"个人证件认证"
▸ 完成充值和认证后回到此窗口
▸ MaaS 按调用量计费，不使用不产生费用
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◀ 完成后回到此会话窗口，选择下方选项继续
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

请选择：
○ ✅ 已完成充值和实名认证，回到会话继续
○ ⚠️ 遇到问题，我先去浏览器处理
○ 取消配置

设计目的：华为云充值时会自动触发实名认证引导，因此充值+认证可合并为一个用户操作流。 已认证用户只需充值，未认证用户在充值过程中顺带完成认证，不多走一步。 实名认证是创建 API Key 的前置条件，未认证时创建 Key 会报 "Cloud services require real-name authentication" 错误。

步骤 3：自动完成委托授权

python <skill_dir>/scripts/navigate.py --json --cdp-url "<CDP_URL>" \
  --url "https://console.huaweicloud.com/modelarts/?region=cn-southwest-2#/model-studio/homepage"

python <skill_dir>/scripts/auto_authorize.py --json --cdp-url "<CDP_URL>"

服务声明自动同意：新用户首次打开 MaaS 控制台时，页面会弹出"MaaS 服务声明" 对话框（含"我已阅读并同意"复选框和"确定"按钮）。auto_authorize.py 在检测授权 警告之前会先处理此弹窗——自动勾选复选框、等待"确定"按钮启用后点击确认，无需 用户手动操作。非首次访问时弹窗不会出现，脚本自动跳过。

期望输出（无警告，已授权）：

{"ok": true, "stage": "authorize", "auth_done": false, "skipped_reason": "no_warning", "disclaimer_handled": false}

期望输出（成功更新，首次访问处理了服务声明）：

{"ok": true, "stage": "authorize", "auth_done": true, "skipped_reason": null, "disclaimer_handled": true}

失败降级（如选择器失效）：ok=false -> 提示用户手动完成委托授权（参考 华为云 MaaS 访问授权文档）， 然后重试 auto_authorize.py。

步骤 4：自动创建 API Key（含欠费/未实名检测）

⚠️ 串行约束：下面两个脚本必须按顺序串行执行——先跑 navigate.py 并等待其 stdout 返回 {"ok": true} 后再执行 auto_create_apikey.py。严禁并行调用： 两者会对同一浏览器同一 page 做 goto（加载竞态），SPA 尚未渲染完成时按钮会被误判为 找不到（create_btn_not_found），从而错误触发"手动创建"降级。

python <skill_dir>/scripts/navigate.py --json --cdp-url "<CDP_URL>" \
  --url "https://console.huaweicloud.com/modelarts/?region=cn-southwest-2#/model-studio/authmanage"

python <skill_dir>/scripts/auto_create_apikey.py --json --cdp-url "<CDP_URL>" \
  --tag "jiuwenswarm" \
  --description "jiuwenswarm-config"

期望输出（成功）：

{
  "ok": true,
  "stage": "apikey",
  "api_key": "ABh8zqX4...完整Key...rQfg",
  "tag": "jiuwenswarm",
  "description": "jiuwenswarm-config"
}

欠费时输出：

{
  "ok": false,
  "stage": "insufficient_balance",
  "error": "账户余额不足，请先充值后再创建 API Key",
  "recharge_url": "https://account.huaweicloud.com/usercenter/#/accountindex/balance"
}

未实名认证时输出：

{
  "ok": false,
  "stage": "realname_required",
  "error": "账号未完成实名认证，请先完成实名认证后再创建 API Key",
  "realname_url": "https://account.huaweicloud.com/usercenter/?locale=zh-cn#/accountindex/realNameAuth"
}

步骤 4 欠费处理

当返回 stage=insufficient_balance 时，复用步骤 2 的充值引导（跳转充值页 + ask_user）， 用户确认充值后重新执行步骤 4。

步骤 4 提取失败

当 stage=extract_failed 时，提示用户手动在浏览器中创建 API Key 并通过 ask_user 黏贴完整值 （用户提供 Key 后仍走步骤 6-7）。

步骤 4 未实名认证处理

当返回 stage=realname_required 时，复用步骤 2 的实名认证引导（跳转实名认证页 + ask_user）， 用户确认完成实名认证后重新执行步骤 4。

步骤 5：自动批量开通热门模型

python <skill_dir>/scripts/navigate.py --json --cdp-url "<CDP_URL>" \
  --url "https://console.huaweicloud.com/modelarts/?region=cn-southwest-2#/model-studio/deployment"

python <skill_dir>/scripts/auto_open_model.py --json --cdp-url "<CDP_URL>" \
  --models-file "<skill_dir>/models.json" \
  --timeout 90

流程说明：脚本会搜索第一个目标模型，点击其**"开通服务"**按钮打开 批量订阅弹窗，在弹窗中一次性勾选所有目标模型并点击"一键开通"。 已开通的模型自动跳过。

期望输出：

{
  "ok": true,
  "stage": "open_models",
  "models": ["GLM-5.2", "Kimi-K2.6", "DeepSeek-V4-Flash"],
  "opened": ["GLM-5.2", "DeepSeek-V4-Flash"],
  "already_opened": ["Kimi-K2.6"],
  "failed": [],
  "all_done": true
}

模型名称以 models.json 为准，此处仅为示例。 仅开通文本生成类型的服务；可通过 --type-filter 参数调整类型。

失败降级：failed 列表不为空时，提示用户哪些模型开通失败（未找到、 类型不符、按钮/弹窗异常等），用户可手动在浏览器中开通，或跳过失败的模型继续后续步骤。

步骤 6：写入配置（直接执行，无需确认）

python <skill_dir>/scripts/config_writer.py add --json \
  --api-base "https://api.modelarts-maas.com/openai/v1" \
  --api-key "<步骤 4 提取的完整 API Key>" \
  --models-file "<skill_dir>/models.json"

期望输出：

{
  "env_path": "C:\\Users\\xxx\\.jiuwenswarm\\config\\.env",
  "written_aliases": ["huawei-qwen", "huawei-glm", "huawei-deepseek"],
  "api_base": "https://api.modelarts-maas.com/openai/v1",
  "models": ["qwen3-30b-a3b", "glm-5.2", "deepseek-v4-flash"]
}

.env 使用 HUAWEI_MAAS_ 前缀隔离，不覆盖用户已有配置。 config.yaml 按 alias 追加/更新，不修改任何 is_default。

步骤 7：设置引导完成标志

python -c "import yaml; from pathlib import Path; p = Path.home() / '.jiuwenswarm' / 'config' / 'config.yaml'; c = yaml.safe_load(p.read_text(encoding='utf-8')); c.setdefault('setup_guide', {})['enabled'] = False; p.write_text(yaml.dump(c, allow_unicode=True, default_flow_style=False), encoding='utf-8'); print('setup_guide.enabled = false')"

设置 setup_guide.enabled = false，下次启动不再弹出引导界面。

步骤 8：完成

向用户发送（用自然语言，不要用代码块包裹）：

🎉 华为云 MaaS 服务配置完成！

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 配置摘要

  ✅ API 连接：已配置
  ✅ 模型服务：已开通以下模型
     • Qwen3-30B-A3B（主力对话模型）
     • GLM-5.2（备选对话模型）
     • DeepSeek-V4-Flash（快速推理模型）
  ✅ 配置写入：已保存到本地

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️ 重要提示

▸ 重启生效：配置写入后需要重启 jiuwenswarm 才能生效。重启后即可在对话中选择新加入的华为云模型。

▸ 原有配置保持不变：您的原有模型配置和默认模型设置完全保留，未做任何修改。如需切换默认模型，可前往「设置 -> 模型」进行调整。

▸ 模型服务状态：以上模型已在华为云控制台完成开通。如需开通更多模型，请前往：华为云控制台 -> ModelArts -> 在线推理 -> 预置服务

▸ 计费说明：华为云 MaaS 按实际调用量计费，不使用不产生费用。建议保持账户余额充足，避免欠费导致服务中断。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🚀 下一步

请重启 jiuwenswarm，然后在对话中选择华为云模型开始使用！

如有问题，可随时询问我。

浏览器零配置

ensure_browser.py 内部自动检测浏览器（按 OS 优先级）：

• Windows: Edge（系统自带）> Chrome > Chromium
• macOS: Chrome > Edge > Chromium
• Linux: Chrome > Chromium > Edge

首次启动自动写入 ~/.jiuwenswarm/.browser/profiles.json， 后续启动直接复用。

关键设计取舍

决策	选择	理由
服务声明	脚本自动同意	仅首次出现，DOM 固定（id/data-qa-id 稳定），无决策风险
授权做不做	脚本自动	DOM 固定，确定性高，5-10s 可完成
Key 怎么拿	脚本自动提取	多级策略保证可靠；欠费/未实名时复用对应引导
充值+认证引导	登录后主动提醒	proactive 避免后续欠费/未实名失败；充值时触发认证，合并为一个操作流
实名状态检测	脚本自动检测	通过 window.myRoleTags JS 变量检测，不依赖脆弱 DOM 文案
引导弹窗	脚本自动关闭	ti-guide-modal 干扰自动化，点击关闭按钮即可
开通哪些模型	脚本自动批量开通	列表定义在 models.json，可随时调整
设不设默认	不设默认	仅追加到列表，用户原有默认不变
登录	用户做	涉及账号、验证码、反爬
充值+认证	用户做	涉及个人信息、支付宝扫码、人脸识别，无法自动化
最终确认	用户做	写入不可逆 + 脱敏 Key 展示