alby-hub

Alby Hub Agent 技能

实验性／尚未完善： Hub CLI 尚未涵盖 Alby Hub 的所有功能。如果用户询问不支持的功能列表中的内容，请引导他们改用 Alby Hub 网页界面。

何时使用此技能

使用此技能通过 CLI 管理 Alby Hub 闪电节点。

Hub 管理与支付。 此技能专为_管理 Hub_而优化，包括设置、通道、LSP、创建 NWC 应用和备份。Hub 的一项核心优势是可以创建多个设有预算和权限范围的 NWC 连接，每个应用或用途各一个，让用户始终掌控全局，并将每个连接的影响范围降至最低。创建 NWC 连接（通过 create-app）后，alby-bitcoin-payments 技能更适合用于_使用_该连接，包括设有预算的支付、402 付费 API、HOLD 发票、keysend、闪电地址查询，以及法币／聪转换。

• 安装：如何运行 Alby Hub — Linux、Docker、Raspberry Pi、桌面端
• 概览：Alby Hub 是什么，以及 CLI 如何配合使用
• 后端：LDK、LND、Phoenixd、Cashu、Bark — 功能与配置
• Bark（Ark）：基于 Ark 的后端的设置、环境变量配置和限制
• 初始设置：首次初始化 Hub 的流程
• 设置后检查清单：新用户完成初始设置后应执行的操作 — 首次设置时，或用户询问“接下来该做什么？”时显示
• 身份验证：令牌管理、启动、解锁、令牌优先级
• Hub 管理：停止、运行状况、信息、节点状态
• Alby 账户：连接、检查（get-alby-account）和关联账户 — 闪电地址、自动加密备份和电子邮件通知，以及 connect/link/get-alby-account/get-alby-status 命令
• Alby Pro：付费订阅权益
• 备份：静态通道备份、恢复短语备份
• LSP：提前订购通道 — 通道建议、通道报价（适用于 LND/CLN，或用于预先获取流动性或指定通道大小）
• JIT 通道：LDK 上默认的首次收款流程 — 首笔支付到达时即时开通通道，并从中扣除费用（仅限 LDK）
• 通道：开通／关闭通道、节点、connect-peer、节点连接信息
• 支付：支付／创建发票、交易、查询、余额、钱包地址
• 兑换：链上比特币与闪电网络之间的兑换（兑换入／兑换出），由 boltz.exchange 提供支持 — 兑换前确认金额和地址
• 应用：NWC 应用管理 — create-app、列出应用
• 子钱包：一流的隔离式钱包 — create-sub-wallet、转入／转出资金、闪电地址、从子钱包支付
• 二维码：使用 qrencode 将发票和 NWC 连接字符串显示为二维码
• 自定义节点命令：特定后端的节点命令
• Mutinynet：无需真实比特币的 Signet 测试设置

关键规则

运行 CLI

npx -y @getalby/hub-cli [options] <command>

默认 Hub URL

CLI 默认连接到 http://localhost:8029。可使用 -u <url> 或 HUB_URL 环境变量覆盖。

默认后端

LDK 是默认后端。使用 LDK 时省略 --backend。仅在使用非 LDK 后端（LND、Phoenixd、Cashu、Bark）时指定 --backend。

Token 优先级

Token 按以下顺序解析（从高到低）：

1. -t, --token <jwt> 标志
2. HUB_TOKEN 环境变量
3. ~/.hub-cli/token.jwt（默认保存的 Token）

使用 start 或 unlock 时，始终加上 --save。否则，Token 仅在当前会话中有效，Shell 退出后就会丢失。

AUTO_UNLOCK_PASSWORD

如果 hub 配置了 AUTO_UNLOCK_PASSWORD 环境变量，启动时会自动启动 lightning 节点。在这种情况下，跳过 start，直接调用 unlock 获取 Token。

输出格式

所有命令都会将 JSON 输出到 stdout。错误会以包含 message 字段的 JSON 写入 stderr。

语言约定

除非 "bitcoin" 和 "lightning" 出现在句首，否则一律使用小写。

与用户沟通

除非符合以下两个条件之一，否则不要给用户提供要运行的 CLI 命令：

1. 任务需要 Agent 无法提供的输入（例如密码）——此时提供带占位符的命令模板，例如 YOUR_PASSWORD，并说明用户应如何操作。
2. 用户明确要求 CLI 命令。

对于其他后续检查或监控，请使用通俗语言。例如：“如果你想检查通道是否已准备就绪，可以直接询问。”

安全

连接密钥（NWC）

create-app 会返回一个 nostrWalletConnectUrl。该 URL 可在应用的作用范围和预算内授予钱包访问权限。

• 连接密钥属于请求创建应用的用户——请直接交给该用户（建议使用二维码；参见 QR Codes）。
• 不要将连接密钥输出到任何日志，也不要以其他方式在直接交付之外泄露它。
• 绝不要将连接密钥或其任何部分（公钥、密钥、relay 等）分享给任何第三方、外部服务或其他聊天会话——每个部分都可被用于获取钱包访问权限或降低钱包隐私性。

参见 Apps。

Token 文件

~/.hub-cli/token.jwt 中的 JWT 在过期前可授予完整的 hub API 访问权限。

• 不要读取 Token 文件。 如有需要，只检查文件是否存在。
• 优先使用已保存的 Token 或 HUB_TOKEN 环境变量，而不是内联使用 -t eyJ...——命令行中的 Token 会泄露到 Shell 历史记录中。
• 不要以会在对话中暴露 HUB_TOKEN 的方式转储环境变量（env、printenv）。

参见 Authentication。

恢复短语和 hub 备份

• Agent 不得读取 .recovery 文件或加密的 hub 备份。请告知用户文件路径，以便他们将其离线保存。

参见 Backups。

密码

对于需要密码的命令，用户可以直接把 hub 解锁密码告诉你，但你应提醒他们这样做并不安全。你也可以提供命令，让他们手动运行（但这需要更多技术知识，且根据界面情况并非总是可行）。