ghost-bits-encoder 是一个面向 Woodpecker 的辅助插件，围绕 Ghost Bits / Unicode 高位包装思路，提供通用编解码、JSON 相关编码、URL 相关编码以及若干专项辅助能力。

简体中文 | English

• 项目名：ghost-bits-encoder
• Maven 坐标：me.gv7:ghost-bits-encoder:1.0-SNAPSHOT
• 编译目标：Java 8
• 插件入口：src/main/java/me/gv7/woodpecker/plugin/WoodpeckerPluginManager.java
• Woodpecker 界面名称：GhostBits 编解码器
• Woodpecker 插件版本：2.0

插件的核心做法是：将文本的低 8 位信息映射到不同的 Unicode 字符中，或基于特定解析逻辑生成可用于测试的变体；同时提供对应的解码与验证能力，方便在 Woodpecker 中直接操作和比对结果。

项目当前实现的能力不止“编码/解码”两个标签页，还包含多种针对不同输入形式的辅助编码方式：

核心实现位于 src/main/java/util/GhostBits.java 与 src/main/java/util/Json.java，目前包含以下几类逻辑：

1. 固定基址编码与解码

   • 默认使用 U+4E00（CJK）作为基址。
   • 解码时逐字符取低 8 位恢复原文。

2. 逐字符随机高位包装

   • 预计算安全码点表，按字节值随机选择可见、安全的 Unicode 字符。

3. 多语言区块变体生成

   • 内置多组可用基底，覆盖拉丁扩展、希腊、西里尔、希伯来、阿拉伯、天城文、孟加拉、泰文、缅甸、CJK、数学/几何符号等区块。
   • 编码 标签页默认生成 5 个随机变体。

4. 面向特定场景的辅助编码

   • Jetty Hex / Ghost URL / 全角 URL
   • FastJSON / Jackson
   • Base64 / CRLF / BCEL

说明：README 只描述当前仓库中已经实现的编码行为与插件功能，不对外部环境的兼容性或实际效果做额外保证。实际测试效果请以目标应用链路为准。

根据 WoodpeckerPluginManager，插件启动时会注册以下 11 个标签页：

1. 编码
2. 解码
3. FastJSON Ghost
4. Jetty Hex编码
5. 全角URL编码
6. Ghost URL编码
7. Base64 Ghost
8. CRLF注入编码
9. BCEL Ghost
10. Jackson Ghost
11. 使用帮助

默认输入示例：

../../../

执行后会输出原文和 5 个随机变体，格式类似：

原文: ../../../

贮败赵贰贰贲赥
ぐぜちぢぢづど
αεθικικιμ
...

默认输入示例：

丮丮丯丮丮丯丮丮丯

输出：

../../../

默认输入：

{"@type":"java.awt.Rectangle"}

当输入看起来像 JSON 时，插件会保留 JSON 结构字符，只对字符串字面量内容进行编码；若输入为普通文本，则会整体编码为 \\uXXXX 风格结果。

默认输入：

{"@type":"com.sun.rowset.JdbcRowSetImpl"}

若识别为 JSON，则仅对字符串字面量内容做 Ghost 包装；数字、布尔值和 JSON 结构字符保持不变。

这三个标签页的默认输入都是：

../

• Jetty Hex编码：输出 %XX 风格变体。
• Ghost URL编码：混合 %XX 片段与 Ghost 字符。
• 全角URL编码：先转全角，再输出 URL 编码后的结果。

默认输入：

1ue

处理流程为：先对原文做标准 Base64，再对 Base64 结果逐字符做 Ghost 化。

默认输入：

attacker[CRLF]DATA[CRLF]Subject: PWNED

其中 [CRLF] 是占位标记，编码后对应位置会被替换为 Ghost 化的 \r\n。

默认输入：

$$BCEL$$$l$8b$I$A$A$A$A$A$A$A$9c$bc$db$d2$ab$ca$96

如果输入以 $$BCEL$$ 开头，插件会保留此前缀，只对后续内容做编码。

• JDK 8 或更高版本
• Maven 3.x
• 可加载 Woodpecker Helper 插件的运行环境

git clone https://github.com/woodpecker-appstore/ghost-bits-encoder.git
cd ghost-bits-encoder
mvn clean package

构建完成后会在 target/ 下生成：

target/ghost-bits-encoder-1.0-SNAPSHOT.jar

cp target/ghost-bits-encoder-1.0-SNAPSHOT.jar <woodpecker-plugins-dir>/

src/main/java/me/gv7/woodpecker/plugin/
├── WoodpeckerPluginManager.java
└── helpers/
    ├── Base64GhostHelper.java
    ├── BcelGhostHelper.java
    ├── CrlfGhostHelper.java
    ├── FastjsonGhostHelper.java
    ├── FullwidthUrlHelper.java
    ├── GhostUrlHelper.java
    ├── HelpHelper.java
    ├── JacksonGhostHelper.java
    └── JettyHexHelper.java

src/main/java/util/
├── GhostBits.java
└── Json.java

src/test/java/
├── BcelTest.java
├── DigitTest.java
├── FastJsonTest.java
├── GhostBitsTest.java
└── JsonTest.java

仓库中已经包含基础测试与示例程序，覆盖了以下内容：

• 通用 Ghost 编码/解码往返
• Jetty Hex 编码逻辑
• Base64 Ghost 往返验证
• CRLF 编码结果校验
• 全角 URL / Ghost URL 基本输出验证
• Jackson / FastJSON 场景下的 JSON 结构保留

当前仓库状态下可直接执行：

mvn test

pom.xml 当前主要依赖包括：

• me.gv7.woodpecker:woodpecker-bcel:0.1.0
• me.gv7.woodpecker:woodpecker-sdk:0.3.0
• me.gv7.woodpecker:woodpecker-requests:0.2.0
• me.gv7.woodpecker:woodpecker-tools:0.1.0.beta1
• com.alibaba:fastjson:1.2.57（测试作用域）

• whwlsfb@SgLab
• Xenc@SgLab

MIT