@serjm/deepseek-code
v0.5.0
Published
Terminal AI coding agent for real repository work, powered by the DeepSeek API
Maintainers
Readme
DeepSeek Code (dsc) — это open-source CLI/TUI агент для разработки. Он запускается прямо в вашем репозитории, читает код, планирует изменения, правит файлы, запускает проверки, умеет работать с Chrome для web-проектов и честно показывает итог выполнения.
Проект активно развивается в сторону стабильного coding agent для больших кодовых баз: прозрачный live status, надежный ввод, понятные отчеты, Windows-first ergonomics и безопасная подготовка релизов.
Зачем он нужен
| Задача | Что дает DeepSeek Code | |---|---| | Работать из терминала | TUI со streaming output, tool activity, статусом, токенами/стоимостью и навигацией | | Не отдавать все на автопилот | Режимы Plan, Default, Auto-Edit и Turbo | | Разбираться в реальном проекте | Поиск по репозиторию, чтение файлов, точечные правки, запуск build/test | | Проверять web-флоу | Chrome automation: страницы, формы, console, network, screenshots | | Видеть правду в отчете | Execution Summary показывает tool calls, измененные файлы, failed commands и gaps | | Контролировать стоимость | Используется ваш DeepSeek API key, без фиксированной подписки на coding IDE |
Установка
npm install -g @serjm/deepseek-codeЗапуск в проекте:
dscРазовые и headless-запуски:
dsc -p "Найди, почему падают тесты, и предложи фикс"
dsc --headless --json -p "Проведи ревью этого репозитория"
npx @serjm/deepseek-codeТребуется Node.js 20+ и DeepSeek API key.
Что нового в 0.5.0
- Настоящие сабагенты (
run_agent). Агент делегирует самостоятельные подзадачи вложенным агентам со своим чистым контекстом, ограниченными инструментами и бюджетом — большие исследования не забивают основной контекст, а проверки независимы. Именованные агенты — в.deepseek-code/agents/*.md(/agents). - Хуки, которые реально работают.
PreToolUse/PostToolUseсрабатывают вокруг каждого вызова инструмента, асинхронный запуск, глобальный + проектныйhooks.json.blocking-хук может заблокировать вызов инструмента;addOutput-хук возвращает свой stdout модели — например, авто-линт после каждой правки (/hooks). @-упоминания файлов. Наберите@— живой выбор файла с учётом.gitignore; Tab/Enter вставляет путь.- Автоматизация десктопа Windows (
windows_ui). Любое доступное десктоп-приложение (Explorer, Photoshop, ...) превращается в текстовое дерево именованных элементов через UI Automation — агент осматривает окна, кликает кнопки и меню по имени, заполняет поля, шлёт клавиши. Без vision и без зависимостей. - Рой сабагентов: несколько вызовов
run_agentв одном сообщении выполняются параллельно — широкое исследование кодовой базы за время самой медленной ветки. - Скиллы, которые запускаются. Процедуры из SKILL.md попадают в системный промпт, а
/skills <name>исполняет их как задачу (раньше они парсились и игнорировались). /doctor— диагностика окружения (Node, shell, git, API-ключ, Chrome, UIA) с вердиктом; звуковой сигнал после задач дольше 20 секунд.- Контроль фоновых процессов:
read_pid/list_processesуrun_shell_command+/ps— читать логи dev-сервера, не убивая его.
Ранее (0.4.5–0.4.8): восприятие браузера без vision (observe/dom, клик по видимому тексту), inline-диффы, Matrix-интро, память проекта и глобальная (DEEPSEEK.md, /init), ручное сжатие, --continue восстанавливает транскрипт.
Полная история изменений: CHANGELOG.md.
Как выглядит рабочий сценарий
Вы: "Найди, почему checkout падает после логина, и исправь"
DeepSeek Code:
1. Находит релевантные файлы
2. Читает auth и checkout код
3. Вносит точечный патч
4. Запускает подтвержденные проверки
5. Честно пишет, что изменено, что прошло, что упало и что не проверялосьВозможности
- Agent loop: планирование, чтение, правки, проверки и продолжение диалога.
- Сабагенты: делегирование самостоятельных подзадач вложенным агентам с чистым контекстом и ограниченными инструментами (
run_agent); несколько сабагентов в одном сообщении работают параллельно. Именованные агенты:.deepseek-code/agents/*.md(/agents new <имя>). - TUI: live status, streaming, tool activity с inline-диффами,
@-упоминания файлов с автодополнением. - Режимы контроля: read-only plan, ручные подтверждения, auto-edit или turbo для доверенной локальной работы.
- Browser tools: Chrome-проверки UI, console errors, forms и network behavior — с текстовым «восприятием» (
observe/dom), без vision. В headed-режиме визуальный слой (неоновая рамка, светящийся курсор, рябь клика, HUD действия) показывает, что делает агент. - Автоматизация десктопа (Windows):
windows_uiоткрывает любое доступное десктоп-приложение как текстовое дерево через UI Automation — осмотр окон, клики по кнопкам и меню по имени, заполнение полей, клавиши. - Хуки: ваши shell-команды на события агента (
.deepseek-code/hooks.json) — блокировка вызовов, авто-линт после правок с выводом обратно модели. - Скиллы: переиспользуемые процедуры в
.deepseek-code/skills/<name>/SKILL.md, агент применяет их сам, либо/skills <name>. - Память: проектная + глобальная
DEEPSEEK.mdв контексте; быстрые заметки#/##;/init. - Сессии:
--continueвосстанавливает транскрипт; фоновые dev-серверы живут между проверками (/ps). - Code review:
/reviewдля поиска багов, регрессий, рисков и security-проблем. - Headless mode: JSON-вывод для скриптов и CI через
--headless --json(хуки и скиллы работают и там). - Budget modes:
/budget audit,/budget normal,/budget large,/budget off.
Основные команды
| Команда | Описание |
|---|---|
| /help | Показать команды и горячие клавиши |
| /setup | Настроить API key, язык, модель и режим подтверждений |
| /doctor | Диагностика окружения: Node, shell, git, API-ключ, Chrome, UIA |
| /model | Сменить модель или открыть выбор модели |
| /lang | Сменить язык ответов |
| /agents | Именованные сабагенты; /agents new <имя> создаёт заготовку |
| /skills | Список/запуск скиллов; /skills <name> [ввод] исполняет |
| /hooks | Показать загруженные хуки |
| /remember <text> | Сохранить факт о проекте |
| /memory | Показать сохраненную память |
| /review | Запустить AI code review |
| /checkpoint / /restore | Сохранить или восстановить git checkpoint |
| /budget status\|off\|audit\|normal\|large | Явно управлять лимитами agent loop |
| /chrome | Управление Chrome mode |
| /browser-test | Запустить browser checks |
| /ps | Список/остановка фоновых процессов (dev-серверы) |
| /stats | Показать токены, стоимость и статистику сессии |
| /changelog | Читать release notes внутри CLI |
Горячие клавиши:
PageUp/PageDown: читать историю.End: вернуться к последнему сообщению.Shift+Enter/Alt+Enter: новая строка во вводе.- Mouse wheel пока не захватывается в TUI намеренно: поддержка мыши будет включаться только после отдельного безопасного исследования.
Конфигурация
Через переменные окружения:
export DEEPSEEK_API_KEY="sk-..."
export DEEPSEEK_MODEL="deepseek-chat"Или через .deepseek-code/settings.json в корне проекта:
{
"apiKey": "sk-...",
"model": "deepseek-chat",
"approvalMode": "default",
"temperature": 0.7
}Контроль и безопасность
DeepSeek Code построен вокруг явного контроля:
- Plan: только read-only анализ.
- Default: спрашивает перед правками и shell-командами.
- Auto-Edit: правки файлов автоматические, shell-команды требуют подтверждения.
- Turbo: полная автоматизация для доверенной локальной работы.
Дополнительно есть path checks, блокировка опасных команд, лимиты размера файлов, .deepseekignore, checkpoints, опциональный sandbox, Windows shell guidance и честный финальный отчет.
Статус проекта
Проект находится в активной разработке. Основной фокус сейчас — довести CLI до состояния, где им реально удобно работать над большими проектами: прозрачный activity/status, стабильный TUI, надежный ввод, честные отчеты, отсутствие мусорных файлов и предсказуемый release workflow.
В планах: дальнейшая стабилизация TUI, безопасное исследование mouse wheel, large-project exams и более строгие acceptance-проверки для web-проектов.
Разработка
git clone https://github.com/SerjMihashin/deepseek-code.git
cd deepseek-code
npm install
npm run lint
npm run typecheck
npm run build
npm test
npm pack --dry-runЛицензия
Apache-2.0 © 2026 Serj Mikhashin
