cvc-catalog-sync-plugin 1.0.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +203 -0
- package/README.md +297 -203
- package/README.ru.md +380 -0
- package/SECURITY.md +234 -34
- package/client.js +2428 -553
- package/cordis.patch.yml +13 -8
- package/docs/ARCHITECTURE.md +965 -0
- package/docs/COMPATIBILITY.md +260 -0
- package/docs/DETAIL.md +3 -0
- package/docs/UPGRADING.md +357 -0
- package/docs/preview.svg +99 -0
- package/icon.svg +76 -8
- package/index.js +243 -1312
- package/lib/CONTRACT.js +63 -0
- package/lib/balance.js +412 -0
- package/lib/cache.js +114 -0
- package/lib/catalog-build.js +391 -0
- package/lib/catalog-sync.js +856 -0
- package/lib/coefficients.js +308 -0
- package/lib/config.js +558 -0
- package/lib/cvc-api.js +372 -0
- package/lib/http.js +269 -0
- package/lib/providers.js +210 -0
- package/lib/state.js +233 -0
- package/locale/en.json +4 -3
- package/locale/ru.json +4 -3
- package/package.json +32 -10
package/README.ru.md
ADDED
|
@@ -0,0 +1,380 @@
|
|
|
1
|
+
# Каталог, коэффициенты и баланс CVC
|
|
2
|
+
|
|
3
|
+
[](https://github.com/mikel38487/cvc-catalog-sync-plugin/actions/workflows/ci.yml)
|
|
4
|
+
[](https://github.com/mikel38487/cvc-catalog-sync-plugin/actions/workflows/codeql.yml)
|
|
5
|
+
[](https://www.npmjs.com/package/cvc-catalog-sync-plugin)
|
|
6
|
+
[](LICENSE)
|
|
7
|
+
|
|
8
|
+
Один плагин для трёх вещей, которые нужны профилю DSH с маршрутом
|
|
9
|
+
CheapVibeCode:
|
|
10
|
+
|
|
11
|
+
1. **Синхронизация каталога** держит `llm-pi-ai.providers.<провайдер>.models` и
|
|
12
|
+
список моделей сабагентов в соответствии с `GET /v1/models` и с уровнями
|
|
13
|
+
мышления из официального установщика CheapVibeCode.
|
|
14
|
+
2. **Коэффициенты** ставят рядом с каждой моделью этого провайдера в выборе
|
|
15
|
+
модели множитель цены (`×0.1` … `×10`).
|
|
16
|
+
3. **Баланс** добавляет кнопку в сайдбар и панель с остатком и расходом с
|
|
17
|
+
прошлого замера.
|
|
18
|
+
|
|
19
|
+
У каждой из трёх функций свой переключатель на странице настроек. Выключенная
|
|
20
|
+
функция не оставляет после себя ничего: ни маршрута, ни таймера, ни инструмента,
|
|
21
|
+
ни элемента интерфейса. Версия 2.0.0 заменяет два прежних плагина
|
|
22
|
+
(`cvc-model-coeff-plugin` и `cvc-balance-plugin`) и переносит их возможности в
|
|
23
|
+
этот пакет, поэтому в профильном патче достаточно одной строки.
|
|
24
|
+
|
|
25
|
+
## Требования
|
|
26
|
+
|
|
27
|
+
- DeepSeek Harness `>=0.2.2-rc.3 <0.4.0`;
|
|
28
|
+
- Node.js 20 или новее;
|
|
29
|
+
- маршрут провайдера в `llm-pi-ai`, чей `baseURL` указывает на хост
|
|
30
|
+
`cheapvibecode.ru` (по умолчанию `https://ru.cheapvibecode.ru/v1`), с ключом,
|
|
31
|
+
имя которого задано в `apiKeyEnv` (по умолчанию `CVC_DEEPSEEK_API_KEY`).
|
|
32
|
+
|
|
33
|
+
Если такого маршрута нет, каталогу и балансу не у кого читать: план и
|
|
34
|
+
применение сообщают, что маршрут не найден, и панель баланса говорит то же
|
|
35
|
+
самое. Сама страница настроек при этом работает — она ведь и есть переключатель
|
|
36
|
+
функций.
|
|
37
|
+
|
|
38
|
+
## Установка
|
|
39
|
+
|
|
40
|
+
Попросите агента DSH поставить бандл из npm:
|
|
41
|
+
|
|
42
|
+
```text
|
|
43
|
+
install the npm bundle cvc-catalog-sync-plugin
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Вручную: добавьте `"cvc-catalog-sync-plugin": "^2.0.0"` в зависимости
|
|
47
|
+
`~/.dsh/profiles/<профиль>/package.json`, допишите имя пакета в
|
|
48
|
+
`dsh.profile.bundles` и дайте профилю установить его. Бандл содержит собранный
|
|
49
|
+
`client.js`, поэтому при установке ничего не собирается и разрешение
|
|
50
|
+
`allowBuilds` не требуется. Для локального чекаута используйте
|
|
51
|
+
`"cvc-catalog-sync-plugin": "link:<абсолютный путь>"`.
|
|
52
|
+
|
|
53
|
+
Имя пакета — `cvc-catalog-sync-plugin`, id строки композиции —
|
|
54
|
+
`cvc-catalog-sync`: профиль не нужно переписывать ради обновления. Шаги, которые
|
|
55
|
+
действительно меняются, — в [docs/UPGRADING.md](docs/UPGRADING.md).
|
|
56
|
+
|
|
57
|
+
## Где настройки
|
|
58
|
+
|
|
59
|
+
Одна и та же форма открывается в двух местах:
|
|
60
|
+
|
|
61
|
+
- **Настройки → CVC** — раздел навигации настроек со своим значком
|
|
62
|
+
(`settings.section` + `settings.section.icon`, id `cvc`, order 25);
|
|
63
|
+
- **Плагины → CVC catalog sync → страница бандла** — блок конфигурации между
|
|
64
|
+
описанием бандла и списком компонентов (`plugins.bundle.config` с ключом по
|
|
65
|
+
имени пакета). В свёрнутом списке блок показывается одной строкой-сводкой.
|
|
66
|
+
|
|
67
|
+
Сверху одна группа переключателей (**Функции**), затем группы параметров:
|
|
68
|
+
**Каталог**, **Коэффициенты**, **Баланс** и **Дополнительно**. Переключатели
|
|
69
|
+
решают, действует ли соответствующая группа; **Дополнительно** содержит поиск
|
|
70
|
+
провайдеров (`providers.*`) и кэш уровней и виден при всех выключенных функциях,
|
|
71
|
+
потому что настраивает общий для всех трёх поиск.
|
|
72
|
+
|
|
73
|
+
| Переключатель | Что включает |
|
|
74
|
+
|---|---|
|
|
75
|
+
| Синхронизация каталога | прогоны при старте и по таймеру, инструмент `cvc_catalog`, `POST /cvc/run` и то, что умеют кнопки проверки и применения |
|
|
76
|
+
| Коэффициенты | `GET /cvc/coefficients` и бейджи в выборе модели |
|
|
77
|
+
| Баланс | `GET /cvc/balance`, инструмент `cvc_balance`, кнопка в сайдбаре и панель |
|
|
78
|
+
|
|
79
|
+
Страница настроек и `GET /cvc/state` не гейтятся: они существуют и при всех трёх
|
|
80
|
+
выключенных функциях, потому что страница и есть переключатель. Кнопки проверки и
|
|
81
|
+
применения остаются на странице и при выключенной синхронизации, но маршрут
|
|
82
|
+
прогона за ними отвечает `404`, и страница сообщает о неудачном прогоне.
|
|
83
|
+
|
|
84
|
+
Изменение применяется через `PUT /cvc/config` и действует сразу: все поля
|
|
85
|
+
конфигурации объявлены volatile, поэтому DSH перезагружает строку без
|
|
86
|
+
перезапуска плагина. Выключение функции снимает её с монтирования, включение
|
|
87
|
+
возвращает — в той же сессии страницы.
|
|
88
|
+
|
|
89
|
+
Переключатели называются **Синхронизация каталога**, **Коэффициенты моделей** и
|
|
90
|
+
**Баланс**, и страница настроек прямо говорит, что остаётся после выключения:
|
|
91
|
+
маршрут функции отвечает `404`, таймер не создаётся, элемент интерфейса
|
|
92
|
+
исчезает. Сама страница остаётся всегда — это и есть переключатель.
|
|
93
|
+
|
|
94
|
+
Кнопки:
|
|
95
|
+
|
|
96
|
+
| Кнопка | Что делает |
|
|
97
|
+
|---|---|
|
|
98
|
+
| **Сохранить** | Проверяет форму и пишет строку конфига в профильный патч через `configEditor.edit()`. Значение, равное умолчаниям схемы, убирает переопределение, поэтому в патче остаются только реальные изменения. |
|
|
99
|
+
| **Проверить каталог** | Забирает каталог и карту уровней, показывает разницу, ничего не записывает. |
|
|
100
|
+
| **Применить каталог** | Тот же запрос, затем запись моделей и списка сабагентов. Сначала спрашивает подтверждение. |
|
|
101
|
+
| **Сбросить** | Подставляет умолчания в форму; нажмите «Сохранить», чтобы убрать переопределение. |
|
|
102
|
+
|
|
103
|
+
Проверка и применение используют **сохранённые** настройки, поэтому сначала
|
|
104
|
+
«Сохранить»; несохранённые изменения страница помечает. Под кнопками — итог
|
|
105
|
+
последнего прогона: число моделей в каталоге, сейчас и будет, источник уровней,
|
|
106
|
+
добавленные, удалённые и изменённые модели, правки списка сабагентов,
|
|
107
|
+
предупреждения и путь патча.
|
|
108
|
+
|
|
109
|
+
## Конфигурация
|
|
110
|
+
|
|
111
|
+
Переопределяйте строку в профильном патче по id `cvc-catalog-sync` — или
|
|
112
|
+
пользуйтесь страницей настроек, она пишет ту же строку. Перечислять нужно только
|
|
113
|
+
те поля, которые хотите изменить:
|
|
114
|
+
|
|
115
|
+
```yaml
|
|
116
|
+
- id: cvc-catalog-sync
|
|
117
|
+
name: 'cvc-catalog-sync-plugin'
|
|
118
|
+
config:
|
|
119
|
+
features:
|
|
120
|
+
catalogSync: true
|
|
121
|
+
coefficients: true
|
|
122
|
+
balance: true
|
|
123
|
+
providers:
|
|
124
|
+
match: ['cheapvibecode.ru'] # хосты, по которым узнаётся провайдер
|
|
125
|
+
entryId: llm-pi-ai # строка патча с маршрутами провайдеров
|
|
126
|
+
apiKeyEnv: CVC_DEEPSEEK_API_KEY # запасное имя ключа, не значение
|
|
127
|
+
baseURL: https://ru.cheapvibecode.ru/v1
|
|
128
|
+
timeoutMs: 20000
|
|
129
|
+
catalog:
|
|
130
|
+
provider: cheapvibecode # ключ маршрута, чьи models пишутся
|
|
131
|
+
autoSync: true # прогон при старте и по интервалу
|
|
132
|
+
intervalHours: 24 # 0 выключает таймер; меньше минуты — поднимается
|
|
133
|
+
startupDelayMs: 5000
|
|
134
|
+
minModelRatio: 0.8 # не принимать каталог меньше этой доли
|
|
135
|
+
keepModels: [] # id, которые сохраняются, даже если каталог их убрал
|
|
136
|
+
installerUrls: # карты уровней, уровни берутся из первого доступного
|
|
137
|
+
- https://ru.cheapvibecode.ru/idhw
|
|
138
|
+
- https://ru.cheapvibecode.ru/idhl
|
|
139
|
+
syncAllowlist: true
|
|
140
|
+
allowlistEntryId: subagent-model-selection-settings
|
|
141
|
+
levelsCacheMinutes: 360
|
|
142
|
+
coefficients:
|
|
143
|
+
refreshMinutes: 10
|
|
144
|
+
showFast: true
|
|
145
|
+
balance:
|
|
146
|
+
refreshSeconds: 0 # 0 — только по кнопке; минимум 15
|
|
147
|
+
showDelta: true
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Умолчания те же, что в таблице [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md);
|
|
151
|
+
записанное в патч значение переопределяет умолчание, удалённое поле возвращает
|
|
152
|
+
его обратно.
|
|
153
|
+
|
|
154
|
+
Конфигурация версии 1.x по-прежнему загружается: плоские ключи (`entryId`,
|
|
155
|
+
`provider`, `baseURL`, `apiKeyEnv`, `installerUrls`, `autoSync`,
|
|
156
|
+
`intervalHours`, `startupDelayMs`, `minModelRatio`, `keepModels`,
|
|
157
|
+
`syncAllowlist`, `allowlistEntryId`, `levelsCacheMinutes`, `timeoutMs`)
|
|
158
|
+
принимаются как устаревшие поля и раскладываются по группам. В этом случае
|
|
159
|
+
`GET /cvc/state` сообщает `configShape: legacy`, а страница настроек предлагает
|
|
160
|
+
один раз сохранить, чтобы перейти на новый вид.
|
|
161
|
+
|
|
162
|
+
## Каталог
|
|
163
|
+
|
|
164
|
+
Каталог CVC (`GET /v1/models`) меняется часто и **не содержит** уровней
|
|
165
|
+
мышления — только булев `supports_reasoning`. Уровни лежат литералом
|
|
166
|
+
`const reasoningLevels = {...}` внутри официальных установщиков (`/idhw` для
|
|
167
|
+
PowerShell, `/idhl` для bash). Штатное действие DSH «получить список моделей»
|
|
168
|
+
ничего не сохраняет и уровней не возвращает, поэтому обновление каталога иначе —
|
|
169
|
+
ручная правка `~/.dsh/profiles/<профиль>/cordis.patch.yml`.
|
|
170
|
+
|
|
171
|
+
Что делает прогон:
|
|
172
|
+
|
|
173
|
+
1. При активации, после `startupDelayMs`, и каждые `intervalHours` (если
|
|
174
|
+
`autoSync` включён) забирает `{baseURL}/models` ключом маршрута и карту
|
|
175
|
+
`reasoningLevels` установщика.
|
|
176
|
+
2. Собирает `llm-pi-ai.providers.<провайдер>.models` по правилам самого
|
|
177
|
+
установщика: `name` — хвост `display_name` после ` · `, `contextWindow` —
|
|
178
|
+
`context_window`, `maxTokens` — `min(max_output_tokens, contextWindow)`,
|
|
179
|
+
`input` получает `image`, если модель его принимает, уровень `none`
|
|
180
|
+
превращается в `off: none`, а `gpt-image*` и модели без текстового вывода
|
|
181
|
+
пропускаются.
|
|
182
|
+
3. Пишет результат через `ctx.configEditor.edit()`: сохраняются остальные
|
|
183
|
+
строки патча, комментарии и строки чужих плагинов, а изменение применяется
|
|
184
|
+
через `dsh-hmr` без перезапуска DSH.
|
|
185
|
+
4. При включённом `syncAllowlist` список
|
|
186
|
+
`subagent-model-selection-settings.allowedModels` приводится к тем же id
|
|
187
|
+
моделей; записи других провайдеров не трогаются.
|
|
188
|
+
|
|
189
|
+
Запись выполняется только при реальном изменении каталога или списка. Ответ
|
|
190
|
+
меньше `minModelRatio` от текущего числа моделей отклоняется: частичный или
|
|
191
|
+
пустой каталог не должен стирать рабочий список.
|
|
192
|
+
|
|
193
|
+
### Инструмент cvc_catalog
|
|
194
|
+
|
|
195
|
+
| Действие | Что делает |
|
|
196
|
+
|---|---|
|
|
197
|
+
| `status` | Последний прогон в этом процессе; без сети |
|
|
198
|
+
| `plan` | Забрать, собрать, показать разницу, ничего не записывать |
|
|
199
|
+
| `apply` | Забрать и записать (отказ при усыхании каталога или при устаревшем каталоге, обходится `force: true`) |
|
|
200
|
+
|
|
201
|
+
Проверка и применение проходят одни и те же шаги. Прогон сообщает размер
|
|
202
|
+
каталога, текущее и будущее число моделей, источник уровней, добавленные,
|
|
203
|
+
удалённые и изменённые модели, правки списка сабагентов и предупреждения. Когда
|
|
204
|
+
API отвечает `409`, причина — отказ guard-а или устаревший каталог, а не сбой
|
|
205
|
+
сервера: страница показывает причину и предлагает `force` там, где инструмент его
|
|
206
|
+
принимает.
|
|
207
|
+
|
|
208
|
+
## Коэффициенты
|
|
209
|
+
|
|
210
|
+
Множитель приходит из того же ответа `GET /v1/models` и представляет собой
|
|
211
|
+
коэффициент к базовой цене провайдера, а не сумму в валюте. В меню выбора
|
|
212
|
+
модели и на кнопке текущей модели у композера справа от имени появляется бейдж
|
|
213
|
+
`×0.1`, `×3`, `×10`. Цвет берётся из темы хоста: зелёный до 0.5, обычный текст
|
|
214
|
+
до 1.5, предупреждение до 4, ошибка выше. Если fast-режим дороже обычного,
|
|
215
|
+
подсказка называет и его.
|
|
216
|
+
|
|
217
|
+
Бейдж получают только модели провайдера, чей `baseURL` указывает на
|
|
218
|
+
`cheapvibecode.ru`; та же модель с тем же id у другого провайдера остаётся без
|
|
219
|
+
украшения. Модель без коэффициента в каталоге остаётся без бейджа: плагин не
|
|
220
|
+
угадывает цену. Бейдж не кликабелен, а слот `conversation.input.model.label`
|
|
221
|
+
остаётся его владельцу, поэтому выбор модели не меняется — он по-прежнему у
|
|
222
|
+
штатного селектора.
|
|
223
|
+
|
|
224
|
+
Браузер спрашивает `GET /cvc/coefficients` каждые `refreshMinutes`. Ответ
|
|
225
|
+
отдаётся из общего кэша каталога, поэтому обновление бейджей не стоит лишнего
|
|
226
|
+
запроса к каталогу, пока кэш свеж. Параметр **Показывать быстрый режим** решает,
|
|
227
|
+
добавлять ли в подсказку множитель fast-режима; без него бейдж показывает только
|
|
228
|
+
обычный множитель.
|
|
229
|
+
|
|
230
|
+
## Баланс
|
|
231
|
+
|
|
232
|
+
В футере сайдбара появляется кнопка **CVC баланс** с маленькой точкой
|
|
233
|
+
состояния: зелёная, когда ответили все провайдеры, жёлтая — когда ответила
|
|
234
|
+
только часть (или идёт обновление), красная — когда не ответил никто, нейтральная —
|
|
235
|
+
когда провайдеров нет. Цвета — токены темы, поэтому точка читается и в светлой
|
|
236
|
+
теме.
|
|
237
|
+
|
|
238
|
+
Нажатие открывает панель с карточкой на каждый маршрут: отображаемое имя, ключ
|
|
239
|
+
маршрута, `baseURL`, имя ключа и найден ли он, остаток в единицах провайдера и
|
|
240
|
+
расход с прошлого замера (если `showDelta` включён). Панель можно перетаскивать,
|
|
241
|
+
она запоминает позицию в `localStorage` под ключом `cvc:panel-pos` и предлагает
|
|
242
|
+
кнопки **Обновить** и **Сбросить позицию**. За пределы окна панель не уходит и в
|
|
243
|
+
`document.body` не пишет.
|
|
244
|
+
|
|
245
|
+
`refreshSeconds` по умолчанию `0`: панель читает баланс при открытии или по
|
|
246
|
+
кнопке. Положительное значение от 15 включает таймер, который перечитывает
|
|
247
|
+
баланс, пока панель открыта; при закрытии панели таймер снимается. Значение от 1
|
|
248
|
+
до 14 поднимается до 15, а форма отклоняет его с ошибкой проверки, а не меняет
|
|
249
|
+
число молча.
|
|
250
|
+
|
|
251
|
+
Ошибка одного провайдера показывается на его карточке и не мешает остальным
|
|
252
|
+
ответить. Сам ключ с хоста не уходит: в ответе только `keySet: true|false` и
|
|
253
|
+
цифры.
|
|
254
|
+
|
|
255
|
+
### Инструмент cvc_balance
|
|
256
|
+
|
|
257
|
+
`status` возвращает последний снимок в этом процессе и не тратит запрос: по
|
|
258
|
+
каждому маршруту — флаг `keySet` и остаток в единицах. Он предназначен агенту,
|
|
259
|
+
человеку — панель, и существует инструмент только при включённой функции
|
|
260
|
+
баланса.
|
|
261
|
+
|
|
262
|
+
## HTTP-контракт
|
|
263
|
+
|
|
264
|
+
Все маршруты живут под одним префиксом `/cvc` и обслуживаются веб-сервером DSH
|
|
265
|
+
на том же origin, что и интерфейс.
|
|
266
|
+
|
|
267
|
+
| Метод | Путь | Тело | Ответ |
|
|
268
|
+
|---|---|---|---|
|
|
269
|
+
| GET | `/cvc/state` | — | `{version, features, config, configShape, status, lastRun, patchPath, rowId}` |
|
|
270
|
+
| PUT | `/cvc/config` | `{config}` | `{ok, config, features}`; при ошибке `400` с `fields` |
|
|
271
|
+
| POST | `/cvc/run` | `{action: 'plan' \| 'apply', force?}` | результат прогона |
|
|
272
|
+
| GET | `/cvc/coefficients` | — | `{models, providers, fetchedAt, stale}`; `404`, если функция выключена |
|
|
273
|
+
| GET | `/cvc/balance` | — | `{providers, fetchedAt}`; `404`, если функция выключена |
|
|
274
|
+
| GET | `/cvc/health` | — | `{ok, version}` |
|
|
275
|
+
|
|
276
|
+
Межсайтовые запросы (`Sec-Fetch-Site: cross-site`) получают `403`, запись
|
|
277
|
+
(`PUT` или `POST`) без `application/json` — `415`, тело больше 64 КБ — `413`, а
|
|
278
|
+
неизвестный путь — `404`, а неверный метод на известном пути — `405`.
|
|
279
|
+
|
|
280
|
+
## Совместимость
|
|
281
|
+
|
|
282
|
+
Плагин опирается на несколько поверхностей интерфейса DSH, которые не входят в
|
|
283
|
+
стабильный публичный API: слоты `settings.section` и `settings.section.icon`,
|
|
284
|
+
блок `plugins.bundle.config`, кнопку `sidebar.footer.action` и атрибуты
|
|
285
|
+
`data-model-id` / `data-provider-id`, которые пишет селектор моделей. Панель
|
|
286
|
+
баланса слот `shell.overlay` не использует: она позиционируется внутри слота
|
|
287
|
+
сайдбара. В [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md) перечислены каждая
|
|
288
|
+
поверхность с последствием её исчезновения и клиентские модули, которые манифест
|
|
289
|
+
объявляет через `dsh.client.inject`.
|
|
290
|
+
|
|
291
|
+
## Ограничения
|
|
292
|
+
|
|
293
|
+
- Уровни вытаскиваются из установщика, а не из API. Если оба адреса установщика
|
|
294
|
+
недоступны, текущие уровни сохраняются, а новые модели получают полный ряд по
|
|
295
|
+
`supports_reasoning`; прогон сообщает `levelsSource: none`.
|
|
296
|
+
- Каталог CVC не фильтруется по ключу: `/v1/models` показывает всё, а
|
|
297
|
+
доступность решается конкретным запросом (`403 This model is not enabled for
|
|
298
|
+
the API key`). Скрыть модели, которые ключ не обслуживает, плагин не может.
|
|
299
|
+
- Схема DSH ограничивает **ключи** `reasoningEfforts`
|
|
300
|
+
(`off/minimal/low/medium/high/xhigh/max`), а значения — произвольное проводное
|
|
301
|
+
написание. Поэтому уровень `thinking` из установщика едет как
|
|
302
|
+
`high: thinking`, и плагин повторяет это правило.
|
|
303
|
+
- Модель, у которой каталог не объявил модальности, сохраняет текущий `input`;
|
|
304
|
+
явный `supports_vision: false` убирает `image`.
|
|
305
|
+
- Маршрут, настроенный через `modelOverrides`, отклоняется с понятной ошибкой:
|
|
306
|
+
DSH не принимает `modelOverrides` рядом с `models`, такой маршрут нужно
|
|
307
|
+
сначала перевести на явный список.
|
|
308
|
+
- Бейдж коэффициента рисуется в меню выбора модели у композера и на кнопке
|
|
309
|
+
текущей модели. Команда `/model` рисует строки своим попапом без тех же
|
|
310
|
+
атрибутов, поэтому там бейджа нет.
|
|
311
|
+
- Сопоставление бейджа сводит регистр, точки и подчёркивания в id модели к
|
|
312
|
+
дефису: каталог CheapVibeCode и адаптер DSH могут писать одну модель
|
|
313
|
+
по-разному. Если и после этого кандидатов больше одного, бейдж не ставится.
|
|
314
|
+
- Баланс показывается в единицах провайдера, ровно как их отдаёт `/v1/balance`;
|
|
315
|
+
в деньги плагин их не пересчитывает.
|
|
316
|
+
- Автоматические прогоны пишут через тот же редактор, но только когда HMR-сервис
|
|
317
|
+
хоста отдаёт пригодный контекст транзакции. На хосте, где это не так, таймер
|
|
318
|
+
считает разницу и пишет предупреждение вместо записи; в этом случае запустите
|
|
319
|
+
`cvc_catalog action=apply` или кнопку **Применить каталог**.
|
|
320
|
+
- Фоновой работы при выключенных функциях нет: когда все три выключены, плагин не
|
|
321
|
+
создаёт таймеров и не делает ни одного запроса к провайдеру.
|
|
322
|
+
|
|
323
|
+
## Проверка и откат
|
|
324
|
+
|
|
325
|
+
```powershell
|
|
326
|
+
# план без записи
|
|
327
|
+
cvc_catalog action=plan
|
|
328
|
+
# копия патча до первого применения
|
|
329
|
+
Copy-Item ~\.dsh\profiles\desktop\cordis.patch.yml ~\.dsh\profiles\desktop\cordis.patch.yml.bak-manual
|
|
330
|
+
cvc_catalog action=apply
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
Профиль не под git, поэтому откат — копия файла.
|
|
334
|
+
|
|
335
|
+
## Разработка
|
|
336
|
+
|
|
337
|
+
```powershell
|
|
338
|
+
npm install
|
|
339
|
+
npm test # node --test test/*.mjs
|
|
340
|
+
npm run build # пересборка client.js из src/client/**
|
|
341
|
+
node tools/assert-pack.mjs # проверка состава npm-тарбола
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
`index.js` и `lib/**` — обычный ESM, без сборки. Браузерная половина
|
|
345
|
+
собирается из `src/client/**` в `client.js`; собранный файл коммитится, поэтому
|
|
346
|
+
пакет работает и из npm, и из git без запуска сборки на машине пользователя. CI
|
|
347
|
+
пересобирает его и падает, если закоммиченный файл отличается от исходников; ещё
|
|
348
|
+
одна работа проверяет, что в тарбол попали обещанные пакетом файлы.
|
|
349
|
+
|
|
350
|
+
Сборка идёт через `tsdown`, в чьём собственном поле `engines` требуется Node
|
|
351
|
+
`^22.18` или `>=24.11`, поэтому в CI сборка выполняется на Node 22. Установка из
|
|
352
|
+
npm и работа плагина идут на Node 20 или новее: собранный `client.js` лежит в
|
|
353
|
+
пакете, а установка из npm скрипт сборки не запускает.
|
|
354
|
+
|
|
355
|
+
Локально подключённый бандл связан ссылкой на каталог, а не копией: правка
|
|
356
|
+
файлов сама новый код не поднимает — DSH подхватит модуль после реконсиляции
|
|
357
|
+
профиля (любое изменение патча) или перезапуска приложения.
|
|
358
|
+
|
|
359
|
+
Архитектура: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
|
|
360
|
+
Обновление: [docs/UPGRADING.md](docs/UPGRADING.md).
|
|
361
|
+
Совместимость: [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md).
|
|
362
|
+
Картинки: [docs/DETAIL.md](docs/DETAIL.md) показывает страницу настроек, бейджи и
|
|
363
|
+
панель одной картинкой.
|
|
364
|
+
|
|
365
|
+
## Безопасность
|
|
366
|
+
|
|
367
|
+
См. [SECURITY.md](SECURITY.md). Плагин обращается только к хостам провайдеров и
|
|
368
|
+
адресам установщиков из своей конфигурации, ключ разрешается на хосте по имени и
|
|
369
|
+
в браузер не попадает, а релизы npm несут provenance из GitHub Actions.
|
|
370
|
+
|
|
371
|
+
## Переехало из
|
|
372
|
+
|
|
373
|
+
Функции коэффициентов и баланса перенесены из двух прежних плагинов,
|
|
374
|
+
`cvc-model-coeff-plugin` и `cvc-balance-plugin`. Оба репозитория остаются
|
|
375
|
+
доступными как архивы; при установке этого плагина их нужно убрать из профиля —
|
|
376
|
+
точные шаги в [docs/UPGRADING.md](docs/UPGRADING.md).
|
|
377
|
+
|
|
378
|
+
## Лицензия
|
|
379
|
+
|
|
380
|
+
MIT © 2026 mikel38487
|