浏览器要求
KaleidoSwap 扩展基于 Manifest V3 构建。首个封闭测试版以 Chromium 兼容的 zip 压缩包形式分发，需通过开发者模式安装。安装
封闭测试 zip 包（开发者模式）
KaleidoSwap 扩展的首个版本是仅限邀请的封闭测试。目前还没有浏览器商店上架，扩展源码仓库也尚未公开。受邀测试者会从 KaleidoSwap 团队收到一个专属下载链接，形如https://kaleidoswap.com/dl?t=...。该链接始终提供最新的测试构建，请保留这封邮件——每次更新都用同一个链接。
1
下载测试版 zip 包
打开测试邀请中的下载链接，它会以 zip 压缩包形式提供当前构建。
2
校验下载的文件
同一个链接上还提供了公布的校验和以及维护者的分离签名：将其与你下载的压缩包对比：如果还要校验签名，使用
&file=asc 获取签名文件，并用 KaleidoSwap 发布签名密钥（696F19C9DA0ADBE8B38E5346E007BFF05941433B）验证：3
解压压缩包
把压缩包解压到本机一个固定的文件夹中。扩展安装期间请不要移动这个文件夹，因为浏览器会从该文件夹加载扩展。
4
打开扩展管理页面
在 Chromium 系浏览器中访问
chrome://extensions。5
启用开发者模式
打开右上角的开发者模式（Developer mode）开关。
6
加载已解压的扩展
点击加载已解压的扩展程序（Load unpacked），选择包含
manifest.json 的解压文件夹。7
固定扩展图标
把 KaleidoSwap 图标固定到工具栏，方便随时打开。
暂不可用的渠道
封闭测试者只应安装自己专属下载链接提供的 zip 包。扩展仓库公开后，我们会补充源码构建说明。
首次启动
安装完成后，点击工具栏中的 KaleidoSwap 图标，钱包会在浏览器侧边栏（side panel）中打开（在不支持侧边栏 API 的浏览器上，会退回到工具栏弹出窗口）。首次启动时，扩展会引导你完成初始设置流程：
- 欢迎界面 - 「创建新钱包」(Create New Wallet) 或「导入已有钱包」(Import Existing Wallet)（12 词或 24 词助记词）。导入时选择钱包持有真实比特币（主网，Mainnet）还是测试钱包（测试网络，Test networks：Signet、regtest、Liquid Testnet）
- 设置密码 - 创建一个密码，用于在本设备上加密钱包
- 助记词（仅新钱包） - 保存控制 Spark、Arkade、Liquid、RGB 以及派生 Nostr 身份的 12 个词
- Passkey（可选） - 使用生物识别或安全密钥解锁
- Nostr 身份（仅新钱包） - 保留派生的身份，或导入已有密钥
- RGB 设置 - 「使用此设备」（推荐），或连接你自己的 RGB Lightning Node
- 测试版提示 - 确认测试版风险提示后进入仪表盘
权限
KaleidoSwap 扩展会申请以下 Chrome 扩展权限：
manifest 中还为钱包实际访问的接口端点声明了
host_permissions：KaleidoSwap 服务、区块浏览器与索引器、RGB proxy、Spark/Flashnet、Arkade 以及价格 API。
manifest 还列出了可选的主机权限。只有当你把钱包指向自己的接口端点（例如 LND 节点、Esplora 索引器或 VSS 服务器）时，钱包才会请求相应访问权限。
KaleidoSwap 扩展把加密后的助记词存储在
chrome.storage.local 中。只有你主动连接的账户和服务才会产生网络请求。如果开启了 Chrome 同步，Chrome 可能会把加密的种子、密码哈希和盐值复制到 Google 的服务器；你可以在 chrome://settings/syncSetup/advanced 中关闭扩展同步。更新
封闭测试构建不会通过浏览器商店自动更新。有新测试版时，重新打开你的下载链接——它始终提供当前构建——解压后回到chrome://extensions，在 KaleidoSwap 扩展卡片上点击重新加载（Reload）。如果你把新构建解压到了另一个文件夹，请改为用加载已解压的扩展程序（Load unpacked）指向新文件夹。不要先移除旧扩展：移除会删除浏览器中保存的钱包数据，之后只能用助记词恢复。
由于测试构建使用固定的扩展 ID（mmldlmkphefjjbpbajnhnkbiahiabiog），你的账户、余额和设置会在更新后保留。无论如何，请把助记词放在手边。
卸载
要移除 KaleidoSwap 扩展，请按照浏览器提供的说明操作。申请测试版访问权限
申请加入 KaleidoSwap 扩展的封闭测试。