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

29 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 审批或执行后台自主修复。