[PR #373] docs: add ZCode (Z.ai) integration guide (EN + zh-CN) #379

Open
opened 2026-10-26 09:48:37 +00:00 by bsakaguchi · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/deepseek-ai/awesome-deepseek-agent/pull/373
Author: @wang-yi-bit64
Created: 8/13/2026
Status: 🔄 Open

Base: main ← Head: docs/zcode-zai-guide


📝 Commits (1)

  • 763fb68 docs: add ZCode integration guide (EN + zh-CN)

📊 Changes

4 files changed (+166 additions, -0 deletions)

View changed files

📝 README.md (+1 -0)
📝 README.zh-CN.md (+1 -0)
➕ docs/zcode-zai.md (+82 -0)
➕ docs/zcode-zai.zh-CN.md (+82 -0)

📄 Description

Add a bilingual integration guide for ZCode, the AI coding agent (desktop app + CLI) from Z.ai (Zhipu).

New files

  • docs/zcode-zai.md — English guide: install, DeepSeek API key, add DeepSeek from the built-in provider catalog (or custom endpoint), model selection, API key verification.
  • docs/zcode-zai.zh-CN.md — Simplified Chinese translation.

Agent table

  • ZCode entry added to README.md and README.zh-CN.md (alphabetical, after WorkBuddy/CodeBuddy).

Why the filename zcode-zai.md

  • docs/zcode.md is already taken by PR #289 (Z Code, the Zig terminal coding agent).
  • PR #364 (TunaTung) covers the same Z.ai product under zcode-ade.md; this PR intentionally uses a different filename so both can coexist until the maintainers decide how to merge them.

Configuration facts are verified against ZCode 2026.06 desktop app (app.asar) and its on-disk config.json, not guessed:

  • ZCode ships a built-in DeepSeek provider in its provider catalog (https://api.deepseek.com, openai-compatible + anthropic paths); model IDs deepseek-v4-pro / deepseek-v4-flash, context window 1,000,000, max output 384,000.
  • The actual UI path is Settings → Model Providers (模型供应商) → Add model provider (添加模型供应商), with a "Provider catalog (供应商目录)" option.
  • DeepSeek models default to the max reasoning variant (variants: off / high / max).
  • OpenAI-compatible format is Chat Completions (/chat/completions), not Responses.

CONTRIBUTING compliance: bilingual in one PR, README tables updated in alphabetical order, current model names (deepseek-v4-pro / deepseek-v4-flash), 1M context documented, no workarounds for upstream bugs, no screenshots (text-only guide).


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/deepseek-ai/awesome-deepseek-agent/pull/373 **Author:** [@wang-yi-bit64](https://github.com/wang-yi-bit64) **Created:** 8/13/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs/zcode-zai-guide` --- ### 📝 Commits (1) - [`763fb68`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/763fb686aca8cb0f7a6e25a0e3f2de680124971e) docs: add ZCode integration guide (EN + zh-CN) ### 📊 Changes **4 files changed** (+166 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+1 -0) 📝 `README.zh-CN.md` (+1 -0) ➕ `docs/zcode-zai.md` (+82 -0) ➕ `docs/zcode-zai.zh-CN.md` (+82 -0) </details> ### 📄 Description Add a bilingual integration guide for **ZCode**, the AI coding agent (desktop app + CLI) from Z.ai (Zhipu). **New files** - `docs/zcode-zai.md` — English guide: install, DeepSeek API key, add DeepSeek from the built-in provider catalog (or custom endpoint), model selection, API key verification. - `docs/zcode-zai.zh-CN.md` — Simplified Chinese translation. **Agent table** - `ZCode` entry added to `README.md` and `README.zh-CN.md` (alphabetical, after WorkBuddy/CodeBuddy). **Why the filename `zcode-zai.md`** - `docs/zcode.md` is already taken by PR #289 (Z Code, the Zig terminal coding agent). - PR #364 (TunaTung) covers the same Z.ai product under `zcode-ade.md`; this PR intentionally uses a different filename so both can coexist until the maintainers decide how to merge them. **Configuration facts are verified against ZCode 2026.06 desktop app (app.asar) and its on-disk `config.json`, not guessed:** - ZCode ships a **built-in DeepSeek provider** in its provider catalog (`https://api.deepseek.com`, openai-compatible + anthropic paths); model IDs `deepseek-v4-pro` / `deepseek-v4-flash`, context window 1,000,000, max output 384,000. - The actual UI path is **Settings → Model Providers (模型供应商) → Add model provider (添加模型供应商)**, with a "Provider catalog (供应商目录)" option. - DeepSeek models default to the `max` reasoning variant (variants: off / high / max). - OpenAI-compatible format is Chat Completions (`/chat/completions`), not Responses. **CONTRIBUTING compliance:** bilingual in one PR, README tables updated in alphabetical order, current model names (`deepseek-v4-pro` / `deepseek-v4-flash`), 1M context documented, no workarounds for upstream bugs, no screenshots (text-only guide). --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
Sign in to join this conversation.
No labels
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
deepseek-ai/awesome-deepseek-agent#379
No description provided.