TagUI 跨平台安装部署完全指南：Windows / macOS / Linux 环境配置与首次运行验证

TagUI 跨平台安装部署完全指南：Windows / macOS / Linux 环境配置与首次运行验证

发布时间：2026/10/7 21:05:36
TagUI 跨平台安装部署完全指南：Windows / macOS / Linux 环境配置与首次运行验证 GUI 自动化浏览器控制工作流自动化【免费下载链接】TagUIFree RPA tool by AI Singapore项目地址https://gitcode.com/gh_mirrors/ta/TagUI点击查看免费下载TagUI 是由 AI Singapore 推出的免费开源 RPA机器人流程自动化工具通过简单的 TagUI 语言即可自动化桌面、网页、鼠标与键盘操作。本文以仓库官方安装文档docs/setup.rst为骨架结合 src/tagui、src/tagui.cmd 等启动器源码与示例流程系统讲解 Windows、macOS、Linux 三大平台的完整安装流程、依赖准备、首次运行验证、版本更新机制与常见故障排查。读完本文你将能够独立完成 TagUI 环境搭建并成功运行第一个自动化流程。一、安装前的环境准备三个跨平台通用依赖在进入分平台安装步骤之前先明确 TagUI 运行所需的公共依赖。根据 docs/setup.rst 的说明无论哪个平台以下三者缺一不可依赖用途说明OpenJDK 8驱动 SikuliX 视觉自动化引擎Windows 与 macOS 使用安装包.msi / .pkgLinux 使用压缩包.tar.gz均来自 Amazon Corretto 8 发行版Chrome 浏览器承载 Web 自动化TagUI 对 Chrome/Edge 有原生集成支持DOM 与 XPath 定位方式仅对 Chrome/Edge 生效后续运行流程均依赖 ChromePHP 运行时支撑解析、WebSocket 通信等核心逻辑不同平台情况不同Windows 安装包已内置 PHPmacOS Monterey 及更新版本、多数 Linux 发行版如 Ubuntu需要自行单独安装其中 PHP 依赖在官方 故障排查文档 中被明确提及macOS 从 Monterey 起不再预装 PHP需要单独安装Linux 上 Ubuntu 等发行版默认不带 PHP也需要自行安装。这是新手安装时最容易遗漏的一环。此外如果你计划使用视觉自动化、OCR 与基于屏幕坐标的键盘步骤Linux 平台还需要参照 SikuliX 官方文档完成额外的手动配置详见下文故障排查章节。二、Windows 平台安装步骤官方文档为 Windows 用户给出了如下完整流程每一步都直接可操作下载安装包下载TagUI v6.110 for Windows的 zip 压缩包官方 releases 页面提供路径为TagUI_Windows.zip。若源码方式安装可将本仓库 src、flows 等目录解压到C:\下形成C:\tagui结构。解压到C:\将压缩包内容解压至C:\根目录得到C:\tagui目录。若系统提示无权写入C:\根目录可改解压到 Windows 桌面故障排查章节有说明。安装 OpenJDK for Windows使用 Amazon Corretto 8 的 Windows 安装包.msi完成安装后 Java 环境即被注册到系统。安装 Chrome 浏览器从 Google Chrome 官方渠道安装TagUI 启动器会按预设路径自动查找 Chrome 可执行文件。把c:\tagui\src加入 PATH 环境变量这样在任何目录下都能直接调用tagui命令。打开「系统属性 → 环境变量 → Path」新增一条c:\tagui\src即可。打开命令提示符Command Prompt。复制并运行第一条命令验证安装tagui c:\tagui\flows\samples\1_google.tag拉取最新功能与修复执行更新命令tagui update若遇到问题参考本文「故障排查」章节。流程运行成功即表示你的第一个 TagUI flow 已经跑通。关于第 5 步从启动器源码 src/tagui.cmd 可以看到Windows 版启动器还会在运行时动态探测 Chrome 的位置优先C:\Program Files (x86)\Google\Chrome\Application\chrome.exe其次C:\Program Files\Google\Chrome\Application\chrome.exe最后回退到%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe。因此即使 Chrome 安装路径与默认不同也大概率能被自动找到。Windows 可选组件Office 插件官方安装文档还提供了两个可选组件用于把 RPA 能力嵌入日常办公软件Microsoft Word 插件下载TagUI WordAddIn安装包解压后双击Setup.exe即可。它是一个功能完整的图形化应用让非技术人员也能通过 Word 界面创建和运行 RPA 机器人。对应源码位于 src/office/word/TagUIWordAddIn。Microsoft Excel 插件下载TagUIExcelAddIn安装包用于在 Excel 中定义 RPA 数据参数并从 Excel 启动 TagUI适合数据驱动的批量自动化与可视化场景。对应源码位于 src/office/excel/TagUIExcelAddIn。三、macOS / Linux 平台安装步骤官方文档为 macOS 与 Linux 给出了统一的流程核心区别在于解压位置与符号链接方式下载安装包分别下载TagUI v6.110 for macOSTagUI_macOS.zip或TagUI for LinuxTagUI_Linux.zip。解压macOS 解压到桌面DesktopLinux 解压到/home/你的用户名目录即$HOME下。安装 OpenJDKmacOS 使用 Corretto 8 的 .pkg 安装包Linux 使用 .tar.gz 压缩包解压后配置JAVA_HOME与 PATH 即可。安装 Chrome 浏览器。打开终端Terminal。创建符号链接并运行首个流程其中your_tagui_path替换为实际解压路径sudo ln -sf /your_tagui_path/tagui/src/tagui /usr/local/bin/tagui tagui /your_tagui_path/tagui/flows/samples/1_google.tagln -sf建立软链接后tagui命令即可全局调用。从源码看src/tagui 是一个 bash 脚本它会解析软链接通过readlink循环解析定位真实的 TagUI 目录因此以软链接方式运行完全没有问题。更新到最新版本tagui update遇到问题参考本文故障排查章节。同样地流程运行成功即代表安装完成。macOS 用户注意由于苹果系统安全策略收紧首次运行可能触发 PhantomJS 与 Java 弹窗拦截需要到「系统偏好设置 → 安全性与隐私」中放行详见故障排查章节。从源码安装的另一种方式git clone除下载发布包外也可以直接克隆仓库到本地再使用源码运行git clone https://gitcode.com/gh_mirrors/ta/TagUI克隆后仓库根目录即相当于解压后的tagui目录随后按上文第 58 步建立软链接并运行示例即可。源码目录布局为核心启动器与解析器位于 src示例流程位于 flows/samples官方文档位于 docs。四、验证安装逐行拆解示例流程1_google.tag无论哪个平台验证安装都使用同一个示例在 Google 上搜索关键词、点击第一个结果并截图。完整内容见 flows/samples/1_google.tag逐行含义如下// 访问 google.com不带 https:// 前缀也可以 https://www.google.com // 用 XPath 精确定位搜索框输入 latest movies 并回车 type //*[nameq] as latest movies click btnK // 用 XPath 点击第一个搜索结果 click (//*[classyuRUbf])[1]//a // 等待 3 秒让页面加载完成 wait 3 // 将网页截图保存到 top_result.png snap page to top_result.png这段流程展示了 TagUI 语言的核心要素visit访问网页直接写 URL 即可等价于内置的visit步骤type输入文本type 定位器 as 文本这里用 XPath//*[nameq]定位 Google 搜索框比单纯依赖元素文本更稳定click点击click btnK通过 id/name/class/text 匹配按钮click (//*[classyuRUbf])[1]//a则用 XPath 精准命中结果链接wait等待wait 3表示等待 3 秒语法上wait 3 seconds同样合法snap截图snap page to top_result.png把当前页面保存为截图。运行成功后当前目录会生成top_result.png截图文件。若想了解 TagUI 语言的完整概念流程、步骤、标识符、Live 模式、条件与循环、辅助函数可阅读官方文档 docs/main_concepts.rst仓库 flows/samples 下还提供了循环、条件、数据表、中文流程8_chineseflow.tag、Lazada 电商自动化9_lazada.tag等 9 个可运行示例。五、版本更新机制tagui update的源码原理官方安装流程的最后一步都是执行tagui update用于「拉取最新功能与 bug 修复」。其底层机制在启动器源码中清晰可见以 Linux 版 src/tagui 为例更新流程为通过 curl 下载远程仓库最新版启动器脚本tagui_master并校验其中是否包含版本号标记echo tagui v字样防止下载到错误内容用grep提取远程版本号TAGUI_MASTER_VERSION与本机版本号TAGUI_LOCAL_VERSION并比较——若一致则提示「已经是最新版本」并退出若版本落后则下载 master 分支的 zip 包解压后以src、flows、docs、README.md、LICENSE.md等目录覆盖本机对应内容最后提示更新完成。Windows 版 src/tagui.cmd 的update分支逻辑与此一致下载tagui_master.cmd比对版本号再用内置tar解压覆盖。建议执行tagui update前先备份当前版本启动器帮助文本中也明确提示please backup your version beforehand更新依赖网络访问仓库服务器无网络环境下会输出明确的错误提示并终止。值得注意官方安装文档描述的是 v6.110 下载包而本仓库源码启动器的帮助文本已显示版本号为v6.114见 src/tagui 第 9 行与 src/tagui.cmd 第 17 行说明仓库为较新的开发版安装后执行一次tagui update即可跟进最新状态。六、启动器运行参数速查无论从哪个平台启动tagui命令都支持丰富的运行参数。直接不带参数运行启动器即可看到完整帮助。下面是从 src/tagui.cmd 与 src/tagui 帮助文本归纳的参数表参数长/短用途tagui live进入 Live 交互模式可逐行执行步骤并即时看到输出适合编写和调试流程tagui update下载并更新到最新版本请先备份当前版本input(s)追加自定义参数流程内以变量p1到p8引用data.csv指定 CSV 作为数据表实现批量自动化多行记录-deploy/-d生成可双击运行的.cmdWindows/.commandmacOS/Linux文件便于一键运行流程-headless/-h使用不可见的无头 Chrome 运行 Web 流程不占用桌面视觉自动化流程不可用此模式-nobrowser/-n完全不启动浏览器适合纯视觉自动化场景-report/-r将运行结果记录到src/tagui_report.csv并生成 HTML 格式的执行日志-turbo/-t以约 10 倍于正常人类操作的速度运行自动化使用前请阅读注意事项-quiet/-q静默运行只输出显式结果echo、show、check步骤与错误等-edge/-e改用 Microsoft Edge 而非 Chrome 运行可与-headless组合-chrome/-c显式指定使用 Chrome-firefox/-f通过 SlimerJS 引擎使用 Firefox可见模式-baseline/-b将流程复制到baseline子目录后运行输出与基准版本隔离-test以 CasperJS 测试模式运行流程生成 XUnit 格式的.xml测试报告-debug显示 PhantomJS 后端的运行时调试信息等价于--verbose-speed/-s跳过迭代之间的延迟与 Chrome 重启加快多数据集批量运行以部署参数为例tagui my_flow.tag -deploy会在流程同目录生成一个可双击的快捷脚本源码实现见 src/tagui.cmd 中tagui_deploy_workflow分支把启动命令写入my_flow.cmdWindows 版还会在脚本中cd /d回调用目录Linux/macOS 版生成.command并设置chmod 700。若流程文件移动了位置需要重新生成一次部署脚本。七、核心配置文件tagui_config.txtTagUI 的浏览器自动化行为由 src/tagui_config.txt 控制官方安装后即可按需修改。其默认内容与含义如下// 默认流程语言 var tagui_language english; // 元素查找超时时间毫秒超过即报错 casper.options.waitTimeout 10000; casper.options.logLevel debug; // 浏览器视口尺寸宽 × 高 casper.options.viewportSize { width: 1366, height: 768 }; // PhantomJS 模式下的页面设置 casper.options.pageSettings { loadImages: true, loadPlugins: true, webSecurityEnabled: true, ignoreSslErrors: false, localToRemoteUrlAccessEnabled: false };关键参数说明tagui_language默认流程语言可改为chinese、japanese等对应 src/languages 目录下的多语言词典如 chinese.csv实现以中文等自然语言编写流程示例见 8_chineseflow.tagwaitTimeout元素定位超时时间默认 10000ms10 秒网络较慢时可适当调大viewportSize浏览器视口宽高默认 1366×768Windows 启动器在启动 Chrome 时会读取width/height并据此计算窗口尺寸额外加上约 74 像素的标题栏高度见 src/tagui.cmd 中窗口尺寸拼接逻辑pageSettings仅作用于 PhantomJS 引擎-nobrowser模式控制图片/插件加载、Web 安全策略与 SSL 校验行为。八、常见故障排查官方在 docs/setup_troubleshooting.rst 中针对三大平台整理了高频问题逐一说明WindowsMSVCR110.dll is missing报错安装仓库内随附的 Visual C Redistributable文件位于 docs/_static/vcredist_x86.exe安装后重启命令提示符即可无法解压到C:\根目录系统权限限制所致改解压到 Windows 桌面即可正常使用。macOSPHP 缺失macOS Monterey 及更新版本不再内置 PHP需单独安装 PHP 运行时安全拦截弹窗macOS 安全控制收紧可能拦截 PhantomJS 与 Java 进程需按系统提示在「安全性与隐私」中允许运行。LinuxPHP 缺失Ubuntu 等发行版默认不带 PHP需要自行安装sudo apt install php一类的包管理器命令视觉自动化 / OCR / 键盘步骤无法工作需要参照 SikuliX 官方 Linux 安装文档完成额外的手动设置因为这类步骤依赖屏幕读取与输入模拟能力。九、安装后的资源地图完成安装后以下仓库路径值得继续探索官方概念文档流程、步骤、标识符、Live 模式、条件循环、辅助函数docs/main_concepts.rst高级用法与完整参考docs/advanced.rst、docs/reference.rst附带工具说明docs/tools.rst可运行示例流程flows/samples核心启动器与解析实现src/taguimacOS/Linux、src/tagui.cmdWindows、src/tagui_parse.php浏览器自动化配置src/tagui_config.txt与 Python、R 语言的集成接口src/tagui_py/tagui_py.py、src/tagui_r/tagui_r.R至此你已经完成了 TagUI 在 Windows、macOS 或 Linux 上的完整安装、依赖配置、首次运行验证与更新维护。接下来即可参照 docs/main_concepts.rst 编写自己的第一个自动化流程把重复性的网页与桌面操作交给 TagUI 完成。赞分享GUI 自动化浏览器控制工作流自动化【免费下载链接】TagUIFree RPA tool by AI Singapore项目地址https://gitcode.com/gh_mirrors/ta/TagUI点击查看免费下载相关推荐CopyQ 跨平台安装完全指南Windows / macOS / Linux 多途径部署与命令行环境配置CopyQ 跨平台安装完全指南Windows / macOS / Linux 多途径部署与命令行环境配置 CopyQ 是一款跨平台的高级剪贴板管理器支持 W桌面应用cryptography跨平台部署Windows/Linux/macOS环境配置全指南cryptography跨平台部署Windows/Linux/macOS环境配置全指南 cryptography是一个为Python开发者提供加密原语和加密方密码学imgproxy跨平台部署Linux、macOS与Windows环境配置指南imgproxy跨平台部署Linux、macOS与Windows环境配置指南 imgproxy作为一款快速安全的独立图片处理服务器支持实时调整和转换远程图片图像处理后端上一篇MD2算法原理解图完全指南从填充规则到S盒18轮变换逐行拆解md2_cj实现下一篇如何3步完成AI模型训练Ultralytics HUB零代码可视化平台完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考