VE5 — 本地优先的 AI 财务管家

VE5（VEfinsteward）是一款运行在你自己电脑上的 AI 财务管家。它把分散在各金融机构的账户截图、账单与持仓数据，在你的本地设备上完成识别、整理与分析，并提供资产配置、消费诊断、目标跟踪与生活规划等能力。

核心立场：你的财务数据只属于你。所有数据默认保存在本地，隐私相关任务默认由本地模型处理，不向云端回传。

功能概览

• 财务数据摄取：通过手机截图（证券持仓、银行余额、消费账单等）自动提取结构化财务数据，支持 OCR 与多通道接收。
• 资产配置：战略资产配置（大类资产比例）与战术分析（基本面 / 技术面 / 量化回测），并输出可执行的配置建议。
• 消费结构诊断：基于账单数据识别消费层级、习惯与可优化空间。
• 目标跟踪：设定财务目标并跟踪进度，自动沉淀为可复用的经验。
• 生活管家：围绕财务状况给出食谱、出游与日用品清单等生活规划建议。
• 经验运行时（Experience Runtime）：VE5 内置经验系统，将重复出现的财务决策场景沉淀为“经验”，后续遇到相似场景时优先复用经验，减少重复的模型调用。
• 财务隐私 RAG：本地向量知识库，管理用户自己的财务偏好与历史数据，增删权利始终在用户手中。

技术架构

VE5 采用「本地后端 + 桌面窗口 + 浏览器前端」的轻量架构：

• FastAPI：本地 HTTP API 服务，承载业务逻辑与 AI 调用网关。
• pywebview：桌面窗口（基于 WebView2），启动后自动打开应用界面。
• PWA 前端：纯静态 HTML/CSS/JS 页面，可通过浏览器访问。
• SQLite / Chroma：本地数据存储与向量检索，数据不出本机。
• Experience Runtime：独立子项目，见 experience_runtime。

AI 能力通过统一的 AI Gateway 接入，支持本地模型（Ollama 等）与 OpenAI 兼容的云端 API；含隐私数据的任务强制走本地模型，不可回退云端。

安装与运行

直接运行打包版

从 Releases 下载 VE5.exe 即可运行（打包版内置 Python 运行时与依赖）。首次启动会在程序目录下生成 userdata/，用于存放你的本地数据。

从源码运行

环境要求：Python 3.10+，Windows。

# 安装依赖
pip install -r requirements-desktop.txt

# 启动（自动打开桌面窗口；若无 pywebview 则回退到浏览器）
python ve5_desktop_launcher.py

也可以通过 run_ve5.bat 一键启动。

打包为可执行文件

# 完整打包
python build_portable.py

# 仅同步业务代码到 dist（不重新打包 exe）
python build_portable.py --rapid

也可以直接使用项目自带的 PyInstaller 配置：

pyinstaller VE5.pyinstaller.spec

配置

• AI 提供商：编辑 config/ai_providers.yaml 配置本地或云端模型。云端 API Key 通过环境变量注入（如 TRAEV4_CLOUD_API_KEY），不写入代码。
• 数据目录：默认数据目录为项目根目录下的 userdata/。可通过环境变量指定其他位置：

$env:VE5_DATA_DIR="$env:APPDATA\VE5"

隐私说明

• 所有财务数据、截图、知识库与经验数据默认仅存储在本机。
• 含敏感数据的任务强制由本地模型处理；只有明确不含隐私数据的任务（如公开研报摘要）才允许使用云端模型。
• 项目不会默认复用或复制其他版本的数据目录，避免误碰既有隐私数据。

项目结构

api/        FastAPI 后端接口
core/       核心业务（AI 网关、资产配置、经验桥接等）
receiver/   截图接收、OCR 与数据提取
pwa/        前端页面
tactical/   战术分析（基本面 / 量化）
docs/       设计文档
config/     配置文件

相关项目

• experience_runtime：VE5 使用的经验运行时。