# TradingOS 2026.10.22.8

提供 Windows x64 的 TradingOS.exe 和 Linux x86_64 的 tradingos.bin，均已包含 Python 运行时、交易引擎及依赖，无需安装 Python。

本版本包含 Pro 参数编辑、手动/AI 参数来源、AI 每 30 分钟更新、AI 中线方向判断和默认保留旧轮止盈挂单等当前功能。安装包使用空账户，不包含开发者的 API、密码库、交易记录或预设交易对。

## Windows

解压 ZIP 到有写权限的文件夹，双击 TradingOS.exe。首次运行在控制台输入管理员用户名和密码，密码长度为 8～128 个字符；设置完成后会自动打开浏览器。

默认访问 http://127.0.0.1:9002/。运行期间保留控制台窗口。网页启动不会自动启动交易引擎，在控制台配置自己的账户和交易对后，由使用者手动启动引擎。

也可以从 PowerShell 启动：

```powershell
.\TradingOS.exe setup
.\TradingOS.exe serve
```

## Linux

适用 x86_64、glibc 2.31 及以上的 Linux，已在 Ubuntu 20.04 上构建并完成实际启动测试。Alpine/musl 和 ARM 不适用本包。

解压 tar.gz 后进入 TradingOS 文件夹，运行：

```bash
chmod +x tradingos.bin
./tradingos.bin setup
./tradingos.bin serve
```

按提示设置管理员用户名和密码，默认网页地址也是 http://127.0.0.1:9002/。

服务器远程访问可以在电脑建立 SSH 隧道：

```bash
ssh -L 19002:127.0.0.1:9002 用户名@服务器地址
```

然后打开电脑的 http://127.0.0.1:19002/。监听地址和端口也可通过 `serve --host 地址 --port 端口` 指定。

Linux 包附带 `tradingos.service.example`，用于需要 systemd 托管网页的情况。编辑其中的用户、程序和数据路径后安装；使用前须以同一用户完成 setup。服务只启动网页，交易引擎仍需在网页中手动启动。

## 数据与更新

默认数据目录为程序旁的 `data`。账户、API 加密文件、配置和交易状态均保存在这里。若使用独立目录，每次启动必须传入同一个路径：

```bash
./tradingos.bin setup --data-dir /你的目录/tradingos-data
./tradingos.bin serve --data-dir /你的目录/tradingos-data
```

Windows 对应使用 `TradingOS.exe`，参数相同。首次 setup 拒绝覆盖已有数据库；已有数据直接使用 serve 启动。程序目录和数据目录需要可写，单文件程序启动时也需要可写的系统临时目录。

更新前备份整个 data，在网页中有计划地停止交易引擎，然后退出网页程序并替换可执行文件。保留原 data 或继续使用原 `--data-dir`。交易引擎独立运行，关闭网页窗口或重启网页服务不会替代网页中的“停止引擎”操作。

可选运维界面：运行 `operations` 命令，默认端口 5001。它和主控制台使用同一数据目录。

API 和 AI 联网分析需要网络连接；基础安装和网页启动不需要下载依赖。Web 资源仍由本机程序提供。

## 验证

```bash
./tradingos.bin version
./tradingos.bin self-test
```

Windows 使用 `.\TradingOS.exe version` 和 `.\TradingOS.exe self-test`。自检使用临时空账户，不读取使用者的交易账户，不发送交易订单。

包内 VALIDATION.json、SELFTEST.txt、SMOKE.txt 记录对应平台的实际检查结果，包括登录、页面资源、多账户、重启保留数据、凭据加密和缺少凭据时拒绝启动引擎。

Windows 已在 Windows 11 x64 上验证。程序采用 PyInstaller 打包 Python 字节码与运行环境，不是源码加密方案。请保留 THIRD-PARTY-NOTICES.json 和 licenses 目录中的依赖许可文件。