360safe-cli (360 安全卫士全功能 CLI 与自动化运维工具包)

面向开发人员、系统运维工程师与 AI 智能体打造的 360 安全卫士 (Qihoo 360 Total Security) 满血命令行控制中枢与自动化工具包。

提供了对 360 核心守护进程、内核过滤驱动、注册表安全引擎、SQLite 隔离区底层账本、查杀日志以及开发者信任白名单的全可编程、极速、无头控制能力。

---

核心特性 (Key Features)

1. 自适应动态安装定位 (Dynamic Auto-Discovery)：
   • 彻底废除硬编码路径；自动穿透 Windows 注册表卸载项与活跃进程信息，在任意机器与自定义盘符下开箱即用。
2. 底层隔离区账本直接穿透 (SQLite Quarantine Forensics)：
   • 直接只读挂载读取 360safe.Summary.dat，毫秒级提取被隔离文件的 MD5、SHA256、原始路径与病毒类型，智能识别误报资产。
3. 内核安全驱动实时巡检 (Kernel Drivers Inspection)：
   • 一键枚举当前 Windows 内核中已加载的全部 360 安全过滤驱动（如 360Box64, 360FsFlt, 360netmon 等）。
4. 一键唤起与免密控制 (Instant GUI Launcher)：
   • 终端秒级调起 360 原生可恢复区窗口（360Restore.exe）、安全操作中心（360LogCenter.exe）或主界面。
5. 开发者信任区与白名单运维 (DevMode Trust Manager)：
   • 支持自动化查询信任配置与为指定工程目录添加开发者信任路径。
6. AI Agent 与脚本友好 (JSON Output First)：
   • 全命令原生支持 --json 参数，提供确定性结构化数据输出，完美适配自动化管道与大模型工具调用。

---

环境要求与前置依赖 (Prerequisites)

重要使用前提 (Must Read Before Use)： 本工具是面向已安装 360 软件的自动化运维、无头控制与分析中枢，自身不内置第三方杀毒引擎二进制。为了让所有管控、驱动巡检与隔离区穿透功能完整生效，运行环境要求如下：

1. 操作系统支持：
   • Windows 10 / Windows 11 (64 位架构系统)。
2. 宿主机前置软件依赖：
   • 宿主机需已安装 360 安全卫士 或 360 安全卫士极速版；
   • 允许安装在任意自定义盘符（例如 C:\Program Files (x86)\360\360Safe 或 D:\Software\360\360Safe 等），CLI 具备自动穿透 Windows 注册表与活跃进程的动态发现能力，无需手动配置路径环境变量；
   • 未安装时的表现：若当前机器尚未安装 360，CLI 仍可正常执行，会自动识别并优雅输出“未检测到 360 安装”，不会引发异常崩溃或阻塞管道。
3. Python 运行与开发环境：
   • Python 3.8 或更高版本（推荐 Python 3.10 ~ 3.13）；
   • 仅依赖官方成熟系统巡检库 psutil>=5.8.0（通过 pip install -e . 或 pip install -r 自动下载）。

---

快速上手 (Quick Start)

1. 本地安装

# 克隆仓库 (GitHub 或 Gitee)
git clone https://github.com/markx520/360safe-CLI.git
# 或国内镜像
git clone https://gitee.com/brother_xuan/360safe-cli.git

cd 360safe-CLI

# 安装依赖并以可编辑模式注册命令
pip install -e .

2. 便携批处理运行 (免安装)

仓库根目录内置 360.bat，可直接在终端中调用：

.\360.bat status
.\360.bat quarantine

---

命令行使用手册 (CLI Usage)

用法: 360 [-h] [--test] [--json] {status,quarantine,drivers,open,logs,trust,scan} ...

子命令:
  status                   查看 360 核心进程与引擎就绪状态
  quarantine (quar, list)  查看隔离区/可恢复区中的文件明细 (SQLite 穿透)
  drivers                  枚举底层加载的 360 内核过滤驱动
  open (gui)               调起 360 原生桌面界面 (restore/logcenter/main)
  logs                     解密查看 360 扫描与查杀日志
  trust                    查看 360 信任区配置与项目数
  scan                     调用 360 扫描指定路径

示例 1：查询系统状态与守护进程

360 status

输出示例：

======================================================================
【360 安全卫士系统运行与防护状态】
======================================================================
安装主目录   : D:\Software\360\360Safe (就绪: True)
恢复区程序   : D:\Software\360\360Safe\360Restore.exe
操作中心     : D:\Software\360\360Safe\safemon\360LogCenter.exe
鲲鹏查杀引擎 : [已开启]
云查杀网络检 : [已就绪]
信任区项目数 : 8
最后查杀时间 : 2026-10-28 20:55:15
----------------------------------------------------------------------
活跃 360 进程数: 2
  - PID:  6248 |   61.5 MB | 360tray.exe
  - PID: 12840 |   10.2 MB | 360UDiskPro.exe
----------------------------------------------------------------------
加载内核安全驱动: 10 个
  - 360FsFlt        | File System  | 360FsFlt
  - 360netmon       | Kernel       | 360netmon
======================================================================

示例 2：穿透查看隔离区文件

360 quarantine

示例 3：调起原生可恢复区界面

360 open restore

示例 4：输出结构化 JSON 数据

360 status --json
360 quarantine --json

示例 5：执行五维物理自测套件

360 --test

---

Python API 调用示例 (Python SDK)

除了命令行外，本工具亦可作为标准 Python 库导入使用：

from qihoo360_cli import (
    detect_360_root,
    get_360_processes,
    get_registry_info,
    get_quarantine_summary,
    get_360_drivers,
)

# 动态探测安装目录
safe_root = detect_360_root()
print(f"360 安装目录: {safe_root}")

# 获取当前活跃进程
procs = get_360_processes()
for p in procs:
    print(f"PID: {p['pid']} - 内存占用: {p['memory_mb']} MB")

# 读取隔离区 SQLite 摘要
summary = get_quarantine_summary()
print(f"隔离区记录数: {summary['sqlite_records_count']}")

---

架构示意图 (Architecture)

[ 用户 / AI 智能体 / CI 管道 ]
             │
             ▼
      [ 360 CLI 门面 ] (qihoo360_cli.cli)
             │
   ┌─────────┼─────────┬──────────────┬──────────────┐
   ▼         ▼         ▼              ▼              ▼
[进程探针] [注册表]  [驱动枚举]     [SQLite 隔离区]  [日志解析]
(psutil)  (winreg) (driverquery)  (Summary.dat)   (UTF-16LE)
   │         │         │              │              │
   └─────────┴─────────┼──────────────┴──────────────┘
                       ▼
           [ 360 安全卫士底层运行时 ]

---

本地开发与测试指南 (Development & Testing)

为确保开发者克隆本仓库后能清晰、无阻碍地进行本地二次开发与贡献调试，推荐开发流程如下：

1. 搭建虚拟开发环境

# 1. 创建独立虚拟环境
python -m venv .venv

# 2. 激活虚拟环境
.\.venv\Scripts\activate

# 3. 安装依赖并以可编辑模式挂载当前源码
pip install -e .

2. 执行本地自动化回归测试

# 运行全部 8 项标准单元测试
python -m unittest discover -s tests

# 或使用便携批处理执行 5 维物理自检
.\360.bat --test

---

开源协议与合规免责声明 (License & Legal Disclaimer)

1. 软件许可证 (Open Source License)

本项目采用商业友好型 Apache License 2.0 开源许可证（Copyright 2026 markx520）。允许个人与企业开发者在保留原版权与免责声明的前提下自由使用、修改与衍生开发。

2. 商标中立与指示性合理使用声明 (Trademark & Nominative Fair Use)

根据《中华人民共和国反不正当竞争法》、《中华人民共和国商标法》及 Apache 2.0 许可证第 6 条：

1. 商标归属说明：“360”、“360安全卫士”、“Qihoo 360”及相关标识、文字、图形均为奇虎 360 技术有限公司（Qihoo 360 Technology Co., Ltd.）之注册商标与商业标识。
2. 指示性使用说明：本项目在软件名称、代码变量及文档中使用上述商标，仅出于客观指示兼容目标软件及互操作性（Interoperability）之必要，属于指示性合理使用（Nominative Fair Use），绝对不代表本项目由 360 官方出品、授权、赞助或背书。
3. 独立非官方立场：本项目由独立开源社区开发者维护，作者与 360 公司无任何劳动雇佣、商业代言、联合运营或关联关系。

3. 净室开发与零闭源资产再分发 (Clean-Room & No Binary Redistribution)

1. 100% 原创代码：本仓库包含的全部源码均为开发者独立编写的 Python 代码，未包含任何通过反编译、反汇编获取的原厂私有源码。
2. 零官方二进制再分发：本仓库绝不包含、绝不分发、绝不捆绑任何 360 官方所有的专有二进制文件（包括但不限于 .exe 可执行文件、.dll 动态链接库、.sys 内核驱动及官方专有图标资产）。
3. 运行时依赖说明：所有终端管理命令均依托于用户计算机上已经合法独立安装的 360 软件原生能力，本工具仅作为合规的外挂命令行调用管道。

4. 零破坏性与网络安全合法性声明 (Cybersecurity Compliance & Non-Tampering)

根据《中华人民共和国刑法》第二百八十五条、第二百八十六条及《中华人民共和国网络安全法》：

1. 无危害性与只读运维：本工具仅调用操作系统标准公开接口（如只读查询注册表公开卸载项、与任务管理器同等级的 psutil 进程巡检、Windows 原生 driverquery 驱动只读枚举、以及向官方原版程序发起带参调起）。
2. 绝对零破坏防御：本工具绝对不提供、不包含任何用于破坏计算机信息系统、强行关停杀毒防护、绕过安全拦截、内存注入挂钩或篡改底层防御规则的功能。本项目严格定位于系统管理员合规运维、误报排查与 AI 自动化集成。

5. 民事法律责任豁免与自负风险条款 (Limitation of Liability & As-Is)

根据 Apache 2.0 协议第 7 条及第 8 条，本项目按“现状”（AS-IS）提供，不提供任何明示或暗示的保证（包括但不限于适销性、特定用途适用性或无侵权保证）：

1. 用户在操作系统中使用本工具唤起隔离区恢复文件、修改开发者信任白名单或触发扫描查杀时，应具备完全民事行为能力并知晓安全风险。
2. 任何个人、组织或 AI 代理因使用本工具管理资产、误报文件恢复、系统环境差异或杀毒引擎更新而导致的任何直接或间接损失（包括但不限于数据丢失、系统故障、业务中断或经济损失），作者与贡献者概不承担任何民事赔偿与连带法律责任。

6. 权利人保护与避风港通道 (Notice and Takedown)

本项目高度尊重各方知识产权与合法权益。若相关权利人认为本仓库内容存在任何侵权疑虑，请直接通过 GitHub / Gitee 提交 Issue 或通过项目联系方式提交通知。作者将在核实后依据互联网避风港原则（Safe Harbor）第一时间予以配合处理。