DeepSeek Harness 插件：dsh-daiyi-aimy-skill

前言¶

DeepSeek Harness（DSH）的插件生態通過 Cordis 架構將各類能力以模塊形式注入會話。在安全與滲透測試場景中，模型需要訪問目標網絡、執行偵察與漏洞檢測，但直接暴露網絡接口會帶來授權邊界不清、請求失控等風險。dsh-daiyi-aimy-skill 在此基礎上提供了「授權範圍內」的偵察與 Web 漏洞檢測能力：8 個原生工具 + 8 個技能，默認拒絕任何網絡訪問，只做檢測，零運行時依賴。

插件定位¶

dsh-daiyi-aimy-skill 是 Python CLI 工具 aimy-sikll v2.0.0 的 DeepSeek Harness Cordis 插件再開發版。它把上游命令行腳本改造爲宿主內常駐的原生工具，並加上了「授權範圍護欄」：沒有登記授權範圍時，任何網絡工具都不會執行。插件形態爲 ESM Cordis 插件，運行時僅使用 Node 內置模塊，不依賴第三方 HTTP 庫或安全框架。

插件由戴億維護，版本 3.0.0，採用 MIT 許可證。

核心能力¶

8 個模型可調用工具¶

插件提供 8 個工具供模型直接調用，覆蓋偵察、檢測、審計與報告全流程：

aimy_scope：登記 / 查看 / 移除 / 清空授權範圍，試判目標是否放行（本身不需要授權範圍）。
aimy_recon：DNS、HTTP 基線、安全響應頭、技術棧指紋、robots.txt 偵察。
aimy_port_scan：TCP 端口連通性探測（僅握手），高危端口暴露告警。
aimy_dir_fuzz：路徑/目錄枚舉，軟 404 基線過濾，敏感路徑告警。
aimy_crawl：同源爬取：頁面、鏈接、表單、參數、JS 接口路徑。
aimy_web_scan：一次跑一組 Web 檢測，支持 12 類檢查項。
aimy_jwt_audit：離線 JWT 審計：算法、弱密鑰、聲明、外部密鑰源（純本地）。
aimy_report：彙總、列發現、導出 Markdown / JSON / SARIF（純本地）。

默認拒絕與授權護欄¶

任何網絡目標必須先通過 aimy_scope 登記，未登記直接拒絕並提示下一步。登記時需提供授權說明（≥ 8 字符），支持 host、host:port、scheme、*. 通配子域、路徑前綴與過期時間。範圍變更會寫入審計日誌，迴環/內網地址默認禁止訪問。所有網絡請求經過 lib/http.js 護欄探針，逐請求校驗 scope、預算、超時、響應體截斷與重定向複檢。

12 個檢測模塊 + 3 個偵察模塊¶

檢測模塊覆蓋常見 Web 漏洞類型：SQL 注入、XSS、命令注入、服務器端模板注入、SSRF、非 SQL 注入、本地文件包含、CORS、JWT 審計、GraphQL、協議污染、HTTP 頭部檢查。偵察模塊提供爬蟲、參數挖掘、技術棧指紋能力。端口與目錄枚舉在工具層實現。

8 箇中文技能¶

技能是方法指導，不會自動執行工具，也不能繞過 aimy_scope：

aimy-authorized-scope：會話開始、切換/擴大目標或工具返回 NO_SCOPE / NO_MATCH / EXPIRED / PRIVATE_BLOCKED 時加載。
aimy-recon-workflow：範圍已登記，需要摸清域名、端口、目錄、頁面、參數與技術棧時加載。
aimy-web-vuln-triage：已有帶參數的 URL，需要判定 Web 漏洞真僞與定級時加載。
aimy-auth-and-jwt：目標有登錄態、Bearer token、JWT，或要驗證會話與對象級授權時加載。
aimy-api-and-graphql：存在 /api、/graphql、/swagger 等接口面時加載。
aimy-finding-report：一輪檢測結束，需要出報告或給 CI 出 SARIF 時加載。
aimy-rookie-mode：新手、生產環境，或 mode=rookie 時加載。
aimy-veteran-mode：授權明確、預發/靶場，需要更高覆蓋與鏈式驗證時加載。

三種報告格式與零運行時依賴¶

報告支持 Markdown、JSON、SARIF 三種格式，默認對疑似憑據脫敏。插件不依賴 requests 等第三方 HTTP 庫，僅使用 Node 內置模塊，宿主提供 dsh-tools 與 dsh-skill 作爲輔助。插件無 UI 面板，只提供工具、技能與報告文件。

只做檢測¶

插件不提供反彈 shell、反序列化利用鏈、SSRF 橫向、OOB 帶外回連、WAF 繞過、數據提取、憑據攻擊、MITM 憑據捕獲等武器化能力。所有檢測基於響應差異啓發式，存在誤報漏報，結論必須由有授權的人類複覈。

安裝與啓用¶

前置環境：DSH 桌面端 >=0.2.0-rc.1 <0.3.0，Node ^22.19 || >=24。插件沒有構建步驟，也沒有運行時依賴。

方式 A：用 DSH 插件管理器（推薦）¶

打開 DSH 桌面端「設置 → 插件」，用插件管理器安裝：

本地目錄：選擇本倉庫目錄（含 package.json 與 cordis.patch.yml）。
git 倉庫：填 https://github.com/DaiYiqq/dsh-daiyi-aimy-skill。

安裝後插件管理器的 reconcile 會讀取本包的 dsh.bundle.patch，把 cordis.patch.yml 的 insert 項（id: daiyi-aimy-skill）寫入 profile。

方式 B：手動放進插件目錄¶

把本目錄放到 DSH 插件目錄下（例如 ~/.dsh/plugins/dsh-daiyi-aimy-skill）。
在 profile 的 package.json 的 dependencies 中加入：

   {
     "dsh-daiyi-aimy-skill": "file:~/dsh/plugins/dsh-daiyi-aimy-skill"
   }

file: 後面寫本機絕對路徑；上面的 ~/... 只是示意。
3. 在 profile 目錄執行 pnpm install。
4. 重啓 / 重新加載 DSH。插件管理器 reconcile 時會因爲本包聲明瞭 dsh.bundle.patch，把包名加入 dsh.profile.bundles。

安裝成功後，會話裏能看到 8 個 aimy_* 工具，技能目錄裏出現 8 個 aimy-* 技能。

典型用法¶

下面是一個 5 行快速流程示例，展示了從授權登記到偵察、爬取、檢測與報告的完整鏈路：

// 第 1 步：登記授權範圍——不登記，後面所有網絡工具都會拒絕
aimy_scope(action="add", target="example.com", authorization="客戶授權函 #A-1024，範圍 example.com 全站", expiresInHours=72)
aimy_recon(target="https://example.com")
aimy_crawl(target="https://example.com/", maxPages=10)
aimy_web_scan(target="https://example.com/search?q=test", checks=["xss", "sqli"])
aimy_report(action="report", format="md", outputPath="reports/example-com.md")

工具返回的結構化結果包含 target、checks、skipped、params、findings、requests、notes 等字段。findings 中每條包含 module、checkId、title、severity、confidence、url、param、payload、evidence、cwe、remediation 等信息，便於模型直接輸出或寫入報告。

配置與模式¶

插件配置來自 cordis.patch.yml 的 config，與默認值合併；非法值回退默認並記錄 warning。主要配置項包括：

mode：rookie 或 veteran，默認 rookie。影響請求預算、payload 激進度與超時時間，不放寬授權邊界。
persistScope：是否把授權範圍寫入磁盤，默認 true。
scopeFile：授權範圍文件路徑，默認 <DSH_HOME>/daiyi-aimy-skill/scope.json。
timeoutMs：單請求超時，rookie 模式 8000ms，veteran 模式 12000ms，上限 60000ms。
maxRequests：單次工具調用請求預算，rookie 24，veteran 60，上限 400。
concurrency：併發上限，rookie 4，veteran 8，上限 32。
maxBodyBytes：響應體上限 262144 字節（4 MiB）。
followRedirects：是否跟隨重定向，默認 false。
maxRedirects：跟隨時的最大跳數，默認 3。
userAgent：默認 UA，目標可識別測試來源。
allowPrivateNetworks：是否允許登記/訪問迴環與內網地址，默認 false。
redactSecrets：報告中對疑似憑據脫敏，默認 true。
maxFindings：內存中最多保留的 finding 數，默認 800。
maxRuns：內存中最多保留的運行記錄數，默認 60。

配置示例：

- insert:
    - id: daiyi-aimy-skill
      name: dsh-daiyi-aimy-skill
      config:
        mode: rookie
        persistScope: true

適用場景與注意¶

dsh-daiyi-aimy-skill 適合已獲得書面授權的目標，用於自動化偵察、漏洞檢測與報告生成。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。

插件不承諾檢出率，檢測基於響應差異啓發式，存在誤報漏報。所有網絡請求均經過授權護欄，範圍必須明確、可追溯。插件不保存憑據，不提供武器化能力，僅作爲檢測輔助工具。

小結¶

dsh-daiyi-aimy-skill 爲 DeepSeek Harness 提供了一套「授權範圍內」的偵察與 Web 漏洞檢測能力：8 個原生工具、8 箇中文技能、默認拒絕的授權護欄、單一網絡出口、三種報告格式，且零運行時依賴。它通過 deny-by-default 的設計，把網絡接口控制在授權邊界內，適合需要安全合規的滲透測試與自動化安全評估場景。

目錄頁：https://www.skillhub.cn/plugins/DaiYiqq/dsh-daiyi-aimy-skill
GitHub：https://github.com/DaiYiqq/dsh-daiyi-aimy-skill