Skip to content

【功能需求】提供编程方式新建/管理会话的接口(CLI 或深链),支持长任务自动换届 #929

Open

Description

@lhpnano

【功能需求】提供编程方式新建/管理会话的接口(CLI 或深链),支持长任务自动换届

背景

长周期调研任务(单册产出 33 页、工期数周、多个 CLI 工人并行)在 ZCode 中以单会话承载。会话上下文过换届红线后,任务连续性与上下文新鲜度不可兼得:继续用旧会话则上下文膨胀靠压缩续命,新开会话则必须人工点击。

Claude Code 已有的对标能力

  • claude --bg --session-id <uuid> --name <名称> -p <提示词>:编程方式创建后台会话,自动出现在 Claude Desktop 的 Agent View,可 attach / stop / resume;
  • daemon 守护进程维持后台会话跨终端存活;
  • claude agents --json:程序化查询全部后台会话状态(含 token 用量、运行时长)。

我们在此之上实现了「自动换届」:旧会话上下文过红线 → 钩子触发 → 编程新建会话接力任务 → 旧会话收尾终止,全程无人工干预。

ZCode 现状

  • 桌面应用 ZCode.exe(3.14.4)运行正常,启动时成功注册 zcode:// 深链协议,但深链格式未公开;
  • 未提供 zcode CLI,npm 全局无官方包;
  • 定时任务(自动化)只能唤醒创建它的那个会话,无法新建侧边栏会话;
  • 因此「自动换届」「多会话并发分区」需要人工手动开新对话,自动化断链。

需求(按优先级)

  1. CLI 会话管理:zcode session new --name <名称> --cwd <目录> --prompt <提示词> [--bg],配套 zcode session list --json / attach / stop;新会话自动出现在侧边栏。
  2. 深链格式公开:zcode:// 协议公开「新建会话」的参数格式(携带初始提示词、工作目录、会话名),供脚本与自动化调用。
  3. 自动化触发开关:定时任务触发时可选「在新建会话中运行」,实现每轮触发即全新上下文。

价值场景

  • 长任务自动换届:上下文红线自动开新会话接力,旧会话收尾终止;
  • 多会话并发分区:同一工作区多会话按写集分区并行,互不干扰;
  • 无人值守接力:定时任务触发全新上下文执行体,避免长会话压缩退化。

环境

Windows 11;ZCode 3.14.4(zcode:// 协议注册成功实证);Node 24 桌面宿主。

Activity

  1. github-actions commented on Oct 5, 2026

    @github-actions

    👋 感谢你的反馈,我们已经收到。

    • 维护者看到后会尽快回复你。
    • 状态保持为 status: 待评估,你可以随时补充信息。
    • 信息不全时我们会打上 needs: 更多信息 标签并 @ 你。

    👋 Thanks — we've received your issue.

    • A maintainer will get back to you as soon as we can.
    • Status stays at status: 待评估 (Triage); feel free to add context.
    • If we need more details, we'll add needs: 更多信息 and ping you.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions