cron-up 26.10.27 → 26.10.29

package/README.md

@@ -3,7 +3,7 @@
 为命令行 AI agent 的 cron 定时任务**提前启动并保持一个可用的交互会话**。任务本身仍由 agent 自己的定时机制执行，cron-up 只负责保证：任务到点时，对应目录里已经有一个开着的会话。
 
 > [!WARNING]
-> cron-up 建立在 Claude Code **未公开文档的内部机制**之上（`.claude/scheduled_tasks.json` 文件格式、`~/.claude/sessions/*.json` 会话登记、定时任务只在交互界面里执行、周期任务创建满 7 天后失效、任务的 `permanent` 字段可豁免该失效、登记的会话进程其进程命令行可识别为 claude——原生安装是可执行名含 claude 的二进制，npm/bun 安装是解释器执行 claude 入口脚本）。这些行为可能随版本变化。会话保活已在 **Claude Code 2.1.278** 实测；7 天判定与 `permanent` 豁免的代码逻辑核对自 **2.1.280**；定时任务的投递抖动与任务 id 哈希算法（autoMinId 依赖它）逆向核对自 **2.1.285**（均为 macOS）。升级 Claude Code 后建议重新核对。
+> cron-up 建立在 Claude Code **未公开文档的内部机制**之上（`.claude/scheduled_tasks.json` 文件格式、`~/.claude/sessions/*.json` 会话登记、定时任务只在交互界面里执行、周期任务创建满 7 天后失效、任务的 `permanent` 字段可豁免该失效、登记的会话进程其进程命令行可识别为 claude——原生安装是可执行名含 claude 的二进制，npm/bun 安装是解释器执行 claude 入口脚本、任务按 `createdBySessionId` 等归属字段决定在哪个会话执行）。这些行为可能随版本变化。会话保活已在 **Claude Code 2.1.278** 实测；7 天判定与 `permanent` 豁免的代码逻辑核对自 **2.1.280**；定时任务的投递抖动与任务 id 哈希算法（autoMinId 依赖它）逆向核对自 **2.1.285**；任务归属路由规则、归属三字段与预热会话的三代进程结构（stampOwner 依赖它们）核对自 **2.1.300**（均为 macOS）。升级 Claude Code 后建议重新核对。
 
 ## 平台要求
 
@@ -74,6 +74,24 @@ cron-up install --force --no-auto-renew
 
 > 续期（autoRenew）会**改写各工作目录的 `.claude/scheduled_tasks.json`**：原子写入、保留原权限与中文，只新增 `permanent` 一个字段，不改动 prompt、cron 或 id（id 改小是上一节 autoMinId 的独立动作）。被续期的任务不再被自动删除，为它保活的后台会话也会因此**长期常驻**——这等于关闭了 Claude Code 对自主会话的寿命护栏。相关风险见「安全说明」。
 
+### 任务归属预热（stampOwner，默认关闭）
+
+默认行为下，只要工作区里已经有任何交互会话（包括你本人正在用的那个），巡检就不会再拉预热会话；而 Claude Code 按任务文件里记录的「创建者会话」投递——用 CronCreate 建任务时你在哪个会话，到点任务就弹进哪个会话。于是你建完任务、那个窗口一直没关又恰好正在里面干别的活时，到点任务会挤进当前会话。
+
+开启归属改写：配置 `stampOwner: true`（最多 5 分钟后的下一轮巡检生效），或安装时 `cron-up install --force --stamp-owner`（关闭用 `--no-stamp-owner`）。开启后巡检每轮先回答一个问题：**投递窗口内的任务，它们的创建者会话还活着吗？**
+
+- **创建者会话还开着（哪怕你正在里面干别的活）——完全尊重，不另拉、不改归属**，任务到点照旧进那个会话。cron-up 不判断你是在「特意等结果」还是「被打扰」，创建者会话活着本身就是唯一信号；
+- **创建者会话已关闭或崩溃**——同目录即使还有别的会话在开（它不是创建者），巡检也**另拉一个独立的预热会话**承接，并把窗口内任务的 `createdBySessionId`、`createdByPid`、`createdByProcStart` 三个归属字段盖成它：Claude Code 见到自己是创建者就铁定投到预热，别的会话见到 owner 是另一个活会话则主动回避，不抢锁、不双发；
+- 只盖「窗口内且创建者已不活」的任务、幂等（第二轮起字节级不动）、与续期/改小 id 合并为同一次带乐观锁的原子写；预热会话若中途死亡，任务自动退回 Claude Code 原生的「创建者已死、持锁会话接管」规则，不会漏跑，新一代预热拉起后重新盖印；
+- 一个边界：同一目录的窗口任务里只要**还有一个**创建者会话活着，巡检就不会在该目录另拉预热（避免任何双会话）；其中创建者已死的任务会按 Claude Code 原生规则由持锁的活会话接管这一次。
+
+两个附带的行为变化需要知道：
+
+1. window 模式的回收余量从约 2 分钟收紧为「一个巡检间隔 + 2 分钟」（默认约 7 分钟）——回收后要留足「下轮重拉、再下轮盖印」的时间，任务才不可能在盖印前到点；
+2. 卡在提问界面、超过 3 分钟没登记的预热会话会被终止（默认行为下同目录有别的会话时会跳过这次回收）：活创建者在场时只终止不重拉（创建者自己承接任务），创建者已死时终止并重拉。
+
+> 这同样依赖逆向出来的内部机制：任务文件的三个归属字段、以及「进程是 `script → zsh → claude` 三层、靠祖先 pid 认亲」都不是官方承诺的接口。识别退化（如 `ps` 输出异常）时巡检会发告警并**保守退回默认行为**（不另拉会话、暂停盖印），绝不会在同目录堆会话。残余的回退窗口（电脑休眠漏轮、会话恰在盖印前后换代）见「已知限制」。
+
 安装产物：
 
 | 产物 | 位置 |
@@ -162,15 +180,16 @@ cron-up spawn 的预热会话进程环境里带 `CRON_UP_SESSION=1`（值严格
 - **路径大小写**：macOS 默认文件系统大小写不敏感，而 `realpath` 并不规范化大小写。扫描入口会把 `roots` 认回磁盘上的真实写法，`cron-up logs` 给绝对路径时也一样——大小写敲错不再是「警告一声然后匹配失效」，而是直接按同一路径工作。
 - **提前量与间隔的关系**：请保持 `leadSeconds ≥ intervalSeconds`，否则极端情况下任务会在两轮巡检之间到期而来不及启动。默认 600 ≥ 300 有一倍余量。`--lead 0` 是合法取值（表示不提前，只靠错过补执行兜底），会如实写入配置；`--interval 0` 非法，在写入配置之前就被响亮拒绝，非法值不会落盘。
 - **会话保留策略（sessionRetain，默认 `window`）**：会话的生命周期对齐「一次执行」——任务触发过、执行完毕（界面静默约 3 分钟）且距下次需要会话还有余量（约 2 分钟）时，结束本代会话，下次任务窗口照常重拉。「需要会话」按计入投递抖动（见上节）的**预计实际触发时刻**计算：某任务的 cron 落点已过、但还没到它的延迟投递点的这段尾窗（落点后最多 30 分钟）里会话照样保留，尾窗内若会话意外死亡也会立即重拉——否则同目录两个落点相近的任务，较早的执行完后会话被回收，较晚的还没到投递点就会漏跑（周期任务没有补执行）。效果：**错开约 30 分钟以上（已含投递抖动、静默判定与余量）的任务才必然各自拿到全新会话**，更近的共享同一会话（取决于巡检落点）；上下文不互相累积，内存也只在执行窗口内占用（实测每个会话数百 MB）；时间上重叠或紧邻（前后几分钟内）的任务仍共享同一会话——任务在哪个会话执行由 Claude Code 决定，同目录并发多会话既无法指定归属、还有重复执行的风险，cron-up 不制造这种状态。需要旧的常驻行为（执行间隔里也保留会话、上下文跨触发累积）时，把配置文件中的 `sessionRetain` 改为 `"always"`（下一轮巡检生效），或安装时 `--session-retain always`。
+- **开关任务归属预热**：配置项 `stampOwner`，命令行 `cron-up install --force --stamp-owner` / `--no-stamp-owner`。开启后以「创建者会话是否还活着」为最高优先级：建任务的会话还开着就完全尊重、任务照旧进它；创建者已关闭/崩溃时才另拉独立预热承接，不让任务漏给同目录无关的会话（完整语义见安装一节的「任务归属预热」）。两个附带变化：window 回收余量从约 2 分钟收紧为约 7 分钟（间隔 + 2 分钟）；卡在提问界面的预热会话会被 3 分钟卡死退休——活创建者在场时只终止不重拉，创建者已死时终止并重拉（默认行为下同目录有别的会话时跳过这次回收）。
 - **长驻会话自动换代（`always` 模式与异常情况的兜底）**：连续运行超过 7 天、且界面记录静默超过 1 小时（没有任务在执行、没有界面活动的证据）的会话会被主动结束，任务需要时自然重拉。换代让会话用上新的 claude 版本、界面记录从头写起，也让长期累积的上下文回到干净起点。日志静默是「没在跑任务」的判据，执行中的任务不会被砍；换代不计入失败次数。
-- **连续失败自动暂停**：cron-up 能区分「自己启动的后台会话」和「你本人打开的会话」，只跟踪前者。后台会话有两种失败会被计入：**启动后立即退出**（通常是 shell 环境损坏），以及**进程活着却迟迟不登记会话**（判定线 3 分钟，停在信任确认或工具授权提问上——这种进程不会自己退出，会在下一轮巡检被 cron-up 主动终止；同目录当时还有你本人打开的会话时除外，见「已知限制」）。同一目录连续失败 3 次后暂停重试 30 分钟，无参数 `cron-up` 总览显示「冷却中」；会话只要成功登记过一次，失败计数就清零；暂停结束后会给一次全新的重试机会，不会无限期停摆。失败计数**跨任务窗口保留 48 小时**——提前窗口常常只覆盖一两轮巡检，计数若在窗口外的轮次被清就永远数不满 3 次、冷却形同虚设；超过 48 小时的陈年计数连同条目一起老化，不再影响新尝试。总览对「有任务即将执行却没有会话」的告警会顺带标出近期失败次数，持续失败在进入冷却前就能看见。健康会话实测约 1 秒完成登记，距 3 分钟的判定线有充足余量。
+- **连续失败自动暂停**：cron-up 能区分「自己启动的后台会话」和「你本人打开的会话」，只跟踪前者。后台会话有两种失败会被计入：**启动后立即退出**（通常是 shell 环境损坏），以及**进程活着却迟迟不登记会话**（判定线 3 分钟，停在信任确认或工具授权提问上——这种进程不会自己退出，会在下一轮巡检被 cron-up 主动终止；默认配置下同目录当时还有你本人打开的会话时除外，见「已知限制」；`stampOwner` 开启时不除外——活创建者在场则只终止不重拉，创建者已死则终止并重拉）。同一目录连续失败 3 次后暂停重试 30 分钟，无参数 `cron-up` 总览显示「冷却中」；会话只要成功登记过一次，失败计数就清零；暂停结束后会给一次全新的重试机会，不会无限期停摆。失败计数**跨任务窗口保留 48 小时**——提前窗口常常只覆盖一两轮巡检，计数若在窗口外的轮次被清就永远数不满 3 次、冷却形同虚设；超过 48 小时的陈年计数连同条目一起老化，不再影响新尝试。总览对「有任务即将执行却没有会话」的告警会顺带标出近期失败次数，持续失败在进入冷却前就能看见。健康会话实测约 1 秒完成登记，距 3 分钟的判定线有充足余量。
 - **日志大小**：后台会话的界面输出是持续的全屏渲染流。`script(1)` 每次启动会清空旧日志，因此每次拉起该目录的会话时，上一代的界面记录先轮转为 `.log.1`（只保留一代，总量上界两代）——否则 window 模式下上一次任务执行的记录会随下一代拉起被抹掉。活着的一代日志总量由会话生命周期约束（window 模式一代即一次执行；`always` 模式由 7 天换代约束），唯一无法覆盖的是 `always` 模式下连续 7 天一直在输出、从不空闲的会话——受 macOS `script(1)` 能力限制，运行中不能切割日志。巡检日志（`launchd.out.log`/`.err.log`）每轮固定两行心跳（`巡检开始…`/`巡检结束…`，后者带「发现 N 个工作区、活动交互会话 N 个、动作汇总与耗时」），事件行只在有事发生时才打：启动、主动回收、换代、卡死、冷却、接管孤儿、启动失败（含 spawn 异步错误原因）、会话非巡检主动结束（带存活时长）、登记格式漂移告警。每轮都有心跳，所以 launchd 配置没坏但就是没在跑时，从日志断档和总览页都能发现；距上轮超过两个间隔还会提示可能漏轮（常见于电脑休眠后 launchd 合并错过的间隔）。超过 1MB 时同样轮转为 `.1`，只保留上一份。
-- **会话登记自检**：「有没有交互会话」的判断完全依赖 `~/.claude/sessions/` 的登记格式（见开头的 WARNING）。若升级 Claude Code 后该格式变化，cron-up 会把所有会话都误判为「不存在」，陷入反复重拉。总览页对此有三重烟雾告警：登记目录里有文件却一个 interactive 会话都识别不出、存活进程都不像 claude、或 interactive 登记的 pid/工作目录字段集体无法解读时，「需要留意」会明确提示登记格式疑似变更；看到这条后，在重新核对目录结构之前不要相信「当前没有会话」的判断。进程识别同时覆盖两种安装形态：原生安装看进程可执行名（含 claude），npm/bun 安装（进程名是 node/bun）看命令行里的 claude 入口路径；只有命令行里完全找不到 claude 痕迹的启动形态才会误触这条告警。
+- **会话登记自检**：「有没有交互会话」的判断完全依赖 `~/.claude/sessions/` 的登记格式（见开头的 WARNING）。若升级 Claude Code 后该格式变化，cron-up 会把所有会话都误判为「不存在」，陷入反复重拉。总览页对此有四重烟雾告警：登记目录里有文件却一个 interactive 会话都识别不出、存活进程都不像 claude、interactive 登记的 pid/工作目录字段集体无法解读、或存活会话的进程父链读不完整（仅影响 stampOwner 的认亲与盖印，不影响基础保活）时，「需要留意」会明确提示登记格式或进程信息疑似变更；看到这类告警后，在重新核对之前不要相信「当前没有会话」的判断。进程识别同时覆盖两种安装形态：原生安装看进程可执行名（含 claude），npm/bun 安装（进程名是 node/bun）看命令行里的 claude 入口路径；只有命令行里完全找不到 claude 痕迹的启动形态才会误触这条告警。
 - **巡检心跳与沉默告警**：每轮巡检成功跑完都会刷新 `~/.local/share/cron-up/heartbeat`。总览页的巡检区显示「上次巡检：N 分钟前」；launchd 显示已加载、但心跳超过两个轮次间隔没刷新时，「需要留意」会报「巡检已沉默」——启动脚本静态检查全绿但运行期拉不起来（或轮次持续崩在半道）只有靠它发现。轮首发现距上轮过久也会在巡检日志里记一条漏轮提示（电脑休眠后 launchd 会合并非错过的间隔，醒来只补一轮，属正常现象）。
 
 ## 安全说明
 
-- 后台会话拥有你在 Claude Code 中的全部权限（bypass permissions 模式下执行任何操作都无需确认）。**请只把 `roots` 指向你本人信任的工作目录**；cron-up 读取 `~/.claude/sessions/`（判断目录里是否已有会话）与 roots 下的任务文件，并写入自己的配置、状态与日志目录。**开启 autoRenew 或 autoMinId（两者默认都开）时，它还会改写 roots 下各工作目录的 `.claude/scheduled_tasks.json`**：在同目录写临时文件（先按 0600 创建）再原子替换、保留原文件权限（写一半被杀留下的临时文件，下一轮巡检会顺手清掉）。改写只针对显式周期任务、只动两个字段——补 `permanent: true`（autoRenew）、把哈希过大的 `id` 换成文件内未占用的小号（autoMinId），**绝不改动 prompt 与 cron，也不碰一次性任务**；两项都幂等，每个任务只在首次需要时写一次，之后字节级不再重写。写入采用乐观锁：若读出之后、写回之前 Claude Code 也改了该文件（例如任务刚触发、更新了 `lastFiredAt`，或一次性任务执行后被删除），cron-up 放弃本次写入、下轮巡检再来（否则可能让刚执行完被删的一次性任务复活、被再执行一次）。需要说明：乐观锁是在写回前比对文件 mtime，检查与替换之间不存在真正的互斥，竞态窗口只能收窄到微秒级、无法在原理上消除——这是改写另一个程序的文件固有的代价。
+- 后台会话拥有你在 Claude Code 中的全部权限（bypass permissions 模式下执行任何操作都无需确认）。**请只把 `roots` 指向你本人信任的工作目录**；cron-up 读取 `~/.claude/sessions/`（判断目录里是否已有会话、读取进程 pid 与启动时间用于认亲）与 roots 下的任务文件，并写入自己的配置、状态与日志目录。**开启 autoRenew 或 autoMinId（两者默认都开）时，它还会改写 roots 下各工作目录的 `.claude/scheduled_tasks.json`**：在同目录写临时文件（先按 0600 创建）再原子替换、保留原文件权限（写一半被杀留下的临时文件，下一轮巡检会顺手清掉）。前两种改写只针对显式周期任务、只动两个字段——补 `permanent: true`（autoRenew）、把哈希过大的 `id` 换成文件内未占用的小号（autoMinId），**绝不改动 prompt 与 cron，也不碰一次性任务**；两项都幂等，每个任务只在首次需要时写一次，之后字节级不再重写。**开启 stampOwner（默认关）时存在第三种改写**：仅当任务的创建者会话已不存活时，才把投递窗口内任务（含一次性任务）的 `createdBySessionId`、`createdByPid`、`createdByProcStart` 三个归属字段盖成本轮预热会话的值，创建者会话还开着的任务一律不碰；不碰 `createdInProject`、prompt 与 cron；同样幂等，任务的归属只在「窗口打开且预热换了一代」时才再写一次。三种写入合并在同一次原子替换里。写入采用乐观锁：若读出之后、写回之前 Claude Code 也改了该文件（例如任务刚触发、更新了 `lastFiredAt`，或一次性任务执行后被删除），cron-up 放弃本次写入、下轮巡检再来（否则可能让刚执行完被删的一次性任务复活、被再执行一次）。需要说明：乐观锁是在写回前比对文件 mtime，检查与替换之间不存在真正的互斥，竞态窗口只能收窄到微秒级、无法在原理上消除——这是改写另一个程序的文件固有的代价。
 - **续期会改变三条生命周期/边界**：
   1. 被打 `permanent` 的周期任务不再被 Claude Code 在创建满 7 天后删除，cron-up 为它保活的后台会话随之**长期常驻**，不再随任务过期被回收——这等于主动关闭了 Claude Code 对自主会话的寿命护栏。
   2. 7 天上限本也是一道**自动淘汰**防线：一个你没留意、随 `git pull` 或他人提交进入工作目录的周期任务，原本最多存活 7 天；autoRenew 会无差别把它也永久化。因此**不要把他人可写、或你不完全掌控的仓库纳入 roots**（与下一条任务文件即执行输入的警告同理）；拉取外部代码后先检查 `.claude/scheduled_tasks.json` 里有没有意料之外的周期任务，必要时先关闭 autoRenew。
@@ -185,11 +204,13 @@ cron-up spawn 的预热会话进程环境里带 `CRON_UP_SESSION=1`（值严格
 - Claude Code 的周期任务本会在创建满 7 天后失效；cron-up 默认已通过给任务补 `permanent` 字段自动续期，仅在关闭 autoRenew 后才需要按「使用定时任务时的三个约定」手动续签。`permanent` 是未公开字段，若新版 Claude Code 改变其语义需重新核对（见开头 WARNING）。
 - autoMinId 改小 id 依赖逆向出来的投递哈希算法（见「投递抖动」），不是官方承诺的接口：新版 Claude Code 若更换算法，小 id 不再能保证准点——届时关掉 autoMinId、改用「cron 往前提 30 分钟」即可，`list` 的预计时间与 findings 的验算脚本可用来发现这种漂移。此外在交互会话里用 `CronCreate` 重建任务会生成新的随机大 id（需等下轮巡检再改回），改时间请直接编辑 cron 字段而不是重建。
 - autoMinId 改写 id 的当轮起，巡检按新 id（投递延迟不足 1 分钟）计算投递尾窗，而**已在运行的会话仍按旧 id 投递**（顶格约 30 分钟后）：若保活会话恰在「新投递时刻 ~ 旧投递时刻」这最长约 29 分钟的空隙里死亡，该次投递漏跑（周期任务无补执行），下个周期恢复。window 模式下会话执行完即回收、重拉的新会话读到新 id，风险窗口至多覆盖一次执行；always 模式则持续到 7 天换代。在意的话，等一轮执行完（会话已重拉）再跑 `cron-up renew` 可完全避开。
-- 默认 `sessionRetain: "window"` 下，周期任务的每次触发各自使用新拉起的会话（触发完毕即回收、下次窗口重拉）；**时间上重叠或紧邻的任务仍会共享同一会话**——任务路由由 Claude Code 决定，无法做到「每个任务专属一个并发会话」，同目录多会话还有重复执行的风险。`sessionRetain: "always"` 恢复常驻：同一周期内每次触发都追加进同一条会话记录，上下文随时间累积（反复 compact、每轮执行都携带全部历史），每个有周期任务的工作区也因此常驻一个 claude 进程。真正的并发任务级隔离需要 Claude Code 官方支持任务路由。
+- 默认 `sessionRetain: "window"` 下，周期任务的每次触发各自使用新拉起的会话（触发完毕即回收、下次窗口重拉）；**时间上重叠或紧邻的任务仍会共享同一会话**——任务路由由 Claude Code 决定，无法做到「每个任务专属一个并发会话」。`sessionRetain: "always"` 恢复常驻：同一周期内每次触发都追加进同一条会话记录，上下文随时间累积（反复 compact、每轮执行都携带全部历史），每个有周期任务的工作区也因此常驻一个 claude 进程。`stampOwner` 开启后，创建者会话已关闭/崩溃的任务会走进程独立的预热会话、不漏给同目录无关会话；但创建者会话还开着的任务照旧进创建者（这是刻意的最高优先级），同目录重叠任务的归属仍由 Claude Code 裁决，真正的任务级并发隔离还是需要官方支持任务路由。
 - 手写的任务文件若缺 `createdAt` 字段，错过补执行的判定不生效：错过的一次性任务不会被预热补救，`list` 也不显示「已错过」。`CronCreate` 创建的任务始终带该字段，不受影响。
 - 工作区从巡检视野里消失（`.claude/scheduled_tasks.json` 被整个删除，或目录被移出 `roots`）后，cron-up 不再巡检它：其中仍在运行的保活会话不会被回收或换代，会一直驻留到进程自己退出。无参数 `cron-up` 的「需要留意」会列出这类会话，不需要时请手动结束对应进程（`kill <pid>`）。
-- 同一目录同时存在两个交互会话时，定时任务是否会被各执行一次，官方没有明确说明。cron-up 的策略是「只在没有任何会话时才启动」，正常流程不会制造第二个会话。
-- 「已有会话在消费」按目录判断，分不清消费者是我们的预热会话还是你本人打开的会话：卡在提问界面（始终不会登记）的预热会话，若同目录恰有你的交互会话在场，3 分钟的卡死回收会被跳过——最晚由 7 天自动换代收掉，或在你关掉自己的会话后、下次有任务需要会话的那轮巡检被回收。
+- 同一目录同时存在两个交互会话时，定时任务是否会被各执行一次，官方没有明确说明。cron-up 默认的策略是「只在没有任何会话时才启动」，正常流程不会制造第二个会话；`stampOwner` 开启后也只在「窗口任务的创建者会话都已不活」时才制造「用户会话 + 预热会话」并存的状态（创建者会话还开着则永不双开），并存时靠把死主任务的归属盖给预热会话来保证只有它执行（你的会话按 Claude Code 自身规则主动回避，预热死亡才允许接管），不依赖「谁先动手」，因此不会各执行一次。
+- 「已有会话在消费」按目录判断：默认配置下分不清消费者是我们的预热会话还是你本人打开的会话，卡在提问界面（始终不会登记）的预热会话，若同目录恰有你的交互会话在场，3 分钟的卡死回收会被跳过——最晚由 7 天自动换代收掉，或在你关掉自己的会话后、下次有任务需要会话的那轮巡检被回收。`stampOwner` 开启时改为两件事：按会话 id 判定窗口任务的创建者是否还活着（活着就完全尊重），按进程祖先链认出自己的预热（state 记的 `script` 是登记中 claude 进程的祖父）；只有父链读不完整（`ps` 异常、进程正在退出）时才退回分不清的保守状态——该轮不另拉会话、不盖印并发出告警，下轮自动恢复。
+- `stampOwner` 开启后仍有一个盖印跟不上的回退窗口：创建者会话在窗口内刚关闭、或预热会话换代/被回收后，要经历「下轮巡检重拉（≤ 一个间隔）→ 新会话登记 → 再下轮盖印」两步。若电脑休眠漏轮、或关闭/换代恰好发生在落点前不久，任务可能由同目录的其他活会话按 Claude Code 原生规则（持有调度锁且创建者已死）接管这一次——不会漏跑、不会重复，下轮自动盖回新预热，等同功能关闭时的行为。window 模式的回收余量已因此从约 2 分钟收紧为一个间隔 + 2 分钟（默认约 7 分钟），把这个窗口压缩到极端情况。
+- `stampOwner` 依赖任务文件的三个 `createdBy*` 归属字段、活会话的 session id 与三代进程结构（核对自 Claude Code 2.1.300）：新版若移除或改名这些字段、改变启动进程结构，盖印会失效或认不到自己的预热——退化时一律按保守方向处理：创建者存活性判断不到时视为「可能还活着」（不另拉），认亲失败按歧义处理（不双开），不会出现任务被抢走或同目录堆会话。核对方法同投递抖动：发现任务又弹进错误的会话时，检查任务文件字段与会话登记格式，必要时先关闭开关。
 - 扫描不深入子目录里的符号链接（`roots` 本身的符号链接会先解析成真实路径）：容器里用 symlink 指向别处的仓库不会被发现，其中的任务不会被保活。
 - 系统设置「登录项与扩展 → 允许在后台」里，巡检条目显示为 **cron-up-service**：macOS 按 launchd 拉起的第一个可执行文件（启动脚本）给条目起名。条目小字可能标注「来自未识别的开发者」——启动脚本没有 Apple 签发证书的签名，这行小字没有本地手段改；主名称与开关行为不受影响。
 - 若升级 Node 时删掉了启动脚本 PATH 指向的版本目录（多见于手动删除 nvm/fnm 版本），launchd 会静默拉不起巡检；总览页会报「PATH 目录里找不到 node」，重跑一次 `cron-up install` 即可修复。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cron-up",
-  "version": "26.10.27",
+  "version": "26.10.29",
   "description": "为命令行 AI agent 的 cron 定时任务提前预热并保活交互式会话",
   "type": "module",
   "bin": {

package/src/args.mjs

@@ -13,6 +13,7 @@ export const SPECS = {
       'auto-renew': 'tri',
       'auto-min-id': 'tri',
       'session-retain': 'string',
+      'stamp-owner': 'tri',
     },
   },
   uninstall: {

package/src/cli.mjs

@@ -128,7 +128,7 @@ const USAGE = `cron-up —— 为定时任务提前备好交互会话
 
 用法：
   cron-up                    查看总览（服务、配置、任务、会话）
-  cron-up install            安装配置与 LaunchAgent（--roots --interval --lead --session-retain --force --no-auto-renew --no-auto-min-id）
+  cron-up install            安装配置与 LaunchAgent（--roots --interval --lead --session-retain --stamp-owner --force --no-auto-renew --no-auto-min-id --no-stamp-owner）
   cron-up uninstall          卸载（--purge 连配置日志一起删，--keep-sessions 保留后台会话）
   cron-up list               逐个列出定时任务的设定/预计实际触发时间
   cron-up run                执行一轮巡检（launchd 入口）

package/src/config.mjs

@@ -93,6 +93,10 @@ export function configFieldErrors(cfg) {
     errs.push(['sessionRetain',
       `sessionRetain 应是 "window" 或 "always"，当前为 ${JSON.stringify(cfg.sessionRetain)}`]);
   }
+  if (typeof cfg.stampOwner !== 'boolean') {
+    errs.push(['stampOwner',
+      `stampOwner 应是布尔值（true/false），当前为 ${JSON.stringify(cfg.stampOwner)}`]);
+  }
   return errs;
 }
 

package/src/constants.mjs

@@ -25,6 +25,13 @@ export const DEFAULT_CONFIG = {
   // 上下文不互相累积；'always'——旧常驻行为，执行间隔里也保留会话，仅受
   // 7 天超龄换代约束。
   sessionRetain: 'window',
+  // 任务归属改写：默认关，维持「同目录有会话就不双开」的旧行为。开启后，
+  // 即使用户本人的交互会话在场，也另拉独立预热会话，并把投递窗口内任务的
+  // createdBySessionId/createdByPid/createdByProcStart 三字段改写成预热会话
+  // ——任务按 Claude Code 自身的「创建者会话铁拿」规则投到预热会话，用户
+  // 会话主动不碰；预热死亡则自动滑回原生的死者接管规则。依赖 Claude Code
+  // 未公开的任务文件字段与进程父子关系，见 README「任务归属预热」。
+  stampOwner: false,
 };
 
 // 预热会话连续三次启动后死亡，大概率是环境坏了（缺信任、env 不对），退避

package/src/overview.mjs

@@ -200,7 +200,10 @@ export async function cmdOverview(args) {
   // 都静默拉不起来，这是总览唯一能发现它的地方。
   const health = launcherHealth();
   if (health) alerts.push(health);
-  const [consumers, registryAlert] = await deps.scanSessions();
+  // 父链快照是 stampOwner 的按需成本：只有开关确实开启时才拍，总览页也
+  // 才能顺带显示「认亲退化」这第四枚告警。
+  const [consumers, registryAlert] =
+    await deps.scanSessions({ lineage: cfg?.stampOwner === true });
   if (registryAlert) alerts.push(registryAlert);
   const state = loadState();
   const curOv = Math.floor(Date.now() / 1000);
@@ -221,12 +224,13 @@ export async function cmdOverview(args) {
     const minIdTag = cfg.autoMinId ? '，id 自动改小' : '，id 保持原样';
     const retainTag = cfg.sessionRetain === 'always'
       ? '，会话常驻' : '，会话按执行回收';
+    const stampTag = cfg.stampOwner ? '，任务归属预热' : '';
     if (actualIv == null) {
       deps.print(`巡检：配置为每 ${cfg.intervalSeconds} 秒一轮（服务未加载），`
-        + `提前 ${cfg.leadSeconds} 秒启动会话${renewTag}${minIdTag}${retainTag}`);
+        + `提前 ${cfg.leadSeconds} 秒启动会话${renewTag}${minIdTag}${retainTag}${stampTag}`);
     } else {
       deps.print(`巡检：每 ${actualIv} 秒一轮，提前 ${cfg.leadSeconds} 秒启动`
-        + `会话${renewTag}${minIdTag}${retainTag}`);
+        + `会话${renewTag}${minIdTag}${retainTag}${stampTag}`);
       if (actualIv !== cfg.intervalSeconds) {
         alerts.push(`launchd 实际间隔 ${actualIv} 秒与配置 ${cfg.intervalSeconds} `
           + '秒不一致，重新运行 cron-up install 后生效');

package/src/patrol.mjs

@@ -5,7 +5,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { deps, packageVersion } from './internals.mjs';
+import { deps, packageVersion, isPlainObject } from './internals.mjs';
 import {
   FAIL_LIMIT,
   COOLDOWN_SECONDS,
@@ -51,6 +51,7 @@ const EVENT_LABELS = [
   ['exit', '自行退出'],
   ['stuck', '卡死退休'],
   ['adopt', '接管'],
+  ['reown', '过户'],
   ['fail', '启动失败'],
   ['cool', '进入冷却'],
   ['warn', '告警'],
@@ -180,9 +181,15 @@ function needHorizonMs(tasks, now) {
 // cfg.sessionRetain，直接调用（测试）默认 'always' 保持旧语义。scriptProcs
 // 是进程表快照或 null：null 时仅在需要认领孤儿（state 丢失的兜底分支）当
 // 下才拍快照，平静轮不付全量 ps 的代价。
+// stamp=null 表示 stampOwner 关（一切旧行为）；开启时为
+// {verdict, creatorAlive, recycleMarginSec}：verdict 是 classifyWorkspace
+// 对轮初快照的认亲结论（own/creatorAlive/ambiguous/user，换代或回收导致
+// 快照变化时在 retire 内重算），creatorAlive 是「窗口任务有活创建者」
+// （几分钟内不会变，retire 重算时复用），recycleMarginSec 是 window 回收
+// 余量。
 export async function patrolWorkspace(
   ws, state, now, leadMs, cur, consumers, scriptProcs = null,
-  retain = 'always', stats = null,
+  retain = 'always', stats = null, stamp = null,
 ) {
   const tasks = deps.readTasks(ws);
   let ent = state[ws] ?? null;
@@ -221,13 +228,26 @@ export async function patrolWorkspace(
   // 回收是同一个动作，差别只在触发条件与文案；消费者快照拍于轮初，刚结束
   // 的这代可能正是快照里的消费者，不重扫会让陈旧登记挡住下面的重拉。
   let mineAlive = deps.trackedAlive(ent);
+  // verdict 是轮初快照的认亲结论；换代/回收杀掉本代后消费者集合变了，
+  // 必须按重扫结果重算而不是手改布尔——幸存下来的断链会话（进程组杀不
+  // 掉的用户会话）仍应是歧义态，否则会被误当普通用户会话、在它旁边双开。
+  let verdict = stamp?.verdict ?? null;
   const retire = async (kind, msg) => {
     await deps.stopSession(ent);
     note(kind, msg);
     delete state[ws];
     ent = null;
     mineAlive = false;
-    consumers = (await deps.scanSessions())[0];
+    if (stamp) {
+      const [nextConsumers, , nextDetails] = await deps.scanSessions({ lineage: true });
+      consumers = nextConsumers;
+      // ent 已没，entAlive=false；creatorAlive 沿用轮初判定（活创建者在
+      // 换代这几分钟内不会变成别的状态）。
+      verdict = deps.classifyWorkspace(nextDetails, ws, null, false,
+        stamp.creatorAlive);
+    } else {
+      consumers = (await deps.scanSessions())[0];
+    }
   };
 
   // 换代：超龄且日志静默（无任务在执行的证据）的会话主动结束，需要时下
@@ -246,36 +266,76 @@ export async function patrolWorkspace(
   // 缺一不可：本代会话期间真的有任务触发过（lastFiredAt 晚于 startedAt
   // ——区分「执行完的空闲」与「等待触发的空闲」，后者是预热缓存在干活，
   // 回收它只会每轮空转重拉）；界面静默超时（TUI 执行期间持续渲染，静默
-  // 即不在干活）；距下次需要会话还有余量（回收后同轮重拉，新会话来得及
-  // 登记，不会漏掉到点任务）。时间上重叠或紧邻的任务仍共享会话：任务路
-  // 由在 Claude Code 手里，同目录并发多会话无法指定归属，还有重复执行的
-  // 风险。回收不计失败——任务成功执行过是最强的健康证据，陈年计数一并
-  // 清零。
+  // 即不在干活）；距下次需要会话还有余量（回收后下轮巡检重拉的新会话来
+  // 得及登记，不会漏掉到点任务）。时间上重叠或紧邻的任务仍共享会话：任
+  // 务路由在 Claude Code 手里，同目录并发多会话无法指定归属，还有重复
+  // 执行的风险。回收不计失败——任务成功执行过是最强的健康证据，陈年计
+  // 数一并清零。
+  // 余量取值：默认只保登记抖动（约 2 分钟）；stampOwner 开启时必须再留
+  // 出一个巡检间隔——回收后要靠「下轮重拉→再下轮过户」两步把 owner 盖
+  // 到新会话，余量小于间隔就可能在过户完成前到点（cmdRun 传入
+  // SESSION_FIRE_MARGIN_SECONDS + intervalSeconds）。
+  const fireMarginSec = stamp
+    ? stamp.recycleMarginSec
+    : SESSION_FIRE_MARGIN_SECONDS;
   if (ent !== null && mineAlive && retain === 'window'
       && tasks.some((t) => typeof t?.lastFiredAt === 'number'
         && t.lastFiredAt > (ent.startedAt ?? 0) * 1000)
       && sessionLogIdleSeconds(ent.log || sessionLogPath(ws), cur)
         > SESSION_RECYCLE_IDLE_SECONDS
       && needHorizonMs(tasks, now) - now.getTime()
-        > SESSION_FIRE_MARGIN_SECONDS * 1000) {
-    // 用户自己的会话若在场，retire 的重扫依旧看见，不会在同目录双开。
+        > fireMarginSec * 1000) {
+    // stampOwner 关时：用户自己的会话若在场，retire 的重扫依旧看见，不
+    // 会在同目录双开；开启时：旧代整组结束后重扫只可能剩用户会话，下面
+    // 的逻辑会按需另拉新预热。
     await retire('recycle', `回收 ${ws} pid=${ent.pid}：本代任务已执行完毕且`
       + '界面静默，结束会话，下次需要时重拉');
   }
 
+  // 在场的消费者足以让我们放手吗？功能关时任何消费者都算；开启时三种
+  // 情况算——认到自己的预热（own）、窗口任务的创建者会话还活着
+  // （creatorAlive：用户显式要求尊重，绝不另拉）、父链有歧义无法排除是
+  // 自己（ambiguous）。仅无关用户会话（user）不算：创建者已关闭/崩溃，
+  // 下面继续走到 wanted→卡死退休/冷却→spawn，在同目录另起独立预热承接
+  // （全程只 stop 自己的 ent，不碰用户会话）。
+  const consumerHolds = consumers.has(ws)
+    && (!stamp
+      || verdict?.kind === 'own'
+      || verdict?.kind === 'creatorAlive'
+      || verdict?.kind === 'ambiguous');
+
   // 登记成功即健康证据，当场清零失败计数，不等「有任务想要会话」的轮
   // 次——健康会话常驻时计数会一直挂着，一次无关死亡就能把陈年计数顶满冷
-  // 却，连一次新尝试都不给。
-  if (ent !== null && mineAlive && consumers.has(ws)) {
+  // 却，连一次新尝试都不给。只有真的认到自己（own）才清零：creatorAlive
+  // 时在场的是活创建者、我们自己的预热可能正卡着没登记，不能替它清零；
+  // 歧义态保守当真，与「不双开」方向一致。
+  if (ent !== null && mineAlive && consumers.has(ws)
+      && (!stamp || verdict?.kind === 'own' || verdict?.kind === 'ambiguous')) {
     ent.fails = 0;
   }
 
   // 任务正在被消费。可能是我们的预热会话（已登记——上面的健康清零已覆
-  // 盖），也可能是用户的交互会话——后者放手：不在这里删死条目，失败计数
-  // 要跨任务窗口存活（用户会话在场不证明 launchd 拉起的环境健康），由轮
-  // 末 kept 过滤统一处理。先于 wanted 判定返回：有消费者在场的平稳态不必
-  // 为整组任务跑一遍 cron 求值。
-  if (consumers.has(ws)) return;
+  // 盖），也可能是用户的交互会话——后者默认放手：不在这里删死条目，失败
+  // 计数要跨任务窗口存活（用户会话在场不证明 launchd 拉起的环境健康），
+  // 由轮末 kept 过滤统一处理。先于 wanted 判定返回：有消费者在场的平稳
+  // 态不必为整组任务跑一遍 cron 求值。
+  // creatorAlive/ambiguous 返回前还有一件事：我们自己跟踪的预热若已卡死
+  // （超登记宽限仍未认到——verdict 不是 own），它是没用的垃圾进程，任务
+  // 由活创建者承接（或歧义保守），杀掉它即可、本轮不重拉。
+  if (consumerHolds) {
+    if (stamp && verdict?.kind !== 'own'
+        && ent !== null && mineAlive
+        && tasks.some((t) => taskWanted(t, now, leadMs))
+        && cur - (ent.startedAt ?? cur) > WARMUP_GRACE_SECONDS) {
+      const age = cur - (ent.startedAt ?? cur);
+      await deps.stopSession(ent);
+      note('stuck', `卡死 ${ws} pid=${ent.pid}：进程已存活 ${age} 秒仍未登记`
+        + '会话，已终止；同目录已有会话可承接任务，不另拉预热'
+        + '（排查：cron-up logs '
+        + `${path.basename(ws)}）`);
+    }
+    return;
+  }
 
   if (!tasks.some((t) => taskWanted(t, now, leadMs))) return;
 
@@ -362,7 +422,12 @@ export async function patrolWorkspace(
     fails,
     log: sessionLogPath(ws),
   };
-  note('spawn', `已启动 ${ws} pid=${spawned.pid}（连续失败计数 ${fails}）`);
+  if (stamp && consumers.has(ws) && verdict?.kind === 'user') {
+    note('spawn', `已另启动预热会话 ${ws} pid=${spawned.pid}：你的交互会话仍在`
+      + `，窗口内任务将改由预热会话承接（连续失败计数 ${fails}）`);
+  } else {
+    note('spawn', `已启动 ${ws} pid=${spawned.pid}（连续失败计数 ${fails}）`);
+  }
 }
 
 // 跑一轮巡检；抢不到锁返回 false。
@@ -436,12 +501,21 @@ export async function cmdRun(args) {
     // 登记每轮只读一次：否则每个工作区都要 readdir + ps 一遍，自检也归
     // 属这里。进程表快照不在这里拍：只有孤儿认领分支需要，按需现拍（见
     // patrolWorkspace 的 scriptProcs 形参）。
-    const [consumers, registryAlert] = await deps.scanSessions();
+    // lineage 只在 stampOwner 开启时拍：祖先链要一次全机 ps，关闭时
+    // scanSessions 不付这个代价（见 registry 的 scanSessions 注释）。
+    const [consumers, registryAlert, details] =
+      await deps.scanSessions({ lineage: cfg.stampOwner });
     if (registryAlert) {
       bump(stats, 'warn');
       deps.log(`告警：${registryAlert}`);
     }
 
+    // stampOwner 的结论依赖任务内容（活创建者判定要看窗口任务的
+    // createdBySessionId），所以在下面 discover 循环里、读到任务后逐工
+    // 作区现算；这里只留全轮常量。
+    const recycleMarginSec = SESSION_FIRE_MARGIN_SECONDS
+      + cfg.intervalSeconds;
+
     // 轮间死亡在进入工作区循环前先报：随后该工作区若需要会话会打印重拉，
     // 日志时间线就是「退出 → 重拉」，而不是反过来。
     for (const [ws, old] of prevDead) {
@@ -453,13 +527,48 @@ export async function cmdRun(args) {
     for (const [ws, taskfile] of deps.discover(cfg.roots, cfg.maxDepth)) {
       found += 1;
       // 一个工作区读不动不能中断整轮：discover 是生成器，这里抛了会跳过
-      // 后面所有工作区。续期/改 id 与保活各自独立守卫——维护失败绝不压制
-      // 该工作区的会话保活。两者合并为同一次原子写（见 maintainWorkspace）。
-      if (cfg.autoRenew || cfg.autoMinId) {
+      // 后面所有工作区。续期/改 id/过户与保活各自独立守卫——维护失败绝不
+      // 压制该工作区的会话保活。三者合并为同一次原子写（见
+      // maintainWorkspace）。
+      //
+      // stampOwner 的判定在这里现算（需要任务内容）：窗口内是否还有任务
+      // 的创建者会话活着——活创建者拥有否决权，不另拉、不盖印。
+      let target = null;
+      let stampArg = null;
+      let liveSids = null;
+      if (cfg.stampOwner) {
+        const wsTasks = deps.readTasks(ws) ?? [];
+        liveSids = deps.liveSessionIds(details, ws);
+        const creatorAlive = wsTasks.some((t) =>
+          isPlainObject(t)
+          && typeof t.createdBySessionId === 'string'
+          && liveSids.has(t.createdBySessionId)
+          && taskWanted(t, now, leadMs));
+        const entNow = state[ws] ?? null;
+        const verdict = deps.classifyWorkspace(
+          details, ws, entNow,
+          Boolean(entNow) && deps.trackedAlive(entNow),
+          creatorAlive);
+        target = verdict.target; // 仅 own 且身份完整时非空
+        stampArg = { verdict, creatorAlive, recycleMarginSec };
+      }
+      // 盖印谓词只盖「窗口内且创建者已不活」的任务：活创建者的任务永远
+      // 不碰（即便本目录另有我们的预热在承接别的死主任务）；已盖给本代
+      // 预热的任务因 owner 就在活会话集合里而自然跳过，幂等不靠另写比较。
+      if (cfg.autoRenew || cfg.autoMinId || target) {
         try {
-          const { renewed, minified } = maintainWorkspace(taskfile, {
+          const { renewed, minified, reowned } = maintainWorkspace(taskfile, {
             renew: cfg.autoRenew,
             minify: cfg.autoMinId,
+            // target 多出的祖先链字段 tasks 层不读，展开即可，不必手抄
+            // 三个盖印字段。
+            reown: target
+              ? {
+                  ...target,
+                  isWanted: (t) => taskWanted(t, now, leadMs)
+                    && !liveSids.has(t.createdBySessionId),
+                }
+              : null,
           }) ?? {};
           if (renewed) {
             deps.log(`已续期 ${ws}：${renewed} 个周期任务标记为 permanent，`
@@ -471,6 +580,11 @@ export async function cmdRun(args) {
               + '已在运行的会话要等其结束重拉（window 模式执行完即回收、'
               + 'always 模式换代）后才读到新 id');
           }
+          if (reowned) {
+            bump(stats, 'reown');
+            deps.log(`已过户 ${ws}：${reowned} 个窗口内任务的归属改到预热会话`
+              + ` pid=${target.pid}，这些任务将只在该会话触发`);
+          }
         } catch (e) {
           bump(stats, e instanceof TaskFileChanged ? 'warn' : 'error');
           if (e instanceof TaskFileChanged) {
@@ -484,7 +598,7 @@ export async function cmdRun(args) {
       try {
         await patrolWorkspace(
           ws, state, now, leadMs, cur, consumers, null,
-          cfg.sessionRetain, stats);
+          cfg.sessionRetain, stats, stampArg);
       } catch (e) {
         bump(stats, 'error');
         deps.log(`错误 ${ws}：${e.constructor.name}：${e.message}`);

package/src/registry.mjs

@@ -1,7 +1,13 @@
 // Claude Code 会话登记（~/.claude/sessions/*.json）的读取与消费者判定。
 // 登记是另一个程序未文档化的输出：一旦形状变化，所有会话都会被读成「不
-// 存在」，巡检就会在用户会话旁边反复重拉。scanSessions 因此内置三枚烟
-// 雾告警，分别盯住三种漂移形态。
+// 存在」，巡检就会在用户会话旁边反复重拉。scanSessions 因此内置四枚烟
+// 雾告警，分别盯住四种漂移形态。
+//
+// 除「某目录有没有消费者」外，它还回报每个消费者的进程祖先链：cron-up
+// 拉起的预热会话是三层结构 script(S) → zsh(Z) → claude(C)（claude 在交
+// 互 shell 里是函数，函数帧不做 tail-exec），state 只记得到 S，登记里
+// 却是 C，pgid 又被交互 shell 的作业控制改过——唯一稳定的认亲方式是沿
+// ppid 上溯。
 
 import fs from 'node:fs';
 import path from 'node:path';
@@ -27,15 +33,86 @@ function ps(pid, fmt) {
   }
 }
 
-// 活 pid 是否像 claude 进程；调用方先判存活，这里用来排除回收 pid 的无关
-// 进程。
-export function pidIsClaude(pid) {
-  const comm = path.basename(ps(pid, 'comm=')).toLowerCase();
-  if (comm.includes('claude')) return true;
-  if (INTERPRETER_COMMS.has(comm)) {
-    return CLAUDE_ENTRY_RE.test(ps(pid, 'args=').toLowerCase());
+// 一次 ps 同时拿进程名与父 pid：{isClaude, ppid}。ppid 按「末尾空白+
+// 数字」取——comm 可能是含空格的路径，但不会以「空白+数字」结尾；列缺
+// 失（ps 失败/输出漂移）时 ppid 为 null，调用方按歧义保守处理。
+export function processShape(pid) {
+  const line = ps(pid, 'comm=,ppid=');
+  const m = line.match(/^(.*\S)\s+(\d+)\s*$/);
+  const comm = path.basename((m ? m[1] : line).trim()).toLowerCase();
+  const ppid = m ? parseInt(m[2], 10) : null;
+  let isClaude = comm.includes('claude');
+  if (!isClaude && INTERPRETER_COMMS.has(comm)) {
+    isClaude = CLAUDE_ENTRY_RE.test(ps(pid, 'args=').toLowerCase());
   }
-  return false;
+  return { isClaude, ppid };
+}
+
+// 全机进程父子表：一次 ps -axo pid=,ppid= 拍快照，Map<pid, ppid>。任何
+// 异常都返回 null（调用方退化为「全部歧义」的保守行为，绝不抛出）。
+export function processParentMap() {
+  const r = deps.execFile('/bin/ps', ['-axo', 'pid=,ppid='], { timeout: 5000 });
+  if (r.status !== 0) return null;
+  const map = new Map();
+  for (const line of (r.stdout ?? '').split('\n')) {
+    const m = line.match(/^\s*(\d+)\s+(\d+)\s*$/);
+    if (m) map.set(parseInt(m[1], 10), parseInt(m[2], 10));
+  }
+  return map.size > 0 ? map : null;
+}
+
+// 沿父子表上溯（不含 pid 自身），直到 launchd(1；其父记为 0)。中途父 pid
+// 在快照里缺失（ps 退化/进程刚好退出）或成环时 chainComplete=false——
+// 「没找到目标」与「证据链断了」必须由调用方区分：后者按歧义不双开。
+export function ancestorChain(pid, parentMap) {
+  const ancestors = [];
+  const seen = new Set([pid]);
+  let cur = pid;
+  for (;;) {
+    const parent = parentMap?.get(cur);
+    if (parent === undefined) return { ancestors, chainComplete: false };
+    ancestors.push(parent);
+    if (parent <= 1) return { ancestors, chainComplete: true }; // 0/1 即根
+    if (seen.has(parent)) return { ancestors, chainComplete: false };
+    seen.add(parent);
+    cur = parent;
+  }
+}
+
+// 本目录活着的消费者会话 id 集合。窗口任务的 createdBySessionId 命中其中
+// 任一个，就说明创建它的会话还开着——stampOwner 的最高优先级是尊重活创
+// 建者，既不另拉也不过户。
+export function liveSessionIds(details, ws) {
+  return new Set((details?.get(ws) ?? [])
+    .map((d) => d.sessionId)
+    .filter((x) => typeof x === 'string'));
+}
+
+// stampOwner 的认亲结论。details/ws 是 scanSessions 的第三元素；ent 是
+// state 条目，entAlive 由调用方按指纹判好（registry 不认识 state 语义）；
+// creatorAlive 表示「至少一个窗口内任务的创建者会话还在本目录活着」：
+//   own          祖先链里有本代 script pid——在场消费者就是我们的预热；
+//                target 给出可盖印详情，身份字段缺失时为 null；
+//   creatorAlive 窗口任务的创建者会话还活着——任务按 Claude Code 规则必
+//                然投给它，不另拉、不盖印（用户显式要求的最高优先级）；
+//   ambiguous    没有认到自己的预热，但在场会话父链不完整——无法证明不
+//                是自己（如 state 丢失的孤儿预热），保守不双开；
+//   user         以上皆否——创建者已关闭/崩溃，在场的只是无关用户会话
+//                （或根本没有消费者），可以另拉独立预热承接。
+export function classifyWorkspace(details, ws, ent, entAlive, creatorAlive) {
+  const list = details?.get(ws) ?? [];
+  if (ent?.pid && entAlive) {
+    const own = list.find((d) => d.ancestors.includes(ent.pid));
+    if (own) {
+      return {
+        kind: 'own',
+        target: own.sessionId && own.procStart ? own : null,
+      };
+    }
+  }
+  if (creatorAlive) return { kind: 'creatorAlive', target: null };
+  if (list.some((d) => !d.chainComplete)) return { kind: 'ambiguous', target: null };
+  return { kind: 'user', target: null };
 }
 
 // 读一个登记文件；读不出返回 null。Claude Code 会就地（非原子）重写登
@@ -60,8 +137,12 @@ async function readSessionFile(file) {
   return null;
 }
 
-// 返回 [拥有活消费者会话的工作区集合, 告警字符串|null]。
-export async function scanSessions() {
+// 返回 [拥有活消费者会话的工作区集合, 告警字符串|null, 会话详情 Map]。
+// 第三个元素是 Map<cwd, Array<{pid, sessionId, procStart, ancestors,
+// chainComplete}>>；祖先链要付一次全机 ps，只有 stampOwner 需要，所以
+// lineage 默认关：关时恒为空 Map，总览/list/平静巡检不增加任何进程开销
+// （与本仓「全量 ps 按需现拍」的既有纪律一致）。
+export async function scanSessions({ lineage = false } = {}) {
   let files = [];
   try {
     files = fs.readdirSync(deps.paths.sessionDir)
@@ -78,12 +159,29 @@ export async function scanSessions() {
     }
   }
 
+  // 全轮一张父子表快照：所有会话的祖先链取自同一时刻，且只付一次全量
+  // ps。仅在 lineage 显式开启时拍——快照失败给 null，祖先链一律按断链
+  // 处理（stampOwner 退化为「全部歧义、绝不双开」），consumers 判定不受
+  // 影响。
+  let parentMap = null;
+  if (lineage) {
+    try {
+      parentMap = deps.processParentMap();
+    } catch {
+      parentMap = null;
+    }
+  }
+
   const consumers = new Set();
-  const commCache = new Map();
+  const details = new Map();
+  const shapeCache = new Map();
   let liveOther = 0;
   // interactive 认得出来，却读不出有效 pid 或工作目录的条目数：pid/cwd
   // 字段改名就是这种形态，而下面两条自检只看 kind 与进程形态，兜不住。
   let suspect = 0;
+  // 已是消费者、但进程父 pid 或祖先链读不完整的条目数：stampOwner 会因
+  // 此无法认亲，只能保守不双开（过户暂停），需要一行告警让人看见退化。
+  let lineageMissing = 0;
   for (const s of interactive) {
     // pid 也是外部程序写的字段：null、非数值、非正数、超 pid_t 的巨大整
     // 数都读不出活进程。这段代码在 per-workspace 保护圈之外，一个畸形登
@@ -95,16 +193,35 @@ export async function scanSessions() {
       continue;
     }
     if (!deps.alive(pid)) continue; // 陈旧登记（崩溃留下）：正常，不计
-    if (!commCache.has(pid)) {
-      commCache.set(pid, deps.pidIsClaude(pid)); // ps 调用按 pid 缓存
+    if (!shapeCache.has(pid)) {
+      shapeCache.set(pid, deps.processShape(pid)); // ps 调用按 pid 缓存
     }
-    if (commCache.get(pid)) {
+    const shape = shapeCache.get(pid);
+    if (shape.isClaude) {
       // cwd 同样不可信：非字符串当定位不到工作区；空串与相对路径会被
       // resolve 拼到巡检进程自己的 cwd 下，凭空造出消费者目录，可能令预
       // 热被静默跳过。
       const cwd = s.cwd;
       if (typeof cwd === 'string' && path.isAbsolute(cwd)) {
-        consumers.add(lexReal(cwd));
+        const ws = lexReal(cwd);
+        consumers.add(ws);
+        if (lineage) {
+          const chain = parentMap
+            ? ancestorChain(pid, parentMap)
+            : { ancestors: [], chainComplete: false };
+          if (shape.ppid === null || !chain.chainComplete) lineageMissing += 1;
+          const list = details.get(ws) ?? [];
+          list.push({
+            pid,
+            sessionId: typeof s.sessionId === 'string' ? s.sessionId : null,
+            // procStart 是 ps lstart 原文（单位数日期含双空格），只许原样
+            // 传递给任务文件，绝不能自己拼。
+            procStart: typeof s.procStart === 'string' ? s.procStart : null,
+            ancestors: chain.ancestors,
+            chainComplete: chain.chainComplete,
+          });
+          details.set(ws, list);
+        }
         continue;
       }
       suspect += 1; // 活着的 claude 却没有可用 cwd：cwd 字段漂移
@@ -125,11 +242,19 @@ export async function scanSessions() {
     alert = '会话登记中的 interactive 会话都读不出有效的 pid 或工作目录；'
       + 'Claude Code 的会话登记字段可能已变更，cron-up 会把已有会话误判为'
       + '不存在，在同目录重复拉起会话';
+  } else if (lineage && lineageMissing > 0) {
+    alert = `${lineageMissing} 个存活会话的进程父子关系读不完整（ps 输出异常或`
+      + '会话进程正在退出）；stampOwner 本轮按保守策略不另拉预热会话、暂停'
+      + '任务过户，下轮自动恢复';
   }
-  return [consumers, alert];
+  return [consumers, alert, details];
 }
 
 Object.assign(deps, {
-  pidIsClaude,
+  processShape,
+  processParentMap,
+  ancestorChain,
+  liveSessionIds,
+  classifyWorkspace,
   scanSessions,
 });

package/src/service.mjs

@@ -346,6 +346,7 @@ export async function cmdInstall(args) {
     }
     if (args.autoRenew !== undefined) overrides.autoRenew = args.autoRenew;
     if (args.autoMinId !== undefined) overrides.autoMinId = args.autoMinId;
+    if (args.stampOwner !== undefined) overrides.stampOwner = args.stampOwner;
     if (args.sessionRetain !== undefined) {
       if (args.sessionRetain !== 'window' && args.sessionRetain !== 'always') {
         deps.printErr(`--session-retain 只接受 window 或 always，当前为 ${JSON.stringify(args.sessionRetain)}`);

package/src/tasks.mjs

@@ -248,12 +248,21 @@ export function minifyIds(tasks) {
   return changed;
 }
 
-// 一轮巡检对一个任务文件做的维护：renew（补 permanent）与 minify（id 改
-// 小）合并为同一次受 mtime 乐观锁保护的原子写。先取 mtimeNs、清残留
-// .cron-up-tmp、loadTaskDoc round-trip 整文档；两项计数都为 0 时字节级
-// 不动。返回 {renewed,minified}；null 表示文件缺失/损坏；读到写间被改抛
+// 一轮巡检对一个任务文件做的维护：renew（补 permanent）、minify（id 改
+// 小）、reown（把窗口内任务的 owner 三字段盖给指定预热会话）合并为同一
+// 次受 mtime 乐观锁保护的原子写。先取 mtimeNs、清残留 .cron-up-tmp、
+// loadTaskDoc round-trip 整文档；三项计数都为 0 时字节级不动。返回
+// {renewed,minified,reowned}；null 表示文件缺失/损坏；读到写间被改抛
 // TaskFileChanged。
-export function maintainWorkspace(taskfile, { renew = false, minify = false }) {
+//
+// reown 形状：{sessionId, pid, procStart, isWanted(t)} | null。isWanted
+// 由调用方注入（tasks 层不反向依赖 cron 层）；只盖 createdBySessionId/
+// createdByPid/createdByProcStart 三个字段，不碰 createdInProject。
+export function maintainWorkspace(taskfile, {
+  renew = false,
+  minify = false,
+  reown = null,
+}) {
   let mtimeNs;
   try {
     mtimeNs = fs.statSync(taskfile, { bigint: true }).mtimeNs;
@@ -284,9 +293,28 @@ export function maintainWorkspace(taskfile, { renew = false, minify = false }) {
     }
   }
   const minified = minify ? minifyIds(doc.tasks) : 0;
-  if (renewed === 0 && minified === 0) return { renewed: 0, minified: 0 };
+  let reowned = 0;
+  if (reown) {
+    for (const t of doc.tasks) {
+      // createdBySessionId 已是目标值即跳过：与 renew/minify 同一条幂等
+      // 纪律，第二轮起字节级不动。没有 owner 字段的外部条目同样盖——窗
+      // 口内任务统一归预热会话，语义不因条目来源留例外。
+      if (isPlainObject(t)
+          && t.createdBySessionId !== reown.sessionId
+          && reown.isWanted(t)) {
+        t.createdBySessionId = reown.sessionId;
+        t.createdByPid = reown.pid;
+        // ps lstart 原文（含「Oct  8」双空格），原样取自会话登记。
+        t.createdByProcStart = reown.procStart;
+        reowned += 1;
+      }
+    }
+  }
+  if (renewed === 0 && minified === 0 && reowned === 0) {
+    return { renewed: 0, minified: 0, reowned: 0 };
+  }
   atomicWriteJson(taskfile, doc, mtimeNs);
-  return { renewed, minified };
+  return { renewed, minified, reowned };
 }
 
 Object.assign(deps, { discover, readTasks, loadTaskDoc });