Release room-scoped Matrix bot plugins and room configuration
This commit is contained in:
commit
86c7e4359c
76 files changed
+13539
No files matched your search
@@ -0,0 +1,43 @@
|
||||
# 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 → 设置 → 安全与隐私 → 加密)。
|
||||
|
||||
## 用法
|
||||
|
||||
```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 (可删)` 的临时设备,脚本结束会自动删除。
|
||||
Reference in new issue
Block a user