链上学院 · 文档索引与排查问答
先查章节号，
再读排查问答
这里是 IM钱包 面向中文读者的知识区。钱包华人开发者文档按导入路径编好号，日常问得最多的问题摊开逐条写清，正文里的每个结论都能对回合集中的一个案例。
编号一经发布即固定：修订不改旧号，新增内容顺延到路径末尾。
文档阅读提示
编号规则
助记词走 04.x，私钥走 05.x，Keystore 走 06.x，硬件设备走 07.x，观察模式走 08.x。版本差异单独放在 02.x。
阅读顺序
先在下方的章节索引里定位路径，再读对应的核对步骤，最后按标注的案例编号回到合集看完整复现过程。
只想查一件事
01 / 文档索引
五条导入路径的章节入口
文档把导入拆成五条互不交叉的路径，每条路径的章节号连续编号。下表给出起止章节、覆盖内容与对应的案例区间，可以从一个具体问题直接跳到章节，不必从头翻。
| 导入路径 | 章节号 | 章节覆盖 | 对应案例 |
|---|---|---|---|
| 助记词 | 04.1 – 04.6 | 词表语言与词数校验、恢复后的账户派生顺序、常见词序错误 | #01 – #28 |
| 私钥 | 05.1 – 05.5 | 单地址导入、私钥与账户序号的对应关系、导入后的地址比对 | #29 – #46 |
| Keystore | 06.1 – 06.4 | 文件结构与格式识别、密码输入、跨设备读取失败的返回信息 | #47 – #63 |
| 硬件设备 | 07.1 – 07.5 | 连接方式、账户同步范围、签名确认留在设备侧的执行说明 | #64 – #79 |
| 观察模式 | 08.1 – 08.3 | 只读地址录入、无法签名的功能边界、与正式导入的区别 | #80 – #92 |
文档全文共 320 节、260 段可运行示例，上表只列出与导入相关的部分。
02 / 备份
助记词备份的六步动作
备份的目标只有一个：在设备损坏时能凭自己手里的东西把账户恢复出来。整个过程不需要联网，也不需要任何第三方参与。
-
在出现的当下抄完
助记词只在初始化或恢复的本地界面完整显示一次，抄写就在那一刻完成，不要打算之后再回来找。
-
用离线介质承载
纸张或金属铭牌都可以。不拍照、不截图、不写进云笔记，也不通过聊天工具发送给自己。
-
多份分散存放
至少留 3 份，分散在两个以上物理地点，避免一次意外同时带走全部备份。
-
抄完立刻回读复核
按原始顺序回读一遍，确认词序与词数一致。核对时留意拼写相近的词，逐词确认，不凭记忆跳读。
-
先用观察模式验证
在另一台设备上用观察模式录入地址，确认指向的账户一致，再考虑真正导入。验证阶段不涉及任何签名。
-
定期检查介质状态
隔一段时间检查字迹是否褪色、金属件是否锈蚀、纸张是否受潮，发现不可读就尽早重抄一份。
IM钱包不会通过任何渠道索要助记词、私钥或 Keystore 文件。凡主动索要这些内容的行为，都与本站无关。
03 / 地址核对
收款地址核对的六个步骤
顺序固定：先确认链路与账户，再比对字符串，最后用一次小额收付验证。两个版本在这套顺序的第三步和第五步上给出的信息不同，点击步骤序号可以单步高亮。
-
01
确认链路与账户序号
展开目标链的账户详情，核对网络名称和该地址所属的账户序号。同一条链下的不同账户会给出不同地址，只看地址字符串容易漏掉这一层。
-
02
比对字符串首尾
复制后先粘贴到本地文本，比对前 6 位与后 6 位，再按 4 位一组扫过中段。只对首尾是地址核对里最常见的漏检方式。
-
03
确认复制带出的上下文
这一步两个版本的输出不同，粘贴前先看清复制结果里包含什么。
版本差异2019 单页中文说明只输出地址字符串；2021 多链资产视图会同时带出网络名称与账户序号，便于粘贴时一并确认。
-
04
先用小额收付验证
首次向该地址收款前，先由自己转出一笔小额资产，确认到账后再把它用于正式收款。这一步验证的是地址本身，而不是网络速度。
-
05
对照二维码与字符串
扫码得到的地址必须与字符串逐位一致，两者不一致时以手动核对的结果为准。
版本差异2021 版在收款页同时给出二维码与字符串两条通道；2019 版只提供字符串，需要手动分段检查。
-
06
长期地址留一份离线记录
长期或大额使用的收款地址，单独抄一份离线记录，隔一段时间与钱包内的显示结果复核一次，避免界面层级变化后认错账户。
bc1q …… 6f2d
分段比对的具体写法见文档 05.3，对应案例 #34、#58 与 #71。
04 / 排查问答
八个高频问题的排查方向
每条问答先给结论，再给可以立刻验证的动作。涉及签名与私钥的环节都由你在本机完成，这里不会给出代替操作的建议。
导入之后地址和以前不一样，是哪一步出了问题？
先确认导入走的是哪条路径。同一组助记词配合不同的派生顺序会得到不同地址；私钥导入只对应单个地址，不会带出后续账户。按导入方式回到对应章节重新核对一遍。
文档 04.1 · 05.1 · 案例 #03、#31
恢复时提示助记词词数不对怎么办？
先数字数。常见长度为 12、15、18、21、24 个词，少一个或多一个都会失败。再检查是否有两个词被抄在同一行，或者把序号当成了词。逐词比对词表是唯一可靠的确认方式。
文档 04.3 · 案例 #07、#15
Keystore 文件加密码之后导入失败？
先确认密码大小写与输入法状态，再确认文件有没有被文本编辑器改写过。Keystore 是 JSON 结构，多一个换行符或少一个括号都可能导致解析失败。把文件原样复制一份再试。
文档 06.2 · 案例 #49、#52
观察模式为什么不能转账？
观察模式只录入公开地址，设备里没有对应的私钥，所以只能查看，不能签名。这是功能边界，不是权限设置问题。要发起转账必须改走助记词、私钥或硬件设备路径重新导入。
文档 08.2 · 案例 #81、#88
切到某条网络之后资产是空的？
先看账户序号是否跟着切换。多链视图下每条链会独立列出账户，切换网络不会自动切换账户。再看这条链是否在覆盖范围内——目前共支持 34 条公链与 9 条 Layer2 网络。
文档 05.4 · 案例 #36
硬件设备连上了，但看不到账户？
检查设备侧的账户同步范围。部分设备默认只同步前几个账户，后续账户需要在设备上手动开启显示，再回到钱包刷新一次。签名确认始终在设备侧完成。
文档 07.3 · 案例 #68、#74
地址首尾一样，中间几位却不一致？
这是只比对首尾造成的典型漏检。正确做法是按 4 位一组分段扫描，或者把两个字符串放进本地文本用查找功能比对。中段才是差异最常出现的位置。
文档 05.3 · 案例 #34、#58
导入成功，余额却和浏览器显示的不一样？
钱包展示的是当前账户在所选网络下的资产。差异通常来自三处：网络选错、账户序号不对、代币尚未手动添加。按这个顺序逐个排除即可。
文档 04.4 · 05.5 · 案例 #41
05 / 互引
章节与案例的双向索引
每个文档章节末尾列出相关案例编号，每篇案例开头标注所属章节号。下面几组是查阅频率最高的对应关系，按主题排列。
合集的完整条目按周更新，可以在更新记录里按路径筛选查看。
接着往下看
想按路径逐条对照导入过程，去看案例合集；想确认本地加密与日志留存的边界，去看隐私政策。