TaskReach下载 TaskReach ↗

DOCUMENTATION / QUICK START

快速开始

从 macOS / Windows 桌面预览开始，或使用现有 Docker 交付方式。模型、项目与分析在本机处理；Community 免费免登录，Pro 使用设备绑定离线证。

桌面 0.5.0 · macOS arm64 / Windows x64 开发预览

在 Mac 上安装

  1. 1

    选择安装包

    前往 下载页。当前仅提供 Apple Silicon（arm64），构建目标为 macOS 13.0+，最低系统仍待实机验收。使用 Pro 评估请下载 Pro 应用。

  2. 2

    核对下载文件

    在终端切换到下载目录，与下载页对应 SHA-256 比较。以下以 Pro 文件为例；Community 请使用下载页对应的文件名和校验命令。

    SHA-256
    shasum -a 256 "TaskReach-Pro-0.5.0-macos-arm64-preview.dmg"
  3. 3

    安装并打开

    打开 DMG，将应用复制到“应用程序”文件夹，推出磁盘映像后再启动。运行环境已随包提供，无需安装 Python、Docker 或 ROS。

    当前包为临时签名，尚未通过 Apple Developer ID 签名与公证，系统可能阻止打开。遇到安全提示，请先核对来源和校验值，再联系支持；生产使用请等待正式版本。

  4. 4

    加载你的第一个任务

    应用默认加载 Universal Robots UR5e（推荐），可直接查看关节和末端控制，也可打开自己的机器人模型或 .sqh 项目。

在 Windows 上运行

  1. 1

    选择对应版本

    前往 Windows 下载区，选择 Community 或 Pro。推荐 Setup.exe 安装程序，ZIP 便携版仍可从副链接下载。本次 Setup 要求 Windows 11 x64，最低 Windows 11 版本及干净机器仍待验收；ZIP 当前仅在 Windows 11 x64 本机验证。手机或平板请为实际使用的电脑手动选择系统。

  2. 2

    核对完整性

    在 PowerShell 切换到下载目录，将以下结果与下载页的 SHA-256 比较。Community 或 ZIP 便携版请使用相应文件名。

    SHA-256
    Get-FileHash -Algorithm SHA256 -LiteralPath "TaskReach-Pro-0.5.0-windows-x64-Setup.exe"
  3. 3

    安装并运行

    运行 Setup.exe，按安装向导完成安装后打开应用。

    ZIP 便携版请完整解压并运行目录内的 TaskReach Community.exe 或 TaskReach Pro.exe。请保留 _internal 文件夹，不要只复制 EXE。无需安装 Python、Conda、Docker 或编译器。

    原生窗口需要 Microsoft Edge WebView2 Runtime 与 .NET Framework 4.6.2 或更高版本。当前包未完成 Authenticode 签名，可能出现系统安全提示；请先核对来源与校验值，遇到问题联系支持。

  4. 4

    查看 UR5e 与本机项目

    应用默认加载 Universal Robots UR5e，可调整关节和 TCP，或打开自己的机器人模型、.sqh 项目。当前为开发预览，正式生产使用请等待完整安装验收。

安装程序、升级与卸载

Setup 按当前用户安装，升级或卸载前请先保存项目并关闭应用。安装器只管理程序文件；升级和卸载保留 TaskReach 的用户数据与许可证目录。请将 .sqh 工程另外保存在自己的项目目录，并在升级前备份。

Setup 要求 .NET Framework 4.8 或更高版本。本轮 Setup 随附官方 Microsoft x64 Evergreen WebView2 完整离线运行库；已安装 WebView2 Runtime 时无需联网获取或再次安装该运行库。缺少时会先询问，默认不安装，明确确认后使用随包文件，无需在线下载。静默安装不会自动同意补装，缺少运行库时会明确失败并给出手动安装指引。

Pro：设备申请 → 离线激活

  1. 1

    导出本机设备申请

    在实际使用的 Mac 或 Windows 电脑上打开 Pro 应用，点击右上角“Pro 授权”，选择“导出设备申请”，或复制 TRD1 开头的申请码。

  2. 2

    发送申请，等待人工签发

    将申请文件、评估主体与需求发送至 ur@ultrarock.net，申请 14 天免费评估。申请不包含原始硬件标识或项目数据。目标电脑可以保持离线，由另一台联网电脑发送邮件并转移文件。

  3. 3

    导入许可证

    收到本机专属的 .license.json 后，在“Pro 授权”中选择“导入许可证”。应用验证签名、设备与版本权益，成功后保存文件；导入不会自动停止当前工作。

  4. 4

    保存项目，再确认重载

    先在“项目与报告”保存 .sqh，并确认文件实际存在；随后点击“保存项目后重载”并确认。重新连接后检查顶部显示 TASKREACH PRO，并核对授权类型和到期时间。

整个桌面流程不需要 TaskReach 账号、密码或定期联网续租。授权无效、设备不匹配或版本不在维护范围时，不会启用 Pro。更换电脑、Windows 重装或迁移系统请联系支持处理；macOS 与 Windows 许可证不能互换。

区分评估到期与维护截止

评估许可证：自签发起有效 14 天。面板按北京时间（UTC+08:00）显示到期时刻；到期后 Pro 权益停止，当前项目保留并只读，可先导出项目后主动重载使用基础能力。

正式永久许可证：按设备交付，默认包含一年更新维护。维护截止日之前（含当天）发行的版本可继续永久使用；之后发行的新版本需要续维护。维护届满不等于软件使用权到期，也不会自动扣费。

当前先提供免费评估与人工咨询。具体商业范围、设备数量、支持服务及交付安排以订单文件和有效许可证为准。

保存项目与本机数据

在“项目与报告”保存 .sqh 工程包。升级、重载或切换许可证之前，请保留可恢复的项目文件。

macOS 数据与许可证位于 ~/Library/Application Support/TaskReach/，许可证文件为 license/desktop.license.json。程序资源与用户数据分开；重装同一设备且身份未变时可重用原许可证。

Windows 数据位于当前用户的 %USERPROFILE%\AppData\Local\TaskReach\，许可证为 data\license\desktop.license.json。Windows 许可证绑定系统安装身份，重装系统后请联系支持核实。

Community 不要求许可证。Pro 许可证仅适用于绑定设备，请勿公开分享；签发私钥不随安装包分发。

已有 Docker 交付方式

Community 镜像已开放下载的既有记录继续保留，具体版本见 Docker 下载区。镜像版本与桌面预览分别管理，本次不升级 Docker 发布记录。

Check
docker --version
Pull
docker pull taskreach/community:latest
Run
docker run --rm \ -p 8080:8080 \ -v taskreach-data:/data \ taskreach/community:latest
Open
http://localhost:8080

/data 保存项目、缓存与安装实例信息；请保留命名卷。Pro 镜像使用对应的容器许可证，桌面证不能直接挂载到容器使用。

拉取 Pro 私有镜像可能需要 docker login，这是镜像仓库登录，不是 TaskReach 桌面账号注册。

下一步下载并开始评估 →