本地定时提取与后台生命周期

当前实现为全局间隔、逐源间隔/每日/每周、启动校对、手动合并、单写者及 Windows 可选原生系统任务。Windows 托盘可选，节能暂停与协作式扫描时间限制已接入，具体验收状态见 Plan.md。Windows 文件监听与逐源间隔单调计时已接入；来源实例有两个解析槽，文件/数据库读取与后续处理通过作用域控制协作中断。

设置与执行选择

设置	默认与当前行为
全局自动提取	1 小时；0 关闭所有自动提取（含启动、逐源和系统触发），手动仍可执行
逐源规则	覆盖全局；间隔 15s–24h、每日 HH:MM、每周 ISO 星期 + HH:MM；来源必须启用
定点时区	首次采用统计时区并独立保存，之后修改统计时区不改变计划；数据源页可改时区并预览接下来三次
启动/恢复	自动提取开启时启动校对全部启用来源；全局错过多个间隔合并一次，不回放每个时点
登录时启动	Windows 当前用户自启，默认关闭；与后台任务分别配置
退出后采集	Windows 系统任务默认关闭；当前用户已登录时无窗口检查到期来源；不唤醒电脑
托盘	Windows 默认关闭；开启后关闭窗口隐藏，点击托盘/显示窗口恢复，退出菜单始终退出；登录时启动及系统采集独立
节能暂停	Windows 默认开启；只读 GetSystemPowerStatus，节能模式暂停启动/间隔/逐源/系统自动采集，手动保留，恢复后合并校对一次
文件监听	Windows 可选、默认关闭；仅已登记且启用的本机根，2 秒防抖；每日/每周规则不监听；保留轮询作为备用方式

Windows 登录时启动通过原生注册表 API 读写 HKCU Run 的应用值；查询核对当前可执行路径，旧路径或异形值不当作生效。不启动 reg.exe，不把删除权限失败视为已关闭。

每个来源使用相同采集入口，任务只读取已有本机记录，不执行 shell、Agent CLI、提示词或模型调用。手动刷新包含全部启用来源，包括有独立计划者；自动全局扫描排除尚未到期的独立计划，到期规则每源补扫一次。停用来源不撤回历史贡献。应用内自动提取关闭后，残留系统触发也不能读取；显式 --scan-once 为手动采集。

计划保存规则/时区、启用、配置版本及下次执行；来源停止后无自动读取，恢复后错过时点合并校对。固定时刻的 DST 缺失时间顺延到跳变后的首个有效时刻；重复时间只取第一次。已执行后推进下一个日历时点，不因回拨重放同一时点。全局及逐源运行期间的间隔等待使用单调时钟；逐源首次载入从持久化 UTC 到期时间恢复，之后时钟跳变不提前触发间隔。运行完成/规则修订重新计时，并按剩余单调时间修正下次执行的 UTC 展示；每日/每周仍按独立时区的日历时刻。 GUI 的启动/手动/全局扫描共用持久化全局期限；逐源扫描只推进对应来源，不能反复重置全局计时而使继承全局规则的来源一直无法执行。旧版未保存时区的规则在初始化时固定当前有效统计时区一次。

合并、事务与恢复

GUI/headless 共用两个来源实例工作槽，同一 Agent 的不同根也能并行；空槽领取下一个根，同一实例由既有作业状态机合并。读取和解析时释放应用数据库锁。文件归属/游标加载、结果接纳、批次及作业状态更新经同一个 Storage 互斥锁串行执行，不创建第二个写连接；归档替换仍按既定来源与修订规则在该锁内完成。并行须回归同文件归属、停用/暂停、一次失败不影响其他来源、事件与游标回滚以及重扫不重复新增。文件和数据库读取中断采用每工作线程独立的作用域控制，期限按源/轮次取较早者；有界读取、逐行/逐记录循环、SQLite 查询和备份分页检查。只有完整有效批次才接纳结果，中断不成为解析错误或推进未处理游标；控制及源 SQLite 的句柄随作用域撤销。成功解析的探测指纹、generation 与事件/游标同事务写入；失败后同大小替换仍须重读。 JSONL 默认每文件读取窗 32 MiB，显式较大单行上限会相应放大窗口；完整行可提交，剩余部分标 interrupted，来源计划保持到期。读取至多使用剩余文件读取时间的一半，给解析和提交留时间；暂停或期限耗尽时未确认批次回滚。查找换行只扫描新读入字节。 Codex 跨轮扫描优先未访问的文件，其余按库中上次确认访问时间轮转；同等条件按日期路径倒序读取。大文件用完读取窗后保留游标，下轮让其他尚未访问的文件优先，避免历史回填持续推迟新用量；轮转不把中断标为完整采集。其他适配器沿用自己的发现顺序，只有核验文件间不存在读取顺序要求后才能启用轮转。 JSON 有控制时每 32 KiB 检查，IO 每次至多 64 KiB；开关检查最多缓存 20 ms，期限每次检查。SQLite 每 1,000 VM 指令和备份每页组检查，回调内不调用 SQL。应用归档/保留/费用连接的回调在解锁前撤销，未确认维护事务回滚；已中断的轮次不继续启动保留、费用或可选价格刷新。未访问、中断或合并请求不推进逐源到期时间。任何阻塞 OS 调用仍只能在返回后检查，不能声称硬实时终止。

GUI 与 headless 按同一数据库的 OS 文件锁确定唯一所有者；异常退出由 OS 释放锁。失去锁的手动请求与系统请求分别持久化并合并，不通过打开 Storage 恢复别人的 running 作业。GUI 消费手动请求不依赖自动启用；消费系统请求时再次核对启用意图。运行期间的重复手动刷新最多保留一个后续请求；定点到期保持在库中，运行后推进。

当前应用按注册表分组发现，再由两个工作槽采集来源实例，数据库单写者。事件、游标、解析状态、聚合与作业提交进度同事务；错误源保留状态，其他适配器继续。重启恢复 interrupted 作业并重复重扫而不重复新增，不靠 PID 文件无限占锁。任务注册成功与采集成功是两种状态。

生命周期规则与实施边界：

Windows 文件变更采用原生目录通知，不增加扫描线程；全局开关默认关闭，依赖自动提取及节能状态检查。只对启用来源登记的本机目录/手工文件父目录注册，每日/每周不监听；手工根隔离模式同时限制监听根。最多 32 个目录通知句柄，注册/通知失败或超限回退既有轮询，不把通知本身当成用量或读取成功。同一批变更静默 2 秒后按来源合并一次；暂停时释放句柄，恢复后启动校对。
逐源间隔采用上述进程内单调期限；短生命周期系统任务重启时从 UTC 恢复，不声称单调时钟可以跨进程持久化。
同源最多一个作业和一个合并触发；不同来源最多并行 2 个解析任务。
单文件 scan 的 SQLite busy/locked、短暂 IO 和 Windows 共享违例最多重试 3 次，等待 5/15/30 秒；剩余源时间容纳不下等待时立即返回错误。解析、权限拒绝及不存在的文件不在同轮重试；发现/探测 Pending 留待下轮。重试等待每 100 ms 核对暂停/期限，下一次读取前再核对；中断保留游标且不作解析失败。
设置保存使用后台工作线程；有效暂停请求在等待数据库写锁前阻止自动读取。只有保存成功才替换持久设置，失败释放该请求并沿用旧设置；并发暂停请求分别计数。
每源文件扫描默认共用 30 秒单调计时，包含探测及重试等待；JSONL 读取收到剩余时间，文件和内部读取过程到期停止；仅已提交批次算确认，未提交事件/游标/指纹一起回滚。自动轮次共用 5 分钟期限及暂停，包含文件/数据库读取与归档、保留、费用后处理；未访问来源不冒认成功，也不推进到期时间。系统任务另有 5 分钟终止限制。这是协作式限制，不能当成任何 OS 读取都能在精确时限内强制返回。
托盘与节能仅 Windows 首版；其他平台保留构建，尚未核验原生行为。

采集只能看到源已保存的记录，不能恢复上游删除或未导出的用量。累计观察跨日时保留区间不确定性，不把全部增量算在唤醒日。新鲜度目标仅适用于源已保存记录且正常运行，见资源目标。

Windows 原生系统任务

通过 Task Scheduler COM API 注册，每个应用数据库路径有独立任务名及所有权标记。执行路径与参数分别保存：程序绝对路径，参数 --headless --data-dir <绝对目录>；不拼接 shell，中文/空格路径独立验收。不覆盖或删除所有权标记不匹配的任务。

任务使用 TASK_LOGON_INTERACTIVE_TOKEN、TASK_RUNLEVEL_LUA，不保存密码、不使用 SYSTEM 或管理员权限；每分钟检查应用规则，不唤醒机器，最多一个实例， OS 执行期限 5 分钟。注销、关机和休眠期间不承诺执行；恢复后合并补扫。不足一分钟的逐源间隔在仅系统任务模式下受限，界面显示该精度。

启用/关闭意图先持久化，再调用 OS，最后回查真实生效状态；错误保留意图和原因。设置页分别显示已安装/实际启用、已保存的设置及重试设置入口；只读状态检查不注册任务。关闭意图先保存，即使删除失败，残留 --headless 也立即退出。任务路径失效或升级后路径变化显示待修复，用户应用时重注册；不凭任务存在报成功。

GUI 持锁时 headless 只提交一个后台请求并退出，GUI 再按已保存规则筛选。独立 headless 也先检查意图、全局暂停和逐源到期，完成退出，不创建 WebView、 Agent 或临时 OTLP 接收器。全局后台期限持久化，频繁系统触发不会反复全扫；只有未到期独立规则时不推进它们。旧通用名称任务不会自动冒认成新任务。

--data-dir 只隔离应用数据，不改变来源范围；原生验收须同时隔离子进程的来源与配置环境，见实施边界。系统任务由 OS 启动，不能假定继承测试进程的环境。manual_roots_only 默认关闭，启用后发现只使用已保存的手工目录，不读取环境/默认根、本机账户额度或自动管理的遥测导出。它不删除旧统计。无窗口原生验收同时启用此设置、保存非空合成根，并在 GUI 重启前独立只读核对库中事件，避免启动校对掩盖系统触发未采集。关闭/升级/卸载、注册/删除失败和普通用户竞争按 V24 验收。原生注册 API 往返不等于系统触发器已真实启动应用；两种验证结果分别报告。独立 Windows 卸载会精确清理当前安装对应的自有任务/启动项，并在既有库的写者锁下关闭后台意图；升级临时卸载保留，失败阻止删除程序。详见安装说明。

其他平台与本机环境

macOS/Linux 保留共享调度器、headless、读取与数据库互斥代码及 CI；首版不提供 launchd/systemd/cron 注册入口。WSL/容器须用户显式添加，不为读取隐式启动环境。活跃 WSL SQLite 不跨环境复制三件套；无法一致只读则使用已核验本机一致导出或保留限制。Linux 应用数据库放 Linux 文件系统，不与 Windows 并发共享。

依据与验收

Task Scheduler API、 Windows 节能状态、 Tauri 托盘、 Windows 目录通知、任务身份与权限、 StartWhenAvailable、重复间隔。 StartWhenAvailable 可能延迟启动，不能据此保证唤醒后立刻采集。 OS 锁使用 File.try_lock，最低 Rust 1.89；具体 CI 工具链以仓库实际配置为准。两个工作槽使用 Rust scoped threads；控制读取遵守 Read 的错误语义，用带类型的 Other 错误返回暂停，避免 Interrupted 被 read_to_end 自动重试。 SQLite 控制依据 progress handler，锁内访问符合 rusqlite 0.40.2 Connection 的 Send / 非 Sync 约束。2026-10-04 核对官方正文、锁版本及当前编译/回归，不将官方滚动 Rust 文档版本当作本机工具链。 V23/V24/V25 覆盖暂停、到期、DST、重启、竞争、来源边界与无窗口运行；GUI 和 headless 资源分别测量，实际结果只在验证记录与 Plan.md 登记。