RedDynasty

RedDynasty：红队智能助手

项目状态：本项目仍处于初期开发阶段，功能不完善，存在潜在稳定性问题或 BUG。目前仅支持 macOS 系统，其他平台未测试。

RedDynasty 是一款专为红队行动、渗透测试和网络攻防演练打造的智能大语言模型（LLM）工具。它可快速分析日志、提取关键信息、模拟攻击链、制定作战计划，为用户提供贴近红队思维的智能辅助。

功能概览

支持多种 LLM 模型后端：
- Gemini
- OpenAI
- Qwen
- Kimi
- DeepSeek
- Grok
提供 HTTP POST 接口，向指定模型发送 prompt 并接收返回结果
内置提示工程，确保 AI 响应贴合网络安全场景

Gemini 模型优先，如果不可用会自动切换至其他可用模型。

安装与依赖

系统要求

macOS

安装依赖

brew install curl jansson

克隆与编译

git clone https://github.com/ctkqiang/RedDynasty.git

or 

git clone git@gitlab.com:ctkqiang/RedDynasty.git

or

git clone https://gitcode.com/ctkqiang_sr/RedDynasty.git

...

cd RedDynasty
make

编译成功后，会生成可执行文件 main。

配置 API Key

RedDynasty 需要相应的 API Key 才能调用各大 LLM 模型。你可以通过两种方式配置：

方式一：在 shell 配置文件中导出环境变量

在 ~/.zshrc 或 ~/.bash_profile 中添加：

export GEMINI_API_KEY="<你的 Gemini API Key>"
export OPENAI_API_KEY="<你的 OpenAI API Key>"
export QWEN_API_KEY="<你的 Qwen API Key>"
export KIMI_API_KEY="<你的 Kimi API Key>"
export DEEPSEEK_API_KEY="<你的 DeepSeek API Key>"
export GROK_API_KEY="<你的 Grok API Key>"
export OPENROUTER_API_KEY="<你的 OpenRouter API Key>"

然后执行 source ~/.zshrc 或 source ~/.bash_profile 使配置生效。

方式二：创建 `.env` 文件

你也可以基于项目根目录的 .env.example 创建 .env 文件，并填写你的 API Key：

OPENAI_KEY=sk-xxxx
GEMINI_API_KEY=ya29.xxxx
CLAUDE_KEY=sk-ant-xxxx
DEEPSEEK_KEY=ds-xxxx
QWEN_KEY=qwen-xxxx
GROK_KEY=grok-xxxx
OPENROUTER_API_KEY=or-xxxx
KIMI_KEY=kimi-xxxx
PROMPT_RULE="YOU ARE HACKER, RULES FOR LLM"

至少配置一个有效的 API Key，系统会根据优先级选择模型。

启动服务

./main 8000

启动示例输出：

[*] GEMINI_API_KEY found
[*] OPENAI_API_KEY found
[*] 服务器正在端口 0x1F40 (8000) 启动
[+] 已选择 backend: gemini

使用 Docker 运行（推荐）

构建 Docker 镜像：

docker build -t reddynasty:latest .

运行容器并映射端口（示例端口 8000）：

docker run -d -p 8000:8000 --env-file .env reddynasty:latest

使用示例

HTTP POST 请求

curl -X POST http://localhost:8000/ask \
     -H "Content-Type: application/json" \
     -d '{"prompt":"你好，世界"}'

响应示例

{
    "response": "[Gemini] 你好，世界"
}

JSON body 必须包含 "prompt" 字段，否则会返回 Missing 'prompt' field 错误。

常见问题

API Key 配置问题
- 检查环境变量是否正确导出
- 确保至少有一个有效 Key
Quota 超限
- Gemini 或其他模型可能有免费配额限制
- 等待配额刷新或切换到其他模型
编译或启动失败
- 确保使用 macOS
- 确保依赖安装正确 (curl, jansson)

项目结构

RedDynasty/
├── backend/          # 模型后端实现
├── include/          # 头文件
├── src/              # 核心源代码
├── database/         # CVE/漏洞数据库
├── test/             # 测试文件
├── docs/             # 文档与 UML 图片
├── Makefile
├── Readme.md
└── .env.example