💡 SilentSniffer 背后的理念

大多数互联网用户认为，除非自己在浏览器权限提示中明确点击"允许"，否则其会话始终保持私密和封闭。而实际上，标准Web API在底层静默地授予网站对硬件特征、时序向量、网络拓扑和传感器行为的广泛访问权限。

SilentSniffer 的诞生旨在提供一次教育性的警醒。通过在完全安全、仅限本地的沙箱环境中运行诊断与演示模块，用户能够直观地理解现代浏览器所允许的Web暴露真实范围——且不存在任何数据离开其设备的风险。

🏗 架构概览

该工具包基于零耦合动态插件架构构建。核心引擎完全独立于各模块逻辑，通过集中式清单在运行时发现并加载工具。

graph TD
    A[index.html / debug.html] -->|Bootstrap| B[src/core/engine.js]
    B -->|Fetch Discovery| C[src/config/modules.json]
    C -->|Return Payload Paths| B
    B -->|Dynamic import| D[src/modules/level_X/*.js]
    D -->|Self-Register| B
    B -->|Render Grid| UI[Dynamic Command Center]

关键设计原则：

• 0% 耦合：核心引擎逻辑与诊断载荷保持解耦。
• 100% 内聚：每个模块都是自包含单元，拥有自己的元数据和执行逻辑。
• 本地沙箱保证：所有处理严格在本地客户端 DOM/IndexedDB 环境中进行——不进行任何外部数据传输。

⚡ 威胁升级层级

工具被划分为六个不同级别，反映信息暴露的严重程度。

🔒 安全与本地执行范围

本框架严格用于教育研究、意识提升和浏览器能力审计。第 1 级至第 6 级的所有 54 个模块均严格在您的浏览器内运行。 远程数据外传服务器和恶意载荷已被排除；所有捕获的指标和视觉反馈均严格保留在您的本地机器上。

📖 详细技术规范：如需查看被排除的攻击性函数签名、向量及其安全诊断替代方案的完整列表，请参阅 排除向量规范文档。

组件实现规范：

所有 UI 组件、注册清单、核心基础设施引擎（transmitter.js、persistence.js、evasion.js）以及 54 个诊断模块均已 100% 完成，并可在沙箱环境中正常运行：

所有诊断查询严格在本地浏览器上下文中执行，并将执行数据存储在隔离的本地 IndexedDB（SilentSnifferAuditLogDB）中。任何数据都不会离开用户的浏览器。

🔄 系统工作流程与数据流

当模块被执行时，它会遵循从初始化到本地渲染的严格生命周期。

sequenceDiagram
    participant U as UI (Command Center)
    participant E as Engine.js
    participant M as Module.js
    participant API as Browser Web API

    U->>E: User triggers Execution
    E->>E: Initializing Sequence
    E->>M: run() async
    M->>API: Native Web API Probe / Inspection
    API-->>M: Local Diagnostic State
    M-->>E: Structured Payload
    E->>U: Render to Local Terminal UI

📁 仓库结构

SilentSniffer/
├── src/
│   ├── core/
│   │   ├── engine.js         # Framework Orchestrator
│   │   └── transmitter.js    # Data Storage & Audit Logger
│   ├── config/
│   │   └── modules.json      # Discovery Manifest
│   ├── modules/              # Diagnostic & Awareness Modules
│   │   ├── level1/           # Standard Recon
│   │   ├── level2/           # Fingerprinting
│   │   ├── level3/           # Intelligence
│   │   ├── level4/           # Bypass Lab
│   │   ├── level5/           # Advanced Vectors
│   │   └── level6/           # Social Engineering & Media
│   └── styles/               # Global Design System
├── debug.html                # Command & Diagnostic Center
└── index.html                # Dashboard Interface

🛠 内部模块结构

每个模块都遵循统一接口，以确保在动态沙箱中干净地执行。

/**
 * SilentSniffer Module Template
 */
export default {
    id: 'unique_identifier',
    title: 'Display_Name',
    level: 4, // Level 1-6
    info: "Description of the browser capability or security exposure.",
    steps: [
        "Phase 1 Recon...",
        "Phase 2 Local Probe...",
        "Phase 3 State Analysis..."
    ],
    run: async () => {
        // Local diagnostic logic
        return { data: 'captured_intel' };
    }
};

🤝 开发与贡献

本仓库以 Web 安全教育与研究为核心进行维护。欢迎贡献者通过实现新的浏览器能力审计器来扩展该工具包。

1. 起草：使用标准模板实现诊断模块。
2. 定位：将脚本放入对应的 src/modules/levelX/ 文件夹。
3. 注册：将文件路径添加到 src/config/modules.json。
4. 验证：打开 debug.html 以确认该工具已自动渲染并可正常运行。