Files
order-notification-automation/docs/zcode-integration-2026-10-18.md
T

3.4 KiB
Raw Blame History

ZCode 接入记录

来源与版本

  • 官方项目:https://github.com/zai-org/ZCode
  • 固定桌面发行版:https://github.com/zai-org/ZCode/releases/tag/v3.14.3
  • Windows x64 安装包:150014088 字节;官方 SHA-256 815721ad9888b03da2bba101faba7368896123849a6a82e3bc9e5fe5f3e5048b。
  • 解包入口 resources/glm/zcode.cjs 的 --version 实测为 0.16.9,SHA-256 38c9dfe1a2a884658b7530954bea6c573adcc1f3ae7e9eeda89d58f433e54eb2。不能把桌面发行版本当作 CLI 版本。
  • 通过独立进程调用官方运行包;仓库不复制其源代码或提交二进制。使用和再分发须遵循官方仓库及发行包的 NOTICE 和第三方许可。
  • 会话列表、消息和操作卡片交互参考 https://github.com/open-webui/open-webui 。未复制该项目代码、资源或引入其服务;不声称本项目内嵌 Open WebUI。

实际运行契约

使用 --prompt、--json、--mode plan 与完整的 --disallowed-tools 精确名称名单。固定包静态核对确认内置工具注册项被覆盖;此版本不以 * 表示所有工具。

私有临时 profile 写入权限配置、禁用插件/MCP/技能/子代理/记忆/hooks,隔离运行目录、用户目录和配置。空 .env 防止运行包向上加载其他环境文件;环境白名单阻断其他密钥、代理和遥测配置的继承。显式设置静态 builtin provider 和私有 personal provider 路径,不设置 bundled-refresh 路径,避免自动刷新。每轮结束清理,异常终止整个进程树;停止结果不明时不能标为“已停止”。这是软件权限约束,并非 Windows 用户或容器隔离。

使用官方旧配置导入的自定义 OpenAI 兼容 provider。实际模型请求已验证地址、模型名、Bearer 密钥与无工具列表。旧配置导入会忽略 tool_call:false 和输出 token 上限,因此它们不能作为安全控制依据;应用依靠完整工具禁用名单、最多 512 KiB 进程输出、最长 180 秒和固定业务动作校验。

每轮仅提供授权状态快照和截取后的历史,消息上限 4000 字、整体 prompt 上限 24000 UTF-16 字符。模型原生工具与业务操作分离;业务动作最多 3 项,由服务器保存 ID、用户点选、校验当前角色/所有权/目标后执行。模型不得提供命令、路径或任意请求参数。

验证方法与范围

  • node --test tests/assistant.test.cjs tests/zcode-runtime.test.cjs tests/assistant-http-ui.test.cjs:密文与重启恢复、用户隔离、来源白名单、恶意动作、权限、幂等、额度、取消、配置暂停、密钥轮换历史脱敏、运行环境、输出限额、API 与真实浏览器交互。
  • 官方包专项:设置 ORDER_TEST_ZCODE_CLI 为上述官方绝对入口后运行 node --test tests/zcode-official.test.cjs。测试仅连接回环的 SSE 模型夹具,核对真正发出的模型请求没有原生工具,再返回未经请求的 Write 调用,检查目录未生成 canary 文件。未设置入口时该项跳过,不能把跳过称为官方运行验收通过。
  • 浏览器验证包括连续对话与刷新恢复、恶意 HTML 原样显示、卡片点击才执行、停止回复、390 px 无横向溢出;截图只含虚构夹具数据。
  • 本机已校验并解包官方运行包;未提供真实模型 API 配置,不代表已登录供应商或可用付费额度。
  • 本次没有发送业务邮件、上传真实业务文件、修改 BPM 审批或执行后台自主修复。