涨停自动复盘助手 · 安装手册

适用版本：涨停自动复盘助手 v1.7（独立 EXE + 图形启动器）

合规提示：本工具仅做盘面复盘信息的自动整理与同步，不预测行情、不荐股、不保证收益。

一、环境要求

Windows 版为独立 EXE，已打包所有运行依赖，双击即用，不需要安装 Python。

macOS 版为 Python 源码包，首次使用请双击 install_macos.command 自动检测并安装 Python，详见第三节。

二、获取激活码（一机一码）

1. 启动软件（Windows 双击 涨停自动复盘助手.exe；macOS 终端执行 python3 launcher.py）。
2. 首次运行会弹出「激活」窗口，点击 「复制机器码」。
3. 把机器码（形如 FP-XXXX-XXXX-XXXX）发给客服。
4. 客服据此生成「激活码」发回给你。
5. 把激活码粘贴到「激活码」框，点击 「激活」 即可。

激活码与机器绑定，换电脑/重装系统后需重新获取。请勿外传激活码，避免被倒卖封禁。

三、安装步骤

Windows 用户（独立 EXE，无需 Python）

1. 下载页面上的 Windows 版 ZIP（约 16 MB）并解压。
2. 双击 涨停自动复盘助手.exe 即可启动图形界面。
3. 首次运行弹出激活窗口，按第二节流程获取并填入激活码即可。

说明：本工具采用云端每日核对机制——每天收盘后由维护端自动抓取财联社涨停分析图、核对生成标准数据并发布到云端。你的电脑启动时自动同步当日数据（秒级），无需安装识别引擎、无需联网下载模型，安装包也因此只有约 16 MB。

macOS 用户（详细图文）

macOS 版是 Python 源码包。好消息是：你不需要懂 Python、也不需要手动安装任何东西 —— 我们提供了 install_macos.command 一键脚本，会自动帮你把 Python 环境装好。下面按步骤跟着做即可。

第 1 步：下载并解压

• 在详情页点击「立即下载 macOS 版」获取 ZIP。
• 双击 ZIP 解压，得到文件夹 涨停自动复盘助手_v1.7_macOS。
• 建议把它放到「下载」或「文稿」目录。文件夹路径不要包含中文或空格，否则终端命令会报错。

第 2 步：双击运行 install_macos.command（自动装 Python）

• 进入文件夹，找到 install_macos.command，双击它。
• 系统会自动打开「终端」窗口，脚本会：

1. 检查你的电脑是否已安装 Python 3.8 及以上；
2. 若已安装 → 直接提示「环境就绪」，跳到第 3 步；
3. 若未安装 → 让你选择安装方式（推荐选 1 用 Homebrew 自动装；若没装 Homebrew 会自动改用官方安装包；也可选 2 下载官方 pkg 手动装，或选 3 自己装）。

• 安装完成后，终端会提示你下一步运行 python3 launcher.py。

⚠️ 首次双击可能被 macOS 拦截（提示「无法打开，因为无法验证的开发者」）。这是 macOS 的安全机制，不是文件损坏。解决方法见第五节「常见问题 Q6」。

第 3 步：启动软件并完成激活

• 打开「终端」（启动台搜索 Terminal，或 Command + 空格 输入 Terminal）。
• 用 cd 进入解压目录，然后运行启动命令。示例如下（把路径换成你实际放的位置）：

cd ~/Downloads/涨停自动复盘助手_v1.7_macOS
python3 launcher.py

• 图形界面启动后，按第二节流程获取并填入激活码即可。

第 4 步：设置每日自动复盘（macOS 定时任务）

Windows 版软件里有「⏰ 自动运行」按钮（用系统计划任务在交易日 18:30 自动跑）。macOS 没有计划任务，但系统自带 launchd（推荐）或 crontab，一样能实现「每个交易日 18:30 自动静默复盘」。下面两种方法任选其一。

自动复盘用的是 python3 launcher.py --auto 这个「静默模式」：不弹界面、不弹窗，专为定时任务设计；授权失效会直接退出（不会卡住定时任务）。请确保已激活或处于试用期内再开启定时。

方法一：launchd（推荐，登录后自动运行，最稳）

1. 在解压目录里新建文件 com.fupantong.autorecon.plist（用「文本编辑」即可），内容如下。请把路径 /Users/你的用户名/Downloads/涨停自动复盘助手_v1.7_macOS 换成你电脑上的真实路径（路径不要含中文或空格）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.fupantong.autorecon</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/python3</string>
        <string>/Users/你的用户名/Downloads/涨停自动复盘助手_v1.7_macOS/launcher.py</string>
        <string>--auto</string>
    </array>
    <key>StartCalendarInterval</key>
    <array>
        <dict><key>Weekday</key><integer>1</integer><key>Hour</key><integer>18</integer><key>Minute</key><integer>30</integer></dict>
        <dict><key>Weekday</key><integer>2</integer><key>Hour</key><integer>18</integer><key>Minute</key><integer>30</integer></dict>
        <dict><key>Weekday</key><integer>3</integer><key>Hour</key><integer>18</integer><key>Minute</key><integer>30</integer></dict>
        <dict><key>Weekday</key><integer>4</integer><key>Hour</key><integer>18</integer><key>Minute</key><integer>30</integer></dict>
        <dict><key>Weekday</key><integer>5</integer><key>Hour</key><integer>18</integer><key>Minute</key><integer>30</integer></dict>
    </array>
    <key>StandardOutPath</key>
    <string>/Users/你的用户名/Downloads/涨停自动复盘助手_v1.7_macOS/autorecon.log</string>
    <key>StandardErrorPath</key>
    <string>/Users/你的用户名/Downloads/涨停自动复盘助手_v1.7_macOS/autorecon.log</string>
</dict>
</plist>

1. 打开「终端」，把 plist 装到系统的「启动代理」里并启用：

cp /Users/你的用户名/Downloads/涨停自动复盘助手_v1.7_macOS/com.fupantong.autorecon.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.fupantong.autorecon.plist

较新 macOS（13+）若 launchctl load 提示已废弃，可改用：

launchctl enable gui/$(id -u)/com.fupantong.autorecon && launchctl kickstart -k gui/$(id -u)/com.fupantong.autorecon

想取消自动运行：launchctl unload ~/Library/LaunchAgents/com.fupantong.autorecon.plist，并删除该文件即可。

方法二：crontab（备用，简单直接）

1. 终端执行 crontab -e，按 i 进入编辑，添加下面一行（同样把路径换成你的真实路径）：

30 18 * * 1-5 cd /Users/你的用户名/Downloads/涨停自动复盘助手_v1.7_macOS && /usr/bin/python3 launcher.py --auto >> autorecon.log 2>&1

1. 按 Esc，输入 :wq 回车保存。这样每周一到周五 18:30 会自动跑一次。

验证是否成功

• 先在终端手动跑一次确认能正常复盘：

  cd /Users/你的用户名/Downloads/涨停自动复盘助手_v1.7_macOS
  python3 launcher.py --auto

终端会打印复盘结果或错误信息；没问题就说明定时任务也能跑通。

• 之后每天 18:30 系统会自动执行，运行日志写在 autorecon.log，可随时打开查看。

⚠️ Mac 用户特别注意：同花顺、通达信是 Windows 软件，Mac 上通常没有它们的本地数据目录，因此「写入本地板块」这一步在 Mac 上会跳过或报错，属正常现象。Mac 用户请走 「手机云同步」 路线：先在图形界面「设置 → 手机云同步」里配好你本人同花顺账号的 Cookie（见《使用手册》第五、六节），之后 --auto 会自动把复盘板块推送到你手机上的同花顺。

四、首次运行配置（路径与手机同步）

图形界面启动后，无需手改任何配置文件，在「⚙ 设置」里完成即可：

• 本地路径：点「自动检测通达信路径 / 自动检测同花顺路径」，程序会自动找到你电脑上的安装目录（每位用户的安装盘符、目录名、mo_xxxxxx 账号目录都不同，自动检测可适配）；若直线检测不到，手动填写即可。
• 手机云同步：如需把板块同步到手机，在「设置 → 手机云同步」按说明获取并粘贴你本人同花顺账号的网页 Cookie（详见《使用手册》第五、六节）。Cookie 仅存本机，不上传他人。
• 底部状态栏会实时显示「通达信 / 同花顺 路径是否就绪」「手机云同步 Cookie 是否已配置」，缺什么一眼可见。

五、常见问题（FAQ）

Q1：激活时提示「机器码不匹配」？ A：激活码是在你当前电脑生成的机器码基础上签发的，换电脑或重装系统后机器码会变，需重新向客服获取激活码。

Q2：Windows 提示「未找到 Python」？ A：请下载页面上的 Windows 版（独立 EXE），不需要 Python。若你运行的是源码包，才需要到 python.org 安装 3.8+ 并勾选「Add Python to PATH」。

Q3：运行后同花顺板块没变化？ A：请先完全退出同花顺（右下角托盘→退出），再点「立即复盘」。详见《使用手册》。

Q4：授权会到期吗？ A：取决于你购买的会员时长（连续包月、单月、一年或终身版）。到期前可在软件内或联系客服续费/升级。

Q5：数据从哪来？安全吗？ A：仅读取公开的盘面复盘信息并整理进你指定的复盘板块，不读取你的其他自选/账户，数据留在本机。

Q6：macOS 双击 install_macos.command 没反应 / 报「无法验证的开发者」？ A：这是 macOS 的 Gatekeeper 安全拦截，文件没有损坏。两种解决方式任选其一：

• 方式一（最简单）：右键（或按住 Control 点击）install_macos.command → 在菜单中选择「打开」→ 弹出的提示里点「仍要打开」。
• 方式二：先双击一次触发拦截，再打开「系统设置 → 隐私与安全性」，下方会出现该文件的提示，点「仍要打开」即可。
• 之后再次双击就能正常启动了。也可以在终端执行 xattr -d com.apple.quarantine install_macos.command 移除拦截标记后再双击。

Q7：终端提示 command not found: python3 / brew？ A：说明 Python 还没装好。重新双击 install_macos.command，在选项里选 1（Homebrew 自动安装，推荐）；如果连 Homebrew 都没有，脚本会引导你先安装 Homebrew，再装 Python。请务必等终端显示「环境就绪 / 安装完成」后再执行 python3 launcher.py。

Q8：运行时终端报「No module named ...」？ A：一般是依赖没装全。在终端进入解压目录执行一次：

python3 -m pip install requests Pillow

然后重新 python3 launcher.py 即可。

Q9：macOS 能不能像 Windows 一样定时自动复盘？ A：可以。macOS 没有 Windows 的计划任务，但用系统自带的 launchd（推荐）或 crontab 就能实现交易日 18:30 自动静默复盘，详细步骤见第三节「第 4 步：设置每日自动复盘」。核心命令就是定时执行 python3 launcher.py --auto。