GG-AI Modifier v2.0.0

[yl985211]

GG-AI Modifier 更新日志

English document at the bottom

---

v2.0.0 (2026-05-09)

🆕 新增功能

核心引擎升级

• 内存段智能筛选：解析 /proc/[pid]/maps 时自动按优先级排序，优先搜索 [heap]、[anon:*] 等高价值内存段，跳过只读段，提升搜索效率
• 模糊搜索（未知值搜索）：支持 8 种对比操作（changed/unchanged/increased/decreased/greater/less/equal/not_equal），首次搜索保存快照，后续对比变化
• 特征码搜索（AOB Scan）：支持字节模式匹配，记录目标地址前后 16 字节切片，实现游戏重启后自动重定位
• 数据对齐修复：使用 ByteBuffer.order(ByteOrder.LITTLE_ENDIAN) 显式声明字节序，支持 1 字节精细扫描步进
• 分块读取：内存扫描采用 2MB chunk 分块读取，避免 OOM

Lua 脚本引擎

• 集成 LuaJ (luaj-jse-3.0.2)：在 JVM 中执行 Lua 脚本，无需设备安装 luajit
• 完整 GG API 桥接：支持 gg.choice()、gg.prompt()、gg.toast()、gg.alert() 等交互式 API
• 交互式对话框：Lua 脚本中的 gg.choice() 会弹出真正的选择对话框，阻塞等待用户选择后继续执行（与 GG 修改器体验一致）
• 脚本运行日志：每次运行脚本自动保存日志，支持查看历史运行记录
• 脚本持久化：用户创建的脚本保存到 Hive 存储，重启后不丢失
• 悬浮窗脚本库：悬浮窗中可直接查看脚本列表并运行，日志与主应用同步

AI 对话升级

• Markdown/LaTeX/Mermaid 渲染：悬浮窗 AI 对话使用 WebView 渲染，支持 Markdown 格式、LaTeX 公式（KaTeX）、Mermaid 图表
• Flutter 端 Markdown 渲染：对话详情页使用 flutter_markdown 包渲染 AI 回复
• 真实 LLM API 调用：悬浮窗 AI 对话改为调用真实 API，支持多轮对话上下文

对话记录管理

• 单条/多条导出：支持导出单条或批量对话记录为 Markdown 文件
• 导出路径：/storage/emulated/0/Documents/AI-gg/（Android 10+ 使用 MediaStore API）
• 刷新按钮：悬浮窗保存聊天后可手动刷新，无需重启应用
• 真正删除：清空所有记录时同时清除 Hive 存储和 SharedPreferences

LLM 配置增强

• 自定义模型：支持添加自定义 API 提供商，填写名称/URL/Key/Model 后保存为标签
• 预设独立 API Key：每个预设独立保存 API Key，切换预设不会丢失已配置的 Key
• 预设持久化：重启应用后自动恢复上次选择的预设

设置页面

• AI 读取深度：阶梯式采样开关（20/30/50/100/全部），限制发送给 AI 的搜索结果数量
• GitHub 开源地址：点击跳转浏览器打开项目页面
• 首次启动权限申请：自动申请存储权限和悬浮窗权限

悬浮窗优化

• 记住上次面板：点击悬浮球恢复上次关闭的面板
• 每级窗口"关闭窗口"：所有面板底部都有"关闭窗口"按钮
• 悬浮窗脚本库：简化为只显示脚本列表和运行按钮
• 切换进程提示：AI 对话欢迎消息提示"切换进程后记得清空聊天"

🐛 修复

• 修复 Android 15 导出对话记录失败的问题（改用 MediaStore API）
• 修复悬浮窗 AI 对话硬编码回复的问题
• 修复对话内容切换后消失的问题
• 修复清除所有记录是伪删除的问题
• 修复 LLM 配置预设重启后变成"自定义"的问题
• 修复切换预设时 API Key 消失的问题
• 修复 Release 构建 R8 混淆器移除 LuaJ 类的问题
• 修复悬浮窗脚本库重复显示内置脚本的问题
• 修复悬浮窗脚本库打开新任务界面的问题

📦 版本信息

• 版本号：2.0.0+2
• 最低 Android 版本：Android 5.0 (API 21)
• 目标 Android 版本：Android 15 (API 35)

---

v1.0.0 (2026-05-07)

初始版本

• 基础内存搜索（精确搜索、范围搜索）
• 内存读写
• 内存冻结
• 进程管理（附加/分离）
• AI 对话（LLM Function Calling）
• Lua 脚本库
• 悬浮窗（悬浮球 + 功能面板）
• 设置页面（LLM API 配置、Root 权限检测）
• 首次启动权限申请

GG-AI Modifier Changelog

---

v2.0.0 (2026-05-09)

🆕 New Features

Core Engine Upgrade

• Smart Memory Segment Filtering: Automatically sorts memory segments by priority when parsing /proc/[pid]/maps. High-value segments like [heap] and [anon:*] are searched first, while read-only segments are skipped, improving search efficiency.
• Fuzzy Search (Unknown Value Search): Supports 8 comparison operations (changed/unchanged/increased/decreased/greater/less/equal/not_equal). The initial search saves a snapshot, and subsequent searches compare against it.
• Signature Scan (AOB Scan): Supports byte pattern matching. Records a 16-byte slice before and after the target address, enabling automatic relocation after game restart.
• Data Alignment Fix: Uses ByteBuffer.order(ByteOrder.LITTLE_ENDIAN) to explicitly declare byte order, supporting fine-grained scanning with a 1-byte step.
• Chunked Reading: Memory scanning uses 2MB chunked reading to avoid out-of-memory errors.

Lua Script Engine

• Integrated LuaJ (luaj-jse-3.0.2): Executes Lua scripts inside the JVM without requiring the device to have LuaJIT installed.
• Complete GG API Bridge: Supports interactive APIs such as gg.choice(), gg.prompt(), gg.toast(), and gg.alert().
• Interactive Dialogs: gg.choice() inside Lua scripts displays a real selection dialog that blocks and waits for user choice before continuing (matching the experience of GG Modifier).
• Script Run Logs: Automatically saves a log for each script run, supporting viewing of historical run records.
• Script Persistence: Scripts created by users are saved to Hive storage and are not lost after restart.
• Floating Window Script Library: The floating window can directly display the script list and run scripts. Logs are synchronized with the main app.

AI Conversation Upgrade

• Markdown/LaTeX/Mermaid Rendering: The AI conversation in the floating window uses a WebView for rendering, supporting Markdown, LaTeX formulas (KaTeX), and Mermaid diagrams.
• Flutter-side Markdown Rendering: The conversation detail page uses the flutter_markdown package to render AI replies.
• Real LLM API Calls: The floating window AI dialogue now calls a real API, supporting multi-turn conversation context.

Chat Record Management

• Single/Batch Export: Supports exporting single or batch conversation records as Markdown files.
• Export Path: /storage/emulated/0/Documents/AI-gg/ (Uses MediaStore API on Android 10+).
• Refresh Button: After saving a chat in the floating window, you can manually refresh without restarting the app.
• Real Deletion: Clearing all records now removes data from both Hive storage and SharedPreferences.

LLM Configuration Enhancements

• Custom Model: Supports adding custom API providers. Fill in Name/URL/Key/Model and save as a new preset tag.
• Per-Preset Independent API Key: Each preset saves its own API Key; switching presets will not lose the configured Key.
• Preset Persistence: The app automatically restores the last selected preset after restart.

Settings Page

• AI Read Depth: Stepped sampling toggle (20/30/50/100/All), limiting the number of search results sent to the AI.
• GitHub Open Source Link: Tap to open the project page in a browser.
• First-Launch Permission Request: Automatically requests storage and overlay permissions on first start.

Floating Window Optimization

• Remember Last Panel: Tapping the floating ball restores the last closed panel.
• "Close Window" on Every Level: All panels have a "Close Window" button at the bottom.
• Floating Window Script Library: Simplified to show only the script list and run button.
• Process Switch Hint: The AI conversation welcome message reminds users to "clear the chat after switching processes".

🐛 Fixes

• Fixed export failure on Android 15 (switched to MediaStore API).
• Fixed hardcoded replies in the floating window AI conversation.
• Fixed conversation content disappearing after switching.
• Fixed pseudo-deletion when clearing all records.
• Fixed LLM configuration preset reverting to "Custom" after restart.
• Fixed API Key disappearing when switching presets.
• Fixed R8 obfuscator removing LuaJ classes in Release builds.
• Fixed duplicate built-in scripts in the floating window script library.
• Fixed the floating window script library opening a new task interface.

📦 Version Info

• Version: 2.0.0+2
• Minimum Android Version: Android 5.0 (API 21)
• Target Android Version: Android 15 (API 35)

---

v1.0.0 (2026-05-07)

Initial Release

• Basic memory search (exact search, range search)
• Memory read/write
• Memory freezing
• Process management (attach/detach)
• AI conversation (LLM Function Calling)
• Lua script library
• Floating window (floating ball + function panel)
• Settings page (LLM API configuration, root permission detection)
• First-launch permission request

---

This discussion was created from the release GG-AI Modifier v2.0.0.

[yl985211]

这个版本优化非常好