dsh-progress-updates
English | Русский
A plugin for DeepSeek Harness (DSH) that makes the agent work like a person, not a black box. Instead of going silent for an hour and dumping the result at the end, the model:
- writes a short plan with
todo_writebefore multi-step tasks (DSH shows it as the Todos bar above the composer); - marks steps as done while it works;
- posts a 1–2 sentence update after each meaningful step: what it did and what comes next.
If the model still goes quiet for several tool calls in a row, the plugin gives it a gentle reminder.
Cloned the repository. Now reading the docs and entry points to understand the architecture.
> Reading files
Structure is clear: 13 Python packages plus resource folders. Updating the plan…
> Updated plan, ran commands
[ Todos 3 completed · 1 in progress · 2 pending ]
How it works
- System prompt section. Asks the model to plan tasks of 3+ steps with
todo_write, to keep the current itemin_progress, and to write short updates. Single-step questions get no plan and no updates. - Silence counter. Counts tool calls made without any visible text to the user. After
silentToolCallssilent calls it appends a reminder to the context (sourceprogress-updates), then repeats it everyrepeatEverycalls. Without a plan, the reminder asks for one; with a plan, it asks to update it. - Reset. The counter resets when the model writes visible text, calls
todo_write, or the user sends a message. - Subagents are ignored. Only the agent you talk to is tracked.
The plugin never blocks or rewrites tool calls. It only adds context, following the pattern of DSH's built-in dsh-repeat-tool-reminder.
Install
Requires DSH 0.2.x (tested on 0.2.2-rc.1) and pnpm (npm install -g pnpm).
Web / other profiles
dsh plugin --profile web add github:Biomistik-Official/dsh-progress-updates
Restart DSH.
DSH Desktop
The desktop profile is managed by the app, and dsh plugin refuses it, so install by hand:
Close DeepSeek Harness.
Open
~/.dsh/profiles/desktop/package.json(on Windows:C:\Users\<you>\.dsh\profiles\desktop\package.json) and make a backup copy.Add the dependency and the bundle:
{ "dsh": { "profile": { "bundles": [ // ...existing bundles... "dsh-progress-updates" ] } }, "dependencies": { // ...existing dependencies... "dsh-progress-updates": "github:Biomistik-Official/dsh-progress-updates" } }Run
pnpm installin~/.dsh/profiles/desktop.Start DeepSeek Harness again.
From a local clone (for development)
git clone https://github.com/Biomistik-Official/dsh-progress-updates.git
Use "link:/absolute/path/to/dsh-progress-updates" instead of the github: spec above. Changes then apply after a DSH restart.
Check that it works
Give the agent a multi-step task, for example "Study this repository and list its packages with their purpose." You should see the Todos bar and short updates between tool calls. A simple question like "what is 2+2" should come back without a plan.
Configuration
All fields are optional. Put them in your profile's cordis.patch.yml:
- id: progress-updates
name: dsh-progress-updates
config:
silentToolCalls: 4
repeatEvery: 4
exclude: [read_file]
| Field | Default | Meaning |
|---|---|---|
silentToolCalls |
6 |
Silent tool calls allowed before the first reminder (integer ≥ 1) |
repeatEvery |
6 |
Further silent calls between repeated reminders (integer ≥ 1) |
exclude |
[] |
Tool names that are not counted (exact names, no wildcards) |
promptSection |
true |
Whether to add the progress-updates section to the system prompt |
todoTool |
todo_write |
Name of the plan tool, used in the prompt and the reminders |
Invalid values or unknown keys fail at load with a progress-updates: … error. Either omit config: or make it an object.
Limitations
- The state lives in memory only. After a DSH restart, tracking resumes with your next message.
- If another prompt plugin in your profile tells the model to be extremely terse, updates may get rarer. Lower
silentToolCallsso reminders kick in sooner. - DSH is a developer preview, so its plugin APIs may change between versions.
Development
npm test
The pure logic in src/ has no DSH imports and is tested with node:test (Node 22+). index.js injects createUserMessage and chunkHasVisibleText from @deepseek-ai/dsh-llm, which DSH provides at runtime.
License
MIT
Русский
Плагин для DeepSeek Harness (DSH). С ним агент работает как человек, а не как чёрный ящик: раньше было «дал задачу и час ждёшь результат», теперь модель:
- перед многошаговой задачей составляет короткий план через
todo_write(DSH показывает его панелью «Дела» над полем ввода); - отмечает выполненные шаги по ходу работы;
- после каждого значимого шага пишет 1–2 предложения: что сделано и что дальше.
Если модель всё же молчит несколько вызовов инструментов подряд, плагин мягко ей об этом напоминает.
Как работает
- Раздел в системном промпте. Просит модель составлять план
todo_writeдля задач из 3 шагов и больше, держать текущий шаг вin_progressи писать короткие апдейты. Простые вопросы обходятся без плана. - Счётчик молчания. Плагин считает вызовы инструментов без видимого текста для вас. После
silentToolCallsтаких вызовов он добавляет модели напоминание: «составь план», если плана ещё нет, или «обнови план и напиши апдейт», если план уже есть. Дальше напоминание повторяется каждыеrepeatEveryвызовов. - Сброс. Счётчик обнуляется, когда модель пишет текст, вызывает
todo_writeили вы отправляете сообщение. - Сабагенты не отслеживаются. Плагин следит только за агентом, с которым вы общаетесь.
Плагин ничего не блокирует и не переписывает, он только добавляет контекст.
Установка
Нужны DSH 0.2.x (проверено на 0.2.2-rc.1) и pnpm (npm install -g pnpm).
Веб-профиль и другие профили:
dsh plugin --profile web add github:Biomistik-Official/dsh-progress-updates
После этого перезапустите DSH.
DSH Desktop. Профилем desktop управляет само приложение, команда dsh plugin его не принимает, поэтому установка ручная:
- Закройте DeepSeek Harness.
- Откройте
C:\Users\<вы>\.dsh\profiles\desktop\package.jsonи сделайте резервную копию. - Добавьте
"dsh-progress-updates"в конец спискаdsh.profile.bundles, а вdependencies— строку"dsh-progress-updates": "github:Biomistik-Official/dsh-progress-updates"(пример выше, в английской части). - Выполните
pnpm installв папке~/.dsh/profiles/desktop. - Запустите DeepSeek Harness.
Проверка. Дайте агенту многошаговую задачу, например «изучи этот репозиторий и составь список его пакетов с назначением». Должны появиться панель «Дела» и короткие апдейты между шагами. На простой вопрос («сколько будет 2+2») модель должна ответить без плана.
Настройки
Все поля необязательны и задаются в cordis.patch.yml профиля (пример выше):
| Поле | По умолчанию | Что значит |
|---|---|---|
silentToolCalls |
6 |
Сколько вызовов подряд без текста допускается до первого напоминания |
repeatEvery |
6 |
Через сколько ещё таких вызовов повторять напоминание |
exclude |
[] |
Какие инструменты не считать (точные имена, без масок) |
promptSection |
true |
Добавлять ли раздел про апдейты в системный промпт |
todoTool |
todo_write |
Имя инструмента плана |
Если значение неверное или ключ неизвестен, DSH при загрузке выдаст ошибку progress-updates: ….
Ограничения
- Состояние хранится только в памяти. После перезапуска DSH отслеживание начинается с вашего следующего сообщения.
- Если у вас стоит промпт-плагин, который требует от модели предельной краткости, апдейтов может стать меньше. Тогда уменьшите
silentToolCalls. - DSH пока в developer preview, API плагинов может меняться между версиями.
Лицензия
MIT
No comments yet. Be the first to write one.