o3set/dsh-mapscan：DeepSeek Harness 網絡空間測繪五平臺綜合查詢

前言¶

DeepSeek Harness (DSH) 是一個以插件爲核心的系統，通過動態 Cordis 插件可以在會話中注入工具。在進行資產測繪、滲透測試或攻擊面梳理時，往往需要同時查詢 FOFA、Shodan、鷹圖 Hunter、ZoomEye 和 Quake 五個平臺。這些平臺的搜索語法、鑑權方式和數據結構各不相同。o3set/dsh-mapscan 旨在解決這一痛點，將五個平臺封裝爲統一的工具集，提供歸一化輸出結果和 API Key 持久化管理能力，使滲透測試流程可以直接通過自然語言驅動。

核心能力¶

該插件提供以下主要功能：

五平臺統一搜索：支持 FOFA、Shodan、鷹圖 Hunter、ZoomEye、Quake。
單 IP 測繪詳情：查詢指定 IP 在各平臺上的詳細指紋信息。
聚合統計：對查詢結果進行字段層面的聚合分析。
賬戶與配額查詢：查詢各平臺的賬戶餘額、剩餘積分等狀態。
Shodan DNS 工具：提供批量域名解析（域名→IP）和子域枚舉（A/CNAME 記錄）。
API Key 持久化管理：支持憑證庫存儲與刪除，支持環境變量引用。
歸一化輸出：統一輸出字段包括 ip、端口、協議、域名、標題、banner、證書、地理信息、組件及風險等級。
零運行時依賴：僅依賴 DSH 沙箱能力（ctx.shell 和 web.fetch），無額外 npm 依賴。
沙箱友好：支持自定義 Header（如 ZoomEye API-KEY）和 POST 請求體（如 Quake X-QuakeToken）。
併發與取消：聲明爲併發安全工具，支持調用方通過 exec.signal 取消執行。

安裝與前置要求¶

安裝該插件僅需一條命令。它是一個 DSH bundle 插件，安裝後會在當前會話或全局裝配樹中註冊對應的工具。

O3SET/dsh-mapscan

前置要求：
* DeepSeek Harness：版本需滿足 >= 0.1.7-rc.2。
* 零運行時依賴：插件本體不依賴外部 Node.js 庫，構建與運行僅使用 DSH 提供的沙箱能力。

配置與使用¶

使用前需要配置各平臺的 API Key。插件支持將 Key 寫入憑證庫，或通過環境變量引用。

1. 配置 API Key¶

通過 map_set_keys 工具設置 Key。平臺參數（platform）可省略，系統會自動路由到已填寫 Key 的平臺。

// 配置 FOFA 和 Shodan 的 Key
map_set_keys { "fofa": "你的Key", "shodan": "你的Key" }

2. 統一搜索¶

使用 map_search 進行搜索。同樣支持省略 platform 參數以進行多平臺聯合搜索。

// 搜索 CN 地區的 Nginx
map_search { 
    "platform": "fofa", 
    "query": "app=\"nginx\" && country=\"CN\"", 
    "size": 20 
}

// Shodan 搜索示例
map_search { 
    "platform": "shodan", 
    "query": "nginx port:443 country:CN" 
}

3. 單 IP 詳情與統計¶

查詢具體資產信息或進行數據聚合。

// 查詢單個 IP 的詳情（自動並行查詢已填 Key 的平臺）
map_ip_detail { "platform": "shodan", "ip": "1.1.1.1" }

// 聚合統計（自動統計已填 Key 的平臺）
map_stats { 
    "platform": "fofa", 
    "query": "app=\"nginx\"", 
    "fields": "title,port" 
}

4. 賬戶查詢¶

查看當前配置的各平臺賬戶狀態。

map_account { "platform": "fofa" }

沙箱與運行特性¶

由於僅使用 DSH 沙箱能力，該插件在隔離環境中運行更爲安全。

併發執行：工具聲明瞭 isConcurrencySafe，支持併發調用。
調用方取消：支持轉發 exec.signal 到底層 shell 請求，用戶中斷時進程可終止。
零運行時依賴：沒有 node_modules 依賴，安裝體積小，加載快。
沙箱友好：支持 HTTP 請求頭（Header）和 POST 數據的自定義配置，滿足不同平臺的鑑權需求。

注意事項¶

Config Schema：插件配置項必須符合 schemastery schema 規範。
持久化範圍：Key 的寫入與存儲僅在本機迴環地址下進行。
參數自動路由：當 platform 參數省略時，工具僅對已填寫 API Key 的平臺生效，未填寫的平臺會自動跳過。

總結¶

o3set/dsh-mapscan 爲 DSH 用戶提供了統一的網絡空間測繪接口。通過將五個主流測繪平臺的差異封裝在內部，用戶只需關注通用的搜索語法和結果解析，即可完成從資產發現、詳情查詢到統計分析的完整工作流。其零依賴和沙箱友好的特性使其適合在各類安全測試環境中使用。

項目主頁：https://github.com/O3SET/dsh-mapscan
生態收錄：https://www.skillhub.cn/plugins/O3SET/dsh-mapscan