dsh-context README

The project's README from github.com/bowenliang123/dsh-context. As one markdown file: README.md.

Social preview

dsh-context

npm version GitHub stars dshfind

The best DeepSeek Harness plugin for Agent's context insights and management.

dsh-context provides full context lifecycle management features.

Install / Update

Install dsh-context plugin from DeepSeek Harness:

dsh plugin --profile web add dsh-context

Or update the dsh-context plugin:

dsh plugin --profile web update dsh-context@latest

Then start the web UI with dsh web. No build step, no restart.

Use it

Three surfaces, one story — what your agent is carrying, how it got there, and what it did with it:

Where What you get
Context tab The full dashboard: stats, composition, per-request trend, events, file activity, and the agent network — in every session.
/context command A centered modal with the same composition and context browser, without leaving the chat.
Settings → Plugin configuration Per-user defaults: trend granularity & mode, File Activity sort.

📊 The Context tab

Open any session and click the Context / 上下文 tab:

Context panel overview

Card The question it answers
Context Stats Turns, steps, live tool calls & images, context-event tallies — plus a list-price cost estimate (hover the ? for per-1M rates).
Token Stats Where the billed tokens went: cache read/write, uncached input, output — around the cache-hit ring.
Timing Stats How active time split across model calls, tool runs, and overhead.
Current Context What's in the window right now.
Context Trend Every request's size — and its story.
Context Browser What any request was actually assembled from.
Context Events When and why the window changed.
File Activity What the agent did to your files.
Agent Network The whole agent family, live.

The headline occupancy and composition read the same official token-meter projections as the chat composer's context ring (contextPressure / contextBreakdown), so the figures always match what the ring tells you.

🧱 Current Context — who ate the budget

Current Context card

A six-color stacked bar against the model's full window (hatching = free headroom): system prompt, tool schemas, user messages, injected context, assistant replies, tool results — each with its ≈token figure and share. When a conversation starts degrading, this is where you see which part is responsible.

📈 Context Trend — every request, sized and explained

Context Trend with the step brief

One stacked bar per model request — finer than per-message — so you watch the window grow turn by turn:

Context Trend in Delta mode

🧭 Context Browser — open the box of any request

Pick Live (next request) or any retained step, and browse what that request was assembled from: six collapsible categories expand into one row per element with its token price, and every element expands again into its actual content — the system prompt, each tool's JSON schema, message text, reasoning, tool arguments, and tool outputs.

Tool schemas with source chips, filter, and sort

A tool result expanded with Raw/Markdown toggle

An image payload rendered as a thumbnail card

⚡ Context Events — when and why the window changed

Context Events with a compaction

Every injection, compaction, prune, model switch, and plan-mode toggle — labeled with its producer (instruction file, plugin id, skill name), its net token delta (compactions show what they reclaimed), turn/step, and time. The Inject / Compact / Prune / Switch / Mode chips filter the log by kind.

📁 File Activity — what the agent did to your files

File Activity

One row per touched file — read, written, or searched — aggregated up to whichever step you pick on the trend chart:

🕸 Agent Network — the family portrait

Agent Network with two subagents

The current agent, its parents, and every subagent — one node per agent, colored edges for the lineage, multi-level delegation on one map. Each ring is that session's composition scaled to its window occupancy; hover for tokens, requests, billing, and active time; click to jump into that session's own Context tab. Running agents breathe with a green pulse.

⌨️ /context command

Type /context (or pick it from the / menu) and press Enter:

Slash menu with the context command

A centered dialog opens with the Current Composition card and the Context browser — the same composition bar, per-step picker, and vs previous turn diff badges as the tab:

The /context modal

⚙️ Settings

In Settings → Plugins → Plugin configuration, the Context card holds this plugin's per-user preferences — default trend granularity (Step/Turn), default trend mode (Total/Delta), and the File Activity default sort. In-chart and in-card toggles stay per-view and never overwrite the stored preference.

The Context settings card

Good to know

Like it?

If dsh-context helped you understand what your agent is carrying around, a ⭐ on GitHub is much appreciated — and issues/PRs are welcome!

License

Apache-2.0

dsh-context (bowenliang123/dsh-context)

Searching Database…

2.3K ·GitHub
Dsh-context
Что это?dsh-context — плагин для DeepSeek Harness (dsh), дающий полную видимость контекстного окна AI-агента: вкладку на дашборде, боковую панель и слэш-команду /context, показывающие статистику токенов, состав контекста, тренды, события compaction/prune, активность по файлам и генеалогическое дерево агентов.
Это отдельное приложение или плагин к чему-то?Это плагин, расширяющий собственный веб-интерфейс DeepSeek Harness — добавляющий вкладку Context, панель в правой боковой колонке и слэш-команду /context, — а не отдельное приложение.
Нужно, чтобы DeepSeek Harness уже был настроен?Да — это чисто плагин для DeepSeek Harness, и ему требуется @deepseek-ai/dsh версии 0.1.2-rc1 или новее.
Показанные цифры токенов точны?Большинство разбивок по категориям использует собственную эвристику оценки токенов фиксированной плотности из dsh (ту же, что у встроенного счётчика токенов), тогда как фактические значения prompt/output/cache, сообщаемые провайдером, показываются рядом с закреплёнными деталями трендов для сравнения.
Что показывает график Context Trend?По одному накопительному столбцу на каждый запрос к модели, показывающему, как контекстное окно росло или сжималось ход за ходом, с событиями compaction и prune, закреплёнными ровно там, где они произошли, плюс простое пошаговое пояснение, что входило и выходило.
Для чего нужен вид Agent Network?Он отображает текущего агента вместе с его родителями и всеми сабагентами в виде генеалогического дерева, где живые кольца показывают для каждой сессии расход токенов, запросы, биллинг и активное время — так делегирование между агентами видно с первого взгляда.
Можно ли пользоваться интерфейсом на китайском?Да, dsh-context поставляется с переводами на английский и упрощённый китайский (简体中文).
Зачем это нужно вместо встроенного контекстного кольца?Встроенное кольцо композера показывает лишь общую заполненность, а dsh-context раскладывает те же данные по запросам, вызовам инструментов и файлам и добавляет историю (тренды, события, диффы), чтобы было видно, что именно вызвало изменение контекста.
What are similar projects?dsh-cost-meter, dsh-usage-stats, dsh-agent-team-gui, dsh-gitbash-preset, clearai-dsh, dsh-plugin-agent-workflow, dsh-univer-office, deepseek-harness-for-vscode
Which topics is it in?context-window, deepseek-harness-plugin, dsh-plugins, token-usage, context-engineering, visualization, dsh-plugin, deepseek-harness, i18n, monitoring, dashboard, plugin
Creator
bowenliang123
Size
15.1 MB
Stars
2.3K
Updated
CommitOct 19Releasev0.73.3Oct 19
Age
2mo
Commits · 90 Days