3 步导出 DiPlay 诊断报告：GitHub Issue 高效提交实用指南

【免费下载链接】DiPlayIndependent CarPlay receiver for compatible Android head units. Wired and wireless public preview.项目地址: https://gitcode.com/gh_mirrors/di/DiPlay

DiPlay 是面向比亚迪安卓车机的 CarPlay 接收器，遇到连接、黑屏、卡顿等问题时，一份DiPlay 诊断报告就是维护者定位原因最关键的材料。这篇指南带你走完全流程：报问题前的准备、3 步导出报告、提交前隐私自查、Issue 正文模板，读完后你能独立交出一份可复现、可定位、无隐私风险的完整问题报告。

报问题前的三件事

• 确认版本：打开 DiPlay 设置，确认当前版本号。请务必在最新版本（0.2.15）上复现问题再报，旧版本的问题可能已经修复，基于旧版本导出的报告参考价值有限。
• 先复现，记录故障时间：人为触发一次故障，例如 CarPlay 启动后卡死、无线连接断开，并记下发生的时刻。如果是开机自动启动类问题，故障发生后手动打开 DiPlay 继续操作即可，报告仍会包含启动诊断数据。
• 保留现场：出问题后先别重启车机、别清缓存、别卸载应用，诊断快照依赖当时的本机状态，环境一重置，线索就丢了。

三步导出报告

1. 打开设置 → 诊断 → 保存诊断报告；
2. 等待保存完成，弹窗会明确显示报告实际写入的路径；
3. 点弹窗里的查看报告 / 分享取走.txt文件。若车机上没有分享应用，在报告查看页长按文本即可复制全文。

文件命名规律是DiPlay-日期-时间-毫秒.txt（例如DiPlay-20261103-140507-123.txt），方便和故障时间对照，规则见 DiPlayActivity.kt。

不同 Android 版本的保存位置略有差异：

保存逻辑共 4 级降级，保证任何车机都能落盘，实现见 DiagnosticExportStore.kt。

隐私自查

报告包含：DiPlay 与系统版本、车机型号与主板信息、USB/无线连接模式、CarPlay 会话状态、仪表地图诊断、最近一次显示协商、启动诊断结果，以及脱敏后的会话日志。

脱敏＝日志写入存储前自动抹掉敏感内容，全程本地完成，规则在 DiagnosticRedactor.kt：

• 整行丢弃：含密码、token、证书、配对记录、SSID 等凭据特征的行，以及 TRACE / PHONE 协议行，直接不写入报告；
• 占位符替换：MAC 地址 →[address]，IP/IPv6 →[ip]，长十六进制标识符 →[identifier]；
• 容量上限：单个日志文件最多512 KB，滚动归档最多7 份，不会无限膨胀，见 SessionLogFile.kt。

但必须强调：自动脱敏无法 100% 识别所有厂商私有字符串。Issue 是公开的，提交前请逐条人工过目：

• 无热点密码、Wi-Fi 密钥
• 无个人昵称、自定义设备名
• 无私有认证文件内容
• 未手动删改报告（删掉关键行会让报告失效）

完整隐私说明见 PRIVACY.md。

Issue 正文怎么写

先搜后建：相同车型、相同固件的问题多半已经存在，直接给旧 Issue 补充报告，比新建更快推动修复。确认没有匹配的，再新建，正文按以下要素清单写：

• 车型 / 车机型号，Android 版本 + DiLink 版本 +完整固件号
• iPhone 型号与 iOS 版本
• 连接方式：USB、无线（蓝牙 + Wi-Fi Direct）、车机热点或同一局域网
• 相关设置项（分辨率、帧率、HEVC 等）、复现步骤、故障时间
• 诊断报告.txt：粘贴全文或作为附件

无线卡顿类问题可附上当时的网络环境描述，排查背景见 WIRELESS_DIAGNOSTICS.md。

不要把热点密码或私有认证文件写进 Issue，也不要手动删改报告内容，这两条是公开 Issue 的底线。

失败自救

• 导出失败，提示存储不可用：在弹窗中选择"选择保存位置"换一条路径；若仍失败，检查车机剩余空间后重试。
• 文件管理器打不开Android/data：这是车机系统限制，绕开它——用 DiPlay 自带的查看 / 分享取报告即可。
• 弹窗里没有分享应用：进报告查看页长按文本复制，再粘贴进 Issue 正文。
• 报告删不掉：已导出到Downloads的报告不会随应用卸载消失，请手动清理；降级目录则自动只保留最新 8 份。

能同时做到可复现、可定位、无隐私风险，你的 Issue 就会快人一步被修复。

【免费下载链接】DiPlayIndependent CarPlay receiver for compatible Android head units. Wired and wireless public preview.项目地址: https://gitcode.com/gh_mirrors/di/DiPlay