@jshookmcp/jshook 0.1.8 → 0.1.9

package/README.zh.md

@@ -1,7 +1,7 @@
 # @jshookmcp/jshook
 
 [![License: AGPLv3](https://img.shields.io/badge/License-AGPLv3-red.svg)](LICENSE)
-[![Node.js >= 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
+[![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6.svg)](https://www.typescriptlang.org/)
 [![MCP](https://img.shields.io/badge/MCP-current-8A2BE2.svg)](https://modelcontextprotocol.io/)
 [![pnpm](https://img.shields.io/badge/pnpm-10.x-F69220.svg)](https://pnpm.io/)
@@ -10,889 +10,51 @@
 
 面向 AI 辅助 JavaScript 分析与安全分析的 MCP（模型上下文协议）服务器，提供 **245 个内置工具**——其中 **16 个域下 238 个域工具**，外加 **8 个内置元工具**——并支持从 `plugins/` 与 `workflows/` 目录运行时动态扩展。集成浏览器自动化、Chrome DevTools Protocol 调试、网络监控、智能 JavaScript Hook、LLM 驱动代码分析、进程/内存操作、WASM 工具链、二进制编码、反反调试、GraphQL 发现、Source Map 重建、AST 变换、加密重构、平台包分析、Burp Suite / Native 分析工具桥接及高层复合工作流编排。
 
-## 从这里开始
+## 文档与快速导航
 
-- **文档首页**：<https://vmoranv.github.io/jshookmcp/>
+- **[📖 阅读官方文档](https://vmoranv.github.io/jshookmcp/)**
+- **[🚀 快速开始](https://vmoranv.github.io/jshookmcp/guide/getting-started.html)**
+- **[⚙️ 配置指南](https://vmoranv.github.io/jshookmcp/guide/configuration.html)**
+- **[📚 API 与工具参考](https://vmoranv.github.io/jshookmcp/reference/)**
 
-## 功能特性
-
-<details>
-<summary>展开完整功能清单</summary>
-
-- **浏览器自动化** — 启动 Chromium/Camoufox、页面导航、DOM 交互、截图、Cookie 与存储管理
-- **CDP 调试器** — 断点设置、单步执行、作用域变量检查、监视表达式、会话保存/恢复
-- **网络监控** — 请求/响应捕获、URL/方法过滤、响应体获取、`offset+limit` 分页访问
-- **性能追踪** — Chrome Performance Trace 录制、CPU Profile、堆分配采样（CDP Tracing/Profiler 域）
-- **JS 堆搜索** — 浏览器运行时 CE（Cheat Engine）等价工具：快照 V8 堆并按模式搜索字符串值
-- **Auth 提取** — 自动扫描已捕获请求的 Authorization 头、Bearer/JWT 令牌、Cookie 和查询参数凭据，带置信度评分
-- **HAR 导出 / 请求重放** — 导出 HAR 1.2 流量；重放任意请求，支持请求头/Body/方法覆盖，内置 SSRF 安全防护
-- **Tab 工作流** — 多标签页协调：命名别名绑定、跨标签共享 KV 上下文
-- **复合工作流** — 单次调用编排工具（`web_api_capture_session`、`register_account_flow`、`api_probe_batch`、`js_bundle_search`），将导航、DOM 操作、网络捕获和 Auth 提取链式合并为原子操作
-- **脚本库** — 命名可复用 JS 片段（`page_script_register` / `page_script_run`），内置分析预设
-- **渐进工具发现** — 基于 BM25 的 `search_tools` 元工具可按关键字搜索“内置工具 + 当前已加载扩展工具”（总数动态变化）；`activate_tools` / `deactivate_tools` 按名激活/停用单个工具；`activate_domain` 批量激活整个域；`boost_profile` / `unboost_profile` 档位级升降级，支持 TTL 自动过期
-- **JavaScript Hook** — AI 生成任意函数 Hook，20+ 内置预设（eval、crypto、atob、WebAssembly 等），并支持 inline 自定义模板
-- **代码分析** — 反混淆（JScrambler、JSVMP、Packer）、加密算法检测、LLM 驱动代码理解
-- **WASM 工具链** — 通过 wabt/binaryen/wasmtime 实现 WebAssembly 模块的 Dump、反汇编、反编译、检查、优化与离线执行
-- **WebSocket 与 SSE 监控** — 实时帧捕获、连接追踪、SSE 事件拦截
-- **二进制编码** — 格式检测、熵分析、Protobuf 原始解码、MessagePack 解码、base64/hex/URL 编解码
-- **反反调试** — 绕过 debugger 语句、定时检测、堆栈跟踪检测、console 开发者工具检测
-- **GraphQL** — 内省查询、网络流量 Query 提取、操作重放
-- **调用图分析** — 从页面内追踪记录生成运行时函数调用图
-- **脚本替换** — 通过 CDP 请求拦截实现持久脚本响应替换
-- **Source Map** — 自动发现、VLQ 解码（纯 TS，无 npm 依赖）、项目树重建
-- **Chrome 扩展** — 列出已安装扩展、在扩展 Background 上下文执行代码
-- **AST 变换** — 常量折叠、字符串解密、死代码删除、控制流展开、变量重命名（纯正则，无 babel）
-- **加密重构** — 提取独立加密函数、worker_threads 沙箱测试、实现对比
-- **平台工具** — 小程序包扫描/解包/分析、Electron ASAR 提取、Electron 应用检查
-- **外部工具桥接** — Frida 脚本生成与 Jadx 反编译集成（桥接模式，用户自行安装外部工具）
-- **Burp Suite 桥接** — 代理状态、请求拦截重放、HAR 导入/对比、发送 Repeater；端点仅允许回环地址并具备 SSRF 防护
-- **Native 分析工具桥接** — Ghidra 与 IDA Pro 桥接：函数反编译、符号查询、脚本执行、交叉引用分析；端点仅允许回环地址并具备 SSRF 防护
-- **CAPTCHA 处理** — AI 视觉检测、手动验证流程、可配置轮询
-- **隐身注入** — 针对无头浏览器指纹识别的反检测补丁
-- **进程与内存** — 跨平台进程枚举、带结构化 diagnostics 的内存读写/扫描、内存操作审计导出、默认关闭的 DLL/Shellcode 注入（Windows）、Electron 应用附加
-- **性能优化** — 智能缓存、Token 预算管理、代码覆盖率、渐进工具披露与按域懒初始化、BM25 搜索发现（search 档位初始化仅约 800 token，full 档位约 18K token）
-- **域自发现** — 运行时清单扫描（`domains/*/manifest.ts`）替代硬编码导入；添加新工具域只需创建一个 `manifest.ts` 文件，无需修改任何中心注册代码
-- **安全防护** — Bearer 令牌认证（`MCP_AUTH_TOKEN`）、Origin CSRF 防护、逐跳 SSRF 校验、symlink 安全路径处理、PowerShell 注入防护、外部工具安全执行
-
-</details>
-
-## 架构
-
-<details>
-<summary>展开架构说明</summary>
-
-基于 `@modelcontextprotocol/sdk` v1.27+ 的 **McpServer 高层 API** 构建：
-
-- 所有工具通过 `server.registerTool()` 注册，无手动请求处理
-- 工具 Schema 从 JSON Schema 动态构建（输入由各域 handler 验证）
-- **四种工具档位**：`search`（BM25 搜索发现）、`minimal`（快速启动）、`workflow`（端到端 JavaScript 与安全分析）、`full`（全部域）
-- **渐进发现**：`search` 档位暴露 12 个 maintenance 域工具 + 8 个内置元工具；`search_tools` 会同时搜索内置工具与已加载的插件/工作流工具，且 `workflow/full` 档位会提高工作流结果的排序优先级
-- **域自发现**：启动时 registry 通过动态 ESM import 扫描 `domains/*/manifest.ts` — 新域无需修改任何中心文件即可被自动检测
-- **DomainManifest 契约**：每个域导出标准化清单（`kind`、`version`、`domain`、`depKey`、`profiles`、`registrations`、`ensure`）— 档位归属、工具定义和 handler 工厂全部集中在一个文件中
-- **按域懒初始化**：handler 类通过 Proxy 在首次工具调用时实例化，不在 init 阶段创建
-- **过滤绑定**：`createToolHandlerMap` 仅为已选工具绑定 resolver
-- 两种传输模式：**stdio**（默认）和 **Streamable HTTP**（MCP 当前修订版）
-- 能力声明：`{ tools: { listChanged: true }, logging: {} }`
-
-</details>
-
-## 环境要求
-
-- Node.js >= 20
-- npm（用于全局安装）
-- pnpm（仅在需要从源码构建时使用）
-
-## 安装
-
-### 推荐：使用 npx 直接运行
-
-```bash
-npx -y @jshookmcp/jshook
-```
-
-如果你只是想直接运行 MCP 服务，而不想管理全局安装，这是推荐方式。
-
-注意：
-
-- 这是一个 **stdio MCP 服务器**，不是图形界面程序。直接在终端运行时，看不到 UI 是正常的。
-- 它会占用当前终端并等待 MCP 客户端通过 stdin/stdout 握手；如果你只是手动运行看看，表面上会像“没有输出”。
-- 如果你的 MCP 客户端通过 `npx` 启动它，务必显式加 `-y`，否则首次安装确认会把客户端卡住，看起来就像 MCP 握手失败。
-
-版本说明：
-
-- `0.1.7` 在部分 `npx` / MCP 客户端启动链路里有已知打包问题。
-- 这个问题已经在 `0.1.8` 修复。
-- 如果你本地还出现反复提示安装、`initialize response` 握手失败之类的旧症状，可以先强制拉一次修复版：
-
-```bash
-npx -y @jshookmcp/jshook@0.1.8
-```
-
-MCP 客户端示例：
-
-Codex / Claude Code 的 `stdio` 配置可以写成：
-
-```json
-{
-  "mcpServers": {
-    "jshook": {
-      "command": "npx",
-      "args": ["-y", "@jshookmcp/jshook"]
-    }
-  }
-}
-```
-
-### 可选：全局安装
-
-```bash
-npm install -g @jshookmcp/jshook
-```
-
-这会全局安装 `jshook` 和 `jshookmcp` 命令，但对大多数用户来说，优先推荐 `npx`。
-
-### 从源码安装（开发 / 本地调试）
-
-```bash
-pnpm install
-pnpm build
-pnpm run doctor
-```
-
-### 从源码安装（含 Camoufox）
-
-```bash
-pnpm run install:full
-pnpm build
-```
-
-`install:full` 已包含 `pnpm exec camoufox-js fetch`。
-
-### 缓存清理（可选）
-
-```bash
-# Puppeteer 浏览器缓存
-rm -rf ~/.cache/puppeteer
-
-# Camoufox 浏览器缓存
-rm -rf ~/.cache/camoufox
-```
-
-Windows 常见缓存路径：
-
-- `%USERPROFILE%\.cache\puppeteer`
-- `%LOCALAPPDATA%\camoufox`
-
-## 配置
-
-文档站中的独立配置章节见：`docs/guide/configuration.md:1`
-
-如果你是从源码运行，请将 `.env.example` 复制为 `.env` 并填写：
-
-```bash
-cp .env.example .env
-```
-
-如果你是通过全局 npm 包运行，也可以直接在 shell 环境变量或 MCP 客户端配置里传入同样的配置项。
-
-主要配置项（以 `.env.example` 为准）：
-
-| 变量                            | 说明                                                                       | 默认值 / 示例                                                                  |
-| ------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
-| `DEFAULT_LLM_PROVIDER`          | 当前启用的 LLM 提供方：`openai` 或 `anthropic`                             | `openai`                                                                       |
-| `OPENAI_API_KEY`                | OpenAI 兼容接口 API Key                                                    | —                                                                              |
-| `OPENAI_MODEL`                  | OpenAI 兼容模型名                                                          | `gpt-4-turbo-preview`                                                          |
-| `OPENAI_BASE_URL`               | OpenAI 兼容接口 Base URL                                                   | `https://api.openai.com/v1`                                                    |
-| `ANTHROPIC_API_KEY`             | Anthropic API Key                                                          | —                                                                              |
-| `ANTHROPIC_MODEL`               | Anthropic 模型名                                                           | `claude-3-5-sonnet-20241022`                                                   |
-| `PUPPETEER_HEADLESS`            | 是否启用无头浏览器                                                         | `.env.example` 中为 `true`                                                     |
-| `PUPPETEER_TIMEOUT`             | Puppeteer 默认超时（毫秒）                                                 | `30000`                                                                        |
-| `PUPPETEER_EXECUTABLE_PATH`     | 可选浏览器可执行文件路径                                                   | 注释示例                                                                       |
-| `MCP_SERVER_NAME`               | 进程对外公布的服务名                                                       | `jshookmcp`                                                                    |
-| `MCP_SERVER_VERSION`            | 进程对外公布的服务版本                                                     | `.env.example` 中为 `0.1.8`                                                    |
-| `MCP_TOOL_PROFILE`              | 工具档位：`search`、`minimal`、`workflow`、`full`                          | 注释示例：`minimal`                                                            |
-| `MCP_TOOL_DOMAINS`              | 逗号分隔域覆盖；优先级高于 `MCP_TOOL_PROFILE`                              | 注释示例                                                                       |
-| `LOG_LEVEL`                     | 日志级别（`debug`/`info`/`warn`/`error`）                                  | `info`                                                                         |
-| `ENABLE_CACHE`                  | 是否启用磁盘缓存                                                           | `true`                                                                         |
-| `CACHE_DIR`                     | 缓存目录                                                                   | `.cache`                                                                       |
-| `CACHE_TTL`                     | 缓存 TTL（秒）                                                             | `3600`                                                                         |
-| `MAX_CONCURRENT_ANALYSIS`       | 最大并发分析任务数                                                         | `3`                                                                            |
-| `MAX_CODE_SIZE_MB`              | 分析阶段允许的最大代码体积                                                 | `10`                                                                           |
-| `CAPTCHA_SCREENSHOT_DIR`        | CAPTCHA 兜底截图目录                                                       | `./screenshots`                                                                |
-| `MCP_SCREENSHOT_DIR`            | 截图输出根目录（始终限制在项目根下）                                       | 注释示例：`./screenshots/manual`                                               |
-| `MCP_PLUGIN_ROOTS`              | 逗号分隔插件根目录                                                         | 注释示例：`./plugins,./dist/plugins`                                           |
-| `MCP_WORKFLOW_ROOTS`            | 逗号分隔工作流根目录                                                       | 注释示例：`./workflows`                                                        |
-| `MCP_DEFAULT_PLUGIN_BOOST_TIER` | 插件在 boost 时自动注册的默认档位                                          | 注释示例：`full`                                                               |
-| `BURP_MCP_SSE_URL`              | Burp SSE bridge 地址                                                       | 注释示例                                                                       |
-| `BURP_MCP_AUTH_TOKEN`           | Burp SSE bridge 可选认证令牌                                               | 注释示例                                                                       |
-| `ZAP_API_URL`                   | OWASP ZAP REST 接口地址                                                    | 注释示例                                                                       |
-| `ZAP_API_KEY`                   | OWASP ZAP API Key                                                          | 注释示例                                                                       |
-| `GHIDRA_BRIDGE_URL`             | Ghidra bridge 端点                                                         | 注释示例：`http://127.0.0.1:18080`                                             |
-| `IDA_BRIDGE_URL`                | IDA bridge 端点                                                            | 注释示例：`http://127.0.0.1:18081`                                             |
-| `EXTENSION_REGISTRY_BASE_URL`   | `browse_extension_registry` / `install_extension` 使用的扩展 registry 基址 | `https://raw.githubusercontent.com/vmoranv/jshookmcpextension/master/registry` |
-
-代码里还支持一些更高级的运行时选项，但 `.env.example` 默认没有展开，例如 `MCP_PORT`、`MCP_HOST`、`MCP_AUTH_TOKEN`、`MCP_MAX_BODY_BYTES`、`MCP_ALLOW_INSECURE`。
-
-### 档位规则
-
-| 档位       | 包含域                                                                                | 工具数                           | 初始化 Tokens | 占比 |
-| ---------- | ------------------------------------------------------------------------------------- | -------------------------------- | ------------- | ---- |
-| `search`   | maintenance                                                                           | 20（12 个域工具 + 8 个元工具）   | ~3,440        | 8%   |
-| `minimal`  | browser, maintenance                                                                  | 80（72 个域工具 + 8 个元工具）   | ~13,760       | 33%  |
-| `workflow` | browser, network, workflow, maintenance, core, debugger, streaming, encoding, graphql | 181（173 个域工具 + 8 个元工具） | ~31,132       | 74%  |
-| `full`     | 全部 16 个域                                                                          | 245（238 个域工具 + 8 个元工具） | ~42,140       | 100% |
-
-> Token 数据为近似值，按此前 `claude /doctor` 的平均 172 tokens/工具估算。所有档位均包含 8 个元工具：`search_tools`、`activate_tools`、`deactivate_tools`、`activate_domain`、`boost_profile`、`unboost_profile`、`extensions_list`、`extensions_reload`。
-
-> 若设置了 `MCP_TOOL_DOMAINS`，优先级高于 `MCP_TOOL_PROFILE`。
-
-### 动态扩展（plugins/workflows）
-
-<details>
-<summary>展开扩展目录、约定与热加载规则</summary>
-
-- 默认扩展目录：
-  - `./plugins`
-  - `./workflows`
-- 可选环境变量覆盖：
-  - `MCP_PLUGIN_ROOTS`（逗号分隔）
-  - `MCP_WORKFLOW_ROOTS`（逗号分隔）
-- 新增元工具：
-  - `extensions_list`：查看已加载扩展（插件/工作流/工具）
-  - `extensions_reload`：运行时重载扩展并动态注册扩展工具
-
-约定：
-
-- 插件文件：`plugins/<plugin-name>/manifest.js|ts`，默认导出 `PluginContract`
-- 工作流文件：`workflows/*.workflow.js|ts` 或 `workflows/**/workflow.js|ts`，默认导出 `WorkflowContract`
-- 执行 `extensions_reload` 后，扩展工具会进入工具列表并可被 `search_tools` 检索
-
-示例：
-
-```bash
-# 基于搜索的渐进发现（推荐用于上下文受限的 LLM）
-MCP_TOOL_PROFILE=search jshook
-
-# 本地轻量模式
-MCP_TOOL_PROFILE=minimal jshook
-
-# 端到端 JavaScript 与安全分析流程
-MCP_TOOL_PROFILE=workflow jshook
-
-# 只启用浏览器+维护工具
-MCP_TOOL_DOMAINS=browser,maintenance jshook
-
-# HTTP 模式 + 认证
-MCP_TRANSPORT=http MCP_AUTH_TOKEN=mysecret jshook
-```
-
-</details>
-
-## MCP 客户端配置
-
-### stdio（默认 — 本地 MCP 客户端）
-
-```json
-{
-  "mcpServers": {
-    "jshook": {
-      "command": "jshook",
-      "env": {
-        "OPENAI_API_KEY": "your-key"
-      }
-    }
-  }
-}
-```
-
-只有在你需要覆盖默认模型或自定义兼容接口时，才需要额外设置 `OPENAI_MODEL` / `OPENAI_BASE_URL`。如果你准备使用图像相关工具（例如 CAPTCHA 视觉识别工作流），再显式指定支持视觉能力的模型即可，不要把它当成所有安装场景的默认配置。
-
-如果你不做全局安装，而是让客户端通过 `npx` 拉起服务，推荐配置成：
-
-```json
-{
-  "mcpServers": {
-    "jshook": {
-      "command": "npx",
-      "args": ["-y", "@jshookmcp/jshook"],
-      "env": {
-        "OPENAI_API_KEY": "your-key"
-      }
-    }
-  }
-}
-```
-
-其中 `-y` 很重要：否则首次安装时 `npx` 会等待交互确认，很多 MCP 客户端无法回答这个提示，表现出来就是握手失败或启动超时。
-
-### Streamable HTTP（远程 / MCP 当前修订版）
-
-```bash
-MCP_TRANSPORT=http MCP_PORT=3000 jshook
-```
-
-连接至 `http://localhost:3000/mcp`。服务器支持：
-
-- `POST /mcp` — 发送 JSON-RPC 请求（返回 JSON 或 SSE 流）
-- `GET /mcp` — 开启 SSE 流
-- `DELETE /mcp` — 关闭会话
-
-会话 ID 通过 `Mcp-Session-Id` 响应头下发。
-
-## 工具域
-
-### 核心 / 分析
-
-<details>
-<summary>LLM 驱动的代码收集、反混淆、加密检测、webpack/source-map 分析</summary>
-
-| #   | 工具                    | 说明                                                   |
-| --- | ----------------------- | ------------------------------------------------------ |
-| 1   | `collect_code`          | 从目标网站收集 JavaScript（摘要/优先级/增量/全量模式） |
-| 2   | `search_in_scripts`     | 按关键字或正则搜索已收集脚本                           |
-| 3   | `extract_function_tree` | 提取函数及其完整依赖树                                 |
-| 4   | `deobfuscate`           | 基于 webcrack 的 JavaScript 反混淆（支持 bundle 解包） |
-| 5   | `understand_code`       | 语义代码分析（结构、行为、风险）                       |
-| 6   | `detect_crypto`         | 识别加密算法与使用模式                                 |
-| 7   | `manage_hooks`          | 创建、查看、清除运行时 Hook                            |
-| 8   | `detect_obfuscation`    | 识别 JavaScript 混淆技术                               |
-| 9   | `advanced_deobfuscate`  | 高级反混淆（webcrack 后端，已废弃的旧标志忽略）        |
-| 10  | `webcrack_unpack`       | 直接调用 webcrack 解包，返回模块图详情                 |
-| 11  | `clear_collected_data`  | 清理收集数据、缓存和内存索引                           |
-| 12  | `get_collection_stats`  | 获取收集/缓存/压缩统计                                 |
-| 13  | `webpack_enumerate`     | 枚举当前页面 webpack 模块；可选关键字搜索              |
-| 14  | `source_map_extract`    | 提取并解析 JavaScript Source Map 还原源码              |
-
-</details>
-
-### 浏览器
-
-<details>
-<summary>浏览器控制、DOM 交互、隐身注入、CAPTCHA、存储、框架工具、JS 堆搜索、多标签工作流</summary>
-
-| #   | 工具                      | 说明                                                       |
-| --- | ------------------------- | ---------------------------------------------------------- |
-| 1   | `get_detailed_data`       | 通过 `detailId` 令牌获取大数据结果（超出上下文限制时返回） |
-| 2   | `browser_launch`          | 启动浏览器（`chrome` 或 `camoufox` 反检测 Firefox）        |
-| 3   | `camoufox_server_launch`  | 启动 Camoufox WebSocket 服务（多进程/远程连接）            |
-| 4   | `camoufox_server_close`   | 关闭 Camoufox WebSocket 服务                               |
-| 5   | `camoufox_server_status`  | 获取 Camoufox WebSocket 服务状态                           |
-| 6   | `browser_attach`          | 通过 CDP WebSocket URL 附加已有浏览器                      |
-| 7   | `browser_close`           | 关闭浏览器实例                                             |
-| 8   | `browser_status`          | 获取浏览器状态（运行中、页面数、版本）                     |
-| 9   | `browser_list_tabs`       | 列出所有打开的标签页                                       |
-| 10  | `browser_select_tab`      | 按索引或 URL/标题模式切换标签页                            |
-| 11  | `page_navigate`           | 导航至 URL（自动 CAPTCHA 检测 + 可选网络监控）             |
-| 12  | `page_reload`             | 刷新当前页面                                               |
-| 13  | `page_back`               | 浏览器后退                                                 |
-| 14  | `page_forward`            | 浏览器前进                                                 |
-| 15  | `dom_query_selector`      | 查询单个 DOM 元素                                          |
-| 16  | `dom_query_all`           | 查询所有匹配 DOM 元素                                      |
-| 17  | `dom_get_structure`       | 获取页面 DOM 结构（超大 DOM 自动返回摘要 + `detailId`）    |
-| 18  | `dom_find_clickable`      | 查找所有可点击元素（按钮、链接）                           |
-| 19  | `dom_get_computed_style`  | 获取元素计算样式                                           |
-| 20  | `dom_find_by_text`        | 按文本内容查找元素                                         |
-| 21  | `dom_get_xpath`           | 获取元素 XPath                                             |
-| 22  | `dom_is_in_viewport`      | 检查元素是否在视口内                                       |
-| 23  | `page_click`              | 点击元素                                                   |
-| 24  | `page_type`               | 输入文本                                                   |
-| 25  | `page_select`             | 选择 `<select>` 下拉选项                                   |
-| 26  | `page_hover`              | 悬停元素                                                   |
-| 27  | `page_scroll`             | 滚动页面                                                   |
-| 28  | `page_press_key`          | 键盘按键                                                   |
-| 29  | `page_wait_for_selector`  | 等待元素出现                                               |
-| 30  | `page_evaluate`           | 在页面上下文执行 JavaScript（大结果返回摘要 + `detailId`） |
-| 31  | `page_screenshot`         | 截取当前页面                                               |
-| 32  | `page_get_performance`    | 获取页面性能指标                                           |
-| 33  | `page_inject_script`      | 向页面注入 JavaScript                                      |
-| 34  | `page_set_cookies`        | 设置页面 Cookie                                            |
-| 35  | `page_get_cookies`        | 获取所有 Cookie                                            |
-| 36  | `page_clear_cookies`      | 清空所有 Cookie                                            |
-| 37  | `page_set_viewport`       | 设置视口大小                                               |
-| 38  | `page_emulate_device`     | 模拟移动设备（iPhone、iPad、Android）                      |
-| 39  | `page_get_local_storage`  | 获取所有 `localStorage`                                    |
-| 40  | `page_set_local_storage`  | 设置 `localStorage` 项                                     |
-| 41  | `page_get_all_links`      | 获取页面所有链接                                           |
-| 42  | `get_all_scripts`         | 获取已加载脚本列表（含 `maxScripts` 上限）                 |
-| 43  | `get_script_source`       | 获取脚本源码（大脚本返回摘要 + `detailId`）                |
-| 44  | `console_enable`          | 启用控制台监控                                             |
-| 45  | `console_get_logs`        | 获取捕获的控制台日志                                       |
-| 46  | `console_execute`         | 在控制台上下文执行 JavaScript                              |
-| 47  | `captcha_detect`          | AI 视觉检测 CAPTCHA                                        |
-| 48  | `captcha_wait`            | 等待手动通过 CAPTCHA                                       |
-| 49  | `captcha_config`          | 配置 CAPTCHA 检测行为                                      |
-| 50  | `stealth_inject`          | 注入反检测脚本绕过 Bot 检测                                |
-| 51  | `stealth_set_user_agent`  | 设置真实 User-Agent 与浏览器指纹                           |
-| 52  | `framework_state_extract` | 提取 React/Vue 组件实时状态                                |
-| 53  | `indexeddb_dump`          | 导出所有 IndexedDB 数据库                                  |
-| 54  | `js_heap_search`          | 搜索 V8 堆中匹配模式的字符串（浏览器 CE 等价工具）         |
-| 55  | `tab_workflow`            | 多标签协调（别名绑定、跨标签导航、KV 共享上下文）          |
-
-</details>
-
-### 调试器
-
-<details>
-<summary>CDP 调试器控制、断点、监视、XHR/事件断点、会话持久化、脚本黑盒</summary>
-
-| #   | 工具                            | 说明                                  |
-| --- | ------------------------------- | ------------------------------------- |
-| 1   | `debugger_enable`               | 启用 CDP 调试器                       |
-| 2   | `debugger_disable`              | 关闭调试器并清除所有断点              |
-| 3   | `debugger_pause`                | 在下一条语句暂停执行                  |
-| 4   | `debugger_resume`               | 恢复执行                              |
-| 5   | `debugger_step_into`            | 步入函数调用                          |
-| 6   | `debugger_step_over`            | 步过函数调用                          |
-| 7   | `debugger_step_out`             | 步出当前函数                          |
-| 8   | `debugger_wait_for_paused`      | 等待调试器暂停                        |
-| 9   | `debugger_get_paused_state`     | 获取当前暂停状态                      |
-| 10  | `debugger_evaluate`             | 在当前调用帧求值                      |
-| 11  | `debugger_evaluate_global`      | 在全局上下文求值                      |
-| 12  | `debugger_save_session`         | 保存调试会话到 JSON 文件              |
-| 13  | `debugger_load_session`         | 加载已保存的调试会话                  |
-| 14  | `debugger_export_session`       | 导出会话 JSON 用于分享                |
-| 15  | `debugger_list_sessions`        | 列出所有已保存的调试会话              |
-| 16  | `breakpoint_set`                | 设置断点（URL 或 scriptId，可选条件） |
-| 17  | `breakpoint_remove`             | 按 ID 移除断点                        |
-| 18  | `breakpoint_list`               | 列出所有活跃断点                      |
-| 19  | `breakpoint_set_on_exception`   | 异常中断 — 全部或仅未捕获             |
-| 20  | `get_call_stack`                | 获取调用栈（暂停时）                  |
-| 21  | `get_object_properties`         | 按 `objectId` 获取对象所有属性        |
-| 22  | `get_scope_variables_enhanced`  | 增强作用域变量检查（深度对象遍历）    |
-| 23  | `watch_add`                     | 添加监视表达式                        |
-| 24  | `watch_remove`                  | 移除监视表达式                        |
-| 25  | `watch_list`                    | 列出所有监视表达式                    |
-| 26  | `watch_evaluate_all`            | 评估所有启用的监视                    |
-| 27  | `watch_clear_all`               | 清空所有监视                          |
-| 28  | `xhr_breakpoint_set`            | 设置 XHR/Fetch 断点                   |
-| 29  | `xhr_breakpoint_remove`         | 移除 XHR 断点                         |
-| 30  | `xhr_breakpoint_list`           | 列出所有 XHR 断点                     |
-| 31  | `event_breakpoint_set`          | 设置事件监听器断点                    |
-| 32  | `event_breakpoint_set_category` | 按事件类别批量设置断点                |
-| 33  | `event_breakpoint_remove`       | 移除事件断点                          |
-| 34  | `event_breakpoint_list`         | 列出所有事件断点                      |
-| 35  | `blackbox_add`                  | 按 URL 模式黑盒脚本                   |
-| 36  | `blackbox_add_common`           | 一键黑盒所有常见库                    |
-| 37  | `blackbox_list`                 | 列出所有黑盒 URL 模式                 |
-
-</details>
-
-### 网络
-
-<details>
-<summary>CDP 网络监控、性能追踪、CPU/堆 Profile、Auth 提取、HAR 导出、请求重放、控制台注入</summary>
-
-| #   | 工具                                  | 说明                                                                   |
-| --- | ------------------------------------- | ---------------------------------------------------------------------- |
-| 1   | `network_enable`                      | 启用网络请求监控                                                       |
-| 2   | `network_disable`                     | 关闭网络请求监控                                                       |
-| 3   | `network_get_status`                  | 获取网络监控状态                                                       |
-| 4   | `network_get_requests`                | 获取捕获的请求（`offset+limit` 分页；URL 不区分大小写过滤）            |
-| 5   | `network_get_response_body`           | 获取指定请求的响应体                                                   |
-| 6   | `network_get_stats`                   | 获取网络统计                                                           |
-| 7   | `network_extract_auth`                | 扫描所有已捕获请求的 Auth 凭据（置信度评分）                           |
-| 8   | `network_export_har`                  | 导出 HAR 1.2 流量                                                      |
-| 9   | `network_replay_request`              | 重放已捕获请求（支持覆盖；逐跳 DNS 校验 SSRF 防护）                    |
-| 10  | `performance_get_metrics`             | 获取页面 Web Vitals                                                    |
-| 11  | `performance_start_coverage`          | 开始 JS/CSS 代码覆盖率记录                                             |
-| 12  | `performance_stop_coverage`           | 停止覆盖率记录并返回报告                                               |
-| 13  | `performance_take_heap_snapshot`      | 拍摄 V8 堆内存快照                                                     |
-| 14  | `performance_trace_start`             | 开始 Chrome Performance Trace 录制（CDP Tracing 域）                   |
-| 15  | `performance_trace_stop`              | 停止 Performance Trace 并保存 trace 文件                               |
-| 16  | `profiler_cpu_start`                  | 开始 CDP CPU 性能分析                                                  |
-| 17  | `profiler_cpu_stop`                   | 停止 CPU 分析并返回热点函数                                            |
-| 18  | `profiler_heap_sampling_start`        | 开始 V8 堆分配采样                                                     |
-| 19  | `profiler_heap_sampling_stop`         | 停止堆采样并返回 Top 分配源                                            |
-| 20  | `console_get_exceptions`              | 获取捕获的未处理异常                                                   |
-| 21  | `console_inject_script_monitor`       | 注入动态 `<script>` 元素监控器                                         |
-| 22  | `console_inject_xhr_interceptor`      | 注入 XHR 拦截器捕获 AJAX 请求/响应                                     |
-| 23  | `console_inject_fetch_interceptor`    | 注入 Fetch API 拦截器；自动持久化 URL 至 `localStorage.__capturedAPIs` |
-| 24  | `console_clear_injected_buffers`      | 清理注入的页面内缓冲区                                                 |
-| 25  | `console_reset_injected_interceptors` | 重置拦截器以便重新注入                                                 |
-| 26  | `console_inject_function_tracer`      | 注入基于 Proxy 的函数追踪器                                            |
-
-</details>
-
-### Hook
+## 🌟 核心亮点
 
-<details>
-<summary>AI 生成的 JavaScript Hook 和 20+ 内置预设</summary>
+- 🤖 **AI 智能分析**：结合大语言模型实现 JavaScript 语义级反混淆、加密算法识别与深度 AST 结构理解。
+- ⚡ **搜索优先的上下文效率**：BM25 驱动的 `search_tools` 配合动态加权，可将 jshook 内置配置档位中的“工具 schema 增量初始化上下文”从 `full` 档约 ~35.0K tokens 降至 `search` 档约 ~3.0K（Claude 服务端计数；不含 Claude Code 基线提示词）。
+- 🎯 **渐进式能力分层**：内置三档配置（`search`/`workflow`/`full`），默认从 `search` 基座档启动，按需升级能力范围。
+- 🌐 **全链路自动化**：将浏览器环境（Chromium/Camoufox）、CDP 底层调试与网络拦截无缝整合为原子操作。
+- 🛡️ **高级反反调试**：内置强大的指纹伪装与检测绕过补丁，轻松应对各类反爬与调试器对抗保护。
+- 🧩 **动态热插拔扩展**：支持从本地目录动态加载插件与高层工作流，无需重新编译主服务即可无限横向拓展能力。
+- 🔧 **零胶水扩展性**：通过 `manifest.ts` 自动发现域、懒加载处理器实例化、B-Skeleton 契约驱动的插件/工作流架构。
+- 🛠️ **全能逆向工具链**：集成 WASM 反编译、二进制漏洞/熵分析、实时内存扫描，并原生提供 Burp Suite 与 Ghidra/IDA Pro 桥接。
 
-| #   | 工具               | 说明                                 |
-| --- | ------------------ | ------------------------------------ |
-| 1   | `ai_hook_generate` | 为函数、API 或对象方法生成 Hook 代码 |
-| 2   | `ai_hook_inject`   | 将已生成的 Hook 注入页面             |
-| 3   | `ai_hook_get_data` | 获取活跃 Hook 的捕获数据             |
-| 4   | `ai_hook_list`     | 列出所有活跃 Hook                    |
-| 5   | `ai_hook_clear`    | 清除一个或全部 Hook                  |
-| 6   | `ai_hook_toggle`   | 启用或禁用 Hook                      |
-| 7   | `ai_hook_export`   | 导出 Hook 捕获数据（JSON/CSV）       |
-| 8   | `hook_preset`      | 安装 20+ 预设 Hook                   |
-
-**内置预设：** `eval`、`function-constructor`、`atob-btoa`、`crypto-subtle`、`json-stringify`、`object-defineproperty`、`settimeout`、`setinterval`、`addeventlistener`、`postmessage`、`webassembly`、`proxy`、`reflect`、`history-pushstate`、`location-href`、`navigator-useragent`、`eventsource`、`window-open`、`mutationobserver`、`formdata`、`anti-debug-bypass`、`crypto-key-capture`、`webassembly-full`
-
-</details>
-
-### 维护
-
-<details>
-<summary>Token 预算追踪与缓存管理</summary>
-
-| #   | 工具                     | 说明                      |
-| --- | ------------------------ | ------------------------- |
-| 1   | `get_token_budget_stats` | 获取 Token 预算使用统计   |
-| 2   | `manual_token_cleanup`   | 手动触发 Token 预算清理   |
-| 3   | `reset_token_budget`     | 重置所有 Token 预算计数器 |
-| 4   | `get_cache_stats`        | 获取所有内部缓存统计      |
-| 5   | `smart_cache_cleanup`    | 智能清理缓存，保留热数据  |
-| 6   | `clear_all_caches`       | 清空所有内部缓存          |
-
-</details>
-
-### 进程 / 内存 / Electron
-
-<details>
-<summary>进程枚举、内存诊断与审计导出、受控 DLL/Shellcode 注入、Electron 附加</summary>
-
-| #   | 工具                       | 说明                                                                   |
-| --- | -------------------------- | ---------------------------------------------------------------------- |
-| 1   | `process_find`             | 按名称模式查找进程                                                     |
-| 2   | `process_list`             | 列出所有运行进程                                                       |
-| 3   | `process_get`              | 获取特定进程详情                                                       |
-| 4   | `process_windows`          | 获取进程的所有窗口句柄                                                 |
-| 5   | `process_find_chromium`    | 按设计禁用；请改用受管浏览器会话                                       |
-| 6   | `process_check_debug_port` | 检查进程是否启用了调试端口                                             |
-| 7   | `process_launch_debug`     | 以远程调试端口启动可执行文件                                           |
-| 8   | `process_kill`             | 按 PID 结束进程                                                        |
-| 9   | `memory_read`              | 读取进程指定地址的内存；失败时返回 diagnostics                         |
-| 10  | `memory_write`             | 写入进程内存；失败时返回 diagnostics                                   |
-| 11  | `memory_scan`              | 按 hex/值模式扫描进程内存；失败时返回 diagnostics                      |
-| 12  | `memory_check_protection`  | 检查内存保护标志（R/W/X）                                              |
-| 13  | `memory_protect`           | `memory_check_protection` 别名                                         |
-| 14  | `memory_scan_filtered`     | 在已过滤地址集中二次扫描                                               |
-| 15  | `memory_batch_write`       | 批量写入多个内存补丁                                                   |
-| 16  | `memory_dump_region`       | 将内存区域转储为二进制文件                                             |
-| 17  | `memory_list_regions`      | 列出所有内存区域及保护标志                                             |
-| 18  | `memory_audit_export`      | 导出内存操作的内存内审计轨迹                                           |
-| 19  | `inject_dll`               | 默认关闭；需设置 `ENABLE_INJECTION_TOOLS=true` 后在 Windows 启用       |
-| 20  | `module_inject_dll`        | `inject_dll` 别名                                                      |
-| 21  | `inject_shellcode`         | 默认关闭；支持 hex/base64，需设置 `ENABLE_INJECTION_TOOLS=true` 后启用 |
-| 22  | `module_inject_shellcode`  | `inject_shellcode` 别名                                                |
-| 23  | `check_debug_port`         | 检查进程是否被调试                                                     |
-| 24  | `enumerate_modules`        | 列出所有已加载模块（DLL）及基址                                        |
-| 25  | `module_list`              | `enumerate_modules` 别名                                               |
-| 26  | `electron_attach`          | 通过 CDP 连接运行中的 Electron 应用                                    |
-
-> **平台说明：** 内存读写/扫描/转储支持 **Windows**（原生 API）和 **macOS**（lldb + vmmap）。`memory_read`、`memory_write`、`memory_scan` 失败时会返回结构化 `diagnostics`。注入工具默认关闭；需在 Windows 提权后通过 `ENABLE_INJECTION_TOOLS=true` 启用。
-
-</details>
-
-### 工作流
-
-<details>
-<summary>面向全链路 JavaScript 分析与安全分析任务的高层编排</summary>
-
-| #   | 工具                      | 说明                                                         |
-| --- | ------------------------- | ------------------------------------------------------------ |
-| 1   | `web_api_capture_session` | 导航 + 操作 + 收集请求 + Auth 提取 + HAR 导出 — 一次调用完成 |
-| 2   | `register_account_flow`   | 自动化注册：填表、提交、收集 Token、可选邮箱验证标签页       |
-| 3   | `api_probe_batch`         | 在浏览器上下文批量 fetch 探测多个 API（自动注入 Bearer）     |
-| 4   | `js_bundle_search`        | 服务端 fetch + 缓存远程 JS Bundle；多正则搜索 + 噪音过滤     |
-| 5   | `page_script_register`    | 注册命名可复用 JavaScript 片段到会话脚本库                   |
-| 6   | `page_script_run`         | 执行脚本库中的命名脚本（支持运行时 `__params__` 注入）       |
-
-**内置脚本库预设**（无需注册即可通过 `page_script_run` 使用）：
-`auth_extract`、`bundle_search`、`react_fill_form`、`dom_find_upgrade_buttons`
-
-</details>
-
-### WASM
-
-<details>
-<summary>WebAssembly Dump、反汇编、反编译、检查、优化、离线执行、VMP 追踪</summary>
-
-| #   | 工具                    | 说明                                                      |
-| --- | ----------------------- | --------------------------------------------------------- |
-| 1   | `wasm_dump`             | 从当前浏览器页面 Dump WebAssembly 模块                    |
-| 2   | `wasm_disassemble`      | 使用 wasm2wat 反汇编 .wasm 为 WAT（需 wabt）              |
-| 3   | `wasm_decompile`        | 使用 wasm-decompile 反编译 .wasm 为类 C 伪代码（需 wabt） |
-| 4   | `wasm_inspect_sections` | 使用 wasm-objdump 检查段和元数据（需 wabt）               |
-| 5   | `wasm_offline_run`      | 通过 wasmtime/wasmer 离线执行 WASM 导出函数               |
-| 6   | `wasm_optimize`         | 通过 binaryen wasm-opt 优化 .wasm                         |
-| 7   | `wasm_vmp_trace`        | 追踪 WASM VMP opcode 执行（增强插桩）                     |
-| 8   | `wasm_memory_inspect`   | 检查 WebAssembly.Memory 线性内存内容                      |
-
-> **外部依赖：** wabt（`wasm2wat`、`wasm-objdump`、`wasm-decompile`）、binaryen（`wasm-opt`）、wasmtime 或 wasmer。均为可选 — 工具在不可用时会优雅提示。
-
-</details>
-
-### 流式监控
-
-<details>
-<summary>WebSocket 帧捕获与 SSE 事件拦截</summary>
-
-| #   | 工具                 | 说明                                       |
-| --- | -------------------- | ------------------------------------------ |
-| 1   | `ws_monitor_enable`  | 通过 CDP Network 事件启用 WebSocket 帧捕获 |
-| 2   | `ws_monitor_disable` | 关闭 WebSocket 监控并返回捕获摘要          |
-| 3   | `ws_get_frames`      | 获取捕获的 WebSocket 帧（分页 + 正则过滤） |
-| 4   | `ws_get_connections` | 获取追踪的 WebSocket 连接及帧计数          |
-| 5   | `sse_monitor_enable` | 通过 EventSource 构造器拦截启用 SSE 监控   |
-| 6   | `sse_get_events`     | 获取捕获的 SSE 事件（支持过滤与分页）      |
-
-</details>
-
-### 编码
-
-<details>
-<summary>二进制格式检测、熵分析、Protobuf/MessagePack 解码、编解码</summary>
-
-| #   | 工具                      | 说明                                                        |
-| --- | ------------------------- | ----------------------------------------------------------- |
-| 1   | `binary_detect_format`    | 通过魔数、编码启发式和 Shannon 熵检测二进制格式             |
-| 2   | `binary_decode`           | 解码二进制 payload（base64/hex/url/protobuf/msgpack）       |
-| 3   | `binary_encode`           | 将 utf8/hex/json 输入编码为 base64/hex/url 输出             |
-| 4   | `binary_entropy_analysis` | 计算 Shannon 熵 + 字节频率分布                              |
-| 5   | `protobuf_decode_raw`     | 无 Schema 解码 base64 protobuf 字节（线类型感知递归解析器） |
-
-</details>
-
-### 反调试
-
-<details>
-<summary>绕过反调试保护与检测保护技术</summary>
-
-| #   | 工具                                  | 说明                                                                 |
-| --- | ------------------------------------- | -------------------------------------------------------------------- |
-| 1   | `antidebug_bypass_all`                | 注入所有反反调试绕过脚本（双注入：evaluateOnNewDocument + evaluate） |
-| 2   | `antidebug_bypass_debugger_statement` | 通过 Patch Function 构造器绕过 debugger 语句保护                     |
-| 3   | `antidebug_bypass_timing`             | 通过稳定 performance.now / Date.now 绕过定时检测                     |
-| 4   | `antidebug_bypass_stack_trace`        | 通过过滤可疑堆栈帧绕过 Error.stack 检测                              |
-| 5   | `antidebug_bypass_console_detect`     | 绕过基于 console 的开发者工具检测                                    |
-| 6   | `antidebug_detect_protections`        | 检测反调试保护并返回绕过建议                                         |
-
-</details>
-
-### GraphQL / 调用图
-
-<details>
-<summary>GraphQL 内省、Query 提取、操作重放、运行时调用图分析、脚本替换</summary>
-
-| #   | 工具                      | 说明                                           |
-| --- | ------------------------- | ---------------------------------------------- |
-| 1   | `call_graph_analyze`      | 从页面内追踪记录分析运行时函数调用图           |
-| 2   | `script_replace_persist`  | 通过 CDP 请求拦截持久替换脚本响应              |
-| 3   | `graphql_introspect`      | 对目标端点执行 GraphQL 内省查询                |
-| 4   | `graphql_extract_queries` | 从已捕获网络流量中提取 GraphQL 查询/变更       |
-| 5   | `graphql_replay`          | 重放 GraphQL 操作（可选 variables 和 headers） |
-
-</details>
-
-### 桥接器
-
-<details>
-<summary>小程序包工具、Electron ASAR 提取/检查、Frida/Jadx 桥接</summary>
-
-| #   | 工具                   | 说明                                                                     |
-| --- | ---------------------- | ------------------------------------------------------------------------ |
-| 1   | `miniapp_pkg_scan`     | 扫描本地小程序缓存目录查找包文件                                         |
-| 2   | `miniapp_pkg_unpack`   | 解包小程序包文件（外部 CLI 或纯 Node.js 降级）                           |
-| 3   | `miniapp_pkg_analyze`  | 分析解包后小程序结构（页面、子包、组件）                                 |
-| 4   | `asar_extract`         | 提取 Electron app.asar（纯 Node.js，无 @electron/asar 依赖）             |
-| 5   | `electron_inspect_app` | 分析 Electron 应用结构（package.json、main、preload、依赖）              |
-| 6   | `frida_bridge`         | Frida 集成桥接：环境检测、脚本模板生成、使用指南（需外部 frida-tools）   |
-| 7   | `jadx_bridge`          | Jadx 集成桥接：环境检测、APK/DEX/AAR 反编译、使用指南（需外部 jadx CLI） |
-
-> **外部依赖：** `unveilr`（小程序解包器）、`frida`（pip install frida-tools）、`jadx`（Java 反编译器）。均为可选 — 工具在依赖缺失时会优雅处理。
-
-</details>
-
-### Burp Suite 桥接
-
-<details>
-<summary>Burp Suite REST API 集成：代理状态、请求重放、HAR 导入/对比、Repeater 发送</summary>
-
-| #   | 工具                           | 说明                                                |
-| --- | ------------------------------ | --------------------------------------------------- |
-| 1   | `burp_proxy_status`            | 检查 Burp Suite 适配器健康状态与连接情况            |
-| 2   | `intercept_and_replay_to_burp` | 将已捕获请求重放到 Burp 代理或 Repeater             |
-| 3   | `import_har_from_burp`         | 导入并过滤 HAR 条目（URL/方法/状态码过滤）          |
-| 4   | `diff_har`                     | 对比两个 HAR：新增/删除/修改条目及 Header/Body 差异 |
-| 5   | `burp_send_to_repeater`        | 携带自定义头/Body 将 URL 发送到 Burp Repeater       |
-
-> **外部依赖：** Burp Suite + REST API 适配器（或 Burp Suite Pro Extender）。端点必须为回环地址（127.0.0.1 / localhost / ::1）。
-
-</details>
-
-### Native 分析工具桥接
-
-<details>
-<summary>Ghidra 与 IDA Pro 桥接：反编译、符号检索、脚本执行、交叉引用分析</summary>
-
-| #   | 工具                   | 说明                                                                   |
-| --- | ---------------------- | ---------------------------------------------------------------------- |
-| 1   | `native_bridge_status` | 检查 Ghidra 与 IDA 桥接连通性                                          |
-| 2   | `ghidra_bridge`        | Ghidra 集成：打开项目、反编译函数、列符号、查 xrefs、运行脚本          |
-| 3   | `ida_bridge`           | IDA Pro 集成：打开二进制、反编译函数、列符号、查 xrefs、运行 IDAPython |
-| 4   | `native_symbol_sync`   | 在 Ghidra 与 IDA 之间同步符号/类型数据                                 |
-
-> **外部依赖：** Ghidra + `ghidra_bridge` Python 服务、IDA Pro + IDAPython HTTP bridge。端点必须为回环地址（127.0.0.1 / localhost / ::1）。
-
-</details>
-
-### Source Map / 扩展
-
-<details>
-<summary>Source Map 发现、VLQ 解码、项目树重建、Chrome 扩展交互</summary>
-
-| #   | 工具                           | 说明                                                                |
-| --- | ------------------------------ | ------------------------------------------------------------------- |
-| 1   | `sourcemap_discover`           | 通过 CDP Debugger.scriptParsed 事件自动发现页面 Source Map          |
-| 2   | `sourcemap_fetch_and_parse`    | 获取并解析 SourceMap v3（纯 TS VLQ 解码器，无 source-map npm 依赖） |
-| 3   | `sourcemap_reconstruct_tree`   | 从 SourceMap sources + sourcesContent 重建原始项目文件树            |
-| 4   | `extension_list_installed`     | 通过 CDP Target.getTargets 列出已安装的 Chrome 扩展                 |
-| 5   | `extension_execute_in_context` | 通过 Target.attachToTarget 在 Chrome 扩展 Background 上下文执行代码 |
-
-</details>
-
-### 变换 / 加密
-
-<details>
-<summary>AST 风格变换（纯正则）、加密函数提取、沙箱测试、实现对比</summary>
-
-| #   | 工具                        | 说明                                                        |
-| --- | --------------------------- | ----------------------------------------------------------- |
-| 1   | `ast_transform_preview`     | 预览轻量变换（常量折叠、字符串解密、死代码删除等），带 diff |
-| 2   | `ast_transform_chain`       | 创建并存储内存中的命名变换链                                |
-| 3   | `ast_transform_apply`       | 对代码或活动页面 scriptId 应用变换                          |
-| 4   | `crypto_extract_standalone` | 从页面提取加密/签名/加密函数为独立可运行代码                |
-| 5   | `crypto_test_harness`       | 在 worker_threads + vm 沙箱中用测试输入运行提取的加密代码   |
-| 6   | `crypto_compare`            | 使用相同测试向量比较两个加密实现                            |
-
-</details>
-
-### 元工具
-
-<details>
-<summary>展开元工具清单</summary>
-
-| #   | 工具                | 说明                                                                                                                                                                                                                                                          |
-| --- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1   | `search_tools`      | _(元工具)_ BM25 关键字搜索内置工具 + 已加载的插件/工作流工具；在 `workflow/full` 档位下，工作流域结果会获得额外排序加权。若已加载扩展 workflow，`run_extension_workflow` / `list_extension_workflows` 还会获得额外权重（尤其在注册/验证码/keygen 等意图下）。 |
-| 2   | `activate_tools`    | _(元工具)_ 按名称动态注册指定工具（来自搜索结果）                                                                                                                                                                                                             |
-| 3   | `deactivate_tools`  | _(元工具)_ 移除先前激活的工具以释放上下文                                                                                                                                                                                                                     |
-| 4   | `activate_domain`   | _(元工具)_ 一次激活整个域的所有工具（如 `debugger`、`network`）                                                                                                                                                                                               |
-| 5   | `boost_profile`     | _(元工具)_ 升级至更高档位（search → minimal → workflow → full）；TTL 自动过期                                                                                                                                                                                 |
-| 6   | `unboost_profile`   | _(元工具)_ 降级至更低档位并移除 boost 添加的工具                                                                                                                                                                                                              |
-| 7   | `extensions_list`   | _(元工具)_ 列出当前已加载的 `plugins/` / `workflows/` 扩展                                                                                                                                                                                                    |
-| 8   | `extensions_reload` | _(元工具)_ 运行时重新扫描扩展目录并动态注册扩展工具                                                                                                                                                                                                           |
-
-</details>
-
-### 动态扩展（plugins/workflows）
-
-<details>
-<summary>展开扩展根目录、信任策略与放置规范</summary>
-
-- 默认扩展根目录（全局，位于 jshook 安装目录下）：
-  - `<jshook-install>/plugins`
-  - `<jshook-install>/workflows`
-- 可选环境变量覆盖：
-  - `MCP_PLUGIN_ROOTS`（逗号分隔，支持绝对/相对路径）
-  - `MCP_WORKFLOW_ROOTS`（逗号分隔，支持绝对/相对路径）
-- 可选信任策略：
-  - `MCP_PLUGIN_ALLOWED_DIGESTS`（逗号分隔 SHA-256 摘要白名单，导入前校验）
-  - `MCP_PLUGIN_SIGNATURE_REQUIRED=true`（强制要求插件签名）
-  - `MCP_PLUGIN_SIGNATURE_SECRET`（用于签名校验的 HMAC 密钥）
-- 相对路径按服务进程 `cwd`（`process.cwd()`）解析。
-- 根目录会递归扫描。
-
-#### 插件放置规范
-
-- 插件清单文件放在：
-  - `plugins/<plugin-name>/manifest.js`（生产推荐）
-  - `plugins/<plugin-name>/manifest.ts`（也支持）
-- 默认导出 `PluginContract`。
-- 扩展仓建议从 `@jshookmcp/extension-sdk/plugin` 导入插件开发类型与工具函数。
-- 插件可通过 `manifest.contributes` 提供 `DomainManifest` 与 `WorkflowContract`。
-
-#### Workflow 放置规范
-
-- Workflow 文件放在：
-  - `workflows/*.workflow.js` / `workflows/*.workflow.ts`
-  - `workflows/**/workflow.js` / `workflows/**/workflow.ts`
-- 默认导出 `WorkflowContract`。
-- 扩展仓建议从 `@jshookmcp/extension-sdk/workflow` 导入 Workflow 契约与 builder。
-- 发现与去重规则（重要）：
-  - workflow 文件会按“规范化相对目录 key”分组。
-  - 每个 key 在 reload 时只保留一个文件。
-  - 如果把多个文件都放在 `workflows/*.workflow.js` 顶层，最终可能只加载其中一个。
-  - 推荐多 workflow 目录结构：`workflows/<workflow-name>/workflow.js`（或 `workflow.ts`）。
-
-#### 热加载流程（推荐）
-
-1. 按规范放置插件/工作流文件。
-2. 调用 `extensions_reload`。
-3. 检查返回中的 `warnings`、`errors`、`addedTools`、`removedTools`。
-4. 调用 `extensions_list` 与 `search_tools` 验证是否已可见。
-
-- `extensions_reload` 会替换当前已加载扩展（先移除旧扩展，再按目录重建）。
-- 通过 `extensions_reload` 加载的扩展工具会立即进入“可调用 + 可检索”状态。
-- `activate_domain` 只有在执行过 `extensions_reload` 后，才会包含扩展域。
-- reload 时会在可用情况下执行插件清理生命周期（`onDeactivate` → `onUnload`）。
-
-</details>
-
-## 免责声明
-
-- 进程内存修改、代码注入、流量重放等底层能力按现状提供，不附带适用性或结果保证。
-- 通过本地目录或 registry 加载的第三方插件、工作流与扩展，不属于本项目已审计、背书或担保的内容。
-- 是否启用这些内置变更能力或外部扩展，以及因此产生的运行、合规、安全、数据损失等后果，由使用者自行评估并承担。
-
-## 生成产物与清理
-
-| 产物                   | 默认位置                                           | 生成工具                                                           |
-| ---------------------- | -------------------------------------------------- | ------------------------------------------------------------------ |
-| HAR 流量               | `artifacts/har/jshook-capture-<timestamp>.har`     | `web_api_capture_session`、`network_export_har`                    |
-| Workflow Markdown 报告 | `artifacts/reports/web-api-capture-<timestamp>.md` | `web_api_capture_session`                                          |
-| 截图                   | `screenshots/manual/`                              | `page_screenshot`                                                  |
-| CAPTCHA 截图           | `screenshots/`                                     | `page_navigate` CAPTCHA 检测                                       |
-| 调试会话               | `sessions/`                                        | `debugger_save_session` / `debugger_export_session`                |
-| WASM 产物              | `artifacts/wasm/`                                  | `wasm_dump`、`wasm_disassemble`、`wasm_decompile`、`wasm_optimize` |
-| Source Map 树          | `artifacts/sourcemap/`                             | `sourcemap_reconstruct_tree`                                       |
-| 小程序解包             | `artifacts/miniapp-unpack/`                        | `miniapp_pkg_unpack`                                               |
-| Jadx 反编译            | `artifacts/jadx-decompile/`                        | `jadx_bridge`                                                      |
-| 性能 Trace             | `artifacts/trace/`                                 | `performance_trace_stop`                                           |
-| CPU Profile            | `artifacts/profile/`                               | `profiler_cpu_stop`                                                |
-| 堆采样                 | `artifacts/heap/`                                  | `profiler_heap_sampling_stop`                                      |
-
-所有路径均已在 `.gitignore` 中配置。
-
-支持以下 retention 环境变量：
-
-- `MCP_ARTIFACT_RETENTION_DAYS`
-- `MCP_ARTIFACT_MAX_TOTAL_MB`
-- `MCP_ARTIFACT_CLEANUP_ON_START=true`
-- `MCP_ARTIFACT_CLEANUP_INTERVAL_MINUTES`
-
-可用的维护工具：
-
-- `cleanup_artifacts`
-- `doctor_environment`
-
-```bash
-# 环境与依赖诊断
-pnpm run doctor
-```
-
-## 安全
-
-- **认证**：设置 `MCP_AUTH_TOKEN` 启用 HTTP 传输 Bearer 令牌认证
-- **CSRF 防护**：Origin 校验阻断无认证的跨域浏览器请求
-- **SSRF 防御**：`network_replay_request` 和 `safeFetch` 使用 `redirect: 'manual'` + 逐跳 DNS pinning；Burp/Ghidra/IDA 桥接端点在构造时强制校验为回环地址（不可由用户覆盖）
-- **路径穿越**：HAR 导出和调试会话使用 `fs.realpath` + symlink 检测进行路径校验
-- **注入防护**：所有 PowerShell 操作使用 `execFile` + 输入净化
-- **外部工具安全**：`ExternalToolRunner` 使用仅限白名单的工具注册 + `shell: false` 执行
-
-## 平台说明
+## 功能特性
 
-- Windows 仍是内存写入 / 注入类工具的主平台。
-- Linux/macOS 更适合使用浏览器 Hook、网络采集、workflow 编排与 bridge 模式分析。
-- 配置好 Ghidra / IDA / Burp 后，建议先运行 `pnpm run doctor` 或 `doctor_environment`。
+提供了一整套用于 AI 辅助 JavaScript 分析、浏览器自动化、CDP 调试、网络拦截与内存分析的全面工具集。
 
-## 扩展模板
+> **[查看完整功能列表 ↗](https://vmoranv.github.io/jshookmcp/)**
 
-> 这里说的是“开发扩展”的模板仓，不是主程序 `jshook` 的安装方式。普通使用者运行主程序，优先走上面的 `npx @jshookmcp/jshook`；只有在你要自己开发 plugin / workflow 时，才需要 clone 模板仓并本地 build。
+## 架构与性能
 
-- 插件模板仓：`https://github.com/vmoranv/jshook_plugin_template`
-- 工作流模板仓：`https://github.com/vmoranv/jshook_workflow_template`
-- 想让自己的 plugin / workflow 被扩展 registry 收录：到 `https://github.com/vmoranv/jshookmcpextension/issues` 提 issue 申报
+- **渐进式工具发现**：`search_tools` 元工具（BM25 排序）+ `activate_tools` / `activate_domain` + 配置档位升级（`boost_profile`）
+- **search 档行为说明**：`search_tools` 只负责检索与排序，不会自动 `activate_tools`，也不会自动 `boost_profile`；推荐链路是 `search_tools -> activate_tools / activate_domain -> （确有需要时）boost_profile`
+- **单工具不必先升档**：`activate_tools` 可跨当前基座档精确启用单个工具；只有在你接下来会反复使用一整组相关能力时，`boost_profile` 才更合适
+- **域延迟初始化**：处理器类通过 Proxy 在首次调用时实例化，而非启动时预加载
+- **域自发现架构**：运行时扫描 `domains/*/manifest.ts` 替代硬编码导入；新增域只需创建一个 manifest 文件
+- **B-Skeleton 契约**：插件（`PluginContract`）、工作流（`WorkflowContract`）、可观测性（`InstrumentationContract`）的扩展性契约
+- **上下文效率基准**：基于 Claude 服务端对当前内置工具 schema 的实测计数（2026-03-12），`search` 档 ≈ 2,975 tokens，`full` 档 ≈ 34,985 tokens（当前分别为 12 与 238 个 built-in tools；数值会随工具与描述变更而变化）
 
 ## 项目统计
 
 <div align="center">
 
-[![Star History Chart](https://api.star-history.com/svg?repos=vmoranv/jshookmcp&type=Date)](https://star-history.com/#vmoranv/jshookmcp&Date)
+<a href="https://www.star-history.com/?repos=vmoranv%2Fjshookmcp&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/image?repos=vmoranv/jshookmcp&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/image?repos=vmoranv/jshookmcp&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/image?repos=vmoranv/jshookmcp&type=date&legend=top-left" />
+ </picture>
+</a>
 
 ![Activity](https://repobeats.axiom.co/api/embed/83c000c790b1c665ff2686d2d02605412a0b8805.svg 'Repobeats analytics image')