![](\"https://img.shields.io/badge/license-AIPL%201.1-yellow\"/){kind=icon}
](LICENSE.md)\r\n\r\n\r\n\r\n[![](\"https://img.shields.io/github/v/release/SheepChef/Abracadabra?color=00aaff\"/)
](https://github.com/SheepChef/Abracadabra/releases/latest)\r\n[![](\"https://img.shields.io/github/actions/workflow/status/SheepChef/Abracadabra/node.js.yml?branch=main&label=%E6%9E%84%E5%BB%BA\"/)
](https://github.com/SheepChef/Abracadabra/actions/workflows/node.js.yml)\r\n[![](\"https://img.shields.io/codecov/c/github/SheepChef/Abracadabra?label=%E8%A6%86%E7%9B%96%E7%8E%87\"/)
](https://github.com/SheepChef/Abracadabra/actions/workflows/coverage.yml)\r\n![\"Featured｜HelloGitHub\"](\"https://api.hellogithub.com/v1/widgets/recommend.svg?rid=6d67b7be3ccc43419924dbe40b31e937&claim_uid=cQrPYdpGNg4ACK6&theme=small\")
\r\n\r\n\r\n![](\"https://img.shields.io/badge/立刻使用-ffd91c?logo=cloudflarepages&style=for-the-badge&logoColor=000000\"){kind=icon}
](https://abra.js.org/)\r\n[![](\"https://img.shields.io/badge/下载插件-8a54ff?logo=googlechrome&style=for-the-badge&logoColor=ffffff\"){kind=icon}
](#浏览器插件)\r\n\r\n[![](\"https://img.shields.io/badge/项目主页-54ffac?logo=javascript&style=for-the-badge&logoColor=000000\"){kind=icon}
](https://abracadabra.js.org)\r\n[![](\"https://img.shields.io/badge/前端源码仓库-9a10b5?style=for-the-badge\"){kind=icon}
](https://github.com/SheepChef/Abracadabra_demo)\r\n[![](\"https://img.shields.io/badge/更新频道-0970ba?logo=telegram&style=for-the-badge&logoColor=ffffff\"){kind=icon}
](https://t.me/abracadabra_cn)\r\n\r\n![\"中国哲学书电子化计划\"](\"https://ctext.org/logos/ctplogo6.gif\")
![](\"https://img.shields.io/badge/静态页面-ffd91c?logo=cloudflarepages&style=for-the-badge&logoColor=000000\"){kind=icon}
](https://abra.js.org/)\r\n[![](\"https://img.shields.io/badge/前端源码-9a10b5?style=for-the-badge\"){kind=icon}
](https://github.com/SheepChef/Abracadabra_demo)\r\n\r\n### 浏览器插件\r\n\r\n浏览器插件基于本项目的 JavaScript 实现。\r\n\r\n已上架 **Chrome WebStore**, **Edge 加载项** 和 **Firefox 扩展**。\r\n\r\n如果不方便访问Chrome插件商店，也可以访问Edge插件商店，和Firefox扩展商店。\r\n\r\n[![](\"https://img.shields.io/badge/Chrome){kind=icon}
](https://chrome.google.com/webstore/detail/jgmlgdoefnmlealmfmhjhnoiejaifpko)\r\n[![](\"https://img.shields.io/badge/MSEdge){kind=icon}
](https://microsoftedge.microsoft.com/addons/detail/abracadabra-%E9%AD%94%E6%9B%B0/kfkmhdcahjblddpkkmnjeppmfmfoihkb)\r\n[![](\"https://img.shields.io/badge/Firefox){kind=icon}
](https://addons.mozilla.org/zh-CN/firefox/addon/abracadabra-%E9%AD%94%E6%9B%B0/)\r\n\r\n> **提示：Edge 插件商店的上架审核速度十分缓慢，因此更新速度也更慢。不推荐从Edge商店下载本插件。**\r\n\r\n### Android 客户端\r\n\r\n本项目的 Android 客户端完全在 WebView 中静态运行。 \r\n\r\nAPK 使用 Cordova 构建，**完全离线运行，不申请联网权限，没有自动更新等配套功能**。\r\n\r\n功能和界面均和前端静态网页没有差异。 \r\n\r\nAPK文件可以 [**在 Release 中下载**](https://github.com/SheepChef/Abracadabra/releases/latest)\r\n\r\n## 细节概要\r\n\r\n请查阅 [**项目主页**](https://abracadabra.js.org) 了解更多。\r\n\r\n[](https://deepwiki.com/SheepChef/Abracadabra)\r\n\r\n### 加解密过程\r\n\r\n```\r\n明文 -> 压缩 -> 加密/高级加密 -> Base64 -> 三重转轮 -> 映射汉字 -> 组句(仅仿真加密时) -> 密文\r\n\r\n密文 -> 解仿真(仅仿真加密) -> 转轮逆映射 -> Base64 -> 解密 -> 解压缩 -> 明文\r\n```\r\n\r\n### 映射表\r\n\r\nAbracadabra 以最常用的 3000 个汉字为密本，对大小写拉丁字母，阿拉伯数字和部分符号进行映射。\r\n\r\n密表为纯人工编纂，没有让人眼花缭乱的生僻字。\r\n\r\n映射表公开可查，查阅 [**映射表(传统)**](https://github.com/SheepChef/Abracadabra/blob/main/src/javascript/mapping.json) 或者 [**映射表(仿真)**](https://github.com/SheepChef/Abracadabra/blob/main/src/javascript/mapping_next.json) 以了解密本的全貌。\r\n\r\n### AES 加密\r\n\r\n核心安全性由久经考验的 AES 加密算法提供，采用无填充的AES-256-CTR，节省密文长度。\r\n\r\nAES 加密密钥和转轮密钥是同一个，均采用哈希值。\r\n\r\n### 高级加密套件\r\n\r\n魔曰提供高级密码学套件支持，使用者可藉此执行更高安全性的加密。\r\n\r\n除 AES-256-CTR 外，下列密码套件受支持：\r\n\r\n- **强IV** (初始化向量，16Bytes)\r\n- **HMAC-SHA256** (消息签名，32Bytes)\r\n- **PBKDF2** (密钥衍生算法，100000次哈希迭代，盐值长度 16Bytes)\r\n- **TOTP** (时效性密钥，作为 PBKDF2 之盐值，可自定义多个参数)\r\n\r\n启用高级加密套件将导致密文长度显著增加，所有组件均可独立开启和关闭。\r\n\r\n请查阅 [**项目主页**](https://abracadabra.js.org/document/enc.html#高级加密) 了解更多。\r\n\r\n### 三重转轮混淆\r\n\r\n模拟转轮密码机，每次加密均会对密本映射进行偏移。\r\n\r\n简言之，程序会将给定的密钥进行 SHA256，得到一个长度为 32 的 Uint8_t 数组。\r\n\r\n这个数组中的每个数字，都会决定三重转轮中每个转轮每次迭代的转动方向和转动距离。\r\n\r\n数字/符号，字母分别拥有一套转轮，即总共六个转轮，改变密钥相当于更换一套完全不同的转轮。\r\n\r\n转轮显著增加了 Base64 密文的安全性，查阅 [**项目主页**](https://abracadabra.js.org/document/enc.html#三重转轮混淆) 来了解转轮的详细运行机制。\r\n\r\n### 压缩\r\n\r\n为了削减密文的长度，每次加密前会对数据进行智能压缩。 \r\n\r\n针对短文本，采用专门为短文本优化的 Unishox2 压缩算法。 \r\n一般数据(>1KB)则采用GZIP。\r\n\r\n压缩后会执行效率验证，如果出现无效压缩，则自动回落到原始数据。\r\n\r\n\r\n\r\n---\r\n\r\n> 原创逆向研究，特别支持解密熊曰(与熊论道)密文。\r\n>\r\n> 详情请见 [**使用提示**](https://abracadabra.js.org/document/demo-usage#熊曰解密-与熊论道) 和 [**Issue #123**](https://github.com/SheepChef/Abracadabra/issues/123)\r\n>\r\n> 有关本项目中内置的熊曰解密函数，请见 [**JavaScript 部署**](https://abracadabra.js.org/document/js-deploy#beardecode-熊曰解密函数) 。\r\n\r\n## 鸣谢\r\n\r\n感谢 [**Unishox2**](https://github.com/siara-cc/Unishox2) 提供高效的短文本压缩方案。\r\n\r\n感谢 [**中国哲学书电子化计划**](http://ctext.org/zhs) 提供高质量的古籍参考资料。\r\n\r\n感谢 [**JS.ORG**](https://js.org) 为本项目提供域名支持。\r\n\r\n感谢 [**@Amlkiller**](https://github.com/amlkiller) 为本项目提供十分有价值的反馈和建议。\r\n\r\n感谢 **熊曰(与熊论道)、佛曰、兽音译者** 为本项目提供灵感和参考。\r\n\r\n感谢贡献 PR 和参与测试的其他所有人，以及**正在使用本项目的您**。\r\n\r\n## 开放源代码许可\r\n\r\n**⚠️本项目受私有许可证保护**，使用本项目则默认视为同意并遵守相关条款。禁止将本项目用于非法用途。 \r\n👉 查阅 [**AIPL-1.2 许可**](LICENSE.md) 来了解详细信息，也可以前往 [**#87**](https://github.com/SheepChef/Abracadabra/issues/87) 查阅简单介绍。 \r\n\r\n---\r\n\r\n以下是本项目的依赖项：\r\n\r\n- [**Unishox2**](https://github.com/siara-cc/Unishox2) 短字符串压缩实现 _©Siara-cc_, **Apache-2.0** License.\r\n- [**noble-ciphers**](https://github.com/paulmillr/noble-ciphers) AES加密算法实现 _©Paul Miller_, **MIT** License.\r\n- [**noble-hashes**](https://github.com/paulmillr/noble-hashes) 哈希和PBKDF2算法实现 _©Paul Miller_, **MIT** License.\r\n- [**pako**](https://github.com/nodeca/pako) GZIP压缩实现 _©Vitaly Puzrin/Andrei Tuputcyn_, **MIT** License.\r\n- [**js-base64**](https://github.com/dankogai/js-base64) Base64编码工具实现 _©Dan Kogai_, **BSD-3-Clause** License.\r\n- [**mersenne-twister**](https://github.com/boo1ean/mersenne-twister) 梅森旋转算法实现 _©Makoto Matsumoto/Takuji Nishimura_, **BSD-3-Clause** License.\r\n- [**opencc-js**](https://github.com/nk2028/opencc-js) 简繁体转换实现 _©nk2028_, **MIT** License.\r\n- [**otplib**](https://github.com/yeojz/otplib) TOTP 实现 _©Gerald Yeo_, **MIT** License.\r\n\r\n\r\n本项目许可证与所有依赖项的许可证兼容。\r\n\r\n## Star History\r\n\r\n\r\n