[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81669":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":8,"language":10,"languages":8,"totalLinesOfCode":8,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":8,"rankLanguage":8,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":8,"pushedAt":8,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":15,"starSnapshotCount":15,"syncStatus":28,"lastSyncTime":29,"discoverSource":30},81669,"amap-companion","zuo-qirun\u002Famap-companion","zuo-qirun",null,"https:\u002F\u002Famap-companion.zuoqirun.top","Java",44,16,38,1,0,3,6,9,3.69,"GNU General Public License v3.0",false,"master",true,[],"2026-06-12 02:04:18","# AMap Companion\r\n\r\nAMap Companion 是一个用于高德地图车机版广播数据的 Android 悬浮窗辅助应用。\r\n它会监听导航和巡航相关广播，并在可拖动悬浮窗中显示转向提示、红绿灯倒计时、车道信息、目的地、预计到达信息、道路提醒、电子眼提示、速度和部分协议详情。\r\n\r\n> 本项目由 AI 编写和维护，代码与文档仍建议结合真实车机环境继续验证。\n\n## 巡航红绿灯定制地图\n\n巡航模式下的多方向红绿灯（例如同一路口同时存在左转和直行倒计时）需要高德地图车机版额外广播 `CameraLightInfoWrapper` 的完整列表。原版高德通常只暴露单个方向字段，AMap Companion 无法稳定获得完整巡航红绿灯序列。\n\n- 定制地图 skill 仓库：\u003Chttps:\u002F\u002Fgithub.com\u002Fzuo-qirun\u002Famap-cruise-wrapper-skill>\n- 定制地图 skill ZIP 镜像：\u003Chttps:\u002F\u002Fgh-proxy.com\u002Fhttps:\u002F\u002Fgithub.com\u002Fzuo-qirun\u002Famap-cruise-wrapper-skill\u002Farchive\u002Frefs\u002Fheads\u002Fmaster.zip>\n- 已改好的高德地图：\u003Chttps:\u002F\u002Fgithub.com\u002Fzuo-qirun\u002Famap-cruise-wrapper-skill\u002Freleases\u002Fdownload\u002Fv20260523-cruise-wrapper\u002Famap-auto-cruise-wrapper-20260523.apk>\n- 已改好的高德地图镜像：\u003Chttps:\u002F\u002Fgh.llkk.cc\u002Fhttps:\u002F\u002Fgithub.com\u002Fzuo-qirun\u002Famap-cruise-wrapper-skill\u002Freleases\u002Fdownload\u002Fv20260523-cruise-wrapper\u002Famap-auto-cruise-wrapper-20260523.apk>\n\n该定制地图会额外发送 `lightsData`、`lightsCount` 和 `clearLights` 广播字段，用于显示和及时清除巡航红绿灯倒计时。\n\n## 主要功能\n\n- 可拖动悬浮窗，点击悬浮窗可打开主界面。\n- 支持用户自主选择目标应用包名，当前目标应用列表会过滤 `com.autonavi.*`。\r\n- 支持导航模式和巡航模式状态展示。\r\n- 支持显示高德 AMapAuto 广播协议中的车道信息。\n- 使用高德风格车道图标资源渲染复杂车道，避免简单箭头复用导致重叠和难以辨认。\n- 红绿灯倒计时使用醒目的胶囊样式，并支持方向相关红绿灯信息；巡航多方向红绿灯需要配合定制地图。\n- 支持显示目的地名称、剩余时间、剩余距离、当前道路、速度、道路类型、电子眼和道路提醒等信息。\r\n- 支持进入应用后自动检查更新，发现新版本时展示更新详情，并通过 Android `PackageInstaller` 安装。\r\n- 支持通过滑动条实时调整悬浮窗大小，悬浮窗和内容会同步缩放。\r\n\r\n## 构建方式\r\n\r\n本项目保持轻量化，没有使用 Gradle，直接通过 Android SDK build-tools 构建。\r\n在 Windows 本机执行：\r\n\r\n```powershell\r\n.\\build.ps1\r\n```\r\n\r\n构建完成后会生成：\r\n\r\n```text\r\namap_companion_signed.apk\r\n```\r\n\r\n服务端自动构建时可以通过环境变量覆盖版本号：\r\n\r\n```bash\r\nAPP_VERSION_CODE=1760000000 APP_VERSION_NAME=20260504-abcdef0 pwsh -NoProfile -ExecutionPolicy Bypass -File .\u002Fbuild.ps1\r\n```\r\n\r\n## 自动构建与发布\r\n\r\n仓库已配置 GitHub Actions。\r\n每次向 `master` 分支推送代码后，GitHub Actions 会自动：\r\n\r\n- 安装 Android SDK 和 build-tools。\r\n- 构建并签名 APK。\r\n- 上传 APK artifact。\r\n- 创建 GitHub Release，并附带可安装的 APK 文件。\r\n\r\n也可以在 GitHub Actions 页面手动触发构建。\r\n\r\n## 检查更新与自动升级\r\n\r\n应用内支持设置更新服务器地址，例如：\r\n\r\n```text\r\nhttp:\u002F\u002F你的服务器IP:8787\u002Fupdate.json\r\n```\r\n\r\n设置后，应用进入主界面会自动检查更新；也可以手动点击“检查更新”。如果服务器返回的 `versionCode` 大于当前应用版本，应用会先展示版本号和更新日志。点击“更新”后会下载 APK、校验 SHA-256，并通过 Android `PackageInstaller` 提交安装。\r\n\r\n如果系统要求用户确认安装，应用会自动打开系统确认界面。部分车机 ROM 可能限制普通应用安装未知来源 APK，失败时应用会显示 `PackageInstaller` 返回的状态信息，便于排查权限问题。\r\n\r\n服务器端代码位于：\r\n\r\n```text\r\nupdate_server\u002F\r\n```\r\n\r\n树莓派 Debian arm64 推荐只负责分发 GitHub Actions 构建出的 Release APK，不在树莓派本地构建。详细部署方式见：\r\n\r\n```text\r\nupdate_server\u002FREADME.md\r\n```\r\n\r\n## 更新日志\r\n\r\n项目更新日志见：\r\n\r\n```text\r\nCHANGELOG.md\r\n```\r\n\r\n服务器每次自动构建后还会生成面向客户端的：\r\n\r\n```text\r\nupdate_server\u002Fpublic\u002FCHANGELOG.md\r\n```\r\n\r\n## 签名说明\r\n\r\n当前 APK 使用仓库中的 `debug.keystore` 签名，以便后续构建可以覆盖安装到同一设备上的旧版本。\r\n签名信息说明见：\r\n\r\n```text\r\nSIGNING.md\r\n```\r\n\r\n请不要随意替换 `debug.keystore`，否则已安装版本可能无法直接升级覆盖。\r\n\r\n## 适用场景\r\n\r\n本应用主要用于配合高德地图车机版广播协议进行悬浮窗显示和调试。\r\n如果使用虚拟定位、修改版高德车机版或不同系统 ROM，广播字段和权限行为可能存在差异，需要结合实际环境测试。\r\n","AMap Companion 是一个用于高德地图车机版广播数据的 Android 悬浮窗辅助应用。它监听导航和巡航相关广播，在可拖动悬浮窗中显示转向提示、红绿灯倒计时、车道信息、目的地、预计到达时间等信息。核心功能包括支持导航模式和巡航模式状态展示，使用高德风格车道图标资源渲染复杂车道，以及通过滑动条实时调整悬浮窗大小。此外，该应用还支持自动检查更新并通过 Android `PackageInstaller` 安装新版本。适用于需要在车机环境中通过悬浮窗显示导航和巡航信息的场景，特别适合调试和测试高德地图车机版广播协议。",2,"2026-06-11 04:05:54","CREATED_QUERY"]