API 参考

Legado Tauri 书源引擎通过 legado.* 命名空间向脚本注入宿主 API。所有 API 均为同步阻塞调用，无需 async/await。

API 分类总览

HTTP 请求

API	说明
`legado.http.get(url, headers?)`	同步 GET 请求
`legado.http.post(url, body, headers?)`	同步 POST 请求
`legado.http.postBinary(url, base64Body, headers?)`	二进制 POST 请求
`legado.http.batchGet(urls, headers?, concurrency?)`	并发批量 GET
`legado.http.request(options)`	统一 HTTP 接口（仅 GUI）

DOM 解析

API	说明
`legado.dom.parse(html)`	解析 HTML → 文档句柄
`legado.dom.select(handle, sel)`	CSS 选择首个匹配
`legado.dom.selectAll(handle, sel)`	CSS 选择全部匹配
`legado.dom.text(handle)`	获取元素全部文本
`legado.dom.html(handle)`	获取 innerHTML
`legado.dom.attr(handle, name)`	获取属性值
`legado.dom.selectText(handle, sel)`	快捷：select + text
`legado.dom.selectAttr(handle, sel, attr)`	快捷：select + attr
`legado.dom.selectAllTexts(handle, sel)`	快捷：selectAll + text
`legado.dom.selectAllAttrs(handle, sel, attr)`	快捷：selectAll + attr
`legado.dom.selectByText(handle, text)`	按文本查找元素
`legado.dom.remove(handle, sel)`	移除匹配元素
`legado.dom.free(handle)`	释放文档句柄

编码与加密

API	说明
`legado.base64Encode(str)`	Base64 编码
`legado.base64Decode(str)`	Base64 解码
`legado.urlEncode(str)`	URL 编码
`legado.urlDecode(str)`	URL 解码
`legado.md5(str)`	MD5 哈希
`legado.sha1(str)` / `sha256(str)`	SHA 哈希
`legado.aesEncrypt(...)` / `aesDecrypt(...)`	AES 加解密
`legado.desEncrypt(...)` / `desDecrypt(...)`	DES 加解密

浏览器探测

API	说明
`legado.browser.create(options?)`	创建探测会话
`legado.browser.acquire(role, options?)`	获取命名会话
`legado.browser.navigate(id, url, options?)`	导航到 URL
`legado.browser.eval(id, code, options?)`	执行页面 JS
`legado.browser.run(url, code, options?)`	一次性导航 + 执行
`legado.browser.html(id)` / `text(id)` / `url(id)`	读取页面内容
`legado.browser.cookies(url?)`	读取 Cookie

图片处理

API	说明
`legado.image.decode(base64)`	解码图片 → 句柄
`legado.image.create(w, h)`	创建空白图片
`legado.image.crop(handle, x, y, w, h)`	裁剪
`legado.image.paste(dest, src, x, y)`	粘贴
`legado.image.encode(handle, format?)`	编码为 base64

其他

API	说明
`legado.log(msg)`	打印日志
`legado.toast(msg)`	显示通知
`legado.config.read(scope, key)`	读取配置
`legado.config.write(scope, key, value)`	写入配置
`legado.ui.emit(event, data)`	推送 UI 事件