Files

cross-sign 一次性工具

给 bot 设备做 cross-signing(交叉签名),让它在 Element 设备列表里显示为 「已验证」(绿盾),并触发你的其它设备自动向 bot 分享房间密钥(从而能解部分旧消息)。

为什么需要它

bot 主程序用的是 matrix-bot-sdk,其底层加密内核 (@matrix-org/[email protected])不支持设备验证 / cross-signing, 所以你在 Element 里点「验证」会一直卡在「等待对方接受」。

本工具改用官方 matrix-js-sdk(支持完整验证)临时登录一次,从你的 Secret Storage(4S)取出 cross-signing 私钥,直接给目标设备签名 —— 等价于 Element 里 SAS 对暗号成功后的那一步。签完立即登出并删除这个临时设备。 bot 运行时完全不受影响。

前提

你的 Matrix 账号必须已设置过 cross-signing + 安全密钥(Security Key)或安全短语 (Element → 设置 → 安全与隐私 → 加密)。

用法

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 (可删) 的临时设备,脚本结束会自动删除。