[Docs] 「连接模型」文档的 DeepSeek 示例使用了已下线的模型名
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 22
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
使用环境
- 文档页:https://zcode.z.ai/cn/docs/configuration(「连接模型」→「自定义供应商」一节的 DeepSeek 示例)
- ZCode 版本:v3.11.2
- 平台:Windows 11 x64
问题
该页的 DeepSeek 示例给出的模型 ID 是:
deepseek-chat、deepseek-reasoner
这两个模型名在 DeepSeek 官方文档中已不存在。DeepSeek 当前的模型 ID 为:
deepseek-flash(对应 DeepSeek-V4.1-Flash)deepseek-v4-pro(对应 DeepSeek-V4-Pro-0813)
参考:https://api-docs.deepseek.com/quick_start/pricing
复现步骤
- 设置 → 模型设置 → 添加供应商
- 名称填
DeepSeek,OpenAI 接口地址填https://api.deepseek.com/v1,填入平台 Key - 按文档示例「添加模型」,输入
deepseek-chat - 打开启用开关,回到对话框选择该模型并发起对话
期望表现
示例应使用当前有效的模型 ID;或至少提示一句「模型名以平台当前文档为准」。
实际表现
照抄示例配置的模型已下线,对话直接调用失败。文档没有提示模型名可能变更,读者难以判断这是自己的配置问题还是模型已下线 —— 这个歧义会让排查绕远路(我在核对时才确认是模型名过期,而不是地址或 Key 的问题)。
建议
把示例中的模型 ID 更新为 deepseek-flash、deepseek-v4-pro。
顺带一问(非确定结论,想确认预期行为)
同一页各厂商示例的地址格式不一致:
| 厂商 | 文档中的地址 | 是否含版本段 |
|---|---|---|
| DeepSeek | https://api.deepseek.com/v1 |
有 |
| OpenAI | https://api.openai.com |
无 |
| OpenRouter | https://openrouter.ai/api |
无 |
如果这些值会被直接用作 base_url,那么 OpenAI 与 OpenRouter 两条可能缺版本段(OpenRouter 官方文档给的 base URL 是 https://openrouter.ai/api/v1);如果客户端会自动补 /v1,那就没问题。
外部无法判断属于哪种,所以这里只作为疑问提出,不是断言它们有错。如果是「会自动补全」,也许值得在文档里加一句说明,因为各厂商示例格式不一致容易让用户以为自己填错了。
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start at the 「连接模型」→「自定义供应商」 section of the configuration documentation page and verify the current DeepSeek model IDs against the linked DeepSeek documentation. Update the example IDs and clarify whether provider base URLs require a version suffix or are completed automatically; done means the examples reflect current supported values and explain any URL normalization.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 74/100