面向新手的输出描述符、脚本、密钥、派生路径、校验和、只读钱包与恢复规划指南。
引言
比特币钱包并不只是助记词和一组地址。为了正确重建一个钱包，软件还可能需要知道钱包使用哪一种脚本类型、密钥通过什么路径派生、哪些路径属于收款地址与找零地址，以及多个公钥是否必须共同参与签名。
这正是比特币钱包描述符（Bitcoin Wallet Descriptor），也称为输出描述符（Output Descriptor），要解决的问题。描述符是一种结构化指令，用来告诉兼容的钱包软件：密钥和脚本如何对应到钱包控制的地址与可花费输出。
描述符特别适合用于只读钱包、硬件钱包协作、多重签名恢复、钱包迁移以及长期备份规划。它不是私钥，也不包含钱包余额；它保存的是钱包的花费策略和地址生成逻辑，让软件能够理解并重建这些规则。
在此前的 XTS Insights 文章《什么是比特币多重签名？》中，我们说明了为什么多重签名钱包通常不应只备份一份助记词。描述符可以帮助记录多重签名策略、公钥以及派生信息，让兼容的钱包在恢复时重新找到相关资金。
本指南将介绍描述符是什么、其中包含哪些信息、它与助记词和 xpub 有什么区别，以及如何在存入大量资金前建立并测试一套可恢复的钱包方案。
简单回答：什么是比特币钱包描述符？
比特币钱包描述符是一种机器可读的规则说明，用于描述钱包如何创建和识别比特币输出脚本、公钥、派生路径与地址。它更像是一张钱包策略蓝图，而不是可以直接授权花费的秘密。
描述符可以描述单密钥钱包、多重签名策略、Taproot 构造或其他受支持的脚本类型。它可能包含密钥来源信息、扩展公钥、派生路径、地址索引通配符，以及用于发现复制错误的校验和。
描述符本身通常不能花费比特币。真正签名仍然需要对应的私钥或签名设备。不过，描述符可以帮助只读钱包生成地址、追踪资金、识别找零输出，并重建恢复时所需要的钱包策略。
为什么只备份密钥可能不够？
助记词非常重要，因为它可以重新生成确定性密钥材料。但助记词并不一定能告诉恢复软件如何完整找回某个钱包的全部资金。
同一个助记词可以配合不同的脚本类型、账户分支、地址格式或派生路径使用。如果原钱包使用原生 SegWit 地址，而恢复软件只搜索传统路径，恢复结果可能不完整。如果钱包是多重签名结构，恢复还需要多个扩展公钥以及单个助记词无法表达的签名门槛。
因此，恢复过程可能还需要以下信息：
输出脚本类型，例如 `wpkh`、`wsh` 或 `tr`。
派生路径和密钥来源信息。
收款分支与找零分支的路径。
组成共享策略的公钥或 xpub。
多重签名的门槛以及适用的公钥排序规则。
用于查找历史交易的创建时间、扫描范围或重新扫描信息。
这并不意味着助记词不重要，而是说明完整的备份计划应同时保存秘密密钥材料，以及告诉软件如何使用这些密钥的钱包策略。
什么是输出描述符？
输出描述符是一种简洁的语言，用于描述一组比特币输出脚本。它通过类似函数的表达式，表示钱包如何把密钥转换为脚本和地址。
例如，`wpkh(…)` 表示原生 SegWit 的公钥哈希输出；`wsh(…)` 表示见证脚本哈希输出，常用于基于脚本的多重签名；`tr(…)` 表示 Taproot 输出。具体支持哪些表达式，取决于钱包软件及其实现的描述符版本。
因此，描述符更像一份钱包配方，而不是一个单独的账户号码。它说明钱包应该追踪哪些地址，以及未来交易需要满足哪些花费条件。
描述符可以包含哪些信息？
脚本或输出类型
最外层的表达式告诉钱包要创建哪一种输出脚本。常见例子包括 `pkh`、`wpkh`、`sh`、`wsh`、`tr`、`multi` 和 `sortedmulti`。
脚本类型会影响地址格式、交易大小、手续费、隐私特征、硬件钱包支持以及恢复方式。即使使用相同的密钥材料，两个钱包也可能因为输出表达式不同而生成不同地址。
密钥表达式
密钥表达式可以包含公钥、扩展公钥（例如 xpub），或者在严格保密的情况下包含扩展私钥。用于监控的钱包通常应只保存公开信息。
密钥表达式还可能包含来源指纹和派生路径。这些信息可以帮助软件理解某个密钥从哪里来，以及如何继续派生相关的子密钥。
派生路径与通配符
钱包通常会从一棵密钥树派生大量地址。路径可以标记账户、找零分支以及地址索引。像 `/*` 这样的通配符通常表示“继续派生后续索引”。
某些描述符格式还支持 `<0;1>` 这样的多路径写法，用于表示外部收款分支和内部找零分支。不要假设所有钱包都以完全相同的方式解释路径；导入或恢复前，应先确认钱包的文档。
校验和
许多描述符会在 `#` 字符后附带校验和。校验和不是加密，也不能证明描述符来自可信来源；它主要用于在导入前发现抄写或复制错误。
钱包提供描述符时，应尽量复制包含校验和的完整字符串。如果工具重新计算了校验和，也应将结果与可信原文进行比对，不要在没有确认的情况下默默接受变化后的字符串。
如何阅读一个简单的描述符示例？
下面是一个仅供说明的单密钥示例：
`wpkh([abcd1234/84h/0h/0h]xpub…/0/*)#checksum`
这不是真实的钱包备份，也不能直接导入。它只是展示描述符可能包含的部分：
`wpkh` 表示原生 SegWit 公钥哈希输出。
`[abcd1234/84h/0h/0h]` 展示示例来源信息与派生路径。
`xpub…` 代表扩展公钥，省略号只是占位符。
`/0/*` 表示外部收款分支以及不断变化的地址索引。
`#checksum` 代表描述符校验和。
一个概念性的 2-of-3 基于脚本的多重签名描述符可以写成：
`wsh(sortedmulti(2,[origin-A]xpub-A/0/*,[origin-B]xpub-B/0/*,[origin-C]xpub-C/0/*))#checksum`
其中，`wsh` 表示脚本包装方式，`sortedmulti(2,…)` 表示三把公钥中需要两把签名，三个 xpub 表达式提供每个地址索引所需的子公钥。实际语法、公钥排序以及路径分支，都必须以创建该策略的钱包导出结果为准。
描述符如何帮助钱包工作？
生成收款地址
钱包可以根据描述符派生下一个符合策略的收款地址。只读钱包也能完成这项工作，不需要持有私钥。
追踪找零地址
比特币钱包通常会使用内部找零地址，把未花费的剩余金额返回给付款方。如果恢复过程只搜索外部收款地址，就可能漏掉资金。完整的描述符和路径计划可以帮助钱包同时搜索两条分支。
识别可花费输出
当交易向钱包描述的脚本支付时，钱包可以把该输出识别为自己的交易历史。这有助于计算余额并创建未来交易。
协调签名者
在多重签名安排中，描述符记录共享的公钥策略，而每位签名者分别保管自己的私钥。兼容软件可以使用同一策略生成一致地址，并交换 PSBT（部分签名比特币交易）。
支持钱包恢复
如果原钱包应用丢失，描述符可以把地址和脚本逻辑交给新的兼容软件，帮助其重新发现地址与输出。恢复仍然需要兼容软件、所需私钥，以及查找历史交易所需要的扫描或重新扫描信息。
描述符、助记词、xpub、地址和钱包文件有什么区别？
描述符与助记词
助记词是用于恢复确定性秘密密钥材料的人类可读备份。描述符则描述钱包如何使用密钥和脚本。助记词可以恢复密钥，但不一定保存某个钱包使用的完整策略或精确路径。
描述符与 xpub
xpub 是可以派生公开子密钥的扩展公钥。它不能授权花费，但可能暴露钱包的大量交易历史，因此属于需要谨慎保护的隐私信息。描述符可以把一个或多个 xpub 与脚本和路径规则结合起来。
描述符与地址
地址是一次收款的目的地。描述符则可以生成一系列地址，并说明这些地址如何对应到脚本、密钥和找零分支。
描述符与钱包文件
钱包文件可能同时保存描述符、加密私钥、标签、交易历史和应用设置。导出一个描述符并不一定等于导出了完整钱包。若钱包依赖这些信息，应分别保管钱包文件、描述符与签名备份。
只读钱包与描述符
只读钱包（Watch-only Wallet）保存公开信息，用来生成地址和监控余额，但不持有签名所需的私钥。
描述符非常适合只读场景，因为它可以说明钱包应该监控哪些脚本和公钥。组织可以使用只读协调钱包创建未签名交易，同时把签名设备放在离线或不同地点。
只读并不代表没有风险。取得 xpub 或描述符的人，可能能够推断交易历史或未来地址之间的关系，具体取决于钱包设计。公开钱包数据前，应确认接收方确实需要这种可见性。
描述符与多重签名恢复
多重签名更明显地说明了完整钱包文档的重要性。单个签名者的助记词可能只能恢复一把私钥，却不会自动告诉新软件其他哪些密钥属于该策略、需要几把签名、使用何种脚本类型，或地址路径如何派生。
一份可恢复的多重签名记录通常应保存：
包含校验和的完整描述符。
M-of-N 签名门槛和计划中的签名者列表。
每位签名者的来源信息和派生路径。
策略使用的公钥或 xpub。
每把私钥或硬件签名设备的位置与状态。
创建钱包时使用的软件和描述符格式。
需要扫描的外部收款分支与内部找零分支。
原钱包消失后，如何创建、签名、广播并验证恢复交易的测试流程。
基于脚本的多重签名描述符，不应与密钥聚合协议混为一谈。例如，MuSig2 是一种交互式 n-of-n Schnorr 签名方案，并不等同于基于脚本的 2-of-3 策略。两种方案的恢复记录、签名要求和软件支持都可能不同。
为什么描述符校验和很重要？
钱包描述符可能很长，手动输入容易出错。少一个字符、替换一把公钥或修改一个派生路径，都可能让钱包生成完全不同的地址，或无法识别原有资金。
校验和可以帮助软件发现许多意外变化。它不会自动修复描述符，也不能找回缺失字符，更不能防止恶意替换。校验和只是安全检查的一部分，不能取代可信备份和独立核对。
在给恢复后的钱包充值前：
将描述符与可信来源逐字比对。
确认校验和有效。
在两台独立设备或软件界面上生成收款地址。
对比前几个收款地址和找零路径。
先发送少量测试金额，并完成一次测试恢复。
建立可恢复的钱包描述符流程
可以把下面的流程作为规划清单。具体导出和导入命令，必须以实际钱包文档为准。
确认钱包策略、脚本类型和地址格式。
从钱包导出包含校验和的完整描述符。
记录密钥来源、派生路径、外部与内部分支，以及创建描述符的钱包版本。
将每位签名者的私钥或助记词，与公开描述符分开备份。
在干净的只读环境中导入描述符，并对比生成的地址。
使用正确的扫描或重新扫描设置，确认历史交易与找零输出能够被发现。
使用真实设备或 PSBT 流程，以少量资金测试签名过程。
记录原钱包消失后如何恢复、签名、广播和验证交易。
在多个安全地点保存加密或物理保护的备份副本。
当设备、钱包软件、签名者或安全假设发生变化时，重新审核这套方案。
目标不是收集一串字符后就遗忘它，而是证明这份策略确实能生成同样的地址，并完成一次可控恢复。
常见的描述符错误
只保存助记词
助记词可能恢复密钥，却无法告诉软件脚本类型、路径或多重签名参与者。请把描述符和策略信息与私钥备份一起妥善保存。
丢失来源信息或派生路径
没有来源和路径的 xpub，可能无法告诉恢复软件如何重建原钱包账户。应记录钱包导出的完整表达式。
混淆收款分支与找零分支
只扫描外部地址可能得到不完整的余额。请确认钱包使用了哪些分支，以及描述符如何表达这些分支。
把 xpub 当成私钥
xpub 通常不能花费资金，但可能暴露交易历史。应把它视为需要保护的公开信息，不能把它当成私钥备份的替代品。
未核对多重签名公钥顺序
有些描述符使用 `multi`，另一些使用 `sortedmulti`。公钥顺序和排序规则可能改变最终脚本。应使用钱包导出的准确描述符。
复制描述符时省略校验和
字符串看起来仍然可读，但导入工具会失去重要的错误检测信号。只要钱包提供，就应保存完整字符串。
从未测试恢复
没有进行过恢复测试的备份，只是一种假设。应在钱包持有大量余额前，先测试只读导入、地址核对以及受控签名流程。
哪些场景特别适合使用描述符？
描述符尤其适用于：
硬件钱包与桌面钱包协作。
企业或团队的只读资金监控。
多重签名与协作托管。
在兼容钱包之间迁移。
审核钱包的地址生成策略。
把在线监控和离线签名分离。
为长期冷存储记录恢复方案。
如果只把描述符当作一串神秘字符，却不了解钱包实现、脚本类型、密钥位置和恢复步骤，它的价值就会大幅降低。文档和测试本身也是备份的一部分。
XTS 如何看待比特币钱包描述符？
在 XTS 看来，钱包描述符是比特币简单用户体验与精确技术规则之间的重要桥梁。
描述符让钱包策略变得可见：使用什么脚本、哪些密钥参与、地址如何派生，以及兼容钱包应如何识别输出。这种清晰度能够减少恢复时的意外，也让只读监控、多重签名协作和硬件钱包流程更容易审计。
描述符并不能替代安全纪律。私钥仍需要严格保护，公开钱包数据仍需要隐私控制，每一套恢复方案都应该在投入重要资金前完成测试。最好的备份是一套完整、记录清晰并且可以验证的流程。
常见问题（FAQ）
用简单的话说，什么是比特币钱包描述符？
比特币钱包描述符是一份配方，告诉钱包软件如何创建和识别钱包的脚本、密钥、派生路径与地址。
描述符包含私钥吗？
不一定。只读描述符通常只包含公钥或 xpub。某些软件可以从私钥材料生成描述符，但秘密信息不应出现在公开或只读备份中。
描述符可以恢复我的钱包吗？
它可以帮助兼容软件重建钱包的地址和脚本逻辑，但描述符本身通常不能花费资金。完整恢复还可能需要私钥、硬件设备、兼容软件以及用于查找历史输出的扫描设置。
描述符和助记词有什么区别？
助记词用于恢复确定性秘密密钥材料，描述符用于描述密钥和脚本如何被使用。一套可靠的恢复方案可能需要两者。
描述符可以创建只读钱包吗？
可以。基于公钥的描述符可以让兼容软件生成地址和监控资金，同时不持有签名私钥。
描述符中的 `/*` 是什么意思？
它通常代表派生通配符，允许软件继续生成一系列子地址。具体分支和范围规则取决于描述符和钱包实现。
什么是描述符校验和？
校验和是描述符末尾的一段验证信息，用于帮助发现意外改动。它不是加密，也不能证明描述符来源可信。
为什么多重签名需要描述符？
多重签名需要共享记录签名门槛、公钥、脚本类型、密钥来源和派生路径。描述符可以保存这套共享策略，同时让每位签名者分别保管私钥。
xpub 可以安全分享吗？
xpub 通常不能花费资金，但可能暴露地址和交易历史。应把它视为隐私敏感信息，只分享给确实需要监控钱包的人或系统。
描述符能恢复所有比特币钱包吗？
不能。恢复取决于钱包的描述符格式、脚本支持、完整密钥、路径信息，以及查找历史输出所需的元数据。务必根据钱包文档和少量测试资金进行验证。
总结
比特币钱包描述符是一份结构化蓝图，说明密钥、脚本、派生路径与地址之间的关系。它帮助兼容软件理解钱包应该监控什么，以及未来交易需要满足哪些条件。
当钱包使用多重签名、硬件签名设备、只读监控或长期冷存储时，描述符尤其有价值。它可以保存助记词无法完整表达的钱包策略，而校验和则有助于发现复制过程中的意外错误。
最安全的做法，是把描述符视为一套经过测试的恢复系统中的一部分：保存包含校验和的完整描述符，分别保护私钥，记录钱包与路径格式，核对收款和找零地址，并在钱包持有大量资金前演练一次受控恢复。
重点整理
钱包描述符说明比特币脚本、密钥、路径和地址如何组合。
描述符不是私钥、钱包余额或加密方法。
助记词恢复密钥材料，描述符保存钱包策略和地址生成逻辑。
基于 xpub 的描述符可以支持只读监控，但没有签名权限。
多重签名恢复通常需要完整描述符、所有签名者信息以及经过测试的软件。
`/*` 通常表示派生通配符，但具体路径规则因钱包而异。
校验和有助于发现复制错误，但不能证明描述符真实可信。
在存入大量资金前，应先测试恢复和地址派生。
发表回复