coder-firefly-cli 1.0.0__py3-none-any.whl

coder_firefly_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,239 @@
+Metadata-Version: 2.4
+Name: coder-firefly-cli
+Version: 1.0.0
+Summary: Firefly III CLI - 个人财务管理命令行工具
+Home-page: https://github.com/joyous-coder/coder-firefly-cli
+Author: coder
+Author-email: coder@example.com
+License: MIT
+Keywords: firefly-iii cli finance personal-finance
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.25
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: responses>=0.25; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# coder-firefly-cli
+
+Firefly III CLI - 个人财务管理命令行工具
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+## 前提条件
+
+- Python 3.10+
+- 运行中的 Firefly III 实例
+- Personal Access Token (PAT)
+
+## 配置
+
+### 环境变量（推荐）
+
+```bash
+export FIREFLY_BASE_URL="https://firefly.yourdomain.com"
+export FIREFLY_PAT="your-personal-access-token"
+```
+
+### 命令行参数
+
+```bash
+coder-firefly-cli --base-url https://firefly.yourdomain.com --pat your-token accounts list
+```
+
+## 使用方法
+
+### 账户管理
+
+```bash
+# 列出账户
+coder-firefly-cli accounts list
+coder-firefly-cli accounts list --type asset
+
+# 获取账户详情
+coder-firefly-cli accounts get --id 123
+
+# 创建账户
+coder-firefly-cli accounts create --name "现金" --type asset --currency-code CNY
+
+# 更新账户
+coder-firefly-cli accounts update --id 123 --name "新名称"
+
+# 删除账户
+coder-firefly-cli accounts delete --id 123
+```
+
+### 交易管理
+
+```bash
+# 列出交易
+coder-firefly-cli transactions list
+coder-firefly-cli transactions list --limit 10 --start 2024-01-01
+
+# 创建支出
+coder-firefly-cli transactions create --description "超市购物" --amount 100.00 --source-account 1
+
+# 创建转账
+coder-firefly-cli transactions create --description "转账" --amount 500.00 --source-account 1 --destination-account 2 --type transfer
+
+# 获取交易详情
+coder-firefly-cli transactions get --id 456
+
+# 删除交易
+coder-firefly-cli transactions delete --id 456
+```
+
+### 预算管理
+
+```bash
+# 列出预算
+coder-firefly-cli budgets list
+
+# 创建预算
+coder-firefly-cli budgets create --name "餐饮预算"
+
+# 设置预算限额
+coder-firefly-cli budgets limit-create --budget-id 1 --amount 2000 --start 2024-01-01 --end 2024-01-31
+```
+
+### 分类管理
+
+```bash
+# 列出分类
+coder-firefly-cli categories list
+
+# 创建分类
+coder-firefly-cli categories create --name "餐饮"
+```
+
+### 标签管理
+
+```bash
+# 列出标签
+coder-firefly-cli tags list
+
+# 创建标签
+coder-firefly-cli tags create --tag "重要"
+```
+
+### 账单管理
+
+```bash
+# 列出账单
+coder-firefly-cli bills list
+
+# 创建账单
+coder-firefly-cli bills create --name "房租" --amount-min 3000 --amount-max 3000 --date 2024-01-01
+```
+
+### 储蓄罐管理
+
+```bash
+# 列出储蓄罐
+coder-firefly-cli piggy-banks list
+
+# 创建储蓄罐
+coder-firefly-cli piggy-banks create --name "旅行基金" --account-id 1 --target-amount 10000
+```
+
+### 搜索
+
+```bash
+# 搜索交易
+coder-firefly-cli search transactions --query "超市"
+```
+
+### 洞察报告
+
+```bash
+# 支出洞察
+coder-firefly-cli insights expense --start 2024-01-01 --end 2024-01-31
+
+# 收入洞察
+coder-firefly-cli insights income --start 2024-01-01 --end 2024-01-31
+```
+
+### 系统信息
+
+```bash
+# 获取系统信息
+coder-firefly-cli info about
+
+# 检查连接状态
+coder-firefly-cli info status
+```
+
+## JSON 输出
+
+所有命令都支持 `--json` 参数以结构化格式输出：
+
+```bash
+coder-firefly-cli --json accounts list
+```
+
+## 故障排除
+
+### 连接失败
+
+```
+错误: 无法连接到 Firefly III 实例
+```
+
+检查：
+1. Firefly III 实例是否正在运行
+2. 基础 URL 是否正确
+3. 网络连接是否正常
+
+### 认证失败
+
+```
+错误: 认证失败: Personal Access Token 无效
+```
+
+检查：
+1. PAT 是否正确
+2. PAT 是否已过期
+3. 在 Firefly III 的 选项 > 个人资料 > OAuth 中生成新的 PAT
+
+## 开发
+
+```bash
+# 安装依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 代码格式化
+black src/
+```
+
+## 许可证
+
+MIT License

coder_firefly_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+commands/__init__.py,sha256=CWZPsSgPbJkjvUJRTnSOoNvHzClpKAHxT1ZsYOfTxXg,33
+commands/accounts.py,sha256=ecNFiVwi2nLE8oqsvGLp5bRVhbVtTSw-vSmIxTU1wOA,3270
+commands/bills.py,sha256=DmjqmNVmBSxxso1cokZOxoGsuU3Xofm0Sg06x7qwv2M,2782
+commands/budgets.py,sha256=S48263TalETyO_4qmUL1qTs7GV1sQFoMA3ZHy4Hhgos,3955
+commands/categories.py,sha256=sOwaIym29mebnSFf8z6spDyPPpPeX-rRuU2tI8E_chY,1946
+commands/info.py,sha256=TAeZOaGSKyQPhCVP40ZwekLxh396T5uXYc2aaRI5ClI,899
+commands/insights.py,sha256=PgsiyE6X2zLn7SSRdCVA5CW0ptYBSLDI5ElANo0YM0Y,2449
+commands/piggy_banks.py,sha256=zsqQyjB8-nfZh2ycr_MiuH6bqxwSzq7jdpJs8D9WtmI,2949
+commands/search.py,sha256=SyBIdrHAXOdA6nhIckWXaFPF4sn9ujqC9qtd2w8lO3I,571
+commands/tags.py,sha256=Gd7ir05CMrOKdpgjqIOdbFS4uVE2BS0p0ltY8T1pOvg,2564
+commands/transactions.py,sha256=QEjtg259YU_qfC5uZ-pmWCuAG-Mxxah-1vdcdjo2gqM,4820
+coder_firefly_cli-1.0.0.dist-info/METADATA,sha256=17ZZimvUAv7ZRsAOTaj_S98hloxf0NxqSKG_-yA02Nk,4759
+coder_firefly_cli-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+coder_firefly_cli-1.0.0.dist-info/entry_points.txt,sha256=KG7AR_EGrOib73vpbyAP-W79pyIcbsUQRXcZV1lEG_g,47
+coder_firefly_cli-1.0.0.dist-info/top_level.txt,sha256=6dNUbRvZAy7fLWNbD4YeUosLYwGk-SVew-Swd5CfFkg,9
+coder_firefly_cli-1.0.0.dist-info/RECORD,,

coder_firefly_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

coder_firefly_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+coder-firefly-cli = cli:main

coder_firefly_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+commands

commands/__init__.py

@@ -0,0 +1 @@
+# coder-firefly-cli 命令模块

commands/accounts.py

@@ -0,0 +1,113 @@
+r"""
+账户管理命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def accounts():
+    """管理账户"""
+    pass
+
+
+@accounts.command(name="list")
+@click.option("--type", 
+              type=click.Choice(['asset', 'expense', 'revenue', 'liability', 'all']),
+              default='all',
+              help="按账户类型筛选")
+@click.option("--limit", default=50, help="限制结果数量")
+@click.option("--page", default=1, help="页码")
+def accounts_list(type, limit, page):
+    """列出所有账户"""
+    client = get_client()
+    params = {"limit": limit, "page": page}
+    if type != 'all':
+        params["type"] = type
+    
+    result = client.get_accounts(params)
+    output(result)
+
+
+@accounts.command(name="get")
+@click.option("--id", required=True, type=int, help="账户 ID")
+def accounts_get(id):
+    """获取账户详情"""
+    client = get_client()
+    result = client.get_account(id)
+    output(result)
+
+
+@accounts.command(name="create")
+@click.option("--name", required=True, help="账户名称")
+@click.option("--type", 
+              required=True,
+              type=click.Choice(['asset', 'expense', 'revenue', 'liability']),
+              help="账户类型")
+@click.option("--currency-code", default="USD", help="货币代码 (ISO 4217)")
+@click.option("--opening-balance", default="0", help="初始余额")
+@click.option("--account-role", help="账户角色 (用于资产账户)")
+@click.option("--iban", help="IBAN")
+@click.option("--bic", help="BIC")
+@click.option("--account-number", help="账户号码")
+@click.option("--notes", help="备注")
+def accounts_create(name, type, currency_code, opening_balance, account_role, iban, bic, account_number, notes):
+    """创建新账户"""
+    client = get_client()
+    
+    data = {
+        "name": name,
+        "type": type,
+        "currency_code": currency_code,
+        "opening_balance": opening_balance,
+    }
+    
+    if account_role:
+        data["account_role"] = account_role
+    if iban:
+        data["iban"] = iban
+    if bic:
+        data["bic"] = bic
+    if account_number:
+        data["account_number"] = account_number
+    if notes:
+        data["notes"] = notes
+    
+    result = client.create_account(data)
+    output(result)
+
+
+@accounts.command(name="update")
+@click.option("--id", required=True, type=int, help="账户 ID")
+@click.option("--name", help="账户名称")
+@click.option("--opening-balance", help="初始余额")
+@click.option("--notes", help="备注")
+def accounts_update(id, name, opening_balance, notes):
+    """更新现有账户"""
+    client = get_client()
+    
+    data = {}
+    if name:
+        data["name"] = name
+    if opening_balance:
+        data["opening_balance"] = opening_balance
+    if notes:
+        data["notes"] = notes
+    
+    if not data:
+        click.echo("错误: 至少需要提供一个更新字段", err=True)
+        return
+    
+    result = client.update_account(id, data)
+    output(result)
+
+
+@accounts.command(name="delete")
+@click.option("--id", required=True, type=int, help="账户 ID")
+@click.confirmation_option(prompt="确定要删除此账户吗？")
+def accounts_delete(id):
+    """删除账户"""
+    client = get_client()
+    result = client.delete_account(id)
+    output(result)

commands/bills.py

@@ -0,0 +1,99 @@
+r"""
+账单管理命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def bills():
+    """管理账单"""
+    pass
+
+
+@bills.command(name="list")
+@click.option("--limit", default=50, help="限制结果数量")
+@click.option("--page", default=1, help="页码")
+def bills_list(limit, page):
+    """列出所有账单"""
+    client = get_client()
+    params = {"limit": limit, "page": page}
+    result = client.get_bills(params)
+    output(result)
+
+
+@bills.command(name="get")
+@click.option("--id", required=True, type=int, help="账单 ID")
+def bills_get(id):
+    """获取账单详情"""
+    client = get_client()
+    result = client.get_bill(id)
+    output(result)
+
+
+@bills.command(name="create")
+@click.option("--name", required=True, help="账单名称")
+@click.option("--amount-min", required=True, help="最小金额")
+@click.option("--amount-max", required=True, help="最大金额")
+@click.option("--date", required=True, help="账单日期 (YYYY-MM-DD)")
+@click.option("--repeat-freq", default="monthly", help="重复频率")
+@click.option("--skip", default=0, help="跳过次数")
+@click.option("--currency-code", default="USD", help="货币代码")
+@click.option("--notes", help="备注")
+def bills_create(name, amount_min, amount_max, date, repeat_freq, skip, currency_code, notes):
+    """创建新账单"""
+    client = get_client()
+
+    data = {
+        "name": name,
+        "amount_min": amount_min,
+        "amount_max": amount_max,
+        "date": date,
+        "repeat_freq": repeat_freq,
+        "skip": skip,
+        "currency_code": currency_code,
+    }
+    if notes:
+        data["notes"] = notes
+
+    result = client.create_bill(data)
+    output(result)
+
+
+@bills.command(name="update")
+@click.option("--id", required=True, type=int, help="账单 ID")
+@click.option("--name", help="账单名称")
+@click.option("--amount-min", help="最小金额")
+@click.option("--amount-max", help="最大金额")
+@click.option("--notes", help="备注")
+def bills_update(id, name, amount_min, amount_max, notes):
+    """更新现有账单"""
+    client = get_client()
+
+    data = {}
+    if name:
+        data["name"] = name
+    if amount_min:
+        data["amount_min"] = amount_min
+    if amount_max:
+        data["amount_max"] = amount_max
+    if notes:
+        data["notes"] = notes
+
+    if not data:
+        click.echo("错误: 至少需要提供一个更新字段", err=True)
+        return
+
+    result = client.update_bill(id, data)
+    output(result)
+
+
+@bills.command(name="delete")
+@click.option("--id", required=True, type=int, help="账单 ID")
+@click.confirmation_option(prompt="确定要删除此账单吗？")
+def bills_delete(id):
+    """删除账单"""
+    client = get_client()
+    result = client.delete_bill(id)
+    output(result)

commands/budgets.py

@@ -0,0 +1,147 @@
+r"""
+预算管理命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def budgets():
+    """管理预算"""
+    pass
+
+
+@budgets.command(name="list")
+@click.option("--limit", default=50, help="限制结果数量")
+@click.option("--page", default=1, help="页码")
+def budgets_list(limit, page):
+    """列出所有预算"""
+    client = get_client()
+    params = {"limit": limit, "page": page}
+    result = client.get_budgets(params)
+    output(result)
+
+
+@budgets.command(name="get")
+@click.option("--id", required=True, type=int, help="预算 ID")
+def budgets_get(id):
+    """获取预算详情"""
+    client = get_client()
+    result = client.get_budget(id)
+    output(result)
+
+
+@budgets.command(name="create")
+@click.option("--name", required=True, help="预算名称")
+@click.option("--notes", help="备注")
+def budgets_create(name, notes):
+    """创建新预算"""
+    client = get_client()
+
+    data = {"name": name}
+    if notes:
+        data["notes"] = notes
+
+    result = client.create_budget(data)
+    output(result)
+
+
+@budgets.command(name="update")
+@click.option("--id", required=True, type=int, help="预算 ID")
+@click.option("--name", help="预算名称")
+@click.option("--notes", help="备注")
+def budgets_update(id, name, notes):
+    """更新现有预算"""
+    client = get_client()
+
+    data = {}
+    if name:
+        data["name"] = name
+    if notes:
+        data["notes"] = notes
+
+    if not data:
+        click.echo("错误: 至少需要提供一个更新字段", err=True)
+        return
+
+    result = client.update_budget(id, data)
+    output(result)
+
+
+@budgets.command(name="delete")
+@click.option("--id", required=True, type=int, help="预算 ID")
+@click.confirmation_option(prompt="确定要删除此预算吗？")
+def budgets_delete(id):
+    """删除预算"""
+    client = get_client()
+    result = client.delete_budget(id)
+    output(result)
+
+
+# ========== 预算限额 ==========
+
+@budgets.command(name="limits")
+@click.option("--budget-id", required=True, type=int, help="预算 ID")
+@click.option("--start", help="开始日期 (YYYY-MM-DD)")
+@click.option("--end", help="结束日期 (YYYY-MM-DD)")
+def budgets_limits(budget_id, start, end):
+    """列出预算限额"""
+    client = get_client()
+    params = {}
+    if start:
+        params["start"] = start
+    if end:
+        params["end"] = end
+    result = client.get_budget_limits(budget_id, params)
+    output(result)
+
+
+@budgets.command(name="limit-create")
+@click.option("--budget-id", required=True, type=int, help="预算 ID")
+@click.option("--amount", required=True, help="金额")
+@click.option("--start", required=True, help="开始日期 (YYYY-MM-DD)")
+@click.option("--end", required=True, help="结束日期 (YYYY-MM-DD)")
+@click.option("--currency-code", default="USD", help="货币代码")
+def budgets_limit_create(budget_id, amount, start, end, currency_code):
+    """创建预算限额"""
+    client = get_client()
+
+    data = {
+        "amount": amount,
+        "start": start,
+        "end": end,
+        "currency_id": currency_code,
+    }
+
+    result = client.create_budget_limit(budget_id, data)
+    output(result)
+
+
+@budgets.command(name="limit-update")
+@click.option("--id", required=True, type=int, help="预算限额 ID")
+@click.option("--amount", help="金额")
+def budgets_limit_update(id, amount):
+    """更新预算限额"""
+    client = get_client()
+
+    data = {}
+    if amount:
+        data["amount"] = amount
+
+    if not data:
+        click.echo("错误: 金额是必填项", err=True)
+        return
+
+    result = client.update_budget_limit(id, data)
+    output(result)
+
+
+@budgets.command(name="limit-delete")
+@click.option("--id", required=True, type=int, help="预算限额 ID")
+@click.confirmation_option(prompt="确定要删除此预算限额吗？")
+def budgets_limit_delete(id):
+    """删除预算限额"""
+    client = get_client()
+    result = client.delete_budget_limit(id)
+    output(result)

commands/categories.py

@@ -0,0 +1,79 @@
+r"""
+分类管理命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def categories():
+    """管理分类"""
+    pass
+
+
+@categories.command(name="list")
+@click.option("--limit", default=50, help="限制结果数量")
+@click.option("--page", default=1, help="页码")
+def categories_list(limit, page):
+    """列出所有分类"""
+    client = get_client()
+    params = {"limit": limit, "page": page}
+    result = client.get_categories(params)
+    output(result)
+
+
+@categories.command(name="get")
+@click.option("--id", required=True, type=int, help="分类 ID")
+def categories_get(id):
+    """获取分类详情"""
+    client = get_client()
+    result = client.get_category(id)
+    output(result)
+
+
+@categories.command(name="create")
+@click.option("--name", required=True, help="分类名称")
+@click.option("--notes", help="备注")
+def categories_create(name, notes):
+    """创建新分类"""
+    client = get_client()
+
+    data = {"name": name}
+    if notes:
+        data["notes"] = notes
+
+    result = client.create_category(data)
+    output(result)
+
+
+@categories.command(name="update")
+@click.option("--id", required=True, type=int, help="分类 ID")
+@click.option("--name", help="分类名称")
+@click.option("--notes", help="备注")
+def categories_update(id, name, notes):
+    """更新现有分类"""
+    client = get_client()
+
+    data = {}
+    if name:
+        data["name"] = name
+    if notes:
+        data["notes"] = notes
+
+    if not data:
+        click.echo("错误: 至少需要提供一个更新字段", err=True)
+        return
+
+    result = client.update_category(id, data)
+    output(result)
+
+
+@categories.command(name="delete")
+@click.option("--id", required=True, type=int, help="分类 ID")
+@click.confirmation_option(prompt="确定要删除此分类吗？")
+def categories_delete(id):
+    """删除分类"""
+    client = get_client()
+    result = client.delete_category(id)
+    output(result)

commands/info.py

@@ -0,0 +1,36 @@
+r"""
+系统信息命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def info():
+    """系统信息"""
+    pass
+
+
+@info.command(name="about")
+def info_about():
+    """获取 Firefly III 系统信息"""
+    client = get_client()
+    result = client.get_about()
+    output(result)
+
+
+@info.command(name="status")
+def info_status():
+    """检查 Firefly III 连接状态"""
+    try:
+        client = get_client()
+        result = client.get_about()
+        click.echo("Firefly III 连接正常")
+        if 'data' in result:
+            attrs = result['data'].get('attributes', {})
+            click.echo(f"  版本: {attrs.get('version', 'N/A')}")
+            click.echo(f"  API 版本: {attrs.get('api_version', 'N/A')}")
+            click.echo(f"  环境: {attrs.get('environment', 'N/A')}")
+    except Exception as e:
+        click.echo(f"连接失败: {e}", err=True)

commands/insights.py

@@ -0,0 +1,87 @@
+r"""
+洞察命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def insights():
+    """查看财务洞察"""
+    pass
+
+
+@insights.command(name="expense")
+@click.option("--start", help="开始日期 (YYYY-MM-DD)")
+@click.option("--end", help="结束日期 (YYYY-MM-DD)")
+@click.option("--accounts", help="账户 ID (逗号分隔)")
+@click.option("--categories", help="分类 ID (逗号分隔)")
+@click.option("--budgets", help="预算 ID (逗号分隔)")
+@click.option("--tags", help="标签 (逗号分隔)")
+def insights_expense(start, end, accounts, categories, budgets, tags):
+    """支出洞察"""
+    client = get_client()
+    params = {}
+    if start:
+        params["start"] = start
+    if end:
+        params["end"] = end
+    if accounts:
+        params["accounts"] = accounts
+    if categories:
+        params["categories"] = categories
+    if budgets:
+        params["budgets"] = budgets
+    if tags:
+        params["tags"] = tags
+
+    result = client.get_insight("expense", params)
+    output(result)
+
+
+@insights.command(name="income")
+@click.option("--start", help="开始日期 (YYYY-MM-DD)")
+@click.option("--end", help="结束日期 (YYYY-MM-DD)")
+@click.option("--accounts", help="账户 ID (逗号分隔)")
+@click.option("--categories", help="分类 ID (逗号分隔)")
+@click.option("--tags", help="标签 (逗号分隔)")
+def insights_income(start, end, accounts, categories, tags):
+    """收入洞察"""
+    client = get_client()
+    params = {}
+    if start:
+        params["start"] = start
+    if end:
+        params["end"] = end
+    if accounts:
+        params["accounts"] = accounts
+    if categories:
+        params["categories"] = categories
+    if tags:
+        params["tags"] = tags
+
+    result = client.get_insight("income", params)
+    output(result)
+
+
+@insights.command(name="transfer")
+@click.option("--start", help="开始日期 (YYYY-MM-DD)")
+@click.option("--end", help="结束日期 (YYYY-MM-DD)")
+@click.option("--accounts", help="账户 ID (逗号分隔)")
+@click.option("--tags", help="标签 (逗号分隔)")
+def insights_transfer(start, end, accounts, tags):
+    """转账洞察"""
+    client = get_client()
+    params = {}
+    if start:
+        params["start"] = start
+    if end:
+        params["end"] = end
+    if accounts:
+        params["accounts"] = accounts
+    if tags:
+        params["tags"] = tags
+
+    result = client.get_insight("transfer", params)
+    output(result)

commands/piggy_banks.py

@@ -0,0 +1,99 @@
+r"""
+储蓄罐管理命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def piggy_banks():
+    """管理储蓄罐"""
+    pass
+
+
+@piggy_banks.command(name="list")
+@click.option("--limit", default=50, help="限制结果数量")
+@click.option("--page", default=1, help="页码")
+def piggy_banks_list(limit, page):
+    """列出所有储蓄罐"""
+    client = get_client()
+    params = {"limit": limit, "page": page}
+    result = client.get_piggy_banks(params)
+    output(result)
+
+
+@piggy_banks.command(name="get")
+@click.option("--id", required=True, type=int, help="储蓄罐 ID")
+def piggy_banks_get(id):
+    """获取储蓄罐详情"""
+    client = get_client()
+    result = client.get_piggy_bank(id)
+    output(result)
+
+
+@piggy_banks.command(name="create")
+@click.option("--name", required=True, help="储蓄罐名称")
+@click.option("--account-id", required=True, type=int, help="关联账户 ID")
+@click.option("--target-amount", required=True, help="目标金额")
+@click.option("--current-amount", default="0", help="当前金额")
+@click.option("--start-date", help="开始日期 (YYYY-MM-DD)")
+@click.option("--target-date", help="目标日期 (YYYY-MM-DD)")
+@click.option("--notes", help="备注")
+def piggy_banks_create(name, account_id, target_amount, current_amount, start_date, target_date, notes):
+    """创建新储蓄罐"""
+    client = get_client()
+
+    data = {
+        "name": name,
+        "account_id": account_id,
+        "target_amount": target_amount,
+        "current_amount": current_amount,
+    }
+    if start_date:
+        data["start_date"] = start_date
+    if target_date:
+        data["target_date"] = target_date
+    if notes:
+        data["notes"] = notes
+
+    result = client.create_piggy_bank(data)
+    output(result)
+
+
+@piggy_banks.command(name="update")
+@click.option("--id", required=True, type=int, help="储蓄罐 ID")
+@click.option("--name", help="储蓄罐名称")
+@click.option("--target-amount", help="目标金额")
+@click.option("--current-amount", help="当前金额")
+@click.option("--notes", help="备注")
+def piggy_banks_update(id, name, target_amount, current_amount, notes):
+    """更新现有储蓄罐"""
+    client = get_client()
+
+    data = {}
+    if name:
+        data["name"] = name
+    if target_amount:
+        data["target_amount"] = target_amount
+    if current_amount:
+        data["current_amount"] = current_amount
+    if notes:
+        data["notes"] = notes
+
+    if not data:
+        click.echo("错误: 至少需要提供一个更新字段", err=True)
+        return
+
+    result = client.update_piggy_bank(id, data)
+    output(result)
+
+
+@piggy_banks.command(name="delete")
+@click.option("--id", required=True, type=int, help="储蓄罐 ID")
+@click.confirmation_option(prompt="确定要删除此储蓄罐吗？")
+def piggy_banks_delete(id):
+    """删除储蓄罐"""
+    client = get_client()
+    result = client.delete_piggy_bank(id)
+    output(result)

commands/search.py

@@ -0,0 +1,25 @@
+r"""
+搜索命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def search():
+    """搜索交易"""
+    pass
+
+
+@search.command(name="transactions")
+@click.option("--query", required=True, help="搜索关键词")
+@click.option("--limit", default=50, help="限制结果数量")
+@click.option("--page", default=1, help="页码")
+def search_transactions(query, limit, page):
+    """搜索交易"""
+    client = get_client()
+    params = {"limit": limit, "page": page}
+    
+    result = client.search_transactions(query, params)
+    output(result)

commands/tags.py

@@ -0,0 +1,100 @@
+r"""
+标签管理命令组
+"""
+
+import click
+from cli import get_client, output
+
+
+@click.group()
+def tags():
+    """管理标签"""
+    pass
+
+
+@tags.command(name="list")
+@click.option("--limit", default=50, help="限制结果数量")
+@click.option("--page", default=1, help="页码")
+def tags_list(limit, page):
+    """列出所有标签"""
+    client = get_client()
+    params = {"limit": limit, "page": page}
+    result = client.get_tags(params)
+    output(result)
+
+
+@tags.command(name="get")
+@click.option("--id", required=True, help="标签 ID")
+def tags_get(id):
+    """获取标签详情"""
+    client = get_client()
+    result = client.get_tag(id)
+    output(result)
+
+
+@tags.command(name="create")
+@click.option("--tag", required=True, help="标签名称")
+@click.option("--date", help="日期 (YYYY-MM-DD)")
+@click.option("--description", help="描述")
+@click.option("--latitude", help="纬度")
+@click.option("--longitude", help="经度")
+@click.option("--zoom", help="缩放级别")
+@click.option("--notes", help="备注")
+def tags_create(tag, date, description, latitude, longitude, zoom, notes):
+    """创建新标签"""
+    client = get_client()
+
+    data = {"tag": tag}
+    if date:
+        data["date"] = date
+    if description:
+        data["description"] = description
+    if latitude:
+        data["latitude"] = latitude
+    if longitude:
+        data["longitude"] = longitude
+    if zoom:
+        data["zoom"] = zoom
+    if notes:
+        data["notes"] = notes
+
+    result = client.create_tag(data)
+    output(result)
+
+
+@tags.command(name="update")
+@click.option("--id", required=True, help="标签 ID")
+@click.option("--tag", help="标签名称")
+@click.option("--date", help="日期 (YYYY-MM-DD)")
+@click.option("--description", help="描述")
+@click.option("--notes", help="备注")
+def tags_update(id, tag, date, description, notes):
+    """更新现有标签"""
+    client = get_client()
+
+    data = {}
+    if tag:
+        data["tag"] = tag
+    if date:
+        data["date"] = date
+    if description:
+        data["description"] = description
+    if notes:
+        data["notes"] = notes
+
+    if not data:
+        click.echo("错误: 至少需要提供一个更新字段", err=True)
+        return
+
+    result = client.update_tag(id, data)
+    output(result)
+
+
+@tags.command(name="delete")
+@click.option("--id", required=True, help="标签 ID")
+@click.confirmation_option(prompt="确定要删除此标签吗？")
+def tags_delete(id):
+    """删除标签"""
+    client = get_client()
+    result = client.delete_tag(id)
+    output(result)

commands/transactions.py

@@ -0,0 +1,151 @@
+r"""
+交易管理命令组
+"""
+
+import click
+from datetime import datetime
+from cli import get_client, output
+
+
+@click.group()
+def transactions():
+    """管理交易"""
+    pass
+
+
+@transactions.command(name="list")
+@click.option("--limit", default=50, help="限制结果数量")
+@click.option("--page", default=1, help="页码")
+@click.option("--start", help="开始日期 (YYYY-MM-DD)")
+@click.option("--end", help="结束日期 (YYYY-MM-DD)")
+@click.option("--type",
+              type=click.Choice(['withdrawal', 'deposit', 'transfer']),
+              help="交易类型")
+@click.option("--source-account", help="源账户 ID 或名称")
+@click.option("--destination-account", help="目标账户 ID 或名称")
+def transactions_list(limit, page, start, end, type, source_account, destination_account):
+    """列出交易"""
+    client = get_client()
+    params = {"limit": limit, "page": page}
+
+    if start:
+        params["start"] = start
+    if end:
+        params["end"] = end
+    if type:
+        params["type"] = type
+    if source_account:
+        params["source_id"] = source_account
+    if destination_account:
+        params["destination_id"] = destination_account
+
+    result = client.get_transactions(params)
+    output(result)
+
+
+@transactions.command(name="get")
+@click.option("--id", required=True, type=int, help="交易 ID")
+def transactions_get(id):
+    """获取交易详情"""
+    client = get_client()
+    result = client.get_transaction(id)
+    output(result)
+
+
+@transactions.command(name="create")
+@click.option("--description", required=True, help="交易描述")
+@click.option("--amount", required=True, help="交易金额")
+@click.option("--source-account", required=True, help="源账户 ID")
+@click.option("--destination-account", help="目标账户 ID (转账时需要)")
+@click.option("--type",
+              type=click.Choice(['withdrawal', 'deposit', 'transfer']),
+              default='withdrawal',
+              help="交易类型")
+@click.option("--date", default=lambda: datetime.now().strftime('%Y-%m-%d'),
+              help="交易日期 (YYYY-MM-DD)")
+@click.option("--category", help="分类名称")
+@click.option("--tags", help="标签 (逗号分隔)")
+@click.option("--budget", help="预算名称")
+@click.option("--notes", help="备注")
+def transactions_create(description, amount, source_account, destination_account,
+                       type, date, category, tags, budget, notes):
+    """创建新交易"""
+    client = get_client()
+
+    transaction_data = {
+        "type": type,
+        "date": date,
+        "amount": amount,
+        "description": description,
+        "source_id": source_account,
+    }
+
+    if destination_account:
+        transaction_data["destination_id"] = destination_account
+    if category:
+        transaction_data["category_name"] = category
+    if tags:
+        transaction_data["tags"] = [tag.strip() for tag in tags.split(",")]
+    if budget:
+        transaction_data["budget_name"] = budget
+    if notes:
+        transaction_data["notes"] = notes
+
+    data = {
+        "error_if_duplicate_hash": True,
+        "error_if_duplicate_hash_v2": True,
+        "apply_rules": True,
+        "fire_webhooks": True,
+        "group_title": description,
+        "transactions": [transaction_data]
+    }
+
+    result = client.create_transaction(data)
+    output(result)
+
+
+@transactions.command(name="update")
+@click.option("--id", required=True, type=int, help="交易 ID")
+@click.option("--description", help="交易描述")
+@click.option("--amount", help="交易金额")
+@click.option("--category", help="分类名称")
+@click.option("--tags", help="标签 (逗号分隔)")
+@click.option("--notes", help="备注")
+def transactions_update(id, description, amount, category, tags, notes):
+    """更新现有交易"""
+    client = get_client()
+
+    transaction_data = {}
+    if description:
+        transaction_data["description"] = description
+    if amount:
+        transaction_data["amount"] = amount
+    if category:
+        transaction_data["category_name"] = category
+    if tags:
+        transaction_data["tags"] = [tag.strip() for tag in tags.split(",")]
+    if notes:
+        transaction_data["notes"] = notes
+
+    if not transaction_data:
+        click.echo("错误: 至少需要提供一个更新字段", err=True)
+        return
+
+    data = {
+        "apply_rules": True,
+        "fire_webhooks": True,
+        "transactions": [transaction_data]
+    }
+
+    result = client.update_transaction(id, data)
+    output(result)
+
+
+@transactions.command(name="delete")
+@click.option("--id", required=True, type=int, help="交易 ID")
+@click.confirmation_option(prompt="确定要删除此交易吗？")
+def transactions_delete(id):
+    """删除交易"""
+    client = get_client()
+    result = client.delete_transaction(id)
+    output(result)