文档地址 https://docs.hamibot.com/

在 Hamibot 中为脚本（如“猫眼脚本”）填写参数，你需要通过配置脚本的表单来实现。这些参数会以键值对的形式存储在 hamibot.env 对象中，你可以在脚本代码中读取并使用。

步骤说明：

1. 定义表单结构
   在脚本的配置页面中，你需要设置一个 JSON 格式的表单结构，用于让用户输入参数。例如，如果你需要一个“城市”和“查询关键词”作为参数，可以这样写：

   [
     {
       "label": "城市",
       "name": "city",
       "placeholder": "请输入城市名称",
       "validation": "required"
     },
     {
       "label": "搜索关键词",
       "name": "keyword",
       "placeholder": "例如：演唱会",
       "help": "填写你想搜索的内容"
     }
   ]
   

2. 在脚本中读取参数
   保存后，在你的脚本代码中通过 hamibot.env 获取这些值：

   // 文档地址 https://docs.hamibot.com/
   const { city, keyword } = hamibot.env;
   
   if (!city || !keyword) {
     toastLog("缺少必要参数，请在脚本设置中填写");
     exit();
   }
   
   log("城市: " + city);
   log("关键词: " + keyword);
   
   // 后续可以用这些变量发起网络请求或执行自动化操作
   

3. 运行时传参（可选）
   如果你是通过 API 触发脚本运行，也可以在请求体中通过 vars 字段传递参数：

   curl -X POST \
     -H "Authorization: hmp_xxxxx" \
     -H "Content-Type: application/json" \
     -d '{
       "devices": [{"_id": "你的设备ID"}],
       "vars": {
         "city": "北京",
         "keyword": "演唱会"
       }
     }' \
     https://api.hamibot.com/v1/scripts/脚本_id/run
   

4. 注意事项

   • name 字段不能使用 JavaScript 保留字或 Hamibot 内置对象名（如 id, app, if 等）。
   • 所有参数默认是字符串类型，如果需要布尔值或数字，需手动转换。
   • 脚本设置中建议开启“启用脚本信息”，以便通过 postMessage 查看运行状态。

完成以上步骤后，你就可以灵活地为猫眼脚本或其他任意脚本传入运行所需的参数了。