ZCode Plugins · common 0.9.1 · 手机重连命名修复

common 0.9.1 - 2026-10-30

修复手机远控重连时可能中断会话自动命名的问题。

Bug 修复

手机重连与本地调用共存（#176、#182）

• 本地客户端使用共享桥期间，手机页面重新认证时保留 Desktop 侧终端归属，避免中断在途标题生成与改名调用。
• 无本地客户端时，手机页面换代仍由 Desktop 释放旧页面的终端资源；不自动重放可能已执行的业务调用。

验证范围：网关回归覆盖模拟手机重连与终端资源释放；最终版本的真实手机重连尚未复测。

ZCode Plugins · common 0.9.0 + title 0.3.0 · 手机远控与命名提醒

common 0.9.0 - 2026-10-30

共享通知新增免打扰，并修复手机远控与本地插件共用网关时的终端身份问题。

新增

通知免打扰（#178）

• 公共依赖和自动命名提醒提供 24 小时免打扰按钮，各插件分别保存状态。
• 到期后恢复通知，并继续遵守原有两小时冷却。

Bug 修复

手机远控与共享桥共存（#176、#177）

• 内部握手与共享桥继承当前已配对手机的终端身份，避免建立本地调用时结束手机的终端归属。
• 身份失配、终端更换或 relay 错误后清除旧身份；虚拟配对与迟到消息不恢复旧身份。

验证范围：Windows Desktop 3.17.1.9553 隔离副本、relay V2 与真实手机普通会话已验证命名成功；真实手机回退后继续输入的完整场景仍待验收。Toast 按钮尚未在真实 Windows 桌面验收。

title 0.3.0 - 2026-10-30

修复会话回退后自动命名遗漏新分支内容的问题，并在命名模型配置不可用时提供排障提醒。

新功能

模型不可用提醒（#178）

• 所选模型或思考档位不在原窗口可用目录时，Stop 命名任务通过通知提示并提供可复制的排障提示词。
• 通知提供 24 小时免打扰，保持用户原有模型选择，不自动改选。

Bug 修复

回退后的命名历史（#176、#177）

• 兼容 conversation_rewind 的分支切点，保留回退前有效前缀与后续新分支消息。
• 继续支持旧回退格式；找不到切点时不重新纳入已废弃分支，也不放宽系统注入消息的过滤。

验证范围：历史裁剪契约已验证，真实手机普通会话已完成命名验证；真实手机回退后继续输入的完整场景仍待验收。模型目录可用但运行时请求失败的情况沿用已有网关错误分类。

插件系列标识

• 更新仓库整体及四个插件的透明标识，并接入 README 与市场目录（#178）；市场图标会在正式分支纳入文件后生效。
• app-mcp 与 side-editor 的已发布版本和 ZIP 保持不变。

ZCode Plugins · common 0.8.1 + app-mcp 0.11.3 · 3.17.1 适配档案与定时任务工具更名

common 0.8.1 - 2026-10-30

登记 Windows 3.17.1.9553 原版运行包的 local-only 适配档案：升级到该版本的 ZCode 仍可经统一补丁 CLI 自动路由识别，setup 现场生成候选。

新增

3.17.1 发行包适配（#172）

• 新增档案 windows-3.17.1.9553-9a09f6ef（修订号 1）：七处注入（P0-P6）逐锚点重建，原版 app.asar 摘要精确匹配路由；旧档案（3.16.2/3.16.3）字节与状态契约不变。
• 适配 3.16.x → 3.17.1 编译产物变化：注入注册处移至每会话连接 options、getToken 新增单飞包装，短路语义不变。
• 静态锚点核对、候选确定性与实际包副本 apply/restore 往返已验证；新版原生运行验收待隔离 lab 补做。

app-mcp 0.11.3 - 2026-10-30

定时任务启停工具更名，参数与行为保持不变，调用方仅需换名。

变更

定时任务启停工具更名（#173）

• set_cron_enabled 更名为 set_cron_paused_and_resumed，旧名不再提供；参数（automation_id、布尔 enabled、workspace_path、可选 workspace_key）、行为与返回结构不变，调用方只需更新工具名。
• 名称直述两态语义（enabled:false 暂停 lifecycle paused、true 恢复 active）；底层官方 RPC setAutomationEnabled 协议名不变。

ZCode Plugins · common 0.8.0 · 网关看护拉起与日志留存

suian-zcode-common 0.8.0 - 2026-10-25

为网关增加周期看护拉起与受限日志留存：网关非正常退出后自动恢复，运行日志按启动批次留存 7 天并自包含版本溯源。设计与决策见 看护拉起与日志留存规格 与 ADR 0001。

新增

看护拉起（keepalive pull-up）

• 计划任务在登录触发之外新增每 30 分钟重复的时间触发器（setup.ps1 -KeepaliveIntervalMin 可配 5-1440，写入 config.json，重跑未传参时沿用已装值）。
• 幂等两层：任务 MultipleInstances IgnoreNew 之上，启动器拉起前探测 /health，健康即退出（fail-open，探测异常不阻断拉起）。
• 存量安装重跑 setup Install/Restart 时按触发器形状比对自动重注册（Status 新增 keepalive_interval_min 与 keepalive_trigger_ok）；健康网关上的 Install 同样自愈触发器形状与间隔（任务缺失或启动动作一致而不符时原地重注册，不打断运行实例，先改任务再写配置，回执间隔即任务实际间隔）；旧启动链动作切换仍只报告待升级、交给安全重载，该场景下显式改间隔被拒绝并引导以同参 Restart 应用（0.8 之前无间隔字段的旧配置视为无已装间隔，任何间隔写入均拒绝），不写入未生效配置。
• 触发器间隔识别按完整 ISO 8601 duration 换算总分钟：任务计划程序登记的 PT1H/PT1H30M/P1D 与等值分钟写法视为同一形状，不误报、不反复重注册。
• 候选失败回退路径同样保持双触发器形状。

日志留存与自包含

• 网关 stdout/stderr 改为 DataDir/logs/gateway-<yyyyMMdd-HHmmss>.{out,error}.log 按启动批次命名成对文件，拉起前清理 7 天窗口外批次并迁移删除旧根目录单文件日志。
• 网关启动横幅升级为自描述 JSON（启动时刻、模式、端口、协议版本、build id 与部署路径、插件版本、Node 版本、pid、config 路径），作为每个批次 out.log 的首行。
• hook 与 toast-action 两族 jsonl 事件日志按天滚动（<族>-<yyyyMMdd>.log.jsonl），每行内嵌插件版本字段（v），写入点自清理 7 天窗口外日文件并删除旧单文件；Toast 执行器部署文本经占位符注入版本。

已知限制

• 进程存活但不监听的僵尸场景不在自动看护范围，需手动 Restart；注销后任务不运行（Interactive 会话语义不变）。
• PS 5.1 不接受无限重复时长，看护触发器以 10 年近似无限；最坏自愈延迟等于看护间隔。

---

本 Release 资产与市场条目说明

• suian-zcode-common-0.8.0.zip：本版主体（网关周期看护拉起、启动批次日志 7 天滚动、jsonl 日族按天滚动自包含版本）。
• suian-side-editor-0.4.0.zip：同版本重打包，仅 release.json 变化（buildId 随源码树前进、minimumCommonVersion 0.6.0→0.8.0），其余条目字节与 plugins-2026.10.21 一致。
• suian-zcode-title-0.2.1.zip / suian-zcode-app-mcp-0.11.2.zip：字节与既有发布一致，市场清单 URL 统一指向本 Release 位置。
• 凭证：tag plugins-2026.10.25 绑定提交 e5af562（市场候选采纳）；构建证据见 build-evidence.json，匿名下载核验见 public-download-verification.json。

ZCode Plugins · app-mcp 0.11.2 · GLM 部分结果回归修复

app-mcp 0.11.2 - 2026-10-23

修复 GLM 查询单路失败时，诊断处理覆盖另一项成功结果的回归。

Bug 修复

• 额度或重置卡查询以 null／undefined 拒绝时，保留另一项成功数据及 host_query_failed 标记，不再抛出 TypeError（#164）。
• 四种回归组合同时核对查询次数、连接释放和零次额度重置，保持原有部分成功语义。

本次仅更新 app-mcp；common、title、side-editor 沿用原发布资产。最终提交的 MCP 229 项测试通过，包含 GLM 两路查询以 null/undefined 拒绝的四种组合；未调用真实模型或消耗额度。

ZCode Plugins · common 0.7.3 + title 0.2.1 + app-mcp 0.11.1 · 空闲重附着修复与诊断

本次发布 common 0.7.3、title 0.2.1 与 app-mcp 0.11.1，修复一条空闲后重新附着的间歇性错误，并补齐诊断。side-editor 沿用 0.4.0。

common 0.7.3 - 2026-10-23

修复空闲后重新连接 Host 的一条间歇性协议错误路径，并补齐网关与调用方可关联的安全诊断。

Bug 修复

空闲后重新附着（Windows 3.16.3 隔离宿主）（#162）

• 最后一个使用者及内部查询结束后释放旧 Host 桥，下次附着建立新身份。
• 消费退役桥迟到的 terminal-owner-ended 通知，避免它破坏新连接或泄露物理桥身份；在线客户端仍共用 Host 桥。
• 保留请求取消顺序和已提交操作结果可能未知的语义，不自动重试业务写入。

其他改进

失败诊断（网关、公共客户端与业务调用方）（#162）

• 失败日志记录 UTC 时间、诊断 ID、阶段、帧序号、桥失效原因、关闭来源及实际运行版本和 buildId。
• 客户端保留健康检查、附着与 RPC 阶段；字段按白名单传递，不记录正文、凭据或会话标识。
• 诊断模块随网关部署闭包打包并纳入运行指纹。

验证范围：3.16.3.8992 真实隔离副本及回环 relay 夹具已重复验证；已验证的修复构建在 relay/local-only 各 216 次调用中无失败，发布前另补手机导航失败路径的契约验证。官方在线 relay 与真实手机组合仍待验收，不把这条复现归因为所有同码故障，见验证记录。

title 0.2.1 - 2026-10-23

命名失败结果和 runner 日志保留公共层诊断 ID、阶段与原因；日志不可写时向 stderr 报告。命名规则、模型选择和标题写入语义保持。配套修复 Toast 测试夹具的旧版本目录断言。

app-mcp 0.11.1 - 2026-10-23

补齐会话操作失败的分层诊断，配合 common 0.7.3 定位间歇性 Host 附着错误。

Bug 修复

跨层错误回执（会话工具、工件详情与 GLM）（#162）

• 工具结果保留网关阶段、原因码和安全诊断 ID，包括包装错误与部分成功中的失败。
• stderr 记录带时间戳的受控工具失败日志，不复制工具参数、对话正文或异常中的任意文本。
• 工具参数、写入语义及失败后不自动重试的行为保持。

三个 ZIP 随附 SHA256SUMS 与脱敏构建证据。官方在线 relay、真实手机组合及日常安装升级仍待用户验收。

ZCode Plugins · common 0.7.2 · ZCode 3.16.3 补丁路由

common 0.7.2 - 2026-10-23

追加 Windows ZCode 3.16.3.8992 的 local-only 适配档案，沿用 setup 自动路由与现场补丁准备流程。

其他改进

• 按新版 exe 版本与原版 asar 摘要选择独立修订号 1 的注入规则，保留 3.16.2 档案。
• 发布包携带新档案，无须下载完整宿主或手选补丁；业务插件不联动升版。
• 新旧补丁 50 项测试及 2 项 setup 契约通过，实际包副本应用/还原摘要一致。

验收边界：3.16.3 原生无登录冷启动、官方远控不可达、网关重连与 MCP 闭环仍待验收；本版提供适配候选，不代表新版完整兼容验收通过。

ZCode Plugins · common 0.7.1 · local-only 补丁引导修订

common 0.7.1 - 2026-10-23

补齐安装与升级路径的 local-only 补丁引导：已有 local-only 配置的机器升级后不再静默保留不可用状态。仅修订技能指引，无运行时代码变化，业务插件无需联动升版。

其他改进

• setup 升级流程（#158）：已有 local-only 配置时补核补丁状态（local_only_patch）并向用户交付三选一决策（补丁迁移 / 完整还原保持 relay / 明确暂缓），补丁未应用不得汇报升级完成
• setup 升级流程：local-only 完成判据改为重开后 desktop_ready 与原 Host 探针通过，网关健康检查通过不等于 Desktop 已连上本地网关
• setup 首次安装：部署网关前确认连接模式，local-only 受支持包直接走补丁安装完整流程，不在 relay 装成后再改
• configuration：补全"原配置 local-only 且应用升级到 3.16"的双分支引导，受支持包走补丁迁移、不受支持包完整还原切 relay

ZCode Plugins · common 0.7.0 · local-only 与补丁自动路由

common 0.7.0 - 2026-10-22

新增指定 Windows 3.16.2 运行包的 local-only 安装流程，并为后续版本适配建立自动路由。业务插件继续复用公共网关，无需联动升版。

新功能

3.16.2 本地远控（Windows）（#152）

• setup 可选择 local-only：Agent 预检并准备外部命令，用户关闭 ZCode 后执行补丁，继续使用原快捷方式。
• 受支持包可在无 ZCode 登录态、官方远控不可达时冷启动，并在网关重启后恢复连接。
• 切回 relay 时保留补丁并关闭本地开关；完整还原命令恢复原包及本功能管理的 relay 配置。
• 提供隔离测试环境、操作指南和 MCP、Stop 命名、侧栏评论的开发验证记录。

补丁自动路由（#153）

• 按平台、exe 版本和原版 asar 摘要选择随包适配档案；新增档案时保留旧档案和独立补丁修订号。
• 兼容历史候选与状态记录，支持同包补丁升级和还原。
• 应用前拒绝跨包候选、补丁降级及损坏记录；未知包明确报告不支持。

支持范围：真实支持限定 Windows 3.16.2.8769 的既定发行包，不泛化为整个 3.16 系列。新版本需追加适配档案并单独验收；自动路由不等于自动适配未知版本。

升级安排：补丁应用由用户保存工作、退出目标 ZCode 全部实例后在外部 PowerShell 执行。插件升级本身不会改写 Desktop，默认 relay 模式保留。

联网边界：local-only 免除官方远控连接，模型服务与套餐查询仍需相应服务可达。日常安装与在线 relay 的实际用户验收独立于隔离开发验证。

ZCode Plugins · common 0.6.0 · 网关升级忙退避与幂等锁

common 0.6.0 - 2026-10-21

本版本主线：网关升级从"要求用户手动暂停远控"演进为忙时自动退避、空闲闪断切换、事务幂等防重入（GUL 系列 #134–#137），另修复网关任务导航透传。

新功能

网关升级忙退避与空闲闪断（#136）

• Restart/Remove 在远控忙时自动指数退避重探（2 秒起步、15 秒封顶、默认 60 秒上限，-BusyTimeoutSec 可调），不再要求手动暂停远控
• V2 协议下连接空闲（无飞行操作）即闪断升级：Desktop V2 连接层自动重连并重放未确认请求，等价于一次网络抖动
• 超时仍忙则放弃本次切换并输出 remote_busy，旧服务保留、配置与任务不动，稍后重试即可
• 旧网关（健康无 rpc_in_flight 字段）或 V1 协议保守等待连接断开，不对 V1 Desktop 误发闪断

升级空闲信号与关闭端点（#134）

• /health 新增 rpc_in_flight：请求在飞计数，含建桥等待与手机远端透传保守占忙；订阅与纯连接不计
• /shutdown?idle=1 升级关闭：Desktop 在连但无飞行操作时放行，忙时 409；旧关闭语义不变

切换事务幂等锁（#135）

• upgrade.lock 独占句柄锁覆盖切换全程（含共享启动器写入），并发安装拿锁失败即明确报错（含持锁 pid）且不动任何文件
• 持锁进程崩溃或被杀由系统自动释放，无需陈旧清理

Bug 修复

• 网关透传任务导航：未登记工作区的会话恢复附着与打开（#133）
• 网关关闭幂等化；升级关闭失败分支先重探再判超时，瞬断后等待收尾（PR #138 审查修复）

其他改进

• 规格 7.2、仓库约定、安装技能与 README 端点表同步升级新语义（#137）

附带说明

• title 0.2.0、app-mcp 0.11.0 输入未变复用原字节
• editor 0.4.0 仅 release.json 的最低公共版本声明联动至 0.6.0，业务行为零变化

⚠️ 升级注意：手机 App 断线重连表现为外部行为，首次真实升级时建议观察远控会话恢复；V1 协议（3.16 前 Desktop）仍需等待连接断开的保守窗口。