


手机上有几样东西只有手机自己拿得到:系统记下的哪个应用什么时候到了前台、手机上装了哪些应用、人大概在哪儿、手机系统记的步数。我在安卓手机上装了一个自己写的小 App(手机上叫“个人采集”),它请系统约每 15 分钟叫醒一次(实际可能延迟),把这几样补拉下来、存成文件留在手机里;电脑在家时每半小时经无线调试来收一次;AI 刷新手机来源时,个人理解库再导入,用来算手机用了多久、查去过哪、看装了什么、查手机步数。另外,打开 App 的“流量统计”页,能直接看每天、每周、每月 Wi-Fi 和两张卡各用了多少流量、哪个应用用得多;这一页打开才读,不经过电脑。采集的东西不往外网传,平时也不在通知栏常驻;被系统杀掉,已经写下的也不丢;没采到的时段明写是缺口,不补猜。它还多了一个小用处:电脑连不上手机的 Wi-Fi 时,可以经蓝牙连进来,这时通知栏短暂出现“电脑经蓝牙连接中”,连完自己退出。这条路只给 AI 临时取东西用;每半小时的定时收取仍然只走局域网或 USB,手机在外面不会被定时收。网页上只讲做法,不放任何定位点、使用记录、步数、流量和装机清单。

手机上有几样东西只有手机自己拿得到:系统记下的哪个应用什么时候到了前台、手机上装了哪些应用、人大概在哪儿、手机系统记的步数。我在安卓手机上装了一个自己写的小 App(手机上叫“个人采集”),它请系统约每 15 分钟叫醒一次(实际可能延迟),把这几样补拉下来、存成文件留在手机里;电脑在家时每半小时经无线调试来收一次;AI 刷新手机来源时,个人理解库再导入,用来算手机用了多久、查去过哪、看装了什么、查手机步数。另外,打开 App 的“流量统计”页,能直接看每天、每周、每月 Wi-Fi 和两张卡各用了多少流量、哪个应用用得多;这一页打开才读,不经过电脑。采集的东西不往外网传,平时也不在通知栏常驻;被系统杀掉,已经写下的也不丢;没采到的时段明写是缺口,不补猜。它还多了一个小用处:电脑连不上手机的 Wi-Fi 时,可以经蓝牙连进来,这时通知栏短暂出现“电脑经蓝牙连接中”,连完自己退出。这条路只给 AI 临时取东西用;每半小时的定时收取仍然只走局域网或 USB,手机在外面不会被定时收。网页上只讲做法,不放任何定位点、使用记录、步数、流量和装机清单。


装好、放行一次以后,采集和电脑收文件都自动进行;AI 刷新手机来源时再导入理解库,回答前先看最近导入到哪天、有没有缺口。想知道什么,直接问 AI;想看流量,打开 App 的“流量统计”页。

先在电脑上构建出安装包,再让手机连上电脑(插线,或已配对且在线的无线调试都行,第一次可能要在手机上点确认),跑一条安装命令:装好 App、给权限、打开一次,再把第一轮的状态取回电脑核对。要给的是使用情况访问、所有文件访问、定位(含后台)、忽略电池优化、蓝牙连接(电脑经蓝牙连手机时要用),以及系统健康应用(Health Connect)里的步数、后台读取、历史步数三项;手机不让命令代开时,到 App 的“权限”卡点进去自己开。再在手机系统里放行自启动和后台。想分开看两张卡的流量,首次安装、换卡、调换卡槽或清除 App 数据后,还要让电脑做一次分卡初始化。之后不用再打开它。以后升级只换新版:不重新授权、不打开 App,权限和分卡设置都留着;所以只换新版的旧安装不一定有蓝牙连接这项,要用就重跑一次完整安装。权限被撤销了,再回“权限”卡打开。

它请系统约每 15 分钟叫醒一次,实际可能延迟;开机、解锁、App 更新以后也会重新登记;MacroDroid 每小时再推它一下。每一轮补拉新的使用事件、回读系统记的手机步数、看装机清单变没变、看定位够不够新,写完文件就退出。

电脑每 30 分钟经无线调试来收一次。出门在外、在家只开数据网络都算正常,文件先留在手机上,回家连上 Wi-Fi 后一并补收。这条定时收取只走局域网或 USB,蓝牙转发不改变这一点。AI 在外面临时要手机上的东西,是另一件事,见手机直取。电脑核对指纹后存进本地的个人资料目录;AI 刷新手机来源时,个人理解库再从那里导入。

打开 App 的“采集概览”页:最近一轮是什么时候、今天补拉了多少、近 24 小时实际运行几次(含打开 App 和手动采集)、最长隔了多久、最近一次被系统停掉的原因、步数回读到哪,以及七项开没开(使用情况访问、所有文件、健康步数、后台回读、历史步数、电池白名单、通知;定位授权在系统设置里看)。“刷新”只重新读一遍状态,不会启动采集;要马上跑一轮,点“立即采集一次”。电脑这边,手机桥每次检查也看它多久没出新文件,超过 2 小时算不新鲜。

左右滑到“流量统计”页:按北京时间的日、自然周、月翻看系统还留着的历史,可以筛 Wi-Fi、SIM1、SIM2 和总量、下载、上传,下面列出有流量记录的全部应用。打开或切日期时才读系统接口,不在后台采,也不上传;日常不靠电脑和无线调试。它只告诉你哪个应用用了多少流量,认不出访问了哪个网站。

装好、放行一次以后,采集和电脑收文件都自动进行;AI 刷新手机来源时再导入理解库,回答前先看最近导入到哪天、有没有缺口。想知道什么,直接问 AI;想看流量,打开 App 的“流量统计”页。

先在电脑上构建出安装包,再让手机连上电脑(插线,或已配对且在线的无线调试都行,第一次可能要在手机上点确认),跑一条安装命令:装好 App、给权限、打开一次,再把第一轮的状态取回电脑核对。要给的是使用情况访问、所有文件访问、定位(含后台)、忽略电池优化、蓝牙连接(电脑经蓝牙连手机时要用),以及系统健康应用(Health Connect)里的步数、后台读取、历史步数三项;手机不让命令代开时,到 App 的“权限”卡点进去自己开。再在手机系统里放行自启动和后台。想分开看两张卡的流量,首次安装、换卡、调换卡槽或清除 App 数据后,还要让电脑做一次分卡初始化。之后不用再打开它。以后升级只换新版:不重新授权、不打开 App,权限和分卡设置都留着;所以只换新版的旧安装不一定有蓝牙连接这项,要用就重跑一次完整安装。权限被撤销了,再回“权限”卡打开。

它请系统约每 15 分钟叫醒一次,实际可能延迟;开机、解锁、App 更新以后也会重新登记;MacroDroid 每小时再推它一下。每一轮补拉新的使用事件、回读系统记的手机步数、看装机清单变没变、看定位够不够新,写完文件就退出。

电脑每 30 分钟经无线调试来收一次。出门在外、在家只开数据网络都算正常,文件先留在手机上,回家连上 Wi-Fi 后一并补收。这条定时收取只走局域网或 USB,蓝牙转发不改变这一点。AI 在外面临时要手机上的东西,是另一件事,见手机直取。电脑核对指纹后存进本地的个人资料目录;AI 刷新手机来源时,个人理解库再从那里导入。

打开 App 的“采集概览”页:最近一轮是什么时候、今天补拉了多少、近 24 小时实际运行几次(含打开 App 和手动采集)、最长隔了多久、最近一次被系统停掉的原因、步数回读到哪,以及七项开没开(使用情况访问、所有文件、健康步数、后台回读、历史步数、电池白名单、通知;定位授权在系统设置里看)。“刷新”只重新读一遍状态,不会启动采集;要马上跑一轮,点“立即采集一次”。电脑这边,手机桥每次检查也看它多久没出新文件,超过 2 小时算不新鲜。

左右滑到“流量统计”页:按北京时间的日、自然周、月翻看系统还留着的历史,可以筛 Wi-Fi、SIM1、SIM2 和总量、下载、上传,下面列出有流量记录的全部应用。打开或切日期时才读系统接口,不在后台采,也不上传;日常不靠电脑和无线调试。它只告诉你哪个应用用了多少流量,认不出访问了哪个网站。


已经写下的不会丢:每次追加都先落盘,断点只在一段事件全部写好后才往前走。下次醒来从断点往前多查 2 分钟接着补,重复的按整条记录去掉。

系统能留多久的使用事件,随手机系统而变。App 第一次查到非空结果时,记下那一次拿到的最早时间:这只是当时观测到的下限,不会随日历变长,也不是完整的保留期。过期了或从没采到的补不回来,就记成缺口,按“确定没采到”“可能已过期”“说不准”三档写明,不补猜。另外,App 自己读不到双开空间(第二个微信)的系统使用事件。10 月 31 日起,电脑每次收取连上手机时,距上次成功满 2 小时就另读一次双开空间最近 24 小时的事件,单独交给理解库;连不上或没读到的时段,仍不能当作没用。

每段最多查 6 小时;返回满 2 万条就对半拆开重查。拆到 1 分钟以内还是满的,保存已经拿到的,再记一条“查询到上限”的缺口。

没有文件权限或存储还没准备好时,运行、退出记录和 0.1.17 起新收到的定位先存进 App 自己的保护目录,恢复后按原时间补写出去。这段时间没采的使用事件和装机清单,不拿内部数据冒充。但卸载 App 或清除它的数据,会把还没导出的这些内部记录一起删掉;之后共享存储恢复了,也找不回来。

平时请系统定位服务约每 15 分钟送点,实际可能延迟;采集运行时若距上次写入已满 31 分钟,才尝试一次最长 60 秒的单次定位。请求开始前的旧缓存位置不收。0.1.13 起,状态里另存最近 48 批送点的判定证据(不含坐标):每批记下什么时候收到、带了几个点、每个点是写进去了,还是不合法、时间没更新、没到 10 分钟被跳过或保存失败。夜里空了一段,先看这里分清是系统根本没送点,还是送到了却没写进去;这份证据本身出错也不影响正常采集。它只用来查原因,不能拿来说夜间空档已经修好。0.1.19 起,同一次开机里改用不受改时间影响的系统时钟判断新旧和间隔,不再因为位置自带的时间和系统时间对不上,把新点当旧点跳过;这修的是一种具体误判,同样不证明夜里不再断。

只算系统自己记的本机步数,别的应用写进去的只列名字、不算数。没给权限、后台或历史权限缺一项、手机系统版本不够、确认不了来源、读取出错,都写明原因;系统没返回的 15 分钟不当 0 步,系统明确给 0 才记 0。每次往回多读 24 小时,接住系统迟到或改过的数。没给历史权限时,最早只读到首次授权前 30 天。

系统没保留的历史不补成 0,页面写“已有记录”并说明有缺口。还没做分卡初始化或某张卡读取失败,就在那张卡下写原因。Wi-Fi 包含局域网,无线调试也算在 Wi-Fi 里,不要重复相加。

同一时间只让一台手机采集:新手机开始采集后,关掉旧手机的采集。电脑上的数据按换机日期前后区分,不按设备区分。

先分清是手机没产出、没连上,还是连上了没收到。不在家不算错误;开机或连上 Wi-Fi 时 MacroDroid 会自动重新打开无线调试,电脑按新端口找到手机再收。

最后一行只写了一半,电脑导入时先忽略,下次补齐再收;中间的坏行记成缺口,前后好的照收。开机还没解锁、系统查不出数据时,断点也不往前走。


已经写下的不会丢:每次追加都先落盘,断点只在一段事件全部写好后才往前走。下次醒来从断点往前多查 2 分钟接着补,重复的按整条记录去掉。

系统能留多久的使用事件,随手机系统而变。App 第一次查到非空结果时,记下那一次拿到的最早时间:这只是当时观测到的下限,不会随日历变长,也不是完整的保留期。过期了或从没采到的补不回来,就记成缺口,按“确定没采到”“可能已过期”“说不准”三档写明,不补猜。另外,App 自己读不到双开空间(第二个微信)的系统使用事件。10 月 31 日起,电脑每次收取连上手机时,距上次成功满 2 小时就另读一次双开空间最近 24 小时的事件,单独交给理解库;连不上或没读到的时段,仍不能当作没用。

每段最多查 6 小时;返回满 2 万条就对半拆开重查。拆到 1 分钟以内还是满的,保存已经拿到的,再记一条“查询到上限”的缺口。

没有文件权限或存储还没准备好时,运行、退出记录和 0.1.17 起新收到的定位先存进 App 自己的保护目录,恢复后按原时间补写出去。这段时间没采的使用事件和装机清单,不拿内部数据冒充。但卸载 App 或清除它的数据,会把还没导出的这些内部记录一起删掉;之后共享存储恢复了,也找不回来。

平时请系统定位服务约每 15 分钟送点,实际可能延迟;采集运行时若距上次写入已满 31 分钟,才尝试一次最长 60 秒的单次定位。请求开始前的旧缓存位置不收。0.1.13 起,状态里另存最近 48 批送点的判定证据(不含坐标):每批记下什么时候收到、带了几个点、每个点是写进去了,还是不合法、时间没更新、没到 10 分钟被跳过或保存失败。夜里空了一段,先看这里分清是系统根本没送点,还是送到了却没写进去;这份证据本身出错也不影响正常采集。它只用来查原因,不能拿来说夜间空档已经修好。0.1.19 起,同一次开机里改用不受改时间影响的系统时钟判断新旧和间隔,不再因为位置自带的时间和系统时间对不上,把新点当旧点跳过;这修的是一种具体误判,同样不证明夜里不再断。

只算系统自己记的本机步数,别的应用写进去的只列名字、不算数。没给权限、后台或历史权限缺一项、手机系统版本不够、确认不了来源、读取出错,都写明原因;系统没返回的 15 分钟不当 0 步,系统明确给 0 才记 0。每次往回多读 24 小时,接住系统迟到或改过的数。没给历史权限时,最早只读到首次授权前 30 天。

系统没保留的历史不补成 0,页面写“已有记录”并说明有缺口。还没做分卡初始化或某张卡读取失败,就在那张卡下写原因。Wi-Fi 包含局域网,无线调试也算在 Wi-Fi 里,不要重复相加。

同一时间只让一台手机采集:新手机开始采集后,关掉旧手机的采集。电脑上的数据按换机日期前后区分,不按设备区分。

先分清是手机没产出、没连上,还是连上了没收到。不在家不算错误;开机或连上 Wi-Fi 时 MacroDroid 会自动重新打开无线调试,电脑按新端口找到手机再收。

最后一行只写了一半,电脑导入时先忽略,下次补齐再收;中间的坏行记成缺口,前后好的照收。开机还没解锁、系统查不出数据时,断点也不往前走。







- 手机:PersonalOS/Collector/ 下 events、runs、exits、steps 按北京日期分文件,packages 按日期放快照,另有 status.json、state.json、steps-state.json;定位在 PersonalOS/Location/Collector/,一天一个 CSV;流量页的卡槽映射只在 App 私有 files/traffic-sims.json
- 电脑:本地个人资料目录的来源投递区(手机自动同步),不进 Git
- 代码:私有仓库 wlyaaaaa/phone-collector,Kotlin,只放代码和合成测试数据
- 这个 App:只做只有手机能做的——补拉使用事件、装机清单、定位、回读系统步数、显示本机流量、记自己的运行;另外按连接短暂把蓝牙转到手机本机调试端口,让电脑连不上 Wi-Fi 时也能用 adb,不碰采集文件
- 电脑配置(PCConfig):每 30 分钟收文件;手机桥管通知、验证码和剪贴板,也查采集 App、短信备份和 MacroDroid 心跳新不新
- 个人理解库:刷新手机来源时导入,算手机用时,查去过哪、装了什么、手机步数;手机步数只补手表没戴或没电的时段,怎么合并归健康项目,这里不合并
- 现成 App:MacroDroid 定时叫醒、自动开无线调试;SMS Backup & Restore 备份短信和通话
- 构建:在仓库根跑 pwsh -NoProfile -File .\
tools\ Build-Collector.ps1 -TempRoot <临时父目录>,依次跑单元测试、lint,出 debug APK(app/build/outputs/apk/debug/app-debug.apk);要本机 Gradle、JDK 21 和 Android SDK,专用临时目录用完送回收站 - 安装:pwsh -NoProfile -File .\
tools\ Install-Collector.ps1 -OutDir <新的输出目录>;前提是已经有上面的 debug APK、手机经 adb 在线(插线或已配对的无线调试都行,不强制 USB;未授权的设备仍要本人在手机上确认)。它装好、授权(含健康三项,手机拒绝时到 App“权限”卡手动开)、打开 App,等到这次新的 run.id 才取回 status.json,末尾 JSON 列出每步结果和失败原因 - 多台设备加 -Serial,-Apk 换别的包;-DryRun 只打印命令和汇总,不调用 adb、不碰手机;每次用新的输出目录,免得和上次的文件混在一起
- 只更新:同一脚本加 -UpdateOnly(-OutDir 仍要给,可带 -Serial、-Apk、-DryRun)。先确认 APK 包名是 cn.wly.collector、手机已装且只有一个 APK,adb install -r 后核对已装 APK 的 SHA-256;不重新授权、不动白名单、不打开 App。入口和分支已核对,还没有实际更新回执
- 流量分卡初始化:python -B tools/initialize_traffic_sims.py --work-dir <E 盘任务临时目录>。首次安装、换卡、调换卡槽或清除 App 数据后跑一次,真实卡身份不进电脑、源码和日志;日常查看不需要它
- 蓝牙调试转发:前提是电脑和手机已配对、电脑类设备建立蓝牙连接(耳机不触发)、有 BLUETOOTH_CONNECT 权限、手机本机 5555 调试端口已由电脑打开(手机重启后要重新开)。完整安装会授予这项权限,-UpdateOnly 不重新授权
- 格式的唯一说明是 docs/data-format.md,下面每个组件对应其中一节
- CollectorRuntime.kt:周期任务、开机和 RUN 广播、调度事件 ↔「自身运行与退出」
- CollectorEngine.kt、CollectorLogic.kt:每轮各步、分段补拉、规范 JSON 去重、装机快照、退出记录、status ↔「原始使用事件与断点」「装机清单」「状态和电脑端导入」
- LocationSchedule.kt、LocationCollector.kt:系统送点和单次后备 ↔「状态和电脑端导入」的定位部分;0.1.19 起同次开机按单调时钟(elapsedRealtimeNanos)判断新旧和间隔,跨开机或缺这个时钟证据时才回退日历时间
- BluetoothBridge.kt:蓝牙转发,只接受已配对且加密的 RFCOMM(服务名 PCConfig ADB Bridge),把字节转到手机本机 127.0.0.1:5555,沿用 adb 自己的 RSA 授权;同一时刻只转发一个连接;首次 60 秒没人接入就退出,连接结束后再等 30 秒,没人重连或电脑蓝牙链路断开也退出。运行时是连接设备前台服务,挂一条低重要度通知;INTERNET 权限只用来连本机回环,不连外网
- JsonStore.kt:追加后落盘、临时文件原子替换 ↔「文件与提交规则」
- MainActivity.kt:两个页签的主页面;采集概览里“刷新”只读状态,“立即采集一次”才跑一轮
- StepCollector.kt、HealthPermissionsActivity.kt:Health Connect 回读、权限入口和用途说明 ↔「系统手机步数」
- TrafficReader.kt、TrafficPage.kt、TrafficDates.kt:流量统计页,NetworkStatsManager 按需读取 ↔ README「手机流量查看」
- app/src/test:14 个带 @Test 的测试文件分别对着上面的组件和页面截图(11 月 6 日静态数)
- 15 分钟是请求周期,什么时候真跑由系统定,不保证准时;定位送点同样
- 退出记录来自系统有限的环形缓冲,只查本 App;进程被冻住不会留下退出记录;SIGKILL 不能一律当成厂商强杀
- 调度事件只留最近 48 条,更早的会被盖掉,缺事件不证明没发生;“线程完成”只表示执行结束,不代表采集成功
- 送点证据(0.1.13 起)同样只留最近 48 批,每批只记前 8 个点和省略数;每个点标 saved(写入)、invalid(不合法)、non_new(时间没更新)、interval_gate(没满 10 分钟)或 save_error(保存失败,只记错误类别不记正文),不含坐标;收到时刻是取得处理锁后开始处理的时刻,不是广播最早到达的时刻,跨重启的单调时间不能直接比;诊断失败不阻断采集,也不能据此宣称夜间空档已修复
- 步数缺口 steps=null 不是 0 步;系统扩展不足 22、无后台或历史权限都有明确结果,没实测授予结果不算通过
- 流量只有字节数和应用身份,认不出域名和内容;Wi-Fi 含局域网,UID 2000 的系统调试是 Wi-Fi 的子集,不重复相加;合成截图(docs/screenshots)不算真机验收
- 最大间隔只说明这段没有执行记录,可能是调度延迟、休眠、重启或冻结
- 保留范围(status 里由 probeTime、earliestTime 算出,带 retentionObservedAt)固定对应第一次非空探测,是下限,不随日历变长
- 桌面单元测试证明不了国产系统夜里的调度可靠性,要真机验收
- 源码:build.gradle.kts 里 versionName 0.1.19(versionCode 20),提交 1fc61d5(北京时间 11 月 5 日 10:07,11 月 6 日 05:10 核对)
- 手机上实际装的版本:11 月 6 日 13:56 重读电脑已收状态:记录时间为 11 月 6 日 11:26:49,写着 0.1.19;这次没连手机,安装包身份和蓝牙授权都没有当场核过
- 测试:74 个 @Test 是 11 月 6 日 05:10 对源码的静态计数(10 月 22 日是 40 个),共 14 个测试文件,没有运行;项目里现存的测试结果只有 11 月 3 日 03:19 一个测试类的 5 个用例,不能代表这 74 个都通过
- 真机观察:换机时定下的 72 小时拔线观察和跨夜定位口径写在 PCConfig 换机清单里,没找到通过回执,不当作已验收;流量页的分卡初始化和真机读回也没有核实。蓝牙转发:11 月 5 日 04:20 的合并说明记了真机连通并核对序列号(关 Wi-Fi 时约 125KB/秒),厂商是否放行后台蓝牙广播启动临时前台服务仍要真机验收;11 月 6 日没有连手机重做







- 手机:PersonalOS/Collector/ 下 events、runs、exits、steps 按北京日期分文件,packages 按日期放快照,另有 status.json、state.json、steps-state.json;定位在 PersonalOS/Location/Collector/,一天一个 CSV;流量页的卡槽映射只在 App 私有 files/traffic-sims.json
- 电脑:本地个人资料目录的来源投递区(手机自动同步),不进 Git
- 代码:私有仓库 wlyaaaaa/phone-collector,Kotlin,只放代码和合成测试数据
- 这个 App:只做只有手机能做的——补拉使用事件、装机清单、定位、回读系统步数、显示本机流量、记自己的运行;另外按连接短暂把蓝牙转到手机本机调试端口,让电脑连不上 Wi-Fi 时也能用 adb,不碰采集文件
- 电脑配置(PCConfig):每 30 分钟收文件;手机桥管通知、验证码和剪贴板,也查采集 App、短信备份和 MacroDroid 心跳新不新
- 个人理解库:刷新手机来源时导入,算手机用时,查去过哪、装了什么、手机步数;手机步数只补手表没戴或没电的时段,怎么合并归健康项目,这里不合并
- 现成 App:MacroDroid 定时叫醒、自动开无线调试;SMS Backup & Restore 备份短信和通话
- 构建:在仓库根跑 pwsh -NoProfile -File .\
tools\ Build-Collector.ps1 -TempRoot <临时父目录>,依次跑单元测试、lint,出 debug APK(app/build/outputs/apk/debug/app-debug.apk);要本机 Gradle、JDK 21 和 Android SDK,专用临时目录用完送回收站 - 安装:pwsh -NoProfile -File .\
tools\ Install-Collector.ps1 -OutDir <新的输出目录>;前提是已经有上面的 debug APK、手机经 adb 在线(插线或已配对的无线调试都行,不强制 USB;未授权的设备仍要本人在手机上确认)。它装好、授权(含健康三项,手机拒绝时到 App“权限”卡手动开)、打开 App,等到这次新的 run.id 才取回 status.json,末尾 JSON 列出每步结果和失败原因 - 多台设备加 -Serial,-Apk 换别的包;-DryRun 只打印命令和汇总,不调用 adb、不碰手机;每次用新的输出目录,免得和上次的文件混在一起
- 只更新:同一脚本加 -UpdateOnly(-OutDir 仍要给,可带 -Serial、-Apk、-DryRun)。先确认 APK 包名是 cn.wly.collector、手机已装且只有一个 APK,adb install -r 后核对已装 APK 的 SHA-256;不重新授权、不动白名单、不打开 App。入口和分支已核对,还没有实际更新回执
- 流量分卡初始化:python -B tools/initialize_traffic_sims.py --work-dir <E 盘任务临时目录>。首次安装、换卡、调换卡槽或清除 App 数据后跑一次,真实卡身份不进电脑、源码和日志;日常查看不需要它
- 蓝牙调试转发:前提是电脑和手机已配对、电脑类设备建立蓝牙连接(耳机不触发)、有 BLUETOOTH_CONNECT 权限、手机本机 5555 调试端口已由电脑打开(手机重启后要重新开)。完整安装会授予这项权限,-UpdateOnly 不重新授权
- 格式的唯一说明是 docs/data-format.md,下面每个组件对应其中一节
- CollectorRuntime.kt:周期任务、开机和 RUN 广播、调度事件 ↔「自身运行与退出」
- CollectorEngine.kt、CollectorLogic.kt:每轮各步、分段补拉、规范 JSON 去重、装机快照、退出记录、status ↔「原始使用事件与断点」「装机清单」「状态和电脑端导入」
- LocationSchedule.kt、LocationCollector.kt:系统送点和单次后备 ↔「状态和电脑端导入」的定位部分;0.1.19 起同次开机按单调时钟(elapsedRealtimeNanos)判断新旧和间隔,跨开机或缺这个时钟证据时才回退日历时间
- BluetoothBridge.kt:蓝牙转发,只接受已配对且加密的 RFCOMM(服务名 PCConfig ADB Bridge),把字节转到手机本机 127.0.0.1:5555,沿用 adb 自己的 RSA 授权;同一时刻只转发一个连接;首次 60 秒没人接入就退出,连接结束后再等 30 秒,没人重连或电脑蓝牙链路断开也退出。运行时是连接设备前台服务,挂一条低重要度通知;INTERNET 权限只用来连本机回环,不连外网
- JsonStore.kt:追加后落盘、临时文件原子替换 ↔「文件与提交规则」
- MainActivity.kt:两个页签的主页面;采集概览里“刷新”只读状态,“立即采集一次”才跑一轮
- StepCollector.kt、HealthPermissionsActivity.kt:Health Connect 回读、权限入口和用途说明 ↔「系统手机步数」
- TrafficReader.kt、TrafficPage.kt、TrafficDates.kt:流量统计页,NetworkStatsManager 按需读取 ↔ README「手机流量查看」
- app/src/test:14 个带 @Test 的测试文件分别对着上面的组件和页面截图(11 月 6 日静态数)
- 15 分钟是请求周期,什么时候真跑由系统定,不保证准时;定位送点同样
- 退出记录来自系统有限的环形缓冲,只查本 App;进程被冻住不会留下退出记录;SIGKILL 不能一律当成厂商强杀
- 调度事件只留最近 48 条,更早的会被盖掉,缺事件不证明没发生;“线程完成”只表示执行结束,不代表采集成功
- 送点证据(0.1.13 起)同样只留最近 48 批,每批只记前 8 个点和省略数;每个点标 saved(写入)、invalid(不合法)、non_new(时间没更新)、interval_gate(没满 10 分钟)或 save_error(保存失败,只记错误类别不记正文),不含坐标;收到时刻是取得处理锁后开始处理的时刻,不是广播最早到达的时刻,跨重启的单调时间不能直接比;诊断失败不阻断采集,也不能据此宣称夜间空档已修复
- 步数缺口 steps=null 不是 0 步;系统扩展不足 22、无后台或历史权限都有明确结果,没实测授予结果不算通过
- 流量只有字节数和应用身份,认不出域名和内容;Wi-Fi 含局域网,UID 2000 的系统调试是 Wi-Fi 的子集,不重复相加;合成截图(docs/screenshots)不算真机验收
- 最大间隔只说明这段没有执行记录,可能是调度延迟、休眠、重启或冻结
- 保留范围(status 里由 probeTime、earliestTime 算出,带 retentionObservedAt)固定对应第一次非空探测,是下限,不随日历变长
- 桌面单元测试证明不了国产系统夜里的调度可靠性,要真机验收
- 源码:build.gradle.kts 里 versionName 0.1.19(versionCode 20),提交 1fc61d5(北京时间 11 月 5 日 10:07,11 月 6 日 05:10 核对)
- 手机上实际装的版本:11 月 6 日 13:56 重读电脑已收状态:记录时间为 11 月 6 日 11:26:49,写着 0.1.19;这次没连手机,安装包身份和蓝牙授权都没有当场核过
- 测试:74 个 @Test 是 11 月 6 日 05:10 对源码的静态计数(10 月 22 日是 40 个),共 14 个测试文件,没有运行;项目里现存的测试结果只有 11 月 3 日 03:19 一个测试类的 5 个用例,不能代表这 74 个都通过
- 真机观察:换机时定下的 72 小时拔线观察和跨夜定位口径写在 PCConfig 换机清单里,没找到通过回执,不当作已验收;流量页的分卡初始化和真机读回也没有核实。蓝牙转发:11 月 5 日 04:20 的合并说明记了真机连通并核对序列号(关 Wi-Fi 时约 125KB/秒),厂商是否放行后台蓝牙广播启动临时前台服务仍要真机验收;11 月 6 日没有连手机重做
数字截至 2026 年 11 月 6 日


采集不开前台服务、不在通知栏挂图标,请系统约每 15 分钟叫醒一次,实际可能延迟;唯一例外是蓝牙转发:电脑经蓝牙连进来时短暂开一个前台服务、挂一条通知,连完就退出,和采集无关;定位请求交给系统定位服务持有,设计上不靠 App 进程一直活着;但 App 被杀或被冻住以后,系统还送不送点、隔多久送,由手机系统决定,跨夜表现还待真机验收。也不开 Device Owner:它和微信双开冲突。

原始记录只追加、不改写;状态文件先写临时文件再整体替换。断点永远落在已写下的数据后面,宁可重查也不漏。

空值是“未知”,不是零,也不是“没发生”。缺口分档写下;电脑算手机用时,只把覆盖完整的那几天当可信。

先用现成 App(自动化用 MacroDroid,短信备份用 SMS Backup & Restore),再用开源代码,都没有才自己写最小一层。现成的在真机上不靠谱,才接手。

收文件、看别的工具在不在跑、电量、剩余空间、通知、剪贴板,都由电脑经无线调试来做;手机只做定位、补拉使用事件这类只有手机能做的事,外加让无线调试一直开着,以及电脑蓝牙连进来时短暂转发一下。

流量统计不加后台采集:打开页面或切日期时才读系统接口,也不上传。电脑只在首次或换卡时帮着把卡槽对上一次,之后手机自己就能看。

不用计步器短读,也不把别的应用写进来的数算进去;来源确认不了就写明,不猜。宁可留一段缺口,也不把没数据当成 0 步。

只用安卓自带的能力和不挑品牌的应用;换手机只需重新配对、在新品牌里放行后台,再关掉旧手机的采集。只管安卓各品牌。


采集不开前台服务、不在通知栏挂图标,请系统约每 15 分钟叫醒一次,实际可能延迟;唯一例外是蓝牙转发:电脑经蓝牙连进来时短暂开一个前台服务、挂一条通知,连完就退出,和采集无关;定位请求交给系统定位服务持有,设计上不靠 App 进程一直活着;但 App 被杀或被冻住以后,系统还送不送点、隔多久送,由手机系统决定,跨夜表现还待真机验收。也不开 Device Owner:它和微信双开冲突。

原始记录只追加、不改写;状态文件先写临时文件再整体替换。断点永远落在已写下的数据后面,宁可重查也不漏。

空值是“未知”,不是零,也不是“没发生”。缺口分档写下;电脑算手机用时,只把覆盖完整的那几天当可信。

先用现成 App(自动化用 MacroDroid,短信备份用 SMS Backup & Restore),再用开源代码,都没有才自己写最小一层。现成的在真机上不靠谱,才接手。

收文件、看别的工具在不在跑、电量、剩余空间、通知、剪贴板,都由电脑经无线调试来做;手机只做定位、补拉使用事件这类只有手机能做的事,外加让无线调试一直开着,以及电脑蓝牙连进来时短暂转发一下。

流量统计不加后台采集:打开页面或切日期时才读系统接口,也不上传。电脑只在首次或换卡时帮着把卡槽对上一次,之后手机自己就能看。

不用计步器短读,也不把别的应用写进来的数算进去;来源确认不了就写明,不猜。宁可留一段缺口,也不把没数据当成 0 步。

只用安卓自带的能力和不挑品牌的应用;换手机只需重新配对、在新品牌里放行后台,再关掉旧手机的采集。只管安卓各品牌。


手机系统为了省电,常在后台把 App 停掉。这个 App 不靠一直活着:系统自己会记应用前后台的事件,它每次醒来从上次的断点接着往后查就行。查询区间往前多叠 2 分钟,重复的按整条记录的规范写法去掉;同一毫秒、不同通知渠道的两条也分得开。只要系统还留着,停了几小时也能整段补回来。

定位不靠 App 自己一直开着 GPS,而是向系统定位服务登记一个持续请求,由系统把点送上门。请求按 15 分钟登记,是为了抵消系统送点的延迟,目标约半小时一个点;实际可能延迟,跨夜稳不稳还待真机验收。采集运行时若距上次写入已满 31 分钟,才尝试一次单次定位。手机静止时,系统给同一位置换上新时间送来,也照常记下。

每一轮都记下是谁叫醒的(周期、开机、解锁、更新、广播、手动)、每一步用了多久、离上一轮隔了多久、系统是不是中途把它叫停、为什么;系统给的退出记录也按原因存下。0.1.12 起再存最近 48 条调度事件(这部分尚待真机验收)。夜里出现空档时,把调度、运行、退出和电脑收取记录合起来缩小范围;记录缺失、被覆盖或系统没给原因的,就写未知,不硬归因。


手机系统为了省电,常在后台把 App 停掉。这个 App 不靠一直活着:系统自己会记应用前后台的事件,它每次醒来从上次的断点接着往后查就行。查询区间往前多叠 2 分钟,重复的按整条记录的规范写法去掉;同一毫秒、不同通知渠道的两条也分得开。只要系统还留着,停了几小时也能整段补回来。

定位不靠 App 自己一直开着 GPS,而是向系统定位服务登记一个持续请求,由系统把点送上门。请求按 15 分钟登记,是为了抵消系统送点的延迟,目标约半小时一个点;实际可能延迟,跨夜稳不稳还待真机验收。采集运行时若距上次写入已满 31 分钟,才尝试一次单次定位。手机静止时,系统给同一位置换上新时间送来,也照常记下。

每一轮都记下是谁叫醒的(周期、开机、解锁、更新、广播、手动)、每一步用了多久、离上一轮隔了多久、系统是不是中途把它叫停、为什么;系统给的退出记录也按原因存下。0.1.12 起再存最近 48 条调度事件(这部分尚待真机验收)。夜里出现空档时,把调度、运行、退出和电脑收取记录合起来缩小范围;记录缺失、被覆盖或系统没给原因的,就写未知,不硬归因。

采集





交给电脑







保活和自查








手机上直接看


采集





交给电脑







保活和自查








手机上直接看



复制 AI 续作说明
项目:手机采集;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。




