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.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 | |
|---|---|---|---|
| fane-2.2.0.tar.gz | 95.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fane-2.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 193.7 kB
Release files / fane-2.2.0.tar.gz
| Download URL | fane-2.2.0.tar.gz |
|---|---|
| Size | 95.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0e635ee2e9bb01df11751d58a250bd9d908eeb5f67f2b6cbb451b04f552e4734
|
|
BLAKE2b-256 checksum How to use checksums |
537493350bb7f288a8cab38265e9174b72f53b875ce89dfbc8cb0fd361465a4f
|
| 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.0-py3-none-any.whl
| Download URL | fane-2.2.0-py3-none-any.whl |
|---|---|
| Size | 97.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cefceacc9020354ebaf42d7e099bb1aa0e38ed32c7e247dc22b86913d684eeab
|
|
BLAKE2b-256 checksum How to use checksums |
d71d6cf8d084531899b7b05222a5ddabdd043d1a71cecc05a8badaf7a6996a2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|