Openclaw용 Beancount Import

전제 조건: 대상 파일이 포함된 루트를 가진 기존 로컬 Beancount 원장, 그리고 bea 및 bean-check. 문서화된 옵션 중 하나를 사용하여 bea를 설치합니다:

brew install bex-co/tap/bea

또는 uv로 Beancount.io 패키지를 설치합니다:

uv tool install beancount-io

가져오기 전에 기술의 관련 참조를 읽으십시오: 새 소스 또는 변경된 소스 형식에 대해서는 references/formats.md, 중복 처리에 대해서는 references/dedup.md, 그리고 카테고리화, 브로커 활동 및 bea 명령에 대한 해당 지침을 읽으십시오. 다음을 사용하여 원장 파일을 찾습니다:

fd -e beancount -e bean . | head -20
# 대체:
find . -maxdepth 4 \( -name '*.beancount' -o -name '*.bean' \)

소스 계정과 기존 추가 대상을 식별합니다. 이 기술은 대상 파일을 생성하거나 은행에서 데이터를 가져오지 않습니다. 첫 번째 가져오기 시 소스 매핑, 날짜 및 부호 규칙, 대상을 확인합니다. 승인 및 성공적인 기록 후에는 이러한 세부 정보가 반복 가져오기를 위해 기본 원장의 구성 주석 블록에 저장됩니다. 이 로컬 원장 워크플로를 통해 호스팅된 Beancount.io 원장에서 가져오기를 실행하지 마십시오.

이 기술은 date, 원장 부호 규칙의 amount, payee/description, 보류 중인 상태, 그리고 OFX FITID와 같은 선택적 네이티브 ID의 필드가 포함된 정규화된 행을 스테이징합니다. 승인된 각 거래에는 정확한 재가져오기 감지를 위해 import-id 메타데이터가 부여됩니다. PDF 행은 검토를 위해 페이지 및 줄 참조를 유지합니다.

항목은 기존 거래를 편집하거나 삭제하는 데 사용되는 것이 아니라 추가됩니다. PDF 가져오기는 또한 명세서 기간 다음 날짜로 지정된 기말 balance 어설션을 추가합니다. 명세서를 참조하는 document 지시문은 선택 사항이며 별도의 승인이 필요하고 가져오기가 성공한 후에만 추가됩니다. 이 기술은 option, plugin 또는 include 지시문을 변경하지 않습니다.