从原版 Bob（Kyokan）迁移至 Bob LearnHNS

分清各个 Bob（并非第三种钱包）

• 原版 Bob——Kyokan / bob-wallet 系列。早期构建约为 2021 年的 0.6.x。最后一个已停止更新的官方构建是 2.1.0（2024）。它属于同一应用系列，只是版本较新，仍使用旧 SPV 辅助服务。
• Bob LearnHNS——持续维护的分支（shadstoneofficial），目前为 2.3.x。具有独立应用名称和独立数据文件夹。这是升级目标。

如果您使用原版 Bob 2.1.0，您用的并非第三种钱包，而是原版 Bob 的最后版本。请并行安装 LearnHNS，退出 2.1.0，然后导入助记词。

Bob LearnHNS 2.3.12 及更早版本首次运行时，可能显示含 macOS 复制命令的“Already use original Bob?”提示框。该提示框已过时。请忽略它，改用 Import a wallet（导入钱包）。下一版本正在移除此提示。

推荐：使用助记词恢复

Handshake 域名和 HNS 存在于区块链上。助记词足以让 Bob LearnHNS 在扫描后重建钱包。您无需先找到旧收款地址。

1. 从 bobwallet.org/download/bob-learnhns 获取安装程序。
2. 完全退出原版 Bob（不能只关闭窗口，请检查菜单栏／系统托盘）。
3. 打开 Bob LearnHNS。
4. 首次运行时，选择 Import a wallet（导入钱包），然后选择 Import Your Seed Phrase（导入助记词）。如果您已看到登录界面，请使用 Restore with your seed phrase（使用助记词恢复）。
5. 设置新的应用密码（它仅加密本地 LearnHNS 副本；除非您重复使用旧密码，否则与旧 Kyokan 密码不同）。
6. 手动输入助记词，然后恢复。不要从聊天或云端笔记粘贴。如果询问首次使用钱包的时间，请选择 2021 年或之前的年份，不要猜测区块高度。
7. 等待同步完成。随着后台扫描继续，域名、HNS 和旧出价可能会陆续出现。
8. 确认 Settings → Network & Connection → SPV Helper API 为 https://spv.learnhns.com/hsd。

即使 LearnHNS 已正常运行，也请保留原版 Bob 应用及其数据文件夹作为备份。不要为了“清理”而删除它们。

新安装的 LearnHNS 会从 0% 开始 SPV 同步。该进度条表示轻量区块头同步及辅助服务处理，并不是全节点下载整条链。首次运行仍需一些时间，但仍远快于全节点。导入助记词后还需再等待钱包恢复／扫描，期间域名和旧出价可能陆续出现。请保持应用打开，直到它显示已同步。不要为了“加快速度”切换到全节点。

为何不支持复制旧数据文件夹

复制文件夹原本是同一台电脑上的捷径，并非真正的升级。LearnHNS 使用与原版 Kyokan Bob 不同的应用文件夹。复制旧文件夹也会带入过时的 SPV／节点状态（错误的辅助服务、旧链文件、旧设置）。用户随后会遇到域名详情空白、端口冲突，或看似迁移成功却仍有问题的 LearnHNS 配置。终端和 PowerShell 步骤在 macOS、Windows 和 Linux 上也经常失败。

助记词是钱包的核心，HNS 和域名存在于链上。LearnHNS 导入适用于新电脑、重装操作系统后及旧文件夹丢失等情况。在验证恢复的钱包之前，请将旧 Bob 应用和文件夹保留为备份，但不要在升级过程中复制、重命名、合并或删除这些文件夹。

输入助记词比复制文件夹风险更高吗？

重新输入助记词确实存在风险：键盘记录器、剪贴板管理器、截图及旁观窥视。复制已加密的 Bob 数据文件夹不会在屏幕上显示助记词。这一点质疑是合理的。

Bob LearnHNS 支持通过应用内导入流程恢复，而非复制应用数据文件夹。只在官方 Bob LearnHNS 内输入助记词：手动输入，不要从云端笔记或聊天粘贴，不要截图，也绝不能将助记词发送给支持人员或 Telegram。被入侵的电脑仍可能窃取助记词，因此恢复前请核验安装程序和电脑。

xpriv 或主密钥文件呢？

xpriv 与助记词属于同等级的秘密信息（HD 主密钥）。粘贴或保存 xpriv 并不比输入助记词更安全。LearnHNS 可导入助记词、xpriv 或加密的主密钥 JSON。原版 Bob 2.1.0 的常规设置不提供这些文件的导出。Settings → Reveal seed phrase 会在输入密码后在屏幕上显示助记词。Settings → View Account Key 是 xpub（只读），并非 xpriv。加密的主密钥 JSON 下载仅存在于少见的“seed phrase mismatch”备份流程，不是标准的 2.1.0 导出功能。Settings → Backup WalletDB 复制的是钱包数据库文件，并非 LearnHNS 的“导入主密钥文件”格式。

助记词恢复会带回什么、不会带回什么

扫描后从链上恢复：该助记词对应的 HNS、拥有的域名、出价及交易历史。

不在链上、因此不会由助记词恢复的内容：本地设置、关注列表，以及 Shakedex 上架文件或凭证。有活跃上架的卖家应保留下载的市场备份，并保持旧 Bob 安装及数据不变，直到每条上架都已在 Bob LearnHNS 中验证。不要用复制应用文件夹代替市场备份。更换安装前，请阅读 Shakedex 安全与备份指南。

进入 LearnHNS 之后

日常请使用 Bob LearnHNS。原版 Kyokan Bob 2.1.0 / 0.6.x 无法指向当前的 SPV 辅助服务，因此其中的域名详情会一直为空。不要同时运行两个应用。

如果 LearnHNS 无法启动，请参阅 SPV 辅助服务设置指南；关于无需旧地址的助记词恢复，请参阅常见问题。