diff --git a/README.md b/README.md index e2923b7..52d71b0 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,11 @@ --- -> Unofficial tool. Not affiliated with DeepSeek. +> Unofficial tool. Not affiliated with DeepSeek. Also not the same thing +> as [dsh](https://github.com/deepseek-ai/deepseek-harness), DeepSeek's +> official agent harness — dsh runs agents and executes tools; this is +> the API client underneath: one request, its cost, and the docs, from a +> shell. DeepSeek serves the same two models through four different wire formats — OpenAI chat, OpenAI Responses, Anthropic Messages, and FIM. Every other @@ -387,7 +391,11 @@ Honest limits: ## For agents Built to be scripted. See [AGENTS.md](AGENTS.md) for the full contract -and [skill/SKILL.md](skill/SKILL.md) for a drop-in agent skill. +and [skill/SKILL.md](skill/SKILL.md) for a drop-in agent skill. The skill +is an Anthropic-format `SKILL.md` bundle — the same format +[dsh](https://github.com/deepseek-ai/deepseek-harness) reads from +`~/.agents/skills` and `/.agents/skills` — so one skills +directory serves Claude Code, dsh and this CLI alike. ```bash deepseek chat "..." --json | jq -r '.choices[0].message.content' @@ -509,6 +517,8 @@ Design rulings and the reasons behind them: [TASTE.md](TASTE.md). - [AGENTS.md](AGENTS.md) · [skill/SKILL.md](skill/SKILL.md) — the scripting contract - [TASTE.md](TASTE.md) — design rejections and their reasons - [DeepSeek API docs](https://api-docs.deepseek.com/) — the upstream API +- [dsh (DeepSeek Harness)](https://github.com/deepseek-ai/deepseek-harness) — + DeepSeek's official agent harness; a different tool for a different layer ## License diff --git a/llms.txt b/llms.txt index 6919a57..1845959 100644 --- a/llms.txt +++ b/llms.txt @@ -40,3 +40,4 @@ response body unmodified. Exit codes: 0 ok, 1 error, 2 auth, 3 no balance, - [DeepSeek API docs](https://api-docs.deepseek.com/): the upstream API this wraps - [Models & pricing](https://api-docs.deepseek.com/quick_start/pricing): the rate card `pricing.go` encodes +- [dsh (DeepSeek Harness)](https://github.com/deepseek-ai/deepseek-harness): DeepSeek's official agent harness — it runs agent loops and executes tools, this CLI does not. Complementary layers: dsh drives the agent, deepseek-cli checks keys, prices calls and carries the docs. dsh skills are Anthropic SKILL.md-compatible (~/.agents/skills, /.agents/skills), so skills interop across harnesses diff --git a/site/build.py b/site/build.py index 3075c4d..7d2fe7f 100644 --- a/site/build.py +++ b/site/build.py @@ -1362,12 +1362,16 @@ def jstr(s): PAGES.append(dict( slug="news/", crumb="news", - title="DeepSeek API news: V4-Pro GA, the announced price rise, releases", - description="What is changing in the DeepSeek API: V4-Pro's official release (DeepSeek-V4-Pro-0813), an across-the-board price increase announced with no date yet, the 2x peak-hour pricing policy, V4-Flash's official release, and what each one does to the cost of a call.", - keywords="deepseek v4 pro release, deepseek v4 pro ga, deepseek-v4-pro-0813, deepseek api price increase, deepseek price rise 2026, deepseek peak hour pricing, deepseek api news, deepseek api changelog, deepseek v4 flash release, deepseek pricing change", + title="DeepSeek API news: dsh ships, V4-Pro GA, the announced price rise", + description="What is changing around the DeepSeek API: DeepSeek ships dsh (DeepSeek Harness), its official open-source agent harness, V4-Pro's official release (DeepSeek-V4-Pro-0813), an across-the-board price increase announced with no date yet, the 2x peak-hour pricing policy, V4-Flash's official release, and what each one means for a call.", + keywords="deepseek harness, dsh, @deepseek-ai/dsh, install dsh, dsh plugins, dsh skills, dsh-plugin, dsh vs claude code, deepseek cli vs dsh, deepseek v4 pro release, deepseek v4 pro ga, deepseek-v4-pro-0813, deepseek api price increase, deepseek price rise 2026, deepseek peak hour pricing, deepseek api news, deepseek api changelog, deepseek v4 flash release, deepseek pricing change", jsonld=faq([ ("Is DeepSeek V4-Pro officially released?", "Yes. On 2026-08-12 the model version on DeepSeek's Models & Pricing page changed to DeepSeek-V4-Pro-0813, ending the preview that had run since 2026-04-24. The model ID is unchanged (deepseek-v4-pro), the rate card is unchanged, and the release focuses on agentic post-training rather than new pretraining."), + ("What is dsh (DeepSeek Harness)?", + "dsh is DeepSeek's official open-source agent harness, released 2026-08-13 as deepseek-ai/deepseek-harness on GitHub and @deepseek-ai/dsh on npm (MIT). It is in developer preview with compatibility-breaking changes promised. Everything in it is a plugin, built on the Cordis runtime; `npx @deepseek-ai/dsh web` starts its Web UI. The official repository does not accept external pull requests, and there is no plugin marketplace or registry: discovery is the dsh-plugin GitHub topic, with the ecosystem explicitly delegated to the community."), + ("Is dsh the same as deepseek-cli?", + "No. dsh (DeepSeek Harness) is DeepSeek's official agent harness: it runs an agent loop, executes tools, and manages plugins, skills and sessions. deepseek-cli is an unofficial single-binary API client: it sends one request in any of DeepSeek's four wire formats, prints the response and its estimated cost, and carries DeepSeek's API documentation offline. They are complementary, not competing: run agents with dsh, and use deepseek-cli to check a key, price a call, debug the wire formats, or query the docs."), ("Is DeepSeek raising its API prices?", "Yes, a rise is announced but not yet in effect. On 2026-08-06 (Beijing time) DeepSeek posted a notice in the platform console and emailed API account holders saying all API services will be repriced in the near term and that the increase is expected to be substantial, advising developers to plan call volume and top-ups accordingly. No new rate card and no effective date have been published. Separately, a 2x peak-hour pricing policy has been announced since June 2026, also without an effective date."), ("When does DeepSeek's peak-hour pricing start?", @@ -1384,6 +1388,62 @@ def jstr(s): live API where that is possible; the in-terminal feed is ds docs changelog.

+

2026-08-13 · DeepSeek ships dsh, its own agent harness

+

DeepSeek released DeepSeek Harness: +deepseek-ai/deepseek-harness +on GitHub, @deepseek-ai/dsh on npm, dsh in the +shell, MIT. It is a developer preview and says so in capitals – +“THERE WILL BE COMPATIBILITY-BREAKING CHANGES” – and the +architecture is the pitch: everything is a plugin, on the +Cordis runtime. One +command starts it:

+
npx @deepseek-ai/dsh web     # Web UI at http://127.0.0.1:3080
+ +

The ecosystem is delegated, deliberately

+

The document worth reading twice is +CONTRIBUTING.md. +The official repository takes no external pull requests (“we are +sorry that we cannot accept external pull requests at the moment”), +and there is no plugin marketplace and no registry. Discovery is a GitHub +topic: tag your repository +dsh-plugin +and that is the catalogue. DeepSeek's framing of its own repo: “an +idea, an official showcase, and a source of inspiration, but not a +mandate”. The ecosystem's official badge is shields.io in the brand +blue, #4D6BFE:

+

powered by dsh: the official shields.io badge in DeepSeek brand blue #4D6BFE

+ +

dsh skills are Claude Code skills

+

dsh skills are SKILL.md directory bundles, the format +Anthropic's agent skills established, and the local provider reads them +from <project>/.agents/skills and +~/.agents/skills as well as its own .dsh/skills +roots. A skill already written for Claude Code drops in front of dsh +unchanged – including this +CLI's own skill, which teaches any harness to drive +deepseek for key checks, cost accounting and offline docs. +That is also the honest one-line comparison with Claude Code: +dsh is the model vendor's own harness, open source and plugin-first, with +the batteries left to the community rather than included.

+ +

Is dsh the same as deepseek-cli? No

+

Different layer, same API. dsh is the agent harness: it +runs the loop, executes the tool calls, manages plugins and sessions, and +serves a UI. deepseek-cli is the API client: it sends one +request in any of DeepSeek's four wire +formats, prints the response and what it cost, and carries DeepSeek's +API documentation in the binary. This tool deliberately does not execute +tool calls and is not becoming a harness – that line is a +recorded decision, and it just +got easier to hold, because the official answer to “run an agent on +DeepSeek” now exists.

+

What it changes here: nothing in the tool. The pairing +writes itself: dsh runs the agent, and this CLI is what you reach for +underneath it – ds check when a key misbehaves, +ds tokens and the ledger to price +a workload, ds docs ask when you need the API's own text +rather than a model's memory of it.

+

2026-08-13 · V4-Pro in the field: what practitioners report

The launch table is DeepSeek's own. This is what people running deepseek-v4-pro-0813 in real harnesses said in the diff --git a/site/llms.txt b/site/llms.txt index d74b7e8..39748b0 100644 --- a/site/llms.txt +++ b/site/llms.txt @@ -25,7 +25,7 @@ response body unmodified. Exit codes: 0 ok, 1 error, 2 auth, 3 no balance, - [Formats](https://thevibeworks.github.io/deepseek-cli/formats/): DeepSeek's four wire formats compared: auth, thinking controls, tool support, Claude model remapping, and the token-accounting convention that differs between them - [Cost](https://thevibeworks.github.io/deepseek-cli/cost/): the rate card, what the context cache is worth, the thinking surcharge and how it varies by effort level, the local usage ledger, and the caveats on every figure - [Benchmarks](https://thevibeworks.github.io/deepseek-cli/bench/): how deepseek-v4-pro (GA 0813) and v4-flash score against Kimi K3, GLM-5.2, Claude Opus 4.8 and Fable 5 on the agent suites (DeepSeek's own launch chart, with caveats), what the GA checkpoint changed over the preview, and the DeepSeek kill line (斩杀线) economics idea with the price gap to GPT-5.6 -- [News](https://thevibeworks.github.io/deepseek-cli/news/): what is changing in the DeepSeek API: the price rise announced 2026-08-06 with no effective date yet, the 2x peak-hour pricing policy (also undated), V4-Flash's official release, and what each does to the cost of a call +- [News](https://thevibeworks.github.io/deepseek-cli/news/): what is changing around the DeepSeek API: DeepSeek shipping dsh (DeepSeek Harness, its official agent harness) and how it relates to this CLI, the price rise announced 2026-08-06 with no effective date yet, the 2x peak-hour pricing policy (also undated), V4-Flash's official release, and what each does to the cost of a call - [Agents](https://thevibeworks.github.io/deepseek-cli/agents/): the scripting contract: output streams, JSON response shapes per format, exit-code semantics, retry behaviour - [Playground](https://thevibeworks.github.io/deepseek-cli/playground/): the DeepSeek API in a browser with no API key: all four wire formats, streaming, and the equivalent deepseek command for every request @@ -39,6 +39,8 @@ response body unmodified. Exit codes: 0 ok, 1 error, 2 auth, 3 no balance, - Text only: image, document and search-result content blocks are rejected in every format - Tool calls are printed, never executed - A free tier exists: `deepseek free` enrols with a proof-of-work puzzle instead of a signup, then relays through a gateway run by the project. Flash only, 30 requests and 20K output tokens per UTC day, 4K output per call. A pro request is refused rather than downgraded. Prompts transit the gateway; token counts and cost are recorded, prompts and completions are not +- Not the same tool as dsh: dsh (DeepSeek Harness, github.com/deepseek-ai/deepseek-harness, npm @deepseek-ai/dsh) is DeepSeek's official open-source agent harness that runs agent loops and executes tools; deepseek-cli is an unofficial API client for one-shot requests, cost accounting and offline docs. Complementary, not competing: run agents with dsh, debug keys, wire formats, costs and docs with deepseek-cli +- Skills interop with dsh: dsh skills are Anthropic SKILL.md-compatible directory bundles read from ~/.agents/skills and /.agents/skills, so a skill written for Claude Code or for this CLI drops in front of dsh unchanged ## Source @@ -52,3 +54,4 @@ response body unmodified. Exit codes: 0 ok, 1 error, 2 auth, 3 no balance, - [DeepSeek API docs](https://api-docs.deepseek.com/): the upstream API this wraps - [Models & pricing](https://api-docs.deepseek.com/quick_start/pricing): the rate card encoded in the tool +- [DeepSeek Harness (dsh)](https://github.com/deepseek-ai/deepseek-harness): DeepSeek's official agent harness, a different tool for a different layer diff --git a/site/news/index.html b/site/news/index.html index 64f0ca7..29f9e57 100644 --- a/site/news/index.html +++ b/site/news/index.html @@ -3,25 +3,25 @@ -DeepSeek API news: V4-Pro GA, the announced price rise, releases - - +DeepSeek API news: dsh ships, V4-Pro GA, the announced price rise + + - - + + - - + + @@ -30,7 +30,7 @@