设置参考
设置的逐项参考：名称、控件、默认值、说明 —— 全部由代码与官方文案生成，改了代码重新生成即可对齐。
没有匹配的小节，换个关键词试试。
手册其它页面也没有匹配。
设置#
设置#
电台、定位、链路与数据
设置页顶部是 8 张分组卡（点进去是子页面），下面还有 6 个直达入口。本页把每个子页里的设置项逐条列出：名称、控件、默认值、说明 —— 默认值直接取自代码，改了代码重新生成即对齐。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 电台 | 分组卡 | — | 呼号 · SSID · 符号 |
| 定位上报 | 分组卡 | — | GPS · 信标 · 手动定位 |
| 连接 | 分组卡 | — | 服务器 · 过滤范围 |
| 显示 | 分组卡 | — | 坐标 · 主题 |
| 设备 | 分组卡 | — | 数据来源 · 链路与网关 |
| 数据 | 分组卡 | — | 清除本地数据 |
| 高级 | 分组卡 | — | 实验室 · 开发者 |
| 更新 | 分组卡 | — | 检查新版本 |
| 运动排行榜 | 直达入口 | — | 今日步数排行（只统计本机收到的报文） |
| 荣誉墙 | 直达入口 | — | 我的徽章与成就 |
| 翻译设置 | 直达入口 | — | 翻译接口、语言与自动翻译 |
| 导出 ADIF | 直达入口 | — | 会话导出为日志文件 |
| 主题 | 直达入口 | — | 自定义颜色、图标与文字 |
| 历史轨迹 | 直达入口 | — | 按天记录自己的速度与里程，保存在本机 |
| 备份与恢复 | 直达入口 | — | 打包配置与数据为 JSON 文件 |
| 赞助与鸣谢 | 直达入口 | — | 名单与赞助方式（服务器与地图流量都靠它） |
| 关于 | 直达入口 | — | |
| 生命守护 | 直达入口 | — | 心率异常时告警、拨打急救、向附近台站求助 |
电台#
电台#
呼号 · SSID · 符号
身份是所有报文的根：呼号必须与你的执照一致，SSID 决定台站类型（-9 车载、-7 手持常见）。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 高度（米，留空跟随定位） | 输入框 | — | 填了就用手填的这个海拔（更可靠：无气压计机型、室内、只有网络定位时 GPS 海拔常不可用），留空则跟随定位的海拔。发送时按英尺编成 /A=aaaaaa 六位；这是台站海拔，与下面 PHG 里的「天线高度」（高于当地平均地面）是两个不同的量。 |
| 功率（瓦） | 输入框 | — | 功率 / 天线高度 / 增益同属一个 PHG 数据扩展，填了任一项就一起编码发出（规范里它是固定的 7 字节字段）。功率取不超过实际值的最大档：25 W 报 25、30 W 也只报 25 —— 写大了等于虚报覆盖范围。天线高度是「高于当地平均地面」，与上面自动发送的 /A= 海拔是两个不同的量。 |
| 天线高度（英尺） | 输入框 | — | 功率 / 天线高度 / 增益同属一个 PHG 数据扩展，填了任一项就一起编码发出（规范里它是固定的 7 字节字段）。功率取不超过实际值的最大档：25 W 报 25、30 W 也只报 25 —— 写大了等于虚报覆盖范围。天线高度是「高于当地平均地面」，与上面自动发送的 /A= 海拔是两个不同的量。 |
| 增益（dB） | 输入框 | — | 功率 / 天线高度 / 增益同属一个 PHG 数据扩展，填了任一项就一起编码发出（规范里它是固定的 7 字节字段）。功率取不超过实际值的最大档：25 W 报 25、30 W 也只报 25 —— 写大了等于虚报覆盖范围。天线高度是「高于当地平均地面」，与上面自动发送的 /A= 海拔是两个不同的量。 |
独立状态报文 aprsStatusText | 输入框 | （空） | 这一点发的是独立一帧状态报文（> 开头、不含坐标、不会移动你在 aprs.fi 上的位置），与上面那行备注是两种不同的 APRS 报文。留空则发送内置的 APRSlocus 在线帧。 |
电台身份
呼号、SSID 与备注
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
呼号 myCall | 输入框 | BV2AAA | APRS 呼号，如 BV2AAA |
台站备注 myComment | 输入框 | （空） | 信标发送时的备注内容 |
| 发射 | 按钮 | — |
显示信息
我的符号与当前定位
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 网格 | 只读状态 | — | |
| 我的位置 | 只读状态 | — |
定位上报#
定位上报#
GPS · 信标 · 手动定位
三件事：用什么定位（GPS / 网络 / 手动）、多久报一次（默认 60 秒、最短 5 秒）、报什么（速度/方位角/电量可关）。
定位来源
选择坐标来源
无法自动定位时，可手动输入经纬度或用地图选点，用于信标上报与台站距离计算。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
手机 GPS模拟位置 useSimLocation | 选项卡 | 关 | 使用设备定位 / 模拟位置：手动输入坐标 |
传感器辅助定位 sensorAssist | 开关 | 开 | 同时可用时的优先级：模拟/手动位置 › 佳明（手表有实时数据时）› 手机 GPS |
| 定位来源 | 只读状态 | — |
定位模式
选择定位方式
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
纯 GPSGPS + 网络 · 纯网络 locationMode | 选项卡 | gps_network | 仅卫星定位，更省电 / GPS + 网络：网络仅作兜底（GPS 停更时），粗定位不写轨迹 / 纯网络：仅基站 / Wi-Fi，误差百米级；最省电，适合没有 GPS 的设备 |
| 网络定位时的台站图标 | 入口 | — | 纯网络定位的点可能偏几百米到几公里，换一个图标能让别人一眼看出「这是网络标的位」。默认跟随「我的符号」。 |
外置 GPS 优先时手机 GPS 待机 extGpsStandby | 开关 | 开 | 外置 GPS（佳明 LiveTrack）在推数据时，停掉手机的定位以省电；外置失效时会自动切回手机 GPS，并在状态栏与日志里说明。关掉它也不会让位置变错——位置优先级本来就是「外置优先」。 |
信标上报
发送间隔与上报内容
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
启用位置信标 beaconEnabled | 开关 | 开 | 经典＝一行（状态 + 立即上报）；详细＝多一行判据：当前档位、还差多少秒、距离打点还差多少米、转弯还差多少度，并每秒刷新一次。 |
纯网络上报间隔（秒） beaconNetInterval | 输入框 | 300 | 纯网络模式使用固定间隔；网络定位没有可靠速度，不使用智能信标（按速度 / 距离 / 转弯） |
上报间隔(秒) beaconInterval | 输入框 | 60 | 位置信标的发送间隔，至少 5 秒 |
智能信标(按速度分档) smartBeaconEnabled | 开关 | 关 | |
速度 beaconIncludeSpeed | 小开关 | 开 | |
方位角 beaconIncludeCourse | 小开关 | 开 | |
手机电量 beaconIncludeBattery | 小开关 | 开 | |
本次里程 beaconIncludeTripMileage | 小开关 | 关 | |
累计里程 beaconIncludeTotalMileage | 小开关 | 关 | |
步数 beaconIncludeSteps | 小开关 | 关 | |
| 今日步数 | 只读状态 | — | 步数来自手机的计步传感器（硬件计数，比用加速度计估算准）。可以随信标一起发出（STEPS=），对方也是 APRSlocus 时就能在运动排行榜里看到你。 |
| 授予「身体活动」权限 | 按钮 | — | |
| 定位状态 | 只读状态 | — | |
| 信标发送次数 | 只读状态 | — | |
| 下次上报 | 只读状态 | — | 当前定位来自网络（粗，误差常达几百米）—— 自动上报已暂停，GPS 恢复后自动继续；期间仍可手动上报。 |
| 开启射频信标 | 按钮 | — | |
强制接受网络定位自动上报 beaconForceCoarse | 开关 | 关 | 正在用网络定位（粗）上报 |
| 重新定位 | 按钮 | — |
连接#
连接#
服务器 · 过滤范围
APRS-IS 服务器与 Passcode、数据来源多选、接收范围（默认 300 km）、数据上限。改完点「保存并应用」才生效。
APRS-IS 连接
连接状态与信息
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 连接 | 只读状态 | — | |
服务器 server | 输入框 | rotate.aprs2.net | |
端口 port | 输入框 | 14580 | |
| WebSocket URL(可选) | 输入框 | — |
APRS-IS 连接
通过蓝牙或串口的 TNC 与电台直接收发
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 已绑定设备 | 只读状态 | — | |
| 连接 | 只读状态 | — | |
| 允许射频信标 | 只读状态 | — | TNC 模式下不使用服务器与过滤器，相关设置已停用 |
| KISS 参数 | 按钮 | — |
APRS-IS 连接
在电台 WLAN 设置里开启遥控并设置 Network User 名/密码，手机与电台保持同一网段。WLAN 电台局域网音频固定 12000 Hz。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 音频后端 | 只读状态 | — | |
| 采样率 | 只读状态 | — | |
| 连接 | 只读状态 | — | |
| 允许射频信标 | 只读状态 | — | 音频模式下不使用服务器、过滤器与 KISS 参数 |
| WLAN 电台直连WLAN 电台直连 | 按钮 | — | |
| 音频（声卡 TNC）音频（声卡 TNC） | 按钮 | — |
APRS-IS 连接
用蓝牙/串口读取电台输出的 Kenwood 航点语句（只收不发）
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 已绑定设备 | 只读状态 | — | |
| 连接 | 只读状态 | — | |
| PKWDWPL（Kenwood 航点） | 只读状态 | — | PKWDWPL 是只读链路：能收台站、不参与发射（发射请用 APRS-IS / TNC / 音频） |
| PKWDWPL 设备 | 按钮 | — |
接收范围过滤
过滤中心与接收半径
只接收设定范围内的台站数据包
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
过滤中心跟随我的位置保存并应用过滤 filterFollow | 开关 | 开 | |
过滤半径(km) filterRadius | 输入框 | 300 | 接收半径（km），点“保存并应用”生效 |
| 用我的位置作为过滤中心 | 按钮 | — |
数据上限
本地保留的数据量
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
最大台站数 maxStations | 输入框 | 100000 | 内存中保留的最大台站数量（默认不限制，可设更大值） |
数据包保留条数 maxPackets | 输入框 | 2000 | 数据包页面保留的历史条数（默认 2000，提高会占用更多内存） |
轨迹点数上限 maxTrackPts | 输入框 | 300 | 每个台站保留的轨迹点数（默认 300，决定运动轨迹能回溯多长；仅位移超过 20m 才记点） |
在线判定时长（分钟） onlineWindowMin | 输入框 | 5 | 台站最后上报超过该时长即视为离线（默认 5 分钟） |
接收呼号筛选
按国家/地区或呼号接收
除范围过滤外，按国家/地区分组或精确呼号接收台站
显示#
显示#
坐标 · 主题
深色模式、天气组件、单位与网格在这里；地图类型与离线地图在地图菜单与对应子页。另有一个公告横幅开关（默认开）：横幅显示在主页／地图的顶部，内容取自官网的公告区，改官网就能发通知、不用等新版；断网时显示上次缓存的那份，不想看到可以关掉（关掉后不再联网）。想主动查看时，用设置主页最底部的「公告」按钮 —— 它随时可点，读的是同一份内容。
全部
主题、语言与坐标显示
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
深色模式 darkMode | 开关 | 关 | |
天气组件 weatherEnabled | 开关 | 开 | |
公告 noticeBanner | 开关 | 开 | 当前主题已固定主色，请到「主题」页修改 |
| 单位 | 只读状态 | — | |
| 网格 | 只读状态 | — |
地图
地图类型与显示
「地图 2.0（矢量）」使用客户端实时矢量渲染，数据量小、缩放清晰；栅格图源为在线瓦片，画质取决于网络。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
始终显示地图标签 mapLabelsAlways | 开关 | 关 | 无论台站多少、缩放多小，都在地图上显示每个台站的呼号标签。 |
| 离线地图 | 入口 | — | 材质只作用于应用自己的表面（卡片、顶栏、导航栏、弹窗、地图浮层），不是系统窗口的透明。模糊要占显卡：旧机型上可能不如关闭时顺滑。 / 把地图瓦片预先下载到本机，没有网络时也能看地图 |
数据#
数据#
清除本地数据
只读统计与破坏性操作分开摆：清聊天记录是单独按钮，「清除所有数据」会二次确认。
聊天记录
联系人与聊天数据
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 聊天记录 | 选项卡 | — | |
| 清空全部聊天记录 | 按钮 | — |
台站列表
收到的台站与它们的轨迹，保存在本机
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 台站列表 | 选项卡 | — | |
| 清除台站列表 | 按钮 | — |
清除所有数据
删除本地记录
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 台站列表 | 选项卡 | — | |
| 聊天记录 | 选项卡 | — | |
| 群聊 | 选项卡 | — | |
| 日志 | 选项卡 | — | |
| 数据包 | 选项卡 | — | |
| 确认清除所有数据 | 按钮 | — |
离线地图
浏览地图时自动缓存，也可手动下载区域
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 离线区域 | 入口 | — | 已下载的区域可在地图上离线查看 |
高级#
高级#
实验室 · 开发者
横屏开关、演示数据（模拟台站/数据包）、收发计数与重新运行向导都在这里。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
允许手机横屏显示 labLandscape | 开关 | 关 | 实验室功能仍在测试中，可能影响使用体验。默认锁定竖屏，开启后支持横屏。 |
启用模拟数据（演示台站/数据包） devMode | 开关 | 关 | |
| 收包 / 发包 | 只读状态 | — | |
| 台站数量 | 只读状态 | — | |
| 连接 | 只读状态 | — |
设备#
设备#
数据来源、链路状态与自检
设备总览 = 当前链路 + 网关状态 + 四个子页入口（TNC / WLAN 电台 / 音频 / PKWDWPL）+ 链路自检与日志。
网关（iGate）
把射频收到的报文送上 APRS-IS
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
启用网关 igateEnabled | 开关 | 关 | |
双向网关（向射频转递消息） igateTwoWay | 开关 | 关 | 射频上一条报文都没收到：网关的条件已经全齐，但它无报文可转。这不是网关的问题 —— 报文根本没进到应用里。查上游：电台音量与静噪、天线、对方是否真的在发射，也可以在日志页确认有没有任何射频报文。 |
| 射频收到（条） | 只读状态 | — | |
| 已转递 → APRS-IS（条） | 只读状态 | — | |
| 已转递 → 射频（条） | 只读状态 | — | |
| 重复丢弃（条） | 只读状态 | — | |
| 环路拒收（条） | 只读状态 | — | |
| 清空统计 | 按钮 | — | |
| 允许射频信标 | 只读状态 | — |
当前链路
只读摘要 · 改参数请进对应子页
设备与参数
每条链路一个子页，各管各的参数
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| TNC 设备与参数 | 选项卡 | — | 蓝牙/串口绑定、初始化串、KISS 参数与发射自检 |
WLAN 电台直连 source | 选项卡 | AudioSource.device | 已连接 |
| 音频（声卡 TNC） | 选项卡 | — | 用声卡收发 AFSK 1200 报文 |
| PKWDWPL 设备 | 选项卡 | — | 绑定电台端口 · 查看航点接收状态 |
APRSlocusBOX connected | 选项卡 | 关 | 已连接 |
| 心率 | 选项卡 | — | 蓝牙心率带（标准心率服务），可随信标一起上报 |
| 佳明 LiveTrack | 选项卡 | — | 暂无日志 / 把佳明手表的活动实时位置接进来，随信标上报 |
TNC 设备与参数#
TNC 设备与参数#
蓝牙/串口绑定、初始化串、KISS 参数与发射自检
接蓝牙/USB TNC 的全部参数：绑定、初始化串、线速、KISS 定时参数、中继路径、发射自检。
蓝牙 TNC
绑定并连接电台侧的 TNC
两条链路绑定了同一台设备
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 已绑定设备 | 只读状态 | — | |
| 连接 | 只读状态 | — | 未找到设备 · 请先在系统蓝牙设置里配对 TNC，或插上 USB 串口线（OTG） |
| 扫描设备（蓝牙已配对 + USB 串口） | 按钮 | — | |
| 断开连接重启链路 | 按钮 | — | |
| 解除绑定 | 按钮 | — |
TNC 初始化串
连接后逐行发送（等价 APRSdroid 的 kiss.init）
若 TNC「能收不能发」，先在这里试：很多蓝牙/串口 TNC 模块上电停在命令模式，必须先收到 KISS ON、RESTART 等指令才进入 KISS 转发状态。每行一条命令（发送时自动补 CRLF）。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
行间隔 (ms) initDelayMs | 输入框 | 300 | 每行命令之间的等待时间。模块处理命令需要时间，太短会丢命令 |
串口线速 (bd) serialBaud | 输入框 | 9600 | USB 串口线与电台数据口必须同速，否则一个字节都收不到。常见值：9600 / 19200 / 38400 / 57600 / 115200。蓝牙 SPP 没有波特率概念，绑蓝牙设备时此项不生效。 |
| 发射串口 | 入口 | — | 当前绑的是蓝牙设备：蓝牙 SPP 没有波特率概念，此项不生效 / 已保存。默认与接收共用一个口；分开口可避免 Windows 上读写争用同一 COM 口。 |
| 立即发送初始化串 | 按钮 | — | |
| 未填写初始化串 | 选项卡 | — |
KISS 参数
直接下发到 TNC 的链路层参数
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
连接后下发 KISS 参数 pushKissParams | 开关 | 关 | 默认关闭（与 APRSdroid 一致）。打开后连接时会把上面的参数推给 TNC，覆盖它自己的配置 —— 参数不合适可能让它一直退避而不发射，所以只在需要统一管理时打开。 |
发射延时 (ms) txDelayMs | 输入框 | 300 | KISS TXDELAY，单位 10ms。发射前留给自己 PTT 建立的时间 |
发射尾音 (ms) txTailMs | 输入框 | 50 | KISS TXTAIL，单位 10ms。某些电台需要尾部保持才能收全 |
持续度 P persistence | 输入框 | 63 | KISS PERSISTENCE，0-255。越小越礼让，共用信道时能减少碰撞 |
时隙 (ms) slotTimeMs | 输入框 | 100 | KISS SLOTTIME，单位 10ms。与持续度共同决定信道竞争节奏 |
全双工 fullDuplex | 开关 | 关 | |
信道 / KISS 端口 channel | 输入框 | 0 | 多信道 TNC 才有多端口，单信道电台保持 0 |
帧长上限 (字节) maxFrame | 输入框 | 330 | 超过此长度的报文不会发出（1200bd 下 AX.25 单帧约 330 字节） |
射频中继路径 path | 输入框 | WIDE1-1,WIDE2-1 | 射频上使用的中继，如 WIDE1-1,WIDE2-1；留空则不指定 |
厂商命令码 hardwareCmd | 输入框 | -1 | KISS SETHARDWARE (0x06)，厂商自定义；-1 表示不下发 |
参数值 hardwareVal | 输入框 | 0 | KISS SETHARDWARE (0x06)，厂商自定义；-1 表示不下发 |
| 下发参数 | 按钮 | — | |
| 回到 TNC 命令模式 | 按钮 | — | |
| 请先连接 TNC | 选项卡 | — | |
| 回到 TNC 命令模式 | 选项卡 | — | KISS SETHARDWARE (0x06)，厂商自定义；-1 表示不下发 |
发射自检
向 TNC 写一帧测试包，判断问题在链路还是 TNC
发的是一帧状态包（不含坐标），不会把台站在 aprs.fi 上挪位置。若这里显示「已写入」却仍然不发射，问题在 TNC 侧：先试初始化串（KISS ON / RESTART），再检查 TxDelay 与信道占用。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 写入测试帧 | 按钮 | — |
射频（TNC）模式
射频信道是共享资源，消息能力相应受限
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
允许射频信标 rfBeacon | 开关 | 关 | 打开后才会在射频上定时发射位置。发射需以自己的呼号并在执照范围内操作 |
自动回复 ACK autoAck | 开关 | 开 | 关闭后不回应收到的消息回执，可减少射频占用 |
断开后自动重连 autoReconnect | 开关 | 开 |
WLAN 电台直连#
WLAN 电台直连#
局域网直连 Icom 电台（IC-705 / IC-9700 / IC-7610 / IC-905），收发 12 kHz PCM 音频与 CI-V 控制
局域网直连 Icom 电台（IC-705 / IC-9700 / IC-7610 / IC-905 等）：电台 IP/控制端口、Network User 认证、CI-V 地址与导前延时（TX Delay）、射频中继路径（如 WIDE1-1,WIDE2-1）、收发 12 kHz PCM 音频。
电台链路状态
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 启用 WLAN 电台直连 | 开关 | — | 开启后，APRS 音频收发数据源将直接绑定至 $… 局域网直连 |
| 射频收发统计 | 只读状态 | — | |
| 音频采样率 | 只读状态 | — |
电台网络参数
选择电台型号预置并配置 IP 与 Network User 凭据
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 电台 IP | 输入框 | — | |
| 控制端口 | 输入框 | — | |
| 用户名（Network User） | 输入框 | — | |
| 密码（Network User） | 输入框 | — | 提示：用户名和密码必须与电台内部 Network User Setting 完全一致。 |
CI-V 控制与发射设置
PTT 自动控制、前导延时与信标参数
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
允许射频信标 rfBeacon | 开关 | 关 | 是否允许通过电台射频自动周期发射信标（半双工，发射时自动静默监听）。 |
发射前导延迟 (TX Delay, ms) txDelayMs | 输入框 | 300 | |
| 电台 CI-V 地址 (十六进制) | 输入框 | — | |
| 控制器地址 | 只读状态 | — | |
射频中继路径 path | 输入框 | WIDE1-1,WIDE2-1 | 射频上使用的中继，如 WIDE1-1,WIDE2-1；留空则不指定 |
电台设置指引
在 Icom 电台上的必要准备步骤
音频（声卡 TNC）#
音频（声卡 TNC）#
用声卡收发 AFSK 1200 报文
把声卡当 TNC：采样率/比特率/音调、发射电平与 CSMA 等待、WAV 文件模式（离线解码录音）。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 播放设备 | 入口 | — | 要启用 / 切换数据来源（链路），请到「设置 → 设备」 |
音频采集
从麦克风/线路输入解调 AFSK 1200
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 音频后端 | 只读状态 | — | |
| 连接停止采集 · 重启音频链路 | 只读状态 | — | |
| 解调锁定 | 只读状态 | — | 解码中止 … 次（噪声/失步） |
| 收 … 帧 | 只读状态 | — | 当前平台不支持实时音频（可用 WAV 文件模式） |
音频（声卡 TNC）
用声卡收发 AFSK 1200 报文
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
采样率 sampleRate | 输入框 | 22050 | 22050Hz 是声卡 TNC 常用值；设备不支持时改用 44100/48000。修改会重启采集 |
| 比特率 | 输入框 | — | APRS 在 VHF 上固定 1200 bd（Bell 202），HF 才用 300 |
| 标号频率 (Hz) | 输入框 | — | Bell 202 规定标号 1200Hz、空号 2200Hz；只有 ±几 Hz 的容差，不要随意改 |
| 空号频率 (Hz) | 输入框 | — | 空号音调。与标号音调一起决定 FSK 频偏（标准为 1000Hz） |
发射前导 (ms) txDelayMs | 输入框 | 300 | 发射前导时长：给对端解调器锁定时间、给电台 PTT 建立时间 |
音频发射
发射前先听信道，避免与其它台站碰撞
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
允许发射 txEnabled | 开关 | 开 | 关闭后只接收不发射（只想听信标时最省心） |
允许射频信标 rfBeacon | 开关 | 关 | 打开后才会在射频上定时发射位置。发射需以自己的呼号并在执照范围内操作 |
发射前等待信道空闲 (ms) csmaWaitMs | 输入框 | 3000 | 检测到信道占用时最多等待多久；0 = 不等待直接发射 |
射频中继路径 path | 输入框 | WIDE1-1,WIDE2-1 | 射频上使用的中继，如 WIDE1-1,WIDE2-1；留空则不指定 |
帧长上限 (字节) maxFrame | 输入框 | 330 | 超过此长度的报文不会发出（1200bd 下 AX.25 单帧约 330 字节） |
| 发射电平 | 只读状态 | — | 发射前系统会把媒体音量拉到最大、并暂停麦克风采集；峰值太低或削顶都会让对端解不出 |
自动回复 ACK autoAck | 开关 | 开 | 关闭后不回应收到的消息回执，可减少射频占用 |
断开后自动重连 autoReconnect | 开关 | 开 | |
| 停止发射 | 按钮 | — |
WAV 文件模式
离线解码一段录音，或把报文导出成音频文件
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 待导出报文 (TNC2) | 输入框 | — | 格式 SRC>DEST,PATH:info，例如 BG7LZQ-9>APALOC:>TEST |
| 文件路径 | 输入框 | — | 离线解码一段录音，或把报文导出成音频文件 |
| 选择 WAV 文件 | 按钮 | — | |
| 导出到下载目录 | 按钮 | — | |
| 复制路径 | 按钮 | — | |
| 路径已复制 | 选项卡 | — | 接电台请用音频线（耳机口 → 电台数据口/话筒）；手机扬声器在 2200Hz 衰减很大，对着麦克风很难解出。对端是电脑上的 Direwolf 时，先用「导出」出的 WAV 验证一遍，能解出就说明问题在音频通路而不是协议 |
链路日志
暂无日志
PKWDWPL 设备#
PKWDWPL 设备#
绑定电台端口 · 查看航点接收状态
Kenwood 航点只读链路：绑定与状态、收到的航点计数、严格校验和（默认关，只标注不丢弃）。
设备绑定与状态
选择输出 语句的那个串口 / 蓝牙端口
两条链路绑定了同一台设备
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 已绑定设备 | 只读状态 | — | |
| 连接 | 只读状态 | — | |
| PKWDWPL（Kenwood 航点） | 只读状态 | — | 未找到设备 · 请先在系统蓝牙设置里配对 TNC，或插上 USB 串口线（OTG） |
| 扫描设备（蓝牙已配对 + USB 串口） | 按钮 | — | |
| 断开连接重启链路 | 按钮 | — | |
| 解除绑定 | 按钮 | — |
航点接收
绑定电台端口 · 查看航点接收状态
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 已收航点 … 条 | 只读状态 | — | |
| 丢弃/无效语句 | 只读状态 | — | |
| 校验和不符 | 只读状态 | — | |
| 其它 NMEA 语句（已忽略） | 只读状态 | — | 帧缓冲溢出 $… 字节 |
严格校验和（不符即丢弃） strictChecksum | 开关 | 关 | 默认关闭：验证不符时只标注并记日志，不丢句子 —— 本地线缆上的不符多半是固件格式与手册有出入，整条丢弃会让界面「什么都不显示」，反而更难排查 |
断开后自动重连 autoReconnect | 开关 | 开 | 暂无 PKWDWPL 日志 |
翻译设置#
翻译设置#
翻译接口、语言与自动翻译
目标语言、引擎（默认 auto 免密钥）、各引擎的密钥/实例地址、测试翻译。
翻译为
翻译接口、语言与自动翻译
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 翻译为 | 只读状态 | — | |
| 翻译接口 | 只读状态 | — | 翻译会把消息文本发送到你选择的第三方接口，请自行评估隐私 |
翻译接口
依次尝试多个免密钥接口，取第一个真正翻译成功的结果
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 本次实际使用 | 只读状态 | — | 开源、可自建最可靠；公共实例现已要求密钥且常不支持中文 |
实例地址 libreUrl | 输入框 | https://libretranslate.com | |
实例 API Key（公共实例需要，自建可留空） libreApiKey | 输入框 | （空） | |
Google API Key googleApiKey | 输入框 | （空） | Google Cloud Translation v2 的 API Key，需要自行到 Google Cloud 控制台申请 |
百度 App ID baiduAppId | 输入框 | （空） | |
百度密钥 baiduKey | 输入框 | （空） | 在百度翻译开放平台申请「通用文本翻译」，密钥只保存在本机 |
接口地址 customUrl | 输入框 | （空） | |
请求头 (JSON) customHeaders | 输入框 | {"Content-Type": "application/json"} | |
请求体模板 customBody | 输入框 | {"q": "{text}", "source": "{from}", "target": "{to}"} | 可用占位符：… 原文、… 源语言、… 目标语言。选择 GET 时忽略此项 |
结果字段路径 customResultPath | 输入框 | （空） | 用点号表示层级，数组用序号，如 data.translations.0.translatedText |
测试翻译
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 测试翻译 | 按钮 | — | |
| 翻译 | 只读状态 | — |
主题#
主题#
把界面配色、图标与常用文案改成你自己的
颜色 / 图标 / 文字 / 背景图四大块，改完可导出 JSON 分享；预设皮肤可一键切换。
颜色
逐项覆写配色；未修改的项跟随默认
卡片表面
有背景图时，卡片要多透才既看得见图又读得清字
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 不透明度（越低越透） | 选项卡 | — |
界面松紧与字体
只作用于卡片与输入框的留白，不改各处细节间距
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 松紧 | 选项卡 | — | 改的是卡片内边距；若某项看起来没变，说明那处留白是单独写死的 |
| 字体 | 选项卡 | — | 只使用系统已装的字体；某台设备没装时会自动回退，不会变方框 |
强调色
入口卡片的渐变色，以及每个页签自己的强调色
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 统一入口卡片配色 | 开关 | — | |
| 渐变起始色 | 选项卡 | — | |
| 渐变结束色 | 选项卡 | — |
背景图
用一张图片做整个界面的底；卡片会自动变得半透明
当前主题未使用背景图，界面底为纯色
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 移除背景图 | 按钮 | — | |
| 不透明度 | 选项卡 | — | |
| 模糊 | 选项卡 | — | |
| 填充方式 | 选项卡 | — | |
| 对齐 | 选项卡 | — | |
| 缩放 | 选项卡 | — | 背景图只存在本机：主题文件里只记录引用，不含图片本身，分享给别人后对方会看到无背景的主题。 |
卡片圆角
作用于卡片与输入框（小徽标等不受影响）
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 卡片圆角 | 选项卡 | — |
图标
为底部页签与设置入口换图标
Web 版不支持导入图片，请使用内置图标库
文字
覆写常用文案（按钮与错误提示不开放，避免界面变得不可操作）
导入与导出
主题是 JSON 文本，可以分享给别人，也可以手工编辑
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 导出时包含图片 | 开关 | — | 图片较大，无法通过剪贴板传递，请用「导出全部主题」保存为文件 |
| 导出全部主题 | 选项卡 | — | |
| 导入主题 | 选项卡 | — | |
| 从剪贴板导入 | 选项卡 | — | |
| 重置本主题 | 选项卡 | — |
皮肤信息
分享给别人时，这两项会跟着皮肤一起走
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 作者 | 选项卡 | — | |
| 说明 | 选项卡 | — | |
| 重命名 | 选项卡 | — |
预设与我的主题
把界面配色、图标与常用文案改成你自己的
预设主题不可修改，复制为我的主题后即可自由编辑
备份与恢复#
备份与恢复#
导出或导入配置与数据
一个 JSON 装下设置与数据；白名单导入防来路不明的文件改配置；导入后需重启生效。
备份与恢复
备份文件是 JSON 文本，换机或重装后可恢复；导入按分组覆盖，无法撤销。
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 备份文件包含呼号、服务器口令与 API 密钥，请妥善保管。 | 选项卡 | — | |
| Web 版请用「复制到剪贴板 / 从剪贴板粘贴」导入导出。 | 选项卡 | — |
导出备份
选择要包含的内容，然后保存为文件或复制到剪贴板
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 全选 | 按钮 | — | |
| 已保存到：… | 选项卡 | — | |
| 导出时包含图片 | 开关 | — | 备份会包含主题引用的图片本体；不包含时，换机恢复后主题会回退成内置图标 |
导入备份
选择之前导出的 JSON 备份文件
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
| 选择备份文件 | 按钮 | — | |
| 从剪贴板粘贴 | 按钮 | — |
离线地图#
离线地图#
把地图瓦片预先下载到本机，没有网络时也能看地图
瓦片缓存与「仅使用离线瓦片」开关；下载范围 = 当前所见那一屏，入口在地图菜单。
瓦片缓存
浏览地图时自动缓存，也可手动下载区域
| 设置项 | 控件 | 默认值 | 说明 |
|---|---|---|---|
缓存地图瓦片 tileCacheOn | 开关 | 开 | 浏览地图时把瓦片存到本机，之后可离线查看 |
仅使用离线瓦片 offlineOnly | 开关 | 关 | 不再从网络加载瓦片，只用已下载/已缓存的图（省流量） |
离线区域
已下载的区域可在地图上离线查看
范围太大（约 … 张瓦片），请缩小范围或降低最大层级