当AI安全工具箱长出一个会游走的灵体,桌面交互被重新定义了
万字长文|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% | ≥10 | 7天 |
| ⚖️ 治理提案 | 100人 | 75% | ≥50 | 14天 |
| 📦 资源分配 | 80人 | 67% | ≥30 | 10天 |
| ⚠️ 违规申诉 | 10人 | 51% | — | 3天 |
| 🚩 分叉提案 | 1000人 | 80% | ≥200 | 180天 |
发起提案必须完成身份认证和激活,达到对应贡献分。点击「➕新提案」时会显示要求和警告,确认后才进入填写流程。投票点击赞成/反对按钮前会提示确认,投票后不可更改。
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 三层工具发现(可扩展到上千个工具)
模型不需要在一段长文本里翻找工具,而是通过三层机制发现和调用工具:
- enum全量目录(始终可见):
security_tool函数的tool_name参数带有所有已授权工具名的enum列表(JSON数组,约500 token),模型永远看得到全部工具名,不会因为描述过长被云端API截断。新增工具自动出现在enum中,零维护。 - search_tools按需查询:模型可以调用
search_tools函数查询工具详情,支持按类别(如"信息收集")、关键词(如"dns")、风险级别(safe/low/medium/high)筛选,不传参数返回全部工具。全量查询按类别列出工具名(紧凑格式,不截断),筛选查询附带工具描述和风险级别。适合"你有什么工具""用所有信息收集工具扫一遍"等场景。 - 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看到的工具是动态生成的,不是硬编码。工具发现分三层:
- 网络函数:web_search(搜索)、web_fetch(抓取)、web_deep_search(深度搜索),作为独立函数暴露
- security_tool函数:统一安全工具入口,
tool_name参数的enum包含当前所有已授权工具名,模型始终看得到全部工具名,不会被API截断。具体数量取决于你安装了哪些工具、设置了什么权限级别 - 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秒自动刷新,窗口不可见时暂停刷新——省资源的小细节。
外部工具执行时自动清除代理环境变量——防止流量被本地代理劫持。做安全工具的人才会想到这个。
十七、如何开始
三步开始使用:
- 创建账户:对灵体说"打开身份认证",或按Ctrl+K搜索"身份认证",输入邮箱、手机号和密码,系统自动生成许可证和激活码
- 激活账户:注册后在同一页面输入许可证和激活码,两者都正确才能激活
- 开始对话:单击屏幕中央的灵体,或直接开始打字,即可和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
更多推荐


所有评论(0)