uname -s 2>/dev/null || echo Windows

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"

[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"

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"

$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])" }

$localVer = "not_installed"

undefined

LOCAL_VER="not_installed"

undefined

LOCAL_VER="not_installed"

undefined

if [ "$LOCAL_VER" = "not_installed" ]; then
    echo "STATUS=not_installed"
elif printf '%s\n' "$LATEST_VER" "$LOCAL_VER" | sort -V | head -1 | grep -qx "$LATEST_VER"; then
    echo "STATUS=up_to_date"
else
    echo "STATUS=needs_update"
fi

if ($localVer -eq "not_installed") {
    Write-Host "STATUS=not_installed"
} elseif ([version]$localVer -ge [version]$latestVer) {
    Write-Host "STATUS=up_to_date"
} else {
    Write-Host "STATUS=needs_update"
}

undefined

**Note**: `$latestVer` needs to be extracted and passed in at the top of the script by getting the redirect URL or download link filename. After the check passes, Step 3 should use the `$guiExe` found here to start the installer.

DMG_FILE=$(find "$HOME/Desktop" -maxdepth 3 -name "*OpenD-GUI*${LATEST_VER}*.dmg" -type f | head -1)
if [ -n "$DMG_FILE" ]; then
    echo "Version verified: found $(basename "$DMG_FILE") (matches expected $LATEST_VER)"
else
    # List all GUI DMG versions found for diagnosis
    ALL_DMG=$(find "$HOME/Desktop" -maxdepth 3 -name "*OpenD-GUI*.dmg" -type f 2>/dev/null)
    echo "WARNING: Expected version $LATEST_VER not found in extracted files."
    echo "Found DMG files: $ALL_DMG"
    echo "The download may not contain the expected version. Aborting installation."
    exit 1
fi

undefined

If the user specifies a path via `-path`, replace `~/Desktop` with the corresponding path. After the check passes, the subsequent installation step should use the `$PKG_FILE` found here.

Futu_OpenD_x.x.xxxx_Windows/
├── Futu_OpenD-GUI_x.x.xxxx_Windows/
│   └── Futu_OpenD-GUI_x.x.xxxx_Windows.exe   ← GUI version installer (generates %APPDATA%\Futu_OpenD\Futu_OpenD.exe after installation)
├── Futu_OpenD_x.x.xxxx_Windows/
│   ├── FutuOpenD.exe                           ← Command-line version main program (do not start this)
│   ├── FutuOpenD.xml                           ← Configuration file
│   ├── AppData.dat                             ← Data file
│   └── ... (DLL and other dependencies)
└── README.txt

undefined

**Brand Replacement Rules**:
- Futu version: `$url` uses `futunn.com` link, `$archiveName = "FutuOpenD.7z"`
- moomoo version: `$url` uses `moomoo.com` link, `$archiveName = "MoomooOpenD.7z"`

**Path Replacement Rules**:
- Default (desktop): `$downloadDir = [Environment]::GetFolderPath("Desktop")`
- User-specified: `$downloadDir = "user-provided path"`

**Precondition**: Need to install 7-Zip. If not installed, the script will prompt, at this time inform users:
- Download 7-Zip: `https://www.7-zip.org/download.html`
- Backup link: `https://github.com/ip7z/7zip/releases`
- Or manually right-click to decompress .7z file

**Execution Steps**:
1. Use Write tool to write the script to temporary file `install_opend.ps1`
2. Execute with Bash tool: `powershell -ExecutionPolicy Bypass -File "install_opend.ps1"`
3. Delete temporary script after completion: `rm install_opend.ps1`

Note: `$` symbol in Bash tool will be escaped, must write .ps1 file first then execute.

Futu_OpenD_x.x.xxxx_Mac/
├── Futu_OpenD-GUI_x.x.xxxx_Mac.dmg   ← GUI version installation image (need to mount for installation)
├── Futu_OpenD_x.x.xxxx_Mac.app       ← Command-line version (non-GUI, do not install this)
├── Futu_OpenD_x.x.xxxx_Mac/
│   ├── FutuOpenD                       ← Command-line version main program
│   ├── FutuOpenD.xml                   ← Configuration file
│   └── ...
├── fixrun.sh                           ← Path repair script
└── README.txt

undefined

Extract filename from redirect URL (such as `Futu_OpenD_10.0.6018_Mac.tar.gz` or `moomoo_OpenD_10.0.6018_Mac.tar.gz`).

**Step 2: Direct Download from softwaredomain**

Splice the extracted filename with softwaredownload domain URL, execute download with Bash tool, **must set timeout to 600000** (10 minutes):

- Futu version: `https://softwaredownload.futunn.com/{filename}`
- moomoo version: `https://softwaredownload.moomoo.com/{filename}`

```bash

Replace filename with actual filename obtained in Step 1.

Path replacement rules:
- Default: `$HOME/Desktop`
- Replace with corresponding path when user specifies via `-path`

Confirm file size after download:
```bash
du -h "$HOME/Desktop/FutuOpenD.tar.gz"

tar -xzf "$HOME/Desktop/FutuOpenD.tar.gz" -C "$HOME/Desktop/" && rm -f "$HOME/Desktop/FutuOpenD.tar.gz"

DMG_PATH=$(find "$HOME/Desktop" -maxdepth 3 -name "*OpenD-GUI*.dmg" -type f | head -1) && echo "Found DMG: $DMG_PATH"

hdiutil attach "$DMG_PATH" -nobrowse

VOLUME_PATH=$(hdiutil attach "$DMG_PATH" -nobrowse | grep "/Volumes" | awk -F'\t' '{print $NF}') && echo "Mounted: $VOLUME_PATH"
APP_IN_DMG=$(find "$VOLUME_PATH" -maxdepth 1 -name "*.app" -type d | head -1) && echo "Found app: $APP_IN_DMG" && cp -R "$APP_IN_DMG" /Applications/ && echo "Installed to /Applications/"

APP_NAME=$(basename "$APP_IN_DMG") && xattr -rd com.apple.quarantine "/Applications/$APP_NAME"

hdiutil detach "$VOLUME_PATH"

APP_NAME=$(ls /Applications/ | grep "OpenD-GUI" | head -1) && open "/Applications/$APP_NAME"

FIXRUN=$(find "$HOME/Desktop" -maxdepth 3 -name "fixrun.sh" | head -1) && chmod +x "$FIXRUN" && bash "$FIXRUN"

EXTRACT_DIR=$(find "$HOME/Desktop" -maxdepth 1 -type d -name "*OpenD*" | head -1) && rm -rf "$EXTRACT_DIR" && echo "Cleaned up: $EXTRACT_DIR"

Futu_OpenD_x.x.xxxx_Ubuntu/
├── Futu_OpenD-GUI_x.x.xxxx_Ubuntu.deb   ← GUI version installation package (install this)
├── Futu_OpenD_x.x.xxxx_Ubuntu/
│   ├── FutuOpenD                          ← Command-line version main program (do not run this)
│   ├── FutuOpenD.xml                      ← Configuration file
│   └── ...
├── fixrun.sh                              ← Path repair script
└── README.txt

curl -L -o ~/Desktop/FutuOpenD.tar.gz "https://www.futunn.com/download/fetch-lasted-link?name=opend-centos"
tar -xzf ~/Desktop/FutuOpenD.tar.gz -C ~/Desktop/
rm ~/Desktop/FutuOpenD.tar.gz

curl -L -o ~/Desktop/FutuOpenD.tar.gz "https://www.futunn.com/download/fetch-lasted-link?name=opend-ubuntu"
tar -xzf ~/Desktop/FutuOpenD.tar.gz -C ~/Desktop/
rm ~/Desktop/FutuOpenD.tar.gz

DEB_PATH=$(find ~/Desktop -maxdepth 3 -name "*OpenD-GUI*.deb" -type f | head -1) && echo "Found: $DEB_PATH"
sudo dpkg -i "$DEB_PATH"
sudo apt-get install -f -y  # Fix dependencies

RPM_PATH=$(find ~/Desktop -maxdepth 3 -name "*OpenD-GUI*.rpm" -type f | head -1) && echo "Found: $RPM_PATH"
sudo rpm -ivh "$RPM_PATH"

undefined

**Note**: Prohibit running command-line version `FutuOpenD` (no underscore), must run GUI version `Futu_OpenD` (with underscore).

pip show futu-api 2>&1

pip index versions futu-api 2>&1 | head -3

| Item | Old Version | New Version |
|------|--------|--------|
| futu-api | x.x.xxxx | y.y.yyyy |
| protobuf | a.b.c | d.e.f | (if changed)

pip install backtrader matplotlib pandas numpy

pip show backtrader matplotlib pandas numpy 2>&1 | grep -E "^(Name|Version):"

| Library Name | Version |
|------|------|
| backtrader | x.x.x |
| matplotlib | x.x.x |
| pandas | x.x.x |
| numpy | x.x.x |

from futu import *

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

For moomoo version, replace `from futu import *` with `from moomoo import *`.