林枢 Android App 使用手册
软件完整部署与使用说明
一、整体架构说明
本软件采用「手机端APP + 独立服务端」的双层架构，无需在车机端安装任何程序，也无需开启车机ADB调试权限，仅需完成服务端部署 + 手机端登录配置，即可解锁并使用软件全部功能。
服务端仅需二选一部署：Windows系统设备可直接安装PC版服务端；Linux系统设备/服务器可使用Docker镜像部署。API配置操作均在服务端完成，手机端仅需完成账号登录与服务端关联。
二、前置准备
- 设备准备
- 智能手机1台：用于安装手机端APP，需保持正常联网
- 服务端设备（二选一即可，无需同时准备）：
① 搭载Windows系统的台式电脑/笔记本/主机，可稳定开机联网
② 搭载Linux系统的电脑/服务器，已配置好Docker运行环境
- 账号准备
请提前准备好比亚迪官方子账号。
⚠️ 核心提示：禁止直接使用比亚迪主账号登录本软件，否则会导致主账号在官方渠道被强制顶下线；使用子账号登录既不影响主账号正常使用，账号安全性也更有保障。
三、服务端部署（二选一执行）
方案A：Windows 系统 PC 端安装
1. 获取官方提供的Windows版服务端安装包，下载至本地电脑
2. 双击运行安装程序，按照界面指引完成安装路径选择、组件确认等步骤
3. 安装完成后启动服务端程序，进入设置界面，在对应栏目填写API配置信息并保存
4. 确认服务端界面显示「运行正常」，保持电脑开机、联网状态即可
方案B：Linux 系统 Docker 镜像部署
1. 登录Linux设备，确认Docker服务已正常启动
2. 通过官方提供的指令，拉取最新版服务端Docker镜像
3. 按照官方配置说明，设置容器运行参数，并在配置项中填写API相关信息
4. 执行启动命令运行容器，验证容器运行状态与服务连通性，确认部署成功
四、手机端 APP 安装与登录配置
1. 获取官方手机端APP安装包，在手机上完成安装，根据系统提示授予必要的基础权限
2. 打开APP，进入登录页面，输入比亚迪子账号信息完成登录（严禁使用主账号）
3. 登录成功后，在APP的服务端配置页面，填写已部署好的服务端连接信息，完成设备关联
4. 页面提示连接成功后，即可正常使用软件的全部功能
五、重要注意事项
1. 车机端无操作要求：本软件全程无需对车机进行任何安装、调试操作，无需开启ADB权限，不会修改车机系统设置
2. 服务端二选一原则：Windows PC版与Linux Docker版仅需部署其中一个，同时部署不会增加功能，反而可能导致连接冲突
3. 账号安全红线：必须使用子账号登录手机端APP，主账号登录会被官方系统顶号，影响账号正常使用
4. 运行稳定性要求：服务端设备需保持持续开机、联网状态，若服务端离线，手机端将无法正常使用相关功能
下面开始请app相关功能介绍。
目录如下
快速开始
认识首页
首次配置
授权与体验
车况详情
远控操作
行程统计
蓝牙钥匙
常见问题
关于我们
从安装到日常远控，一页看懂。
截图使用 v34 演示数据。实际车辆名称、电量、定位、设备码、账号状态和行程数据以你的 App 为准。部分页面内容较长，需要在 App 内继续下滑查看。
1
先配置连接
选择远程 API 或账号直连，填写地址、账号和操作密码。
2
确认授权状态
体验期可直接使用；需要授权时复制设备码并应用授权码。
3
再执行操作
刷新车况后再远控，确认车辆周边环境安全。
- 认识首页
首页完整截图
首页：车况、续航和远控入口
打开 App 后，首页会显示车辆状态、续航、电量/油量、定位卡片和远控入口。
顶部中间显示当前车辆名称。
顶部左侧显示车辆驱动/在线状态。
右上角齿轮进入设置。
点击车辆图片区域进入车辆详情。
底部导航可切换首页、蓝牙钥匙和行程。
如果车况未更新，可以下拉刷新；App 从后台回到前台时也会显示同款刷新提示并自动刷新车况。
- 首次配置连接模式
App 支持“远程 API”和“账号直连”两种连接方式。远程 API 可以通过局域网、公网、反向代理或内网穿透访问；需要 APK 内登录账号时再使用账号直连。
账号限制：当前只限授权账号使用，主账号/车主账号不支持。当前登录账号如果没有设置操作密码，任何远程操作都无法执行，包括解锁、上锁、空调、后备箱和车窗操作。
远程 API 模式
远程 API 设置完整截图
远程 API：连接外部林枢服务
点击右上角齿轮进入设置。
连接模式选择“远程 API”。
填写远程 API 地址，例如 http://192.168.1.100:38987、https://linshu.example.com 或内网穿透地址。
填写 6 位操作密码；如服务端启用 API PIN，请保持一致。
点击“保存配置”，再点击“测试连接”。
API 地址可以是局域网 IP、公网域名、HTTPS 反代地址或内网穿透地址；关键是手机当前网络能访问。127.0.0.1 只代表当前手机自己，连接电脑或服务器上的服务时不要填写它。
账号直连模式
账号直连设置完整截图
账号直连：在 APK 内登录车辆账号
连接模式选择“账号直连”。
填写 BYD 账号和密码。
选择车辆所属品牌体系。
多车账号可填写 VIN 固定目标车辆。
填写 6 位操作密码，点击保存或登录。
当前只限授权账号使用，主账号/车主账号不支持。当前登录账号必须设置操作密码，否则任何远程操作都无法执行。账号直连模式下，行程页暂不启用。若当前版本提示暂不支持某项直连能力，请以 App 内提示为准。
- 授权与体验
应用授权码弹窗截图
授权弹窗：粘贴 LS1 授权码
设置页中的“授权与体验”区域会显示体验期或授权状态，并提供设备码复制和授权码应用入口。
进入设置，找到“授权与体验”。
点击“复制”，把设备码发送给发码方。
收到 LS1... 授权码后点击“授权”。
粘贴授权码，点击“确认应用”。
设备授权码绑定当前设备码。
通用授权码不需要设备码。
体验或授权到期后，远控、账号直连、蓝牙保活等能力可能受限。
- 查看车况详情
车辆详情完整截图
车辆详情：车身、轮胎和系统状态
在首页点击车辆图片区域，或点击状态提示区域，可进入车辆详情页。
基本信息：总里程、HEV 里程、驱动状态、数据时间、VIN。
车身状态：前舱盖、天窗、后备箱、四门门/窗/锁状态。
轮胎状态：四轮胎压。
系统检测：动力、制动、转向、ABS、ESP、EPB 等状态。
- 执行远控操作
远控前请确认 App 已连接、车辆状态可信、周围环境安全，并已为当前登录账号配置操作密码。未设置操作密码时，任何远程操作都不能执行。
在首页点击目标操作，例如解锁、上锁、开后备箱或开空调。
确认弹窗中再次核对操作。
点击确认后等待执行结果。
操作完成后 App 会刷新车况。
支持的远控能力
解锁车门、上锁车门。
开/关后备箱。
开启或关闭空调，并可调整目标温度。
车窗操作：部分车型支持关窗，但大部分车型不支持开窗；尝试开窗时可能提示“权限变更”或无对应权限，这是车型/账号能力限制，不代表 App 故障。
鸣笛闪灯、闪灯示位。
上锁前 App 会尽量读取车况快照。若检测到车辆离线、未熄火、车门未关或已上锁，可能跳过上锁操作。远控能力由当前账号、车型和车辆权限共同决定；未设置操作密码时，所有远程操作都会失败。
- 查看行程统计
行程统计完整截图
行程页：筛选、统计和记录
底部点击“行程”进入数据仪表盘，可按时间、地址或统计周期查看里程、费用、能耗和目的地。完整截图已包含页面下方的单次行程记录。
搜索地址或关键字。
使用“全部、最近1周、最近1月、最近3月”快速筛选。
手动选择开始和结束日期。
点击“查询”或“刷新”加载行程。
切换“按日、按周、按月、按年”查看不同统计周期。
页面下方列出单次行程记录，包括出发时间、里程、行程类型、耗电/耗油、费用、起点和终点。
有轨迹数据的行程会显示“查看轨迹”；没有轨迹数据的行程会显示“无轨迹数据”。
行程数据来自远程 API 服务；账号直连模式下行程页暂不启用。行程轨迹依赖远程 API 返回的轨迹数据，不是每条行程都会有轨迹。
行程轨迹测试截图
轨迹页示例：测试路线和测试数据
行程轨迹示例
有轨迹数据时，点击单次行程里的“查看轨迹”可进入轨迹页，查看路线、起点、终点、里程、耗时、能耗和费用。
这张图为测试截图，地点和数据均为演示内容。实际轨迹以远程 API 返回的数据为准。
- 使用蓝牙钥匙
蓝牙钥匙完整截图
蓝牙钥匙：绑定设备并监测 RSSI
蓝牙钥匙用于绑定 BYD BLE3 数字钥匙，并在手机靠近或离开车辆时进行近场感应。当前本地蓝牙主要用于解锁和上锁；其他远控能力仍按首页的远程 API 或账号直连方式执行。
首次使用
先打开手机蓝牙，并按系统提示允许“附近的设备”或蓝牙权限；部分 Android 版本还需要允许定位权限。
进入“蓝牙钥匙”页，点击中央钥匙卡片；如果显示“未授权”，按提示生成二维码。
使用官方 BYD App 扫码完成本地数字钥匙授权和同步，等待页面显示“已授权”。二维码过期时重新扫码即可。
点击右上角放大镜搜寻附近设备，选择目标钥匙；也可以填写钥匙 MAC 地址和名称后手动绑定。
绑定成功后，钥匙卡片会显示名称、地址、连接状态和信号强度。首次建议在车旁完成绑定和一次解锁测试。
授权是 BYD 数字钥匙授权，绑定是选择手机要监测的 BLE 设备；两步都完成后，自动感应才可以正常工作。
蓝牙钥匙页面
中央钥匙卡片显示授权状态；点击“未授权”可以重新打开扫码授权，已授权时可通过卡片上的注销按钮移除本地数字钥匙授权。
右上角放大镜用于手动搜寻附近 BLE 设备。扫描列表中的名称和地址应与实际钥匙一致，不要绑定陌生设备。
“靠近自动解锁”开启后，手机进入解锁阈值并满足安全条件时尝试解锁。
“离开自动锁车”开启后，手机远离车辆、信号持续变弱或钥匙断连达到条件后尝试上锁。
“主驾开门即上电”需要先开启自动解锁；左前车门触发后请求车辆低压上电，不需要时建议关闭。
自动锁车与上一次自动解锁是否成功相互独立；解锁因车库、遮挡或弱信号失败时，离车后仍可能继续执行上锁判断。
距离阈值
“自动解锁阈值”：手机靠近到该信号强度时触发解锁判断。
“自动锁车阈值”：手机远离后，信号弱于该值并稳定一段时间才触发上锁判断。
“人在车内抑制阈值”：信号仍较强时认为钥匙可能在车内，抑制自动锁车，降低把钥匙锁在车内的风险。
RSSI 使用负数 dBm 表示，数值越接近 0 通常越近，例如 -55 dBm 比 -80 dBm 强。阈值不要设置得过于接近，避免车辆在边界位置反复解锁或上锁。
蓝牙高级设置
蓝牙高级设置完整截图
高级设置：直连间隔、超时和后台权限
“本地蓝牙”适合车旁快速解锁/上锁；“云端网络”适合不使用本地蓝牙时的远程操作。默认使用本地蓝牙，并可在本地失败且网络可用时回落云端。
弱信号确认时间越短，离开锁车越快；越长越稳。
钥匙消失锁车用于直连断开后的兜底离车锁车，适合地下车库或信号不稳定场景。
“后台常驻监测”用于锁屏或切到后台后继续感应；开启后必须允许通知、后台运行和电池不受限制。
“锁车安全校验”建议保持开启。开启后，上锁前会尽量确认车辆在线、已熄火、车门状态安全等条件。
“口袋补偿”用于手机放在口袋、包内或被遮挡时补偿信号衰减；误触发或耗电明显时可以关闭。
“快速重连间隔”和“普通连接超时”属于专家参数，一般保持默认值即可。
可以开启“无障碍唤醒”作为后台唤醒锚点；它只用于唤醒蓝牙监测，不读取屏幕内容，不执行点击或手势。
无障碍唤醒会在亮屏、解锁和窗口事件时节流确认后台服务存活；休眠结束后只触发一次直连唤醒突刺，不依赖后台 BLE 扫描。
小米/Redmi 等系统建议关闭睡眠省电，将 App 省电策略设为无限制，并在最近任务中锁定 App。
系统权限建议
蓝牙和附近设备权限：用于搜索、连接和监测钥匙。
通知权限：用于维持后台服务和展示后台运行状态。
电池优化：将林枢设为“不优化”或“无限制”，避免锁屏后服务被系统停止。
自启动、后台活动和最近任务：允许林枢后台运行；部分厂商还需要锁定最近任务。
无障碍唤醒：仅在需要增强锁屏/休眠唤醒时开启，并在系统无障碍设置中启用“林枢蓝牙唤醒”。
蓝牙自动解锁和自动锁车不是绝对可靠的安全装置。首次使用、调整阈值或更换手机后，请在车旁观察实际结果；离车前仍应手动确认车辆已经锁好。
- 常见问题
手机连不上远程 API
确认 API 服务已启动。
确认 API 地址是手机可访问的地址；可以是局域网 IP、公网域名、反向代理或内网穿透地址。
如果使用局域网 IP，确认手机和服务端在同一网络。
如果使用公网或内网穿透，确认域名、隧道、证书和防火墙正常。
确认 API PIN 正确。
远控失败或一直超时
确认当前账号具备对应远控权限。
确认当前账号为授权账号；主账号/车主账号不支持。
确认当前登录账号已经设置操作密码；未设置操作密码时，所有远程操作都会被拒绝。
确认车辆在线，服务端能正常刷新车况。
确认操作密码是 6 位数字。
在桌面端或命令行验证同一账号是否能完成相同操作。
为什么开窗提示权限变更
大部分车型本身不支持远程开窗，部分车型只支持关窗。开窗时如果提示“权限变更”、无权限或不支持，通常是车型或当前账号的能力限制，并非 App 配置错误。请以车辆和账号实际返回的能力为准。
主账号可以使用吗
不支持。当前只限授权账号使用，主账号/车主账号不支持远控、车况和行程相关能力。
授权码无法应用
确认授权码完整，并以 LS1. 开头。
确认设备授权码绑定了当前设备码。
确认授权码未过期，且已到生效时间。
确认 APK 使用了与授权码匹配的公钥。
蓝牙钥匙后台不稳定
确认蓝牙和定位相关权限已允许。
确认通知权限已允许。
在蓝牙高级设置里打开“无障碍唤醒”，并在系统无障碍设置中启用“林枢蓝牙唤醒”。
确认系统没有限制后台运行、自启动或电池优化。
如果后台长时间没有响应，先打开蓝牙钥匙页确认钥匙绑定和授权状态，再到蓝牙高级设置重新检查通知、电池优化、自启动和无障碍唤醒。
确认绑定的 MAC 地址正确，阈值没有设置得过于接近。
其他说明！
版本更新：显示当前安装版本，并可点击“检查更新”。
免责声明：说明林枢是个人辅助工具，并非比亚迪官方应用，也不代表相关车企或平台授权、背书或合作。
用户协议：使用本应用前，请确认你拥有相关车辆和账号的合法使用权限，不要用于未经授权的车辆、账号或违法违规场景。
隐私说明：App 自身不主动收集、上传或出售个人信息，不内置用户行为统计、埋点或广告 SDK；行程统计属于你主动查看的车辆/行程数据展示，配置仅用于你主动启用的连接和车辆操作。
远控、蓝牙感应、账号直连等能力都有实际车辆操作风险。执行操作前请确认车辆状态可信、周围环境安全，并妥善保管账号、密码、设备码和授权码。
使用边界
林枢是个人辅助工具，并非比亚迪官方应用。请只在合法、安全、可确认车辆状态的场景中使用远控和蓝牙自动感应能力。执行解锁、上锁、空调、车窗、后备箱等操作前，请确认车辆周边环境安全。
本期公共授权码：LS1.AUaVkfo25l0MRscrn-oKI3zbZWD-I9XYqkfgQ-u_axEVbvKroE0A4uy3-rXqg_DIdeIdtrV4MUbZup0F-HqZFnLwQ3Q4Hq-J7LFo1RPUCkkawcfawx1vBur2LfmqhIziCU040QXNIKHuLRpN6sR_f1vdr9zhPRPAw-ZC_lvrJharsC4B_P1VuSScCq8X2o_HYCOyqhsVxIkKhlCf0NK7wpSG1Lpf8EEu0QMZlu8kuTvIdFEtWmZcFiFm.MEUCIQDXhFtNko3hADX8-YZWFnsYeSybJc_oJtk4Gh336_AyKQIgCSXAezMBApPzy_Gw8jqFaA6W4Kd8iwnCjYnjasPIZPg（有效期至：26年10月01日）
评论 (0)