[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ASWZ62403PH17S5ES4M91Z":3,"skill-same:01M7ASWZ62403PH17S5ES4M91Z":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7ASWZ62403PH17S5ES4M91Z","re-plugin-dev",null,"Ghidra\u002FIDA 插件开发：脚本→插件工程化。 触发词：插件开发、Ghidra插件、IDA插件、插件工程","dslsdzc\u002Frev-skills","dslsdzc","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F150430440?v=4","01M7ASEW5AKHWCFR1TXPAXQ237","DslsDZC","01M7ASEW5WJZ3GGBCCT12KHAQZ",243,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fre-plugin-dev\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: re-plugin-dev\ndescription: >\n  Ghidra\u002FIDA 插件开发：脚本→插件工程化。\n  触发词：插件开发、Ghidra插件、IDA插件、插件工程\ncapabilities: [plugin-development]\n---\n\n# Ghidra \u002F IDA 插件开发\n\n## 何时使用 \u002F 何时不用\n\n- 用：重复性分析步骤需要固化成可复用工具（批量标注、解密循环、自定义格式解析、特殊协议字段标注）\n- 用：需要交互式 UI（菜单\u002F快捷键\u002F面板）或\"工程加载即自动执行\"的常驻功能\n- 用：团队内分发\u002F多机器统一分析环境（[[re-ghidra]] \u002F [[re-ida]] 脚本升级为工程化插件）\n- 不用：一次性分析任务（脚本即用即走，[[re-ghidra]] 步骤 4 \u002F [[re-ida]] 步骤 4 的轻量脚本足够）\n- 不用：只是把已有逻辑换个语言重写（先确认场景，见步骤 1）\n\n## 工具准备\n\n静态分析工具开发可免沙箱；插件跑在分析工具进程内，不执行样本代码（免沙箱，[[re-analyze\u002Fplatform-tips]] 静态优先）。\n\n### Ghidra —— Java 扩展 \u002F Python 脚本\n\n- Ghidra 安装（JDK 21+，Ghidra 11.3+ 要求）见 [[re-ghidra]] 工具准备\n- GhidraDev Eclipse 插件（官方，GitHub `NationalSecurityAgency\u002Fghidra` 仓库内 GhidraDev 目录）: 需要 Eclipse（Linux `apt install eclipse` \u002F Fedora `dnf install eclipse-platform` \u002F Arch `pacman -S eclipse-java`；macOS `brew install --cask eclipse-java`；Windows 官网 zip 解压）；非必需——纯 Gradle 也能构建扩展；GhidraDev 版本与 Eclipse 版本有配套表，装不上先在官方 release notes 核对组合\n- Gradle（可选，构建 Java 扩展）: Debian\u002FUbuntu `apt install gradle` \u002F Fedora `dnf install gradle` \u002F Arch `pacman -S gradle`；macOS `brew install gradle`；Windows `choco install gradle`；验证 `gradle --version`；发行版仓库的 Gradle 可能过旧（构建 Ghidra 扩展失败）——优先用 GhidraDev 工程自带的 gradle wrapper（`.\u002Fgradlew`）\n- 验证: Ghidra GUI Script Manager 能列出脚本；`File > Install Extensions` 能看到安装的扩展\n\n### IDA —— idapython 插件\n\n- IDA 安装见 [[re-ida]] 工具准备（idapython 内置，无需单独安装）\n- 插件目录: Windows `%APPDATA%\\Hex-Rays\\IDA Pro\\plugins\\`（或 IDA 安装目录 `plugins\\`）；Linux\u002FmacOS `~\u002F.idapro\u002Fplugins\u002F`\n- 验证: 插件文件放入目录后 IDA 启动日志出现 `Loading plugin ...`；`File > Script command` 执行 `print(idaapi.IDA_SDK_VERSION)` 输出 SDK 版本\n\n## 操作步骤\n\n按顺序执行；每个插件产物（源码\u002F构建产物\u002F测试样本与输出）存档 sha256 + 路径，供报告与复用（[[re-ioc]] 证据链要求）。\n\n1. **场景识别（批处理脚本 vs 交互插件）**：\n   - 一次性\u002F简单重复 → 脚本（[[re-ghidra]] 的 GhidraScript \u002F [[re-ida]] 的 idapython 脚本）\n   - 常驻\u002F需 UI\u002F加载即执行\u002F多机分发 → 插件（Ghidra Java Extension \u002F IDA idapython 插件）\n   - 判据四条，命中其一即该做插件: ① 需要交互 UI（菜单\u002F快捷键\u002F对话框）② 工程加载后自动执行 ③ 团队多机分发（版本统一）④ 需要与外部服务\u002FAPI 集成\n   - 记录决策: 场景 + 工具链 + 维护责任人（坑 4 的维护成本先摊开说）\n\n2. **Ghidra 插件骨架（Java 扩展 \u002F 程序脚本）**：\n   - Python 脚本（最轻）: `@category` 头注释 + 存 GhidraScripts 目录，Script Manager 运行（注意内置 Jython 2.7，见坑 2 与 [[re-ghidra]] 坑）\n   - Java 扩展（工程化）: GhidraDev `New > Ghidra Module Project` 选 Extension → 实现 `Plugin` 类（覆写 `init`\u002F`dispose`，在 `init` 里注册菜单动作）→ Gradle `gradle buildExtension` 产出 .zip → 目标机器 `File > Install Extensions` 安装\n   - 骨架要点: 动作注册用 `ToolAction`\u002F`AbstractAction` 挂到菜单；无头环境用 `-postScript` 测试（[[re-ghidra]] 步骤 4）；脚本与扩展的边界见 [[re-ghidra]] 坑（脚本 vs 扩展选型）\n   - 扩展结构: 构建产物 .zip 内含 extension.properties（声明适用的 Ghidra 版本范围）——装到范围外版本会被拒载，分发时注明版本并锁范围\n   - 验证: 安装后在菜单触发动作；无头 `analyzeHeadless ... -postScript MyPluginTest.java` 跑通输出；`gradle buildExtension` 产出 zip 后先查 extension.properties 版本范围再分发\n\n3. **IDA 插件骨架（idapython）**：\n   ```python\n   # myplugin.py —— 放到 plugins 目录，IDA 启动自动加载\n   import idaapi\n   class MyPlugin(idaapi.plugin_t):\n       flags = idaapi.PLUGIN_KEEP\n       comment = \"demo plugin\"\n       help = \"\"\n       wanted_name = \"MyPlugin\"\n       wanted_hotkey = \"Ctrl-Shift-M\"\n       def init(self):\n           idaapi.register_action(idaapi.action_desc_t(\n               \"my:action\", \"My Action\", MyAct(), \"Ctrl-Shift-M\"))\n           return idaapi.PLUGIN_KEEP\n       def run(self, arg):\n           print(\"hello from MyPlugin\")\n   def PLUGIN_ENTRY():\n       return MyPlugin()\n   ```\n   - 菜单注册: `idaapi.register_action` + `idaapi.attach_action_to_menu(\"Edit\u002F...\", \"my:action\")`；对话框: `ida_kernwin.ask_str` \u002F `ask_buttons`（注意 IDA 9.x 中部分 API 迁到 `ida_kernwin`，见坑 1）\n   - 无头测试: 无头可执行文件名与 `-A -S` 用法见 [[re-ida]]（脚本内 `ida_auto` 等同样按该处写法）\n   - 验证: 启动日志有 `Loading plugin ... MyPlugin`；快捷键触发动作输出正常\n\n4. **与现有脚本复用（[[re-ghidra]] \u002F [[re-ida]] 的脚本）**：\n   - 起步素材: [[re-ghidra]] 步骤 4 的批量重命名\u002F解密循环脚本、[[re-ida]] 步骤 4 的批量 patch\u002F标注脚本——把\"手动跑一遍\"包成\"菜单触发\"\n   - 场景示例: 自动扫描常量表（[[re-crypto-id]] 的 FindCrypt 思路）、花指令清除批处理（[[re-deobfuscate]] 的 D-810 思路）、PE\u002FELF 自定义格式解析（[[re-format-pe]] \u002F [[re-format-elf]]）\n   - 复用纪律: 脚本里的易变逻辑（模式串\u002F表\u002F阈值）外置为配置文件或插件选项，别硬编码进代码（降低坑 4 的维护成本）\n   - 旧脚本先跑一遍验证基线输出，再包成插件——插件上线前后输出必须一致（回归测试）\n\n5. **测试与分发**：\n   - 测试矩阵: 多版本工具（IDA\u002FGhidra，见坑 1）、多架构样本（x86\u002Fx64\u002FARM）、有\u002F无符号样本；修改型脚本先在副本 .i64\u002F.idb 或独立工程上跑（[[re-ida]] 坑）\n   - 只读验证先行: 先跑只读统计脚本确认预期，再上修改型逻辑（[[re-ida]] 坑: 修改型脚本直接在原库上跑改坏难回滚）\n   - 分发: Ghidra 扩展 .zip（`gradle buildExtension`，README 注明 Ghidra 版本）；IDA 插件单 .py 文件或打包，注明 IDA 版本与 Python 版本；商业 IDA 的分发还要过插件签名（坑 3）\n   - 验收: 干净环境（新工程\u002F新 IDB）从零安装 → 触发 → 输出与开发环境一致，才算发布完成\n\n## 跨域联合\n\n- [[re-binary-core]]：本技能是其工具链扩展环节（网关工作流第 5 步反编译之后的可选工程化动作）\n- [[re-ghidra]]：Ghidra 脚本\u002F扩展开发起点（工作流步骤 4 的脚本即插件素材）\n- [[re-ida]]：idapython 插件开发起点（工作流步骤 4 的脚本即插件素材；无头测试写法）\n- [[re-deobfuscate]]：插件化脱混淆场景（D-810 思路）\n- [[re-crypto-id]]：插件化常量表指纹扫描（FindCrypt 思路）\n- [[re-format-pe]] \u002F [[re-format-elf]] \u002F [[re-format-macho]]：格式解析类插件的目标对象\n- [[re-binaryninja]]：Binary Ninja 脚本 API 插件（多工具插件体系可互参考）\n- 引用 [[re-analyze\u002Fplatform-tips]] 静态优先原则（插件开发与测试免沙箱）\n\n## 常见坑与陷阱\n\n- **API 版本差异（Ghidra\u002FIDA 升级破坏）**：现象——插件在旧版工具正常，升级后加载失败\u002F运行报错\u002F菜单消失；原因——Ghidra 11.x 有破坏性 API 变更（如函数管理类迁移）、IDA 9.x 把部分 `idc`\u002F`idaapi` 函数重组织到新模块（`ida_bytes` 等）；对策——插件文档锁版本（写明测试过的 Ghidra\u002FIDA 版本），测试矩阵覆盖新旧版本（步骤 5），升级工具后先跑只读脚本再改代码（[[re-ida]] 坑）\n- **Java 环境要求**：现象——Ghidra 扩展构建或运行报 `UnsupportedClassVersionError`、Python 脚本语法错误；原因——JDK 版本不匹配（Ghidra 11.3+ 需 JDK 21，见 [[re-ghidra]]）、内置解释器是 Jython 2.7（Python 2 语法，不支持 f-string\u002F海象运算，也无法 import pip 包）；对策——`java -version` 确认 21+ 且 `JAVA_HOME` 正确；脚本按 Python 2 兼容语法写，需要现代 Python 时用 ghidra-bridge 外接 Python 3（[[re-ghidra]] 坑）\n- **插件签名（IDA 商业版）**：现象——插件放进 plugins 目录但商业版 IDA 不加载（启动日志无该插件，无任何报错）；原因——IDA 商业版对第三方插件做签名验证，未签名插件被拒；对策——确认 IDA 版本（Freeware 不做签名验证），开发期用 Freeware\u002F无头模式测试，正式分发走 Hex-Rays 官方插件签名申请流程；把\"签名状态\"写进分发文档\n- **维护成本失控**：现象——插件发布三个月后跟不上升级\u002F新样本形态，没人修，反而拖慢分析；原因——插件是长期承诺（API 升级 + 场景变化都要跟进），一次性脚本没有这个成本；对策——步骤 1 先判值不值: 逻辑简单\u002F变化快 → 脚本；稳定且复用高 → 插件；插件内把易变逻辑（模式串\u002F表\u002F阈值）外置配置，减少改码面；每次发布记录版本与对应工具版本\n- **修改型插件直接改库，改坏不可逆**：现象——批量改名\u002Fpatch 插件跑完，IDB 标注错乱且撤销困难；原因——跳过只读验证、没在副本上跑；对策——先跑只读统计脚本确认预期（[[re-ida]] 坑），修改逻辑先在副本 .i64\u002F.idb 或独立 Ghidra 工程上验证，验收通过再上正式库\n- **Ghidra 扩展版本范围拒载**：现象——扩展装进 Ghidra 无报错但列表里不出现；原因——extension.properties 声明的适用版本范围与当前 Ghidra 不匹配，被安装器拒载；对策——先解压 zip 核对 extension.properties 的版本范围（`ghidra.version` 字段），用 GhidraDev 生成工程时按目标版本建；分发文档写明测试过的 Ghidra 版本\n- **无头\u002F批处理环境不能依赖交互对话框**：现象——`analyzeHeadless` 或 IDA 无头模式（[[re-ida]]）下插件行为异常\u002F卡住；原因——批处理模式没有 UI 事件循环，ask_* 对话框类 API 与菜单触发逻辑不可用；对策——交互参数（路径\u002F阈值\u002F模式串）改从命令行参数或配置文件读取，插件内先判断运行环境（是否 GUI 会话）再决定走哪条分支；无头测试脚本只验证纯计算逻辑\n","# Ghidra \u002F IDA 插件开发\n\n## 何时使用 \u002F 何时不用\n\n- 用：重复性分析步骤需要固化成可复用工具（批量标注、解密循环、自定义格式解析、特殊协议字段标注）\n- 用：需要交互式 UI（菜单\u002F快捷键\u002F面板）或\"工程加载即自动执行\"的常驻功能\n- 用：团队内分发\u002F多机器统一分析环境（[[re-ghidra]] \u002F [[re-ida]] 脚本升级为工程化插件）\n- 不用：一次性分析任务（脚本即用即走，[[re-ghidra]] 步骤 4 \u002F [[re-ida]] 步骤 4 的轻量脚本足够）\n- 不用：只是把已有逻辑换个语言重写（先确认场景，见步骤 1）\n\n## 工具准备\n\n静态分析工具开发可免沙箱；插件跑在分析工具进程内，不执行样本代码（免沙箱，[[re-analyze\u002Fplatform-tips]] 静态优先）。\n\n### Ghidra —— Java 扩展 \u002F Python 脚本\n\n- Ghidra 安装（JDK 21+，Ghidra 11.3+ 要求）见 [[re-ghidra]] 工具准备\n- GhidraDev Eclipse 插件（官方，GitHub `NationalSecurityAgency\u002Fghidra` 仓库内 GhidraDev 目录）: 需要 Eclipse（Linux `apt install eclipse` \u002F Fedora `dnf install eclipse-platform` \u002F Arch `pacman -S eclipse-java`；macOS `brew install --cask eclipse-java`；Windows 官网 zip 解压）；非必需——纯 Gradle 也能构建扩展；GhidraDev 版本与 Eclipse 版本有配套表，装不上先在官方 release notes 核对组合\n- Gradle（可选，构建 Java 扩展）: Debian\u002FUbuntu `apt install gradle` \u002F Fedora `dnf install gradle` \u002F Arch `pacman -S gradle`；macOS `brew install gradle`；Windows `choco install gradle`；验证 `gradle --version`；发行版仓库的 Gradle 可能过旧（构建 Ghidra 扩展失败）——优先用 GhidraDev 工程自带的 gradle wrapper（`.\u002Fgradlew`）\n- 验证: Ghidra GUI Script Manager 能列出脚本；`File > Install Extensions` 能看到安装的扩展\n\n### IDA —— idapython 插件\n\n- IDA 安装见 [[re-ida]] 工具准备（idapython 内置，无需单独安装）\n- 插件目录: Windows `%APPDATA%\\Hex-Rays\\IDA Pro\\plugins\\`（或 IDA 安装目录 `plugins\\`）；Linux\u002FmacOS `~\u002F.idapro\u002Fplugins\u002F`\n- 验证: 插件文件放入目录后 IDA 启动日志出现 `Loading plugin ...`；`File > Script command` 执行 `print(idaapi.IDA_SDK_VERSION)` 输出 SDK 版本\n\n## 操作步骤\n\n按顺序执行；每个插件产物（源码\u002F构建产物\u002F测试样本与输出）存档 sha256 + 路径，供报告与复用（[[re-ioc]] 证据链要求）。\n\n1. **场景识别（批处理脚本 vs 交互插件）**：\n   - 一次性\u002F简单重复 → 脚本（[[re-ghidra]] 的 GhidraScript \u002F [[re-ida]] 的 idapython 脚本）\n   - 常驻\u002F需 UI\u002F加载即执行\u002F多机分发 → 插件（Ghidra Java Extension \u002F IDA idapython 插件）\n   - 判据四条，命中其一即该做插件: ① 需要交互 UI（菜单\u002F快捷键\u002F对话框）② 工程加载后自动执行 ③ 团队多机分发（版本统一）④ 需要与外部服务\u002FAPI 集成\n   - 记录决策: 场景 + 工具链 + 维护责任人（坑 4 的维护成本先摊开说）\n\n2. **Ghidra 插件骨架（Java 扩展 \u002F 程序脚本）**：\n   - Python 脚本（最轻）: `@category` 头注释 + 存 GhidraScripts 目录，Script Manager 运行（注意内置 Jython 2.7，见坑 2 与 [[re-ghidra]] 坑）\n   - Java 扩展（工程化）: GhidraDev `New > Ghidra Module Project` 选 Extension → 实现 `Plugin` 类（覆写 `init`\u002F`dispose`，在 `init` 里注册菜单动作）→ Gradle `gradle buildExtension` 产出 .zip → 目标机器 `File > Install Extensions` 安装\n   - 骨架要点: 动作注册用 `ToolAction`\u002F`AbstractAction` 挂到菜单；无头环境用 `-postScript` 测试（[[re-ghidra]] 步骤 4）；脚本与扩展的边界见 [[re-ghidra]] 坑（脚本 vs 扩展选型）\n   - 扩展结构: 构建产物 .zip 内含 extension.properties（声明适用的 Ghidra 版本范围）——装到范围外版本会被拒载，分发时注明版本并锁范围\n   - 验证: 安装后在菜单触发动作；无头 `analyzeHeadless ... -postScript MyPluginTest.java` 跑通输出；`gradle buildExtension` 产出 zip 后先查 extension.properties 版本范围再分发\n\n3. **IDA 插件骨架（idapython）**：\n   ```python\n   # myplugin.py —— 放到 plugins 目录，IDA 启动自动加载\n   import idaapi\n   class MyPlugin(idaapi.plugin_t):\n       flags = idaapi.PLUGIN_KEEP\n       comment = \"demo plugin\"\n       help = \"\"\n       wanted_name = \"MyPlugin\"\n       wanted_hotkey = \"Ctrl-Shift-M\"\n       def init(self):\n           idaapi.register_action(idaapi.action_desc_t(\n               \"my:action\", \"My Action\", MyAct(), \"Ctrl-Shift-M\"))\n           return idaapi.PLUGIN_KEEP\n       def run(self, arg):\n           print(\"hello from MyPlugin\")\n   def PLUGIN_ENTRY():\n       return MyPlugin()\n   ```\n   - 菜单注册: `idaapi.register_action` + `idaapi.attach_action_to_menu(\"Edit\u002F...\", \"my:action\")`；对话框: `ida_kernwin.ask_str` \u002F `ask_buttons`（注意 IDA 9.x 中部分 API 迁到 `ida_kernwin`，见坑 1）\n   - 无头测试: 无头可执行文件名与 `-A -S` 用法见 [[re-ida]]（脚本内 `ida_auto` 等同样按该处写法）\n   - 验证: 启动日志有 `Loading plugin ... MyPlugin`；快捷键触发动作输出正常\n\n4. **与现有脚本复用（[[re-ghidra]] \u002F [[re-ida]] 的脚本）**：\n   - 起步素材: [[re-ghidra]] 步骤 4 的批量重命名\u002F解密循环脚本、[[re-ida]] 步骤 4 的批量 patch\u002F标注脚本——把\"手动跑一遍\"包成\"菜单触发\"\n   - 场景示例: 自动扫描常量表（[[re-crypto-id]] 的 FindCrypt 思路）、花指令清除批处理（[[re-deobfuscate]] 的 D-810 思路）、PE\u002FELF 自定义格式解析（[[re-format-pe]] \u002F [[re-format-elf]]）\n   - 复用纪律: 脚本里的易变逻辑（模式串\u002F表\u002F阈值）外置为配置文件或插件选项，别硬编码进代码（降低坑 4 的维护成本）\n   - 旧脚本先跑一遍验证基线输出，再包成插件——插件上线前后输出必须一致（回归测试）\n\n5. **测试与分发**：\n   - 测试矩阵: 多版本工具（IDA\u002FGhidra，见坑 1）、多架构样本（x86\u002Fx64\u002FARM）、有\u002F无符号样本；修改型脚本先在副本 .i64\u002F.idb 或独立工程上跑（[[re-ida]] 坑）\n   - 只读验证先行: 先跑只读统计脚本确认预期，再上修改型逻辑（[[re-ida]] 坑: 修改型脚本直接在原库上跑改坏难回滚）\n   - 分发: Ghidra 扩展 .zip（`gradle buildExtension`，README 注明 Ghidra 版本）；IDA 插件单 .py 文件或打包，注明 IDA 版本与 Python 版本；商业 IDA 的分发还要过插件签名（坑 3）\n   - 验收: 干净环境（新工程\u002F新 IDB）从零安装 → 触发 → 输出与开发环境一致，才算发布完成\n\n## 跨域联合\n\n- [[re-binary-core]]：本技能是其工具链扩展环节（网关工作流第 5 步反编译之后的可选工程化动作）\n- [[re-ghidra]]：Ghidra 脚本\u002F扩展开发起点（工作流步骤 4 的脚本即插件素材）\n- [[re-ida]]：idapython 插件开发起点（工作流步骤 4 的脚本即插件素材；无头测试写法）\n- [[re-deobfuscate]]：插件化脱混淆场景（D-810 思路）\n- [[re-crypto-id]]：插件化常量表指纹扫描（FindCrypt 思路）\n- [[re-format-pe]] \u002F [[re-format-elf]] \u002F [[re-format-macho]]：格式解析类插件的目标对象\n- [[re-binaryninja]]：Binary Ninja 脚本 API 插件（多工具插件体系可互参考）\n- 引用 [[re-analyze\u002Fplatform-tips]] 静态优先原则（插件开发与测试免沙箱）\n\n## 常见坑与陷阱\n\n- **API 版本差异（Ghidra\u002FIDA 升级破坏）**：现象——插件在旧版工具正常，升级后加载失败\u002F运行报错\u002F菜单消失；原因——Ghidra 11.x 有破坏性 API 变更（如函数管理类迁移）、IDA 9.x 把部分 `idc`\u002F`idaapi` 函数重组织到新模块（`ida_bytes` 等）；对策——插件文档锁版本（写明测试过的 Ghidra\u002FIDA 版本），测试矩阵覆盖新旧版本（步骤 5），升级工具后先跑只读脚本再改代码（[[re-ida]] 坑）\n- **Java 环境要求**：现象——Ghidra 扩展构建或运行报 `UnsupportedClassVersionError`、Python 脚本语法错误；原因——JDK 版本不匹配（Ghidra 11.3+ 需 JDK 21，见 [[re-ghidra]]）、内置解释器是 Jython 2.7（Python 2 语法，不支持 f-string\u002F海象运算，也无法 import pip 包）；对策——`java -version` 确认 21+ 且 `JAVA_HOME` 正确；脚本按 Python 2 兼容语法写，需要现代 Python 时用 ghidra-bridge 外接 Python 3（[[re-ghidra]] 坑）\n- **插件签名（IDA 商业版）**：现象——插件放进 plugins 目录但商业版 IDA 不加载（启动日志无该插件，无任何报错）；原因——IDA 商业版对第三方插件做签名验证，未签名插件被拒；对策——确认 IDA 版本（Freeware 不做签名验证），开发期用 Freeware\u002F无头模式测试，正式分发走 Hex-Rays 官方插件签名申请流程；把\"签名状态\"写进分发文档\n- **维护成本失控**：现象——插件发布三个月后跟不上升级\u002F新样本形态，没人修，反而拖慢分析；原因——插件是长期承诺（API 升级 + 场景变化都要跟进），一次性脚本没有这个成本；对策——步骤 1 先判值不值: 逻辑简单\u002F变化快 → 脚本；稳定且复用高 → 插件；插件内把易变逻辑（模式串\u002F表\u002F阈值）外置配置，减少改码面；每次发布记录版本与对应工具版本\n- **修改型插件直接改库，改坏不可逆**：现象——批量改名\u002Fpatch 插件跑完，IDB 标注错乱且撤销困难；原因——跳过只读验证、没在副本上跑；对策——先跑只读统计脚本确认预期（[[re-ida]] 坑），修改逻辑先在副本 .i64\u002F.idb 或独立 Ghidra 工程上验证，验收通过再上正式库\n- **Ghidra 扩展版本范围拒载**：现象——扩展装进 Ghidra 无报错但列表里不出现；原因——extension.properties 声明的适用版本范围与当前 Ghidra 不匹配，被安装器拒载；对策——先解压 zip 核对 extension.properties 的版本范围（`ghidra.version` 字段），用 GhidraDev 生成工程时按目标版本建；分发文档写明测试过的 Ghidra 版本\n- **无头\u002F批处理环境不能依赖交互对话框**：现象——`analyzeHeadless` 或 IDA 无头模式（[[re-ida]]）下插件行为异常\u002F卡住；原因——批处理模式没有 UI 事件循环，ask_* 对话框类 API 与菜单触发逻辑不可用；对策——交互参数（路径\u002F阈值\u002F模式串）改从命令行参数或配置文件读取，插件内先判断运行环境（是否 GUI 会话）再决定走哪条分支；无头测试脚本只验证纯计算逻辑\n",{"name":5,"description":24,"capabilities":25},"Ghidra\u002FIDA 插件开发：脚本→插件工程化。 触发词：插件开发、Ghidra插件、IDA插件、插件工程\n",[26],"plugin-development","main","1977504515d3f5fa8889da43974feb7a0f4eaab9",".claude\u002Fskills\u002Fre-plugin-dev",43,"https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills","https:\u002F\u002Fgithub.com\u002Fdslsdzc","Building systems from scratch","2026-10-12 04:15:49",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add dslsdzc\u002Frev-skills --skill re-plugin-dev",{"tool":41,"command":42},"bunx","bunx skills add dslsdzc\u002Frev-skills --skill re-plugin-dev",{"tool":44,"command":45},"pnpm","pnpm dlx skills add dslsdzc\u002Frev-skills --skill re-plugin-dev","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fre-plugin-dev\u002FSKILL.md",true,[],[50,57,63,70,77,84],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7AT3SFGN6KTM2DBN8TCNC4K","no-tools","缺工具准备章节。missing tools section.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fno-tools\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7AT3PY0QVB4A4WGAZHY43WP","good-skill","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fgood-skill\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7AT3NJ1PG8DR115AMJC1Q1C","gateway-skill","网关型技能，无工具准备章节。gateway skill.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fgateway-skill\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7AT3KCJGZV60PKJX244V8Z4","broken-link","含死链接与合法 references 链接。broken link.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbroken-link\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7AT3HMVTA2MR66A5FMATVFQ","wrong-name","名字与目录不符。name mismatch.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbad-name\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7AT3F4K5ES6N62092Y8TRNG","bad-frontmatter","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbad-frontmatter\u002FSKILL.md",[],[]]