From ac5a3c6dd7b8dd49a6c97834c6f4d53ee5b1bc25 Mon Sep 17 00:00:00 2001
From: SerinaNya <34389622+SerinaNya@users.noreply.github.com>
Date: Tue, 23 Jun 2026 14:52:19 +0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(AGENTS.md):=20init?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 packages/fluxent/AGENTS.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 packages/fluxent/AGENTS.md

diff --git a/packages/fluxent/AGENTS.md b/packages/fluxent/AGENTS.md
new file mode 100644
index 0000000..410097f
--- /dev/null
+++ b/packages/fluxent/AGENTS.md
@@ -0,0 +1,37 @@
+# Fluxent 记账逻辑
+
+## dc_flag 语义
+
+`dc_flag` 表示**资金流向**（从用户角度），不反转：
+
+- `DEBIT` = 资金流出（支出）
+- `CREDIT` = 资金流入（收入）
+
+## 账户类型与余额变化
+
+`account_type` 决定余额如何变化：
+
+| 账户类型 | DEBIT（支出） | CREDIT（收入） |
+|----------|--------------|---------------|
+| `ASSET`（资产） | 余额减少 | 余额增加 |
+| `LIABILITY`（负债） | 负债减少（还款） | 负债增加（消费/借款） |
+| `EQUITY`（权益） | 权益减少 | 权益增加 |
+
+## 信用卡交易示例
+
+| 交易 | 账户 | account_type | dc_flag | 余额变化 |
+|------|------|-------------|---------|---------|
+| 用信用卡买咖啡 ¥30 | 信用卡 | LIABILITY | DEBIT | 负债 +30 |
+| 从储蓄卡还信用卡 ¥5000 | 储蓄卡 | ASSET | DEBIT | 余额 -5000 |
+| 从储蓄卡还信用卡 ¥5000 | 信用卡 | LIABILITY | CREDIT | 负债 -5000 |
+
+## 会计恒等式
+
+同币种时校验：
+
+- **CREDIT（收入）**: `posting_amt = txn_amt + surcharge_amt - comm_amt - disc_amt`
+- **DEBIT（支出）**: `posting_amt = txn_amt + surcharge_amt + comm_amt - disc_amt`
+
+## 金额/币种对校验
+
+可选的金额/币种对（`posting_amt/ccy`、`comm_amt/ccy`、`surcharge_amt/ccy`、`disc_amt/ccy`）必须同时为 `None` 或同时有值。
\ No newline at end of file