Flova
Flova 把 webhook、只读账本查询、财务适配、本机服务启停和远程部署合成一个可安装的项目。配置与业务数据留在服务器,源码留在本地。
uv tool install 'flova[download]'
flova --config /path/to/flova.toml config check
flova webhook serve
flova finance prepare --offline --date 2026-10-03
flova finance finish --write --decisions-base64 'BASE64_JSON'
flova service start
flova service restore # 仅恢复资源,不启动任务
flova service stop
flova service check
flova service pack
flova service pack --keep-stopped # 正式迁移,成功后保持旧机停止
仅运行 ledger 时安装 uv tool install 'flova[ledger]',用 flova ledger serve 启动,或 flova ledger query --start YYYY-MM-DD --end YYYY-MM-DD 查询。
flova download -p alipay --download-config /path/to/download.json 使用现有下载库的提供者工厂,并明确读取配置路径,不再改写第三方包源码。
flova-download download 提供旧 dflow 命令的参数和 JSON 兼容入口,服务器 dflow 入口指向它。
默认配置 /root/.flow/config/flova.toml。支持 ${ENV_NAME} 占位符,缺失变量直接报错。模板见 examples/。--config 和 --root 是全局参数,放在功能指令前。FLOVA_CONFIG、FLOVA_ROOT 可设置默认位置。
Webhook 验证 GitHub HMAC SHA256,只响应指定分支的 push;同一仓库同步互斥,保持旧服务的 fetch/reset/clean 镜像同步语义。因此应指向自动部署仓库,不应指向有未提交人工改动的开发目录。同步后的可选 HTTP hook 由配置指定;失败记录类型,不把凭据或请求正文写入日志。
账本接口保持 GET /health 和 POST /query,字段 start_date、end_date、max_transactions,仍输出 schema_version=1、收入/支出/资产负债变动、分录及警告。日期范围最多366天;查询只读。
财务功能只编排 fa、下载提供者和 oub;Fane 负责解析、模板、去重和分类。prepare --offline 不下载、解压、写交易、调用AI或推送。finish 不带 --write 为预览;未配置实际订阅计划时明确失败,不假装成功。
服务指令读取服务器 config/services.json 和唯一 config/compose.yaml。启动重复执行不会重建正在运行的容器。普通打包短暂停止 webhook、暂停容器以复制一致数据,立即恢复,再导出镜像。正式迁移使用 --keep-stopped:先停稳服务再复制数据,成功后旧机保持停止,禁用 webhook 自启与容器自动重启;失败或回退启动恢复原策略。包保留 n8n 配置和所有权,包含秘密,应私有保存。
换 VPS 在本地执行一条命令:
uvx --from 'flova==0.3.0' flova migrate rn root@新服务器IP --execute
新机使用干净的 Ubuntu 24.04 x86_64,并能从本地以 root SSH 登录。命令自动装依赖、停旧机打包、校验传输、恢复 uv/镜像/卷、合并 SSH/Git、更新 n8n SSH 地址并恢复原发布版本。不带 --execute 只预检;旧机保持停止,最后手动切 DNS。完整行为与回退边界见 迁移手册。
开发:uv sync --all-extras,uv run python -m unittest discover -s tests,uv run ruff check src tests。发布:PYPI_TOKEN_FILE=/private/path/token ./release.sh --yes。token 不进入项目分发包。
远程盘点、清单备份恢复和 Docker 克隆见 主机管理,统一入口 flova host,无需本机服务器配置。原 Deploior 功能已全部迁入,配置模板为 examples/hosts.toml。
完整换 VPS 步骤见 迁移手册,部署概览见 服务器说明,完整参数见 指令参考,财务流程见 n8n说明。发布新版本前先提高 pyproject.toml 版本号,PyPI 已发布版本不能覆盖。
Metadata
Release files for flova 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| flova-0.3.0.tar.gz | 75.7 kB | Without provenance | Details for flova-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| flova-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for flova-0.3.0-py3-none-any.whl |
Total release size: 129.4 kB
Release files / flova-0.3.0.tar.gz
| Download URL | flova-0.3.0.tar.gz |
|---|---|
| Size | 75.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ef7410b61401cdc427fcf0eba11031cbc12cc61a80b96a281c1c036c81714188
|
|
BLAKE2b-256 checksum How to use checksums |
85faabddde20451fed5d637915c4ed7c176c080bd06d795a4a3561b1c5ecd285
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / flova-0.3.0-py3-none-any.whl
| Download URL | flova-0.3.0-py3-none-any.whl |
|---|---|
| Size | 53.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d2bf0c9b5bee0fd4ff09b96ffaa5b2dea0ceb955168edb38e85a1feb447435d7
|
|
BLAKE2b-256 checksum How to use checksums |
ba95baa5e629ad1d62f7bf8bcb9cbe5781262f41664ffd12bb6100869dc732f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for flova 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.