万字长文|MrHua:当AI安全工具箱长出一个会游走的灵体,桌面交互被重新定义了

一个没有菜单栏、没有图标网格的桌面工具,一个自主游走的光球,一套覆盖AI对话、网络安全工具箱、知识库、代码工坊、加密通信和身份系统的完整技术栈。本文深度拆解MrHua的设计哲学、核心架构与实战能力,全文约1.5万字,建议收藏后阅读。


写在前面:我们到底需要什么样的安全桌面工具?

如果你是一名安全从业者、渗透测试工程师、CTF选手,或者只是一个对网络安全有持续热情的开发者,你一定经历过这样的场景:

  • 桌面上堆着几十个工具——nmap、sqlmap、nuclei、ffuf、hydra、BurpSuite……每个工具有自己的命令行参数、自己的输出格式、自己的配置文件。你想做一次完整的侦察,需要在五六个终端窗口之间反复切换,手工把上一步的输出喂给下一步。
  • 你想让AI帮你分析扫描结果,但AI和你的工具链是割裂的。你复制粘贴输出,AI给你一段泛泛而谈的建议,既不能调用工具,也不记得你上次扫过什么。
  • 你尝试过各种"AI安全助手",发现它们要么只是套壳聊天,要么把工具调用做成硬编码的正则匹配,稍微复杂一点的指令就失效,更别提权限控制和审计了。
  • 你关心隐私,但大多数云端AI工具默认把你的对话、扫描结果、甚至API密钥都传到服务器上,你根本不知道哪些数据流出去了。

MrHua试图回答的,就是这些问题。它不是又一个"AI+安全"的缝合怪,而是一个从交互范式到工具治理、从记忆系统到社区治理都重新设计过的桌面工具。最直观的区别是:它没有传统菜单栏,没有图标网格,整个界面的唯一入口是一个自主游走的光球——灵体(Orb)。

这篇文章会从交互设计、AI工具调用管线、工具治理、记忆系统、社区治理、隐私安全等维度,把MrHua完整拆解一遍。无论你是想找一个真正能用的AI安全工作站,还是想研究AI Agent如何安全地调用系统工具,相信都能有所收获。


一、第一印象:一个没有菜单栏的桌面工具

1.1 灵体:唯一入口

打开MrHua,你看到的是纯白背景上一个渐变色光球。它不挂在任务栏上,不固定在某个角落,而是每3到9秒自主选择一个目标点平滑移动。鼠标快速靠近时它会害羞地躲开,鼠标静止时它会好奇地靠近,鼠标靠近且静止时它会磁吸飘向你——方便你点击。

这个设计初看有点"反效率",但用久了会发现它的逻辑:灵体用颜色、光效、粒子和动作表达状态,不需要文字标签。 默认是紫色渐变光球空闲游走;AI思考时变成蓝色脉冲;AI回复时绿色微光;安全工具执行中是黄色旋转;工具完成绿色闪烁加蹦跳;未认证等告警状态是橙色脉冲加抖动;错误是红色震动;5分钟无操作后缩小变暗进入休眠。

安全发现还会按严重程度发光:蓝色信息、绿色低危、黄色中危(灵体轻推你)、橙色高危(摇头)、红色严重(震动加粒子爆发)。这种"无言表达"在长时间扫描任务中特别有用——你不用盯着日志,余光扫一眼灵体的颜色就知道当前状态。

灵体的交互方式相当密集:

  • 单击打开/聚焦对话窗口
  • 双击打开命令面板(模糊搜索全部47个功能)
  • 右键弹出环形菜单(10个常用工具快捷入口)
  • 中键触发Exposé窗口总览(所有已打开窗口平铺预览)
  • 滚轮在已打开的窗口间循环切换
  • 三击开始新会话
  • 长按0.5秒语音输入(需麦克风权限)
  • Shift+点击截图并保存
  • Ctrl/⌘+点击打开独立对话窗口
  • Alt+点击切换灵体大小
  • 拖窗口到灵体最小化该窗口

键盘侧有Ctrl/⌘+K命令面板、Ctrl/⌘+N新对话、Ctrl/⌘+,设置、Ctrl/⌘+W关闭窗口、Ctrl/⌘+M最小化、Ctrl/⌘+Q安全退出、F1操作手册、Esc关闭弹窗。最实用的是直接打字——不需要先点击任何东西,敲键盘就自动打开对话窗口并输入。

1.2 窗口与灵体的伴飞机制

MrHua的窗口管理有一套和灵体联动的设计。打开窗口后,灵体自动缩小到36px,停靠在最前窗口的右上角外侧,窗口拖动时实时跟随。窗口最大化(占屏85%以上)时,灵体自动飞入底部任务栏的停靠槽(24px),点击槽位可手动切换停靠/释放。关闭所有窗口后灵体恢复110px继续游走。

底部任务栏始终可见:🏠返回主页(关闭所有窗口)、灵体图标槽(窗口最大化时灵体停靠于此)、窗口按钮(已打开窗口的任务切换)、⏻安全退出。窗口本身支持拖拽标题栏移动、拖拽右下角调整大小、双击标题栏最大化/还原,位置和大小自动保存。

这套设计的核心思路是:灵体是注意力的锚点。 当你对AI说"打开设置",灵体会先飞到设置窗口的位置引导你注意,而不是冷冰冰地弹一个窗口出来。AI模型可以通过orb_control工具操控灵体——打开窗口并引导灵体飞过去、吸引注意、点头/摇头/蹦跳、发光脉冲、切换状态、标记发现严重程度。这让AI的反馈有了空间感,而不只是对话流里的一行文字。

1.3 灵体皮肤:可定制的外观

灵体外观不内置角色,由用户自己定制。在「⚙️ 设置」→「灵体皮肤」中管理,也可以直接对AI说"定制角色"“换回光球”。支持:

  • 光球:默认渐变光球
  • 定制角色:选择形状(圆形/流体/幽灵/果冻/星形/心形)、眼睛样式(圆眼/点眼/动漫眼/眯眯眼/星星眼)、主色、腮红,实时预览后保存
  • 导入SVG:上传自己的SVG文件作为灵体外观
  • 导入Live2D:填写Live2D模型的model3.json URL即可加载(需联网加载PixiJS引擎,Cubism Core受Live2D许可约束)

每个身份档案(主用户和子用户)独立保存自己的角色定制和皮肤选择,切换身份时灵体外观自动切换。自定义文件存放在~/MrHuaData/orb_skins/。


二、身份认证与人格系统:让AI真正"成为"你的助手

2.1 身份认证:一人一主账户

MrHua的身份系统设计得比较克制:每人只能创建一个主账户。 对灵体说"打开身份认证"即可进入。注册流程是输入真实邮箱地址和11位手机号、设置密码(至少6位),系统自动生成唯一用户名(MH开头)、许可证密钥、激活码。注册后需要在同一页面输入许可证和激活码,两者都正确才能激活。只有激活后才能使用工具箱、记忆、网络共享等全部功能。

登录支持用户名、邮箱或手机号。密码使用PBKDF2-SHA256(10万次迭代加随机盐)哈希存储,许可证密钥绑定邮箱和手机,不可伪造。

2.2 身份档案(子用户):多场景AI身份

在身份认证窗口展开「身份档案」,可以为不同场景创建独立的AI身份,比如工作助手、学习伙伴,每个档案可设置AI的名字、性格、说话风格。激活某个档案后,AI将使用该身份与你对话。主用户始终拥有完整工具权限,身份档案仅切换AI身份,不影响工具使用。

这个设计解决了一个真实痛点:你可能希望AI在写代码时严谨克制,在头脑风暴时发散活泼,在安全分析时冷静专业。传统做法是每次对话手动写一大段system prompt,MrHua把它做成了可切换的档案。

2.3 人格设置:行为方式的精细控制

对灵体说"打开人格设置"或按Ctrl+K搜索"人格"即可打开。这里可以定制AI的行为方式:

  • 人格预设:一键切换多种AI角色风格
  • 场景模式:根据当前任务选择模式(闲聊/安全扫描/代码生成/代码审查/深度分析/教学)
  • 服从等级:控制AI对指令的服从程度(平衡/顺从/严格/绝对服从)
  • 沉浸感增强:开启记忆引用、情感共鸣、主动关心、人格一致、环境感知
  • 自定义指令:添加你希望AI始终遵守的规则

配合云端隐私保护和网络搜索授权(基础/标准/搜索+浏览/完全授权),以及SSH隧道和隐私脱敏引擎,人格系统不只是"换个说话风格",而是和权限、隐私策略联动的完整行为配置。


三、记忆系统:AI的长期记忆核心

3.1 扫描记忆:自动保存所有工具结果

对灵体说"打开记忆"或按Ctrl+K搜索"记忆"打开。记忆系统是AI的长期记忆核心,自动保存所有对话和工具扫描结果,让AI在后续对话中引用历史上下文,避免重复扫描。

所有安全工具的执行结果自动保存为扫描记忆,无需手动操作。每次端口扫描、DNS查询、HTTP指纹、漏洞检测等工具执行后,结果结构化存储,包含:

  • 目标信息:IP/域名、扫描时间、使用的工具和参数
  • 结构化数据:端口列表、服务版本、DNS记录、SSL证书、CVE编号等
  • 原始输出:工具的完整原始输出,便于回溯
  • 风险评级:根据发现内容自动评级(高/中/低/信息)

检索方式支持按目标IP/域名、工具类型、风险等级、关键词、时间范围检索。AI在对话中可以自动引用相关扫描记忆——比如你说"上次扫描的那个服务器还有什么端口",AI会从记忆中查找,而不是重新扫一遍。

3.2 记忆河流:时间线视图

按时间线查看所有对话和事件记录,包括对话消息(用户提问和AI回复摘要)、工具调用记录(工具名、目标、结果状态)、系统事件(登录、配置变更、版本更新)、安全告警(高危端口发现、CVE漏洞、异常登录)。支持按日期跳转、按类型筛选、关键词搜索,可导出为Markdown或JSON。

3.3 语义检索:不只是关键词匹配

记忆系统支持向量化语义检索:

  • 使用本地语义模型(paraphrase-multilingual-MiniLM-L12-v2)将记忆内容向量化
  • AI需要引用历史时,用语义相似度匹配最相关的记忆条目
  • 支持"我之前说过关于X的什么"这类模糊查询
  • 可在设置中切换向量引擎(TagHash/TF-IDF/Semantic/Cloud API)

所有记忆数据存储在本地~/MrHuaData/memory/,不上传服务器。开启云端隐私保护后,记忆数据不会发送给云端模型(默认不发送)。可手动删除单条记忆或清空全部记忆,记忆条目数和存储占用在「📊 系统监控」中可查看。

和知识库的区别值得强调:记忆是自动保存的对话和扫描历史,知识库是你手动采集和整理的文档资料。 两者都支持语义检索,AI回答时会同时引用记忆和知识库。


四、社区治理:10级角色、提案、投票与分叉

4.1 角色体系

所有用户都可以在「⚖️ 治理」窗口查看社区统计、角色权限、提案和分叉信息。角色由系统根据贡献和治理投票自动分配,用户不可自行选择。从低到高:

角色权限概要
🔒 禁言(muted)因违规被限制发言,可查看但不可发送消息,到期自动恢复
👀 访客(guest)未注册或未激活,仅可查看公开信息和接收版本公告,不可发言、投票
🙋 成员(member)已注册并激活的正式用户,可聊天、发文件、提交提案、投票
🌱 贡献者(contributor)有实质贡献(代码/文档/帮助他人),可投票、参与版本评审
🔍 审核员(reviewer)负责内容审核,可标记违规、参与提案评审、否决不当版本
🔧 维护者(maintainer)代码维护者,可发布版本公告、审核代码合并,由贡献者晋升
📋 版主(moderator)日常管理,可删除消息、置顶、踢出用户、警告违规、撤回版本
⚖️ 仲裁者(arbitrator)独立仲裁人,处理违规申诉、否决提案、仲裁争议,不隶属管理链
👑 管理员(admin)系统管理,可分配角色、封禁用户、管理房间、发布版本
🏛️ 所有者(owner)平台创建者,最高决策权,可修改治理规则、分配所有角色、发起分叉

4.2 创建者与工程师附加角色

除了上述10级治理角色,还有一个附加角色体系,与治理角色独立、叠加存在:

  • ⚡ 创建者(Founder):每个平台首次启动后,第一个注册并激活的用户自动成为该平台的创建者。创建者凭证仅生成一次,不可转让、不可继承。创建者自动获得「工程师」附加角色。右上角用户名旁会显示橙色⚡创建者徽章。
  • 🔧 工程师(Engineer):附加在治理角色之上的工程角色,目前仅创建者拥有。治理角色和投票权重不变,但额外获得构建和发布版本(不受maintainer等治理角色限制)、管理平台配置(平台ID、名称、版本等)、代码优化和工程管理的权限。

多平台关系值得注意:每个MrHua实例是一个独立平台(拥有唯一PLAT-XXXXXXXX平台ID),各平台自治管理代码和版本,但平台之间可通过广域网互相发现、搜索账户、添加联系人和交易。角色体系全局统一,各平台不可自行定义角色。

4.3 提案类型与要求

提案类型投票人数共识贡献要求冷却
🔧 技术提案50人60%≥107天
⚖️ 治理提案100人75%≥5014天
📦 资源分配80人67%≥3010天
⚠️ 违规申诉10人51%—3天
🚩 分叉提案1000人80%≥200180天

发起提案必须完成身份认证和激活,达到对应贡献分。点击「➕新提案」时会显示要求和警告,确认后才进入填写流程。投票点击赞成/反对按钮前会提示确认,投票后不可更改。

4.4 版本发布与分叉

版本发布分发的是编译后的安装包(Windows .exe、macOS .app/.dmg、Linux .bin),不是源代码。用户收到版本公告后可以直接安装更新,安装前自动备份当前版本。

  • 发布版本:maintainer及以上角色、或拥有🔧工程师附加角色的用户(即平台创建者)可发布。填写版本号和更新说明,勾选目标平台,系统自动构建安装包(优先使用PyInstaller,不可用时构建自包含更新包)并广播到WAN
  • 安装更新:member及以上角色可安装。检查更新后点击「安装更新」,系统自动下载对应平台安装包、备份当前版本、执行安装,重启后生效
  • 投票:contributor及以上可对版本投票(同意/中立/拒绝),reviewer及以上可否决
  • 撤回:moderator及以上可撤回有问题的版本
  • 源代码获取:只能通过治理分叉(Fork)流程,经社区投票通过后获取,不在版本发布中提供

分叉是极其严肃的决定,需要社区≥1000人参与、80%以上共识,发起人必须已激活身份且贡献分≥200,180天内只能发起一次。分叉会完整复制平台所有规则和代码,生成ZIP快照。代码包下载需要已激活身份且贡献分≥50,分叉列表对所有用户可见。

标语是:“这里,创造高于消费,心法高于功能,自由高于归属。”


五、局域网与广域网:公共社区my_era

5.1 公共社区my_era

连接广域网即加入公共房间my_era(密码my_era_public_2026),这是所有MrHua用户的公共社区,可见可聊天,不可离开。在线人数就是社区当前真实在线人数,注册人数通过邮箱/手机哈希去重统计,只传哈希不传明文。在「⚖️社区治理」窗口顶部可看到实时统计。

单页面设计:打开广域网就是完整界面,无需先填表再跳转。顶部紧凑连接栏填写昵称、MQTT中继和TLS,点「连接」即可。左侧房间列表、中间聊天区、右侧成员列表始终显示。

昵称显示:系统自动分配唯一用户名(格式为MHxxxxxxxx)。可在顶部连接栏或聊天区设置自定义昵称,显示格式为用户名 (自定义昵称)。

5.2 多房间同时加入

除了公共社区my_era,你还可以同时加入多个其他房间。点击房间列表底部的「+」,输入房间号和密码即可。左侧房间列表显示所有已加入房间、在线人数和最后消息预览,点击切换聊天窗口。非社区房间可点击×离开。每个房间使用独立的加密密钥,消息互不干扰。

5.3 MQTT中继与加密

默认使用broker.hivemq.com:8883(TLS加密,HiveMQ提供的免费公共中继,位于德国),可切换为broker.emqx.io或test.mosquitto.org。中继只负责转发加密消息,无法读取内容。

局域网自动发现同网段用户,可聊天和共享文件,文件存到~/MrHuaWorkspace/SharedFiles/。广域网通过MQTT中继跨网段通信,TLS加密,房间制加密码,文件存到~/MrHuaWorkspace/WANFiles/,聊天记录自动保存到本地。

5.4 节点同步

在「🔗 节点同步」中可拉取房间内其他节点共享的安全工具、字典和配置数据。拉取前会显示差异预览,可备份回滚。推送功能已移除,避免误传本地数据。

权限方面,10级角色体系不同角色有不同权限。初次违规警告,二次封禁,可申诉。


六、任务中心、贡献记录与联系人

6.1 任务中心

对灵体说"打开任务"或按Ctrl+K搜索"任务"打开。任务中心是社区协作的激励机制,通过发布和完成任务获得贡献分,贡献分影响治理角色晋升和版本发布密钥额度。

任务是用户之间有偿协作的方式,发布者支付能力价值作为奖励,完成者获得奖励和贡献分。流程是:发布任务(填写标题、描述、奖励金额)→ 接受任务(系统生成唯一验证码)→ 完成任务(将验证码提交给发布者确认)→ 确认完成(发布者验证后输入验证码,奖励自动转账)→ 争议处理(可提交仲裁者裁决)。任务类型包括代码开发、安全测试、文档编写、工具配置、知识分享、问题排查等,由发布者自定义。

6.2 贡献记录

贡献分是社区治理的核心货币,影响角色晋升、投票权重和版本发布密钥额度。贡献行为包括:完成任务获得贡献分奖励、提交有效反馈和建议、分享工具配置/字典/规则库、帮助其他用户解决问题、参与社区治理投票和提案评审、发布高质量版本更新、报告安全漏洞和Bug。

贡献记录只显示任务标题和描述,不显示发布者个人信息,防止刷分和利益输送。 贡献分达到阈值后自动晋升治理角色(成员→贡献者→审核员→维护者等)。

6.3 联系人

管理常用联系人,用于广域网通信、权限委托和任务协作。添加联系人输入名称和对方身份ID(选填),支持关键词搜索筛选、信任标记(权限委托时优先选择信任联系人)。联系人信息仅保存在本地,不上传服务器。任务中心负责任务发布和完成流程,贡献页面(🏆贡献与成就)负责贡献分统计、成就徽章和新手任务,两者数据互通。


七、状态面板与漏洞知识图谱

7.1 状态面板:系统运行的实时仪表盘

对灵体说"状态面板"或按Ctrl+K搜索"状态"打开。状态面板每5秒自动刷新,窗口不可见时暂停刷新以节省资源。发现异常状态(模型断开、工具全部未安装、WAN连接失败)时对应卡片红色高亮。

AI模型状态:连接状态(cloud云端/local本地/auto自动)、响应延迟(最近一次API请求往返时间,延迟过高时提示切换端点)、当前模型名称(如deepseek-chat、本地模型路径)、累计调用次数和token消耗。

工具状态:已加载工具数(原生+外部+插件)、按分类统计(信息收集/扫描爆破/编码解码/Web安全/漏洞检测/密码破解/流量分析等)、安装状态(已安装/未安装/已禁用)、工具治理级别(当前自动执行最高风险级别safe/low/medium/high)。

记忆与知识库:记忆条目数(扫描记忆和对话记忆总条数)、知识库文档数、向量引擎(TagHash/TF-IDF/Semantic/Cloud API)和索引状态、存储占用。

网络状态:WAN连接状态、已加入房间数、在线节点数、LAN发现状态和同网段在线用户数、P2P节点在线数和负载、MQTT中继服务器和延迟。

用户与权限:当前用户登录名、治理角色、附加角色(创建者/工程师)、激活状态、权限级别、贡献分和等级进度。

系统运行:运行时间、CPU使用率、内存占用(RSS)、磁盘IO、Web服务监听地址和端口、当前连接数、安全工具子进程运行数和资源占用。

7.2 漏洞知识图谱

安全工具执行后,结果自动构建为图结构,无需手动操作。在对话中让AI执行端口扫描、DNS查询、HTTP指纹等任何安全工具,图谱都会实时更新。

节点类型包括:🟣目标(IP/域名)、🔵IP主机、🟠端口、🔵服务、🟢技术栈(nginx/PHP/jQuery等)、⚫DNS记录/NS/MX、🟣子域名、🟡发现路径、🔴CVE漏洞、🔴漏洞、🟢SSL证书、🟤WAF、⚫操作系统。

自动解析的工具覆盖:端口扫描(nmap/masscan/rustscan/naabu/原生port_scan → 端口+服务+OS)、DNS(dns_lookup/dig/nslookup/host → A/AAAA/MX/NS/CNAME记录+关联IP)、HTTP指纹(http_fingerprint/whatweb/httpx/curl → 状态码+技术栈+Server)、SSL(ssl_info/openssl/sslyze → 证书颁发者+到期+SAN域名)、漏洞扫描(nuclei/nikto/sqlmap/xray → CVE编号+严重级别)、目录爆破(ffuf/gobuster/dirb → 路径+状态码)、子域名(subfinder/amass/sublist3r/原生枚举 → 子域名关联)、暴力破解(hydra/medusa/ncrack → 破解凭据)、WAF检测(wafw00f → WAF类型)。任何工具输出中的CVE编号都会被自动提取。

使用方式:在对话中让AI执行安全工具,图谱自动构建;或在图谱窗口输入目标,点击「扫描并构建」自动执行DNS+端口+HTTP指纹侦察;点击节点查看详情和所有关联节点;力导向布局自动排列,目标节点居中。


八、插件系统:不修改核心代码的扩展能力

8.1 三个Tab页

插件是放在mrhua/plugins/(内置)或~/MrHuaData/plugins/(用户)的Python脚本,无需修改核心代码即可扩展功能。界面分三个Tab页:

  • 📂 本地插件:查看已安装的插件,可编辑、启用/禁用、删除、发布到市场
  • 🌐 插件市场:浏览WAN上其他用户发布的插件,一键请求代码并安装
  • ✏️ 编写插件:填写名称/描述/分类,从模板创建,在线编辑保存

插件可注册:register_tool(注册工具函数,出现在工具箱中,同时自动暴露给AI模型调用)、register_search_backend(注册自定义搜索后端)、register_hook(注册生命周期钩子,扫描前/后、发送前/接收后等)、register_menu(注册前端菜单项)。

8.2 插件与模型调用

通过register_tool注册的插件工具会自动出现在模型的function calling工具列表中:插件名自动加入security_tool的enum,模型调用search_tools时能看到插件的描述和风险级别。模型可以像调用原生工具一样调用插件:

  • 插件工具在search_tools结果中标注type: "plugin",模型可区分原生工具和插件
  • 插件参数通过管线帮助注入(自动获取--help并解析为结构化参数)和search_tools查询获取,不需要手写描述
  • 插件风险级别从PLUGIN_REGISTRY获取,默认low,受工具治理的自动执行级别控制
  • 重名不覆盖:如果插件与原生工具同名(如port_scan),原生版本保持原名,插件版本自动加plugin_前缀(如plugin_port_scan),模型可选择调用哪个版本

内置27个插件:14个独立名称(hash_calc、json_tool、password_gen、regex_test、time_convert、url_parser、email_validate、whois_lookup、ssl_cert_check、http_headers_check、robots_check、ping_test、cors_check、dir_scan);6个重名插件用plugin_前缀(plugin_port_scan、plugin_dns_lookup、plugin_encode_decode、plugin_http_methods、plugin_ip_info、plugin_subdomain_enum);7个安全插件(cve_lookup NVD漏洞查询、payload_generator XSS/SQLi/LFI/CMDi/SSRF payload、encoder_chain多轮编码链、reverse_shell_gen 10种反弹shell、jwt_tool JWT解码+弱密钥爆破、log_analyzer日志攻击分析、subdomain_takeover CNAME接管检测)。

发布到WAN:编辑好插件后点击「🌐 发布」,代码分块加密传输到房间,其他用户可在市场看到并安装。


九、AI如何调用安全工具:语义管线与三层发现

这是MrHua技术含量最高、也最值得细看的部分。MrHua使用语义意图分类加工具匹配管线,AI能理解自然语言指令并自动选择合适的安全工具,无需手动指定工具名。模型通过OpenAI function calling调用工具,同时兼容TOOL/BATCH标签格式。

9.1 语义管线工作流程

意图分类(5维度):用本地语义模型(paraphrase-multilingual-MiniLM-L12-v2)将你的消息向量化,与5组样本投票计算相似度,判断属于哪种意图——search(需要联网查找信息)、tool(需要调用安全工具)、code(编程相关任务)、chat(普通对话)、meta(询问AI自身能力,如"你能调用哪些工具",不触发搜索,模型通过search_tools查询后准确回答)。不是正则关键词匹配,而是语义向量相似度投票,避免"查看"误触发搜索等问题。

工具匹配:两层向量匹配——先匹配工具类别(信息收集/Web安全/密码攻击等),再在类别内匹配最相关的工具,返回Top-5候选。

帮助注入:自动获取匹配工具的--help输出,本地解析为统一的结构化JSON参数列表(参数名、是否必填、类型、说明),让AI知道怎么传参,不需要手写规则。帮助文本可配置长度上限以节省token。

动态提示词:只在需要时注入工具指令和帮助,闲聊时不塞工具信息,节省token。

输出校验:检测空回复、拒绝执行、DSML标签泄漏、编造URL等问题,自动重试或兜底。

9.2 三层工具发现(可扩展到上千个工具)

模型不需要在一段长文本里翻找工具,而是通过三层机制发现和调用工具:

  1. enum全量目录(始终可见):security_tool函数的tool_name参数带有所有已授权工具名的enum列表(JSON数组,约500 token),模型永远看得到全部工具名,不会因为描述过长被云端API截断。新增工具自动出现在enum中,零维护。
  2. search_tools按需查询:模型可以调用search_tools函数查询工具详情,支持按类别(如"信息收集")、关键词(如"dns")、风险级别(safe/low/medium/high)筛选,不传参数返回全部工具。全量查询按类别列出工具名(紧凑格式,不截断),筛选查询附带工具描述和风险级别。适合"你有什么工具""用所有信息收集工具扫一遍"等场景。
  3. pipeline语义推荐(自动):简单请求(如"查DNS")由本地管线自动匹配Top-5工具并注入帮助文档,模型直接选用,不需要额外查询。

9.3 两种调用路径

路径一:Function Calling(推荐)——模型通过security_tool函数调用,传入JSON参数:{"tool_name":"nmap","target":"192.168.1.1","params":{"ports":"1-1000"}}。工具名从enum中选择,不确定时先调search_tools查询。需要了解工具用途或参数时也可以调search_tools。

路径二:TOOL/BATCH标签——模型在回复中输出<<<TOOL:工具名 目标 [选项]>>>标签,系统解析后执行。适合复杂的多工具编排。

9.4 单工具与批量调用

单工具调用直接用自然语言:"查一下example.com的DNS A记录"自动调用dns_lookup;"扫描192.168.1.1的端口"自动调用port_scan;"这个网站用什么技术栈"自动调用http_fingerprint;"把hello做base64编码"自动调用encode_decode插件。目标直接写域名或IP,不需要带http://前缀。

批量工具调用支持三种方式:

方式一:多个TOOL标签(每个任务不同)

<<<TOOL:dns_lookup example.com A>>>
<<<TOOL:dns_lookup example.org MX>>>
<<<TOOL:http_fingerprint example.com>>>
<<<TOOL:port_scan 192.168.1.1 -p 1-1000>>>

方式二:BATCH矩阵(多目标×多工具,自动展开)

<<>>
target: example.com, example.org, example.net
tools: dns_lookup A, http_fingerprint, port_scan -p 1-1000
<<>>

上面的例子自动展开为3目标×3工具=9个任务并行执行。

方式三:BATCH列表(逐行指定不同任务)

<<>>
dns_lookup example.com MX
dns_lookup example.com NS
whois example.org
port_scan 10.0.0.1 -p 80,443
<<>>

批量执行特性:默认5个任务同时跑(可在设置中调整1-10);单任务超时默认30秒,超时自动跳过继续执行其他任务,标记⏱;对话中显示[x/N] ✅/❌ 工具 → 目标进度条;单个工具失败不影响其他任务,最后汇总失败列表;每个工具结果限500字(可调),结构化显示DNS记录/端口列表/技术栈等;相同工具+目标+参数只执行一次;不限制多步骤任务的工具调用次数,但有防御性检查——任务已完成且无新指令时不会空转。

9.5 多步骤任务分解

当你说"先搜索某个关键词,然后扫描找到的网站"这类多步骤指令时,系统自动拆分为带依赖的步骤:Step 1 [搜索] 关键词→获取目标URL;Step 2 [扫描] 网站指纹(依赖Step 1的URL)。AI按顺序执行,前一步结果自动传递给下一步。搜索完成后不会重复搜索,直接进入下一步。


十、搜索架构:三层管线与智能路由

MrHua的搜索不是简单地把关键词丢给一个引擎,而是经过意图识别、关键词提取、多引擎竞速、质量过滤和自动编排的完整管线。

10.1 第一层:意图识别与关键词提取

  • 语义意图分类:5维度向量分类(搜索/工具/代码/闲聊/元问题),询问AI自身能力(如"你能调用哪些工具")不触发搜索
  • jieba分词提取:用词汇级分词(不是单字截断)提取搜索关键词,自动剥离"帮我搜索""查一下"等指令前缀和"主网站/官网/网站"等尾部冗余词
  • 多子句选择:"重新搜索,搜索Python教程"这类包含多个子句的句子,自动选择去掉搜索词后内容最长的子句,不会把"重新"当成搜索词
  • 保护词典:加载config/protected_terms.txt中的专有名词(如工具名、技术术语),搜索结果必须包含保护词,否则判定为不相关

10.2 第二层:多引擎并行竞速

通用搜索:Bing、百度、DuckDuckGo HTML、Mojeek四个引擎同时发起请求,Bing优先(综合质量和语法支持最好),谁先返回足够结果就用谁,慢引擎自动取消。

安全专项搜索:根据查询意图自动路由到专业数据源,不走通用引擎——CVE编号(如CVE-2021-44228)→ NVD美国国家漏洞数据库(带7天本地缓存);子域名/证书关键词→crt.sh证书透明度日志;历史URL/wayback→Wayback Machine CDX API;Shodan/IP资产→Shodan API(需在设置中配置API Key)。

高级搜索语法(dork):支持site: inurl: intitle: intext: filetype: ext:等运算符,以及双引号精确匹配、-排除、OR。dork查询自动跳过关键词拆分和相关度过滤,原样传给搜索引擎,Bing优先(语法支持最全)。内置15个预设dork模板(找后台、找敏感文件、找注入点等),配置在config/dork_templates.yaml。

10.3 第三层:质量过滤与结果增强

  • 关键词相关度过滤:用bigram分词检查结果标题/摘要与查询的相关度,低于阈值的结果自动过滤;全部不相关时返回空并触发换引擎重试,不回退垃圾结果
  • 质量门控:Top结果与查询语义相似度过低时,自动用备用引擎重试一次
  • URL清理:自动解析搜索引擎跳转链接拿到真实URL,修复被换行/空格破坏的域名,过滤无效链接
  • 内容去重:不同站点转载同一内容时自动合并,跨引擎结果交叉验证标记
  • 语义重排:启用语义模型时,按结果与查询的语义相关度重新排序

10.4 前置搜索与自动编排

前置搜索:在模型开始生成回复之前就并行执行搜索,结果直接注入上下文,模型无法拒绝搜索。

侦察链自动编排:安全工具执行后,结果自动解析为结构化数据(端口/服务/版本/CVE/DNS/SSL等),写入漏洞图谱,并根据规则自动驱动低风险后续任务(如发现80端口→自动HTTP指纹,识别出服务版本→自动查CVE),高风险任务只给建议不自动执行。

防重复搜索:已搜索过的内容不重复触发搜索,多步骤任务中搜索完成后直接进入下一步。

隐私脱敏兼容:TOOL/BATCH标签内的域名和IP不会被隐私脱敏引擎替换,确保工具能正确执行;标签外的普通文本仍正常脱敏。

10.5 可调参数

以下参数可在设置页面或通过pipeline.update_settings()调整:batch_max_workers(批量并发数,默认5,建议3-5)、batch_task_timeout(单任务超时秒数,默认30)、batch_result_max_chars(每个结果摘要字数,默认500)、top_k_tools(工具匹配返回数量,默认5)、help_max_chars(工具帮助注入长度上限,默认2000,越小越省token)。


十一、工具治理:模型能调用哪些工具

在「⚙️ 设置」→「工具治理(模型权限)」中配置AI模型可以调用的工具范围。所有工具调用都经过权限检查、审批、审计和错误回退四层控制。

11.1 风险分级

  • 🟢 safe(安全):只读操作,无副作用。DNS查询、WHOIS、SSL信息、HTTP头检查、编码解码、哈希计算、搜索、网页抓取、dig/nslookup/openssl
  • 🟡 low(低风险):轻度主动探测。Ping、端口扫描、Banner抓取、子域名枚举、路由追踪、HTTP指纹、nmap、masscan、whatweb、subfinder、wafw00f、tshark、lynis、clamav、yara、volatility
  • 🟠 medium(中风险):目录爆破、漏洞扫描、爬虫、流量中间人,可能触发目标告警。ffuf、gobuster、nuclei、nikto、xray、mitmproxy、bettercap、scapy、radare2、trivy、burp
  • 🔴 high(高风险):暴力破解、攻击利用、SQL注入。hashcat、john、hydra、medusa、ncrack、sqlmap、metasploit、aircrack-ng
  • ⛔ dangerous(危险):可能造成破坏的操作,默认禁止

11.2 模型可见的工具(动态发现)

模型通过function calling看到的工具是动态生成的,不是硬编码。工具发现分三层:

  1. 网络函数:web_search(搜索)、web_fetch(抓取)、web_deep_search(深度搜索),作为独立函数暴露
  2. security_tool函数:统一安全工具入口,tool_name参数的enum包含当前所有已授权工具名,模型始终看得到全部工具名,不会被API截断。具体数量取决于你安装了哪些工具、设置了什么权限级别
  3. search_tools函数:按需查询工具目录,支持按类别/关键词/风险级别筛选,返回工具名、描述、风险级别等信息

安全工具由三部分构成:Python原生工具(随软件内置,无需安装,始终可用,如dns_lookup、port_scan、http_fingerprint、whois、ssl_info、ping、traceroute等);外部工具(通过config.yaml配置和TOOL_REGISTRY自动发现,需要在系统中安装后才会出现在模型可见列表中,如nmap、masscan、nuclei、ffuf、whatweb、msfconsole、curl、wget、sqlmap、hydra等);Python插件(随软件分发的插件工具,与原生重名的用plugin_前缀区分,不覆盖原生版本)。

工具列表随系统安装状态和权限级别动态变化——新安装的工具下次对话自动出现在enum中,开发工具(python3/git/npm等)不暴露给模型。插件工具标注[插件]标签,重名不覆盖原生。在「📊 系统监控」→「🛠️ 工具」中可以查看当前环境的实际工具数量和状态。

11.3 自动执行最高风险级别

这是最核心的权限设置,控制模型可以自动执行哪些工具(无需人工确认):

  • safe:仅只读操作(DNS查询、WHOIS、SSL信息、HTTP头检查、编码解码、搜索等),最安全
  • low:允许主动探测(Ping、端口扫描、Banner抓取、子域名枚举等),日常使用推荐
  • medium:允许扫描爆破(目录爆破、漏洞扫描等),渗透测试使用
  • high:允许破解和利用(暴力破解、SQL注入、攻击框架等),仅限授权测试

每个级别实际包含多少工具取决于系统安装了哪些工具。高于此级别的工具不会暴露给模型(模型根本看不到),dangerous级别始终禁止。模型调用工具时以auto_approve=True执行,在授权级别内无需弹窗确认。

11.4 系统环境扫描与工具监控台

在「📊 系统监控」→「🛠️ 工具」标签页中,点击「🔍 扫描系统」按钮可以自动检测注册表中所有工具的安装状态(通过PATH和MrHuaWorkspace/bin目录)、自动发现系统中已安装但不在注册表中的安全工具、扫描常见字典目录(/usr/share/wordlists、SecLists、MrHuaData/wordlists等)、避免重复安装已存在的工具。

工具监控台分两行卡片。第一行按类型分类(已安装/总数):📦可安装工具、📖字典资源、🔌内置插件、🛡️网安工具、⚙️原生工具、🌐网络工具。第二行运行状态统计:工具总数、可用、未安装、已禁用、总调用、成功率、失败(下方有失败记录详情)。可按名称搜索、按类型和状态筛选,点击「禁用/启用」可单独控制工具是否允许模型调用(即时生效),自动刷新5秒一次,窗口不可见时不刷新。

11.5 设置项与审计日志

设置项包括:启用工具治理(总开关)、允许模型调用工具、显示工具调用状态、自动执行最高风险级别、记录操作审计日志、审计记录工具参数(密码自动脱敏)、失败重试次数、每分钟最大调用次数、每小时高风险上限、失败回退策略(重试后切换工具/跳过失败工具/中止操作)。还可以单独启用/禁用六种工具类型(Web/原生/外部/插件/字典/可安装)和所有工具类别,关闭某类别后该类别下所有工具从模型视野中移除。

每次工具调用记录:时间、工具名、类型、风险级别、参数(密码脱敏)、目标、成功/失败、耗时、错误信息。通过GET /api/governance/audit查询,支持按工具名、风险级别、成功状态筛选。

错误处理与回退:超时等待2秒自动重试;连接失败自动切换同类工具;工具未安装自动切换到原生替代(nmap→port_scan、subfinder→subdomain_enum等18组映射);权限不足跳过,不卡死。

外部工具执行时自动清除代理环境变量(http_proxy/https_proxy),防止流量被本地代理劫持。AI只能调用已安装、已启用且在授权风险级别内的工具。工具类型路由优先级:plugin_前缀→原生工具→唯一名称插件→外部工具。


十二、工具与字典安装

在「工具安装」窗口可自动检测和安装外部安全工具,覆盖20个分类:🔍信息收集(whois/dig/amass/subfinder等)、🌐Web扫描(sqlmap/nuclei/nikto/wpscan/ffuf/gobuster/dirb等)、🔧网络工具(curl/wget/netcat/socat/nmap等)、💻开发工具(git/python3/node/go/rust等,不暴露给模型)、🔑密码攻击(hydra/john/hashcat/medusa等)、🏗️渗透框架(metasploit/cobaltstrike/empire等)、🚀扫描器(masscan/rustscan/zmap等)、🔬逆向工程(gdb/radare2/ghidra/binwalk等)、🔍取证(volatility/autopsy/foremost等)、🎯漏洞利用(searchsploit/msfvenom等)、📶无线安全(aircrack-ng/reaver/wifite等)、📊网络分析(wireshark/tcpdump/ettercap等)、☁️云安全(awscli/gcloud/az等)、🌍OSINT(theharvester/maltego等)、💥网络攻击(hping3/yersinia等)、🗄️数据库(sqlite3/redis-cli等)、📱移动安全(apktool/jadx等)、🕵️Web代理(burpsuite/owasp-zap等)、🔐加密(openssl等)、🔩杂项工具。

还可下载常用字典:SecLists全套、RockYou、子域名、密码、用户名、目录、LFI/RCE/XXE/SSTI Payload、UA列表、默认凭证、WebShell、FuzzDB、PayloadsAllTheThings等。

点击「安装」按钮自动执行安装(macOS用brew、Linux用apt、Windows用choco),失败时显示具体错误和解决建议。已安装的工具显示🟢,未安装显示🔴。安装后工具自动出现在模型可见列表中(受工具治理级别控制)。


十三、协作白板与AI辅助规则编写器

13.1 协作白板

在WAN房间内共享的可视化画布,适合团队协作绘制网络拓扑和攻击路径。支持多种节点形状(矩形/圆形/菱形/云朵/数据库/攻击者/防火墙)、节点间连线、文字标注、颜色自定义、双击节点编辑标签(内联编辑器,不再弹窗)、撤销/重做(Ctrl+Z / Ctrl+Y,最多50步)、网格吸附和节点自动对齐。

缩放与平移:鼠标滚轮以光标为中心缩放(30%~300%),工具栏+/−/重置按钮控制缩放,Shift+拖拽或鼠标中键拖拽平移画布,高清DPI渲染,Retina屏幕不模糊。

图谱导入与同步:点击「🕸 从图谱导入」自动将漏洞图谱绘制成拓扑图,点击「🔄 同步到房间」将白板共享给房间内所有成员。

13.2 AI辅助规则编写器

用自然语言描述需求,AI生成可直接使用的安全规则:WAF规则(ModSecurity/CRS格式,防护SQL注入、XSS等)、YARA规则(恶意软件家族识别和样本匹配)、Snort/Suricata规则(网络入侵检测)、自定义脚本(Python检测脚本模板)。生成的规则可直接复制或保存到本地。


十四、隐私与安全:数据留在本地

所有数据存储在本地~/MrHuaData/目录。密码使用PBKDF2-SHA256(10万次迭代加随机盐)哈希存储。云同步文件AES-256加密,云端只存密文。广域网消息端到端加密,默认房间my_era使用TLS 8883。SSH隧道支持跳板机加密传输云端API流量。

云端隐私分类控制:8类数据(记忆/扫描/知识库/反馈/历史/工具结果/用户上下文/系统提示词)可单独开关,默认敏感数据不发送。隐私脱敏引擎自动替换发送给云端的敏感信息(IP/域名/邮箱等),回复后本地还原。API密钥不持久化,每次会话临时输入。API端点需要登录才能访问。许可证密钥绑定邮箱和手机,不可伪造。沙箱环境隔离运行不可信脚本。审计日志记录所有关键操作。工具治理默认仅自动执行只读操作,扫描等需用户确认。


十五、这套东西到底适合谁?

写到这里,MrHua的功能覆盖面已经相当清楚了。它不是给所有人准备的,但对以下几类人会有实打实的价值:

渗透测试工程师和安全服务从业者:你日常要在多个工具之间切换,MrHua的语义管线让你用自然语言驱动工具链,批量执行和侦察链自动编排能省掉大量手工衔接。工具治理和审计日志让"AI自动执行"这件事在授权测试场景下可控可追溯。漏洞图谱自动构建,扫描结果不再是散落在终端里的文本。

安全研究者和CTF选手:记忆系统让你不用重复扫描同一目标,语义检索能找到"上次那个站点的SSL证书什么时候到期"这类模糊历史。插件系统让你用Python快速扩展自己的工具,注册后AI直接可调用。协作白板适合团队梳理攻击路径。

对AI Agent安全调用系统工具感兴趣的研究者:MrHua的工具治理设计——风险分级、enum全量目录、search_tools按需查询、pipeline语义推荐、四层控制(权限检查/审批/审计/错误回退)——是一个值得参考的工程样本。它没有把"AI调用工具"做成一个黑盒,而是把每一层都暴露给用户配置。

注重隐私的开发者:本地存储、AES-256加密、8类云端隐私开关、脱敏引擎、SSH隧道,这些设计说明作者认真考虑过"哪些数据不该离开本地"。

想参与社区治理开源项目的用户:10级角色、5类提案、版本发布与分叉流程,这套治理机制虽然不是每个人都需要,但它展示了一种"代码和规则都由社区投票决定"的组织方式。创建者徽章和工程师附加角色也给早期参与者留了位置。


十六、一些值得注意的设计细节

在通读材料的过程中,有几个细节让我觉得作者是真的在用这套东西:

灵体的"害羞"和"磁吸"——鼠标快速靠近时躲开,静止时靠近,靠近且静止时磁吸飘向鼠标。这不是装饰性的动画,而是在解决一个真实问题:灵体在页面上游走,如果总是躲着鼠标,点击会很烦;如果总是黏着鼠标,又会挡住内容。磁吸机制让"想点的时候点得到,不想点的时候不碍事"。

重名插件不覆盖原生工具——插件和原生工具同名时,原生保持原名,插件加plugin_前缀。这个细节避免了插件生态里最常见的命名冲突问题,同时让模型可以显式选择调用哪个版本。

TOOL/BATCH标签内的域名和IP不被隐私脱敏替换——脱敏引擎会替换普通文本里的敏感信息,但如果标签内的目标也被替换,工具就没法执行了。这个兼容处理说明作者考虑过脱敏和工具执行的冲突。

贡献记录只显示任务标题和描述,不显示发布者个人信息——防止刷分和利益输送。治理系统里这种"反作弊"设计往往比功能本身更难做。

窗口最大化时灵体飞入任务栏停靠槽,手动释放后在窗口状态变化前不会自动弹回——这个"手动优先"的逻辑避免了灵体在停靠和释放之间反复横跳。

状态面板每5秒自动刷新,窗口不可见时暂停刷新——省资源的小细节。

外部工具执行时自动清除代理环境变量——防止流量被本地代理劫持。做安全工具的人才会想到这个。


十七、如何开始

三步开始使用:

  1. 创建账户:对灵体说"打开身份认证",或按Ctrl+K搜索"身份认证",输入邮箱、手机号和密码,系统自动生成许可证和激活码
  2. 激活账户:注册后在同一页面输入许可证和激活码,两者都正确才能激活
  3. 开始对话:单击屏幕中央的灵体,或直接开始打字,即可和AI聊天

激活后建议先做几件事:在「⚙️ 设置」→「工具治理」里把自动执行最高风险级别设为low(日常使用推荐);在「📊 系统监控」→「🛠️ 工具」里点「🔍 扫描系统」看看本机已有哪些工具;在「工具安装」里补装需要的工具和字典;在「人格设置」里选一个场景模式;在「记忆」里确认存储路径。

如果想体验社区功能,打开广域网连接公共房间my_era(密码my_era_public_2026),在「⚖️ 社区治理」里看看当前统计和提案。想参与治理的话,先通过任务中心和贡献行为积累贡献分。


结语:创造高于消费,心法高于功能,自由高于归属

MrHua的标语是"这里,创造高于消费,心法高于功能,自由高于归属。"这句话放在文末,不是装饰。从灵体的交互设计到工具治理的四层控制,从记忆系统的语义检索到社区治理的分叉机制,这套东西的每一个模块都在试图回答同一个问题:当AI有了调用系统工具的能力,人应该站在什么位置?

MrHua给出的答案是:人站在治理的位置。工具的风险级别由人设定,数据是否上云由人开关,角色和提案由人投票,代码分叉由人决定。AI可以自动执行授权范围内的工具,可以自主编排侦察链,可以引用记忆和知识库,但它始终在一个被人设定好边界的环境里工作。灵体用颜色和动作表达状态,而不是用文字标签——这个设计本身就在说:AI的反馈应该是可感知的,但决策权在人手里。

如果你对"AI Agent如何安全地调用安全工具"这个话题感兴趣,MrHua的代码和设计文档值得一读。如果你只是想要一个能干活的安全工作站,它的语义管线、批量执行、漏洞图谱和记忆系统应该能帮你省下不少时间。如果你关心隐私和治理,它的本地存储、脱敏引擎和社区治理机制提供了一个可参考的样本。

万字长文到此结束。建议收藏,按需查阅。欢迎在评论区交流你用过的AI安全工具,以及你对"AI调用系统工具"这件事的看法。


本文基于 MrHua 官方使用手册整理撰写,功能细节以实际版本为准。相关版本与发布信息可参见:https://gitcode.com/AevumArk/Aevum/releases/v0.1.7

Logo

更多推荐