qwen-code Daemon Channel 运行时控制不重启即可热切换频道选择【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code本篇技术指南围绕 qwen-code 的 daemon 频道运行时控制Channel Runtime Control机制展开。它解决的核心问题是daemon 在未携带--channel启动后如何在不重启进程的前提下动态启用、替换、检查、重载与停止频道ChannelWorker 的选择。读完本文你将掌握GET/PUT/DELETE /workspace/channel与POST /workspace/channel/reload的完整调用契约、运行时选择的生命周期与回滚语义、启动时--channel与serve.channels的兼容恢复规则以及qwen channel set等 CLI 操作的实际用法。设计目标把频道选择从启动参数变成运行时可变状态在传统设计中daemon 启动时通过--channel参数决定启动哪些频道 Worker之后若想调整频道列表只能重启整个 daemon。qwen-code 的运行时控制层改变了这一模型其核心目标包括daemon 可以完全不携带--channel启动频道运行时处于禁用状态不占用 channel service 租约运行时通过 HTTP API 或 CLI 即可启用、替换、检查、重载、停止频道选择全程无需重启 daemon运行时更改不持久化下次 daemon 启动时优先遵循显式的--channel若未显式指定则恢复受信任主工作区trusted primary workspace配置中的serve.channels若两者都不存在频道保持禁用。这套控制层位于按工作区分组workspace-grouped的 Worker 实现之上channel-worker-manager.ts由它统一持有已提交committed的选择、串行化生命周期变更、守护 serve 拥有的 channel-service 租约并且只对有序选择发生变化的工作区组执行协调reconcile。公共契约四个 HTTP 端点与 capability 通告运行时控制暴露在 daemon 的 HTTP API 上所有变更类操作PUT / DELETE / POST都经过严格的 operator-authority 门禁deps.mutate({ strict: true })见 workspace-channel-control.ts。查询当前状态GET /workspace/channel返回已提交的选择、可选的待定pending选择、当前迁移状态transition以及带工作区标注的 Worker 快照。典型响应结构如下{ enabled: true, selection: { mode: names, names: [telegram, feishu] }, transition: idle, workers: [ { workspaceCwd: /data/workspace-a, state: running, channels: [telegram, feishu], pid: 12345 } ] }其中transition可取idle、starting、reconciling、stopping、rolling_back对应快照由snapshot()在 channel-worker-manager.ts 中统一构建只要存在已提交选择、Worker 组或已预留租约三者之一enabled即为true。启用或替换选择PUT /workspace/channel请求体接受两种形态{ selection: { mode: names, names: [telegram, feishu] } }或{ selection: { mode: all } }语义约束与 channel-selection.ts 中normalizeServeChannelSelection的实现一致names模式每个名称先trim()再去重保序、不排序空名称会直接报错空选择没有任何有效名称无效返回invalid_channel_selectionall不能与names混用源码中会抛错all cannot be combined with channel names在多工作区模式下all仅对主工作区生效primary-workspace-only。成功时返回 200若为首次启用则返回 201响应中包含changed、replaced、partial与最新state{ changed: true, replaced: false, partial: false, state: { enabled: true, selection: { mode: names, names: [telegram] }, transition: idle, workers: [] } }禁用选择DELETE /workspace/channel幂等地禁用运行时选择停止所有频道 Worker、释放 channel-service 租约并清空已提交选择。若本来就没有启用任何频道则返回changed: false不会报错。重载设置POST /workspace/channel/reload重新读取设置settings并按已提交选择重建 Worker 组用于配置热更新场景。若 daemon 当前没有任何已提交的频道选择则返回 409 与channel_worker_not_enabled提示先设置运行时选择。错误码与状态码语义从 workspace-channel-control.ts 的错误映射实现可以看到完整的错误契约HTTP 状态码错误码触发场景400invalid_channel_selection选择体结构非法、names非字符串数组、all混用names、空选择400channel_workspace_mismatch/ambiguous_channel_workspace频道与工作区归属不匹配或归属存在歧义403untrusted_workspace目标工作区未通过信任校验409channel_control_workspace_limit_reached运行时控制的工作区数量达到上限409channel_service_conflictchannel service 被其他 owner/pid 占用响应中携带owner与pid409channel_worker_not_enabled尝试重载/停止未启用的选择500channel_worker_stop_failed停止 Worker 失败502channel_worker_start_failed启动/替换 Worker 失败响应中可携带rolledBack、rollbackError、startupFailures503daemon_drainingdaemon 正在关停拒绝新的变更其中channel_worker_start_failed的startupFailures数组按工作区与频道展开启动连接阶段的失败明细并受startupFailuresTruncated截断标记保护所有诊断字段都会经过凭据脱敏redactLogCredentials与日志文本净化。Capability 通告在 capabilities.ts 中channel_control与channel_reload两个 capability 均在 v1 版本起可用但其通告条件不同channel_control资源本身一经支持即通告channel_reload仅当 manager 持有已提交且可重载的选择时才通告源码中对应channelReloadAvailable true的 toggle 判定。这保证了客户端可以据此判断当前 daemon 是否值得展示重载频道入口。生命周期串行化、预检、替换与回滚单 FIFO 通道串行化所有变更manager 对外暴露不可变快照immutable snapshots所有变更操作——startInitial、setSelection、setChannelEnabled、stopSelection、reload——都通过同一条 FIFO lane 排队执行enqueue实现于 channel-worker-manager.ts。这保证了并发请求之间不存在交错竞争每一次状态迁移在下一个操作开始前完成。变更前的预检preflight一次选择更新在停止任何 Worker 之前会先完成工作区归属解析resolveGroups区分initial/set/reload三种场景工作区数量上限校验工作区信任trust校验channel-service 租约预留reserve。任何一项不通过迁移状态立即回到idle已提交状态保持不变。租约在 Workers 真正启动前就完成预留避免出现两个 daemon 抢同一 channel service的窗口。协调式替换只动变化的工作区执行替换时manager 调用group.reconcile(targetGroups, ...)未变化的工作区条目直接保留发生变化或被移除的条目先停止、再启动替换整个过程中 daemon 始终持有全局 channel-service 租约不会释放。失败回滚与rolledBack语义如果替换失败manager 会尝试停止本次新启动的条目重启之前的条目。但清理与恢复本身也可能失败因此客户端必须同时检查rolledBack、rollbackError与state三个字段rolledBack为false且存在rollbackError时说明回滚动作自身未完成。源码中classifyFailure与各catch分支如 channel-worker-manager.ts正是围绕这一语义构造错误对象。硬停止失败SIGKILL 后无法确认子进程退出一个需要特别关注的边界当 supervisor 对子进程执行 SIGKILL 后未观察到子进程退出这被认定为硬停止失败hard stop failure。此时supervisor 保留子进程引用manager 保留 channel-service 租约不派生任何替换 Worker。这是为了避免在旧进程可能仍存活的情况下出现双实例冲突宁可让频道保持不可用也不制造资源竞争。generation 隔离旧回调不能污染新状态Worker 回调携带代际generation信息。来自已被替换条目的回调可能仍会触发例如异步日志但它们不能更新当前的 pidfile 或路由状态从而杜绝上一个实例的迟到事件改写新实例状态的问题。原子提交与完整 pidfile 快照一次成功的提交会把选择selection、Webhook 配置、Worker 映射三者一起原子交换commit函数随后重写完整的 pidfile 快照保证磁盘上的运行态信息与内存中的已提交状态一致。部分适配器连接保留既有的部分连接行为只要至少一个请求的频道成功连接该 Worker 即视为 ready。控制结果中通过partial: true报告部分连接daemon 状态也会继续发出channel_worker_partial_connect遥测事件方便上层区分完全就绪与部分可用。启动兼容性--channel与serve.channels的恢复规则三种启动路径启动条件频道运行时行为显式传入--channel使用同一套 manager保留监听前租约预留与成功前就绪ready-before-success的既有启动行为未传--channel但受信任主工作区配置了serve.channels自动恢复该持久化选择两者皆无不预留 channel service不加载重量级频道运行时直到第一次运行时变更mutation才按需启用注意几点启动时的选择使用持久化的文件夹信任设置且 Workers 启动前会再次检查工作区归属与信任次级工作区不会独立恢复自己的serve.channels只有主工作区的持久化配置会被自动恢复若自动恢复被跳过或失败诊断信息记录在 daemon 日志中且不会用启动失败快照去覆盖已配置的实例或启动开关。启动名称的合法性校验存储在serve.channels中的启动名称必须满足非空无首尾空白字符不含不安全控制字符或不可见字符。校验失败的条目会按数组索引单独跳过并记录日志测试断言如ignored invalid workspace serve.channels entry at index 0而不是整体放弃同时启动逻辑不会把无效名称 trim 成其他实例名也不会改写存储的配置。每个合法名称以--channelvalue原样传给 Worker因此即使名称以-开头该连字符仍是值的一部分而非参数标志。若启动字段本身非法、或 Workers 启动前发生校验/租约错误自动恢复会被跳过并在日志中定位到serve.channels其余无关设置保持生效。若 Worker 启动失败daemon 只有在清理成功后才会继续在 Worker 终止尚未确认期间channel-service 租约始终被持有。CLI 实战qwen channel set与配套命令除了 HTTP API运行时控制也以 CLI 形式暴露。核心新命令是qwen channel set实现于 packages/cli/src/commands/channel/set.ts用法如下# 命名模式启用 telegram 与 feishu qwen channel set telegram feishu # 全量模式all 必须单独出现 qwen channel set all # 指定 daemon 地址与鉴权 token qwen channel set telegram --daemon-url http://127.0.0.1:4170 --token token # 指定请求超时毫秒 qwen channel set feishu --timeout 15000参数说明names..一个或多个频道名或单独的值all。CLI 侧同样执行 trim 去重all与其他名称混用会被拒绝Pass one or more channel names, or all by itself.--daemon-urldaemon 基础地址默认取QWEN_DAEMON_URL_ENV环境变量否则回退到http://127.0.0.1:4170--tokenBearer token默认取QWEN_SERVER_TOKEN_ENV或QWEN_DAEMON_TOKEN_ENV--timeout请求超时毫秒。命令输出会汇总每个工作区的频道结果例如[Channel] Selection applied (replacedfalse, partialfalse, workers/data/workspace-a:telegram,feishu).失败时输出[Channel] Set failed (baseUrl): 原因并附带各工作区/频道的启动失败明细。此外channel stop 与 status 也提供了远程remote变体可与qwen channel set组合成完整的启停查闭环。兼容性与迁移设计明确保留了所有既有入口的兼容性legacy 的runtime.channelWorker、分组后的runtime.channelWorkers、pidfile 字段、standalone 的qwen channel start与qwen channel reload均继续可用。新增能力只是在其之上叠加了运行时控制层因此既有自动化脚本可以逐步迁移到qwen channel set 远程 stop/status而无需一次性改造。总结qwen-code 的 Channel Runtime Control 把频道选择从进程启动参数升级为运行时可变的期望状态desired stateAPI 面GET /workspace/channel查询、PUT启用/替换、DELETE禁用、POST /workspace/channel/reload重载全部走严格 operator-authority 门禁一致性FIFO 串行化 变更前预检 失败回滚 generation 隔离 原子提交保证任意并发与失败场景下运行时状态不产生撕裂启动兼容--channel显式优先其次恢复主工作区serve.channels都没有则按需惰性启用且自动恢复失败不会污染既有配置运维面qwen channel set telegram feishu一条命令即可完成频道热切换无需重启 daemon。如需深入实现细节可继续阅读 workspace-channel-control.ts路由与错误码、channel-worker-manager.ts生命周期状态机、channel-selection.ts选择归一化以及 channel-worker-manager.test.ts 与 workspace-channel-management.test.ts 中的行为测试用例。【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
qwen-code Daemon Channel 运行时控制不重启即可热切换频道选择【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code本篇技术指南围绕 qwen-code 的 daemon 频道运行时控制Channel Runtime Control机制展开。它解决的核心问题是daemon 在未携带--channel启动后如何在不重启进程的前提下动态启用、替换、检查、重载与停止频道ChannelWorker 的选择。读完本文你将掌握GET/PUT/DELETE /workspace/channel与POST /workspace/channel/reload的完整调用契约、运行时选择的生命周期与回滚语义、启动时--channel与serve.channels的兼容恢复规则以及qwen channel set等 CLI 操作的实际用法。设计目标把频道选择从启动参数变成运行时可变状态在传统设计中daemon 启动时通过--channel参数决定启动哪些频道 Worker之后若想调整频道列表只能重启整个 daemon。qwen-code 的运行时控制层改变了这一模型其核心目标包括daemon 可以完全不携带--channel启动频道运行时处于禁用状态不占用 channel service 租约运行时通过 HTTP API 或 CLI 即可启用、替换、检查、重载、停止频道选择全程无需重启 daemon运行时更改不持久化下次 daemon 启动时优先遵循显式的--channel若未显式指定则恢复受信任主工作区trusted primary workspace配置中的serve.channels若两者都不存在频道保持禁用。这套控制层位于按工作区分组workspace-grouped的 Worker 实现之上channel-worker-manager.ts由它统一持有已提交committed的选择、串行化生命周期变更、守护 serve 拥有的 channel-service 租约并且只对有序选择发生变化的工作区组执行协调reconcile。公共契约四个 HTTP 端点与 capability 通告运行时控制暴露在 daemon 的 HTTP API 上所有变更类操作PUT / DELETE / POST都经过严格的 operator-authority 门禁deps.mutate({ strict: true })见 workspace-channel-control.ts。查询当前状态GET /workspace/channel返回已提交的选择、可选的待定pending选择、当前迁移状态transition以及带工作区标注的 Worker 快照。典型响应结构如下{ enabled: true, selection: { mode: names, names: [telegram, feishu] }, transition: idle, workers: [ { workspaceCwd: /data/workspace-a, state: running, channels: [telegram, feishu], pid: 12345 } ] }其中transition可取idle、starting、reconciling、stopping、rolling_back对应快照由snapshot()在 channel-worker-manager.ts 中统一构建只要存在已提交选择、Worker 组或已预留租约三者之一enabled即为true。启用或替换选择PUT /workspace/channel请求体接受两种形态{ selection: { mode: names, names: [telegram, feishu] } }或{ selection: { mode: all } }语义约束与 channel-selection.ts 中normalizeServeChannelSelection的实现一致names模式每个名称先trim()再去重保序、不排序空名称会直接报错空选择没有任何有效名称无效返回invalid_channel_selectionall不能与names混用源码中会抛错all cannot be combined with channel names在多工作区模式下all仅对主工作区生效primary-workspace-only。成功时返回 200若为首次启用则返回 201响应中包含changed、replaced、partial与最新state{ changed: true, replaced: false, partial: false, state: { enabled: true, selection: { mode: names, names: [telegram] }, transition: idle, workers: [] } }禁用选择DELETE /workspace/channel幂等地禁用运行时选择停止所有频道 Worker、释放 channel-service 租约并清空已提交选择。若本来就没有启用任何频道则返回changed: false不会报错。重载设置POST /workspace/channel/reload重新读取设置settings并按已提交选择重建 Worker 组用于配置热更新场景。若 daemon 当前没有任何已提交的频道选择则返回 409 与channel_worker_not_enabled提示先设置运行时选择。错误码与状态码语义从 workspace-channel-control.ts 的错误映射实现可以看到完整的错误契约HTTP 状态码错误码触发场景400invalid_channel_selection选择体结构非法、names非字符串数组、all混用names、空选择400channel_workspace_mismatch/ambiguous_channel_workspace频道与工作区归属不匹配或归属存在歧义403untrusted_workspace目标工作区未通过信任校验409channel_control_workspace_limit_reached运行时控制的工作区数量达到上限409channel_service_conflictchannel service 被其他 owner/pid 占用响应中携带owner与pid409channel_worker_not_enabled尝试重载/停止未启用的选择500channel_worker_stop_failed停止 Worker 失败502channel_worker_start_failed启动/替换 Worker 失败响应中可携带rolledBack、rollbackError、startupFailures503daemon_drainingdaemon 正在关停拒绝新的变更其中channel_worker_start_failed的startupFailures数组按工作区与频道展开启动连接阶段的失败明细并受startupFailuresTruncated截断标记保护所有诊断字段都会经过凭据脱敏redactLogCredentials与日志文本净化。Capability 通告在 capabilities.ts 中channel_control与channel_reload两个 capability 均在 v1 版本起可用但其通告条件不同channel_control资源本身一经支持即通告channel_reload仅当 manager 持有已提交且可重载的选择时才通告源码中对应channelReloadAvailable true的 toggle 判定。这保证了客户端可以据此判断当前 daemon 是否值得展示重载频道入口。生命周期串行化、预检、替换与回滚单 FIFO 通道串行化所有变更manager 对外暴露不可变快照immutable snapshots所有变更操作——startInitial、setSelection、setChannelEnabled、stopSelection、reload——都通过同一条 FIFO lane 排队执行enqueue实现于 channel-worker-manager.ts。这保证了并发请求之间不存在交错竞争每一次状态迁移在下一个操作开始前完成。变更前的预检preflight一次选择更新在停止任何 Worker 之前会先完成工作区归属解析resolveGroups区分initial/set/reload三种场景工作区数量上限校验工作区信任trust校验channel-service 租约预留reserve。任何一项不通过迁移状态立即回到idle已提交状态保持不变。租约在 Workers 真正启动前就完成预留避免出现两个 daemon 抢同一 channel service的窗口。协调式替换只动变化的工作区执行替换时manager 调用group.reconcile(targetGroups, ...)未变化的工作区条目直接保留发生变化或被移除的条目先停止、再启动替换整个过程中 daemon 始终持有全局 channel-service 租约不会释放。失败回滚与rolledBack语义如果替换失败manager 会尝试停止本次新启动的条目重启之前的条目。但清理与恢复本身也可能失败因此客户端必须同时检查rolledBack、rollbackError与state三个字段rolledBack为false且存在rollbackError时说明回滚动作自身未完成。源码中classifyFailure与各catch分支如 channel-worker-manager.ts正是围绕这一语义构造错误对象。硬停止失败SIGKILL 后无法确认子进程退出一个需要特别关注的边界当 supervisor 对子进程执行 SIGKILL 后未观察到子进程退出这被认定为硬停止失败hard stop failure。此时supervisor 保留子进程引用manager 保留 channel-service 租约不派生任何替换 Worker。这是为了避免在旧进程可能仍存活的情况下出现双实例冲突宁可让频道保持不可用也不制造资源竞争。generation 隔离旧回调不能污染新状态Worker 回调携带代际generation信息。来自已被替换条目的回调可能仍会触发例如异步日志但它们不能更新当前的 pidfile 或路由状态从而杜绝上一个实例的迟到事件改写新实例状态的问题。原子提交与完整 pidfile 快照一次成功的提交会把选择selection、Webhook 配置、Worker 映射三者一起原子交换commit函数随后重写完整的 pidfile 快照保证磁盘上的运行态信息与内存中的已提交状态一致。部分适配器连接保留既有的部分连接行为只要至少一个请求的频道成功连接该 Worker 即视为 ready。控制结果中通过partial: true报告部分连接daemon 状态也会继续发出channel_worker_partial_connect遥测事件方便上层区分完全就绪与部分可用。启动兼容性--channel与serve.channels的恢复规则三种启动路径启动条件频道运行时行为显式传入--channel使用同一套 manager保留监听前租约预留与成功前就绪ready-before-success的既有启动行为未传--channel但受信任主工作区配置了serve.channels自动恢复该持久化选择两者皆无不预留 channel service不加载重量级频道运行时直到第一次运行时变更mutation才按需启用注意几点启动时的选择使用持久化的文件夹信任设置且 Workers 启动前会再次检查工作区归属与信任次级工作区不会独立恢复自己的serve.channels只有主工作区的持久化配置会被自动恢复若自动恢复被跳过或失败诊断信息记录在 daemon 日志中且不会用启动失败快照去覆盖已配置的实例或启动开关。启动名称的合法性校验存储在serve.channels中的启动名称必须满足非空无首尾空白字符不含不安全控制字符或不可见字符。校验失败的条目会按数组索引单独跳过并记录日志测试断言如ignored invalid workspace serve.channels entry at index 0而不是整体放弃同时启动逻辑不会把无效名称 trim 成其他实例名也不会改写存储的配置。每个合法名称以--channelvalue原样传给 Worker因此即使名称以-开头该连字符仍是值的一部分而非参数标志。若启动字段本身非法、或 Workers 启动前发生校验/租约错误自动恢复会被跳过并在日志中定位到serve.channels其余无关设置保持生效。若 Worker 启动失败daemon 只有在清理成功后才会继续在 Worker 终止尚未确认期间channel-service 租约始终被持有。CLI 实战qwen channel set与配套命令除了 HTTP API运行时控制也以 CLI 形式暴露。核心新命令是qwen channel set实现于 packages/cli/src/commands/channel/set.ts用法如下# 命名模式启用 telegram 与 feishu qwen channel set telegram feishu # 全量模式all 必须单独出现 qwen channel set all # 指定 daemon 地址与鉴权 token qwen channel set telegram --daemon-url http://127.0.0.1:4170 --token token # 指定请求超时毫秒 qwen channel set feishu --timeout 15000参数说明names..一个或多个频道名或单独的值all。CLI 侧同样执行 trim 去重all与其他名称混用会被拒绝Pass one or more channel names, or all by itself.--daemon-urldaemon 基础地址默认取QWEN_DAEMON_URL_ENV环境变量否则回退到http://127.0.0.1:4170--tokenBearer token默认取QWEN_SERVER_TOKEN_ENV或QWEN_DAEMON_TOKEN_ENV--timeout请求超时毫秒。命令输出会汇总每个工作区的频道结果例如[Channel] Selection applied (replacedfalse, partialfalse, workers/data/workspace-a:telegram,feishu).失败时输出[Channel] Set failed (baseUrl): 原因并附带各工作区/频道的启动失败明细。此外channel stop 与 status 也提供了远程remote变体可与qwen channel set组合成完整的启停查闭环。兼容性与迁移设计明确保留了所有既有入口的兼容性legacy 的runtime.channelWorker、分组后的runtime.channelWorkers、pidfile 字段、standalone 的qwen channel start与qwen channel reload均继续可用。新增能力只是在其之上叠加了运行时控制层因此既有自动化脚本可以逐步迁移到qwen channel set 远程 stop/status而无需一次性改造。总结qwen-code 的 Channel Runtime Control 把频道选择从进程启动参数升级为运行时可变的期望状态desired stateAPI 面GET /workspace/channel查询、PUT启用/替换、DELETE禁用、POST /workspace/channel/reload重载全部走严格 operator-authority 门禁一致性FIFO 串行化 变更前预检 失败回滚 generation 隔离 原子提交保证任意并发与失败场景下运行时状态不产生撕裂启动兼容--channel显式优先其次恢复主工作区serve.channels都没有则按需惰性启用且自动恢复失败不会污染既有配置运维面qwen channel set telegram feishu一条命令即可完成频道热切换无需重启 daemon。如需深入实现细节可继续阅读 workspace-channel-control.ts路由与错误码、channel-worker-manager.ts生命周期状态机、channel-selection.ts选择归一化以及 channel-worker-manager.test.ts 与 workspace-channel-management.test.ts 中的行为测试用例。【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
