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.4.4

Более стабильный streaming в TUI: chunks батчатся, меньше лишних rerender.
Live follow-up: можно писать агенту во время выполнения задачи.
Исправлено редактирование slash-команд: /model, Backspace/Delete, Esc, Ctrl+U.
Явный статус чтения истории: VIEW:FOLLOW и VIEW:PAUSED.
Execution Summary показывает детали failed tool calls.
Stream timeout теперь виден как ошибка, а не выглядит как молчаливый обрыв.
grep_search работает на Windows даже без установленного rg.
Windows shell policy: меньше падений из-за head, sed, cat и Unix-only команд.
Добавлены /budget normal и /budget large; по умолчанию interactive budget остается выключенным.

Полная история изменений: CHANGELOG.md.

Как выглядит рабочий сценарий

Вы: "Найди, почему checkout падает после логина, и исправь"

DeepSeek Code:
  1. Находит релевантные файлы
  2. Читает auth и checkout код
  3. Вносит точечный патч
  4. Запускает подтвержденные проверки
  5. Честно пишет, что изменено, что прошло, что упало и что не проверялось

Возможности

Agent loop: планирование, чтение, правки, проверки и продолжение диалога.
TUI: live status, streaming, tool activity, scroll/follow indicators и keyboard controls.
Режимы контроля: read-only plan, ручные подтверждения, auto-edit или turbo для доверенной локальной работы.
Browser tools: Chrome-проверки для UI, console errors, forms, screenshots и network behavior.
Память и сессии: продолжение работы и сохранение фактов проекта через /remember.
Code review: /review для поиска багов, регрессий, рисков и security-проблем.
Headless mode: JSON-вывод для скриптов и CI через --headless --json.
Budget modes: /budget audit, /budget normal, /budget large, /budget off.

Основные команды

Команда	Описание
`/help`	Показать команды и горячие клавиши
`/setup`	Настроить API key, язык, модель и режим подтверждений
`/model`	Сменить модель или открыть выбор модели
`/lang`	Сменить язык ответов
`/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
`/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

@serjm/deepseek-code