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
|
@@ -0,0 +1,308 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Коэффициенты моделей CheapVibeCode: бейджи `×0.1…×10` в выборе модели.
|
|
3
|
+
*
|
|
4
|
+
* Своего запроса к апстриму модуль не делает: каталог берётся из ОБЩЕГО кэша
|
|
5
|
+
* `deps.cache` (`lib/cache.js`), который наполняется одним `GET /v1/models` для
|
|
6
|
+
* трёх функций. Здесь остаются только чистые преобразования каталога и защита
|
|
7
|
+
* маршрута от лишних чтений.
|
|
8
|
+
*
|
|
9
|
+
* Почему защита вообще нужна, если кэш и сам сливает одновременные запросы:
|
|
10
|
+
* у маршрута может быть несколько читателей сразу (несколько вкладок браузера,
|
|
11
|
+
* открытая панель), и каждый лишний `cache.get()` — это лишняя работа на
|
|
12
|
+
* хосте. Поэтому модуль сам держит одно чтение на монтирование функции, а
|
|
13
|
+
* поздний ответ (функцию уже выключили и включили заново) он не превращает в
|
|
14
|
+
* ответ: поколение чтения сменилось.
|
|
15
|
+
*
|
|
16
|
+
* Ключ и сеть сюда не попадают: `cache.get()` уже получил каталог, а ошибки
|
|
17
|
+
* апстрима приходят кодом (`CvcApiError.code`), не текстом с секретом.
|
|
18
|
+
*
|
|
19
|
+
* @module cvc-catalog-sync-plugin/lib/coefficients
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
/** Путь маршрута в общей таблице каркаса. */
|
|
23
|
+
export const ROUTE_PATH = 'coefficients'
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Нормализовать идентификатор модели для сравнения и дедупликации.
|
|
27
|
+
*
|
|
28
|
+
* Каталог CheapVibeCode и каталог адаптера DSH пишут одну модель по-разному:
|
|
29
|
+
* `deepseek-v4.1-flash` и `deepseek-v4-1-flash`. Точки и подчёркивания
|
|
30
|
+
* сводятся к дефису, регистр не учитывается.
|
|
31
|
+
*
|
|
32
|
+
* @param {unknown} value — сырой идентификатор.
|
|
33
|
+
* @returns {string} ключ сравнения или пустая строка.
|
|
34
|
+
*/
|
|
35
|
+
export function normalizeModelId(value) {
|
|
36
|
+
return String(value ?? '')
|
|
37
|
+
.trim()
|
|
38
|
+
.toLowerCase()
|
|
39
|
+
.replace(/[._]+/g, '-')
|
|
40
|
+
.replace(/-+/g, '-')
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* Разобрать числовой коэффициент.
|
|
45
|
+
*
|
|
46
|
+
* Ноль — законное значение (бесплатная модель), отрицательное и NaN — нет.
|
|
47
|
+
* Строка принимается, потому что часть прокси отдаёт числа текстом.
|
|
48
|
+
*
|
|
49
|
+
* @param {unknown} value
|
|
50
|
+
* @returns {number | null} число или `null`, если значение не читается.
|
|
51
|
+
*/
|
|
52
|
+
export function parseMultiplier(value) {
|
|
53
|
+
if (typeof value === 'string' && value.trim() !== '') {
|
|
54
|
+
const parsed = Number(value)
|
|
55
|
+
return Number.isFinite(parsed) && parsed >= 0 ? parsed : null
|
|
56
|
+
}
|
|
57
|
+
if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) return null
|
|
58
|
+
return value
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Размер контекста из строки каталога.
|
|
63
|
+
*
|
|
64
|
+
* @param {unknown} value — `context_window` сырой строки.
|
|
65
|
+
* @returns {number | null} целое положительное число или `null`.
|
|
66
|
+
*/
|
|
67
|
+
export function parseContextWindow(value) {
|
|
68
|
+
return Number.isFinite(value) && value > 0 ? Math.trunc(/** @type {number} */ (value)) : null
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Отображаемое имя модели: `display_name` каталога, иначе сам id.
|
|
73
|
+
*
|
|
74
|
+
* @param {string} id — идентификатор модели.
|
|
75
|
+
* @param {unknown} value — `display_name` сырой строки.
|
|
76
|
+
* @returns {string}
|
|
77
|
+
*/
|
|
78
|
+
export function displayNameOf(id, value) {
|
|
79
|
+
if (typeof value === 'string' && value.trim().length > 0) return value.trim()
|
|
80
|
+
return id
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Индекс каталога: `нормализованный id → множители и контекст`.
|
|
85
|
+
*
|
|
86
|
+
* Принимает и весь снимок кэша (`{models: [...]}`), и голый массив строк.
|
|
87
|
+
* Строка без читаемого `multiplier` не индексируется: бейдж без множителя
|
|
88
|
+
* означал бы выдуманную цену. При двух записях с одним ключом остаётся первая:
|
|
89
|
+
* порядок каталога провайдера и есть порядок, в котором он их объявил.
|
|
90
|
+
*
|
|
91
|
+
* @param {unknown} catalog — снимок каталога или список строк.
|
|
92
|
+
* @returns {Map<string, { id: string, displayName: string, multiplier: number, fastMultiplier: number | null, contextWindow: number | null }>}
|
|
93
|
+
*/
|
|
94
|
+
export function indexCoefficients(catalog) {
|
|
95
|
+
const source = Array.isArray(catalog)
|
|
96
|
+
? catalog
|
|
97
|
+
: catalog !== null && typeof catalog === 'object' && Array.isArray(/** @type {any} */ (catalog).models)
|
|
98
|
+
? /** @type {any} */ (catalog).models
|
|
99
|
+
: []
|
|
100
|
+
|
|
101
|
+
const index = new Map()
|
|
102
|
+
for (const row of source) {
|
|
103
|
+
if (row === null || typeof row !== 'object') continue
|
|
104
|
+
const id = typeof row.id === 'string' ? row.id.trim() : ''
|
|
105
|
+
const multiplier = parseMultiplier(row.multiplier)
|
|
106
|
+
if (id.length === 0 || multiplier === null) continue
|
|
107
|
+
const key = normalizeModelId(id)
|
|
108
|
+
if (key.length === 0 || index.has(key)) continue
|
|
109
|
+
index.set(key, {
|
|
110
|
+
id,
|
|
111
|
+
displayName: displayNameOf(id, row.display_name),
|
|
112
|
+
multiplier,
|
|
113
|
+
fastMultiplier: parseMultiplier(row.fast_multiplier),
|
|
114
|
+
contextWindow: parseContextWindow(row.context_window),
|
|
115
|
+
})
|
|
116
|
+
}
|
|
117
|
+
return index
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* Найти коэффициент модели по идентификатору.
|
|
122
|
+
*
|
|
123
|
+
* Порядок поиска: точный ключ, затем ключ без префикса провайдера
|
|
124
|
+
* (`openai/gpt-6-sol`), затем единственный ключ каталога, который заканчивается
|
|
125
|
+
* на id модели. Последний шаг нужен, когда адаптер DSH отрезает вендора, а
|
|
126
|
+
* каталог CheapVibeCode его оставляет. Если таких хвостов несколько — это уже
|
|
127
|
+
* неоднозначность, и коэффициент не показывается.
|
|
128
|
+
*
|
|
129
|
+
* @param {ReturnType<typeof indexCoefficients>} index — индекс каталога.
|
|
130
|
+
* @param {unknown} modelId — идентификатор модели в селекторе.
|
|
131
|
+
* @returns {{ id: string, multiplier: number, fastMultiplier: number | null, contextWindow: number | null } | null}
|
|
132
|
+
*/
|
|
133
|
+
export function lookupCoefficient(index, modelId) {
|
|
134
|
+
const key = normalizeModelId(modelId)
|
|
135
|
+
if (key.length === 0) return null
|
|
136
|
+
|
|
137
|
+
const direct = index.get(key)
|
|
138
|
+
if (direct !== undefined) return direct
|
|
139
|
+
|
|
140
|
+
const slash = key.lastIndexOf('/')
|
|
141
|
+
if (slash >= 0) {
|
|
142
|
+
const tail = index.get(key.slice(slash + 1))
|
|
143
|
+
if (tail !== undefined) return tail
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
// Хвост после дефиса берём только когда он сам похож на id модели.
|
|
147
|
+
// Иначе «pro» совпадёт и с mimo-v2.6-pro, и с gemini-3.1-pro, и с десятком
|
|
148
|
+
// других, а единственный короткий ключ получит чужой коэффициент.
|
|
149
|
+
if (key.length < 6 || !key.includes('-')) return null
|
|
150
|
+
|
|
151
|
+
const suffix = []
|
|
152
|
+
for (const [candidate, value] of index) {
|
|
153
|
+
if (candidate.endsWith(`-${key}`) || candidate.endsWith(`/${key}`)) suffix.push(value)
|
|
154
|
+
}
|
|
155
|
+
return suffix.length === 1 ? suffix[0] : null
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* Текст бейджа: значимые знаки без хвостовых нулей.
|
|
160
|
+
*
|
|
161
|
+
* `0.1` остаётся `×0.1`, `1` становится `×1`, `2.50` — `×2.5`. В браузере
|
|
162
|
+
* правило продублировано (`src/client/coefficients.js`): собранный клиент не
|
|
163
|
+
* может импортировать хост-модуль, и дублирование здесь дешевле сборки.
|
|
164
|
+
*
|
|
165
|
+
* @param {number} multiplier
|
|
166
|
+
* @returns {string} подпись бейджа или пустая строка для нечисла.
|
|
167
|
+
*/
|
|
168
|
+
export function formatMultiplier(multiplier) {
|
|
169
|
+
if (!Number.isFinite(multiplier)) return ''
|
|
170
|
+
return `×${String(Number(multiplier.toFixed(4)))}`
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
/**
|
|
174
|
+
* Ответ маршрута из снимка кэша.
|
|
175
|
+
*
|
|
176
|
+
* `fetchedAt` — время каталога, а не ответа маршрута: бейджи показывают тот
|
|
177
|
+
* каталог, который действительно прочитан. `stale` говорит, что кэш отдал
|
|
178
|
+
* прошлый удачный снимок после ошибки апстрима.
|
|
179
|
+
*
|
|
180
|
+
* @param {unknown} catalog — данные из `cache.get().data`.
|
|
181
|
+
* @param {{ fetchedAt?: number | null, stale?: boolean }} [meta] — метаданные кэша.
|
|
182
|
+
* @returns {{ models: Array<{ id: string, displayName: string, multiplier: number, fastMultiplier: number | null, contextWindow: number | null }>, providers: string[], fetchedAt: string | null, stale: boolean }}
|
|
183
|
+
*/
|
|
184
|
+
export function coefficientsPayload(catalog, meta = {}) {
|
|
185
|
+
const index = indexCoefficients(catalog)
|
|
186
|
+
const models = [...index.values()].map((model) => ({
|
|
187
|
+
id: model.id,
|
|
188
|
+
displayName: displayNameOf(model.id, /** @type {any} */ (model).displayName),
|
|
189
|
+
multiplier: model.multiplier,
|
|
190
|
+
fastMultiplier: model.fastMultiplier,
|
|
191
|
+
contextWindow: model.contextWindow,
|
|
192
|
+
}))
|
|
193
|
+
|
|
194
|
+
// id провайдеров, которым принадлежит кэшированный каталог: браузер не должен
|
|
195
|
+
// украшать бейджем модель чужого провайдера с тем же id.
|
|
196
|
+
const rawProviders = catalog !== null && typeof catalog === 'object' && Array.isArray(/** @type {any} */ (catalog).providers)
|
|
197
|
+
? /** @type {any} */ (catalog).providers
|
|
198
|
+
: []
|
|
199
|
+
const providers = []
|
|
200
|
+
for (const entry of rawProviders) {
|
|
201
|
+
const id = typeof entry === 'string' ? entry : typeof entry?.provider === 'string' ? entry.provider : ''
|
|
202
|
+
if (id.length > 0 && !providers.includes(id)) providers.push(id)
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
const fetchedAt = typeof meta.fetchedAt === 'number' && meta.fetchedAt > 0
|
|
206
|
+
? new Date(meta.fetchedAt).toISOString()
|
|
207
|
+
: null
|
|
208
|
+
|
|
209
|
+
return { models, providers, fetchedAt, stale: meta.stale === true }
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/**
|
|
213
|
+
* Одно чтение общего кэша на все одновременные запросы.
|
|
214
|
+
*
|
|
215
|
+
* Заодно это защита от позднего ответа: `dispose()` поднимает поколение, и
|
|
216
|
+
* чтение, начатое до выключения функции, уже не станет ответом. Сам кэш тоже
|
|
217
|
+
* сливает одновременные запросы, но здесь важно не открывать второе чтение
|
|
218
|
+
* вовсе — у маршрута бывает несколько одновременных читателей.
|
|
219
|
+
*
|
|
220
|
+
* @param {{ get: (options?: { force?: boolean }) => Promise<any> }} cache — общий кэш каталога.
|
|
221
|
+
* @returns {{ read: () => Promise<any | null>, dispose: () => void }}
|
|
222
|
+
*/
|
|
223
|
+
export function createCoefficientsReader(cache) {
|
|
224
|
+
/** @type {Promise<any> | null} */
|
|
225
|
+
let inflight = null
|
|
226
|
+
let generation = 0
|
|
227
|
+
|
|
228
|
+
return {
|
|
229
|
+
read() {
|
|
230
|
+
if (inflight !== null) return inflight
|
|
231
|
+
const startedGeneration = generation
|
|
232
|
+
const run = (async () => {
|
|
233
|
+
try {
|
|
234
|
+
const result = await cache.get()
|
|
235
|
+
// Поздний ответ: функцию успели выключить или перемонтировать.
|
|
236
|
+
if (startedGeneration !== generation) return null
|
|
237
|
+
return result
|
|
238
|
+
} finally {
|
|
239
|
+
if (inflight === run) inflight = null
|
|
240
|
+
}
|
|
241
|
+
})()
|
|
242
|
+
inflight = run
|
|
243
|
+
return run
|
|
244
|
+
},
|
|
245
|
+
dispose() {
|
|
246
|
+
generation += 1
|
|
247
|
+
inflight = null
|
|
248
|
+
},
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
/**
|
|
253
|
+
* Подключить функцию коэффициентов: `GET /cvc/coefficients`.
|
|
254
|
+
*
|
|
255
|
+
* Маршрут отдаёт форму §4 спеки. Ошибка апстрима не превращается в 500:
|
|
256
|
+
* бейджи просто не рисуются, а причина уходит в лог кодом (`CvcApiError.code`),
|
|
257
|
+
* потому что текст ошибки апстрима может содержать что угодно.
|
|
258
|
+
*
|
|
259
|
+
* @param {import('@deepseek-ai/cordis').Context} ctx — контекст плагина.
|
|
260
|
+
* @param {object} deps — общие зависимости каркаса (см. `lib/CONTRACT.js`).
|
|
261
|
+
* @returns {() => void} disposer, снимающий маршрут и ожидающие чтения.
|
|
262
|
+
*/
|
|
263
|
+
export function register(ctx, deps) {
|
|
264
|
+
const reader = createCoefficientsReader(deps.cache)
|
|
265
|
+
const disposeRoute = deps.route(ROUTE_PATH, async (req, res) => {
|
|
266
|
+
if (String(req.method ?? 'GET').toUpperCase() !== 'GET') {
|
|
267
|
+
deps.http.methodNotAllowed(res, ['GET'])
|
|
268
|
+
return
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
let result = null
|
|
272
|
+
let failedCode = ''
|
|
273
|
+
try {
|
|
274
|
+
result = await reader.read()
|
|
275
|
+
} catch (error) {
|
|
276
|
+
failedCode = typeof /** @type {any} */ (error)?.code === 'string' ? error.code : 'unavailable'
|
|
277
|
+
}
|
|
278
|
+
if (failedCode.length > 0) {
|
|
279
|
+
deps.log('warn', `coefficients: catalog read failed (${failedCode})`)
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
if (result === null) {
|
|
283
|
+
// Снимка ещё нет (или чтение отменено выключением функции): пустой каталог
|
|
284
|
+
// — честный ответ, бейджей не будет, но маршрут не врёт про 200.
|
|
285
|
+
deps.http.sendJson(res, 200, { models: [], providers: [], fetchedAt: null, stale: false })
|
|
286
|
+
return
|
|
287
|
+
}
|
|
288
|
+
deps.http.sendJson(res, 200, coefficientsPayload(result.data, {
|
|
289
|
+
fetchedAt: result.fetchedAt,
|
|
290
|
+
stale: result.stale === true,
|
|
291
|
+
}))
|
|
292
|
+
})
|
|
293
|
+
|
|
294
|
+
return () => {
|
|
295
|
+
reader.dispose()
|
|
296
|
+
disposeRoute()
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
/**
|
|
301
|
+
* Описание инструмента функции; у коэффициентов инструмента нет.
|
|
302
|
+
* @param {object} deps
|
|
303
|
+
* @returns {object | null}
|
|
304
|
+
*/
|
|
305
|
+
export function tool(deps) {
|
|
306
|
+
void deps
|
|
307
|
+
return null
|
|
308
|
+
}
|