Repository navigation
Floe Version 2.0.0
🎯 核心主题:品牌焕新 Floe & 跨平台桌面软件化 —— 重构「选股 → 关注池 → 回测」三步核心工作台,支持 macOS / Windows / Linux 一键免配置桌面运行与 Homebrew / npm 多渠道安装。
🆕 新增
1. 全新现代量化工作台 UI 与业务动线重塑
- 聚焦三步核心主工作流:默认首屏
01 市场选股(仅展示入场日期 = 数据截止日的当日新入场标的,自动过滤早期入场副产物)→02 关注股票池(一键入池、自动补全股票简称、实时信号联动)→03 策略回测与监控(默认开启MA5 > MA20简化版策略,历史回测绩效表仅统计本机选股曾入选标的并自首次入选日起算累计收益) - 浅色 / 深色双主题 + 全站中英双语(i18n):前端第三方依赖(Bootstrap / Marked)100% 本地化离线内嵌;切换为
English后,界面文案与后续新生成的 AI 投研报告均自动切换为英文输出 - 双款企鹅图标切换:内置「红涨瞭望款(默认)」与「绿跌闭眼款」两套全平台图标,支持在设置页实时切换界面图标与 macOS 桌面 Dock 图标
2. 跨平台一键运行桌面客户端(macOS / Windows / Linux)
- 原生独立窗口 + 菜单栏常驻:新增统一启动器
floe_app.py,支持pywebview原生桌面窗口与--web浏览器双模启动;内置 macOS 顶部状态菜单栏极简小企鹅常驻快捷菜单与跨平台系统托盘 - 用户数据与安装包彻底解耦:桌面打包模式下,关注池、交易台账、密钥配置与行情缓存自动存储于系统标准用户目录(macOS
~/Library/Application Support/Floe、Windows%APPDATA%\Floe、Linux~/.local/share/floe),覆盖升级绝不丢失个人数据 - 端口冲突自动顺延:默认监听
127.0.0.1:3130,若端口被占用自动向后探测空闲端口平滑启动
3. 买卖记录台账与逐手(FIFO)收益核算
- 支持录入 三位小数(
0.001) 成交均价(适配 ETF、场内基金与分批成交均价) - 自动按先进先出(FIFO)核算历史已平仓实现盈亏与在持仓最新现价浮动盈亏,支持展开任意股票查看每一手买卖盈亏明细
4. 系统设置中心(两步验证 AI · 权限体检 · 检查更新 · 备份恢复)
- AI 与数据源可视化配置:未配置 AI 或 Tushare 时顶栏自动提醒跳转;AI 配置采用「第 1 步验证 API/Ollama 连接实时拉取模型列表 → 第 2 步下拉选定模型保存」流程(默认推荐 DeepSeek API,透明兼容全站 16 个分析模块)
- 系统权限与环境体检:支持一键授权并测试后台任务完成桌面通知、切换国内直连/跟随系统代理模式、运行磁盘/回环/行情源连通性体检
- 版本更新与资产备份:内置「关于我们」与 GitHub Releases 检查更新,支持一键导出/安全恢复(AST 纯字面量校验)包含关注池、台账与配置的
.zip备份包
5. 多渠道自动化发布体系
- 新增 GitHub Actions 四架构构建流水线(macOS arm64/x64
.dmg、Windows x64.zip/.exe、Linux x64.AppImage)、Homebrew Cask 配方(Leo-luxy/tap)与 npm 跨平台启动器(@leo-luxy/floe)
⚠️ 升级提示
- 默认 Web 监听端口调整为
3130(可通过环境变量GP_ANA_WEB_PORT自定义;端口占用时会自动顺延并在终端提示) - 通过桌面安装包(
.dmg/.exe/.AppImage)首次运行时,可在「系统设置 → 数据备份与目录」一键导入原有配置备份
📦 安装与运行
方式一:Homebrew(macOS)
brew tap Leo-luxy/tap
brew install --cask floe方式二:npm(macOS / Windows / Linux)
npm install -g @leo-luxy/floe
floe方式三:源码运行
git clone git@github.com:Leo-luxy/Floe.git
cd Floe
cp config.example.py config.py
pip install -r requirements.txt
python web_ui.py # 浏览器访问 http://127.0.0.1:3130
# 或安装 pywebview 后启动独立桌面窗口:python floe_app.py✅ 质量
- 回归测试扩充至 309 项,新增覆盖跨平台路径隔离、冻结态子进程调度、双语指令注入、三位小数 FIFO 台账、安全备份 AST 校验与端口冲突顺延
完整变更对比:v1.6.0...v2.0.0