授权侦察检测 DaiYiqq/dsh-daiyi-aimy-skill

dsh-daiyi-aimy-skill

简体中文 · English ·繁體中文 ·

为 DeepSeek Harness 提供「授权范围内」的侦察与 Web 漏洞检测能力：8 个原生工具 + 8 个技能，默认拒绝，只做检测。

dsh-daiyi-aimy-skill 是 zxz0119/aimy-sikll（Python CLI，v2.0.0）的 DeepSeek Harness（DSH）Cordis 插件再开发版。它把上游的命令行脚本改造成宿主内常驻的原生工具，并加上了上游没有的授权范围护栏：没有登记授权范围时，任何网络工具都不会执行。

- 形态：ESM Cordis 插件，运行时零第三方依赖（只用 node: 内置模块）。
- 宿主：DSH >=0.2.0-rc.1 <0.3.0；Node ^22.19 || >=24。
- 版本：3.0.0，MIT，作者 戴亿。

特性

| 特性 | 说明 |
| 8 个模型可调用工具 | 范围管理、侦察、端口、目录、爬虫、Web 检测、JWT 审计、报告 |
| 默认拒绝（deny-by-default） | 任何网络目标必须先 aimy_scope 登记，未登记直接拒绝并提示下一步 |
| 授权依据与审计 | 登记必须写授权说明（≥ 8 字符），范围可设过期时间，变更写审计日志 |
| 12 个检测模块 + 3 个侦察模块 | 检测：sqli / xss / cmdi / ssti / ssrf / nosqli / lfi / cors / jwt / graphql / proto-pollution / headers；侦察：crawler / param-miner / tech-fingerprint。端口与目录枚举在工具层实现 |
| 单一网络出口 | 所有请求经 lib/http.js 护栏探针：逐请求 scope 校验、预算、超时、响应体截断、重定向复检 |
| 8 个中文技能 | 授权范围、侦察、Web 判定、认证与 JWT、API 与 GraphQL、报告、菜鸟模式、老鸟模式 |
| 三种报告格式 | Markdown / JSON / SARIF，报告默认脱敏 |
| 零运行时依赖 | 不用 requests、不用第三方 HTTP 库；宿主提供 dsh-tools 与 dsh-skill |
| 只做检测 | 不提供反弹 shell、反序列化利用链、SSRF 横向、OOB 带外、WAF 绕过等武器化能力 |
| 无 UI 面板 | 只提供工具、技能与报告文件；没有图形界面 |

安装

前置：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：手动放进插件目录

1. 把本目录放到 DSH 插件目录下（例如 ~/.dsh/plugins/dsh-daiyi-aimy-skill）。
2. 在 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": "https://example.com/search?q=test",
"checks": ["xss", "sqli"],
"skipped": [],
"params": [{ "name": "q", "location": "query", "sample": "test" }],
"findings": [
{
"module": "xss",
"checkId": "xss-reflected",
"title": "反射型 XSS（HTML 上下文）", "severity": "high", "confidence": "high", "url": "https://example.com/search?q=test", "param": "q", "payload": "aimy1337alert(1)", "evidence": "参数 q 在 HTML 上下文原样回显；payload「…」未编码出现在响应中。响应 200，片段：…", "cwe": "CWE-79", "remediation": "按输出上下文做 HTML/属性/JS 编码，使用白名单过滤，并配置 CSP 作为纵深防御。"
}
],
"requests": 9,
"notes": ["runId=run-1a2b3c4d", "模式=rookie"]
}

上面的 finding 仅用于展示字段形状，不代表 example.com 真的存在该问题。实际返回以你的目标与配置为准。

工具

| 工具 | 作用 | 需要授权范围 |
| aimy_scope | 登记 / 查看 / 移除 / 清空授权范围，试判目标是否放行 | 否（闸门本身） |
| aimy_recon | DNS、HTTP 基线、安全响应头、技术栈指纹、robots.txt | 是 |
| aimy_port_scan | TCP 端口连通性探测（仅握手），高危端口暴露告警 | 是 |
| aimy_dir_fuzz | 路径/目录枚举，软 404 基线过滤，敏感路径告警 | 是 |
| aimy_crawl | 同源爬取：页面、链接、表单、参数、JS 接口路径 | 是 |
| aimy_web_scan | 一次跑一组 Web 检测（12 类 checks，见文档） | 是 |
| aimy_jwt_audit | 离线 JWT 审计：算法、弱密钥、声明、外部密钥源 | 否（纯本地） |
| aimy_report | 汇总、列发现、导出 Markdown / JSON / SARIF | 否 |

完整参数表、返回形状、错误码与限制见 docs/TOOLS.md。

技能

| 技能 | 何时加载 |
| 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 | 授权明确、预发/靶场，需要更高覆盖与链式验证时 |

技能是方法指导，不会自动执行工具，也不能绕过 aimy_scope。

与上游的升级对照

| 维度 | 上游 aimy-sikll v2.0.0 | 本插件 v3.0.0 |
| 形态 | Python CLI，python main.py <子命令> | DSH Cordis 插件，模型直接调用工具 |
| 授权 | 输入目标即探测 | deny-by-default，先登记范围再探测 |
| 网络出口 | 各模块各自用 requests | 唯一护栏探针，逐请求 scope 校验 |
| 输出 | 终端 JSON 文本 | 结构化返回值 + 三种格式报告 |
| 依赖 | requests 等 | 零运行时第三方依赖 |
| 会话 | .pkl 会话文件 | 无状态，不保存凭据 |
| 并发 | 线程池 | 受控并发 + 请求预算 + 取消 |
| 武器化 | 有（反弹 shell、拖库、横向等） | 不提供，对应模块不移植 |
| 技能 | 101 份 Markdown | 精选重写为 8 个可执行 playbook |

34 个上游模块的逐项处置（移植 / 合并 / 只吸收部分 / 不移植及原因）与 CLI 命令对照见 docs/MIGRATION.md。

配置

配置来自 cordis.patch.yml 的 config，与默认值合并；非法值回退默认并记录 warning。

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

| 配置项 | 类型 | 默认 | 说明 |
| mode | rookie \| veteran | rookie | 运行模式；只影响预算与 payload 激进度，不放宽授权边界 |
| persistScope | boolean | true | 是否把授权范围写入磁盘；false 时仅进程内存、重启失效 |
| scopeFile | string | <DSH_HOME>/daiyi-aimy-skill/scope.json | 授权范围文件路径 |
| timeoutMs | number | 8000（rookie）/ 12000（veteran） | 单请求超时，上限 60000 |
| maxRequests | number | 24 / 60 | 单次工具调用请求预算，上限 400 |
| concurrency | number | 4 / 8 | 并发上限，上限 32 |
| maxBodyBytes | number | 262144 | 响应体上限，最大 4 MiB |
| followRedirects | boolean | false | 默认不跟随重定向 |
| maxRedirects | number | 3 | 跟随时的最大跳数 |
| userAgent | string | dsh-daiyi-aimy-skill/3.0.0 (...) | 默认 UA，目标可识别测试来源 |
| allowPrivateNetworks | boolean | false | 是否允许登记/访问回环与内网地址 |
| redactSecrets | boolean | true | 报告中对疑似凭据脱敏 |
| maxFindings | number | 800 | 内存中最多保留的 finding 数 |
| maxRuns | number | 60 | 内存中最多保留的运行记录数 |

安全与合规

- 只做检测：不提供反弹 shell、反序列化利用链、SSRF 横向、OOB 带外回连、WAF 绕过、数据提取、凭据攻击、MITM 凭据捕获。
- 默认拒绝：没有授权范围时，所有网络工具直接拒绝；范围必须写明授权依据。
- 范围可约束：支持 host、host:port、scheme、. 通配子域、路径前缀与过期时间；回环/内网默认禁止。
- 不保存凭据：插件不持久化 token/cookie/登录态；范围文件不记录凭据。
- 不承诺检出率：检测基于响应差异启发式，存在误报漏报；结论必须由有授权的人类复核。
- 合法使用：仅用于已获书面授权的目标。未授权探测、数据提取、持久化访问、拒绝服务等均被禁止，也不在插件能力范围内。

完整授权模型、匹配规则与漏洞报告渠道见 docs/SECURITY.md。

发现插件自身安全问题：请优先通过 GitHub Security Advisory 或邮件 1703205607@qq.com 私下联系，修复前请勿公开细节。

目录结构

dsh-daiyi-aimy-skill/
├── lib/
│ ├── index.js # 插件入口：name / inject / apply │ ├── config.js # 配置归一化与模式预算 │ ├── scope.js # 授权范围：解析、匹配、持久化、审计 │ ├── http.js # 护栏 HTTP 探针（唯一网络出口） │ ├── store.js # Finding 存储、去重、运行记录 │ ├── report.js # Markdown / JSON / SARIF 渲染 │ ├── tools/ # 8 个模型可调用工具 │ ├── engine/ # 12 个检测模块 + 3 个侦察模块 + 注册表 │ └── skills/ # 技能加载器 ├── skills/ # 8 个 aimy- 技能（SKILL.md） ├── docs/ # TOOLS / MIGRATION / SECURITY / ARCHITECTURE / CONTRACT ├── scripts/ # validate-plugin.mjs 契约校验 ├── test/ # 契约测试、引擎测试、技能测试 ├── cordis.patch.yml ├── package.json ├── README.md # 简体中文（主语言） ├── README.en.md # English ├── README.zh-TW.md # 繁體中文 ├── README.ja.md # 日本語 ├── CHANGELOG.md └── LICENSE

开发与测试

要求 Node ^22.19 || >=24。零第三方依赖，因此不需要 npm install。

npm run check # 契约校验 + 全仓语法检查
npm test # node --test "test/*/.test.js"（递归）
npm run verify # check + test（CI 跑的就是这一条）

单独校验某个文件：

node --check lib/http.js
node --test test/engine/sqli.test.js

CI：.github/workflows/ci.yml，ubuntu-latest + Node 24，只跑 npm run verify，不做额外安装。

更多设计说明见 docs/ARCHITECTURE.md；新增检测模块的步骤也在那里。

许可证

MIT © 2026 戴亿 <1703205607@qq.com>

上游项目 aimy-sikll 同为 MIT 许可证；本插件是独立再开发，不是上游的官方发行版。