docs: add ZWS_README_V2 — developer role fix documentation

Made-with: Cursor
This commit is contained in:
zhang-qiang
2026-03-20 21:47:02 +08:00
parent a7fe369ea0
commit dfbb9d5fff

View File

@@ -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 均按协议展示与编辑,避免误导并支持多协议并存时的差异化配置。
---
## 五、涉及文件摘要
| 区域 | 文件 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |