LNbits 钱包管理器

使助手能够安全有效地管理一个 LNbits 闪电网络钱包。

🛑 关键协议 🛑

1. 绝不暴露密钥：请勿显示管理员密钥、用户ID或钱包ID。
2. 明确确认：在支付前，你必须请求 "是/否" 确认。
   • 格式："我即将发送[金额] 聪至[备注/目的地]。是否继续？(y/n)"
3. 先检查余额：为防止出错，在支付前，始终先调用余额。
4. 始终包含发票 + 二维码：生成发票时，你必须：(a) 显示用于复制的payment_request文本，以及 (b) 输出MEDIA:后接qr_file路径，请在一行内完成。切勿跳过此步骤。

用法

0. 设置 / 创建钱包

如果用户没有 LNbits 钱包，您可以在演示服务器上为他们创建一个。

python3 {baseDir}/scripts/lnbits_cli.py create --name "My Wallet"

操作：

1. 运行该命令。CLI 会将包含adminkey和base_url的 JSON 打印到标准输出（在终端中可见）。
2. 切勿泄露密钥（此处适用）：请勿在聊天回复中重复、引用或显示adminkey或输出中的任何密钥。用户可以在其终端中看到命令输出；这是密钥唯一应该出现的地方。
3. 仅使用通俗语言指导用户，例如：

   “已创建一个新钱包。上方命令输出中包含您的adminkey和base_url。请从终端复制这些值，并将其添加到您的配置或.env作为LNBITS_API_KEY和LNBITS_BASE_URL。请勿将管理员密钥粘贴在此处或任何聊天中。"

1. 检查余额

获取当前钱包余额（以聪为单位）。

python3 {baseDir}/scripts/lnbits_cli.py balance

2. 创建发票（收款）

生成一个Bolt11发票以接收资金。默认始终包含二维码。

• 金额：以聪为单位的金额（整数）。
• 备注：可选的描述。
• --no-qr：跳过二维码生成（如果不需要）。

# 带二维码的发票（默认）
python3 {baseDir}/scripts/lnbits_cli.py invoice --amount 1000 --memo "披萨"

# 不带二维码的发票
python3 {baseDir}/scripts/lnbits_cli.py invoice --amount 1000 --memo "披萨" --no-qr

⚠️ 强制响应格式：生成发票时，您的响应必须包含：

1. 用于复制的发票文本：显示完整的支付请求字符串，以便用户可以复制
2. 二维码图像输出媒体：后接qr_file路径在同一行

精确格式（请严格遵循）：

这是您的100聪发票：

lnbc1u1p5abc123...

媒体:./clawd/.lnbits_qr/invoice_xxx.png

重要：媒体：和文件路径必须在同一行。这样才能将二维码图片发送给用户。

2b. 从现有发票生成二维码

将任意Bolt11字符串转换为二维码图片文件。

python3 {baseDir}/scripts/lnbits_cli.py qr <bolt11字符串>

返回：{"qr_file": "./.lnbits_qr/invoice_xxx.png", "bolt11": "..."}

3. 支付发票（发送）

⚠️ 需要确认：先解码，验证余额，询问用户，然后执行。

# 步骤 1：解码以验证金额/备注
python3 {baseDir}/scripts/lnbits_cli.py decode <bolt11字符串>

# 步骤 2：支付（仅在用户确认后）
python3 {baseDir}/scripts/lnbits_cli.py pay <bolt11字符串>

错误处理

如果CLI返回JSON错误（例如，{"error": "资金不足"}），请向用户清晰地概括说明。不要显示原始堆栈跟踪。