# 📦 @goodandready/dsh-goal

Движок автономного выполнения целей и многошагового трекинга задач для DeepSeek Harness

🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明

⭐ Если вам нравится этот плагин, поставьте ему звезду на GitHub — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.

🐛 Если вы нашли баг или хотите предложить новый функционал, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.

--- ## ⚡ Обзор и решаемая проблема Решение комплексных инженерных задач требует автономного многошагового выполнения: декомпозиции целей на майлстоуны, непрерывного выполнения итераций без ручного подталкивания пользователя и наглядного отслеживания прогресса. **`@goodandready/dsh-goal`** внедряет автономный режим достижения целей в DeepSeek Harness через команду `/goal`: * 💡 **Живая корректировка цели / Направление агента (*v0.2.0*)**: Возможность вносить точечные правки и уточнения в активную цель на лету без прерывания сессии. * 🔔 **Браузерные уведомления (*v0.2.0*)**: Нативные пуш-уведомления через HTML5 `Notification API` по завершении или сбое цели. * 📑 **10 инженерных пресетов (*v0.2.0*)**: Готовые кликабельные шаблоны задач (Fix Bug, Refactor YAGNI, Tests, Code Review, Security, Docs, Upgrade Deps, Cleanup, Performance) в окне запуска. * 🛡️ **Tool-Failure Breaker (*v0.2.0*)**: Настраиваемый порог ошибок инструментов (`consecutiveToolFailureLimit`, по умолчанию 3) для предотвращения бесконечных сбойных вызовов. * 📌 **Git Checkpoint (*v0.2.0*)**: Фиксация коммита старта (`git rev-parse --short HEAD`) и копирование команды `git diff` в 1 клик. * 🐙 **Экспорт отчета для GitHub / Gitea PR (*v0.2.0*)**: Генерация отчета со сворачиваемыми спойлерами `

` для PR и задач. * 🎯 **Плавающий баннер в шапке**: зафиксированный статус-бар над чатом с таймером выполнения (`• 2s`, `• 1m 45s`), заголовком цели и кнопками управления. * ⏸️ **Управление циклом (Play / Pause / Cancel)**: мгновенная приостановка автономного цикла агента или его возобновление в любой момент. * 📋 **Интерактивная панель майлстоунов**: модальное окно со списком подзадач, прогресс-баром и журналом выполнения. * 🤖 **Инструменты агента**: `goal_set_milestones`, `goal_update_progress` и `goal_finish` для самостоятельной работы ИИ. * 🔄 **Перехват и замещение инструментов ядра DSH (*Добавлено в v0.1.10*)**: Бесшовная совместимость для моделей, вызывающих стандартные инструменты DSH (`update_goal`, `get_goal`, `create_goal`). Перехватывает действия (`complete`, `pause`, `resume`, `edit`, `blocked`), устраняет падения ядра (`complete and blocked require a direct human turn`) и синхронизирует состояние напрямую с GoalEngine. * 🛡️ **Защитные лимиты**: настраиваемое ограничение `maxIterations` для предотвращения бесконечных циклов. * 🛡️ **Двухфазный режим «Plan Mode ⇄ Act Mode» (*#162*)**: Разделение жизненного цикла цели на фазу проектирования и планирования (только чтение и формирование этапов через `goal_milestones`, блокировка записи файлов и мутирующих команд) и фазу реализации (`Act Mode`), активируемую по кнопке «Утвердить план и запустить» (Approve & Execute). * 🛡️ **Автоматический приёмочный гейт этапа (Critic Verification) (*#163*)**: Опциональное поле `verificationCommand` на этапе (например, `npm test`, `pytest`). При попытке закрыть этап команда автоматически запускается в изолированном `safeCwd`. В случае сбоя (`exitCode != 0`) этап остаётся открытым, а диагностический вывод возвращается модели в качестве обратной связи. Git-снимки и синхронизация задач создаются только при коде возврата 0. --- ## 🏛️ Архитектура ```mermaid graph TD subgraph Input ["Взаимодействие"] Cmd["Слеш-команда: /goal <цель>"] API["REST API: POST /dsh-goal/action"] end subgraph GoalEngine ["Движок целей (lib/index.js)"] State["Менеджер состояний (IDLE, RUNNING, PAUSED, COMPLETED)"] Milestones["Трекер и декомпозиция майлстоунов"] Disk["Хранилище состояний (~/.dsh/goal-state.json)"] end subgraph AgentLoop ["Автономный цикл агента"] ToolSet["goal_set_milestones"] ToolProgress["goal_update_progress"] ToolFinish["goal_finish"] LimitGuard{"Ограничение maxIterations"} end subgraph UI ["Интерфейс DSH"] Banner["Баннер цели над чатом"] Timer["Таймер выполнения"] Drawer["Модальное окно задач"] Settings["Карточка настроек (Schemastery)"] end Cmd --> GoalEngine API --> GoalEngine GoalEngine --> State State --> Disk State --> Banner State --> Drawer GoalEngine --> AgentLoop AgentLoop --> LimitGuard ToolSet --> GoalEngine ToolProgress --> GoalEngine ToolFinish --> GoalEngine ``` --- ## 📦 Установка ```bash dsh plugin --profile web add @goodandready/dsh-goal ``` Перезапустите экземпляр DeepSeek Harness и обновите вкладку в браузере. --- ## 💬 Быстрый старт Запустите цель прямо в чате: ```text /goal Провести рефакторинг middleware авторизации и написать интеграционные тесты ``` Или через REST API: ```bash curl -X POST http://localhost:3080/dsh-goal/action \ -H "Content-Type: application/json" \ -d '{"action":"start","title":"Оптимизация SQL-запросов"}' ``` --- ## ⚙️ Таблица конфигурации (`settings.yaml`) ```yaml dsh-goal: maxIterations: 25 autoDrive: true enableSound: true ``` | Параметр | Тип | По умолчанию | Описание | |:---|:---|:---|:---| | `maxIterations` | `number` | `25` | Защитный лимит: максимум автономных итераций на цель | | `autoDrive` | `boolean` | `true` | Автоматически продолжать автономный цикл между тактами | | `enableSound` | `boolean` | `true` | Звуковое уведомление при успешном завершении цели | --- ## 🧪 Тестирование Запуск набора юнит-тестов: ```bash npm test ``` --- --- ## 📦 История версий (Release Notes) ### v0.2.6 - **Token Budget Guard**: Защитный потолок расхода токенов с предупреждением модели на 80% и мягкой паузой (`PAUSED_BUDGET_EXCEEDED`) с продлением +50k в 1 клик. - **Подзадачи и чек-листы (Sub-milestones)**: Интерактивные чекбоксы подзадач внутри каждого этапа (`checklist: [{ text, done }]`) с синхронизацией с моделью. - **Автоматические Git-чекпоинты**: Опциональное создание снимков репозитория при завершении этапа с откатом в 1 клик. - **Экспорт артефактов выполнения**: Сохранение полного отчёта в `.dsh/goals/-.md` (каталог `.dsh/` добавлен в `.gitignore`). - **Компактный режим панели (Compact Dock Mode)**: Сворачивание панели цели в аккуратную капсулу с запоминанием в `localStorage`. ### v0.2.3 - **Автообновление**: Встроен эндпоинт API автообновления в один клик по адресу `/api/dsh-goal/update` с fail-closed проверкой источника. - **Модульная архитектура**: Серверная половина плагина полностью декомпозирована на специализированные модули (<600 строк каждый): маршруты, инструменты, хранилище, отчёты и модуль обновления. - **Чистое разделение локализации**: Из `lib/*.js` удалены все зашитые русские строки и ветвления; ядро поддерживает только `en` и `zh`, а русская локализация поставляется плагином `@goodandready/dsh-russian-lang`. - **Надёжность**: Устранены все пустые блоки `catch`, добавлено контекстное логирование завершения целей и автоматическая очистка отключившихся SSE-клиентов. - **Дизайн-система**: Чужеродные CSS-классы и явные цвета RGBA заменены на стандартные токены дизайн-системы DSH (`--dsw-alias-*`). - **Защита карточки настроек**: Исправлена обработка снимка настроек при загрузке или отсутствии сервиса, исключающая ложный статус `ready`. ## 📄 Лицензия MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)