dsh-daiyi-aimy-skill
为 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：手动放进插件目录
把本目录放到 DSH 插件目录下（例如
~/.dsh/plugins/dsh-daiyi-aimy-skill）。在 profile 的
package.json的dependencies中加入：{ "dsh-daiyi-aimy-skill": "file:~/dsh/plugins/dsh-daiyi-aimy-skill" }file:后面写本机绝对路径；上面的~/...只是示意。在 profile 目录执行
pnpm install。重启 / 重新加载 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": "aimy1337<script>alert(1)</script>",
"evidence": "参数 q 在 HTML 上下文原样回显；payload「…」未编码出现在响应中。响应 200，片段：<div>…</div>",
"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 许可证；本插件是独立再开发，不是上游的官方发行版。
No comments yet. Be the first to write one.