SpearX - 现代化MacOS工具管理器

一款现代化的跨平台工具管理器，为开发者和安全研究人员打造
集成多种工具类型，支持智能分类管理和一键执行
在极简中发现极致，在安静中感受力量。

Created by Spe4r ⚡

✨ 功能特性

🎯 核心功能

• 🔧 多工具类型支持

• ☕ Java 应用 (Java 8/11/17) - 支持 JAR 包执行，多版本 Java 环境
• 🖥️ 终端工具 - 在终端中打开工具目录，支持命令行工具
• 🌐 Web 应用/网站 - 浏览器中打开 URL
• 📱 本地应用程序 - 系统默认方式打开 APP、目录等
• 🔗 自定义命令 - 灵活配置执行参数和命令

• 📁 智能管理

• 📂 分类组织管理
• 🏷️ 标签系统
• 🔍 实时搜索过滤
• 📝 工具笔记和文档
• 🔄 自动扫描发现工具

• 🎨 现代化界面

• 🌟 毛玻璃效果
• 🎭 流畅动画交互
• 📱 响应式设计
• 🌙 优雅的视觉效果
• ⚡ 高性能渲染

🎯 核心优势

📸 截图预览

主界面展示

🚀 快速开始

📋 系统要求

📦 安装方式

方式一：下载预编译版本 (推荐)

1. 前往 Releases 页面
2. 下载对应平台的最新版本
3. 解压并运行 SpearX

方式二：从源码编译

# 1. 克隆仓库
git clone https://github.com/sspsec/Spear.git
cd spear-x

# 2. 安装 Wails CLI (如果未安装)
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# 3. 构建应用
wails build -platform darwin/amd64 -clean

# 4. 运行应用
./build/bin/SpearX

⚡ 快速体验

1. 首次启动：应用会自动创建默认配置
2. 添加工具：点击 ➕ 按钮手动添加工具
3. 扫描工具：使用 🔄 按钮扫描现有工具目录
4. 执行工具：点击工具卡片即可执行

📚 使用指南

📖 基本操作

1️⃣ 工具添加

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描

2️⃣ 工具执行方式详解

☕ Java 应用 (Java8/Java11/Java17)

适用场景：Java 开发的桌面应用、安全工具、开发工具等

• 支持格式：.jar 文件
• 自动配置：根据工具需求选择对应 Java 版本
• 内存管理：支持自定义 JVM 参数如 -Xmx2g
• 环境隔离：每个工具可独立配置 Java 环境

配置示例：

-ToolName:BurpSuiteProfessional
PATH:/Applications/Security/BurpSuite
FileName:burpsuite_pro.jar
VALUE:Java11# 使用 Java 11
Optional:"-Xmx4g -XX:+UseG1GC"# JVM 优化参数

执行过程：

1. 检测配置的 Java 版本路径
2. 如果未配置则使用系统默认 Java
3. 构建执行命令：{java_path} {optional} -jar {jar_file}
4. 在工具目录中执行命令

🖥️ 终端工具 (openterm)

适用场景：命令行工具、脚本、需要终端交互的工具

• 支持格式：可执行文件、脚本文件、工具目录
• 自动定位：自动 cd 到工具目录
• 终端打开：使用系统默认终端应用
• 环境保持：保持工具的工作目录环境

配置示例：

-ToolName:Nmap网络扫描
PATH:/usr/local/bin/nmap
FileName:""# 工具目录，无需指定文件
VALUE:openterm
Optional:""

执行过程：

1. 打开系统默认终端
2. 自动切换到工具目录
3. 用户可直接使用命令行操作
4. 适合需要交互式操作的工具

🌐 Web 应用 (Browser)

适用场景：在线工具、Web 界面、本地 HTML 工具

• 支持格式：URL 链接、本地 HTML 文件
• 浏览器兼容：使用系统默认浏览器
• 本地支持：支持 file:// 协议的本地文件
• 参数传递：支持 URL 参数和锚点

配置示例：

# 在线工具
-ToolName:GitHub
PATH:https://xxx
VALUE:Browser

# 本地 HTML 工具  
-ToolName:本地报告查看器
PATH:/Users/tools/reports/index.html
VALUE:Browser

执行过程：

1. 检测路径类型（URL 或本地文件）
2. 调用系统默认浏览器
3. 传递完整路径或 URL
4. 支持传递额外参数

📱 系统默认打开 (Open)

适用场景：本地应用程序、文档、媒体文件

• 支持格式：.app(macOS)、各种文档目录
• 系统集成：使用操作系统的文件关联
• 权限处理：自动处理应用权限问题

配置示例：

# macOS 应用
-ToolName:Wireshark
PATH:/Applications/Wireshark.app
VALUE:Open


# 文档文件
-ToolName:工具使用手册
PATH:/Users/docs/manual.pdf
VALUE:Open

执行过程：

1. 检测操作系统类型
2. 使用系统 API 打开文件
3. 自动调用关联的应用程序
4. 处理权限和安全提示

🔗 自定义命令 (Custom)

适用场景：复杂的启动流程、需要特殊参数的工具

• 完全自定义：可以配置任意的执行命令
• 变量支持：支持路径、文件名等变量替换
• 环境变量：可设置特定的环境变量
• 脚本支持：支持执行复杂的启动脚本

配置示例：

-ToolName:Docker工具容器
PATH:/path/to/tool
COMMAND:"docker run -it --rm -v {path}:/workspace tool:latest"
VALUE:Custom
Optional:"--network host"

-ToolName:Python脚本工具
PATH:/tools/scanner
FileName:scanner.py
COMMAND:"python3 {filename} --config config.json"
VALUE:Custom

变量说明：

{path}      # 工具目录的绝对路径
{filename}  # 指定文件的完整路径
{name}      # 工具名称
{optional}  # Optional 字段的内容

🔧 执行优先级和回退机制

SpearX 提供智能的执行方式检测和回退机制：

智能检测示例：

# 自动检测为 Java 应用
-ToolName:自动检测工具
PATH:/tools/scanner
FileName:scanner.jar
VALUE:""# 留空，系统自动检测为 Java

# 自动检测为终端工具  
-ToolName:命令行工具
PATH:/tools/nmap
FileName:""# 目录形式，自动检测为 openterm
VALUE:""

3️⃣ 搜索技巧

# 搜索语法：
- 名称搜索：直接输入工具名称
- 标签搜索：输入 标签名
- 描述搜索：搜索工具描述内容

📂 目录结构与组织方式

🗂️ 推荐的工具组织方式：

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
0

🎯 智能目录扫描特性

SpearX 在扫描目录时会智能识别以下内容：

📋 自动识别的文件类型：

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
1

🔍 智能分类规则：

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
2

路径类型支持：

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
3

⚙️ 配置说明

📄 tool.yml 配置文件

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
4

🔧 Java 环境配置

自动检测 (推荐)

• 留空 JavaPaths 配置，系统自动使用环境变量中的 Java

手动配置

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
5

🔨 开发构建

🛠️ 开发环境要求

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
6

📦 生产构建

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
7

🔧 技术栈

前端技术

• 框架: Vue 3 + Composition API
• UI 库: Element Plus
• 构建工具: Vite
• 样式: CSS3 + 毛玻璃效果
• 图标: Element Plus Icons

后端技术

• 语言: Go 1.24
• 框架: Wails v2
• 配置: YAML
• 依赖: 标准库为主

🏗️ 架构设计

📐 整体架构

# 三种添加方式：
1. ➕ 手动添加 - 逐个配置工具信息
2. 🔄 扫描默认目录 - 扫描 resources 目录
3. 📂 扫描自定义目录 - 选择任意目录扫描
8

🧩 核心模块

❓ 常见问题

🔧 环境配置问题

Q: 运行程序显示文件损坏不能打开？

Q: Java 工具无法执行？

Q: 工具扫描没有发现工具？

🚀 使用问题

Q: 如何添加自定义工具？

Q: 工具笔记保存在哪里？

Q: 支持哪些文件格式？

📂 配置问题

Q: 如何备份工具配置？

🎉 获取下载链接

点击下方名片进入公众号

回复关键字【Spear】获取下载链接