人工智能大模型本地部署AI 应用移动开发AI AgentAI 技能MCP Clients【免费下载链接】galleryA gallery that showcases on-device ML/GenAI use cases and allows people to try and use models locally.项目地址https://gitcode.com/GitHub_Trending/gallery44/gallery点击查看免费下载AI Edge Gallery 是一款在设备端运行大语言模型LLM与 GenAI 用例的开源应用推理完全在本机硬件上完成涉及模型下载、LiteRT 运行时、摄像头/录音等敏感权限与大量原生库依赖。当这类端侧 AI 应用出现异常时工程师需要掌握设备在 Bug 发生瞬间的完整状态——日志、内存、各系统服务与传感器数据缺一不可。本文依据仓库中的 Bug_Reporting_Guide.md 整理系统讲解如何在 Android 设备上为 AI Edge Gallery 生成「完整 Bug 报告」Full Bug Report涵盖面向普通用户的设备端操作法、面向开发者的adb命令行法以及如何解读报告中的关键诊断文件并补充仓库源码中的 Logcat 遥测标签与典型问题类型帮助你提交一份工程师可直接定位问题的高质量报告。为什么需要「完整 Bug 报告」AI Edge Gallery 的核心场景是端侧生成式 AI模型推理全部在设备上完成不依赖服务器这决定了它的 Bug 往往与具体硬件、内存状态、加速器选择如 NPU、GPU 支持和权限配置强相关而不仅仅是应用层逻辑错误。仅靠一句「模型加载失败」或「应用崩溃」的描述工程师很难复现与定位。一份完整 Bug 报告.zip压缩包能够在 Bug 发生时自动抓取以下信息logcat应用与系统输出的完整运行日志包括 AI Edge Gallery 各模块的调试信息dumpstate设备错误状态快照dumpsys所有系统服务的详细诊断输出覆盖内存、电量、网络、传感器等维度。报告给出的是「设备在 Bug 时刻的完整画像」因此官方明确推荐使用Full report完整报告而非简略报告Brief report。另外请注意本指南仅适用于Android 设备iOS 与 macOS 版本的报告方式不在此文范围内。Part 1推荐方法 —— 直接在设备上操作这是最快、最不需要额外工具的方法适合所有用户在遇到 Bug 的当下即可完成。1. 启用开发者选项「开发者选项」在 Android 中默认隐藏需要先手动开启打开手机的设置Settings应用向下滚动并点击「关于手机」About phone找到「版本号」Build number连续点击7 次屏幕会出现 “You are now a developer!”你现在是开发者了的提示。不同厂商 ROM 的菜单名称可能略有差异如「版本号」也可能显示为「内部版本号」但位置均在「关于手机」页面内。2. 捕获 Bug 报告关键建议尽量在刚刚复现 Bug 之后立即生成报告。此时设备内存中仍保留着异常发生前后的日志缓冲抓到的现场信息最完整、最有价值。操作步骤回到设置主页面找到新出现的「开发者选项」Developer options部分机型位于「系统 / System」菜单下在开发者选项内点击「获取 bug 报告」Take bug report在弹出的选项中选择「完整报告」Full report然后点击「报告」Report。完整报告包含最详细的诊断信息是被强烈推荐的选项。3. 等待并分享手机需要一小段时间收集数据收集完成后通知栏会出现「Bug report captured」Bug 报告已捕获的通知点击该通知系统会弹出 Android 分享菜单你可以将生成的.zip文件分享出去。最便捷的方式有两种保存到 Google Drive然后分享文件链接直接将.zip文件附加到 GitHub Issue中。Part 2开发者与进阶用户 —— 使用 ADB 抓取如果你熟悉 Android Debug Bridgeadb命令行工具且设备已通过 USB 连接电脑并开启了 USB 调试可以直接在电脑上完成抓取更适合需要批量复现、反复测试的开发者场景。直接捕获 Bug 报告单设备连接时将报告直接保存到电脑指定路径# 将报告保存到电脑上的指定路径 adb bugreport C:\Reports\MyBugReports多设备连接时需要先用序列号serial number锁定目标设备# 第一步列出所有已连接设备获取序列号 adb devices # 第二步用序列号指定目标设备 adb -s your_device_serial_number bugreport其中your_device_serial_number替换为第一步中查到的实际序列号。adb bugreport会自动生成带时间戳的.zip文件并保存在当前目录或-s目标设备对应的输出目录。从设备上取出历史 Bug 报告Android 会在设备本地自动保存最近的 Bug 报告即使当时没有连接到电脑也可以事后补拉1. 列出已保存的报告adb shell ls /bugreports/2. 拉取指定报告到电脑adb pull /bugreports/bug_report_filename.zip将bug_report_filename.zip替换为上一步列出的实际文件名。/bugreports/是 Android 系统存放已生成 Bug 报告的标准目录本仓库的 bug 报告同样遵循这一机制。理解 Bug 报告文件结构生成的报告是一个.zip压缩包解压后其中最重要的文件是bugreport-[...].txt。这个文本文件包含logcat系统完整日志覆盖应用进程与系统进程dumpstate错误日志包括崩溃堆栈、kernel log 等dumpsys所有系统服务的详细诊断输出。三者合在一起为工程师提供了 Bug 发生时设备状态的完整画面是定位 AI Edge Gallery 推理异常、崩溃、内存不足等问题的第一手证据。结合源码在 logcat 中定位 AI Edge Gallery 的关键遥测理解了报告结构后下一步就是知道「该看什么」。AI Edge Gallery 的源码在 Logcat 中使用了统一、可检索的标签体系报告里的bugreport-[...].txt可以直接用这些标签做针对性检索。1. 统一AG前缀标签仓库各模块的调试日志统一以AG开头并随附模块名便于在 logcat 中过滤。例如AGMetricsLogger推理与模型初始化遥测见 MetricsLogger.ktAGMemoryWarning内存不足检查日志见 MemoryWarning.ktAGDefaultAgentRuntimeExecutor、AGDefaultLlmSessionMgrAgent 运行时与会话管理见 DefaultAgentRuntimeExecutor.kt、DefaultLlmSessionManager.ktAGMainActivity、AGUtils、AGFcmMessagingService等模块级标签同样遵循该命名。查看报告时可按adb logcat -s AG*的思路快速收敛到应用自身的日志再结合报告中的dumpsys信息交叉验证。2. 模型初始化与推理遥测MetricsLogger.kt 在设备日志Logcat中输出结构化的[Model Init Telemetry]与[Inference Telemetry]信息块包含模型与加速器Model名称、Accelerator如 NPU/GPU 名称或N/A初始化状态Initialized/Failed失败时附带errorMessage、初始化耗时ms采样器配置top_k、top_p、temp、max_tokens、thinking、speculative_decoding、是否支持图片/音频输入等推理指标总延迟total、首 token 延迟ttft、解码耗时decode、初始化耗时init、prefill/decode 速度tpsToken 与上下文prompt、output、turn_totaltoken 数以及consumed/max上下文KV-cachetoken内存peak峰值、avg平均内存占用MB。当模型加载失败、推理中断或性能异常时这些字段能直接给出失败状态码InferenceStatus.Code、取消原因CancellationReason与错误信息是区分「模型文件问题」与「运行时/加速器问题」的关键。3. 内存告警日志端侧大模型对设备内存非常敏感。MemoryWarning.kt 中的isMemoryLow()会对比设备实际内存与模型要求的最低内存model.minDeviceMemoryInGb并输出形如Device memory (GB): ... Models required min device memory (GB): ...的 Logcat 日志TAG 为AGMemoryWarning。若报告中出现该日志且设备内存小于模型要求则「内存不足」很可能就是问题根因对应的 App 层弹窗文案位于 strings.xmlmemory_warning_*系列资源。4. 应用整体概览权限与入口理解 Bug 上下文还需知道应用「能做什么」。AI Edge Gallery 的权限声明集中在 AndroidManifest.xml包括摄像头CAMERA、录音RECORD_AUDIO、媒体读取READ_MEDIA_IMAGES/READ_MEDIA_VIDEO、日历读取READ_CALENDAR、通知POST_NOTIFICATIONS以及 AICore 绑定com.google.android.apps.aicore.service.BIND_SERVICE等。若 Bug 与「问图片Ask Image」「音频转录Audio Scribe」「日程相关 Skill」等能力相关报告中应重点检查对应权限是否被授予、dumpsys中相应服务是否异常入口为 MainActivity.kt支持通过自定义 schemecom.google.ai.edge.gallery://深度链接进入见 AndroidManifest 中的 intent-filter。提交高质量 Bug 报告的建议清单结合上述内容建议在提交 Issue 时一并提供设备信息机型、Android 版本、是否启用开发者选项复现步骤从哪个功能入口进入如 AI Chat、Ask Image、Agent Skills、Tiny Garden、Benchmark 等可参考 README.md 的功能列表触发了什么操作完整 Bug 报告bugreport-[...].txt或整个.zip并按上述AG*标签给出你观察到的关键日志片段内存上下文是否出现AGMemoryWarning的低内存提示、正在使用的模型名称与加速器权限状态若与相机/录音/媒体相关说明运行时权限是否已授予。若你的场景需要本地构建复现可参考 DEVELOPMENT.md构建前需配置 HuggingFace 开发者应用的clientId、redirectUri与appAuthRedirectScheme项目的整体定位与功能概览见仓库根目录 README.md。仓库当前尚未开放代码贡献见 CONTRIBUTING.md因此 Bug 报告是参与改进项目的主要途径——一份信息完整的完整报告是工程师快速定位并修复问题的最高效输入。赞分享人工智能大模型本地部署AI 应用移动开发AI AgentAI 技能MCP Clients【免费下载链接】galleryA gallery that showcases on-device ML/GenAI use cases and allows people to try and use models locally.项目地址https://gitcode.com/GitHub_Trending/gallery44/gallery点击查看免费下载相关推荐statsmodels 贡献指南实战从 Bug 报告到 Pull Request 的完整流程statsmodels 贡献指南实战从 Bug 报告到 Pull Request 的完整流程 本篇指南以 statsmodels 仓库的 CONTRIBUTI数据分析数据科学科研问题描述问题描述 清晰描述问题现象包括预期行为与实际行为差异 复现步骤 1. 导入proto文件: example.proto 2. 输入请求参数: {id: 开发工具NetBox 贡献指南从 Bug 报告到 Pull Request 的完整协作流程NetBox 贡献指南从 Bug 报告到 Pull Request 的完整协作流程 NetBox 是一个开源的网络基础设施管理IPAM/DCIM平台其代后端网络数据建模上一篇EdgeRemover 完整指南用 PowerShell 60 秒彻底卸载 Microsoft Edge 与 WebView2下一篇TrollInstallerX 免费一键安装完整指南iOS 14.0–16.6.1 装 TrollStore 只按一次按钮创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考