@serjm/deepseek-code 0.4.3 → 0.4.6

package/CHANGELOG.md

@@ -1,5 +1,90 @@
 # Changelog
 
+## 0.4.6 — Real-Project Agent Hardening
+
+Stabilization driven by running the agent on real, large Windows projects.
+
+### Fixed
+- **Windows shell is now consistent.** All commands run through one resolved shell — Windows PowerShell by default, with a cmd.exe fallback when PowerShell is unavailable (`DEEPSEEK_CODE_SHELL` overrides). This ends the "wrote PowerShell, ran under cmd.exe" failures that produced junk like a literal `$null` file, and the system prompt now states the exact active dialect so the agent stops brute-forcing command variants.
+- **Image content no longer bricks the session.** The DeepSeek API accepts only text; a single `image_url` block in history made every later request fail with `400 unknown variant image_url`. All message content is now flattened to text before sending; image paste is a no-op with a notice; `read_file` returns metadata for binary images (and SVG source / extracted PDF text) instead of inlining base64.
+- **Correct context window and pricing.** The context window is the real **1M tokens** for V4 models (was hardcoded 128k), so auto-compaction no longer fires ~8× too early; cost/token accounting verified against the official pricing page.
+- **Auto-compaction keeps the original task and recent messages** instead of collapsing history to a lone summary (a driver of the agent "remembering" planned work as done).
+- **Browser reuses a single tab** by default instead of opening a new tab per navigation; screenshots are saved for the user and clearly flagged as non-viewable by the model (verify via DOM/`eval`/console).
+
+### Added
+- **Background processes** for `run_shell_command` (`background`, `wait_for_port`, `stop_pid`): start a dev/preview server without hanging, wait for its port, then stop it (whole process tree). Orphans are killed on exit.
+- **Verified-state ledger**: a tool-derived summary of what was actually done (files changed, ok/failed counts) is injected at follow-ups and after compaction, plus a rule that an iteration counts as done only if this run contains its tool calls — guarding against narrating un-done work.
+- Honest-reporting rules: separate the final check result from earlier failed attempts; "could not run X" is reported as Not checked, not as a project defect.
+- MCP: connected MCP tools are callable by the agent; shared-hub project_id auto-derived from cwd; dsc identity stamped on hub writes.
+
+### Changed
+- **Ctrl+C** now exits only on a double press (with a hint on the first) and never aborts the running agent — aborting was what dropped the process to the shell on Windows. To steer the agent mid-run, type a follow-up (it is queued into the active run).
+
+### Known Issues
+- The agent does not always reach for `background:true` on the first try for a dev server (it may run it blocking once and hit a timeout before recovering).
+- This model has no vision: screenshots are saved for the user but verified by the agent via DOM/console, not visually.
+
+## 0.4.5 — TUI Stabilization, Multimodal & Pipeline
+
+### Added
+- **Tool-call activity in history** — finished tool batches are committed to the scrollback as a readable per-call list (`✓`/`✗` + tool + file/command + duration), so you can see exactly what the agent did.
+- **Crash guard** — stray runtime errors are recorded to `~/.deepseek-code/crash.log` instead of dropping you back to the shell mid-session.
+- `read_file` now supports images (PNG, JPG, GIF, WEBP, SVG, BMP) — reads as binary, encodes to base64 data URL.
+- `read_file` now supports Jupyter notebooks (`.ipynb`) — parses JSON, extracts code and markdown cells.
+- `read_file` now supports PDF files — naive text extraction + base64 data URL as fallback.
+- `dataUrlsToContentBlocks()` utility in API layer converts data: URLs to `ContentBlock[]` for multimodal messages.
+- `npm run check` pipeline: lint → typecheck → build → test in one command.
+- **Big Paste Preview** — dialog shown when pasting >500 chars, displaying char/line count with Enter to confirm or Esc to cancel.
+- **Follow-up Queue Indicator** — StatusBar shows `[F:1]` badge when follow-up messages are queued during agent run, cleared on new message send.
+
+### Changed
+- **Chat history now renders through Ink `<Static>`** — finalized messages are printed once to the terminal scrollback. This eliminates the full-screen redraw flicker and enables native mouse-wheel scrolling. The in-app PageUp/PageDown windowing was removed in favor of the terminal's own scrollback.
+- **Shell commands run asynchronously** — `run_shell_command` now uses `spawn` instead of blocking `execSync`, so long commands (installs, builds, tests) no longer freeze the UI and can be cancelled. Cancellation/timeout kills the whole process tree (`taskkill /t` on Windows, process-group on POSIX).
+- Cancellation signal is now plumbed to every tool.
+- `buildMessages()` in API layer now properly passes `ContentBlock[]` for multimodal messages (no longer casts to string).
+- **Removed `deepseek-vl2`** — only `deepseek-v4-pro` and `deepseek-v4-flash` remain; images pass as base64 data URLs in text.
+
+### Fixed
+- **Screen flicker on long output is gone** — the live region is now height-bounded (wrap-aware) so Ink never falls back to clearing the whole terminal each frame, which was the cause of both the shaking and the broken scrollback.
+- Default model set to `deepseek-v4-pro`; `DEEPSEEK_MODELS` updated to V4-Flash / V4-Pro.
+- Removed false vision-model warning on image paste — DeepSeek V4 models receive images as text-embedded data URLs.
+
+### Known Issues
+- **Ctrl+C on Windows may still drop to the shell** instead of pausing the agent. Cancellation is now cooperative and the process no longer hard-crashes, but the clean pause-on-interrupt is still under investigation on Windows terminals.
+- The new `<Static>` rendering has been validated primarily on **Windows Terminal**; appearance may differ on cmd.exe, the VS Code terminal, macOS, or Linux.
+- Switching between `deepseek-v4-pro` and `deepseek-v4-flash` updates the configured model, but the practical difference in responses has not been independently verified.
+
+## 0.4.4 — TUI Stability & Release Candidate
+
+### Fixed
+- Execution Summary now includes details for failed tool calls: tool name, label, and error.
+- Increased Windows glob test timeout to reduce flaky failures on slower Windows runs.
+- Fixed CLI argument parsing so `--json` or `--headless` without a prompt no longer treats `node` and the script path as an agent prompt.
+- Added a Node fallback for `grep_search` when `rg` is not installed.
+- Stream timeouts now surface as explicit errors instead of being hidden as user cancellations.
+- Added Windows shell policy guidance and runtime rejection for common Unix-only inspection commands in Windows shells.
+- PowerShell cmdlets such as `Remove-Item`, `Get-Content`, and `Select-String` now execute through PowerShell on Windows instead of falling through to `cmd.exe`.
+- Commands that mix PowerShell cmdlets with `cmd`/Bash chaining operators such as `&&` are now rejected with a clear Windows shell policy error.
+- `mkdir -p` is now rejected on Windows to avoid creating a literal `-p` directory.
+- Default interactive agent iteration limit increased from 100 to 200, and max-iteration stops now still emit Execution Summary.
+- Added automatic context compaction between agent iterations when the last request approaches the context window limit, with compact progress shown in the TUI status bar.
+- Blocked broad process-kill commands such as `taskkill /F /IM node.exe` so the agent cannot terminate itself or unrelated Node-based sessions.
+- TUI status bar now shows `VIEW:FOLLOW` or `VIEW:PAUSED` with keyboard scroll hints.
+- `/help` now explicitly documents that mouse wheel input is not captured in the TUI.
+- Added explicit `/budget normal` and `/budget large` modes while keeping the interactive default budget off.
+- Stabilized streaming output by batching assistant chunks to reduce TUI rerenders.
+- Stabilized slash-command editing, including `/model`, Backspace/Delete, Esc, and Ctrl+U behavior.
+- Preserved live follow-up input while the agent is running, so user messages are queued into the active loop instead of being lost.
+
+### Changed
+- Added an interactive budget preset for future use, but it is not enabled by default.
+- Reverted the restrictive default interactive budget because it stopped real large-project work too early.
+
+### Known Issues
+- Mouse wheel support is not enabled in the production TUI.
+- History scrolling remains keyboard-first with PageUp, PageDown, and End.
+- Large project acceptance testing is still required before publication.
+
 ## 0.4.3 — Project Mode & Browser Control
 
 ### Improvements

package/README.md

@@ -1,15 +1,16 @@
 <div align="center">
   <br/>
   <h1>DeepSeek Code</h1>
-  <p><strong>Open-source AI coding agent for developers who want a fast terminal workflow without Copilot pricing.</strong></p>
+  <p><strong>A terminal AI coding agent for real repository work, powered by the DeepSeek API.</strong></p>
 
   <p>
     <a href="https://github.com/SerjMihashin/deepseek-code/blob/master/LICENSE">
       <img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="License"/>
     </a>
     <img src="https://img.shields.io/badge/TypeScript-5.7-blue" alt="TypeScript"/>
-    <img src="https://img.shields.io/badge/DeepSeek-API-orange" alt="DeepSeek"/>
-    <img src="https://img.shields.io/badge/status-alpha-yellow" alt="Status"/>
+    <img src="https://img.shields.io/badge/Node-%3E%3D20-green" alt="Node >= 20"/>
+    <img src="https://img.shields.io/badge/DeepSeek-API-orange" alt="DeepSeek API"/>
+    <img src="https://img.shields.io/badge/status-active_development-yellow" alt="Status"/>
   </p>
 
   <p>
@@ -18,36 +19,20 @@
   <br/>
 </div>
 
----
+DeepSeek Code (`dsc`) is an open-source CLI/TUI agent that helps you work inside an existing codebase: inspect files, plan changes, edit code, run checks, use Chrome for web flows, and produce an honest execution summary.
 
-## What's new in 0.4.x
+It is designed for developers who want an agent in the terminal, not a black-box cloud workspace. The project is actively evolving toward a stable, practical coding assistant for large repositories.
 
-- Better project-mode guardrails and visible browser-mode control.
-- Startup update notice and improved `/changelog` modes.
-- `/changelog` command to view release notes inside the CLI.
-- `/update-check` command to check the latest npm version.
-- Stability and honest reporting improvements.
-- `/budget` commands to limit runaway agent loops.
-- Git Files section in Execution Summary.
-- Interactive `/lang` picker and runtime response language.
-- InputBar Home/End and Alt+Enter newline fallback.
+## Why Developers Use It
 
-See [CHANGELOG.md](./CHANGELOG.md) for details.
-
----
-
-## The Short Version
-
-DeepSeek Code is a terminal-first AI coding agent. It reads your project, edits files, runs commands, reviews code, remembers context, and can automate Chrome when a task needs a browser.
-
-It is built for developers who want a practical local workflow:
-
-- **Lower cost**: use DeepSeek API directly instead of a fixed monthly coding subscription.
-- **Real project work**: inspect files, patch code, run tests, and continue from previous sessions.
-- **Terminal-native**: no IDE lock-in, no heavy desktop app, no cloud workspace requirement.
-- **User-controlled automation**: choose read-only planning, manual approvals, auto-edit, or full turbo mode.
-
----
+| Need | What DeepSeek Code provides |
+|---|---|
+| Work from the terminal | TUI with streaming output, tool activity, status, token/cost info, and keyboard navigation |
+| Keep control | Plan, Default, Auto-Edit, and Turbo approval modes |
+| Use real project context | Reads/searches repository files, edits focused ranges, runs build/test commands |
+| Debug web projects | Chrome automation for pages, forms, console, network state, and screenshots |
+| Avoid hidden failures | Execution Summary reports tool calls, changed files, failed commands, and verification gaps |
+| Keep costs flexible | Uses your own DeepSeek API key instead of a fixed coding subscription |
 
 ## Install
 
@@ -55,42 +40,36 @@ It is built for developers who want a practical local workflow:
 npm install -g @serjm/deepseek-code
 ```
 
-Run it:
+Run in a project:
 
 ```bash
-deepseek-code
+dsc
 ```
 
-Or run without installing:
+One-shot and headless runs:
 
 ```bash
+dsc -p "Find why tests are failing and propose a fix"
+dsc --headless --json -p "Review this repository for risky changes"
 npx @serjm/deepseek-code
 ```
 
-Short alias:
+Requires Node.js 20+ and a DeepSeek API key.
 
-```bash
-dsc
-dsc -p "Find the bug in auth.ts and patch it"
-dsc --headless --json -p "Review this repository"
-```
-
----
-
-## Why Use It
+## What Is New In 0.4.4
 
-| Need | DeepSeek Code |
-|---|---|
-| Fix code from the terminal | Reads files, proposes patches, and runs verification commands |
-| Keep costs predictable | Uses your DeepSeek API key directly |
-| Work inside existing repos | Runs where your code already lives |
-| Avoid blind automation | Approval modes keep edits and shell commands under your control |
-| Debug browser flows | Built-in Chrome automation for pages, forms, console, screenshots, and network state |
-| Keep context over time | Project memory and resumable sessions help with longer work |
+- More stable TUI streaming with batched output and live follow-up input.
+- Slash-command editing fixes for `/model`, Backspace/Delete, Esc, and Ctrl+U.
+- Clear `VIEW:FOLLOW` / `VIEW:PAUSED` status for reading long sessions.
+- Failed tool call details in Execution Summary.
+- Explicit stream timeout errors instead of silent aborts.
+- Windows-friendly `grep_search` fallback when `rg` is unavailable.
+- Windows shell policy and guardrails for Unix-only commands such as `head`.
+- Explicit `/budget normal` and `/budget large` modes; default interactive budget remains off.
 
----
+See [CHANGELOG.md](./CHANGELOG.md) for the full release history.
 
-## What It Can Do
+## Typical Workflow
 
 ```text
 You: "Find why checkout fails after login and fix it"
@@ -99,44 +78,45 @@ DeepSeek Code:
   1. Searches the relevant files
   2. Reads the auth and checkout code
   3. Applies a focused patch
-  4. Runs tests or the command you approve
-  5. Summarizes the change
+  4. Runs approved checks
+  5. Reports what changed, what passed, what failed, and what was not checked
 ```
 
-Core features:
-
-- **Autonomous coding agent**: plans, reads, edits, searches, and runs commands.
-- **Full terminal UI**: streaming output, tool activity, status, costs, and context usage.
-- **Approval modes**: Plan, Default, Auto-Edit, and Turbo.
-- **Browser automation**: open pages, click, fill forms, inspect console/network, take screenshots.
-- **MCP support**: connect external tool servers for custom workflows.
-- **Persistent memory**: save project facts with `/remember`.
-- **AI code review**: use `/review` to inspect bugs, risks, and security issues.
-- **Headless mode**: CI-friendly JSON output with `--headless --json`.
+## Core Features
 
----
+- **Agent loop**: plan, inspect, edit, verify, and continue.
+- **TUI**: live status, streaming response, tool activity, scroll/follow indicators, and keyboard controls.
+- **Approval modes**: read-only planning, manual confirmation, auto-edit, or trusted full automation.
+- **Browser tools**: Chrome-based checks for rendered UI, console errors, forms, screenshots, and network behavior.
+- **Session continuity**: continue previous work and save project facts with `/remember`.
+- **Review mode**: use `/review` for bug, regression, and security-oriented code review.
+- **Headless mode**: scriptable output via `--headless --json`.
+- **Budget modes**: `/budget audit`, `/budget normal`, `/budget large`, `/budget off`.
 
-## Commands
+## Useful Commands
 
 | Command | Description |
 |---|---|
-| `/help` | Show available commands |
-| `/setup` | Configure API key, language, and approval mode |
+| `/help` | Show commands and keyboard controls |
+| `/setup` | Configure API key, language, model, and approval mode |
+| `/model` | Switch model or open the model picker |
+| `/lang` | Switch response language |
 | `/remember <text>` | Save project context |
 | `/memory` | Show saved memories |
 | `/review` | Run AI code review |
-| `/checkpoint` | Save a git checkpoint |
-| `/restore` | Restore a checkpoint |
-| `/theme` | Switch terminal theme |
-| `/lang` | Switch language |
-| `/git <cmd>` | Run git operations |
-| `/loop <interval> <task>` | Schedule recurring work |
-| `/sandbox` | Run commands in Docker isolation |
-| `/mcp` | Manage MCP servers |
-| `/stats` | Show session statistics |
-| `/clear` | Clear chat |
-
----
+| `/checkpoint` / `/restore` | Save or restore git checkpoints |
+| `/budget status\|off\|audit\|normal\|large` | Control loop limits explicitly |
+| `/chrome` | Manage Chrome mode |
+| `/browser-test` | Run browser checks |
+| `/stats` | Show tokens, cost, and session statistics |
+| `/changelog` | Read release notes inside the CLI |
+
+Keyboard highlights:
+
+- `PageUp` / `PageDown`: read chat history.
+- `End`: jump back to the latest message.
+- `Shift+Enter` / `Alt+Enter`: insert a newline.
+- Mouse wheel is not captured in the TUI yet; this is intentional while terminal mouse support is being hardened.
 
 ## Configuration
 
@@ -158,20 +138,22 @@ Or create `.deepseek-code/settings.json` in your project:
 }
 ```
 
----
-
 ## Safety Model
 
-DeepSeek Code is designed around explicit control:
+DeepSeek Code is built around explicit control:
 
 - **Plan**: read-only analysis.
-- **Default**: asks before edits and commands.
-- **Auto-Edit**: file edits are automatic, shell commands still need approval.
+- **Default**: asks before edits and shell commands.
+- **Auto-Edit**: edits files automatically; shell commands still need confirmation.
 - **Turbo**: full automation for trusted local work.
 
-It also supports command sanitization, file size limits, `.deepseekignore`, checkpoints, and optional Docker sandboxing.
+The agent also uses path checks, dangerous command blocking, file size limits, `.deepseekignore`, checkpoints, optional sandboxing, Windows shell guidance, and honest final reporting.
+
+## Project Status
 
----
+DeepSeek Code is in active development. The current focus is stability for real development work: large repositories, transparent tool activity, reliable input, honest summaries, Windows-first ergonomics, and release-quality packaging.
+
+Planned work includes deeper TUI hardening, safer mouse-wheel research, larger project exams, and stronger acceptance workflows for browser-based projects.
 
 ## Development
 
@@ -179,32 +161,13 @@ It also supports command sanitization, file size limits, `.deepseekignore`, chec
 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
-```
-
-Package check:
-
-```bash
 npm pack --dry-run
-npm publish --dry-run --access public
-```
-
-Publish to npm:
-
-```bash
-npm login
-npm publish --access public
-```
-
-If npm asks for two-factor authentication:
-
-```bash
-npm publish --access public --otp=123456
 ```
 
----
-
 ## License
 
 Apache-2.0 © 2026 Serj Mikhashin

package/README.ru.md

@@ -1,15 +1,16 @@
 <div align="center">
   <br/>
   <h1>DeepSeek Code</h1>
-  <p><strong>Open-source AI-агент для разработки в терминале: дешевле подписок, ближе к вашему коду, без привязки к IDE.</strong></p>
+  <p><strong>AI coding agent в терминале для реальной работы с проектами, на базе DeepSeek API.</strong></p>
 
   <p>
     <a href="https://github.com/SerjMihashin/deepseek-code/blob/master/LICENSE">
       <img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="License"/>
     </a>
     <img src="https://img.shields.io/badge/TypeScript-5.7-blue" alt="TypeScript"/>
-    <img src="https://img.shields.io/badge/DeepSeek-API-orange" alt="DeepSeek"/>
-    <img src="https://img.shields.io/badge/status-alpha-yellow" alt="Status"/>
+    <img src="https://img.shields.io/badge/Node-%3E%3D20-green" alt="Node >= 20"/>
+    <img src="https://img.shields.io/badge/DeepSeek-API-orange" alt="DeepSeek API"/>
+    <img src="https://img.shields.io/badge/status-active_development-yellow" alt="Status"/>
   </p>
 
   <p>
@@ -18,36 +19,20 @@
   <br/>
 </div>
 
----
+DeepSeek Code (`dsc`) — это open-source CLI/TUI агент для разработки. Он запускается прямо в вашем репозитории, читает код, планирует изменения, правит файлы, запускает проверки, умеет работать с Chrome для web-проектов и честно показывает итог выполнения.
 
-## Что нового в 0.4.x
+Проект активно развивается в сторону стабильного coding agent для больших кодовых баз: прозрачный live status, надежный ввод, понятные отчеты, Windows-first ergonomics и безопасная подготовка релизов.
 
-- Улучшенные правила project mode и наглядное управление режимом браузера.
-- Уведомление об обновлениях при запуске и улучшенные режимы `/changelog`.
-- `/changelog` показывает список изменений прямо в CLI.
-- `/update-check` проверяет последнюю версию в npm.
-- Улучшена стабильность и честность отчётов.
-- `/budget` команды ограничивают runaway tool/API calls.
-- Execution Summary показывает Files: changed/untracked/dirty before run.
-- `/lang` picker и ответы на выбранном языке.
-- InputBar: Home/End и Alt+Enter для новой строки.
-
-Подробнее в [CHANGELOG.md](./CHANGELOG.md).
-
----
-
-## Коротко
-
-DeepSeek Code — это AI-агент для разработки прямо в терминале. Он читает проект, редактирует файлы, запускает команды, делает code review, запоминает контекст и умеет управлять Chrome, когда задача выходит за пределы кода.
-
-Он подходит, если нужен практичный локальный workflow:
-
-- **Ниже стоимость**: используется ваш DeepSeek API key, без дорогой фиксированной подписки.
-- **Реальная работа с проектом**: поиск по коду, патчи, тесты, продолжение прошлых сессий.
-- **Терминальный подход**: без привязки к конкретной IDE и без отдельного облачного workspace.
-- **Контроль над автоматизацией**: режимы от read-only анализа до полного turbo.
+## Зачем он нужен
 
----
+| Задача | Что дает 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 |
 
 ## Установка
 
@@ -55,88 +40,84 @@ DeepSeek Code — это AI-агент для разработки прямо в
 npm install -g @serjm/deepseek-code
 ```
 
-Запуск:
+Запуск в проекте:
 
 ```bash
-deepseek-code
+dsc
 ```
 
-Запуск без установки:
+Разовые и headless-запуски:
 
 ```bash
+dsc -p "Найди, почему падают тесты, и предложи фикс"
+dsc --headless --json -p "Проведи ревью этого репозитория"
 npx @serjm/deepseek-code
 ```
 
-Короткий алиас:
+Требуется Node.js 20+ и DeepSeek API key.
 
-```bash
-dsc
-dsc -p "Найди баг в auth.ts и исправь"
-dsc --headless --json -p "Сделай review репозитория"
-```
+## Что нового в 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](./CHANGELOG.md).
 
-| Задача | Что делает DeepSeek Code |
-|---|---|
-| Исправить код из терминала | Читает файлы, предлагает патчи и запускает проверочные команды |
-| Держать расходы под контролем | Работает напрямую через ваш DeepSeek API key |
-| Работать в существующих репозиториях | Запускается там, где уже лежит код |
-| Не отдавать все на автопилот | Режимы подтверждений контролируют правки и shell-команды |
-| Отлаживать browser flow | Встроенный Chrome: страницы, формы, консоль, network, скриншоты |
-| Не терять контекст | Память проекта и продолжение сессий помогают на длинных задачах |
-
----
-
-## Что он умеет
+## Как выглядит рабочий сценарий
 
 ```text
 Вы: "Найди, почему checkout падает после логина, и исправь"
 
 DeepSeek Code:
-  1. Ищет релевантные файлы
+  1. Находит релевантные файлы
   2. Читает auth и checkout код
   3. Вносит точечный патч
-  4. Запускает тесты или команду после подтверждения
-  5. Кратко объясняет результат
+  4. Запускает подтвержденные проверки
+  5. Честно пишет, что изменено, что прошло, что упало и что не проверялось
 ```
 
-Основные возможности:
+## Возможности
 
-- **Автономный coding agent**: планирует, читает, редактирует, ищет и запускает команды.
-- **Полноценный terminal UI**: streaming output, цепочка инструментов, статус, стоимость и контекст.
-- **Режимы подтверждений**: Plan, Default, Auto-Edit и Turbo.
-- **Автоматизация браузера**: открыть страницу, кликнуть, заполнить форму, проверить console/network, сделать screenshot.
-- **MCP support**: подключение внешних tool-серверов для своих workflows.
-- **Постоянная память**: сохраняйте факты проекта через `/remember`.
-- **AI code review**: команда `/review` ищет баги, риски и проблемы безопасности.
-- **Headless mode**: JSON-вывод для CI и скриптов через `--headless --json`.
+- **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, язык и режим подтверждений |
-| `/remember <text>` | Сохранить контекст проекта |
+| `/help` | Показать команды и горячие клавиши |
+| `/setup` | Настроить API key, язык, модель и режим подтверждений |
+| `/model` | Сменить модель или открыть выбор модели |
+| `/lang` | Сменить язык ответов |
+| `/remember <text>` | Сохранить факт о проекте |
 | `/memory` | Показать сохраненную память |
 | `/review` | Запустить AI code review |
-| `/checkpoint` | Сохранить git checkpoint |
-| `/restore` | Восстановить checkpoint |
-| `/theme` | Сменить тему |
-| `/lang` | Сменить язык |
-| `/git <cmd>` | Git-операции |
-| `/loop <interval> <task>` | Запланировать повторяющуюся задачу |
-| `/sandbox` | Запуск через Docker isolation |
-| `/mcp` | Управление MCP-серверами |
-| `/stats` | Статистика сессии |
-| `/clear` | Очистить чат |
-
----
+| `/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 намеренно: поддержка мыши будет включаться только после отдельного безопасного исследования.
 
 ## Конфигурация
 
@@ -158,20 +139,22 @@ export DEEPSEEK_MODEL="deepseek-chat"
 }
 ```
 
----
-
 ## Контроль и безопасность
 
 DeepSeek Code построен вокруг явного контроля:
 
 - **Plan**: только read-only анализ.
-- **Default**: спрашивает перед правками и командами.
+- **Default**: спрашивает перед правками и shell-командами.
 - **Auto-Edit**: правки файлов автоматические, shell-команды требуют подтверждения.
 - **Turbo**: полная автоматизация для доверенной локальной работы.
 
-Также есть санитизация команд, лимиты размера файлов, `.deepseekignore`, checkpoints и опциональный Docker sandbox.
+Дополнительно есть path checks, блокировка опасных команд, лимиты размера файлов, `.deepseekignore`, checkpoints, опциональный sandbox, Windows shell guidance и честный финальный отчет.
+
+## Статус проекта
 
----
+Проект находится в активной разработке. Основной фокус сейчас — довести CLI до состояния, где им реально удобно работать над большими проектами: прозрачный activity/status, стабильный TUI, надежный ввод, честные отчеты, отсутствие мусорных файлов и предсказуемый release workflow.
+
+В планах: дальнейшая стабилизация TUI, безопасное исследование mouse wheel, large-project exams и более строгие acceptance-проверки для web-проектов.
 
 ## Разработка
 
@@ -179,32 +162,13 @@ DeepSeek Code построен вокруг явного контроля:
 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
-```
-
-Проверить пакет:
-
-```bash
 npm pack --dry-run
-npm publish --dry-run --access public
 ```
 
-Опубликовать в npm:
-
-```bash
-npm login
-npm publish --access public
-```
-
-Если npm просит двухфакторный код:
-
-```bash
-npm publish --access public --otp=123456
-```
-
----
-
 ## Лицензия
 
 Apache-2.0 © 2026 Serj Mikhashin