Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở
  • Có gì không ổn?
#60 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 2 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
25/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
node.js, typescript
Lĩnh vực
cli, tooling

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

说明：本 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）。
Ngôn ngữ chính
Python
Star
86
Fork
51
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của zai-org/zcode-plugins

Tất cả issue của zai-org/zcode-plugins

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.