install-dexsql

安装 DexSQL MCP

完成后，用户选择的版本和客户端应能正常连接本地 DexSQL MCP。DexSQL 是闭源软件：请安装预构建的可执行文件，而不是从源代码构建。服务通过标准输入/输出运行 dexsql mcp，无需 JVM、GUI 或 Python 运行时。本技能仅提供安装指导；仅安装技能不会安装可执行文件或注册 MCP 服务。

选择可执行文件

• 检测主机操作系统和架构、用户请求的 MCP 客户端，以及任何现有的 DexSQL 可执行文件或配置。如果当前本地客户端明确，则据此推断；只有目标客户端或适用范围确实不明确时才询问。
• 优先使用兼容的现有可执行文件，除非用户请求更新。也支持用户提供的本地可执行文件。配置前检查 --version 和 mcp --help。
• 否则检查以下地址中的实际资源： https://api.github.com/repos/LSPosed/dexsql-release/releases/latest；如果用户请求特定版本，则检查 https://api.github.com/repos/LSPosed/dexsql-release/releases/tags/<tag>。面向用户的版本列表位于 https://github.com/LSPosed/dexsql-release/releases。
• 为检测到的操作系统和架构选择 CLI 可执行文件或压缩包。不要替换为 WASM 包、源代码压缩包或其他项目的二进制文件。请使用 API 中实际提供的 browser_download_url；不要臆造资源名称。
• 以所选版本的实际资源和说明为准，确认可用平台、架构、打包方式和系统要求。下载前检查其与主机的兼容性；不要依赖其他版本中的固定平台列表或资源名称。
• 如果无法访问仓库、没有可用版本，或没有匹配的二进制文件，请说明具体问题，并接受用户提供的本地可执行文件或官方版本 URL。不要声称安装成功，也不要尝试构建闭源引擎。

本地安装

下载到临时目录。如果版本资源 API 提供了 sha256:<hex> 格式的 digest，请在运行或安装前将其与下载文件的 SHA-256 值进行比较。也可以使用已发布的校验和文件。如校验不匹配，请停止操作。如果两者都不可用，请将计算出的哈希值报告为本地指纹，而非已验证的上游校验和。独立可执行文件无需解压；仅在临时目录中解压压缩包，并确保所有条目都保留在该目录内。

将可执行文件及其附带的许可证/声明文件放在带有版本号且用户可写的目录中，例如 Windows 上的 %LOCALAPPDATA%/DexSQL/<version>/，或 macOS/Linux 上的 ~/.local/share/dexsql/<version>/。在 MCP 配置中使用其绝对路径，因此无需管理员权限或修改 Shell 的 PATH。将安装后的文件名规范为 Windows 上的 dexsql.exe，或 macOS/Linux 上的 dexsql。对于独立二进制文件，还要将 LICENSE 和 LICENSE-AUXILIARY 保存在可执行文件旁边。优先使用同一版本中的资源，并使用其 API 提供的 URL 和摘要。如果 LICENSE 或 LICENSE-AUXILIARY 不是资源，请使用所选版本实际的 tag_name，而不是默认分支，从 https://raw.githubusercontent.com/LSPosed/dexsql-release/<tag>/<filename> 获取。 必须包含 LICENSE；如果该版本提供 LICENSE-AUXILIARY，则也要保留。第三方声明已压缩在可执行文件中，无需单独下载声明文件。如果用户需要可读副本，请使用已安装的可执行文件运行 dexsql extract licenses --output THIRD_PARTY_NOTICES，以离线导出完整的 UTF-8 文本。该命令不会覆盖现有文件。保留随附的声明文件，并确保仍可访问内嵌声明。在 macOS/Linux 上，确保可执行文件具有执行权限。新可执行文件通过验证前，请保留现有安装。不要禁用操作系统安全检查来强行运行不兼容或被阻止的二进制文件。

连接指定客户端

检查相关的现有配置，并保留无关的服务和设置。新建连接时，添加名为 dexsql 的服务。更新连接时，除非用户要求进行其他更改，否则只更改该服务的可执行文件路径；保留自定义参数、环境设置和超时设置。编辑配置文件前先备份。已有正确配置时，无需重写。

对于 Codex，新建条目时优先使用其 CLI：

codex mcp add dexsql -- /absolute/path/to/dexsql mcp
codex mcp get dexsql --json

根据用户使用的 shell，按要求为可执行文件路径加引号。如果无法使用 Codex CLI，请将此表合并到选定的 Codex 配置文件中：

[mcp_servers.dexsql]
command = "/absolute/path/to/dexsql"
args = ["mcp"]

对于使用 mcpServers JSON 的客户端，请将此条目合并到其文档指定的配置位置，或使用其 MCP 设置界面：

{
  "mcpServers": {
    "dexsql": {
      "command": "/absolute/path/to/dexsql",
      "args": ["mcp"]
    }
  }
}

Windows 路径应使用正确的 JSON/TOML 转义方式。不要假定所有客户端使用相同的配置路径或架构。不要仅为完成此任务而安装另一个 AI 客户端。这是本地 stdio 服务；无需网络监听器或 API 密钥。

验证并交接

运行 --version，然后在客户端可用时通过客户端验证 MCP 初始化握手和 tools/list；否则使用临时的 stdio MCP 探测工具。工具列表必须包含 open_dataset、query 和 decode。完成后关闭探测工具。仅注册配置并不代表连接测试成功。

如果客户端需要重启或新建聊天才能发现服务，请将此要求与已验证的可执行文件/协议状态分开说明。在工具可用之前，不要声称当前聊天已连接。仅当用户提出要求时才分析 APK；安装过程无需打开用户的文件。

报告已安装的版本、可执行文件路径、配置位置、验证结果，以及任何尚待完成的客户端重新加载步骤。一个实用的首条提示词是： “用 DexSQL 打开此 APK，查找引用此字符串的方法，并展示它们的调用方和 Smali。”