Package Exports
- @serjm/deepseek-code
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@serjm/deepseek-code) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
DeepSeek Code
AI coding agent в терминале для реальной работы с проектами, на базе DeepSeek API.
English · Русский
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