跳到主要内容

# 请求文本回复 (LCC.assist.ask_text)

## 声明​

    result, err, task = LCC.assist.ask_text(options)

## 参数​

- options
  表类型，人工辅助请求配置。字段见 通用参数与返回对象。本函数会自动设置 `type = "text"`。

## 返回值​

- result
  表类型或 `nil`；成功时通常为 `{ kind = "text-reply", text = "..." }`。
- err
  字符串型或 `nil`；失败时返回错误描述。
- task
  表类型或 `nil`；最后一次任务状态。

## 说明​

> 用于验证码、短信码、口令等“人工给一段文本，脚本能继续”的场景。
> 不要把文本回复用于“用户要判断下一步怎么办”的场景；这类情况应使用 `request_control()`。

## 示例​

    local result, err = LCC.assist.ask_text({
        title = "输入验证码",
        text = "请查看截图中的验证码并输入",
        screenshotLocalPath = XXT_SCRIPTS_PATH .. "/captcha.png",
        timeout = 120,
    })

    if result then
        sys.input_text(result.text, false)
    else
        nLog("辅助失败", err)
    end