Fane
把支付宝、微信账单变成 Beancount,管理分类、订阅、账本与查询。入口是 fa。
uv tool install .
fa -c config/bill.local.yaml config init
fa -c config/bill.local.yaml config check
Python 3.11+,macOS/Linux。开发安装用 uv pip install -e .。
配置可以用 fa -c PATH,也可以一次设置:
export FANE_CONFIG=/path/to/fane.yaml
export FANE_LEDGER=/path/to/main.bean
常用命令:
fa convert -p wechat -s bill.xlsx
fa bill sync daily --write --json
fa classify extract | your-classifier | fa classify apply --write
fa sub generate --write
fa check
fa query 2026-09-01 2026-09-30
fa serve --host 127.0.0.1 --port 8080
命令可以通过 JSON/JSONL 组合。启用 shell 的 pipefail 可以传播前一步失败:
set -o pipefail
fa convert -p wechat -s bill.xlsx -f jsonl | fa ingest journal --write
账本写入命令默认预览,--write 才修改账本。n8n 的 fa flow 按流程操作执行。
命令显式注册,功能按业务目录拆卸。旧导入壳、动态别名、插件注册与旧命令均已移除。
查询兼容原 ledger-query 的 /health 和 /query,不调用 Flova。
| 需要什么 | 文档 |
|---|---|
| 安装与工作流 | 使用 |
| 全部参数与指令契约 | 命令 |
| YAML、规则与订阅 | 配置 |
| 目录和拆卸 | 模块 |
| rn 部署与 n8n | 自动化 |
rn 使用 uv 安装 Fane,由 systemd 的 fane.service 管理查询进程;n8n 通过内部网络调用它。部署定义见 服务。
项目同时支持 Docker,从项目根目录执行 docker build -f deploy/Dockerfile -t fane .;Docker 构建只包含程序源码,不包含 token 或本地账本。
Metadata
Release files for Fane 2.2.1
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 |
|---|---|---|---|---|
| fane-2.2.1.tar.gz | 76.4 kB | Without provenance | Details for fane-2.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| fane-2.2.1-py3-none-any.whl | Python 3 | none | any | Details for fane-2.2.1-py3-none-any.whl |
Total release size: 176.2 kB
Release files / fane-2.2.1.tar.gz
| Download URL | fane-2.2.1.tar.gz |
|---|---|
| Size | 76.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
270872283d426574b569906c52d76af78e108cbec101240fb1362420fb552633
|
|
BLAKE2b-256 checksum How to use checksums |
580eda473e5a790ff542e85bf296c7f2d76b9f89c1a3b32dda4ecca87edde795
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / fane-2.2.1-py3-none-any.whl
| Download URL | fane-2.2.1-py3-none-any.whl |
|---|---|
| Size | 99.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6808388ea8b3cd8c79ec04e7b3ec91edba5262a8df193534a6c2ac2f9998be59
|
|
BLAKE2b-256 checksum How to use checksums |
38923a05a173160f0b635e30767620e9c817706ba1a3154e95b2ae47b5877c95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Security for Fane 2.2.1
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.