﻿AlphaTown 0.3.0 Windows 版 · 使用说明

一、启动
1. 先把整个压缩包解压到一个文件夹：在压缩包上点右键 →「全部解压缩」。不能在压缩包里直接双击运行。
   建议解压到路径较短的位置，例如 C:\AlphaTown。
2. 双击「启动 AlphaTown.cmd」。稍等片刻（首次启动可能需要一两分钟），AlphaTown 会自动在一个 Edge 窗口中打开。
   如果窗口没有弹出：打开 Edge 浏览器，在地址栏按 Ctrl+V 粘贴（启动器已自动复制地址）后回车，
   或者照着黑色窗口里显示的地址（http://127.0.0.1:…）手动输入。

二、那个黑色窗口
启动后会有一个标题为「AlphaTown（关闭此窗口即退出）」的黑色窗口，它就是 AlphaTown 的后台服务：
· 使用期间请让它一直开着，可以最小化；
· 关闭它，AlphaTown 就退出了；
· 遇到问题时，窗口里的文字有助于排查，可以截图发给我们；
· 窗口里的文字不能用鼠标选中，这是为了防止误点让后台服务暂停；
· AlphaTown 只在这台电脑上提供服务（地址是 127.0.0.1），没有访问令牌，局域网里的其他电脑和手机打不开它。
  不要在 app\.env 里把 ALPHATOWN_HOST 改成 0.0.0.0：没有访问令牌，改了以后同一网络里的任何人都能打开。

三、首次激活与登录设备
第一次打开会显示「激活 AlphaTown」：粘贴发行方提供的授权码（ATL1. 开头的一整段）即可。激活时要联网。
授权码只限本人使用，请不要转给别人。
一个授权码最多同时在两台设备上登录（Mac、Windows 电脑、DGX Spark 各算一台）；第三台登录时，最久没用的那台会退出登录，
在那台电脑上点「在这台电脑上重新登录」即可换回来。AlphaTown 启动时和之后大约每小时会连接发行方的授权服务
（license.dingyuanying.com）确认一次，连续 7 天连不上时需要联网确认一次才能继续使用。发送哪些内容见用户手册 5.11 和 2.9。

四、数据保存在哪里
自选、报告、对话和设置都保存在 %LOCALAPPDATA%\AlphaTown（在资源管理器的地址栏输入这个地址即可打开）。
数据和程序文件夹是分开的：换新版本时删掉旧的程序文件夹即可，数据不受影响。

五、Windows 安全提示
· 解压之前，可以先右键压缩包 →「属性」→ 勾选下方的「解除锁定」→「确定」，再解压，之后就不会反复弹出安全警告。
· 如果出现「Windows 已保护你的电脑」（SmartScreen），点「更多信息」→「仍要运行」。
· 杀毒软件如果拦截：先确认压缩包是从官网链接下载的、SHA256 和官网上的一致，再在杀毒软件里放行；不确定时先别放行，联系我们。
· Windows 11 如果开启了「智能应用控制」，AlphaTown 可能会被阻止运行。

六、如何退出
关闭黑色窗口即可；也可以在黑色窗口里按 Ctrl+C，出现「终止批处理操作吗(Y/N)?」时按 Y。
只关闭 Edge 窗口并不会退出，AlphaTown 仍在后台运行；再次双击「启动 AlphaTown.cmd」会重新打开窗口。

七、已知限制
· 对话 Agent 自由运行 Python 代码（python_exec）默认关闭；模板策略、回测、参数优化和策略托管都可以正常使用。
· 命令推送（消息推送里的「本机命令」方式）暂不可用，其他推送方式不受影响。
· 识图（OCR）：扫描版 PDF 暂不能识别文字；截图里的文字只有在主模型选 Anthropic 时才能识别。
· HEIC 格式的照片请先转成 JPG 或 PNG；旧版 Word 文档（.doc）请先另存为 .docx 再导入。
· 没有自动更新：新版本请下载新的压缩包解压使用，数据保存在 %LOCALAPPDATA%\AlphaTown，不受影响。
· 程序没有数字签名，可能出现安全提示，或被杀毒软件、「智能应用控制」拦截，详见第五节。
· 数据工作室的「本机文件夹」「SQLite 文件」数据源可以正常使用。
· 没有局域网 / 手机访问：只能在这台电脑上用；想在别的设备上用，请在那台设备上另装一份（授权码最多同时在两台设备上登录）。
  没有访问令牌；同一台电脑上的其他 Windows 账号理论上能连上本机的端口，不放心的话请用单独的 Windows 账号运行 AlphaTown。
