[ZCode 主仓 bugfix] CronCreate 无条件改写会话标题——修复分支已就绪，主仓 PR 渠道受限，请求拉取
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 3/5
- 預估耗時
- 1-2 天
- 新手友好度
- 25/100
- Issue 類型
- 缺陷
- 描述清晰度
- 描述清楚
- 活躍度
- 活躍
- 技術堆疊
- node.js, typescript
研究方向
Start by reading automation-port.ts and core/runtime/methods/session-title.ts, then run apps/zcode-cli/packages/core/test/session-title.test.ts. Done means the existing session-title tests pass, the bootstrap build and architecture check remain clean, and CronCreate no longer changes custom or generated session titles.
由索引模型根據 Issue 內容生成。
描述
说明：本 issue 面向 ZCode 主仓（zai-org/ZCode） 的一个 bug 修复。主仓当前 issues 关闭、外部账号创建 PR 也被权限拦截（GraphQL 报
does not have the correct permissions to execute CreatePullRequest），修复分支已推到 fork，只能借本仓库反馈，请维护者拉取或告知正确的提交渠道。
[Bug] CronCreate 会无条件把当前任务（会话）标题改写为 automation 标题
修复分支：https://github.com/neoblackxt/ZCode/tree/fix/croncreate-session-title-freeze
基于 main（29628c9），7 个文件 +169/-2，含 spec 与单元测试（5/5 通过）。
问题
会话内 CronCreate 成功后，automation-port.ts 会无条件调用 setCustomSessionTitle 把当前会话（任务）标题覆盖为该 automation 的 title（代码注释称 "freeze session title"）。该调用不检查标题现有来源，titleSource === "custom"（用户手动命名）与 generated（自动命名已完成）的任务都会被覆盖。
实际影响：在长周期任务中多次创建定时巡检（watchdog）类 automation 时，任务名随每次 CronCreate 反复变化——每个新 automation 就改一次名，用户手动命名也会被覆盖，严重干扰任务列表管理。
实测记录（桌面版 3.11.2，同一任务一天内被改名 4 次，session_title_updated 事件与 CronCreate 调用毫秒级对齐）：
| 时间 | 调用 | 任务被改为的名字（= automation title） |
|---|---|---|
| 17:00:54 | CronCreate | vol_volume_coupling 全量计算 watchdog |
| 17:03:39 | CronCreate | vol_volume_coupling IC 快筛 watchdog |
| 18:07:19 | CronCreate | illiquidity 分钟 stage1 watchdog |
| 18:54:30 | CronCreate | illiquidity IC main 轮 watchdog |
原因
冻结的设计意图（原注释）是抢占首轮迟到的标题生成 sidecar，避免标题被生成成"我无法..."之类的内容。问题在于：
setCustomSessionTitle无条件覆盖，缺少与其它路径一致的保护——自动命名路径（persistGeneratedSessionTitle）在titleSource === "custom"时会跳过，且写回带expectedTitleSources乐观锁；冻结路径两者皆无。结果是自动命名尊重用户手动命名，冻结反而不尊重。- 冻结对已命名的既有会话没有可保护的对象：标题生成只在
turnNumber === 0触发（resume.ts从历史消息重建turnNumber，不会归零），任务中途不存在迟到 sidecar 的竞争窗口，此时覆盖的唯一效果就是改写既有任务名。
修复方案
新增 freezeSessionTitleForAutomation（core/runtime/methods/session-title.ts），把"是否需要冻结"的判定收敛到拥有标题语义的 runtime 层：
- 仅当当前
titleSource ∈ {default, first_input}（sidecar 可能尚未写回）时冻结为 automation 标题——完整保留抢占首轮迟到 sidecar 的原设计意图； custom（用户手动命名）与generated（sidecar 已完成）跳过，记automation.session_title_freeze.skipped（debug）；- 用户手动重命名路径（
setCustomSessionTitle）行为不变。
影响面：首轮创建 automation 行为不变；任务中途 / 手动命名后创建 automation 不再被改名；同一任务多个 automation 不再互相覆盖任务名。
验证
- 单元测试（新增，node:test）：
apps/zcode-cli/packages/core/test/session-title.test.ts，5/5 通过，覆盖上述全部场景； pnpm -r --filter "@zcode/bootstrap..." run build通过（含 core/bootstrap 全量 tsc 类型检查）；pnpm architecture:check --changed：violations 0 / baseline 0 / new 0；- lint / fmt：改动文件 0 警告 0 错误（bootstrap 包存量的 20 个 lint 错误经 stash 对照确认与本次无关）。
请求
- 维护者直接从上述 fork 分支拉取 / cherry-pick（提交信息已按仓库规范写好，含中文修复说明）；或
- 告知外部贡献的正确提交渠道（若 PR 权限是临时限制，恢复后我可立即在主仓补提正式 PR）。
- 主要語言
- Python
- 星號
- 95
- 分支
- 57
- PR 合併指標
- 30 天內沒有已合併 PR
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue，再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫，在一個分支上完成修改。
- 送出 Pull Request，並在描述裡引用這個 Issue 編號。
zai-org/zcode-plugins 的其他 Issue
-
難度 2/5 1-3 小時 新手友好度 76/100
zai-org/zcode-plugins#107 ·
維護者通常 1 天內回覆
-
難度 1/5 1 小時以內 新手友好度 85/100
zai-org/zcode-plugins#106 ·
維護者通常 1 天內回覆
-
video-agent-kit (0.4.3): hooks invoke python3, which doesn't exist on Windows — SessionStart/UserPromptSubmit/Stop hooks fail on every trigger可能已有人在做 @dvd233 於 24 天前認領。 未關閉
難度 2/5 1-3 小時 新手友好度 85/100
zai-org/zcode-plugins#14 ·
維護者通常 1 天內回覆
-
難度 4/5 3-5 天 新手友好度 18/100
zai-org/zcode-plugins#105 · 1 個 reaction ·
維護者通常 1 天內回覆
-
難度 4/5 3-5 天 新手友好度 35/100
zai-org/zcode-plugins#88 · 1 則留言 ·
維護者通常 1 天內回覆
查看 zai-org/zcode-plugins 的全部 Issue
相似的 Issue
-
難度 2/5 1-3 小時 新手友好度 64/100
aws-samples/sample-per-model-bedrock#295 ·
維護者通常 1 天內回覆
-
難度 1/5 1 小時以內 新手友好度 76/100
pyrevitlabs/pyRevit#3792 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 69/100
zephyrproject-rtos/reqmgmt#177 ·
-
難度 2/5 1-3 小時 新手友好度 78/100
polarsource/polar#15580 ·
維護者通常 1 天內回覆
-
難度 1/5 1 小時以內 新手友好度 85/100
521xueweihan/HelloGitHub#4011 ·