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 the
deepseek 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) — expect
serverModel = 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
