[PR #334] docs: add AdaL integration guide

## 📋 Pull Request Information **Original PR:** https://github.com/deepseek-ai/awesome-deepseek-agent/pull/334 **Author:** [@Ricardoran](https://github.com/Ricardoran) **Created:** 7/31/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `add-adal-integration` --- ### 📝 Commits (5) - [`f000e20`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/f000e2081f068c647ed52718d22dbb78faebab65) docs: add AdaL integration guide - [`1dda40a`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/1dda40a5a71affafe05cd2310a87db60dadb6f9f) fix: correct AdaL install commands and remove false BYOAK claim - [`ff6d152`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/ff6d152feda0a0ca019de875d1edbe7bc55578dd) docs: correct AdaL description and clarify DeepSeek 1M context - [`95bc198`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/95bc1988c586c4b4fcfce941667ddb2aceca281d) docs: simplify AdaL DeepSeek context note to 1M window - [`e38eb2f`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/e38eb2f632c5bef234c1f61bd19232ee433c4b1a) docs: document DeepSeek BYOAK support for AdaL ### 📊 Changes **4 files changed** (+142 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+1 -0) 📝 `README.zh-CN.md` (+1 -0) ➕ `docs/adal.md` (+70 -0) ➕ `docs/adal.zh-CN.md` (+70 -0) </details> ### 📄 Description ## TL;DR Adds [AdaL](https://github.com/SylphAI-Inc/adal-cli) to the tools table, with bilingual (EN + zh-CN) integration guides covering installation, DeepSeek model selection, and headless usage. ## What is AdaL AdaL is an AI coding agent for the terminal and browser (same space as Claude Code, Codex, Cursor), with an SDK and cloud agent hosting. Docs: https://docs.sylph.ai DeepSeek-V4-Pro and V4-Flash are both available in AdaL's model catalog and routed through AdaL's hosted proxy. ## Checklist (per CONTRIBUTING.md) ### Agent Configuration - [x] **Model names are current**: `deepseek-deepseek-v4-pro` / `deepseek-deepseek-v4-flash`. These are AdaL's catalog keys (AdaL namespaces every key as `<provider>-<model_id>`, hence the doubled `deepseek-`); verified against the live catalog response, not guessed. - [x] **1M context**: the guide states both models run with a 1M-token context window in AdaL, with no manual config needed. - [ ] **Max thinking / reasoning effort — not supported, documented honestly.** AdaL wires per-request reasoning effort per provider, and DeepSeek is not currently among the providers with an effort path, so there is no `max` setting to document. I chose to state this plainly rather than invent a flag that does not exist. Adding DeepSeek effort support is on our side to fix; happy to follow up with a docs PR once it ships. - [x] **Config fields verified to work**: `/model <key>`, `/byoak add deepseek`, and the `-q ... -m <key>` headless form verified against AdaL's actual command catalog, provider map, and model registry. - [x] **No workarounds for upstream bugs** — none needed; thinking mode is not disabled anywhere in this guide. - [x] **Pricing**: intentionally omitted, so there are no numbers to drift out of date. ### Documentation - [x] Both English (`docs/adal.md`) and Chinese (`docs/adal.zh-CN.md`) in this single PR - [x] README entry inserted alphabetically in both `README.md` and `README.zh-CN.md` (AdaL sorts before AstrBot) - [x] One tool per PR - [x] No images in this PR (none needed) ## Notes on accuracy Every claim was verified against AdaL's source rather than its docs, since docs drift: - Model keys + context windows: AdaL's model registry, cross-checked against the live catalog endpoint. - **BYOAK**: AdaL supports bring-your-own-API-key for DeepSeek — the guide documents `/byoak add deepseek`, verified against AdaL's command catalog and provider map. The proxy remains the default (billed via AdaL credits); BYOAK is the opt-in path for billing usage directly to your own DeepSeek account. (An intermediate revision of this PR stated BYOAK was limited to Anthropic/OpenAI/Google; that reflected an older key allowlist and has been corrected.) - **Description**: an earlier revision described AdaL as "open-source". That was also inaccurate and has been corrected — the AdaL CLI is not open-source, and the entry no longer claims it. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi commented

2026-10-26 09:48:20 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/deepseek-ai/awesome-deepseek-agent/pull/334
Author: @Ricardoran
Created: 7/31/2026
Status: 🔄 Open

Base: main ← Head: add-adal-integration

📝 Commits (5)

f000e20 docs: add AdaL integration guide
1dda40a fix: correct AdaL install commands and remove false BYOAK claim
ff6d152 docs: correct AdaL description and clarify DeepSeek 1M context
95bc198 docs: simplify AdaL DeepSeek context note to 1M window
e38eb2f docs: document DeepSeek BYOAK support for AdaL

📊 Changes

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

View changed files

📝 README.md (+1 -0)
📝 README.zh-CN.md (+1 -0)
➕ docs/adal.md (+70 -0)
➕ docs/adal.zh-CN.md (+70 -0)

📄 Description

TL;DR

Adds AdaL to the tools table, with bilingual (EN + zh-CN) integration guides covering installation, DeepSeek model selection, and headless usage.

What is AdaL

AdaL is an AI coding agent for the terminal and browser (same space as Claude Code, Codex, Cursor), with an SDK and cloud agent hosting. Docs: https://docs.sylph.ai

DeepSeek-V4-Pro and V4-Flash are both available in AdaL's model catalog and routed through AdaL's hosted proxy.

Checklist (per CONTRIBUTING.md)

Agent Configuration

Model names are current: deepseek-deepseek-v4-pro / deepseek-deepseek-v4-flash. These are AdaL's catalog keys (AdaL namespaces every key as <provider>-<model_id>, hence the doubled deepseek-); verified against the live catalog response, not guessed.
1M context: the guide states both models run with a 1M-token context window in AdaL, with no manual config needed.
Max thinking / reasoning effort — not supported, documented honestly. AdaL wires per-request reasoning effort per provider, and DeepSeek is not currently among the providers with an effort path, so there is no max setting to document. I chose to state this plainly rather than invent a flag that does not exist. Adding DeepSeek effort support is on our side to fix; happy to follow up with a docs PR once it ships.
Config fields verified to work: /model <key>, /byoak add deepseek, and the -q ... -m <key> headless form verified against AdaL's actual command catalog, provider map, and model registry.
No workarounds for upstream bugs — none needed; thinking mode is not disabled anywhere in this guide.
Pricing: intentionally omitted, so there are no numbers to drift out of date.

Documentation

Both English (docs/adal.md) and Chinese (docs/adal.zh-CN.md) in this single PR
README entry inserted alphabetically in both README.md and README.zh-CN.md (AdaL sorts before AstrBot)
One tool per PR
No images in this PR (none needed)

Notes on accuracy

Every claim was verified against AdaL's source rather than its docs, since docs drift:

Model keys + context windows: AdaL's model registry, cross-checked against the live catalog endpoint.
BYOAK: AdaL supports bring-your-own-API-key for DeepSeek — the guide documents /byoak add deepseek, verified against AdaL's command catalog and provider map. The proxy remains the default (billed via AdaL credits); BYOAK is the opt-in path for billing usage directly to your own DeepSeek account. (An intermediate revision of this PR stated BYOAK was limited to Anthropic/OpenAI/Google; that reflected an older key allowlist and has been corrected.)
Description: an earlier revision described AdaL as "open-source". That was also inaccurate and has been corrected — the AdaL CLI is not open-source, and the entry no longer claims it.

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

bsakaguchi added the

pull-request

label

bsakaguchi referenced this issue

2026-10-26 09:48:27 +00:00

[PR #352] docs: add DeepSeekCode integration guide (bilingual) #364