Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[ZCode 主仓 bugfix] CronCreate 无条件改写会话标题——修复分支已就绪，主仓 PR 渠道受限，请求拉取

Aperta
  • Qualcosa non va?
#60 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 2 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
25/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
node.js, typescript
Ambito
cli, tooling

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

说明：本 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，避免标题被生成成"我无法..."之类的内容。问题在于：

  1. setCustomSessionTitle 无条件覆盖，缺少与其它路径一致的保护——自动命名路径（persistGeneratedSessionTitle）在 titleSource === "custom" 时会跳过，且写回带 expectedTitleSources 乐观锁；冻结路径两者皆无。结果是自动命名尊重用户手动命名，冻结反而不尊重。
  2. 冻结对已命名的既有会话没有可保护的对象：标题生成只在 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 对照确认与本次无关）。

请求

  1. 维护者直接从上述 fork 分支拉取 / cherry-pick（提交信息已按仓库规范写好，含中文修复说明）；或
  2. 告知外部贡献的正确提交渠道（若 PR 权限是临时限制，恢复后我可立即在主仓补提正式 PR）。
Lingua principale
Python
Stelle
86
Fork
51
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di zai-org/zcode-plugins

Tutte le issue di zai-org/zcode-plugins

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.