Plugin directory / Developer / dsh-ark-plan
dsh-ark-plan
Verified · install-tested on dsh snow-The
What it does
Correctly activate DeepSeek v4 flash on the Volcano Ark plan API for DeepSeek Harness: default config injection (reasoningEfforts + effort=max) + ark_plan_doctor self-check
Works — verified, early-stage project
Correctly activate DeepSeek v4 flash on the Volcano Ark plan API for DeepSeek Harness: default config injection (reasoningEfforts + effort=max) + ark_plan_doctor self-check It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-ark-plan
Activate DeepSeek v4 flash on the Volcano Ark plan API
(https://ark.cn-beijing.volces.com/api/plan/v3) in DeepSeek Harness —
the budget lane: 10× cheaper off-peak token bundles for the same model.
Strategy: built-in route + baseURL override (no custom provider)
The plugin reuses pi-ai's built-in deepseek provider — which already
knows the models (reasoning incl. effort=max, 1M context, 384K output) — and
only overrides baseURL to point at Ark's plan API. No hand-rolled "ark"
provider, nothing to re-declare, nothing to silently degrade.
Two lanes coexist:
| Lane | Provider | baseURL | Key env | Key prefix |
|---|---|---|---|---|
| Official (default) | deepseek-official |
api.deepseek.com | DEEPSEEK_API_KEY |
sk-... |
| Ark budget | deepseek (DeepSeek V4 Flash(ARK)) |
ark plan API | ARK_API_KEY |
ark-... |
Default model stays on the official route; the ark lane is there to burn the
cheap plan tokens when you want them — switch the model picker to thedeepseek provider's models to use it, then switch back when the bundle runs
out (don't buy more: the plan's value ends there).
Install
dsh plugin --profile web add github:snow-The/dsh-ark-plan
# restart dsh web
Configure keys
# ~/.dsh/.credentials.yaml (or the Models page)
DEEPSEEK_API_KEY: sk-... # official DeepSeek key (official lane)
ARK_API_KEY: ark-... # Volcano Ark plan key (ark lane)
The two envs are deliberately separate — a sk- key against the ark
baseURL answers 401 AuthenticationError and vice versa.
Verify
Ask your agent to run ark_plan_doctor. It reads the current config, flags
the known mistakes, and live-tests ark /chat/completions with the deepseek
thinking format (thinking.type=enabled + reasoning_effort=max) — expectserverModel = deepseek-v4-flash-ga-<date> (e.g. ...-ga-260731, the 0731
build) and thinking: true.
Traps this plugin encodes
| Trap | Symptom if missed |
|---|---|
Stale standalone ark provider (v0.1 layout) |
A duplicate "ark | 自定义" entry in the Models page with a red dot. Remove llm-pi-ai.providers.ark. |
reasoningEffort: max not set |
Thinking runs at the endpoint default (high), not max. |
| Wrong key family for the baseURL | sk-... against ark → 401; ark-... against api.deepseek.com → 401. Match key to endpoint. |
ARK_API_KEY missing |
The ark lane exists but answers 401 until its key is filled. |
| baseURL not the ark plan API | Plugin defaults do nothing if deepseek.baseURL points at api.deepseek.com — that's just the official route. |
How the defaults work
dsh-settings registers each entry's patch config as the base of its settings
section, so plugin defaults only apply where the user has not configured the
same keys. No overwriting of user settings.
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-ark-plan for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:snow-The/dsh-ark-planHeadless (CLI) profile:
dsh plugin --profile headless add github:snow-The/dsh-ark-planTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-ark-plan/)<a href="https://dshbase.com/plugins/dsh-ark-plan/"><img src="https://dshbase.com/badges/dsh-ark-plan.svg" alt="dshbase install-tested"></a>