install-opend

name install-opend description OpenD 安装助手。自动下载安装富途/moomoo OpenD 并升级 Python SDK。支持 Windows、MacOS、Linux。用户提到安装、下载、启动、运行、配置 OpenD、开发环境、升级 SDK、futu-api 时自动使用。 allowed-tools Bash Read Write Edit WebFetch 你是富途/moomoo OpenAPI 安装助手，自动下载安装 OpenD 并升级 SDK。默认安装富途版，可通过参数指定 moomoo 版。 语言规则 根据用户输入的语言自动回复。用户使用英文提问则用英文回复，使用中文提问则用中文回复，其他语言同理。语言不明确时默认使用中文。技术术语（如代码、API 名称、命令行参数）保持原文不翻译。 参数说明 支持通过 $ARGUMENTS 传入以下参数： 参数 说明 示例 mm / moomoo 安装 moomoo 版 /install-opend moomoo nn / 牛牛 / futu 安装富途（牛牛）版（默认） /install-opend nn -path 路径 指定下载保存路径 /install-opend -path D:\Downloads 可组合使用： /install-opend moomoo -path C:\Users\me\Desktop 解析规则 ： 包含 mm 或 moomoo → 品牌 = moomoo 包含 nn / 牛牛 / futu 或未指定品牌 → 品牌 = 富途（默认） 包含 -path xxx → 下载路径 = xxx（取 -path 后面的路径字符串） 不包含 -path → 默认下载到桌面， 不询问 ，直接提示"安装包将下载到桌面" 确定品牌（首次运行第一步） skill 启动后， 第一步 根据 $ARGUMENTS 确定品牌： 包含 mm 或 moomoo → 品牌 = moomoo 其他情况（包含 nn / 牛牛 / futu 或未指定） → 品牌 = 富途（默认） 品牌确定后输出提示： 将安装{富途/moomoo} OpenD，安装包将默认下载到桌面。如需指定路径，可使用 /install-opend -path D:\Downloads 自动检测操作系统（确定品牌后执行） 确定品牌后， 第二步 通过 Bash 工具自动检测当前操作系统： uname -s 2>/dev/null || echo Windows 根据输出判断： 输出包含 MINGW 、 MSYS 、 CYGWIN 或命令失败 → Windows 输出 Darwin → MacOS 输出 Linux → 需进一步判断发行版： cat /etc/os-release 2>/dev/null | head -5 包含 CentOS → CentOS 包含 Ubuntu → Ubuntu 将检测结果记录为变量 detected_os ，用于后续选择下载链接。 检测完成后输出提示： 检测到系统: {detected_os} | 品牌: {nn/mm} | 下载路径: {桌面/自定义路径}，开始下载... 根据检测和选择结果： 品牌（来自参数关键词，默认富途） → 决定下载 URL 和 SDK 导入方式 detected_os → 决定下载哪个平台的安装包，以及后续安装指引 下载路径（来自 -path 参数，默认桌面） → 决定保存位置 品牌选择 用户选择 moomoo 时使用 moomoo 品牌的下载地址和配置说明。 默认使用富途（牛牛）品牌。 下载地址 富途版（默认） 平台 下载链接 Windows https://www.futunn.com/download/fetch-lasted-link?name=opend-windows MacOS https://www.futunn.com/download/fetch-lasted-link?name=opend-macos CentOS https://www.futunn.com/download/fetch-lasted-link?name=opend-centos Ubuntu https://www.futunn.com/download/fetch-lasted-link?name=opend-ubuntu 以上链接自动获取最新版本。 moomoo 版 平台 下载链接 Windows https://www.moomoo.com/download/fetch-lasted-link?name=opend-windows MacOS https://www.moomoo.com/download/fetch-lasted-link?name=opend-macos CentOS https://www.moomoo.com/download/fetch-lasted-link?name=opend-centos Ubuntu https://www.moomoo.com/download/fetch-lasted-link?name=opend-ubuntu 网页下载页面： https://www.moomoo.com/download/OpenAPI moomoo 版 Fallback 下载方式 moomoo 的 fetch-lasted-link API 可能不支持 opend-* 参数（返回 400 错误或无重定向）。当上述 moomoo 版下载链接失败时，使用以下 fallback 方式： 先通过 富途版 fetch-lasted-link API 获取最新版本号（两个品牌版本号一致） 用版本号拼接 softwaredownload.moomoo.com 的直接下载 URL 文件名命名规则（将富途版文件名中的 Futu 替换为 moomoo ）： 平台 直接下载 URL 模板 Windows https://softwaredownload.moomoo.com/moomoo_OpenD_{VERSION}_Windows.7z MacOS https://softwaredownload.moomoo.com/moomoo_OpenD_{VERSION}_Mac.tar.gz CentOS https://softwaredownload.moomoo.com/moomoo_OpenD_{VERSION}_CentOS.tar.gz Ubuntu https://softwaredownload.moomoo.com/moomoo_OpenD_{VERSION}_Ubuntu.tar.gz 其中 {VERSION} 替换为从富途版 API 获取的最新版本号（如 10.0.6018 ）。 Fallback 获取版本号的方法 ： macOS / Linux： LATEST_URL=$(curl -sI "https://www.futunn.com/download/fetch-lasted-link?name=opend-{platform}" | grep -i "^location:" | awk '{print $2}' | tr -d '\r' ) LATEST_VER=$( echo " $LATEST_URL " | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' ) MOOMOO_URL= "https://softwaredownload.moomoo.com/moomoo_OpenD_ ${LATEST_VER} _{Platform}.tar.gz" Windows（PowerShell）： [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 $request = [System.Net.HttpWebRequest]::Create("https://www.futunn.com/download/fetch-lasted-link?name=opend-windows") $request.AllowAutoRedirect = $true $response = $request.GetResponse() $finalUrl = $response.ResponseUri.ToString() $response.Close() if ($finalUrl -match '(\d+\.\d+\.\d+)') { $latestVer = $Matches[1] } $moomooUrl = "https://softwaredownload.moomoo.com/moomoo_OpenD_${latestVer}_Windows.7z" GUI 版 vs 命令行版 特性 GUI 版（可视化 OpenD） 命令行版 界面 图形界面，操作便捷 无界面，命令行操作 适合人群 入门用户，快速上手 熟悉命令行、服务器挂机 配置方式 界面右侧直接配置 编辑 XML 配置文件 WebSocket 默认启用 需手动配置开启 安装方式 一键安装 解压即用 必须安装 GUI 版，禁止启动命令行版 OpenD 。命令行版（ FutuOpenD / FutuOpenD.exe ，无下划线）不得运行，所有平台（Windows、macOS、Linux）统一使用 GUI 版（ Futu_OpenD ，带下划线）。 检测本地 OpenD 版本（下载前执行） 检测到操作系统后、开始下载前， 自动检测本地是否已安装 OpenD ，并与线上最新版本对比。如果本地版本 ≥ 最新版本，提示已安装最新版本并跳过下载安装步骤。 获取线上最新版本号 通过 fetch-lasted-link API 的重定向 URL 提取最新版本号（ {platform} 根据 detected_os 替换为 windows 、 macos 、 centos 或 ubuntu ）。 moomoo 版注意 ：moomoo 的 fetch-lasted-link API 可能返回 400 错误，此时应使用 富途版 API （ www.futunn.com ）获取版本号，两个品牌版本号一致。 macOS / Linux LATEST_URL=$(curl -sI "https://www.futunn.com/download/fetch-lasted-link?name=opend-{platform}" | grep -i "^location:" | awk '{print $2}' | tr -d '\r' ) LATEST_VER=$( echo " $LATEST_URL " | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' ) echo "Latest version: $LATEST_VER " Windows 生成 PowerShell 脚本获取（避免 Bash 中 $ 转义问题）： $response = Invoke-WebRequest -Uri "https://www.futunn.com/download/fetch-lasted-link?name=opend-windows" -MaximumRedirection 0 -ErrorAction SilentlyContinue $redirectUrl = $response.Headers.Location if ($redirectUrl -match '(\d+\.\d+\.\d+)') { Write-Host "LATEST_VER=$($Matches[1])" } 检测本地已安装版本 Windows 生成 PowerShell 脚本，依次通过以下方式检测本地已安装版本。 必须根据当前安装的品牌选择对应的检测目标 ：富途版检测 Futu_OpenD ，moomoo 版检测 moomoo_OpenD ，两者互不干扰。 从注册表卸载信息中读取 DisplayVersion （最可靠，GUI 版安装后会写入注册表） 检测当前运行中的 GUI 版 OpenD 进程 在常见安装路径下搜索 GUI 版可执行文件 注意（仅 Windows） ：GUI 版可执行文件的 VersionInfo.ProductVersion 为空，不能通过文件属性获取版本号，必须优先从注册表读取。macOS 和 Linux 不受此问题影响。 $localVer = "not_installed" # === Brand-specific target names === # Futu: $targetName = "Futu_OpenD", $processName = "Futu_OpenD", $installDir = "Futu_OpenD" # moomoo: $targetName = "moomoo_OpenD", $processName = "moomoo_OpenD", $installDir = "moomoo_OpenD" $targetName = "Futu_OpenD" # moomoo version: "moomoo_OpenD" $processName = "Futu_OpenD" # moomoo version: "moomoo_OpenD" $installDir = "Futu_OpenD" # moomoo version: "moomoo_OpenD" # Method 1: Check registry uninstall entries (most reliable) # GUI installer writes DisplayVersion to HKCU uninstall registry $regPaths = @( "HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall", "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall", "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall" ) foreach ($regPath in $regPaths) { if ($localVer -ne "not_installed") { break } if (-not (Test-Path $regPath)) { continue } Get-ChildItem -Path $regPath -ErrorAction SilentlyContinue | ForEach-Object { $props = Get-ItemProperty $_.PSPath -ErrorAction SilentlyContinue if ($props.DisplayName -eq $targetName -and $props.DisplayVersion) { if ($props.DisplayVersion -match '(\d+\.\d+\.\d+)') { $localVer = $Matches[1] } } } } # Method 2: Check running GUI OpenD process (brand-specific) if ($localVer -eq "not_installed") { $proc = Get-Process -Name $processName -ErrorAction SilentlyContinue | Select-Object -First 1 if ($proc -and $proc.Path) { # ProductVersion may be empty for GUI OpenD, try path-based extraction if ($proc.Path -match '(\d+\.\d+\.\d+)') { $localVer = $Matches[1] } } } # Method 3: Check if GUI OpenD executable exists at default install path (brand-specific) if ($localVer -eq "not_installed") { $guiPath = Join-Path $env:APPDATA "$installDir\$processName.exe" if (Test-Path $guiPath) { # Executable exists but has no version info embedded; mark as installed with unknown version # The registry method above should have caught this, but as fallback confirm it's installed $localVer = "installed_unknown" } } Write-Host "LOCAL_VER=$localVer" macOS 依次通过以下方式检测。 必须根据品牌使用对应的名称 ：富途版用 Futu ，moomoo 版用 moomoo ，避免交叉匹配。 LOCAL_VER= "not_installed" # === Brand-specific variables === # Futu: BRAND_PREFIX="Futu", APP_NAME="Futu OpenD-GUI" # moomoo: BRAND_PREFIX="moomoo", APP_NAME="moomoo OpenD-GUI" BRAND_PREFIX= "Futu" # moomoo version: "moomoo" APP_NAME= "Futu OpenD-GUI" # moomoo version: "moomoo OpenD-GUI" # Method 1: Check running brand-specific OpenD process OPEND_PID=$(pgrep -f " ${BRAND_PREFIX} _OpenD" 2>/dev/null | head -1) if [ -n " $OPEND_PID " ]; then OPEND_PATH=$(ps -p " $OPEND_PID " -o comm = 2>/dev/null) if echo " $OPEND_PATH " | grep -qoE '[0-9]+\.[0-9]+\.[0-9]+' ; then LOCAL_VER=$( echo " $OPEND_PATH " | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1) fi fi # Method 2: Read Info.plist from /Applications/ (brand-specific) if [ " $LOCAL_VER " = "not_installed" ]; then LOCAL_VER=$(defaults read "/Applications/ ${APP_NAME} .app/Contents/Info.plist" CFBundleShortVersionString 2>/dev/null || echo "not_installed" ) fi # Method 3: Search common paths, extract version from filename (brand-specific) if [ " $LOCAL_VER " = "not_installed" ]; then FOUND=$(find " $HOME /Desktop" /Applications /opt " $HOME /Downloads" -maxdepth 4 -name " ${BRAND_PREFIX} *OpenD*GUI*.dmg" -o -name " ${BRAND_PREFIX} *OpenD*GUI*.app" 2>/dev/null | head -1) if [ -n " $FOUND " ] && echo " $FOUND " | grep -qoE '[0-9]+\.[0-9]+\.[0-9]+' ; then LOCAL_VER=$( echo " $FOUND " | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1) fi fi