# cross-sign 一次性工具 给 bot 设备做 **cross-signing(交叉签名)**,让它在 Element 设备列表里显示为 「已验证」(绿盾),并触发你的其它设备自动向 bot 分享房间密钥(从而能解部分旧消息)。 ## 为什么需要它 bot 主程序用的是 `matrix-bot-sdk`,其底层加密内核 (`@matrix-org/matrix-sdk-crypto-nodejs@0.4.0`)**不支持设备验证 / cross-signing**, 所以你在 Element 里点「验证」会一直卡在「等待对方接受」。 本工具改用官方 **`matrix-js-sdk`**(支持完整验证)临时登录一次,从你的 Secret Storage(4S)取出 cross-signing 私钥,直接给目标设备签名 —— 等价于 Element 里 SAS 对暗号成功后的那一步。签完立即登出并删除这个临时设备。 **bot 运行时完全不受影响。** ## 前提 你的 Matrix 账号必须**已设置过 cross-signing + 安全密钥(Security Key)或安全短语** (Element → 设置 → 安全与隐私 → 加密)。 ## 用法 ```bash cd scripts/cross-sign npm install # 首次需要 node ./cross-sign.mjs ``` 然后按提示**交互式粘贴**即可(无需任何环境变量 / 配置文件): 1. 输入账号域名或 API 地址 2. 输入完整的 Matrix 用户 ID,例如 `@bot:example.org` 3. 账号密码 —— **粘贴时不回显** 4. 安全密钥(base58,如 `EsTc ...`)—— 不回显;直接回车则改填安全短语 5. 输入要签名的设备 ID。留空后还需输入 `ALL` 才会签名所有未验证设备。 跑一次即可,之后无需再跑(除非 bot 重新登录产生了新设备)。 ## 注意 - 密码、恢复密钥/短语只在本机脚本内使用,不会上传任何第三方;输入时不回显。 - 过程中会**短暂**出现一个名为 `cross-sign-temp (可删)` 的临时设备,脚本结束会自动删除。