From dfbb9d5fff06f93caf01b079a1ad690867340527 Mon Sep 17 00:00:00 2001 From: zhang-qiang Date: Fri, 20 Mar 2026 21:47:02 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20add=20ZWS=5FREADME=5FV2=20=E2=80=94=20d?= =?UTF-8?q?eveloper=20role=20fix=20documentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Made-with: Cursor --- ZWS_README_V2.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/ZWS_README_V2.md b/ZWS_README_V2.md index d038fc12a9..cbed703397 100644 --- a/ZWS_README_V2.md +++ b/ZWS_README_V2.md @@ -70,7 +70,21 @@ --- -## 四、涉及文件摘要 +## 四、当前范围与后续扩展（按协议区分兼容性） + +### 当前实现仅针对 OpenAI 协议 + +- 本轮的「兼容性」配置（**工具 ID 9 位**、**不保留 developer 角色**）在实现上**只对 OpenAI 系协议生效**：请求经 OpenAI Chat Completions / Responses 格式转发时，才会应用这些选项。 +- **同一个模型**可能被多种协议调用（例如同一物理模型既走 OpenAI 兼容端点，也走 Anthropic Messages、或其它网关），理想情况下**兼容性应按「协议」维度**配置，由用户为每个协议单独选择是否做 9 位 tool id、是否不保留 developer 等。 +- **当前页面的「兼容性」入口没有标明协议**，容易让用户误以为这些选项对该模型的所有调用方式都生效；实际上只影响 **OpenAI 协议** 下的行为。 + +### 后续计划 + +- **按协议维护兼容性**：将兼容项（如 `normalizeToolCallId`、`preserveOpenAIDeveloperRole`）归属到「协议」维度（如 `openai`、`anthropic` 等），存储与 UI 均按协议展示与编辑，避免误导并支持多协议并存时的差异化配置。 + +--- + +## 五、涉及文件摘要 | 区域 | 文件 | | ---------- | ------------------------------------------------------------------------------------------------------------------------ |