Ret2Shell All-in-One Kit

回归终端 Ret2Shell 工具箱，目前包含动态 FLAG 生成校验、接口管理（计划）等功能。

Ret2Shell is a feature-riches CTF challenge platform developed by Reverier Xu and other contributors.

This package obeys the same license of Ret2Shell, GNU GPL-3.0.

pip install ret2shell-kit

动态FLAG生成

Ret2Shell Kit 支持以与比赛平台相同的方式生成 FLAG，这样只需要使用平台提供的评测脚本并确保两者的配置（密钥、FLAG模板）相同即可。在生成动态 UUID、Leet FLAG 前，需要让选手输入临时用户识别码或队伍密钥来较为安全地获取选手的用户 ID 或队伍 ID。

使用临时身份识别码获取用户 ID 的方法如下：

from ret2shell_kit import Ret2ShellClient

with Ret2ShellClient("https://ctf.xidian.edu.cn/api") as client:
    player = client.account.get_user_info("AAAAAA") # 通过临时身份识别码拿到用户对象
    print(player.id) # ID，例如 114514
    print(player.account) # 用户名，例如 foo
    print(player.nickname) # 昵称，例如 林林

使用队伍密钥获取队伍 ID 的方法如下：

from ret2shell_kit import Ret2ShellClient

with Ret2ShellClient("https://ctf.xidian.edu.cn/api") as client:
    team = client.game.find_team_by_team_code(37, "xxxxxxxxxxxx")
    print(team.id) # id
    print(team.name) # 队名

通过以上的方法获取到队伍 ID 或用户 ID 后就可以生成动态 FLAG 了。

leet mode

from ret2shell_kit import LeetStego
# 初始化一个密钥，需要与平台上设置的相同
stego = LeetStego("your_secret_key")

# 定义 Flag 模板，获取ID（team_id优先，user_id次之）
template = "this-is-an-example"
data_id = 12345

# 生成 Flag 内容
encoded = stego.encode(template, data_id)
print(f"编码结果 {encoded}")

# 解码验证
decoded = stego.decode(template, encoded)
print(f"解码结果 {decoded}")  # 12345

uuid mode

from ret2shell_kit import UUIDStego

# 初始化（带连字符格式）
uuid_stego = UUIDStego("your_secret_key", with_hyphen=True)

template = "this-is-an-example"
data_id = 12345

# 生成 UUID
encoded = uuid_stego.encode(template, data_id)
print(f"UUID: {encoded}")

# 解码
decoded = uuid_stego.decode(template, encoded)
print(f"解码结果: {decoded}")  # 12345

比赛队伍与排行榜

基于平台接口获取比赛队伍排行榜，按得分降序返回。token 可选，不传则以游客身份访问。

from ret2shell_kit import Ret2ShellClient

with Ret2ShellClient("https://your-platform.example/api", token="your_token") as client:
    # 1. 整场比赛排行榜（分页拉取全部队伍）
    board = client.game.get_leaderboard(game_id=1)

    # 2. 只取前 10 名
    top10 = client.game.get_leaderboard(game_id=1, top_n=10)

    # 3. 按机构 ID 过滤，只取该机构前 10 名
    by_id = client.game.get_leaderboard_by_institute_id(
        game_id=1, institute_id=5, top_n=10
    )

    # 4. 按机构名称过滤（内部先查询机构列表解析出机构 ID）
    by_name = client.game.get_leaderboard_by_institute_name(
        game_id=1, institute_name="西安电子科技大学", top_n=10
    )

各方法返回 Team 模型列表，可按得分/名称等字段访问：

说明：top_n=None时返回全部队伍；页面较大时会自动分页拉取。如需排除被禁用的队伍，可传min_state。排行榜默认按 score 字段降序排列。机构名对应不上时会抛出ValueError。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ret2shell_kit-0.1.5.tar.gz (26.9 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ret2shell_kit-0.1.5-py3-none-any.whl (27.9 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file ret2shell_kit-0.1.5.tar.gz.

File metadata

Download URL: ret2shell_kit-0.1.5.tar.gz
Upload date: Aug 11, 2026
Size: 26.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ret2shell_kit-0.1.5.tar.gz
Algorithm	Hash digest
SHA256	`2aa592688f7f6a2844573f4cd4260f59a18389507a9efce7869b28e9688f4edf`
MD5	`8afb11441b2f802d7deb63fcdb1cfde1`
BLAKE2b-256	`ca2df53355f221d3afd8c1d097fac00086d9ff93483455d8d61075668f3cdf8b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ret2shell_kit-0.1.5.tar.gz:

Publisher: publish.yml on Xiaozonglin/ret2shell-steganography

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ret2shell_kit-0.1.5.tar.gz
- Subject digest: 2aa592688f7f6a2844573f4cd4260f59a18389507a9efce7869b28e9688f4edf
- Sigstore transparency entry: 2421551212
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: Xiaozonglin/ret2shell-steganography@7220d2b612096509690242ccb1db230cbbb95ce2
- Branch / Tag: refs/tags/v0.1.5
- Owner: https://github.com/Xiaozonglin
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@7220d2b612096509690242ccb1db230cbbb95ce2
- Trigger Event: push