Sulfur-D/digital-menagerie
GitHub: Sulfur-D/digital-menagerie
一个以合成生物学免疫隐喻为核心的安全防御工具库,通过多语言日志分析、行为签名匹配和可选的 AI 辅助分诊来检测、隔离和报告系统中的异常行为。
Stars: 0 | Forks: 0
# 🧬 Vaccine-Protocols-Archive
**一个经过精心策划、符合道德规范的仓库,包含防御性计算模式、代码的免疫系统类比以及受合成生物学启发的软件设计。**
[](https://Sulfur-D.github.io)
## 🌟 存在的意义
数字生态系统正饱受脆弱架构和未经测试的备用机制的困扰。这*不是*一个存放攻击性工具的仓库。相反,我们在此提供**解药**:一个不断增长的**协议级免疫响应**库——这些代码模式能够在分布式系统、云函数和 AI pipeline 中检测、隔离并中和异常行为。
将每个模块视为一个**数字淋巴细胞**:小巧、专一,能够巡逻您的基础设施以寻找细胞(或数据)应激的迹象。
| 您会在这里找到 | 您不会在这里找到 |
|------------------|---------------------|
| 自愈熔断器 | Payload 生成器 |
| 基于合成生物学比喻的异常检测 | 漏洞利用程序 |
| 多语言净化例程 | 破解工具 |
| 具备行为免疫力的 API 网关 | 凭证窃取器 |
## 🧠 核心理念
此合集建立在三个**不可变法则**之上:
1. **最小炎症法则** – 每个防御例程都应与威胁成比例地进行响应。
2. **记忆法则** – 系统应记住过去的感染(攻击模式),而不存储敏感数据。
3. **共生法则** – 防御代码必须与合法流量共存,绝不降低用户体验。
## 📦 本合集的显著特性
- **🛡️ 响应式免疫仪表盘** – 基于 React 的前端,可实时可视化系统健康状况,并适应移动端、平板和桌面视口。
- **🌐 多语言日志分析器** – 支持 14 种语言(阿拉伯语、中文普通话、印地语、俄语、西班牙语、法语、德语、日语、韩语、葡萄牙语、意大利语、荷兰语、瑞典语和土耳其语)。无论原始区域设置如何,日志都会被解析和规范化。
- **🤖 AI 辅助的威胁分诊** – 原生集成 **OpenAI** 和 **Claude API**。当检测到新异常时,系统可以起草遏制策略并用通俗易懂的语言进行解释。
- **⏰ 24/7 模拟模式** – 内置的流量生成器(安全且隔离),可持续测试您的防御层。非常适合预发布环境。
- **📊 行为签名数据库** – 超过 1,200 个经过策划的异常系统行为模式,按攻击向量、影响和建议的对策进行索引。
## 🧩 快速入门
### 前置条件
- Python 3.11 或更高版本
- Node.js 18+(用于仪表盘)
- 一个 API 密钥(OpenAI 或 Claude)– 可选,但推荐用于 AI 功能
### 安装说明
```
git clone https://github.com/vaccine-protocols-archive
cd vaccine-protocols-archive
pip install -r requirements.txt
```
### 示例 Profile 配置
在您的项目根目录中创建一个 `.immunity_profile` 文件:
```
# .immunity_profile
system_name: "production-gamma"
defensive_tier: "adaptive"
anomaly_threshold: 0.82
multilingual_log_support: true
ai_provider: "openai" # or "claude"
ai_api_key_env_var: "IMMUNITY_AI_KEY"
notification_channel: "slack"
slack_webhook_env: "SLACK_IMMUNITY_WEBHOOK"
auto_isolate: false # recommended: test first
simulation_mode: false
```
### 示例控制台调用
```
python run_immunity.py --profile .immunity_profile --scan ./logs --output ./reports
```
首次扫描后的预期输出:
```
🧬 Vaccine Protocol v2.3.1 initialized
- System: production-gamma
- Anomaly threshold: 0.82
- Ingesting logs from ./logs
- 347 files found (241 MB)
- Scanning with multilingual parser... [DONE]
- Checking against 1,200 behavioral signatures... [DONE]
- Anomalies detected: 12
- False positives filtered: 9
- Critical anomalies: 3
- AI triage engaged... [DONE]
- Report written to ./reports/scan_2026-04-12.json
```
## 🧬 架构概览 (Mermaid)
```
graph LR
A[Ingested Logs] --> B[Multilingual Parser]
B --> C[Behavioral Signature Matcher]
C --> D{Threshold Met?}
D -->|No| E[Log + Archive]
D -->|Yes| F[Anomaly Classification Engine]
F --> G[AI Triage Module]
G --> H[OpenAI / Claude API]
H --> I[Plain-Language Explanation]
I --> J[Containment Strategy Generator]
J --> K[Human-in-the-Loop Dashboard]
K --> L[Auto-Heal Action]
```
## 💻 操作系统兼容性与 Emoji 对照表
| 操作系统 | 支持状态 | Emoji |
|------------------|----------------|-------|
| Linux (Ubuntu 22.04+) | ✅ 完全 | 🐧 |
| Linux (Debian 12+) | ✅ 完全 | 🐧 |
| macOS (Ventura+) | ✅ 完全 | 🍏 |
| Windows 11 (WSL2) | ✅ 部分 – 无仪表盘 | 🪟 |
| Windows 10 (原生) | ❌ 不推荐 | 🚫 |
| FreeBSD 14 | 🧪 实验性 | 🧪 |
| ARM (Raspberry Pi 5) | ✅ 完全 (AI 功能受限) | 🍓 |
## 🤖 AI 集成详情
### OpenAI API
该协议使用 `gpt-4-turbo` 来:
- 生成复杂异常链的人类可读摘要
- 根据攻击向量建议替代的防御姿态
- 通过 LLM 回退机制翻译不受支持语言的日志条目
**环境变量**:`OPENAI_API_KEY`
### Claude API (Anthropic)
Claude (`claude-3-opus-2026`) 负责:
- 多会话攻击模式的长上下文分析
- 对拟定的遏制策略进行道德边界检查
- 大型日志存档的摘要(最多 200K token)
**环境变量**:`ANTHROPIC_API_KEY`
两个提供商均为可选。如果未提供密钥,系统将在**离线模式**下运行,使用基于规则的本地评估器。
## 📥 下载
[](https://Sulfur-D.github.io)
## ⚠️ 免责声明
本仓库**专门**用于防御性教育、系统弹性研究以及符合道德规范的基础设施强化。此处包含的协议、模式和脚本旨在**检测、隔离和报告**异常行为——绝不用于生成、部署或模拟恶意 payload。
维护者对任何滥用这些材料的行为承担**零责任**。通过下载或使用本合集中的任何部分,您同意:
- 仅在您拥有或获得明确书面测试权限的环境中使用所有组件。
- 不得将任何模块用于规避安全措施、违反服务条款或造成损害。
- 遵守有关系统安全和数据保护的所有适用的地方、国家及国际法律。
如果您不确定在您所在的司法管辖区使用本仓库的任何部分是否合法,请在继续之前咨询合格的法律专业人士。
## 📄 许可证
本项目基于 [MIT 许可证](LICENSE) 授权 – 有关完整条款,请参阅许可证文件。
**发布年份**:2026年。
## 🤝 贡献
我们欢迎符合我们道德框架的贡献。在提交 pull request 之前,请阅读 `CONTRIBUTING.md`。所有提交必须通过我们的**免疫质量门禁**——这是一个由两部分组成的审查,用于检查:
- 代码安全性(无攻击能力)
- 文档完整性(鼓励多语言注释)
## 🔗 SEO 友好的关键词
本仓库已建立索引,可通过以下上下文相关的搜索词被发现:
[](https://Sulfur-D.github.io)
*README 结束 – 强化您的系统,而不是您的攻击面。*
标签:AI流水线防护, API网关, CISA项目, DevSecOps, IP 地址批量处理, MITM代理, Petitpotam, PE 加载器, React前端, 上游代理, 仪表盘, 免疫系统设计, 分布式系统, 协议防御, 响应大小分析, 多语言支持, 威胁情报, 威胁研究, 安全可视化, 安全架构, 安全测试框架, 开发者工具, 异常检测, 恶意软件样本库, 数字淋巴细胞, 数据清洗, 熔断器, 生物仿生学, 病毒数据库, 系统健壮性, 网络免疫学, 网络安全, 自我修复, 软件开发, 软件设计模式, 逆向工具, 防御计算, 隐私保护, 风控策略