用途:自动更新三个法人(韩国/美国/越南)的银行余额与收支,写入 Google Sheets 的 Cash Position Summary。
主要能力:美国 Chase(checking ...6797)与 Hanmi(checking ...3389)通过 Plaid API 自动查询,无需 CSV;韩国(农协/我们/新韩等)需从 Clobe.ai 下载 Excel;越南我们银行需下载 xls,Techcombank 需下载 CSV。核心脚本为 scripts/parse_cash_position.py,运行环境为 /Users/ash/Documents/eoash/.venv/bin/python(已安装 plaid、pandas、dotenv)。
使用方式:仅美国时运行 /Users/ash/Documents/eoash/.venv/bin/python scripts/parse_cash_position.py --plaid --month {YYYY.MM} [--dry-run] [--skip-revenue];全量时追加 --clobe ~/Downloads/주식회사*.xlsx --vietnam ~/Downloads/ExcelSheet*.xls;Plaid 故障时可用 --chase 与 --hanmi 的 CSV 方式回退。未指定月份时自动使用当前月。建议先用 --dry-run 查看结果,确认后再实际更新。
配置:脚本自动加载项目根目录 .env,需 PLAID_CLIENT_ID、PLAID_SECRET、PLAID_ENV=production、PLAID_ACCESS_TOKEN_CHASE、PLAID_ACCESS_TOKEN_HANMI;Google Sheets 服务账号配置在 finance-dashboard/.env.local。
限制:不加 --dry-run 会直接修改 Google Sheets;Plaid access_token 为永久令牌,但银行密码变更后需重新连接(python scripts/plaid_link_connect.py → localhost:8484);韩国与越南不支持 Plaid,必须手动下载文件。