alex/deepseek-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Самодостаточность: движок браузера переехал внутрь, DeepShim больше не нужен

Browse Source 
Раньше сервис был обёрткой: каждый запрос спавнил ollama_orchestro/ask.mjs
дочерним процессом, гонял вопрос и ответ через временные файлы и читал
чужой config.json ради профиля браузера. Работать это могло только рядом
с установленным DeepShim.

Теперь всё своё. browser.mjs — перенесённый из ask.mjs движок: CDP-сессия,
помощники страницы со всем, что удалось выяснить про разметку DeepSeek,
отправка с подтверждением, ожидание ответа по состоянию кнопки, работа
с чатами. Пульт, разбор патчей и git остались в DeepShim, сюда не поехали.

Побочно ушли дочерний процесс на каждый запрос и временные файлы: вопрос
и ответ теперь просто переменные. Файл на диске остался только для картинки —
<input type="file"> иначе не наполнить.

Свои настройки вместо чужих: browserExe, profileDir и cdpPort в config.json,
рядом config.local.json для путей конкретной машины (в репозиторий не идёт).
Свой chats.json, тоже не в репозитории: это рабочее состояние, оно
переписывается при каждой смене чата. Образец — chats.example.json.

Добавлен GET /api/probe: что видно во вкладке прямо сейчас.

ВАЖНО: профиль браузера должен быть отдельный. Перед каждым вопросом сайдбар
подчищается от всего, чего нет в своём chats.json, поэтому две программы
на одном профиле удаляют чаты друг друга. Проверено вживую, описано в README.

Проверки: node test.mjs; сквозной прогон с нуля — свой чат заведён сам,
ответ верный; пять правок в одном чате, на шестом запросе новый чат, старый
удалён, сайдбар не растёт.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Alex Cube
2026-08-26 13:09:41 +03:00
co-authored by Claude Opus 5
parent f5cf061fcc
commit 8c52cf101c
6 changed files with 1307 additions and 296 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+117 -164
View File
@@ -20,6 +20,9 @@
Платить не нужно — используется ваш обычный аккаунт DeepSeek. Взамен всё
медленно (секунды, а не миллисекунды) и работает только пока открыт браузер.
Программа самодостаточна: кроме Node и браузера ей ничего не требуется,
внешних пакетов нет.
---
## Оглавление
@@ -40,11 +43,10 @@
| Что | Зачем | Как проверить, что есть |
|---|---|---|
| **Windows** | скрипты запуска написаны под неё | — |
| **Windows** | скрипт запуска написан под неё | — |
| **Node.js 22 или новее** | на нём написана программа | `node --version` → должно быть `v22.…` и выше |
| **Браузер на движке Chromium** | Яндекс.Браузер, Chrome, Edge — любой | — |
| **Аккаунт DeepSeek** | бесплатный, регистрация на [chat.deepseek.com](https://chat.deepseek.com) | — |
| **Проект DeepShim** | в нём живёт код, который умеет управлять вкладкой | ставится на шаге 1 |
Node.js, если его нет, ставится с [nodejs.org](https://nodejs.org) — берите
версию LTS, кнопка слева. После установки **закройте и откройте заново**
@@ -54,40 +56,27 @@ Node.js, если его нет, ставится с [nodejs.org](https://nodejs
## Установка по шагам
Всего шагов семь. Делайте по порядку, каждый заканчивается проверкой —
Всего шагов пять. Делайте по порядку, каждый заканчивается проверкой —
не переходите к следующему, пока предыдущий не дал ожидаемого результата.
### Шаг 1. Скачать обе программы
Нужны две: эта и DeepShim, в котором лежит код управления браузером.
Положите их **рядом, в одну папку**:
```
C:\#Projects\
deepseek-api\ <- эта программа
ollama_orchestro\ <- DeepShim
```
### Шаг 1. Скачать
```cmd
cd C:\#Projects
git clone https://git.08h.ru/alex/deepseek-api.git
git clone https://git.08h.ru/alex/deepshim.git ollama_orchestro
```
Папка DeepShim должна называться именно `ollama_orchestro` — так она указана
в настройках по умолчанию. Хотите иначе — поправите путь на шаге 6.
Без git можно скачать ZIP с той же страницы и распаковать. Папка может лежать
где угодно.
Без git можно просто скачать ZIP с тех же страниц и распаковать.
> **Проверка:** в `C:\#Projects\deepseek-api\` лежит `server.mjs`,
> в `C:\#Projects\ollama_orchestro\` — `ask.mjs`.
> **Проверка:** в папке есть `server.mjs`, `browser.mjs` и `start.cmd`.
### Шаг 2. Завести отдельный профиль браузера
Браузером будет управлять программа, поэтому работать в нём вам не нужно —
и не стоит: он будет самопроизвольно открываться и переключать вкладки.
Заведите под него **отдельный профиль** — это просто пустая папка,
браузер сам её заполнит:
и не стоит: он будет сам открываться, переключать вкладки и удалять чаты.
Заведите под него **отдельный профиль** — это просто пустая папка, браузер
сам её заполнит:
```cmd
mkdir C:\Browsers\deepseek
@@ -95,20 +84,22 @@ mkdir C:\Browsers\deepseek
Имя любое, запомните путь — понадобится на следующем шаге.
### Шаг 3. Настроить DeepShim
> **Профиль должен быть свой.** Если в том же профиле работает другая
> программа, управляющая чатами DeepSeek (например,
> [DeepShim](https://git.08h.ru/alex/deepshim)), они начнут удалять чаты друг
> друга: каждая считает лишним всё, чего нет в её собственном списке.
В папке `ollama_orchestro` создайте файл `config.json`:
### Шаг 3. Указать путь к браузеру и профилю
Откройте `config.json` и поправьте два значения:
```json
{
"profileDir": "C:\\Browsers\\deepseek",
"browserExe": "C:\\Program Files\\Yandex\\YandexBrowser\\Application\\browser.exe",
"port": 9333
"profileDir": "C:\\Browsers\\deepseek"
}
```
Три значения:
- **`profileDir`** — папка из шага 2.
- **`browserExe`** — путь к браузеру. Типичные:
@@ -118,82 +109,20 @@ mkdir C:\Browsers\deepseek
| Google Chrome | `C:\Program Files\Google\Chrome\Application\chrome.exe` |
| Microsoft Edge | `C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe` |
- **`port`** — порт, по которому программа управляет браузером. `9333` подходит,
меняйте только если он у вас занят.
**Обратные слэши в JSON удваиваются** — `C:\\Browsers\\deepseek`, а не
`C:\Browsers\deepseek`. С одинарными файл не прочитается.
> **Проверка:** откройте `config.json` в браузере (перетащите файл в окно).
> Если показалась структура — JSON верный. Если ошибка — ищите пропущенную
> запятую или одинарный слэш.
> Чтобы обновление программы не затирало ваши пути, их можно положить
> не в `config.json`, а в `config.local.json` рядом — он перебивает основной
> и в репозиторий не попадает.
### Шаг 4. Запустить браузер и войти в DeepSeek
> **Проверка:** перетащите `config.json` в окно браузера. Показалась
> структура — JSON верный. Ошибка — ищите пропущенную запятую или одинарный
> слэш.
### Шаг 4. Запустить
```cmd
cd C:\#Projects\ollama_orchestro
start-browser.cmd
```
Откроется браузер с чистым профилем на странице DeepSeek. **Войдите
в аккаунт.** Логин сохранится в профиле — больше делать это не придётся.
> **Проверка:** в окне командной строки написано
> `READY. … is listening on port 9333.`
> Если написано `Port 9333 did not answer` — см. [Если не работает](#если-не-работает).
**Окно браузера не сворачивайте и не закрывайте.** Свёрнутое окно Windows
не отрисовывает, и программа не сможет прочитать ответ. Достаточно перевести
его на другой рабочий стол или просто оставить позади других окон.
### Шаг 5. Создать три рабочих чата
DeepSeek выбирает режим (обычный / с поиском в интернете / со зрением)
**в момент создания чата**, и потом переключить его нельзя — тумблеры
исчезают после первого сообщения. Поэтому под каждый режим нужен свой чат.
Создадутся они сами:
```cmd
cd C:\#Projects\ollama_orchestro
node ask.mjs init
```
Команда откроет три новых чата, задаст в каждом по вопросу и запишет их
номера в `chats.json`. Займёт минуту-две, окно браузера в это время будет
само щёлкать — так и надо, не мешайте.
> **Проверка:** в конце напечатается что-то вроде
> ```
> Сохранено в chats.json:
> think expert af016e20-…
> search default+… 8021bbc1-…
> vision vision 14663b36-…
> ```
### Шаг 6. Настроить deepseek-api
Файл `config.json` в папке `deepseek-api` уже готов:
```json
{
"port": 11500,
"host": "0.0.0.0",
"bridge": "C:/#Projects/ollama_orchestro/ask.mjs",
"chatUrl": "https://chat.deepseek.com/",
"defaultRole": "think",
"timeout": 300
}
```
Если вы разложили папки как в шаге 1 — **менять здесь нечего, переходите
к шагу 7.** Если DeepShim лежит в другом месте, поправьте `bridge`. Здесь
слэши обычные, прямые (`C:/…`), а не обратные.
### Шаг 7. Запустить
```cmd
cd C:\#Projects\deepseek-api
start.cmd
```
@@ -206,26 +135,34 @@ start.cmd
Это окно должно оставаться открытым — пока оно живо, работает и сервис.
Останов — `Ctrl+C` или просто закрыть окно.
**Готово.** Дальше — проверка.
### Шаг 5. Войти в DeepSeek
---
## Проверка, что всё работает
Откройте **вторую** командную строку (первая занята сервисом) и спросите
что-нибудь:
Браузер поднимается сам, но в пустом профиле вы ещё не залогинены. Дайте
сервису первый запрос — он откроет окно:
```cmd
curl http://localhost:11500/api/tags
```
Ожидается список из трёх «моделей»:
Первый вызов ответит `503` и поднимет браузер. **Войдите в аккаунт DeepSeek
в открывшемся окне.** Логин сохранится в профиле — больше делать это
не придётся.
```json
{"models":[{"name":"deepseek:think",…},{"name":"deepseek:search",…},{"name":"deepseek:vision",…}]}
```
**Окно браузера не сворачивайте и не закрывайте.** Свёрнутое окно Windows
не отрисовывает, и программа не сможет прочитать ответ. Достаточно перевести
его на другой рабочий стол или оставить позади других окон.
Теперь настоящий вопрос:
> **Проверка:** повторите `curl http://localhost:11500/api/tags` — теперь
> должен прийти список из трёх «моделей».
**Готово.** Чаты под каждый режим программа заведёт сама при первом же
вопросе — создавать их руками не нужно.
---
## Проверка, что всё работает
Откройте **вторую** командную строку (первая занята сервисом):
```cmd
curl http://localhost:11500/api/chat -d "{\"model\":\"deepseek:think\",\"stream\":false,\"messages\":[{\"role\":\"user\",\"content\":\"Ответь одним словом: столица Японии?\"}]}"
@@ -237,13 +174,25 @@ curl http://localhost:11500/api/chat -d "{\"model\":\"deepseek:think\",\"stream\
{"model":"deepseek:think","created_at":"…","message":{"role":"assistant","content":"Токио"},"done":true,"done_reason":"stop"}
```
Если пришло — всё работает. В окне сервиса при этом видно, сколько заняло:
В окне сервиса при этом видно, что происходило:
```
[think] 37 симв.
[think] ответ 5 симв. за 8 с
чат think не найден, создаю сразу с вопросом
открыт новый чат
создан новый чат think: 660347d5-…
[think] ответ 5 симв. за 9 с
```
Отдельная диагностика — что сейчас видно во вкладке:
```cmd
curl http://localhost:11500/api/probe
```
Покажет адрес вкладки, найдено ли поле ввода, идёт ли генерация, список чатов
и не просит ли сайт залогиниться.
---
## Как подключить свою программу
@@ -257,8 +206,9 @@ http://localhost:11500
Моделью выберите `deepseek:think`.
Если программа работает на **другом компьютере** в вашей сети — вместо
`localhost` укажите адрес этого компьютера, например `http://192.168.0.10:11500`.
Сервис слушает все адреса, ничего дополнительно настраивать не нужно.
`localhost` укажите адрес этого компьютера, например
`http://192.168.0.10:11500`. Сервис слушает все адреса, ничего дополнительно
настраивать не нужно.
### Три «модели» — это три режима
@@ -268,9 +218,9 @@ http://localhost:11500
| `deepseek:search` | с поиском в интернете | нужны свежие данные |
| `deepseek:vision` | со зрением | разбор картинок |
Картинку можно просто приложить к запросу, как это делает Ollama —
в поле `images` массивом base64. Тогда режим `vision` включится сам,
независимо от того, какую модель вы указали.
Картинку можно приложить к запросу так же, как это делает Ollama — в поле
`images` массивом base64. Тогда режим `vision` включится сам, независимо
от того, какую модель вы указали.
**Незнакомое имя модели — не ошибка.** Если программа настойчиво шлёт свою
`llama3` или `qwen3:8b`, запрос уйдёт в обычный чат. Это сделано нарочно:
@@ -292,6 +242,7 @@ http://localhost:11500
|---|---|
| `GET /api/tags` | список «моделей». **Отвечает 503, пока браузер не поднят** — по этому клиенты понимают, что сервис не готов |
| `GET /api/version` | опознавательная строка |
| `GET /api/probe` | сверх протокола Ollama: что видно во вкладке прямо сейчас |
| `POST /api/chat` | сообщения → ответ |
| `POST /api/generate` | то же, но вопрос одной строкой |
| `POST /api/embeddings` | **501** — веб-чат векторов не отдаёт |
@@ -314,11 +265,12 @@ http://localhost:11500
### Сколько ждать
Порядок величин, замерено на разборе фразы и генерации тегов:
Порядок величин, замерено на коротких вопросах:
| | Ollama (qwen3:8b, локально) | DeepSeek (веб) |
|---|---|---|
| короткий вопрос | 2–3 с | 8–12 с |
| короткий вопрос | 2–3 с | 7–12 с |
| запрос, на котором меняется чат | — | ~16 с |
| первый запрос после запуска браузера | — | +15 с на подъём окна |
Если ваша программа считает, что модель обязана ответить за пару секунд, —
@@ -334,7 +286,9 @@ http://localhost:11500
|---|---|---|
| `port` | `11500` | порт, на котором сервис слушает |
| `host` | `0.0.0.0` | какие адреса слушать; `127.0.0.1` — только этот компьютер |
| `bridge` | `C:/#Projects/ollama_orchestro/ask.mjs` | путь к DeepShim |
| `cdpPort` | `9333` | порт, по которому программа управляет браузером |
| `browserExe` | Яндекс.Браузер | путь к браузеру |
| `profileDir` | `C:\Browsers\deepseek` | папка профиля браузера |
| `chatUrl` | `https://chat.deepseek.com/` | что открывать во вкладке |
| `defaultRole` | `think` | режим для незнакомых имён моделей |
| `timeout` | `300` | сколько секунд ждать **бездействия** страницы |
@@ -342,9 +296,12 @@ http://localhost:11500
Про `timeout`: это не «сколько ждать ответа». Пока DeepSeek печатает, ждём
сколько угодно; срок отсчитывается от последнего признака жизни страницы.
`config.local.json` рядом перебивает `config.json` и в репозиторий не
попадает — туда удобно класть пути конкретной машины.
### Переменные окружения
Перебивают файл, удобны для разовых запусков:
Перебивают файлы, удобны для разовых запусков:
```cmd
set DEEPSEEK_API_PORT=11501
@@ -352,9 +309,10 @@ set DEEPSEEK_CDP_PORT=9444
start.cmd
```
Профиль браузера, путь к нему и порт управления берутся из
`ollama_orchestro/config.json` — там уже выполнен вход в DeepSeek, и второй
экземпляр этих настроек однажды разошёлся бы с первым.
### `chats.json`
Заводится сам, руками его трогать не нужно — см.
[Чаты изнашиваются](#чаты-изнашиваются-и-меняются-сами).
---
@@ -365,29 +323,21 @@ start.cmd
| Что видно | В чём дело | Что делать |
|---|---|---|
| `Браузер с отладочным портом 9333 не отвечает` в ответе на `/api/tags` | браузер закрыт | Ничего: он поднимется сам при первом запросе к `/api/chat`. Если не поднялся — следующая строка |
| `Браузер так и не открыл отладочный порт` | этот профиль уже открыт **без** порта управления: новый процесс отдаёт ссылку старому окну и молча завершается | Закройте **все** окна браузера с этим профилем и повторите. Проверить, что не осталось: диспетчер задач, процессы браузера |
| `в config.json не задан profileDir или browserExe` | шаг 3 пропущен или файл лежит не в той папке | `ollama_orchestro\config.json`, оба ключа заполнены |
| `мост вышел с кодом 1. Вкладка chat.deepseek.com не открыта` | вкладку закрыли руками | Откройте `chat.deepseek.com` в том же окне браузера, или перезапустите его через `start-browser.cmd` |
| `Браузер так и не открыл отладочный порт` | этот профиль уже открыт **без** порта управления: новый процесс отдаёт ссылку старому окну и молча завершается | Закройте **все** окна браузера с этим профилем и повторите. Проверить, что не осталось: диспетчер задач |
| `Браузер не найден: …` | неверный `browserExe` | Проверьте путь и удвоенные слэши |
| `не задан browserExe или profileDir` | шаг 3 пропущен | Заполните оба ключа |
| `Вкладка chat.deepseek.com не открыта` | вкладку закрыли руками | Сервис откроет её сам на следующем запросе; если нет — откройте `chat.deepseek.com` в том же окне |
| Ответ приходит **обрезанным**, без кода | окно браузера свёрнуто — Windows перестаёт его отрисовывать, а DeepSeek дорисовывает блоки кода лениво | Разверните окно. Не сворачивайте: уводите на другой рабочий стол или за другие окна |
| Ответ приходит **чужой**, не на ваш вопрос | вкладка не успела обновиться | Повторите запрос. Если повторяется — перезапустите браузер |
| В окне мелькнуло `правки в этом чате кончились, завожу новый` | исчерпан лимит в шесть правок одного сообщения | Ничего. Это штатная смена чата, см. [Чаты изнашиваются](#чаты-изнашиваются-и-меняются-сами) |
| В логе `правки в этом чате кончились, завожу новый` | исчерпан лимит в шесть правок одного сообщения | Ничего. Это штатная смена чата, см. [Чаты изнашиваются](#чаты-изнашиваются-и-меняются-сами) |
| Чаты пропадают сами, хотя вы их не удаляли | тот же профиль браузера использует другая программа, управляющая чатами | Дайте каждой свой `profileDir` |
| `EADDRINUSE: address already in use` | сервис уже запущен в другом окне | Закройте то окно либо возьмите другой порт (`DEEPSEEK_API_PORT`) |
| `node не является внутренней или внешней командой` | Node не установлен или командная строка открыта до его установки | Поставьте Node, **закройте и откройте заново** командную строку |
| Просит войти в DeepSeek при каждом запуске | профиль браузера каждый раз новый | Проверьте, что `profileDir` указывает на одну и ту же существующую папку |
Отдельная диагностика самого моста — из папки DeepShim:
```cmd
node ask.mjs probe
```
Она скажет, видна ли вкладка, найдено ли поле ввода и не просит ли сайт
залогиниться.
| Просит войти в DeepSeek при каждом запуске | профиль каждый раз новый | Проверьте, что `profileDir` указывает на одну и ту же существующую папку |
Проверить перевод формата, не поднимая браузер:
```cmd
cd C:\#Projects\deepseek-api
node test.mjs
```
@@ -426,12 +376,10 @@ POST /api/chat
├─ выбрать чат по имени модели (think / search / vision)
├─ встать в очередь (вкладка одна)
│
├─> написать вопрос во временный файл
├─> node ask.mjs ask --file … --out … (дочерний процесс)
│ └─> Chrome DevTools Protocol
│ └─> правка ПЕРВОГО сообщения чата
│ └─> дождаться, пока DeepSeek допечатает
├─< прочитать ответ из файла
├─> поднять браузер, если он не отвечает
├─> Chrome DevTools Protocol
│ └─> правка ПЕРВОГО сообщения чата
│ └─> дождаться, пока DeepSeek допечатает
│
└─ отдать в формате Ollama
```
@@ -441,46 +389,51 @@ POST /api/chat
Контекст не растёт, мусор между запросами не копится, каждый вопрос —
с чистого листа.
Почему дочерний процесс, а не импорт: `ask.mjs` — программа командной строки,
она ничего не экспортирует и выполняется сразу при подключении. Переделывать
чужой проект ради этого не стали.
Почему браузер поднимается напрямую, а не через `browser-launch.ps1`
из DeepShim: тот скрипт рассчитан на человека за консолью — на занятом профиле
он задаёт вопрос и ждёт ответа, а у сервиса некому отвечать.
Почему браузер запускается напрямую из программы, а не батником: батник
рассчитан на человека за консолью — на занятом профиле он задаёт вопрос
и ждёт ответа, а у сервиса некому отвечать.
### Чаты изнашиваются и меняются сами
**Одно сообщение DeepSeek разрешает править ровно шесть раз.** После шестой
правки кнопка перестаёт открывать поле ввода — и чат становится непригоден.
Ничего делать не нужно, это уже предусмотрено. На седьмом вопросе DeepShim
Ничего делать не нужно, это предусмотрено. На седьмом вопросе программа
заводит новый чат того же режима, задаёт вопрос сразу в нём, записывает новый
номер в `chats.json` и **удаляет отработавший чат**. Снаружи не видно ничего:
тот же запрос, тот же ответ, разве что на несколько секунд дольше.
Отсюда два следствия:
Отсюда следствия:
- **`chats.json` — не настройка, а переменная.** Номера в нём меняются сами
по мере работы. Не правьте его руками и не удивляйтесь, если git покажет
в нём изменения.
по мере работы. Не правьте его руками; в репозиторий он не попадает,
образец структуры — `chats.example.json`.
- **В сайдбаре DeepSeek не копится мусор.** Старые чаты удаляются, плюс перед
каждым вопросом сайдбар подчищается от посторонних служебных чатов.
каждым вопросом сайдбар подчищается от всего, чего нет в `chats.json`.
Именно поэтому профиль браузера должен быть свой: чужие чаты в нём
программа считает мусором.
- Если вы удалите рабочий чат вручную — ничего страшного: следующий запрос
заметит пропажу и создаст новый.
Если вы удалите рабочий чат вручную — тоже ничего страшного: следующий запрос
заметит пропажу и создаст новый.
Файлы:
### Файлы
| Файл | Что в нём |
|---|---|
| `server.mjs` | всё: HTTP, очередь, запуск браузера, вызов моста |
| `config.json` | настройки этой машины |
| `server.mjs` | HTTP, перевод формата Ollama, очередь |
| `browser.mjs` | всё про браузер: CDP, разметка DeepSeek, отправка, ожидание ответа, чаты |
| `config.json` | настройки; `config.local.json` рядом перебивает их |
| `chats.json` | рабочее состояние: id живых чатов (заводится сам) |
| `start.cmd` | запуск |
| `test.mjs` | проверка перевода формата, браузер не нужен |
Зависимостей нет — только то, что есть в Node 22.
Движок управления вкладкой перенесён из
[DeepShim](https://git.08h.ru/alex/deepshim) и дальше живёт здесь своей жизнью.
Там он часть большого инструмента с веб-пультом и разбором патчей; здесь нужен
только чат. Всё, что удалось выяснить про разметку DeepSeek, перенесено вместе
с комментариями — это знание дороже кода.
---
## Лицензия