dsh-plugin-lcsc 0.3.4 → 0.3.5
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/LICENSE +21 -21
- package/README.md +184 -181
- package/cn.js +808 -808
- package/cordis.patch.yml +28 -28
- package/data.js +1816 -1816
- package/icon.svg +9 -9
- package/index.js +2459 -2207
- package/locale/en.json +6 -6
- package/locale/zh.json +6 -6
- package/package.json +52 -52
package/index.js
CHANGED
|
@@ -1,2207 +1,2459 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* dsh-plugin-lcsc — requirement-driven LCSC part finder and BOM cost auditor
|
|
3
|
-
* for the DeepSeek Harness (DSH) Host.
|
|
4
|
-
*
|
|
5
|
-
* Two LLM-callable tools, deliberately kept small so the plugin does not crowd
|
|
6
|
-
* the model's context when several plugins are installed:
|
|
7
|
-
*
|
|
8
|
-
* - find_lcsc_parts requirement -> ranked candidates (price / stock /
|
|
9
|
-
* basic-vs-extended library / parameter match)
|
|
10
|
-
* - audit_lcsc_bom existing BOM -> cost, stock, library-type and
|
|
11
|
-
* JLCPCB extended-part feeder-fee audit
|
|
12
|
-
*
|
|
13
|
-
* The HTTP/cache/normalisation layer lives in `data.js`.
|
|
14
|
-
*
|
|
15
|
-
* Design rules:
|
|
16
|
-
* - hand-soldering is the default (`assembly: "hand"`): most DIY users buy
|
|
17
|
-
* parts and solder themselves, and SMT fee rules change over time.
|
|
18
|
-
* - `assembly: "smt"` opts into library-type awareness: JLCPCB charges
|
|
19
|
-
* USD 3 per extended part number per order (feeder loading), base library
|
|
20
|
-
* parts are free, so the fee is amortised into the unit price.
|
|
21
|
-
* - prices are never converted between currencies; each price carries its
|
|
22
|
-
* currency and source.
|
|
23
|
-
*/
|
|
24
|
-
|
|
25
|
-
import {
|
|
26
|
-
createLcscService,
|
|
27
|
-
normalizeConfig,
|
|
28
|
-
normalizeCode,
|
|
29
|
-
parseBomCsvDetailed,
|
|
30
|
-
pickTierPrice,
|
|
31
|
-
} from './data.js'
|
|
32
|
-
import { createCnAdapter } from './cn.js'
|
|
33
|
-
|
|
34
|
-
/** Plugin id used by the DSH loader. */
|
|
35
|
-
export const name = 'lcsc-parts'
|
|
36
|
-
/** Required services. */
|
|
37
|
-
export const inject = ['tools']
|
|
38
|
-
|
|
39
|
-
/** Default JLCPCB extended-part feeder loading fee, USD per unique part per order. */
|
|
40
|
-
export const EXTENDED_PART_FEE_USD = 3
|
|
41
|
-
/** Query-wide caps that keep a single tool call fast and cheap. */
|
|
42
|
-
const MAX_CANDIDATES = 8
|
|
43
|
-
const DEFAULT_LIMIT = 5
|
|
44
|
-
const SEARCH_PAGE_SIZE = 100
|
|
45
|
-
const MAX_CNY_LOOKUPS = 3
|
|
46
|
-
const MAX_AUDIT_CNY_LOOKUPS = 32
|
|
47
|
-
const MAX_ALTERNATIVE_LOOKUPS = 16
|
|
48
|
-
|
|
49
|
-
/* -------------------------------------------------------------------------- */
|
|
50
|
-
/* Small helpers */
|
|
51
|
-
/* -------------------------------------------------------------------------- */
|
|
52
|
-
|
|
53
|
-
/** @param {unknown} value @returns {value is Record<string, unknown>} */
|
|
54
|
-
function isRecord(value) {
|
|
55
|
-
return typeof value === 'object' && value !== null && !Array.isArray(value)
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
/** @param {unknown} value @returns {string | undefined} */
|
|
59
|
-
function asString(value) {
|
|
60
|
-
if (typeof value !== 'string') return undefined
|
|
61
|
-
const text = value.trim()
|
|
62
|
-
return text === '' ? undefined : text
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
/** @param {unknown} value @returns {number | undefined} */
|
|
66
|
-
function asNumber(value) {
|
|
67
|
-
if (typeof value === 'number' && Number.isFinite(value)) return value
|
|
68
|
-
if (typeof value === 'string' && value.trim() !== '') {
|
|
69
|
-
const parsed = Number(value)
|
|
70
|
-
if (Number.isFinite(parsed)) return parsed
|
|
71
|
-
}
|
|
72
|
-
return undefined
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
/** @param {unknown} value @returns {number | undefined} */
|
|
76
|
-
function asInteger(value) {
|
|
77
|
-
const number = asNumber(value)
|
|
78
|
-
if (number === undefined || !Number.isInteger(number)) return undefined
|
|
79
|
-
return number
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
/** @param {unknown} value @param {number} min @param {number} max @param {number} fallback */
|
|
83
|
-
function clampInteger(value, min, max, fallback) {
|
|
84
|
-
const number = asInteger(value)
|
|
85
|
-
if (number === undefined) return fallback
|
|
86
|
-
return Math.min(max, Math.max(min, number))
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
/** Round money-like values to avoid float noise in the tool output. */
|
|
90
|
-
function money(value) {
|
|
91
|
-
return Math.round(value * 1e6) / 1e6
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
/**
|
|
95
|
-
* DSH validates tool results for lossless JSON: plain `undefined` properties,
|
|
96
|
-
* NaN and Infinity are rejected. Normalise any result before returning it.
|
|
97
|
-
* @param {unknown} value
|
|
98
|
-
* @returns {unknown}
|
|
99
|
-
*/
|
|
100
|
-
function toLossless(value) {
|
|
101
|
-
if (value === undefined || value === null) return null
|
|
102
|
-
if (typeof value === 'number') {
|
|
103
|
-
if (!Number.isFinite(value)) return null
|
|
104
|
-
return Object.is(value, -0) ? 0 : value
|
|
105
|
-
}
|
|
106
|
-
if (typeof value === 'string' || typeof value === 'boolean') return value
|
|
107
|
-
if (Array.isArray(value)) return value.map((entry) => toLossless(entry))
|
|
108
|
-
if (typeof value === 'object') {
|
|
109
|
-
/** @type {Record<string, unknown>} */
|
|
110
|
-
const output = {}
|
|
111
|
-
for (const [key, entry] of Object.entries(value)) {
|
|
112
|
-
if (entry === undefined) continue
|
|
113
|
-
output[key] = toLossless(entry)
|
|
114
|
-
}
|
|
115
|
-
return output
|
|
116
|
-
}
|
|
117
|
-
return null
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
/**
|
|
121
|
-
* USD unit price of the highest-volume ladder tier (bulk / full-reel price).
|
|
122
|
-
* The Recording_card calibration relates the LCSC retail CNY price to this
|
|
123
|
-
* bulk-tier USD price (× 6.0), not to the small-quantity tier.
|
|
124
|
-
* @param {Record<string, unknown>} item
|
|
125
|
-
* @returns {number | undefined}
|
|
126
|
-
*/
|
|
127
|
-
export function bulkTierUsd(item) {
|
|
128
|
-
const tiers = Array.isArray(item.priceUsdTiers) ? item.priceUsdTiers : []
|
|
129
|
-
/** @type {{ qty: number, unit: number } | undefined} */
|
|
130
|
-
let best
|
|
131
|
-
for (const tier of tiers) {
|
|
132
|
-
if (!isRecord(tier)) continue
|
|
133
|
-
const qty = asNumber(tier.qty)
|
|
134
|
-
const unit = asNumber(tier.unit)
|
|
135
|
-
if (qty === undefined || unit === undefined) continue
|
|
136
|
-
if (best === undefined || qty > best.qty) best = { qty, unit }
|
|
137
|
-
}
|
|
138
|
-
return best?.unit
|
|
139
|
-
}
|
|
140
|
-
|
|
141
|
-
/**
|
|
142
|
-
* Reference CNY estimate = bulk-tier USD × empirical factor.
|
|
143
|
-
* @param {number | undefined} bulkUsd
|
|
144
|
-
* @param {number | undefined} factor
|
|
145
|
-
* @returns {number | undefined}
|
|
146
|
-
*/
|
|
147
|
-
export function estimateCnyFromUsd(bulkUsd, factor) {
|
|
148
|
-
const value = asNumber(bulkUsd)
|
|
149
|
-
const calibration = asNumber(factor)
|
|
150
|
-
if (value === undefined || calibration === undefined) return undefined
|
|
151
|
-
return money(value * calibration)
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
/** @param {number} ms @param {AbortSignal} [signal] */
|
|
155
|
-
function sleep(ms, signal) {
|
|
156
|
-
if (signal?.aborted === true) return Promise.reject(new Error('aborted'))
|
|
157
|
-
return new Promise((resolve, reject) => {
|
|
158
|
-
const timer = setTimeout(() => {
|
|
159
|
-
signal?.removeEventListener?.('abort', onAbort)
|
|
160
|
-
resolve()
|
|
161
|
-
}, ms)
|
|
162
|
-
function onAbort() {
|
|
163
|
-
clearTimeout(timer)
|
|
164
|
-
reject(new Error('aborted'))
|
|
165
|
-
}
|
|
166
|
-
signal?.addEventListener?.('abort', onAbort, { once: true })
|
|
167
|
-
})
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
/**
|
|
171
|
-
* Run `fn` over items with bounded concurrency; results keep input order.
|
|
172
|
-
* @template T, R
|
|
173
|
-
* @param {T[]} items
|
|
174
|
-
* @param {number} limit
|
|
175
|
-
* @param {(item: T, index: number) => Promise<R>} fn
|
|
176
|
-
* @returns {Promise<R[]>}
|
|
177
|
-
*/
|
|
178
|
-
async function mapLimit(items, limit, fn) {
|
|
179
|
-
const results = new Array(items.length)
|
|
180
|
-
let cursor = 0
|
|
181
|
-
const workers = Array.from({ length: Math.min(Math.max(1, limit), items.length) }, async () => {
|
|
182
|
-
while (cursor < items.length) {
|
|
183
|
-
const index = cursor
|
|
184
|
-
cursor += 1
|
|
185
|
-
results[index] = await fn(items[index], index)
|
|
186
|
-
}
|
|
187
|
-
})
|
|
188
|
-
await Promise.all(workers)
|
|
189
|
-
return results
|
|
190
|
-
}
|
|
191
|
-
|
|
192
|
-
/* -------------------------------------------------------------------------- */
|
|
193
|
-
/* Requirement parsing */
|
|
194
|
-
/* -------------------------------------------------------------------------- */
|
|
195
|
-
|
|
196
|
-
/** Chinese / mixed category words mapped to English search hints (longest first). */
|
|
197
|
-
const CATEGORY_TERMS = [
|
|
198
|
-
['自恢复保险丝', ['ptc resettable fuse']],
|
|
199
|
-
['贴片电容', ['capacitor']],
|
|
200
|
-
['贴片电阻', ['resistor']],
|
|
201
|
-
['发光二极管', ['led']],
|
|
202
|
-
['锂电池充电', ['battery charger']],
|
|
203
|
-
['单节锂电池', ['battery charger']],
|
|
204
|
-
['充电ic', ['battery charger']],
|
|
205
|
-
['充电 ic', ['battery charger']],
|
|
206
|
-
['充电芯片', ['battery charger']],
|
|
207
|
-
['静态保护', ['esd']],
|
|
208
|
-
['静电保护', ['esd']],
|
|
209
|
-
['硅麦', ['microphone']],
|
|
210
|
-
['
|
|
211
|
-
['
|
|
212
|
-
['
|
|
213
|
-
['
|
|
214
|
-
['
|
|
215
|
-
['
|
|
216
|
-
['
|
|
217
|
-
['
|
|
218
|
-
['
|
|
219
|
-
['
|
|
220
|
-
['
|
|
221
|
-
['
|
|
222
|
-
['
|
|
223
|
-
['
|
|
224
|
-
['
|
|
225
|
-
['
|
|
226
|
-
['
|
|
227
|
-
['
|
|
228
|
-
['
|
|
229
|
-
['
|
|
230
|
-
['
|
|
231
|
-
['
|
|
232
|
-
['
|
|
233
|
-
['
|
|
234
|
-
['
|
|
235
|
-
['
|
|
236
|
-
['
|
|
237
|
-
['
|
|
238
|
-
['
|
|
239
|
-
['
|
|
240
|
-
['
|
|
241
|
-
['
|
|
242
|
-
['
|
|
243
|
-
['
|
|
244
|
-
['
|
|
245
|
-
['
|
|
246
|
-
['
|
|
247
|
-
['
|
|
248
|
-
['
|
|
249
|
-
['
|
|
250
|
-
['
|
|
251
|
-
['
|
|
252
|
-
['
|
|
253
|
-
['
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
]
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
}
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
const
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
]
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
const
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
*
|
|
344
|
-
* @
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
const
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
const
|
|
367
|
-
const
|
|
368
|
-
if (
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
}
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
const
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
}
|
|
444
|
-
|
|
445
|
-
const
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
'
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
//
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
.
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
.trim()
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
}
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
const
|
|
567
|
-
if (
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
}
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
}
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
*
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
}
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
if (
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
}
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
const
|
|
756
|
-
if (
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
.
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
}
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
808
|
-
*
|
|
809
|
-
*
|
|
810
|
-
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
819
|
-
|
|
820
|
-
|
|
821
|
-
|
|
822
|
-
|
|
823
|
-
|
|
824
|
-
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
|
|
832
|
-
const
|
|
833
|
-
|
|
834
|
-
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
}
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
|
|
842
|
-
|
|
843
|
-
|
|
844
|
-
}
|
|
845
|
-
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
|
|
863
|
-
|
|
864
|
-
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
|
|
868
|
-
|
|
869
|
-
|
|
870
|
-
|
|
871
|
-
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
880
|
-
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
|
|
886
|
-
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
|
|
893
|
-
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
}
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
|
|
914
|
-
|
|
915
|
-
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
const
|
|
920
|
-
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
|
|
933
|
-
|
|
934
|
-
|
|
935
|
-
|
|
936
|
-
}
|
|
937
|
-
|
|
938
|
-
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
|
|
979
|
-
)
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
const
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
}
|
|
1017
|
-
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
|
|
1021
|
-
|
|
1022
|
-
|
|
1023
|
-
|
|
1024
|
-
|
|
1025
|
-
|
|
1026
|
-
|
|
1027
|
-
|
|
1028
|
-
|
|
1029
|
-
|
|
1030
|
-
|
|
1031
|
-
|
|
1032
|
-
|
|
1033
|
-
|
|
1034
|
-
|
|
1035
|
-
|
|
1036
|
-
|
|
1037
|
-
|
|
1038
|
-
|
|
1039
|
-
|
|
1040
|
-
|
|
1041
|
-
|
|
1042
|
-
|
|
1043
|
-
|
|
1044
|
-
|
|
1045
|
-
|
|
1046
|
-
|
|
1047
|
-
|
|
1048
|
-
|
|
1049
|
-
|
|
1050
|
-
|
|
1051
|
-
|
|
1052
|
-
|
|
1053
|
-
|
|
1054
|
-
|
|
1055
|
-
|
|
1056
|
-
|
|
1057
|
-
|
|
1058
|
-
|
|
1059
|
-
|
|
1060
|
-
|
|
1061
|
-
|
|
1062
|
-
|
|
1063
|
-
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
|
|
1067
|
-
|
|
1068
|
-
|
|
1069
|
-
|
|
1070
|
-
|
|
1071
|
-
|
|
1072
|
-
|
|
1073
|
-
|
|
1074
|
-
|
|
1075
|
-
|
|
1076
|
-
|
|
1077
|
-
|
|
1078
|
-
|
|
1079
|
-
|
|
1080
|
-
|
|
1081
|
-
|
|
1082
|
-
|
|
1083
|
-
|
|
1084
|
-
|
|
1085
|
-
|
|
1086
|
-
|
|
1087
|
-
|
|
1088
|
-
|
|
1089
|
-
|
|
1090
|
-
|
|
1091
|
-
|
|
1092
|
-
|
|
1093
|
-
|
|
1094
|
-
|
|
1095
|
-
|
|
1096
|
-
if (
|
|
1097
|
-
|
|
1098
|
-
|
|
1099
|
-
|
|
1100
|
-
|
|
1101
|
-
|
|
1102
|
-
|
|
1103
|
-
|
|
1104
|
-
|
|
1105
|
-
|
|
1106
|
-
|
|
1107
|
-
|
|
1108
|
-
|
|
1109
|
-
|
|
1110
|
-
|
|
1111
|
-
|
|
1112
|
-
|
|
1113
|
-
|
|
1114
|
-
//
|
|
1115
|
-
|
|
1116
|
-
|
|
1117
|
-
|
|
1118
|
-
|
|
1119
|
-
|
|
1120
|
-
|
|
1121
|
-
|
|
1122
|
-
|
|
1123
|
-
|
|
1124
|
-
|
|
1125
|
-
|
|
1126
|
-
|
|
1127
|
-
|
|
1128
|
-
|
|
1129
|
-
|
|
1130
|
-
|
|
1131
|
-
|
|
1132
|
-
|
|
1133
|
-
|
|
1134
|
-
|
|
1135
|
-
|
|
1136
|
-
|
|
1137
|
-
|
|
1138
|
-
|
|
1139
|
-
|
|
1140
|
-
|
|
1141
|
-
|
|
1142
|
-
|
|
1143
|
-
|
|
1144
|
-
|
|
1145
|
-
|
|
1146
|
-
|
|
1147
|
-
|
|
1148
|
-
|
|
1149
|
-
|
|
1150
|
-
|
|
1151
|
-
|
|
1152
|
-
|
|
1153
|
-
|
|
1154
|
-
|
|
1155
|
-
|
|
1156
|
-
|
|
1157
|
-
|
|
1158
|
-
|
|
1159
|
-
|
|
1160
|
-
|
|
1161
|
-
|
|
1162
|
-
|
|
1163
|
-
|
|
1164
|
-
|
|
1165
|
-
|
|
1166
|
-
|
|
1167
|
-
|
|
1168
|
-
|
|
1169
|
-
|
|
1170
|
-
|
|
1171
|
-
|
|
1172
|
-
|
|
1173
|
-
|
|
1174
|
-
|
|
1175
|
-
|
|
1176
|
-
|
|
1177
|
-
|
|
1178
|
-
|
|
1179
|
-
|
|
1180
|
-
|
|
1181
|
-
|
|
1182
|
-
|
|
1183
|
-
|
|
1184
|
-
|
|
1185
|
-
|
|
1186
|
-
|
|
1187
|
-
|
|
1188
|
-
|
|
1189
|
-
|
|
1190
|
-
|
|
1191
|
-
|
|
1192
|
-
|
|
1193
|
-
|
|
1194
|
-
|
|
1195
|
-
|
|
1196
|
-
|
|
1197
|
-
|
|
1198
|
-
|
|
1199
|
-
|
|
1200
|
-
|
|
1201
|
-
|
|
1202
|
-
|
|
1203
|
-
|
|
1204
|
-
|
|
1205
|
-
|
|
1206
|
-
|
|
1207
|
-
|
|
1208
|
-
|
|
1209
|
-
|
|
1210
|
-
|
|
1211
|
-
|
|
1212
|
-
|
|
1213
|
-
|
|
1214
|
-
|
|
1215
|
-
|
|
1216
|
-
|
|
1217
|
-
|
|
1218
|
-
|
|
1219
|
-
|
|
1220
|
-
|
|
1221
|
-
|
|
1222
|
-
|
|
1223
|
-
|
|
1224
|
-
|
|
1225
|
-
)
|
|
1226
|
-
|
|
1227
|
-
|
|
1228
|
-
|
|
1229
|
-
|
|
1230
|
-
|
|
1231
|
-
}
|
|
1232
|
-
|
|
1233
|
-
|
|
1234
|
-
|
|
1235
|
-
|
|
1236
|
-
|
|
1237
|
-
|
|
1238
|
-
|
|
1239
|
-
|
|
1240
|
-
|
|
1241
|
-
|
|
1242
|
-
|
|
1243
|
-
|
|
1244
|
-
|
|
1245
|
-
|
|
1246
|
-
|
|
1247
|
-
|
|
1248
|
-
|
|
1249
|
-
|
|
1250
|
-
|
|
1251
|
-
|
|
1252
|
-
|
|
1253
|
-
}
|
|
1254
|
-
|
|
1255
|
-
|
|
1256
|
-
|
|
1257
|
-
|
|
1258
|
-
|
|
1259
|
-
|
|
1260
|
-
|
|
1261
|
-
|
|
1262
|
-
|
|
1263
|
-
|
|
1264
|
-
|
|
1265
|
-
|
|
1266
|
-
|
|
1267
|
-
|
|
1268
|
-
|
|
1269
|
-
|
|
1270
|
-
|
|
1271
|
-
|
|
1272
|
-
|
|
1273
|
-
|
|
1274
|
-
|
|
1275
|
-
|
|
1276
|
-
|
|
1277
|
-
|
|
1278
|
-
|
|
1279
|
-
|
|
1280
|
-
|
|
1281
|
-
|
|
1282
|
-
|
|
1283
|
-
|
|
1284
|
-
|
|
1285
|
-
|
|
1286
|
-
|
|
1287
|
-
|
|
1288
|
-
|
|
1289
|
-
|
|
1290
|
-
|
|
1291
|
-
|
|
1292
|
-
|
|
1293
|
-
|
|
1294
|
-
|
|
1295
|
-
|
|
1296
|
-
|
|
1297
|
-
|
|
1298
|
-
|
|
1299
|
-
|
|
1300
|
-
|
|
1301
|
-
|
|
1302
|
-
|
|
1303
|
-
|
|
1304
|
-
|
|
1305
|
-
|
|
1306
|
-
|
|
1307
|
-
|
|
1308
|
-
|
|
1309
|
-
|
|
1310
|
-
|
|
1311
|
-
|
|
1312
|
-
|
|
1313
|
-
|
|
1314
|
-
|
|
1315
|
-
|
|
1316
|
-
|
|
1317
|
-
|
|
1318
|
-
|
|
1319
|
-
|
|
1320
|
-
|
|
1321
|
-
|
|
1322
|
-
|
|
1323
|
-
|
|
1324
|
-
|
|
1325
|
-
|
|
1326
|
-
|
|
1327
|
-
|
|
1328
|
-
|
|
1329
|
-
|
|
1330
|
-
|
|
1331
|
-
|
|
1332
|
-
|
|
1333
|
-
|
|
1334
|
-
|
|
1335
|
-
|
|
1336
|
-
|
|
1337
|
-
|
|
1338
|
-
|
|
1339
|
-
|
|
1340
|
-
|
|
1341
|
-
|
|
1342
|
-
|
|
1343
|
-
|
|
1344
|
-
|
|
1345
|
-
|
|
1346
|
-
|
|
1347
|
-
|
|
1348
|
-
|
|
1349
|
-
|
|
1350
|
-
|
|
1351
|
-
|
|
1352
|
-
|
|
1353
|
-
|
|
1354
|
-
|
|
1355
|
-
|
|
1356
|
-
|
|
1357
|
-
|
|
1358
|
-
|
|
1359
|
-
|
|
1360
|
-
|
|
1361
|
-
|
|
1362
|
-
|
|
1363
|
-
|
|
1364
|
-
|
|
1365
|
-
|
|
1366
|
-
|
|
1367
|
-
|
|
1368
|
-
|
|
1369
|
-
|
|
1370
|
-
|
|
1371
|
-
|
|
1372
|
-
|
|
1373
|
-
|
|
1374
|
-
|
|
1375
|
-
|
|
1376
|
-
|
|
1377
|
-
|
|
1378
|
-
|
|
1379
|
-
|
|
1380
|
-
|
|
1381
|
-
|
|
1382
|
-
|
|
1383
|
-
|
|
1384
|
-
|
|
1385
|
-
|
|
1386
|
-
|
|
1387
|
-
|
|
1388
|
-
|
|
1389
|
-
|
|
1390
|
-
*/
|
|
1391
|
-
|
|
1392
|
-
|
|
1393
|
-
|
|
1394
|
-
|
|
1395
|
-
|
|
1396
|
-
|
|
1397
|
-
|
|
1398
|
-
|
|
1399
|
-
|
|
1400
|
-
|
|
1401
|
-
|
|
1402
|
-
|
|
1403
|
-
|
|
1404
|
-
|
|
1405
|
-
|
|
1406
|
-
|
|
1407
|
-
|
|
1408
|
-
|
|
1409
|
-
|
|
1410
|
-
|
|
1411
|
-
|
|
1412
|
-
|
|
1413
|
-
|
|
1414
|
-
|
|
1415
|
-
|
|
1416
|
-
|
|
1417
|
-
|
|
1418
|
-
|
|
1419
|
-
|
|
1420
|
-
|
|
1421
|
-
|
|
1422
|
-
|
|
1423
|
-
|
|
1424
|
-
|
|
1425
|
-
|
|
1426
|
-
|
|
1427
|
-
|
|
1428
|
-
|
|
1429
|
-
|
|
1430
|
-
|
|
1431
|
-
|
|
1432
|
-
|
|
1433
|
-
|
|
1434
|
-
|
|
1435
|
-
|
|
1436
|
-
|
|
1437
|
-
|
|
1438
|
-
|
|
1439
|
-
|
|
1440
|
-
|
|
1441
|
-
|
|
1442
|
-
|
|
1443
|
-
|
|
1444
|
-
|
|
1445
|
-
|
|
1446
|
-
|
|
1447
|
-
|
|
1448
|
-
|
|
1449
|
-
|
|
1450
|
-
|
|
1451
|
-
|
|
1452
|
-
|
|
1453
|
-
|
|
1454
|
-
|
|
1455
|
-
|
|
1456
|
-
|
|
1457
|
-
|
|
1458
|
-
|
|
1459
|
-
|
|
1460
|
-
|
|
1461
|
-
}
|
|
1462
|
-
|
|
1463
|
-
/**
|
|
1464
|
-
|
|
1465
|
-
|
|
1466
|
-
|
|
1467
|
-
|
|
1468
|
-
|
|
1469
|
-
|
|
1470
|
-
|
|
1471
|
-
|
|
1472
|
-
|
|
1473
|
-
|
|
1474
|
-
|
|
1475
|
-
|
|
1476
|
-
|
|
1477
|
-
|
|
1478
|
-
|
|
1479
|
-
|
|
1480
|
-
|
|
1481
|
-
|
|
1482
|
-
|
|
1483
|
-
|
|
1484
|
-
|
|
1485
|
-
|
|
1486
|
-
|
|
1487
|
-
|
|
1488
|
-
|
|
1489
|
-
|
|
1490
|
-
|
|
1491
|
-
|
|
1492
|
-
|
|
1493
|
-
|
|
1494
|
-
|
|
1495
|
-
|
|
1496
|
-
|
|
1497
|
-
|
|
1498
|
-
|
|
1499
|
-
|
|
1500
|
-
|
|
1501
|
-
|
|
1502
|
-
|
|
1503
|
-
|
|
1504
|
-
|
|
1505
|
-
|
|
1506
|
-
|
|
1507
|
-
|
|
1508
|
-
|
|
1509
|
-
|
|
1510
|
-
|
|
1511
|
-
|
|
1512
|
-
|
|
1513
|
-
|
|
1514
|
-
|
|
1515
|
-
|
|
1516
|
-
|
|
1517
|
-
|
|
1518
|
-
|
|
1519
|
-
|
|
1520
|
-
|
|
1521
|
-
|
|
1522
|
-
|
|
1523
|
-
|
|
1524
|
-
|
|
1525
|
-
|
|
1526
|
-
|
|
1527
|
-
|
|
1528
|
-
|
|
1529
|
-
|
|
1530
|
-
|
|
1531
|
-
}
|
|
1532
|
-
|
|
1533
|
-
|
|
1534
|
-
|
|
1535
|
-
|
|
1536
|
-
|
|
1537
|
-
|
|
1538
|
-
|
|
1539
|
-
|
|
1540
|
-
|
|
1541
|
-
|
|
1542
|
-
|
|
1543
|
-
|
|
1544
|
-
|
|
1545
|
-
|
|
1546
|
-
|
|
1547
|
-
|
|
1548
|
-
|
|
1549
|
-
|
|
1550
|
-
|
|
1551
|
-
|
|
1552
|
-
|
|
1553
|
-
|
|
1554
|
-
|
|
1555
|
-
|
|
1556
|
-
|
|
1557
|
-
|
|
1558
|
-
|
|
1559
|
-
|
|
1560
|
-
|
|
1561
|
-
}
|
|
1562
|
-
|
|
1563
|
-
|
|
1564
|
-
|
|
1565
|
-
|
|
1566
|
-
|
|
1567
|
-
|
|
1568
|
-
|
|
1569
|
-
|
|
1570
|
-
|
|
1571
|
-
|
|
1572
|
-
|
|
1573
|
-
|
|
1574
|
-
)
|
|
1575
|
-
|
|
1576
|
-
|
|
1577
|
-
|
|
1578
|
-
|
|
1579
|
-
|
|
1580
|
-
|
|
1581
|
-
|
|
1582
|
-
|
|
1583
|
-
|
|
1584
|
-
|
|
1585
|
-
|
|
1586
|
-
|
|
1587
|
-
|
|
1588
|
-
|
|
1589
|
-
|
|
1590
|
-
|
|
1591
|
-
|
|
1592
|
-
|
|
1593
|
-
|
|
1594
|
-
|
|
1595
|
-
|
|
1596
|
-
|
|
1597
|
-
|
|
1598
|
-
|
|
1599
|
-
|
|
1600
|
-
|
|
1601
|
-
|
|
1602
|
-
|
|
1603
|
-
|
|
1604
|
-
|
|
1605
|
-
|
|
1606
|
-
|
|
1607
|
-
|
|
1608
|
-
|
|
1609
|
-
const
|
|
1610
|
-
|
|
1611
|
-
|
|
1612
|
-
|
|
1613
|
-
|
|
1614
|
-
|
|
1615
|
-
|
|
1616
|
-
|
|
1617
|
-
|
|
1618
|
-
const
|
|
1619
|
-
|
|
1620
|
-
const
|
|
1621
|
-
const
|
|
1622
|
-
|
|
1623
|
-
|
|
1624
|
-
|
|
1625
|
-
|
|
1626
|
-
|
|
1627
|
-
|
|
1628
|
-
|
|
1629
|
-
|
|
1630
|
-
|
|
1631
|
-
|
|
1632
|
-
|
|
1633
|
-
|
|
1634
|
-
|
|
1635
|
-
|
|
1636
|
-
|
|
1637
|
-
|
|
1638
|
-
|
|
1639
|
-
|
|
1640
|
-
|
|
1641
|
-
|
|
1642
|
-
|
|
1643
|
-
|
|
1644
|
-
|
|
1645
|
-
|
|
1646
|
-
|
|
1647
|
-
|
|
1648
|
-
|
|
1649
|
-
|
|
1650
|
-
|
|
1651
|
-
|
|
1652
|
-
|
|
1653
|
-
|
|
1654
|
-
|
|
1655
|
-
|
|
1656
|
-
|
|
1657
|
-
|
|
1658
|
-
|
|
1659
|
-
|
|
1660
|
-
|
|
1661
|
-
|
|
1662
|
-
|
|
1663
|
-
|
|
1664
|
-
|
|
1665
|
-
|
|
1666
|
-
|
|
1667
|
-
|
|
1668
|
-
|
|
1669
|
-
const
|
|
1670
|
-
|
|
1671
|
-
|
|
1672
|
-
|
|
1673
|
-
|
|
1674
|
-
|
|
1675
|
-
const
|
|
1676
|
-
const
|
|
1677
|
-
|
|
1678
|
-
|
|
1679
|
-
|
|
1680
|
-
|
|
1681
|
-
|
|
1682
|
-
|
|
1683
|
-
|
|
1684
|
-
|
|
1685
|
-
|
|
1686
|
-
|
|
1687
|
-
|
|
1688
|
-
|
|
1689
|
-
|
|
1690
|
-
|
|
1691
|
-
|
|
1692
|
-
|
|
1693
|
-
|
|
1694
|
-
|
|
1695
|
-
|
|
1696
|
-
|
|
1697
|
-
|
|
1698
|
-
|
|
1699
|
-
|
|
1700
|
-
|
|
1701
|
-
|
|
1702
|
-
|
|
1703
|
-
|
|
1704
|
-
|
|
1705
|
-
|
|
1706
|
-
|
|
1707
|
-
|
|
1708
|
-
|
|
1709
|
-
|
|
1710
|
-
|
|
1711
|
-
|
|
1712
|
-
|
|
1713
|
-
|
|
1714
|
-
|
|
1715
|
-
|
|
1716
|
-
|
|
1717
|
-
|
|
1718
|
-
|
|
1719
|
-
|
|
1720
|
-
|
|
1721
|
-
|
|
1722
|
-
|
|
1723
|
-
|
|
1724
|
-
|
|
1725
|
-
|
|
1726
|
-
|
|
1727
|
-
|
|
1728
|
-
|
|
1729
|
-
|
|
1730
|
-
|
|
1731
|
-
|
|
1732
|
-
|
|
1733
|
-
|
|
1734
|
-
|
|
1735
|
-
|
|
1736
|
-
|
|
1737
|
-
|
|
1738
|
-
|
|
1739
|
-
|
|
1740
|
-
|
|
1741
|
-
|
|
1742
|
-
|
|
1743
|
-
|
|
1744
|
-
|
|
1745
|
-
|
|
1746
|
-
|
|
1747
|
-
const
|
|
1748
|
-
|
|
1749
|
-
|
|
1750
|
-
|
|
1751
|
-
|
|
1752
|
-
|
|
1753
|
-
|
|
1754
|
-
|
|
1755
|
-
|
|
1756
|
-
|
|
1757
|
-
|
|
1758
|
-
|
|
1759
|
-
|
|
1760
|
-
|
|
1761
|
-
|
|
1762
|
-
|
|
1763
|
-
|
|
1764
|
-
|
|
1765
|
-
|
|
1766
|
-
|
|
1767
|
-
|
|
1768
|
-
|
|
1769
|
-
|
|
1770
|
-
|
|
1771
|
-
|
|
1772
|
-
|
|
1773
|
-
|
|
1774
|
-
|
|
1775
|
-
|
|
1776
|
-
|
|
1777
|
-
|
|
1778
|
-
|
|
1779
|
-
|
|
1780
|
-
|
|
1781
|
-
|
|
1782
|
-
|
|
1783
|
-
|
|
1784
|
-
|
|
1785
|
-
|
|
1786
|
-
|
|
1787
|
-
|
|
1788
|
-
|
|
1789
|
-
|
|
1790
|
-
|
|
1791
|
-
|
|
1792
|
-
|
|
1793
|
-
|
|
1794
|
-
|
|
1795
|
-
|
|
1796
|
-
|
|
1797
|
-
|
|
1798
|
-
|
|
1799
|
-
|
|
1800
|
-
|
|
1801
|
-
|
|
1802
|
-
|
|
1803
|
-
|
|
1804
|
-
|
|
1805
|
-
|
|
1806
|
-
|
|
1807
|
-
|
|
1808
|
-
|
|
1809
|
-
|
|
1810
|
-
|
|
1811
|
-
|
|
1812
|
-
|
|
1813
|
-
|
|
1814
|
-
|
|
1815
|
-
|
|
1816
|
-
}
|
|
1817
|
-
|
|
1818
|
-
|
|
1819
|
-
|
|
1820
|
-
|
|
1821
|
-
|
|
1822
|
-
|
|
1823
|
-
|
|
1824
|
-
|
|
1825
|
-
|
|
1826
|
-
|
|
1827
|
-
|
|
1828
|
-
|
|
1829
|
-
|
|
1830
|
-
|
|
1831
|
-
|
|
1832
|
-
|
|
1833
|
-
|
|
1834
|
-
|
|
1835
|
-
|
|
1836
|
-
|
|
1837
|
-
|
|
1838
|
-
|
|
1839
|
-
|
|
1840
|
-
|
|
1841
|
-
|
|
1842
|
-
|
|
1843
|
-
|
|
1844
|
-
|
|
1845
|
-
|
|
1846
|
-
|
|
1847
|
-
|
|
1848
|
-
|
|
1849
|
-
|
|
1850
|
-
|
|
1851
|
-
assembly === '
|
|
1852
|
-
|
|
1853
|
-
|
|
1854
|
-
|
|
1855
|
-
|
|
1856
|
-
|
|
1857
|
-
|
|
1858
|
-
|
|
1859
|
-
|
|
1860
|
-
|
|
1861
|
-
|
|
1862
|
-
|
|
1863
|
-
|
|
1864
|
-
|
|
1865
|
-
|
|
1866
|
-
|
|
1867
|
-
|
|
1868
|
-
|
|
1869
|
-
|
|
1870
|
-
|
|
1871
|
-
|
|
1872
|
-
|
|
1873
|
-
|
|
1874
|
-
|
|
1875
|
-
|
|
1876
|
-
|
|
1877
|
-
|
|
1878
|
-
|
|
1879
|
-
|
|
1880
|
-
|
|
1881
|
-
|
|
1882
|
-
|
|
1883
|
-
|
|
1884
|
-
|
|
1885
|
-
|
|
1886
|
-
|
|
1887
|
-
|
|
1888
|
-
|
|
1889
|
-
|
|
1890
|
-
|
|
1891
|
-
|
|
1892
|
-
|
|
1893
|
-
|
|
1894
|
-
|
|
1895
|
-
|
|
1896
|
-
|
|
1897
|
-
|
|
1898
|
-
|
|
1899
|
-
|
|
1900
|
-
|
|
1901
|
-
|
|
1902
|
-
|
|
1903
|
-
|
|
1904
|
-
|
|
1905
|
-
|
|
1906
|
-
|
|
1907
|
-
|
|
1908
|
-
|
|
1909
|
-
|
|
1910
|
-
|
|
1911
|
-
|
|
1912
|
-
|
|
1913
|
-
|
|
1914
|
-
|
|
1915
|
-
|
|
1916
|
-
|
|
1917
|
-
|
|
1918
|
-
|
|
1919
|
-
|
|
1920
|
-
|
|
1921
|
-
|
|
1922
|
-
|
|
1923
|
-
|
|
1924
|
-
|
|
1925
|
-
|
|
1926
|
-
|
|
1927
|
-
|
|
1928
|
-
|
|
1929
|
-
|
|
1930
|
-
|
|
1931
|
-
const
|
|
1932
|
-
const
|
|
1933
|
-
|
|
1934
|
-
|
|
1935
|
-
|
|
1936
|
-
|
|
1937
|
-
|
|
1938
|
-
|
|
1939
|
-
|
|
1940
|
-
|
|
1941
|
-
const
|
|
1942
|
-
|
|
1943
|
-
|
|
1944
|
-
|
|
1945
|
-
|
|
1946
|
-
|
|
1947
|
-
|
|
1948
|
-
|
|
1949
|
-
|
|
1950
|
-
|
|
1951
|
-
|
|
1952
|
-
|
|
1953
|
-
|
|
1954
|
-
|
|
1955
|
-
|
|
1956
|
-
|
|
1957
|
-
|
|
1958
|
-
|
|
1959
|
-
|
|
1960
|
-
|
|
1961
|
-
const
|
|
1962
|
-
|
|
1963
|
-
|
|
1964
|
-
|
|
1965
|
-
|
|
1966
|
-
|
|
1967
|
-
|
|
1968
|
-
|
|
1969
|
-
|
|
1970
|
-
|
|
1971
|
-
|
|
1972
|
-
|
|
1973
|
-
|
|
1974
|
-
|
|
1975
|
-
|
|
1976
|
-
|
|
1977
|
-
const
|
|
1978
|
-
const
|
|
1979
|
-
|
|
1980
|
-
|
|
1981
|
-
|
|
1982
|
-
|
|
1983
|
-
|
|
1984
|
-
|
|
1985
|
-
|
|
1986
|
-
|
|
1987
|
-
|
|
1988
|
-
|
|
1989
|
-
|
|
1990
|
-
|
|
1991
|
-
|
|
1992
|
-
|
|
1993
|
-
|
|
1994
|
-
|
|
1995
|
-
|
|
1996
|
-
|
|
1997
|
-
|
|
1998
|
-
|
|
1999
|
-
|
|
2000
|
-
|
|
2001
|
-
|
|
2002
|
-
}
|
|
2003
|
-
|
|
2004
|
-
|
|
2005
|
-
|
|
2006
|
-
|
|
2007
|
-
|
|
2008
|
-
|
|
2009
|
-
|
|
2010
|
-
|
|
2011
|
-
|
|
2012
|
-
|
|
2013
|
-
|
|
2014
|
-
|
|
2015
|
-
|
|
2016
|
-
|
|
2017
|
-
|
|
2018
|
-
|
|
2019
|
-
|
|
2020
|
-
|
|
2021
|
-
|
|
2022
|
-
|
|
2023
|
-
|
|
2024
|
-
|
|
2025
|
-
|
|
2026
|
-
|
|
2027
|
-
|
|
2028
|
-
|
|
2029
|
-
|
|
2030
|
-
|
|
2031
|
-
|
|
2032
|
-
|
|
2033
|
-
|
|
2034
|
-
|
|
2035
|
-
|
|
2036
|
-
|
|
2037
|
-
|
|
2038
|
-
|
|
2039
|
-
|
|
2040
|
-
|
|
2041
|
-
|
|
2042
|
-
|
|
2043
|
-
|
|
2044
|
-
|
|
2045
|
-
|
|
2046
|
-
|
|
2047
|
-
|
|
2048
|
-
|
|
2049
|
-
|
|
2050
|
-
|
|
2051
|
-
|
|
2052
|
-
|
|
2053
|
-
|
|
2054
|
-
|
|
2055
|
-
|
|
2056
|
-
|
|
2057
|
-
|
|
2058
|
-
},
|
|
2059
|
-
|
|
2060
|
-
|
|
2061
|
-
|
|
2062
|
-
|
|
2063
|
-
|
|
2064
|
-
|
|
2065
|
-
|
|
2066
|
-
|
|
2067
|
-
|
|
2068
|
-
|
|
2069
|
-
|
|
2070
|
-
|
|
2071
|
-
|
|
2072
|
-
|
|
2073
|
-
|
|
2074
|
-
|
|
2075
|
-
|
|
2076
|
-
|
|
2077
|
-
|
|
2078
|
-
|
|
2079
|
-
|
|
2080
|
-
|
|
2081
|
-
|
|
2082
|
-
|
|
2083
|
-
|
|
2084
|
-
return
|
|
2085
|
-
}
|
|
2086
|
-
|
|
2087
|
-
|
|
2088
|
-
|
|
2089
|
-
|
|
2090
|
-
|
|
2091
|
-
|
|
2092
|
-
|
|
2093
|
-
|
|
2094
|
-
|
|
2095
|
-
|
|
2096
|
-
|
|
2097
|
-
|
|
2098
|
-
|
|
2099
|
-
|
|
2100
|
-
|
|
2101
|
-
|
|
2102
|
-
|
|
2103
|
-
|
|
2104
|
-
|
|
2105
|
-
|
|
2106
|
-
|
|
2107
|
-
|
|
2108
|
-
|
|
2109
|
-
|
|
2110
|
-
|
|
2111
|
-
|
|
2112
|
-
|
|
2113
|
-
|
|
2114
|
-
|
|
2115
|
-
|
|
2116
|
-
|
|
2117
|
-
|
|
2118
|
-
|
|
2119
|
-
|
|
2120
|
-
|
|
2121
|
-
|
|
2122
|
-
|
|
2123
|
-
|
|
2124
|
-
|
|
2125
|
-
|
|
2126
|
-
|
|
2127
|
-
|
|
2128
|
-
|
|
2129
|
-
|
|
2130
|
-
|
|
2131
|
-
|
|
2132
|
-
|
|
2133
|
-
|
|
2134
|
-
|
|
2135
|
-
|
|
2136
|
-
|
|
2137
|
-
|
|
2138
|
-
|
|
2139
|
-
|
|
2140
|
-
|
|
2141
|
-
|
|
2142
|
-
|
|
2143
|
-
|
|
2144
|
-
|
|
2145
|
-
|
|
2146
|
-
|
|
2147
|
-
|
|
2148
|
-
|
|
2149
|
-
|
|
2150
|
-
|
|
2151
|
-
|
|
2152
|
-
|
|
2153
|
-
|
|
2154
|
-
|
|
2155
|
-
|
|
2156
|
-
|
|
2157
|
-
|
|
2158
|
-
|
|
2159
|
-
|
|
2160
|
-
|
|
2161
|
-
|
|
2162
|
-
|
|
2163
|
-
|
|
2164
|
-
|
|
2165
|
-
|
|
2166
|
-
|
|
2167
|
-
|
|
2168
|
-
|
|
2169
|
-
|
|
2170
|
-
|
|
2171
|
-
|
|
2172
|
-
|
|
2173
|
-
|
|
2174
|
-
|
|
2175
|
-
|
|
2176
|
-
|
|
2177
|
-
|
|
2178
|
-
}
|
|
2179
|
-
|
|
2180
|
-
|
|
2181
|
-
|
|
2182
|
-
}
|
|
2183
|
-
|
|
2184
|
-
|
|
2185
|
-
|
|
2186
|
-
|
|
2187
|
-
|
|
2188
|
-
|
|
2189
|
-
})
|
|
2190
|
-
for (const
|
|
2191
|
-
|
|
2192
|
-
|
|
2193
|
-
|
|
2194
|
-
}
|
|
2195
|
-
|
|
2196
|
-
|
|
2197
|
-
|
|
2198
|
-
|
|
2199
|
-
|
|
2200
|
-
|
|
2201
|
-
|
|
2202
|
-
|
|
2203
|
-
|
|
2204
|
-
|
|
2205
|
-
|
|
2206
|
-
|
|
2207
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* dsh-plugin-lcsc — requirement-driven LCSC part finder and BOM cost auditor
|
|
3
|
+
* for the DeepSeek Harness (DSH) Host.
|
|
4
|
+
*
|
|
5
|
+
* Two LLM-callable tools, deliberately kept small so the plugin does not crowd
|
|
6
|
+
* the model's context when several plugins are installed:
|
|
7
|
+
*
|
|
8
|
+
* - find_lcsc_parts requirement -> ranked candidates (price / stock /
|
|
9
|
+
* basic-vs-extended library / parameter match)
|
|
10
|
+
* - audit_lcsc_bom existing BOM -> cost, stock, library-type and
|
|
11
|
+
* JLCPCB extended-part feeder-fee audit
|
|
12
|
+
*
|
|
13
|
+
* The HTTP/cache/normalisation layer lives in `data.js`.
|
|
14
|
+
*
|
|
15
|
+
* Design rules:
|
|
16
|
+
* - hand-soldering is the default (`assembly: "hand"`): most DIY users buy
|
|
17
|
+
* parts and solder themselves, and SMT fee rules change over time.
|
|
18
|
+
* - `assembly: "smt"` opts into library-type awareness: JLCPCB charges
|
|
19
|
+
* USD 3 per extended part number per order (feeder loading), base library
|
|
20
|
+
* parts are free, so the fee is amortised into the unit price.
|
|
21
|
+
* - prices are never converted between currencies; each price carries its
|
|
22
|
+
* currency and source.
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
import {
|
|
26
|
+
createLcscService,
|
|
27
|
+
normalizeConfig,
|
|
28
|
+
normalizeCode,
|
|
29
|
+
parseBomCsvDetailed,
|
|
30
|
+
pickTierPrice,
|
|
31
|
+
} from './data.js'
|
|
32
|
+
import { createCnAdapter } from './cn.js'
|
|
33
|
+
|
|
34
|
+
/** Plugin id used by the DSH loader. */
|
|
35
|
+
export const name = 'lcsc-parts'
|
|
36
|
+
/** Required services. */
|
|
37
|
+
export const inject = ['tools']
|
|
38
|
+
|
|
39
|
+
/** Default JLCPCB extended-part feeder loading fee, USD per unique part per order. */
|
|
40
|
+
export const EXTENDED_PART_FEE_USD = 3
|
|
41
|
+
/** Query-wide caps that keep a single tool call fast and cheap. */
|
|
42
|
+
const MAX_CANDIDATES = 8
|
|
43
|
+
const DEFAULT_LIMIT = 5
|
|
44
|
+
const SEARCH_PAGE_SIZE = 100
|
|
45
|
+
const MAX_CNY_LOOKUPS = 3
|
|
46
|
+
const MAX_AUDIT_CNY_LOOKUPS = 32
|
|
47
|
+
const MAX_ALTERNATIVE_LOOKUPS = 16
|
|
48
|
+
|
|
49
|
+
/* -------------------------------------------------------------------------- */
|
|
50
|
+
/* Small helpers */
|
|
51
|
+
/* -------------------------------------------------------------------------- */
|
|
52
|
+
|
|
53
|
+
/** @param {unknown} value @returns {value is Record<string, unknown>} */
|
|
54
|
+
function isRecord(value) {
|
|
55
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value)
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** @param {unknown} value @returns {string | undefined} */
|
|
59
|
+
function asString(value) {
|
|
60
|
+
if (typeof value !== 'string') return undefined
|
|
61
|
+
const text = value.trim()
|
|
62
|
+
return text === '' ? undefined : text
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** @param {unknown} value @returns {number | undefined} */
|
|
66
|
+
function asNumber(value) {
|
|
67
|
+
if (typeof value === 'number' && Number.isFinite(value)) return value
|
|
68
|
+
if (typeof value === 'string' && value.trim() !== '') {
|
|
69
|
+
const parsed = Number(value)
|
|
70
|
+
if (Number.isFinite(parsed)) return parsed
|
|
71
|
+
}
|
|
72
|
+
return undefined
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** @param {unknown} value @returns {number | undefined} */
|
|
76
|
+
function asInteger(value) {
|
|
77
|
+
const number = asNumber(value)
|
|
78
|
+
if (number === undefined || !Number.isInteger(number)) return undefined
|
|
79
|
+
return number
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/** @param {unknown} value @param {number} min @param {number} max @param {number} fallback */
|
|
83
|
+
function clampInteger(value, min, max, fallback) {
|
|
84
|
+
const number = asInteger(value)
|
|
85
|
+
if (number === undefined) return fallback
|
|
86
|
+
return Math.min(max, Math.max(min, number))
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** Round money-like values to avoid float noise in the tool output. */
|
|
90
|
+
function money(value) {
|
|
91
|
+
return Math.round(value * 1e6) / 1e6
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* DSH validates tool results for lossless JSON: plain `undefined` properties,
|
|
96
|
+
* NaN and Infinity are rejected. Normalise any result before returning it.
|
|
97
|
+
* @param {unknown} value
|
|
98
|
+
* @returns {unknown}
|
|
99
|
+
*/
|
|
100
|
+
function toLossless(value) {
|
|
101
|
+
if (value === undefined || value === null) return null
|
|
102
|
+
if (typeof value === 'number') {
|
|
103
|
+
if (!Number.isFinite(value)) return null
|
|
104
|
+
return Object.is(value, -0) ? 0 : value
|
|
105
|
+
}
|
|
106
|
+
if (typeof value === 'string' || typeof value === 'boolean') return value
|
|
107
|
+
if (Array.isArray(value)) return value.map((entry) => toLossless(entry))
|
|
108
|
+
if (typeof value === 'object') {
|
|
109
|
+
/** @type {Record<string, unknown>} */
|
|
110
|
+
const output = {}
|
|
111
|
+
for (const [key, entry] of Object.entries(value)) {
|
|
112
|
+
if (entry === undefined) continue
|
|
113
|
+
output[key] = toLossless(entry)
|
|
114
|
+
}
|
|
115
|
+
return output
|
|
116
|
+
}
|
|
117
|
+
return null
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* USD unit price of the highest-volume ladder tier (bulk / full-reel price).
|
|
122
|
+
* The Recording_card calibration relates the LCSC retail CNY price to this
|
|
123
|
+
* bulk-tier USD price (× 6.0), not to the small-quantity tier.
|
|
124
|
+
* @param {Record<string, unknown>} item
|
|
125
|
+
* @returns {number | undefined}
|
|
126
|
+
*/
|
|
127
|
+
export function bulkTierUsd(item) {
|
|
128
|
+
const tiers = Array.isArray(item.priceUsdTiers) ? item.priceUsdTiers : []
|
|
129
|
+
/** @type {{ qty: number, unit: number } | undefined} */
|
|
130
|
+
let best
|
|
131
|
+
for (const tier of tiers) {
|
|
132
|
+
if (!isRecord(tier)) continue
|
|
133
|
+
const qty = asNumber(tier.qty)
|
|
134
|
+
const unit = asNumber(tier.unit)
|
|
135
|
+
if (qty === undefined || unit === undefined) continue
|
|
136
|
+
if (best === undefined || qty > best.qty) best = { qty, unit }
|
|
137
|
+
}
|
|
138
|
+
return best?.unit
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
* Reference CNY estimate = bulk-tier USD × empirical factor.
|
|
143
|
+
* @param {number | undefined} bulkUsd
|
|
144
|
+
* @param {number | undefined} factor
|
|
145
|
+
* @returns {number | undefined}
|
|
146
|
+
*/
|
|
147
|
+
export function estimateCnyFromUsd(bulkUsd, factor) {
|
|
148
|
+
const value = asNumber(bulkUsd)
|
|
149
|
+
const calibration = asNumber(factor)
|
|
150
|
+
if (value === undefined || calibration === undefined) return undefined
|
|
151
|
+
return money(value * calibration)
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/** @param {number} ms @param {AbortSignal} [signal] */
|
|
155
|
+
function sleep(ms, signal) {
|
|
156
|
+
if (signal?.aborted === true) return Promise.reject(new Error('aborted'))
|
|
157
|
+
return new Promise((resolve, reject) => {
|
|
158
|
+
const timer = setTimeout(() => {
|
|
159
|
+
signal?.removeEventListener?.('abort', onAbort)
|
|
160
|
+
resolve()
|
|
161
|
+
}, ms)
|
|
162
|
+
function onAbort() {
|
|
163
|
+
clearTimeout(timer)
|
|
164
|
+
reject(new Error('aborted'))
|
|
165
|
+
}
|
|
166
|
+
signal?.addEventListener?.('abort', onAbort, { once: true })
|
|
167
|
+
})
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
/**
|
|
171
|
+
* Run `fn` over items with bounded concurrency; results keep input order.
|
|
172
|
+
* @template T, R
|
|
173
|
+
* @param {T[]} items
|
|
174
|
+
* @param {number} limit
|
|
175
|
+
* @param {(item: T, index: number) => Promise<R>} fn
|
|
176
|
+
* @returns {Promise<R[]>}
|
|
177
|
+
*/
|
|
178
|
+
async function mapLimit(items, limit, fn) {
|
|
179
|
+
const results = new Array(items.length)
|
|
180
|
+
let cursor = 0
|
|
181
|
+
const workers = Array.from({ length: Math.min(Math.max(1, limit), items.length) }, async () => {
|
|
182
|
+
while (cursor < items.length) {
|
|
183
|
+
const index = cursor
|
|
184
|
+
cursor += 1
|
|
185
|
+
results[index] = await fn(items[index], index)
|
|
186
|
+
}
|
|
187
|
+
})
|
|
188
|
+
await Promise.all(workers)
|
|
189
|
+
return results
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/* -------------------------------------------------------------------------- */
|
|
193
|
+
/* Requirement parsing */
|
|
194
|
+
/* -------------------------------------------------------------------------- */
|
|
195
|
+
|
|
196
|
+
/** Chinese / mixed category words mapped to English search hints (longest first). */
|
|
197
|
+
const CATEGORY_TERMS = [
|
|
198
|
+
['自恢复保险丝', ['ptc resettable fuse']],
|
|
199
|
+
['贴片电容', ['capacitor']],
|
|
200
|
+
['贴片电阻', ['resistor']],
|
|
201
|
+
['发光二极管', ['led']],
|
|
202
|
+
['锂电池充电', ['battery management', 'battery charger']],
|
|
203
|
+
['单节锂电池', ['battery management', 'battery charger']],
|
|
204
|
+
['充电ic', ['battery management', 'battery charger']],
|
|
205
|
+
['充电 ic', ['battery management', 'battery charger']],
|
|
206
|
+
['充电芯片', ['battery management', 'battery charger']],
|
|
207
|
+
['静态保护', ['esd']],
|
|
208
|
+
['静电保护', ['esd']],
|
|
209
|
+
['硅麦', ['microphone']],
|
|
210
|
+
['type-c母座', ['usb type-c receptacle']],
|
|
211
|
+
['type-c 母座', ['usb type-c receptacle']],
|
|
212
|
+
['type c母座', ['usb type-c receptacle']],
|
|
213
|
+
['母座', ['receptacle']],
|
|
214
|
+
['贴片', []],
|
|
215
|
+
['电容', ['capacitor']],
|
|
216
|
+
['电阻', ['resistor']],
|
|
217
|
+
['电感', ['inductor']],
|
|
218
|
+
['磁珠', ['ferrite bead']],
|
|
219
|
+
['二极管', ['diode']],
|
|
220
|
+
['肖特基', ['schottky']],
|
|
221
|
+
['三极管', ['transistor']],
|
|
222
|
+
['场效应管', ['mosfet']],
|
|
223
|
+
['mos管', ['mosfet']],
|
|
224
|
+
['稳压器', ['ldo', 'voltage regulator']],
|
|
225
|
+
['ldo', ['ldo']],
|
|
226
|
+
['连接器', ['connector']],
|
|
227
|
+
['插座', ['connector']],
|
|
228
|
+
['排针', ['pin header']],
|
|
229
|
+
['排母', ['pin header']],
|
|
230
|
+
['按键', ['tactile switch']],
|
|
231
|
+
['轻触开关', ['tactile switch']],
|
|
232
|
+
['开关', ['switch']],
|
|
233
|
+
['晶振', ['crystal']],
|
|
234
|
+
['谐振器', ['resonator']],
|
|
235
|
+
['保险丝', ['fuse']],
|
|
236
|
+
['麦克风', ['microphone']],
|
|
237
|
+
['咪头', ['microphone']],
|
|
238
|
+
['蜂鸣器', ['buzzer']],
|
|
239
|
+
['电池座', ['battery holder']],
|
|
240
|
+
['电池连接器', ['battery connector']],
|
|
241
|
+
['光耦', ['optocoupler']],
|
|
242
|
+
['运放', ['operational amplifier']],
|
|
243
|
+
['比较器', ['comparator']],
|
|
244
|
+
['单片机', ['microcontroller']],
|
|
245
|
+
['存储器', ['memory']],
|
|
246
|
+
['电平转换', ['level shifter']],
|
|
247
|
+
['tvs', ['tvs']],
|
|
248
|
+
['esd', ['esd']],
|
|
249
|
+
['type-c', ['type-c']],
|
|
250
|
+
['tf卡座', ['microsd']],
|
|
251
|
+
['sd卡座', ['microsd']],
|
|
252
|
+
['microsd', ['microsd']],
|
|
253
|
+
['usb', ['usb']],
|
|
254
|
+
]
|
|
255
|
+
|
|
256
|
+
/** Extra search keywords per category (JLCPCB keyword search is literal). */
|
|
257
|
+
const CATEGORY_SEARCH_VARIANTS = {
|
|
258
|
+
microphone: ['MEMS', 'MEMS microphone', 'microphone'],
|
|
259
|
+
'ptc resettable fuse': ['PTC', 'resettable fuse', 'fuse'],
|
|
260
|
+
fuse: ['PTC', 'resettable fuse'],
|
|
261
|
+
'usb type-c receptacle': ['USB Type-C', 'Type-C receptacle', 'Type-C'],
|
|
262
|
+
'type-c': ['USB Type-C', 'Type-C'],
|
|
263
|
+
usb: ['USB Type-C', 'USB'],
|
|
264
|
+
'battery management': ['battery management', 'charging IC', 'battery charger'],
|
|
265
|
+
'battery charger': ['battery management', 'charging IC', 'battery charger'],
|
|
266
|
+
tvs: ['TVS', 'ESD'],
|
|
267
|
+
esd: ['ESD', 'TVS'],
|
|
268
|
+
ldo: ['LDO', 'voltage regulator'],
|
|
269
|
+
'voltage regulator': ['LDO', 'voltage regulator'],
|
|
270
|
+
'ferrite bead': ['ferrite bead', 'ferrite'],
|
|
271
|
+
connector: ['connector'],
|
|
272
|
+
'pin header': ['pin header', 'header'],
|
|
273
|
+
'tactile switch': ['tactile switch', 'tact switch'],
|
|
274
|
+
crystal: ['crystal', 'oscillator'],
|
|
275
|
+
'battery holder': ['battery holder', 'battery connector'],
|
|
276
|
+
'battery connector': ['battery connector', 'battery holder'],
|
|
277
|
+
optocoupler: ['optocoupler'],
|
|
278
|
+
'operational amplifier': ['operational amplifier', 'op amp'],
|
|
279
|
+
microcontroller: ['microcontroller', 'MCU'],
|
|
280
|
+
memory: ['memory', 'flash'],
|
|
281
|
+
'level shifter': ['level shifter'],
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/** ASCII-only remainder of the requirement, useful for `USB Type-C 16P` / `MEMS`. */
|
|
285
|
+
function asciiRequirement(text) {
|
|
286
|
+
return String(text ?? '')
|
|
287
|
+
.replace(/[\u4e00-\u9fff]+/g, ' ')
|
|
288
|
+
.replace(/[，。；、,;:：!！?？]/g, ' ')
|
|
289
|
+
.replace(/\s+/g, ' ')
|
|
290
|
+
.trim()
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
/** Tokens in the ASCII remainder that are meaningful (not a bare value/unit/package). */
|
|
294
|
+
function asciiSearchTokens(text) {
|
|
295
|
+
return asciiRequirement(text)
|
|
296
|
+
.split(/\s+/)
|
|
297
|
+
.map((token) => token.replace(/^[\(（"']+|["'）)]+$/g, ''))
|
|
298
|
+
.filter((token) => token.length >= 3)
|
|
299
|
+
.filter((token) => /[A-Za-z]/.test(token))
|
|
300
|
+
.filter((token) => !VALUE_UNIT_TOKEN_RE.test(token))
|
|
301
|
+
.filter((token) => extractPackage(token) !== token.toUpperCase())
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
/**
|
|
305
|
+
* Recall keyword variants, in order, for the staged degradation chain.
|
|
306
|
+
* @param {ReturnType<typeof parseNeed>} need
|
|
307
|
+
* @returns {string[]}
|
|
308
|
+
*/
|
|
309
|
+
function recallFallbackKeywords(need) {
|
|
310
|
+
const keywords = []
|
|
311
|
+
const push = (value) => {
|
|
312
|
+
const text = String(value ?? '').trim()
|
|
313
|
+
if (text !== '' && !keywords.includes(text) && text !== need.searchKeyword) keywords.push(text)
|
|
314
|
+
}
|
|
315
|
+
// 1) Simplified category phrases (e.g. "PTC", "USB Type-C", "MEMS")
|
|
316
|
+
for (const category of need.categories ?? []) {
|
|
317
|
+
for (const variant of CATEGORY_SEARCH_VARIANTS[category] ?? []) push(variant)
|
|
318
|
+
}
|
|
319
|
+
// 2) English tokens that survived the Chinese text (e.g. "MEMS", "USB Type-C 16P")
|
|
320
|
+
const ascii = asciiRequirement(need.raw)
|
|
321
|
+
if (ascii !== '') push(ascii)
|
|
322
|
+
const tokens = asciiSearchTokens(need.raw)
|
|
323
|
+
if (tokens.length > 0) push(tokens.join(' '))
|
|
324
|
+
// 3) Package + category, then the untouched raw text
|
|
325
|
+
push([need.package, ...(need.categories ?? [])].filter(Boolean).join(' '))
|
|
326
|
+
push(need.raw)
|
|
327
|
+
return keywords
|
|
328
|
+
}
|
|
329
|
+
|
|
330
|
+
/** A single token that is a value+unit (e.g. "100nF", "3.3V", "10kΩ") is not a part number. */
|
|
331
|
+
const VALUE_UNIT_TOKEN_RE =
|
|
332
|
+
/^\d+(?:\.\d+)?\s*(?:pf|nf|uf|µf|mf|f|v|kv|ma|ua|µa|a|w|mw|ω|kω|mω|ohm|kohm|mm|nh|uh|µh|mh|hz|khz|mhz|ghz|k|r|m|%|p|pin|pins|针|脚)$/i
|
|
333
|
+
|
|
334
|
+
/** Normalised model string used for exact-model matching. */
|
|
335
|
+
export function normalizeModelToken(text) {
|
|
336
|
+
return String(text ?? '').toUpperCase().replace(/[^A-Z0-9]/g, '')
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
/**
|
|
340
|
+
* Detect an exact part query (LCSC code or manufacturer part number) before any
|
|
341
|
+
* numeric parameter parsing. This is the fix for "SMF5.0A" being read as
|
|
342
|
+
* current>=5A / "TP4054" as 4054: those strings are part numbers, not values.
|
|
343
|
+
* @param {string} text
|
|
344
|
+
* @returns {{ type: 'code' | 'model', value: string, token?: string } | undefined}
|
|
345
|
+
*/
|
|
346
|
+
export function detectExactQuery(text) {
|
|
347
|
+
const raw = String(text ?? '').trim()
|
|
348
|
+
if (raw === '') return undefined
|
|
349
|
+
const wholeCode = raw.match(/^C\d{4,11}$/i)
|
|
350
|
+
if (wholeCode !== null) return { type: 'code', value: wholeCode[0].toUpperCase() }
|
|
351
|
+
const tokens = raw.split(/[\s,;，；、]+/).filter((token) => token !== '')
|
|
352
|
+
if (tokens.length === 0) return undefined
|
|
353
|
+
// Only treat the input as a part number when it is a single token, or when
|
|
354
|
+
// one token is a strong part number and the rest are category words. Mixed
|
|
355
|
+
// requirement strings ("22 ohm 0402 resistor") must keep their value parsing.
|
|
356
|
+
const strong = []
|
|
357
|
+
for (const token of tokens) {
|
|
358
|
+
const clean = token.replace(/^[\(（"'`]+|[)'"`”）]+$/g, '')
|
|
359
|
+
if (clean.length < 4) continue
|
|
360
|
+
if (/^C\d{4,11}$/i.test(clean)) return { type: 'code', value: clean.toUpperCase() }
|
|
361
|
+
if (VALUE_UNIT_TOKEN_RE.test(clean)) continue
|
|
362
|
+
if (extractPackage(clean) === clean.toUpperCase()) continue
|
|
363
|
+
if (!/^[A-Za-z0-9._/+\-]+$/.test(clean)) continue
|
|
364
|
+
if (!/\d/.test(clean) || !/[A-Za-z]/.test(clean)) continue
|
|
365
|
+
const startsWithLetters = /^[A-Za-z]{2,}/.test(clean)
|
|
366
|
+
const hasSeparator = /[-._/+]/.test(clean)
|
|
367
|
+
const longPartNumber = clean.length >= 8
|
|
368
|
+
if (startsWithLetters || hasSeparator || longPartNumber) strong.push(clean)
|
|
369
|
+
}
|
|
370
|
+
if (strong.length === 1) return { type: 'model', value: strong[0], token: normalizeModelToken(strong[0]) }
|
|
371
|
+
if (strong.length > 1 && tokens.length === strong.length) {
|
|
372
|
+
// A single part number split by separators is already covered by one token;
|
|
373
|
+
// multiple independent part numbers are ambiguous, so keep parameter parsing.
|
|
374
|
+
return undefined
|
|
375
|
+
}
|
|
376
|
+
return undefined
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
/** Package / footprint tokens, longest first so SOT-23-5 wins over SOT-23. */
|
|
380
|
+
const PACKAGE_PATTERNS = [
|
|
381
|
+
'SOT-23-6', 'SOT-23-5', 'SOT-23-3', 'SOT-23', 'SOD-123FL', 'SOD-123', 'SOD-323',
|
|
382
|
+
'DO-214AC', 'DO-214AA', 'DO-214AB', 'ESOP-8', 'SOP-16', 'SOP-8', 'SOP-4',
|
|
383
|
+
'TSSOP-16', 'TSSOP-20', 'MSOP-8', 'MSOP-10', 'QFN-16', 'QFN-20', 'QFN-24',
|
|
384
|
+
'DFN-6', 'DFN-8', 'SMA', 'SMB', 'SMC', 'TO-220', 'TO-92', 'TO-252', 'TO-263',
|
|
385
|
+
'0201', '0402', '0603', '0805', '1206', '1210', '1812', '2010', '2512', '3225', '5032',
|
|
386
|
+
]
|
|
387
|
+
|
|
388
|
+
const VOLTAGE_UNIT = /(kv|v)/i
|
|
389
|
+
const CURRENT_UNIT = /(ma|ua|µa|a)/i
|
|
390
|
+
const CAP_UNIT = /(mf|uf|µf|nf|pf|f)/i
|
|
391
|
+
const RES_UNIT = /(mω|kω|mohm|kohm|ω|ohm|meg|m|k|r)/i
|
|
392
|
+
|
|
393
|
+
/** Normalise a comparator token to one of '>=', '<=', '='. */
|
|
394
|
+
function normalizeComparator(raw) {
|
|
395
|
+
if (raw === undefined) return undefined
|
|
396
|
+
const text = String(raw).toLowerCase()
|
|
397
|
+
if (['>=', '≥', '>', '至少', '不小于', '大于', 'min', 'minimum'].includes(text)) return '>='
|
|
398
|
+
if (['<=', '≤', '<', '最多', '不超过', '小于', 'max', 'maximum'].includes(text)) return '<='
|
|
399
|
+
return '='
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
/** @param {string} text @returns {string | undefined} */
|
|
403
|
+
function extractPackage(text) {
|
|
404
|
+
const upper = text.toUpperCase()
|
|
405
|
+
for (const pattern of PACKAGE_PATTERNS) {
|
|
406
|
+
if (upper.includes(pattern)) return pattern
|
|
407
|
+
}
|
|
408
|
+
const inch = upper.match(/\b(0201|0402|0603|0805|1206|1210|1812|2010|2512)\b/)
|
|
409
|
+
return inch === null ? undefined : inch[1]
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
/**
|
|
413
|
+
* Extract numeric requirements from free text.
|
|
414
|
+
* @param {string} text
|
|
415
|
+
* @returns {{ kind: string, value: number, unit: string, comparator: string | undefined, raw: string }[]}
|
|
416
|
+
*/
|
|
417
|
+
export function extractRequirements(text) {
|
|
418
|
+
/** @type {{ kind: string, value: number, unit: string, comparator: string | undefined, raw: string }[]} */
|
|
419
|
+
const requirements = []
|
|
420
|
+
const cleaned = text
|
|
421
|
+
.replace(/\b(0201|0402|0603|0805|1206|1210|1812|2010|2512)\b/g, ' ')
|
|
422
|
+
.replace(/\b(x7r|x5r|x6s|x7s|c0g|np0|y5v|z5u)\b/gi, ' ')
|
|
423
|
+
const push = (kind, value, unit, comparator, raw) => {
|
|
424
|
+
if (!Number.isFinite(value)) return
|
|
425
|
+
requirements.push({ kind, value, unit, comparator: normalizeComparator(comparator), raw })
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
// Capacitance
|
|
429
|
+
for (const match of cleaned.matchAll(/(>=|≥|>|<=|≤|<|=|至少|不小于|大于|最多|不超过|小于)?\s*(\d+(?:\.\d+)?)\s*(pf|nf|uf|µf|mf|f)\b/gi)) {
|
|
430
|
+
const unit = match[3].toLowerCase()
|
|
431
|
+
const scale = { pf: 1, nf: 1e3, uf: 1e6, 'µf': 1e6, mf: 1e9, f: 1e12 }[unit]
|
|
432
|
+
push('capacitance', Number(match[2]) * scale, unit, match[1], match[0].trim())
|
|
433
|
+
}
|
|
434
|
+
// Resistance ("10kΩ", "5.1k", "100Ω", "0R")
|
|
435
|
+
for (const match of cleaned.matchAll(/(?<![A-Za-z0-9])(>=|≥|>|<=|≤|<|=|至少|不小于|大于|最多|不超过|小于)?\s*(\d+(?:\.\d+)?)\s*(kω|kohm|mω|mohm|meg|mω|ω|ohm|k|m|r)(?![A-Za-z0-9])/gi)) {
|
|
436
|
+
const unitRaw = match[3]
|
|
437
|
+
const unit = unitRaw === undefined ? undefined : unitRaw.toLowerCase()
|
|
438
|
+
if (unit === undefined) continue
|
|
439
|
+
const value = Number(match[2])
|
|
440
|
+
const scale = { 'ω': 1, ohm: 1, r: 1, k: 1e3, 'kω': 1e3, kohm: 1e3, m: 1e6, meg: 1e6, 'mω': 1e-3, mohm: 1e-3 }[unit]
|
|
441
|
+
if (scale === undefined) continue
|
|
442
|
+
push('resistance', value * scale, unit, match[1], match[0].trim())
|
|
443
|
+
}
|
|
444
|
+
// Inductance
|
|
445
|
+
for (const match of cleaned.matchAll(/(>=|≥|>|<=|≤|<|=|至少|不小于|大于|最多|不超过|小于)?\s*(\d+(?:\.\d+)?)\s*(nh|uh|µh|mh|h)\b/gi)) {
|
|
446
|
+
const unit = match[3].toLowerCase()
|
|
447
|
+
const scale = { nh: 1, uh: 1e3, 'µh': 1e3, mh: 1e6, h: 1e9 }[unit]
|
|
448
|
+
push('inductance', Number(match[2]) * scale, unit, match[1], match[0].trim())
|
|
449
|
+
}
|
|
450
|
+
// Voltage
|
|
451
|
+
for (const match of cleaned.matchAll(/(>=|≥|>|<=|≤|<|=|至少|不小于|大于|最多|不超过|小于)?\s*(\d+(?:\.\d+)?)\s*(kv|v)\b/gi)) {
|
|
452
|
+
const unit = match[3].toLowerCase()
|
|
453
|
+
push('voltage', Number(match[2]) * (unit === 'kv' ? 1000 : 1), unit, match[1], match[0].trim())
|
|
454
|
+
}
|
|
455
|
+
// Current
|
|
456
|
+
for (const match of cleaned.matchAll(/(>=|≥|>|<=|≤|<|=|至少|不小于|大于|最多|不超过|小于)?\s*(\d+(?:\.\d+)?)\s*(ma|ua|µa|a)\b/gi)) {
|
|
457
|
+
const unit = match[3].toLowerCase()
|
|
458
|
+
const scale = { ma: 1, ua: 1e-3, 'µa': 1e-3, a: 1e3 }[unit]
|
|
459
|
+
push('current', Number(match[2]) * scale, unit, match[1], match[0].trim())
|
|
460
|
+
}
|
|
461
|
+
// Power
|
|
462
|
+
for (const match of cleaned.matchAll(/(>=|≥|>|<=|≤|<|=|至少|不小于|大于|最多|不超过|小于)?\s*(\d+(?:\.\d+)?)\s*(mw|w)\b/gi)) {
|
|
463
|
+
const unit = match[3].toLowerCase()
|
|
464
|
+
push('power', Number(match[2]) * (unit === 'mw' ? 1 : 1000), unit, match[1], match[0].trim())
|
|
465
|
+
}
|
|
466
|
+
// Tolerance (percent) - tighter is better, so default comparator is <=
|
|
467
|
+
for (const match of cleaned.matchAll(/(>=|≥|>|<=|≤|<|=|至少|不小于|大于|最多|不超过|小于)?\s*±?\s*(\d+(?:\.\d+)?)\s*%/g)) {
|
|
468
|
+
push('tolerance', Number(match[2]), '%', match[1], match[0].trim())
|
|
469
|
+
}
|
|
470
|
+
// Frequency
|
|
471
|
+
for (const match of cleaned.matchAll(/(>=|≥|>|<=|≤|<|=|至少|不小于|大于|最多|不超过|小于)?\s*(\d+(?:\.\d+)?)\s*(khz|mhz|ghz|hz)\b/gi)) {
|
|
472
|
+
const unit = match[3].toLowerCase()
|
|
473
|
+
const scale = { hz: 1, khz: 1e3, mhz: 1e6, ghz: 1e9 }[unit]
|
|
474
|
+
push('frequency', Number(match[2]) * scale, unit, match[1], match[0].trim())
|
|
475
|
+
}
|
|
476
|
+
// Footprint dimensions like 2.0x1.2mm
|
|
477
|
+
for (const match of cleaned.matchAll(/(\d+(?:\.\d+)?)\s*(?:x|×|\*)\s*(\d+(?:\.\d+)?)\s*mm/gi)) {
|
|
478
|
+
requirements.push({ kind: 'size', value: Number(match[1]), unit: 'mm', comparator: '=', raw: match[0], extra: Number(match[2]) })
|
|
479
|
+
}
|
|
480
|
+
// Pin / contact count ("16P", "16 pin", "16针")
|
|
481
|
+
for (const match of cleaned.matchAll(/(?<![A-Za-z0-9])(\d{1,3})\s*(?:p|pin|pins|针|脚)(?![A-Za-z0-9])/gi)) {
|
|
482
|
+
push('pins', Number(match[1]), 'pins', '=', match[0].trim())
|
|
483
|
+
}
|
|
484
|
+
return requirements
|
|
485
|
+
}
|
|
486
|
+
|
|
487
|
+
/**
|
|
488
|
+
* Parse a free-form requirement (Chinese or English) into a structured need.
|
|
489
|
+
* @param {string} raw
|
|
490
|
+
* @returns {{ raw: string, searchKeyword: string, package?: string, directCode?: string, modelGuess: boolean, categories: string[], dielectric?: string, requirements: ReturnType<typeof extractRequirements> }}
|
|
491
|
+
*/
|
|
492
|
+
export function parseNeed(raw) {
|
|
493
|
+
const text = String(raw ?? '').trim()
|
|
494
|
+
const exact = detectExactQuery(text)
|
|
495
|
+
if (exact !== undefined) {
|
|
496
|
+
// Exact part query: return the code/model directly and DO NOT parse numeric
|
|
497
|
+
// requirements. Part numbers such as SMF5.0A / AO3401A / TP4054 contain
|
|
498
|
+
// digit+letter patterns that would otherwise be misread as value/unit.
|
|
499
|
+
return {
|
|
500
|
+
raw: text,
|
|
501
|
+
searchKeyword: exact.value,
|
|
502
|
+
package: extractPackage(text),
|
|
503
|
+
directCode: exact.type === 'code' ? exact.value : undefined,
|
|
504
|
+
modelGuess: exact.type === 'model',
|
|
505
|
+
modelToken: exact.type === 'model' ? exact.token : undefined,
|
|
506
|
+
categories: [],
|
|
507
|
+
dielectric: undefined,
|
|
508
|
+
requirements: [],
|
|
509
|
+
exact: true,
|
|
510
|
+
exactValue: exact.value,
|
|
511
|
+
upper: text.toUpperCase(),
|
|
512
|
+
}
|
|
513
|
+
}
|
|
514
|
+
|
|
515
|
+
const packageName = extractPackage(text)
|
|
516
|
+
const categories = []
|
|
517
|
+
const dielectricMatch = text.match(/\b(X7R|X5R|X6S|X7S|C0G|NP0|Y5V|Z5U)\b/i)
|
|
518
|
+
const dielectric = dielectricMatch === null ? undefined : dielectricMatch[1].toUpperCase()
|
|
519
|
+
for (const [word, hints] of CATEGORY_TERMS) {
|
|
520
|
+
if (text.toLowerCase().includes(word)) {
|
|
521
|
+
for (const hint of hints) if (!categories.includes(hint)) categories.push(hint)
|
|
522
|
+
}
|
|
523
|
+
}
|
|
524
|
+
// English category words are used as-is by the JLCPCB search, so keep them.
|
|
525
|
+
const ENGLISH_CATEGORIES = [
|
|
526
|
+
'capacitor', 'resistor', 'inductor', 'ferrite bead', 'diode', 'schottky', 'led',
|
|
527
|
+
'transistor', 'mosfet', 'ldo', 'voltage regulator', 'connector', 'pin header',
|
|
528
|
+
'tactile switch', 'switch', 'crystal', 'resonator', 'fuse', 'ptc resettable fuse',
|
|
529
|
+
'microphone', 'buzzer', 'battery holder', 'battery connector', 'optocoupler',
|
|
530
|
+
'operational amplifier', 'comparator', 'microcontroller', 'memory', 'level shifter',
|
|
531
|
+
'tvs', 'esd', 'type-c', 'microsd', 'usb', 'relay', 'sensor', 'motor driver',
|
|
532
|
+
'adc', 'dac', 'interface', 'antenna', 'receptacle', 'battery charger', 'battery management', 'pin header',
|
|
533
|
+
]
|
|
534
|
+
for (const word of ENGLISH_CATEGORIES) {
|
|
535
|
+
const re = new RegExp(`(^|[^a-z0-9])${word.replace(/[.*+?^${}()|[\\]\\]/g, '\\$&')}([^a-z0-9]|$)`, 'i')
|
|
536
|
+
if (re.test(text) && !categories.includes(word)) categories.push(word)
|
|
537
|
+
}
|
|
538
|
+
|
|
539
|
+
// Translate Chinese category words into English so the JLCPCB keyword search
|
|
540
|
+
// (which is English-oriented) gets a useful query.
|
|
541
|
+
let keyword = text
|
|
542
|
+
for (const [word, hints] of CATEGORY_TERMS) {
|
|
543
|
+
if (hints.length === 0) continue
|
|
544
|
+
const re = new RegExp(word.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi')
|
|
545
|
+
keyword = keyword.replace(re, ` ${hints[0]} `)
|
|
546
|
+
}
|
|
547
|
+
keyword = keyword
|
|
548
|
+
.replace(/[，。；、,;:：!！?？]/g, ' ')
|
|
549
|
+
.replace(/需要|一个|帮我|找一下|寻找|找|用来|用于|的|料号|器件|元件|请|帮我选|推荐/g, ' ')
|
|
550
|
+
.replace(/[\u4e00-\u9fff]+/g, ' ')
|
|
551
|
+
.replace(/\s+/g, ' ')
|
|
552
|
+
.trim()
|
|
553
|
+
// If the user already wrote English/ASCII terms, prefer them: translating
|
|
554
|
+
// 母座 -> receptacle or 麦克风 -> microphone can otherwise dilute a literal
|
|
555
|
+
// keyword search (e.g. "USB Type-C 16P receptacle" vs "USB Type-C 16P").
|
|
556
|
+
const ascii = asciiRequirement(text)
|
|
557
|
+
const meaningfulAscii = asciiSearchTokens(text)
|
|
558
|
+
if (meaningfulAscii.length > 0 && ascii !== '') keyword = ascii
|
|
559
|
+
if (keyword === '') keyword = [packageName, dielectric, ...categories].filter(Boolean).join(' ')
|
|
560
|
+
if (keyword === '') keyword = text
|
|
561
|
+
// Collapse repeated tokens produced by overlapping Chinese synonyms.
|
|
562
|
+
const seenTokens = new Set()
|
|
563
|
+
keyword = keyword
|
|
564
|
+
.split(/\s+/)
|
|
565
|
+
.filter((token) => {
|
|
566
|
+
const key = token.toLowerCase()
|
|
567
|
+
if (seenTokens.has(key)) return false
|
|
568
|
+
seenTokens.add(key)
|
|
569
|
+
return true
|
|
570
|
+
})
|
|
571
|
+
.join(' ')
|
|
572
|
+
|
|
573
|
+
const requirements = extractRequirements(text)
|
|
574
|
+
// Category-aware comparator defaults.
|
|
575
|
+
const isRegulator = categories.some((category) => category === 'ldo' || category === 'voltage regulator' || category === 'battery charger')
|
|
576
|
+
for (const requirement of requirements) {
|
|
577
|
+
if (requirement.comparator !== undefined) continue
|
|
578
|
+
if (requirement.kind === 'voltage' && isRegulator) requirement.comparator = '='
|
|
579
|
+
else if (requirement.kind === 'tolerance') requirement.comparator = '<='
|
|
580
|
+
else if (requirement.kind === 'size') requirement.comparator = '='
|
|
581
|
+
else if (requirement.kind === 'capacitance' || requirement.kind === 'resistance' || requirement.kind === 'inductance' || requirement.kind === 'frequency' || requirement.kind === 'pins') requirement.comparator = '='
|
|
582
|
+
else requirement.comparator = '>='
|
|
583
|
+
}
|
|
584
|
+
return {
|
|
585
|
+
raw: text,
|
|
586
|
+
searchKeyword: keyword,
|
|
587
|
+
package: packageName,
|
|
588
|
+
directCode: undefined,
|
|
589
|
+
modelGuess: false,
|
|
590
|
+
modelToken: undefined,
|
|
591
|
+
categories,
|
|
592
|
+
dielectric,
|
|
593
|
+
requirements,
|
|
594
|
+
exact: false,
|
|
595
|
+
exactValue: undefined,
|
|
596
|
+
upper: text.toUpperCase(),
|
|
597
|
+
}
|
|
598
|
+
}
|
|
599
|
+
|
|
600
|
+
/* -------------------------------------------------------------------------- */
|
|
601
|
+
/* Candidate extraction / matching */
|
|
602
|
+
/* -------------------------------------------------------------------------- */
|
|
603
|
+
|
|
604
|
+
/** @param {Record<string, unknown>} item */
|
|
605
|
+
function attributesOf(item) {
|
|
606
|
+
return Array.isArray(item.attributes)
|
|
607
|
+
? item.attributes.filter(isRecord).map((attribute) => ({
|
|
608
|
+
name: asString(attribute.name) ?? '',
|
|
609
|
+
value: asString(attribute.value) ?? '',
|
|
610
|
+
}))
|
|
611
|
+
: []
|
|
612
|
+
}
|
|
613
|
+
|
|
614
|
+
/** Full searchable text of a JLCPCB candidate row. */
|
|
615
|
+
function candidateText(item) {
|
|
616
|
+
const parts = [
|
|
617
|
+
asString(item.model),
|
|
618
|
+
asString(item.package),
|
|
619
|
+
asString(item.category),
|
|
620
|
+
asString(item.description),
|
|
621
|
+
]
|
|
622
|
+
for (const attribute of attributesOf(item)) parts.push(`${attribute.name} ${attribute.value}`)
|
|
623
|
+
return parts.filter(Boolean).join(' ').toLowerCase()
|
|
624
|
+
}
|
|
625
|
+
|
|
626
|
+
/** Infer quantity kinds from an attribute name. */
|
|
627
|
+
function kindsFromAttributeName(name) {
|
|
628
|
+
const kinds = []
|
|
629
|
+
if (/capacitance|^cap\b/i.test(name)) kinds.push('capacitance')
|
|
630
|
+
if (/resistance|resistor/i.test(name)) kinds.push('resistance')
|
|
631
|
+
if (/inductance/i.test(name)) kinds.push('inductance')
|
|
632
|
+
if (/voltage|vds|vgs|reverse|vrm|vrr|supply/i.test(name)) kinds.push('voltage')
|
|
633
|
+
if (/current|amp/i.test(name)) kinds.push('current')
|
|
634
|
+
if (/\bpower\b/i.test(name)) kinds.push('power')
|
|
635
|
+
if (/tolerance/i.test(name)) kinds.push('tolerance')
|
|
636
|
+
if (/frequency/i.test(name)) kinds.push('frequency')
|
|
637
|
+
return kinds
|
|
638
|
+
}
|
|
639
|
+
|
|
640
|
+
/**
|
|
641
|
+
* Extract candidate numeric values for matching.
|
|
642
|
+
* @param {Record<string, unknown>} item
|
|
643
|
+
* @returns {{ kind: string, value: number }[]}
|
|
644
|
+
*/
|
|
645
|
+
export function extractCandidateQuantities(item) {
|
|
646
|
+
/** @type {{ kind: string, value: number }[]} */
|
|
647
|
+
const result = []
|
|
648
|
+
const add = (kind, value) => {
|
|
649
|
+
if (Number.isFinite(value)) result.push({ kind, value })
|
|
650
|
+
}
|
|
651
|
+
for (const attribute of attributesOf(item)) {
|
|
652
|
+
if (/number of (contacts|positions|pins)|contacts|positions|pin count|number of pins|pin number/i.test(attribute.name)) {
|
|
653
|
+
const pinMatch = attribute.value.match(/\d{1,3}/)
|
|
654
|
+
if (pinMatch !== null) add('pins', Number(pinMatch[0]))
|
|
655
|
+
}
|
|
656
|
+
const kinds = kindsFromAttributeName(attribute.name)
|
|
657
|
+
const valueText = `${attribute.value}`
|
|
658
|
+
if (kinds.length === 0) continue
|
|
659
|
+
for (const kind of kinds) {
|
|
660
|
+
for (const parsed of parseQuantitiesOfKind(valueText, kind)) add(kind, parsed)
|
|
661
|
+
}
|
|
662
|
+
// "10k" / "0R" style resistance values without a unit letter.
|
|
663
|
+
if (kinds.includes('resistance')) {
|
|
664
|
+
const bare = valueText.trim().match(/^(\d+(?:\.\d+)?)\s*(k|m)?$/i)
|
|
665
|
+
if (bare !== null) {
|
|
666
|
+
const multiplier = bare[2] === undefined ? 1 : bare[2].toLowerCase() === 'k' ? 1e3 : 1e6
|
|
667
|
+
add('resistance', Number(bare[1]) * multiplier)
|
|
668
|
+
}
|
|
669
|
+
}
|
|
670
|
+
}
|
|
671
|
+
// Generic scan over the description as a fallback.
|
|
672
|
+
const description = asString(item.description)
|
|
673
|
+
if (description !== undefined) {
|
|
674
|
+
for (const match of description.matchAll(/(\d+(?:\.\d+)?)\s*(pf|nf|uf|µf|mf|f)\b/gi)) {
|
|
675
|
+
add('capacitance', Number(match[1]) * ({ pf: 1, nf: 1e3, uf: 1e6, 'µf': 1e6, mf: 1e9, f: 1e12 }[match[2].toLowerCase()] ?? 0))
|
|
676
|
+
}
|
|
677
|
+
for (const match of description.matchAll(/(\d+(?:\.\d+)?)\s*(kv|v)\b/gi)) {
|
|
678
|
+
add('voltage', Number(match[1]) * (match[2].toLowerCase() === 'kv' ? 1000 : 1))
|
|
679
|
+
}
|
|
680
|
+
for (const match of description.matchAll(/(\d+(?:\.\d+)?)\s*(ma|ua|µa|a)\b/gi)) {
|
|
681
|
+
add('current', Number(match[1]) * ({ ma: 1, ua: 1e-3, 'µa': 1e-3, a: 1e3 }[match[2].toLowerCase()] ?? 0))
|
|
682
|
+
}
|
|
683
|
+
for (const match of description.matchAll(/(\d+(?:\.\d+)?)\s*(mw|w)\b/gi)) {
|
|
684
|
+
add('power', Number(match[1]) * (match[2].toLowerCase() === 'mw' ? 1 : 1000))
|
|
685
|
+
}
|
|
686
|
+
for (const match of description.matchAll(/±\s*(\d+(?:\.\d+)?)\s*%/g)) add('tolerance', Number(match[1]))
|
|
687
|
+
for (const match of description.matchAll(/(\d+(?:\.\d+)?)\s*(nh|uh|µh|mh|h)\b/gi)) {
|
|
688
|
+
add('inductance', Number(match[1]) * ({ nh: 1, uh: 1e3, 'µh': 1e3, mh: 1e6, h: 1e9 }[match[2].toLowerCase()] ?? 0))
|
|
689
|
+
}
|
|
690
|
+
for (const match of description.matchAll(/(\d+(?:\.\d+)?)\s*(?:x|×|\*)\s*(\d+(?:\.\d+)?)\s*mm/gi)) {
|
|
691
|
+
add('size', Number(match[1]))
|
|
692
|
+
add('size', Number(match[2]))
|
|
693
|
+
}
|
|
694
|
+
}
|
|
695
|
+
return result
|
|
696
|
+
}
|
|
697
|
+
|
|
698
|
+
/** Parse values of one kind from a text fragment. */
|
|
699
|
+
function parseQuantitiesOfKind(text, kind) {
|
|
700
|
+
const values = []
|
|
701
|
+
const add = (value) => {
|
|
702
|
+
if (Number.isFinite(value)) values.push(value)
|
|
703
|
+
}
|
|
704
|
+
if (kind === 'capacitance') {
|
|
705
|
+
for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(pf|nf|uf|µf|mf|f)\b/gi)) {
|
|
706
|
+
const scale = { pf: 1, nf: 1e3, uf: 1e6, 'µf': 1e6, mf: 1e9, f: 1e12 }[match[2].toLowerCase()]
|
|
707
|
+
if (scale !== undefined) add(Number(match[1]) * scale)
|
|
708
|
+
}
|
|
709
|
+
} else if (kind === 'resistance') {
|
|
710
|
+
for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(kω|kohm|mω|mohm|meg|ω|ohm|m|k|r)?\b/gi)) {
|
|
711
|
+
const unit = match[2] === undefined ? undefined : match[2].toLowerCase()
|
|
712
|
+
const scale = unit === undefined
|
|
713
|
+
? 1
|
|
714
|
+
: { 'ω': 1, ohm: 1, r: 1, k: 1e3, 'kω': 1e3, kohm: 1e3, m: 1e6, meg: 1e6, 'mω': 1e-3, mohm: 1e-3 }[unit]
|
|
715
|
+
if (scale !== undefined) add(Number(match[1]) * scale)
|
|
716
|
+
}
|
|
717
|
+
} else if (kind === 'inductance') {
|
|
718
|
+
for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(nh|uh|µh|mh|h)\b/gi)) {
|
|
719
|
+
const scale = { nh: 1, uh: 1e3, 'µh': 1e3, mh: 1e6, h: 1e9 }[match[2].toLowerCase()]
|
|
720
|
+
if (scale !== undefined) add(Number(match[1]) * scale)
|
|
721
|
+
}
|
|
722
|
+
} else if (kind === 'voltage') {
|
|
723
|
+
for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(kv|v)\b/gi)) {
|
|
724
|
+
add(Number(match[1]) * (match[2].toLowerCase() === 'kv' ? 1000 : 1))
|
|
725
|
+
}
|
|
726
|
+
} else if (kind === 'current') {
|
|
727
|
+
for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(ma|ua|µa|a)\b/gi)) {
|
|
728
|
+
const scale = { ma: 1, ua: 1e-3, 'µa': 1e-3, a: 1e3 }[match[2].toLowerCase()]
|
|
729
|
+
if (scale !== undefined) add(Number(match[1]) * scale)
|
|
730
|
+
}
|
|
731
|
+
} else if (kind === 'power') {
|
|
732
|
+
for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(mw|w)\b/gi)) {
|
|
733
|
+
add(Number(match[1]) * (match[2].toLowerCase() === 'mw' ? 1 : 1000))
|
|
734
|
+
}
|
|
735
|
+
} else if (kind === 'tolerance') {
|
|
736
|
+
for (const match of text.matchAll(/±?\s*(\d+(?:\.\d+)?)\s*%/g)) add(Number(match[1]))
|
|
737
|
+
} else if (kind === 'frequency') {
|
|
738
|
+
for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(khz|mhz|ghz|hz)\b/gi)) {
|
|
739
|
+
const scale = { hz: 1, khz: 1e3, mhz: 1e6, ghz: 1e9 }[match[2].toLowerCase()]
|
|
740
|
+
if (scale !== undefined) add(Number(match[1]) * scale)
|
|
741
|
+
}
|
|
742
|
+
} else if (kind === 'size') {
|
|
743
|
+
for (const match of text.matchAll(/(\d+(?:\.\d+)?)\s*(?:x|×|\*)\s*(\d+(?:\.\d+)?)\s*mm/gi)) {
|
|
744
|
+
add(Number(match[1]))
|
|
745
|
+
add(Number(match[2]))
|
|
746
|
+
}
|
|
747
|
+
}
|
|
748
|
+
return values
|
|
749
|
+
}
|
|
750
|
+
|
|
751
|
+
/** Does a candidate value satisfy a parsed requirement? */
|
|
752
|
+
function satisfies(value, requirement) {
|
|
753
|
+
const target = requirement.value
|
|
754
|
+
const comparator = requirement.comparator ?? '>='
|
|
755
|
+
const tolerance = Math.max(Math.abs(target) * 0.05, 1e-9)
|
|
756
|
+
if (comparator === '=') return Math.abs(value - target) <= tolerance
|
|
757
|
+
if (comparator === '>=') return value >= target - tolerance
|
|
758
|
+
if (comparator === '<=') return value <= target + tolerance
|
|
759
|
+
return false
|
|
760
|
+
}
|
|
761
|
+
|
|
762
|
+
/** Package comparison tolerant to spacing/case differences. */
|
|
763
|
+
function packageMatches(candidatePackage, wantedPackage) {
|
|
764
|
+
if (candidatePackage === undefined) return true
|
|
765
|
+
const normal = (value) => String(value).toUpperCase().replace(/[\s_]/g, '')
|
|
766
|
+
return normal(candidatePackage) === normal(wantedPackage)
|
|
767
|
+
}
|
|
768
|
+
|
|
769
|
+
/**
|
|
770
|
+
* Check whether a JLCPCB candidate satisfies a parsed requirement.
|
|
771
|
+
* @param {Record<string, unknown>} item
|
|
772
|
+
* @param {ReturnType<typeof parseNeed>} need
|
|
773
|
+
* @returns {{ ok: boolean, matched: string[], missing?: string }}
|
|
774
|
+
*/
|
|
775
|
+
export function candidateMatches(item, need) {
|
|
776
|
+
if (need.directCode !== undefined && String(item.code).toUpperCase() !== need.directCode) {
|
|
777
|
+
return { ok: false, matched: [] }
|
|
778
|
+
}
|
|
779
|
+
if (need.modelGuess === true) {
|
|
780
|
+
const candidate = normalizeModelToken(item.model)
|
|
781
|
+
if (need.modelToken === undefined || !candidate.includes(need.modelToken)) {
|
|
782
|
+
return { ok: false, matched: [] }
|
|
783
|
+
}
|
|
784
|
+
return { ok: true, matched: [`model=${item.model ?? need.exactValue}`] }
|
|
785
|
+
}
|
|
786
|
+
if (need.package !== undefined && item.package !== undefined && !packageMatches(item.package, need.package)) {
|
|
787
|
+
return { ok: false, matched: [] }
|
|
788
|
+
}
|
|
789
|
+
const text = candidateText(item)
|
|
790
|
+
if (need.dielectric !== undefined && !text.includes(need.dielectric.toLowerCase())) {
|
|
791
|
+
return { ok: false, matched: [] }
|
|
792
|
+
}
|
|
793
|
+
if (need.categories.length > 0) {
|
|
794
|
+
const hit = need.categories.some((category) => text.includes(category.toLowerCase()))
|
|
795
|
+
if (!hit) return { ok: false, matched: [] }
|
|
796
|
+
}
|
|
797
|
+
const quantities = extractCandidateQuantities(item)
|
|
798
|
+
const matched = []
|
|
799
|
+
for (const requirement of need.requirements) {
|
|
800
|
+
if (requirement.kind === 'size') {
|
|
801
|
+
const values = quantities.filter((quantity) => quantity.kind === 'size').map((quantity) => quantity.value)
|
|
802
|
+
if (values.length >= 1) {
|
|
803
|
+
const wanted = requirement.value
|
|
804
|
+
const wantedExtra = Number(requirement.extra ?? wanted)
|
|
805
|
+
const pairMatch = values.some((value, index) => {
|
|
806
|
+
if (index + 1 >= values.length) return false
|
|
807
|
+
const other = values[index + 1]
|
|
808
|
+
return (Math.abs(value - wanted) <= wanted * 0.2 && Math.abs(other - wantedExtra) <= wantedExtra * 0.25) ||
|
|
809
|
+
(Math.abs(value - wantedExtra) <= wantedExtra * 0.2 && Math.abs(other - wanted) <= wanted * 0.25)
|
|
810
|
+
})
|
|
811
|
+
if (!pairMatch) return { ok: false, matched }
|
|
812
|
+
}
|
|
813
|
+
matched.push(`size=${requirement.raw}`)
|
|
814
|
+
continue
|
|
815
|
+
}
|
|
816
|
+
const values = quantities.filter((quantity) => quantity.kind === requirement.kind).map((quantity) => quantity.value)
|
|
817
|
+
if (values.length === 0) return { ok: false, matched }
|
|
818
|
+
if (!values.some((value) => satisfies(value, requirement))) return { ok: false, matched }
|
|
819
|
+
matched.push(`${requirement.kind}=${requirement.raw}`)
|
|
820
|
+
}
|
|
821
|
+
return { ok: true, matched }
|
|
822
|
+
}
|
|
823
|
+
|
|
824
|
+
/**
|
|
825
|
+
* Explain why a candidate fails the parsed requirement (used by the relaxed
|
|
826
|
+
* fallback, so the agent can tell the user which constraint could not be met).
|
|
827
|
+
* @param {Record<string, unknown>} item
|
|
828
|
+
* @param {ReturnType<typeof parseNeed>} need
|
|
829
|
+
* @returns {string[]}
|
|
830
|
+
*/
|
|
831
|
+
export function mismatchReasons(item, need) {
|
|
832
|
+
const reasons = []
|
|
833
|
+
if (need.directCode !== undefined && String(item.code).toUpperCase() !== need.directCode) {
|
|
834
|
+
reasons.push(`LCSC 编号为 ${item.code}，不是 ${need.directCode}`)
|
|
835
|
+
}
|
|
836
|
+
if (need.modelGuess === true && !normalizeModelToken(item.model).includes(need.modelToken ?? '')) {
|
|
837
|
+
reasons.push(`型号 ${item.model ?? '?'} 与 ${need.exactValue ?? '?'} 不完全一致`)
|
|
838
|
+
}
|
|
839
|
+
if (need.package !== undefined && item.package !== undefined && !packageMatches(item.package, need.package)) {
|
|
840
|
+
reasons.push(`封装 ${item.package} ≠ ${need.package}`)
|
|
841
|
+
}
|
|
842
|
+
const text = candidateText(item)
|
|
843
|
+
if (need.dielectric !== undefined && !text.includes(need.dielectric.toLowerCase())) {
|
|
844
|
+
reasons.push(`介质/温度特性不含 ${need.dielectric}`)
|
|
845
|
+
}
|
|
846
|
+
if (need.categories.length > 0 && !need.categories.some((category) => text.includes(category.toLowerCase()))) {
|
|
847
|
+
reasons.push(`品类不匹配（期望 ${need.categories.slice(0, 2).join(' / ')}）`)
|
|
848
|
+
}
|
|
849
|
+
const quantities = extractCandidateQuantities(item)
|
|
850
|
+
for (const requirement of need.requirements) {
|
|
851
|
+
if (requirement.kind === 'size') continue
|
|
852
|
+
const values = quantities.filter((quantity) => quantity.kind === requirement.kind).map((quantity) => quantity.value)
|
|
853
|
+
if (values.length === 0) {
|
|
854
|
+
reasons.push(`缺少参数 ${requirement.kind}`)
|
|
855
|
+
} else if (!values.some((value) => satisfies(value, requirement))) {
|
|
856
|
+
reasons.push(`参数 ${requirement.kind} 不满足 ${requirement.comparator ?? '='} ${requirement.raw ?? requirement.value}`)
|
|
857
|
+
}
|
|
858
|
+
if (reasons.length >= 4) break
|
|
859
|
+
}
|
|
860
|
+
return reasons
|
|
861
|
+
}
|
|
862
|
+
|
|
863
|
+
/** Pick the ladder tier for `qty`, returning both the used threshold and price. */
|
|
864
|
+
export function pickTier(tiers, qty) {
|
|
865
|
+
if (!Array.isArray(tiers) || tiers.length === 0) return undefined
|
|
866
|
+
const sorted = tiers
|
|
867
|
+
.filter((tier) => isRecord(tier) && Number.isFinite(asNumber(tier.qty)) && Number.isFinite(asNumber(tier.unit)))
|
|
868
|
+
.map((tier) => ({ qty: Number(tier.qty), unit: Number(tier.unit) }))
|
|
869
|
+
.sort((left, right) => left.qty - right.qty)
|
|
870
|
+
if (sorted.length === 0) return undefined
|
|
871
|
+
let chosen = sorted[0]
|
|
872
|
+
for (const tier of sorted) {
|
|
873
|
+
if (qty >= tier.qty) chosen = tier
|
|
874
|
+
else break
|
|
875
|
+
}
|
|
876
|
+
return { qty: chosen.qty, unit: chosen.unit, label: `${chosen.qty}+` }
|
|
877
|
+
}
|
|
878
|
+
|
|
879
|
+
/**
|
|
880
|
+
* Compare footprints for a substitution: same package = drop-in, otherwise the
|
|
881
|
+
* PCB needs a change.
|
|
882
|
+
* @param {string | undefined} left
|
|
883
|
+
* @param {string | undefined} right
|
|
884
|
+
*/
|
|
885
|
+
export function footprintCompatible(left, right) {
|
|
886
|
+
if (left === undefined || right === undefined) return undefined
|
|
887
|
+
return packageMatches(left, right)
|
|
888
|
+
}
|
|
889
|
+
|
|
890
|
+
/* -------------------------------------------------------------------------- */
|
|
891
|
+
/* Scoring */
|
|
892
|
+
/* -------------------------------------------------------------------------- */
|
|
893
|
+
|
|
894
|
+
/**
|
|
895
|
+
* @typedef {object} ScoreContext
|
|
896
|
+
* @property {'hand' | 'smt'} assembly
|
|
897
|
+
* @property {number} quantity components per board
|
|
898
|
+
* @property {number} boards board count
|
|
899
|
+
* @property {number} orderQty total parts to buy
|
|
900
|
+
* @property {'balanced' | 'cost' | 'stock'} sort
|
|
901
|
+
*/
|
|
902
|
+
|
|
903
|
+
/**
|
|
904
|
+
* Score one candidate.
|
|
905
|
+
* @param {Record<string, unknown>} item
|
|
906
|
+
* @param {ReturnType<typeof parseNeed>} need
|
|
907
|
+
* @param {ScoreContext} context
|
|
908
|
+
*/
|
|
909
|
+
export function scoreCandidate(item, need, context) {
|
|
910
|
+
const match = candidateMatches(item, need)
|
|
911
|
+
const tiers = Array.isArray(item.priceUsdTiers) ? item.priceUsdTiers : []
|
|
912
|
+
const unitUsd = pickTierPrice(tiers, context.orderQty)
|
|
913
|
+
const expand = String(item.libraryType ?? '').toLowerCase() !== 'base'
|
|
914
|
+
const modelExact =
|
|
915
|
+
context.modelToken === undefined
|
|
916
|
+
? false
|
|
917
|
+
: String(item.model ?? '').replace(/[^A-Za-z0-9]/g, '').toUpperCase() === context.modelToken
|
|
918
|
+
const extendedFeeUsd = context.assembly === 'smt' && expand ? EXTENDED_PART_FEE_USD : 0
|
|
919
|
+
const feePerBoardUsd = extendedFeeUsd === 0 ? 0 : extendedFeeUsd / Math.max(1, context.boards)
|
|
920
|
+
const unitEffectiveUsd =
|
|
921
|
+
unitUsd === undefined
|
|
922
|
+
? undefined
|
|
923
|
+
: unitUsd + (context.assembly === 'smt' ? feePerBoardUsd / Math.max(1, context.quantity) : 0)
|
|
924
|
+
return { item, match, unitUsd, unitEffectiveUsd, extendedFeeUsd, feePerBoardUsd, expand, modelExact }
|
|
925
|
+
}
|
|
926
|
+
|
|
927
|
+
/** @param {number} stock */
|
|
928
|
+
function stockScore(stock) {
|
|
929
|
+
if (!Number.isFinite(stock) || stock <= 0) return 0
|
|
930
|
+
return Math.min(1, Math.max(0, Math.log10(stock + 1) / 7))
|
|
931
|
+
}
|
|
932
|
+
|
|
933
|
+
/**
|
|
934
|
+
* Rank scored candidates (already filtered by `match.ok`).
|
|
935
|
+
* @param {ReturnType<typeof scoreCandidate>[]} candidates
|
|
936
|
+
* @param {ScoreContext} context
|
|
937
|
+
* @param {number} neededQty
|
|
938
|
+
*/
|
|
939
|
+
export function rankCandidates(candidates, context, neededQty) {
|
|
940
|
+
const priced = candidates.filter((candidate) => candidate.unitEffectiveUsd !== undefined)
|
|
941
|
+
const unitValues = priced.map((candidate) => candidate.unitEffectiveUsd)
|
|
942
|
+
const minUnit = unitValues.length > 0 ? Math.min(...unitValues) : 0
|
|
943
|
+
const maxUnit = unitValues.length > 0 ? Math.max(...unitValues) : 0
|
|
944
|
+
const weights =
|
|
945
|
+
context.sort === 'cost'
|
|
946
|
+
? { cost: 0.75, stock: 0.1, cover: 0.05, library: 0.05, params: 0.05 }
|
|
947
|
+
: context.sort === 'stock'
|
|
948
|
+
? { cost: 0.2, stock: 0.55, cover: 0.15, library: 0.05, params: 0.05 }
|
|
949
|
+
: context.assembly === 'smt'
|
|
950
|
+
? { cost: 0.4, stock: 0.25, cover: 0.15, library: 0.1, params: 0.1 }
|
|
951
|
+
: { cost: 0.5, stock: 0.3, cover: 0.1, library: 0.0, params: 0.1 }
|
|
952
|
+
const scored = candidates.map((candidate) => {
|
|
953
|
+
const unit = candidate.unitEffectiveUsd
|
|
954
|
+
const costScore = unit === undefined
|
|
955
|
+
? 0.2
|
|
956
|
+
: maxUnit === minUnit
|
|
957
|
+
? 1
|
|
958
|
+
: 1 - (unit - minUnit) / (maxUnit - minUnit)
|
|
959
|
+
const stock = asInteger(candidate.item.stock) ?? 0
|
|
960
|
+
const cover = neededQty <= 0 ? 1 : Math.min(1, stock / Math.max(1, neededQty * 1.5))
|
|
961
|
+
const library =
|
|
962
|
+
context.assembly === 'smt' ? (candidate.expand ? 0 : 1) : 0.5
|
|
963
|
+
const params = needParamScore(candidate.match)
|
|
964
|
+
const score =
|
|
965
|
+
weights.cost * costScore +
|
|
966
|
+
weights.stock * stockScore(stock) +
|
|
967
|
+
weights.cover * cover +
|
|
968
|
+
weights.library * library +
|
|
969
|
+
weights.params * params
|
|
970
|
+
return { ...candidate, score: Math.round(score * 1000) / 1000, stock, cover }
|
|
971
|
+
})
|
|
972
|
+
scored.sort((left, right) => {
|
|
973
|
+
if (left.modelExact !== right.modelExact) return left.modelExact ? -1 : 1
|
|
974
|
+
if (right.score !== left.score) return right.score - left.score
|
|
975
|
+
const leftUnit = left.unitEffectiveUsd ?? Number.POSITIVE_INFINITY
|
|
976
|
+
const rightUnit = right.unitEffectiveUsd ?? Number.POSITIVE_INFINITY
|
|
977
|
+
if (leftUnit !== rightUnit) return leftUnit - rightUnit
|
|
978
|
+
return right.stock - left.stock
|
|
979
|
+
})
|
|
980
|
+
return scored
|
|
981
|
+
}
|
|
982
|
+
|
|
983
|
+
/** @param {{ matched: string[] }} match */
|
|
984
|
+
function needParamScore(match) {
|
|
985
|
+
return match.matched !== undefined && match.matched.length > 0 ? 1 : 0.5
|
|
986
|
+
}
|
|
987
|
+
|
|
988
|
+
/* -------------------------------------------------------------------------- */
|
|
989
|
+
/* Suggestion / output helpers */
|
|
990
|
+
/* -------------------------------------------------------------------------- */
|
|
991
|
+
|
|
992
|
+
/** Pick the attributes worth showing to the model (max 6). */
|
|
993
|
+
function pickSpecs(item) {
|
|
994
|
+
const preferred = /capacitance|resistance|inductance|voltage rating|output voltage|output current|current - output|tolerance|temperature coefficient|drain-source|forward current|power|package|size|dimension/i
|
|
995
|
+
const specs = []
|
|
996
|
+
for (const attribute of attributesOf(item)) {
|
|
997
|
+
if (!preferred.test(attribute.name)) continue
|
|
998
|
+
specs.push({ name: attribute.name, value: attribute.value })
|
|
999
|
+
if (specs.length >= 6) break
|
|
1000
|
+
}
|
|
1001
|
+
return specs
|
|
1002
|
+
}
|
|
1003
|
+
|
|
1004
|
+
/** @param {ReturnType<typeof scoreCandidate>} candidate @param {ScoreContext} context */
|
|
1005
|
+
function reasonsFor(candidate, context) {
|
|
1006
|
+
const reasons = []
|
|
1007
|
+
if (context.assembly === 'smt') {
|
|
1008
|
+
reasons.push(
|
|
1009
|
+
candidate.expand
|
|
1010
|
+
? `扩展库：每片板摊 $${money(candidate.feePerBoardUsd)} 上料费（每料号 $${EXTENDED_PART_FEE_USD}/单）`
|
|
1011
|
+
: '基础库：无上料费',
|
|
1012
|
+
)
|
|
1013
|
+
}
|
|
1014
|
+
if (candidate.unitUsd !== undefined) {
|
|
1015
|
+
reasons.push(`阶梯价 $${candidate.unitUsd}（按采购量 ${context.orderQty}）`)
|
|
1016
|
+
}
|
|
1017
|
+
reasons.push(`库存 ${candidate.stock}`)
|
|
1018
|
+
if (candidate.cover >= 1) reasons.push(`库存覆盖需求（${Math.round(candidate.cover * 100)}%）`)
|
|
1019
|
+
else if (candidate.cover < 1) reasons.push(`库存仅覆盖需求的 ${Math.round(candidate.cover * 100)}%`)
|
|
1020
|
+
if (candidate.modelExact === true) reasons.push('型号精确匹配')
|
|
1021
|
+
if (candidate.match.matched.length > 0) reasons.push(`参数匹配：${candidate.match.matched.slice(0, 4).join(', ')}`)
|
|
1022
|
+
return reasons
|
|
1023
|
+
}
|
|
1024
|
+
|
|
1025
|
+
/**
|
|
1026
|
+
* Find requirement-matching parts.
|
|
1027
|
+
* @param {ReturnType<typeof createLcscService>} service
|
|
1028
|
+
* @param {Record<string, unknown>} args
|
|
1029
|
+
* @param {{ signal?: AbortSignal }} [options]
|
|
1030
|
+
*/
|
|
1031
|
+
/** Identity constraints that must not be relaxed when looking for substitutes. */
|
|
1032
|
+
const IDENTITY_REQUIREMENT_KINDS = new Set(['capacitance', 'resistance', 'inductance', 'pins'])
|
|
1033
|
+
|
|
1034
|
+
/** Pin/contact count reported by the JLCPCB attributes, if available. */
|
|
1035
|
+
function candidatePinCount(item) {
|
|
1036
|
+
for (const attribute of attributesOf(item)) {
|
|
1037
|
+
if (/number of (contacts|positions|pins)|contacts|positions|pin count|number of pins/i.test(attribute.name)) {
|
|
1038
|
+
const match = attribute.value.match(/\d{1,3}/)
|
|
1039
|
+
if (match !== null) return Number(match[0])
|
|
1040
|
+
}
|
|
1041
|
+
}
|
|
1042
|
+
const pins = extractCandidateQuantities(item).find((quantity) => quantity.kind === 'pins')
|
|
1043
|
+
return pins === undefined ? undefined : pins.value
|
|
1044
|
+
}
|
|
1045
|
+
|
|
1046
|
+
/**
|
|
1047
|
+
* Find requirement-matching parts.
|
|
1048
|
+
* @param {ReturnType<typeof createLcscService>} service
|
|
1049
|
+
* @param {Record<string, unknown>} args
|
|
1050
|
+
* @param {{ signal?: AbortSignal }} [options]
|
|
1051
|
+
*/
|
|
1052
|
+
export async function findParts(service, args, options = {}) {
|
|
1053
|
+
const needText = asString(args.need)
|
|
1054
|
+
if (needText === undefined) throw new Error('find_lcsc_parts requires a non-empty `need` string')
|
|
1055
|
+
const assembly = args.assembly === 'smt' ? 'smt' : 'hand'
|
|
1056
|
+
const quantity = clampInteger(args.quantity, 1, 100000, 1)
|
|
1057
|
+
const boards = clampInteger(args.boards, 1, 100000, 1)
|
|
1058
|
+
const limit = clampInteger(args.limit, 1, MAX_CANDIDATES, DEFAULT_LIMIT)
|
|
1059
|
+
const sort = ['cost', 'stock'].includes(args.sort) ? args.sort : 'balanced'
|
|
1060
|
+
const baseOnly = args.base_only === true
|
|
1061
|
+
const requireStock = ['lcsc', 'smt'].includes(args.require_stock) ? args.require_stock : 'any'
|
|
1062
|
+
const includeCny = args.include_cny === true || (args.include_cny === undefined && assembly === 'hand') || requireStock === 'lcsc'
|
|
1063
|
+
const exclude = new Set(
|
|
1064
|
+
(Array.isArray(args.exclude_lcsc) ? args.exclude_lcsc : [])
|
|
1065
|
+
.map((code) => normalizeCode(code))
|
|
1066
|
+
.filter(Boolean),
|
|
1067
|
+
)
|
|
1068
|
+
const need = parseNeed(needText)
|
|
1069
|
+
const orderQty = quantity * boards
|
|
1070
|
+
const feeUsd = asNumber(service.settings?.extendedPartFeeUsd) ?? EXTENDED_PART_FEE_USD
|
|
1071
|
+
const usdToCnyFactor = asNumber(service.settings?.usdToCnyFactor) ?? 6.0
|
|
1072
|
+
const context = {
|
|
1073
|
+
assembly,
|
|
1074
|
+
quantity,
|
|
1075
|
+
boards,
|
|
1076
|
+
orderQty,
|
|
1077
|
+
sort,
|
|
1078
|
+
modelToken: need.modelGuess ? need.modelToken : undefined,
|
|
1079
|
+
feeUsd,
|
|
1080
|
+
}
|
|
1081
|
+
const notes = []
|
|
1082
|
+
const hints = []
|
|
1083
|
+
|
|
1084
|
+
/** @type {Map<string, Record<string, unknown>>} */
|
|
1085
|
+
const pool = new Map()
|
|
1086
|
+
/** @param {{ total: number, items: Record<string, unknown>[] }} result */
|
|
1087
|
+
const absorb = (result) => {
|
|
1088
|
+
for (const item of result.items) {
|
|
1089
|
+
if (!pool.has(String(item.code))) pool.set(String(item.code), item)
|
|
1090
|
+
}
|
|
1091
|
+
return pool.size
|
|
1092
|
+
}
|
|
1093
|
+
|
|
1094
|
+
// ---- Phase 1: candidate recall -------------------------------------------
|
|
1095
|
+
const queries = []
|
|
1096
|
+
if (need.exact) {
|
|
1097
|
+
queries.push({ keyword: need.searchKeyword })
|
|
1098
|
+
} else if (assembly === 'smt') {
|
|
1099
|
+
// Search the base library first so free-to-load parts are not drowned out.
|
|
1100
|
+
queries.push({ keyword: need.searchKeyword, libraryType: 'base' })
|
|
1101
|
+
queries.push({ keyword: need.searchKeyword })
|
|
1102
|
+
} else {
|
|
1103
|
+
queries.push({ keyword: need.searchKeyword })
|
|
1104
|
+
}
|
|
1105
|
+
for (const query of queries) {
|
|
1106
|
+
const result = await service.searchRaw(query.keyword, {
|
|
1107
|
+
pageSize: SEARCH_PAGE_SIZE,
|
|
1108
|
+
libraryType: query.libraryType,
|
|
1109
|
+
signal: options.signal,
|
|
1110
|
+
})
|
|
1111
|
+
absorb(result)
|
|
1112
|
+
}
|
|
1113
|
+
// Degradation chain for recall: simplified category terms -> English tokens
|
|
1114
|
+
// in the raw text -> package+category -> raw text. This keeps Chinese
|
|
1115
|
+
// colloquial requirements ("MEMS 麦克风", "USB Type-C 16P 母座") searchable.
|
|
1116
|
+
if (pool.size === 0 && !need.exact) {
|
|
1117
|
+
for (const fallbackKeyword of recallFallbackKeywords(need)) {
|
|
1118
|
+
if (pool.size > 0) break
|
|
1119
|
+
notes.push(`关键词「${need.searchKeyword}」无结果，回退到「${fallbackKeyword}」。`)
|
|
1120
|
+
absorb(await service.searchRaw(fallbackKeyword, { pageSize: SEARCH_PAGE_SIZE, signal: options.signal }))
|
|
1121
|
+
}
|
|
1122
|
+
}
|
|
1123
|
+
if (pool.size === 0 && need.exact) {
|
|
1124
|
+
// The code/model search found nothing; the text may still be a model with
|
|
1125
|
+
// punctuation that the API search does not match verbatim.
|
|
1126
|
+
absorb(await service.searchRaw(need.raw, { pageSize: SEARCH_PAGE_SIZE, signal: options.signal }))
|
|
1127
|
+
}
|
|
1128
|
+
|
|
1129
|
+
// ---- Phase 2: strict filter, then staged relaxation ----------------------
|
|
1130
|
+
const usablePool = () =>
|
|
1131
|
+
[...pool.values()]
|
|
1132
|
+
.filter((item) => !exclude.has(String(item.code)))
|
|
1133
|
+
.filter((item) => (asInteger(item.stock) ?? 0) > 0)
|
|
1134
|
+
const scoreWith = (needForFilter) =>
|
|
1135
|
+
usablePool()
|
|
1136
|
+
.map((item) => scoreCandidate(item, needForFilter, context))
|
|
1137
|
+
.filter((candidate) => candidate.match.ok)
|
|
1138
|
+
|
|
1139
|
+
let relaxed = false
|
|
1140
|
+
let relaxStage = 0
|
|
1141
|
+
let droppedRequirements = []
|
|
1142
|
+
let scored = scoreWith(need)
|
|
1143
|
+
if (scored.length === 0 && !need.exact && need.requirements.length > 0) {
|
|
1144
|
+
// Stage 1: keep identity (value/package) constraints, relax ratings.
|
|
1145
|
+
const identity = need.requirements.filter((requirement) => IDENTITY_REQUIREMENT_KINDS.has(requirement.kind))
|
|
1146
|
+
if (identity.length !== need.requirements.length) {
|
|
1147
|
+
const stageScored = scoreWith({ ...need, requirements: identity })
|
|
1148
|
+
if (stageScored.length > 0) {
|
|
1149
|
+
scored = stageScored
|
|
1150
|
+
relaxed = true
|
|
1151
|
+
relaxStage = 1
|
|
1152
|
+
droppedRequirements = need.requirements
|
|
1153
|
+
.filter((requirement) => !IDENTITY_REQUIREMENT_KINDS.has(requirement.kind))
|
|
1154
|
+
.map((requirement) => requirement.raw ?? requirement.kind)
|
|
1155
|
+
notes.push(`严格匹配无结果：已放宽非核心参数（${droppedRequirements.join('、')}），保留容值/阻值/感值/引脚数等身份参数。`)
|
|
1156
|
+
}
|
|
1157
|
+
}
|
|
1158
|
+
// Stage 2: drop the remaining requirements, keep package/category.
|
|
1159
|
+
if (scored.length === 0) {
|
|
1160
|
+
const stageScored = scoreWith({ ...need, requirements: [] })
|
|
1161
|
+
if (stageScored.length > 0) {
|
|
1162
|
+
scored = stageScored
|
|
1163
|
+
relaxed = true
|
|
1164
|
+
relaxStage = 2
|
|
1165
|
+
droppedRequirements = need.requirements.map((requirement) => requirement.raw ?? requirement.kind)
|
|
1166
|
+
notes.push('严格匹配无结果：已仅按封装/品类筛候选，参数需人工核对（见每行 mismatch_reasons）。')
|
|
1167
|
+
}
|
|
1168
|
+
}
|
|
1169
|
+
// Stage 3: last resort, everything in the recall pool.
|
|
1170
|
+
if (scored.length === 0) {
|
|
1171
|
+
scored = usablePool().map((item) => ({
|
|
1172
|
+
...scoreCandidate(item, need, context),
|
|
1173
|
+
match: { ok: true, matched: [] },
|
|
1174
|
+
}))
|
|
1175
|
+
if (scored.length > 0) {
|
|
1176
|
+
relaxed = true
|
|
1177
|
+
relaxStage = 3
|
|
1178
|
+
notes.push('没有满足条件的候选；以下为最接近的候选，不匹配原因见 mismatch_reasons。')
|
|
1179
|
+
}
|
|
1180
|
+
}
|
|
1181
|
+
}
|
|
1182
|
+
|
|
1183
|
+
if (baseOnly) {
|
|
1184
|
+
const baseCandidates = scored.filter((candidate) => !candidate.expand)
|
|
1185
|
+
if (baseCandidates.length === 0) {
|
|
1186
|
+
hints.push('该品类没有找到基础库（base library）候选；可去掉 base_only 或接受扩展库（SMT 每料号有上料费）。')
|
|
1187
|
+
} else {
|
|
1188
|
+
scored = baseCandidates
|
|
1189
|
+
}
|
|
1190
|
+
}
|
|
1191
|
+
if (assembly === 'smt' && !baseOnly) {
|
|
1192
|
+
const hasBase = scored.some((candidate) => !candidate.expand) ||
|
|
1193
|
+
[...pool.values()].some((item) => String(item.libraryType).toLowerCase() === 'base')
|
|
1194
|
+
if (!hasBase && scored.length > 0) {
|
|
1195
|
+
hints.push(`该品类未找到基础库候选（均为扩展库，$${feeUsd}/料号上料费）；请到下单页确认优选扩展库分类。`)
|
|
1196
|
+
}
|
|
1197
|
+
}
|
|
1198
|
+
|
|
1199
|
+
let ranked = rankCandidates(scored, context, orderQty)
|
|
1200
|
+
|
|
1201
|
+
// ---- Phase 3: real CNY prices (domestic store via Chrome) ----------------
|
|
1202
|
+
/** @type {Map<string, Record<string, unknown>>} */
|
|
1203
|
+
const cnyByCode = new Map()
|
|
1204
|
+
if (includeCny && ranked.length > 0) {
|
|
1205
|
+
const cnyLookupCount = requireStock === 'lcsc' ? Math.min(10, ranked.length) : Math.min(MAX_CNY_LOOKUPS, ranked.length)
|
|
1206
|
+
const targets = ranked.slice(0, cnyLookupCount)
|
|
1207
|
+
const results = await mapLimit(targets, 2, async (candidate) => {
|
|
1208
|
+
const code = String(candidate.item.code)
|
|
1209
|
+
try {
|
|
1210
|
+
if (typeof service.cn?.query === 'function') {
|
|
1211
|
+
const cn = await service.cn.query(code)
|
|
1212
|
+
// Keep the adapter's own failure reason (chrome-not-found, WAF, …) so
|
|
1213
|
+
// the caller can see WHY real CNY is missing and how to fix it.
|
|
1214
|
+
if (cn !== undefined && cn !== null) return cn
|
|
1215
|
+
}
|
|
1216
|
+
if (typeof service.cny === 'function') return await service.cny(code, options.signal)
|
|
1217
|
+
return { ok: false, reason: 'cny-adapter-unavailable' }
|
|
1218
|
+
} catch (error) {
|
|
1219
|
+
return { ok: false, reason: error instanceof Error ? error.message : String(error) }
|
|
1220
|
+
}
|
|
1221
|
+
})
|
|
1222
|
+
for (let index = 0; index < targets.length; index += 1) {
|
|
1223
|
+
cnyByCode.set(String(targets[index].item.code), results[index])
|
|
1224
|
+
}
|
|
1225
|
+
const covered = [...cnyByCode.values()].filter((result) => result?.ok === true).length
|
|
1226
|
+
if (covered > 0) {
|
|
1227
|
+
notes.push(`人民币价来自立创商城国内站（Chrome 渲染，${covered}/${targets.length} 个候选取到 CNY，24h 缓存）。USD 与 CNY 并列，不混算。`)
|
|
1228
|
+
}
|
|
1229
|
+
const cnyFailure = cnFailureHint(results, service.cn)
|
|
1230
|
+
if (cnyFailure !== undefined) hints.push(cnyFailure)
|
|
1231
|
+
}
|
|
1232
|
+
|
|
1233
|
+
// require_stock: DIY defaults to the retail warehouse; PCBA can ask for SMT.
|
|
1234
|
+
if (requireStock !== 'any' && ranked.length > 0) {
|
|
1235
|
+
const kept = []
|
|
1236
|
+
const dropped = []
|
|
1237
|
+
for (const candidate of ranked) {
|
|
1238
|
+
const code = String(candidate.item.code)
|
|
1239
|
+
const smtStock = asInteger(candidate.item.stock) ?? 0
|
|
1240
|
+
const cn = cnyByCode.get(code)
|
|
1241
|
+
const retailStock = cn?.ok === true ? asInteger(cn.stock) : undefined
|
|
1242
|
+
if (requireStock === 'smt') {
|
|
1243
|
+
if (smtStock > 0) kept.push(candidate)
|
|
1244
|
+
else dropped.push(code)
|
|
1245
|
+
} else if (retailStock !== undefined && retailStock > 0) {
|
|
1246
|
+
kept.push(candidate)
|
|
1247
|
+
} else {
|
|
1248
|
+
dropped.push(code)
|
|
1249
|
+
}
|
|
1250
|
+
}
|
|
1251
|
+
if (kept.length < ranked.length) {
|
|
1252
|
+
notes.push(`require_stock=${requireStock}：${dropped.length} 个候选因库存口径不满足被跳过${dropped.length > 0 ? `（如 ${dropped.slice(0, 4).join(', ')}）` : ''}。`)
|
|
1253
|
+
}
|
|
1254
|
+
if (kept.length === 0) hints.push(`require_stock=${requireStock} 时没有库存满足的候选；可改用 require_stock="any" 查看全部。`)
|
|
1255
|
+
ranked = kept
|
|
1256
|
+
}
|
|
1257
|
+
|
|
1258
|
+
// ---- Phase 4: build output ----------------------------------------------
|
|
1259
|
+
const candidates = ranked.slice(0, limit).map((candidate) => {
|
|
1260
|
+
const code = String(candidate.item.code)
|
|
1261
|
+
const cny = cnyByCode.get(code)
|
|
1262
|
+
const cnyUnit = cny?.ok === true ? asNumber(cny.unit) : undefined
|
|
1263
|
+
const cnyStock = cny?.ok === true ? asInteger(cny.stock) : undefined
|
|
1264
|
+
const tier = pickTier(candidate.item.priceUsdTiers, orderQty)
|
|
1265
|
+
const bulkUsd = bulkTierUsd(candidate.item)
|
|
1266
|
+
const cnyEstimate = cnyUnit === undefined ? estimateCnyFromUsd(bulkUsd, usdToCnyFactor) : undefined
|
|
1267
|
+
const stockSmt = asInteger(candidate.item.stock) ?? 0
|
|
1268
|
+
const stockLcsc = cnyStock ?? null
|
|
1269
|
+
const stock = assembly === 'smt' ? stockSmt : (stockLcsc ?? stockSmt)
|
|
1270
|
+
const stockAsOf = cny?.ok === true ? (cny.fetched_at ?? new Date().toISOString()) : new Date().toISOString()
|
|
1271
|
+
const dataWarnings = []
|
|
1272
|
+
if (stockLcsc === 0 && stockSmt > 0) dataWarnings.push('retail_out_of_stock_smt_ok')
|
|
1273
|
+
if (stockLcsc !== null && stockLcsc > 0 && stockSmt === 0) dataWarnings.push('smt_out_of_stock_retail_ok')
|
|
1274
|
+
const priceUsd = tier === undefined
|
|
1275
|
+
? null
|
|
1276
|
+
: {
|
|
1277
|
+
currency: 'USD',
|
|
1278
|
+
unit: money(tier.unit),
|
|
1279
|
+
tier: tier.label,
|
|
1280
|
+
source: 'jlcpcb-smt',
|
|
1281
|
+
tiers: (candidate.item.priceUsdTiers ?? []).slice(0, 8).map((entry) => ({ qty: entry.qty, unit: money(entry.unit) })),
|
|
1282
|
+
}
|
|
1283
|
+
const priceCny = cnyUnit !== undefined
|
|
1284
|
+
? {
|
|
1285
|
+
currency: 'CNY',
|
|
1286
|
+
unit: money(cnyUnit),
|
|
1287
|
+
source: cny.source ?? 'lcsc_cn_render',
|
|
1288
|
+
estimated: false,
|
|
1289
|
+
cached: cny.cached === true,
|
|
1290
|
+
fetched_at: cny.fetched_at,
|
|
1291
|
+
}
|
|
1292
|
+
: cnyEstimate === undefined
|
|
1293
|
+
? null
|
|
1294
|
+
: {
|
|
1295
|
+
currency: 'CNY',
|
|
1296
|
+
unit: cnyEstimate,
|
|
1297
|
+
source: 'usd_x_factor',
|
|
1298
|
+
estimated: true,
|
|
1299
|
+
factor: usdToCnyFactor,
|
|
1300
|
+
note: '参考估算（批量档 USD × 系数），非实际报价',
|
|
1301
|
+
}
|
|
1302
|
+
// The primary `price` field is the actual reference price. In hand mode a
|
|
1303
|
+
// real CNY price wins; when CNY is only an estimate, USD stays primary (the
|
|
1304
|
+
// estimate is still exposed in price_cny/cny_estimate and clearly labelled).
|
|
1305
|
+
const primaryPrice = assembly === 'smt'
|
|
1306
|
+
? priceUsd
|
|
1307
|
+
: (priceCny !== null && priceCny.estimated !== true ? priceCny : (priceUsd ?? priceCny))
|
|
1308
|
+
return {
|
|
1309
|
+
lcsc: candidate.item.code,
|
|
1310
|
+
model: candidate.item.model,
|
|
1311
|
+
brand: candidate.item.brand,
|
|
1312
|
+
package: candidate.item.package,
|
|
1313
|
+
category: candidate.item.category,
|
|
1314
|
+
pin_count: candidatePinCount(candidate.item),
|
|
1315
|
+
library: candidate.expand ? 'expand' : 'base',
|
|
1316
|
+
preferred: candidate.item.preferred === true ? true : null,
|
|
1317
|
+
stock,
|
|
1318
|
+
stock_retail: stockLcsc,
|
|
1319
|
+
stock_smt: stockSmt,
|
|
1320
|
+
stock_global: null,
|
|
1321
|
+
stock_lcsc: stockLcsc,
|
|
1322
|
+
stock_asof: stockAsOf,
|
|
1323
|
+
stock_scope: assembly,
|
|
1324
|
+
stock_scope_note: assembly === 'smt'
|
|
1325
|
+
? 'SMT 库存（嘉立创 PCBA 备料仓），与立创商城零售库存独立'
|
|
1326
|
+
: '立创商城零售库存（DIY 配单）；SMT 库存另列',
|
|
1327
|
+
data_warnings: dataWarnings.length === 0 ? undefined : dataWarnings,
|
|
1328
|
+
coverage: orderQty > 0 ? Math.min(1, Math.round((stock / orderQty) * 100) / 100) : undefined,
|
|
1329
|
+
price: primaryPrice === null ? undefined : { currency: primaryPrice.currency, unit: primaryPrice.unit, source: primaryPrice.source },
|
|
1330
|
+
price_usd: priceUsd,
|
|
1331
|
+
price_cny: priceCny,
|
|
1332
|
+
used_tier: tier?.label ?? null,
|
|
1333
|
+
effective_unit_usd: candidate.unitEffectiveUsd === undefined ? undefined : money(candidate.unitEffectiveUsd),
|
|
1334
|
+
fee_per_board_usd: assembly === 'smt' ? money(candidate.feePerBoardUsd) : 0,
|
|
1335
|
+
cny_price: cnyUnit === undefined ? null : money(cnyUnit),
|
|
1336
|
+
cny_estimate: priceCny === null || priceCny.estimated !== true
|
|
1337
|
+
? null
|
|
1338
|
+
: { unit: priceCny.unit, factor: usdToCnyFactor, basis: 'highest-volume USD tier × factor', note: '参考估算，非实时汇率/非实际报价' },
|
|
1339
|
+
specs: pickSpecs(candidate.item),
|
|
1340
|
+
score: candidate.score,
|
|
1341
|
+
reasons: reasonsFor(candidate, context),
|
|
1342
|
+
mismatch_reasons: relaxStage >= 2 && need.requirements.length > 0 ? mismatchReasons(candidate.item, need) : undefined,
|
|
1343
|
+
url: asString(candidate.item.url) ?? `https://www.lcsc.com/product-detail/${candidate.item.code}.html`,
|
|
1344
|
+
}
|
|
1345
|
+
})
|
|
1346
|
+
|
|
1347
|
+
if (candidates.length === 0) {
|
|
1348
|
+
hints.push(
|
|
1349
|
+
'没有找到候选。建议：改用型号/LCSC 编号（如 SMF5.0A / TP4054 / C307331）；或减少参数；或把中文品类换成英文（capacitor / resistor / LDO / connector）。',
|
|
1350
|
+
)
|
|
1351
|
+
}
|
|
1352
|
+
if (need.exact) {
|
|
1353
|
+
notes.push(`按${need.directCode !== undefined ? ' LCSC 编号' : '型号'}精确查询（${need.exactValue}），未做参数解析。`)
|
|
1354
|
+
} else if (need.requirements.length > 0) {
|
|
1355
|
+
notes.push(`解析到参数条件：${need.requirements.map((requirement) => `${requirement.kind}${requirement.comparator ?? '='}${requirement.value}`).join(', ')}`)
|
|
1356
|
+
}
|
|
1357
|
+
if (assembly === 'hand') {
|
|
1358
|
+
notes.push('assembly=hand：不考虑嘉立创上料费与基础库偏好；价格优先展示立创商城人民币零售价，USD 并列参考。')
|
|
1359
|
+
} else {
|
|
1360
|
+
notes.push(`assembly=smt：扩展库按每料号 $${feeUsd}/单上料费摊销；基础库优先度体现在排序里。`)
|
|
1361
|
+
}
|
|
1362
|
+
|
|
1363
|
+
const allWarnings = [...new Set(candidates.flatMap((candidate) => candidate.data_warnings ?? []))]
|
|
1364
|
+
if (allWarnings.includes('retail_out_of_stock_smt_ok')) {
|
|
1365
|
+
notes.push('注意：部分候选「立创零售仓缺货、嘉立创 SMT 仓有货」——不是停产；DIY 配单需看 stock_retail，PCBA 可看 stock_smt。')
|
|
1366
|
+
}
|
|
1367
|
+
return {
|
|
1368
|
+
need: needText,
|
|
1369
|
+
exact: need.exact,
|
|
1370
|
+
assembly,
|
|
1371
|
+
quantity,
|
|
1372
|
+
boards,
|
|
1373
|
+
order_qty: orderQty,
|
|
1374
|
+
require_stock: requireStock,
|
|
1375
|
+
stock_scope_note: assembly === 'smt'
|
|
1376
|
+
? '默认按嘉立创 SMT 库存；DIY 配单请传 require_stock="lcsc"'
|
|
1377
|
+
: '默认按立创商城零售库存；PCBA 请传 require_stock="smt"',
|
|
1378
|
+
currency: includeCny ? 'USD + CNY（并列，不混算）' : 'USD（CNY 为参考估算）',
|
|
1379
|
+
relaxed,
|
|
1380
|
+
relax_stage: relaxStage,
|
|
1381
|
+
candidates,
|
|
1382
|
+
data_warnings: allWarnings,
|
|
1383
|
+
hints,
|
|
1384
|
+
notes,
|
|
1385
|
+
fetched_at: new Date().toISOString(),
|
|
1386
|
+
}
|
|
1387
|
+
}
|
|
1388
|
+
|
|
1389
|
+
/* -------------------------------------------------------------------------- */
|
|
1390
|
+
/* BOM audit */
|
|
1391
|
+
/* -------------------------------------------------------------------------- */
|
|
1392
|
+
|
|
1393
|
+
/** @param {unknown} input @returns {{ line: number, code: string, qty: number, designators?: string, comment?: string }[]} */
|
|
1394
|
+
/**
|
|
1395
|
+
* Normalise a per-line placement value to `smt` | `hand` | `dnp`.
|
|
1396
|
+
* A BOM without a placement column inherits the audit's assembly mode: a hand
|
|
1397
|
+
* audit must not label every line `smt` (that contradicted the summary).
|
|
1398
|
+
* @param {unknown} value
|
|
1399
|
+
* @param {'smt' | 'hand'} [fallback]
|
|
1400
|
+
*/
|
|
1401
|
+
export function normalizePlace(value, fallback = 'smt') {
|
|
1402
|
+
const defaultPlace = fallback === 'hand' ? 'hand' : 'smt'
|
|
1403
|
+
const text = String(value ?? '').trim().toLowerCase()
|
|
1404
|
+
if (text === '') return defaultPlace
|
|
1405
|
+
if (/dnp|do ?not|不贴|未贴|不焊|no ?populate|不上件/.test(text)) return 'dnp'
|
|
1406
|
+
if (/hand|手焊|手工|烙铁|manual/.test(text)) return 'hand'
|
|
1407
|
+
if (/smt|贴片|机贴|回流|reflow/.test(text)) return 'smt'
|
|
1408
|
+
return defaultPlace
|
|
1409
|
+
}
|
|
1410
|
+
|
|
1411
|
+
/**
|
|
1412
|
+
* Explain why real CNY prices were missing and tell the calling agent how to
|
|
1413
|
+
* fix the local Chrome configuration. Without this the tool silently degrades
|
|
1414
|
+
* to USD estimates and nobody knows a one-line config change would fix it.
|
|
1415
|
+
* @param {Record<string, unknown>[]} results per-code CNY query results
|
|
1416
|
+
* @param {{ chrome?: { path?: string, source?: string, tried?: string[], hint?: string } } | undefined} adapter
|
|
1417
|
+
* @returns {string | undefined}
|
|
1418
|
+
*/
|
|
1419
|
+
function cnFailureHint(results, adapter) {
|
|
1420
|
+
const total = results.length
|
|
1421
|
+
if (total === 0) return undefined
|
|
1422
|
+
const failed = results.filter((result) => result?.ok !== true)
|
|
1423
|
+
if (failed.length === 0) return undefined
|
|
1424
|
+
const counts = new Map()
|
|
1425
|
+
for (const result of failed) {
|
|
1426
|
+
const reason = String(result?.reason ?? 'unknown')
|
|
1427
|
+
counts.set(reason, (counts.get(reason) ?? 0) + 1)
|
|
1428
|
+
}
|
|
1429
|
+
const breakdown = [...counts.entries()]
|
|
1430
|
+
.sort((left, right) => right[1] - left[1])
|
|
1431
|
+
.map(([reason, count]) => `${reason}×${count}`)
|
|
1432
|
+
.join('，')
|
|
1433
|
+
const parts = [`国内站人民币价 ${total - failed.length}/${total} 成功，失败原因：${breakdown}。`]
|
|
1434
|
+
const transient = ['szlcsc-waf-challenge', 'chrome-render-empty', 'page-parse-failed'].filter((reason) => counts.has(reason))
|
|
1435
|
+
if (counts.has('chrome-not-found')) {
|
|
1436
|
+
parts.push(
|
|
1437
|
+
typeof adapter?.chrome?.hint === 'string'
|
|
1438
|
+
? adapter.chrome.hint
|
|
1439
|
+
: '未找到 Chrome/Chromium：请配置 chromePath 或设置环境变量 CHROME_BIN 后重试。',
|
|
1440
|
+
)
|
|
1441
|
+
} else if (transient.length > 0) {
|
|
1442
|
+
parts.push(
|
|
1443
|
+
'以上失败属阵发问题（阿里云 WAF 限流或页面渲染为空），已自动重试 1 次；' +
|
|
1444
|
+
'稍后重试即可，不需要改配置。成功的料号已写入 24h 缓存，重跑只补失败项。' +
|
|
1445
|
+
'若频繁出现，可把 cnConcurrency 降到 1（默认 2）以减少触发。',
|
|
1446
|
+
)
|
|
1447
|
+
}
|
|
1448
|
+
if (counts.has('product-id-not-found')) {
|
|
1449
|
+
parts.push('部分料号在 EasyEDA 查不到商品 id 映射（常见于新料或国内专属料），重试无效，只能参考 USD 价。')
|
|
1450
|
+
}
|
|
1451
|
+
if (counts.has('cny-adapter-unavailable')) {
|
|
1452
|
+
parts.push('人民币适配器未初始化（Chrome 渲染器未挂载），请检查插件是否完整安装及宿主日志。')
|
|
1453
|
+
}
|
|
1454
|
+
if (counts.has('cn-budget-exceeded')) {
|
|
1455
|
+
parts.push('部分料号超出时间预算未查完；结果已写入 24h 缓存，再调用一次会更快补齐。')
|
|
1456
|
+
}
|
|
1457
|
+
if (adapter?.chrome?.path !== undefined && counts.has('chrome-not-found') === false) {
|
|
1458
|
+
parts.push(`当前 Chrome：${adapter.chrome.path}（来源 ${adapter.chrome.source ?? 'auto'}）。`)
|
|
1459
|
+
}
|
|
1460
|
+
return parts.join('')
|
|
1461
|
+
}
|
|
1462
|
+
|
|
1463
|
+
/** @param {unknown} input @returns {{ rows: { line: number, code: string, qty: number, designators?: string, comment?: string, place?: string }[], skipped: { line: number, raw?: string, comment?: string, designators?: string }[] }} */
|
|
1464
|
+
function parseBomInput(input) {
|
|
1465
|
+
if (typeof input === 'string') {
|
|
1466
|
+
const head = input.slice(0, 8)
|
|
1467
|
+
if (head.startsWith('PK\u0003\u0004') || head.startsWith('PK\u0005\u0006') || head.startsWith('<?xml')) {
|
|
1468
|
+
throw new Error(
|
|
1469
|
+
'audit_lcsc_bom 收到的是 xlsx/二进制内容而不是 BOM 文本：请先在 Excel 里「另存为」CSV/TSV（或转成 CSV 文本）再传入',
|
|
1470
|
+
)
|
|
1471
|
+
}
|
|
1472
|
+
const text = input.trim()
|
|
1473
|
+
if (text === '') throw new Error('audit_lcsc_bom requires a non-empty BOM string')
|
|
1474
|
+
if (text.startsWith('[') || text.startsWith('{')) {
|
|
1475
|
+
let parsed
|
|
1476
|
+
try {
|
|
1477
|
+
parsed = JSON.parse(text)
|
|
1478
|
+
} catch {
|
|
1479
|
+
parsed = undefined
|
|
1480
|
+
}
|
|
1481
|
+
if (Array.isArray(parsed)) return { rows: parseBomRows(parsed), skipped: [] }
|
|
1482
|
+
if (isRecord(parsed) && Array.isArray(parsed.rows)) return { rows: parseBomRows(parsed.rows), skipped: [] }
|
|
1483
|
+
}
|
|
1484
|
+
const detailed = parseBomCsvDetailed(text)
|
|
1485
|
+
return {
|
|
1486
|
+
skipped: detailed.skipped,
|
|
1487
|
+
rows: detailed.rows.map((row) => ({
|
|
1488
|
+
line: row.line,
|
|
1489
|
+
code: normalizeCode(row.code) ?? '',
|
|
1490
|
+
qty: Math.max(1, asInteger(row.qty) ?? 1),
|
|
1491
|
+
designators: row.designators,
|
|
1492
|
+
comment: row.comment,
|
|
1493
|
+
place: row.place,
|
|
1494
|
+
})),
|
|
1495
|
+
}
|
|
1496
|
+
}
|
|
1497
|
+
if (Array.isArray(input)) return { rows: parseBomRows(input), skipped: [] }
|
|
1498
|
+
throw new Error('audit_lcsc_bom requires `bom` as CSV text or an array of {lcsc/code, qty, place} rows')
|
|
1499
|
+
}
|
|
1500
|
+
|
|
1501
|
+
/** @param {unknown[]} rows */
|
|
1502
|
+
function parseBomRows(rows) {
|
|
1503
|
+
const result = []
|
|
1504
|
+
for (const row of rows) {
|
|
1505
|
+
if (!isRecord(row)) continue
|
|
1506
|
+
const code = normalizeCode(row.lcsc ?? row.code ?? row.LCSC)
|
|
1507
|
+
const qty = Math.max(1, asInteger(row.qty ?? row.quantity ?? 1) ?? 1)
|
|
1508
|
+
result.push({
|
|
1509
|
+
line: result.length + 1,
|
|
1510
|
+
code: code ?? '',
|
|
1511
|
+
qty,
|
|
1512
|
+
designators: asString(row.designators ?? row.refs ?? row.ref),
|
|
1513
|
+
comment: asString(row.comment ?? row.description ?? row.model),
|
|
1514
|
+
place: asString(row.place ?? row.mount ?? row.assembly),
|
|
1515
|
+
})
|
|
1516
|
+
}
|
|
1517
|
+
return result
|
|
1518
|
+
}
|
|
1519
|
+
|
|
1520
|
+
/**
|
|
1521
|
+
* Merge BOM rows that reference the same LCSC code: quantities and designators
|
|
1522
|
+
* are combined, the feeder fee is charged once per unique part, and the price
|
|
1523
|
+
* tier is taken at the combined order quantity.
|
|
1524
|
+
*/
|
|
1525
|
+
function mergeBomRows(rows, assembly = 'smt') {
|
|
1526
|
+
/** @type {Map<string, { code: string, qty: number, designators: string[], comments: string[], places: string[], lines: { line: number, qty: number, designators?: string, place: string }[] }>} */
|
|
1527
|
+
const byCode = new Map()
|
|
1528
|
+
const fallbackPlace = assembly === 'hand' ? 'hand' : 'smt'
|
|
1529
|
+
for (const row of rows) {
|
|
1530
|
+
const place = normalizePlace(row.place, fallbackPlace)
|
|
1531
|
+
const key = `${row.code}|${place}`
|
|
1532
|
+
const entry = byCode.get(key)
|
|
1533
|
+
if (entry === undefined) {
|
|
1534
|
+
byCode.set(key, {
|
|
1535
|
+
code: row.code,
|
|
1536
|
+
qty: row.qty,
|
|
1537
|
+
designators: row.designators === undefined ? [] : [row.designators],
|
|
1538
|
+
comments: row.comment === undefined ? [] : [row.comment],
|
|
1539
|
+
places: [place],
|
|
1540
|
+
lines: [{ line: row.line, qty: row.qty, designators: row.designators, place }],
|
|
1541
|
+
})
|
|
1542
|
+
continue
|
|
1543
|
+
}
|
|
1544
|
+
entry.qty += row.qty
|
|
1545
|
+
if (row.designators !== undefined) entry.designators.push(row.designators)
|
|
1546
|
+
if (row.comment !== undefined) entry.comments.push(row.comment)
|
|
1547
|
+
entry.places.push(place)
|
|
1548
|
+
entry.lines.push({ line: row.line, qty: row.qty, designators: row.designators, place })
|
|
1549
|
+
}
|
|
1550
|
+
for (const entry of byCode.values()) {
|
|
1551
|
+
// groups are keyed by code|place, so every entry has a single place
|
|
1552
|
+
entry.place = entry.places[0] ?? 'smt'
|
|
1553
|
+
}
|
|
1554
|
+
return [...byCode.values()]
|
|
1555
|
+
}
|
|
1556
|
+
|
|
1557
|
+
/**
|
|
1558
|
+
* Build a synthetic need from an existing part so we can search for a base
|
|
1559
|
+
* library alternative with the same identity parameters.
|
|
1560
|
+
* @param {Record<string, unknown>} item
|
|
1561
|
+
* @param {ReturnType<typeof parseNeed>} originalNeed
|
|
1562
|
+
*/
|
|
1563
|
+
function needFromItem(item, originalNeed) {
|
|
1564
|
+
const requirements = []
|
|
1565
|
+
for (const attribute of attributesOf(item)) {
|
|
1566
|
+
const name = attribute.name
|
|
1567
|
+
const value = attribute.value
|
|
1568
|
+
const pushParsed = (kind, comparator) => {
|
|
1569
|
+
for (const parsed of parseQuantitiesOfKind(value, kind)) {
|
|
1570
|
+
requirements.push({ kind, value: parsed, unit: '', comparator, raw: `${name}=${value}` })
|
|
1571
|
+
}
|
|
1572
|
+
}
|
|
1573
|
+
if (/^capacitance$/i.test(name)) pushParsed('capacitance', '=')
|
|
1574
|
+
else if (/^resistance$/i.test(name)) pushParsed('resistance', '=')
|
|
1575
|
+
else if (/^inductance$/i.test(name)) pushParsed('inductance', '=')
|
|
1576
|
+
else if (/^output voltage$/i.test(name)) pushParsed('voltage', '=')
|
|
1577
|
+
else if (/voltage rating|reverse voltage|drain-source voltage|maximum input voltage/i.test(name)) pushParsed('voltage', '>=')
|
|
1578
|
+
else if (/output current|forward current|current - output/i.test(name)) pushParsed('current', '>=')
|
|
1579
|
+
}
|
|
1580
|
+
return {
|
|
1581
|
+
...originalNeed,
|
|
1582
|
+
requirements,
|
|
1583
|
+
directCode: undefined,
|
|
1584
|
+
modelGuess: false,
|
|
1585
|
+
categories: originalNeed.categories,
|
|
1586
|
+
package: originalNeed.package ?? asString(item.package),
|
|
1587
|
+
searchKeyword: [
|
|
1588
|
+
asString(item.package),
|
|
1589
|
+
...attributesOf(item)
|
|
1590
|
+
.filter((attribute) => /capacitance|resistance|voltage rating|output voltage|output current|inductance/i.test(attribute.name))
|
|
1591
|
+
.slice(0, 3)
|
|
1592
|
+
.map((attribute) => attribute.value),
|
|
1593
|
+
].filter(Boolean).join(' ') || String(item.model ?? item.code ?? ''),
|
|
1594
|
+
}
|
|
1595
|
+
}
|
|
1596
|
+
|
|
1597
|
+
/**
|
|
1598
|
+
* Find one basic-library substitute for an extended part, with the net saving
|
|
1599
|
+
* (feeder fee avoided minus component price delta at the order quantity).
|
|
1600
|
+
* "换成基础库不一定更便宜" is why the caller needs the net number, not just
|
|
1601
|
+
* "free feeder loading".
|
|
1602
|
+
* @param {ReturnType<typeof createLcscService>} service
|
|
1603
|
+
* @param {Record<string, unknown>} item
|
|
1604
|
+
* @param {ReturnType<typeof parseNeed>} originalNeed
|
|
1605
|
+
* @param {{ signal?: AbortSignal, orderQty?: number, feeUsd?: number }} [options]
|
|
1606
|
+
*/
|
|
1607
|
+
export async function findAlternative(service, item, originalNeed, options = {}) {
|
|
1608
|
+
const packageName = asString(item.package)
|
|
1609
|
+
const orderQty = Math.max(1, asInteger(options.orderQty) ?? 1)
|
|
1610
|
+
const feeUsd = asNumber(options.feeUsd) ?? EXTENDED_PART_FEE_USD
|
|
1611
|
+
const originalTier = pickTier(item.priceUsdTiers, orderQty)
|
|
1612
|
+
const originalUnit = originalTier?.unit
|
|
1613
|
+
const tryCodes = []
|
|
1614
|
+
const alternatives = asString(item.alternatives)
|
|
1615
|
+
if (alternatives !== undefined) {
|
|
1616
|
+
for (const match of alternatives.matchAll(/C\d{4,11}/gi)) tryCodes.push(match[0].toUpperCase())
|
|
1617
|
+
}
|
|
1618
|
+
const candidates = []
|
|
1619
|
+
for (const code of tryCodes.slice(0, 3)) {
|
|
1620
|
+
const result = await service.searchRaw(code, { pageSize: 5, signal: options.signal })
|
|
1621
|
+
const hit = result.items.find((candidate) => String(candidate.code) === code)
|
|
1622
|
+
if (hit !== undefined && String(hit.libraryType).toLowerCase() === 'base') candidates.push(hit)
|
|
1623
|
+
}
|
|
1624
|
+
if (candidates.length === 0) {
|
|
1625
|
+
const need = needFromItem(item, originalNeed)
|
|
1626
|
+
const categoryName = asString(item.category)
|
|
1627
|
+
/** @param {Record<string, unknown>[]} items */
|
|
1628
|
+
const collect = (items) => {
|
|
1629
|
+
for (const candidate of items) {
|
|
1630
|
+
if (String(candidate.libraryType).toLowerCase() !== 'base') continue
|
|
1631
|
+
// A substitute must be the same kind of device; a different package is
|
|
1632
|
+
// allowed but flagged (footprint_compatible=false means a PCB respin).
|
|
1633
|
+
if (categoryName !== undefined) {
|
|
1634
|
+
const candidateCategory = asString(candidate.category)
|
|
1635
|
+
if (candidateCategory === undefined || candidateCategory.toLowerCase() !== categoryName.toLowerCase()) continue
|
|
1636
|
+
}
|
|
1637
|
+
if ((asInteger(candidate.stock) ?? 0) <= 0) continue
|
|
1638
|
+
if (candidateMatches(candidate, need).ok) candidates.push(candidate)
|
|
1639
|
+
}
|
|
1640
|
+
}
|
|
1641
|
+
// First try same package + identity values, then relax the package prefix so
|
|
1642
|
+
// e.g. 0603 ferrite beads can surface an 0805 base part (flagged as needing
|
|
1643
|
+
// a footprint change) instead of reporting "no alternative" wrongly.
|
|
1644
|
+
const withPackage = await service.searchRaw(need.searchKeyword, {
|
|
1645
|
+
pageSize: 50,
|
|
1646
|
+
libraryType: 'base',
|
|
1647
|
+
signal: options.signal,
|
|
1648
|
+
})
|
|
1649
|
+
collect(withPackage.items)
|
|
1650
|
+
if (candidates.length === 0) {
|
|
1651
|
+
const withoutPackageKeyword = attributesOf(item)
|
|
1652
|
+
.filter((attribute) => /capacitance|resistance|voltage rating|output voltage|output current|inductance|impedance/i.test(attribute.name))
|
|
1653
|
+
.slice(0, 3)
|
|
1654
|
+
.map((attribute) => attribute.value)
|
|
1655
|
+
.filter(Boolean)
|
|
1656
|
+
.join(' ')
|
|
1657
|
+
if (withoutPackageKeyword !== '' && withoutPackageKeyword !== need.searchKeyword) {
|
|
1658
|
+
const withoutPackage = await service.searchRaw(withoutPackageKeyword, {
|
|
1659
|
+
pageSize: 50,
|
|
1660
|
+
libraryType: 'base',
|
|
1661
|
+
signal: options.signal,
|
|
1662
|
+
})
|
|
1663
|
+
collect(withoutPackage.items)
|
|
1664
|
+
}
|
|
1665
|
+
}
|
|
1666
|
+
}
|
|
1667
|
+
if (candidates.length === 0) return undefined
|
|
1668
|
+
const scored = candidates.map((candidate) => {
|
|
1669
|
+
const context = { assembly: 'smt', quantity: 1, boards: 1, orderQty, sort: 'cost', feeUsd }
|
|
1670
|
+
return scoreCandidate(candidate, originalNeed, context)
|
|
1671
|
+
})
|
|
1672
|
+
/** @type {{ score: ReturnType<typeof scoreCandidate>, net: number, componentDelta: number }[]} */
|
|
1673
|
+
const evaluated = []
|
|
1674
|
+
for (const candidate of scored) {
|
|
1675
|
+
const tier = pickTier(candidate.item.priceUsdTiers, orderQty)
|
|
1676
|
+
const unit = tier?.unit
|
|
1677
|
+
const componentDelta = originalUnit !== undefined && unit !== undefined ? (unit - originalUnit) * orderQty : 0
|
|
1678
|
+
const net = feeUsd - componentDelta
|
|
1679
|
+
evaluated.push({ score: candidate, net, componentDelta })
|
|
1680
|
+
}
|
|
1681
|
+
evaluated.sort((left, right) => right.net - left.net)
|
|
1682
|
+
const requireStock = ['lcsc', 'smt'].includes(options.requireStock) ? options.requireStock : 'any'
|
|
1683
|
+
const includeCny = options.includeCny === true || requireStock === 'lcsc'
|
|
1684
|
+
/** @param {string} code */
|
|
1685
|
+
const queryRetail = async (code) => {
|
|
1686
|
+
try {
|
|
1687
|
+
if (typeof service.cn?.query === 'function') {
|
|
1688
|
+
const cn = await service.cn.query(code)
|
|
1689
|
+
if (cn !== undefined && cn !== null) return cn
|
|
1690
|
+
}
|
|
1691
|
+
if (typeof service.cny === 'function') return await service.cny(code, options.signal)
|
|
1692
|
+
} catch {
|
|
1693
|
+
// ignore
|
|
1694
|
+
}
|
|
1695
|
+
return undefined
|
|
1696
|
+
}
|
|
1697
|
+
/** @type {{ lcsc: string, reason: string }[]} */
|
|
1698
|
+
const skipped = []
|
|
1699
|
+
/** @type {ReturnType<typeof scoreCandidate> | undefined} */
|
|
1700
|
+
let best
|
|
1701
|
+
for (const entry of evaluated.slice(0, requireStock === 'lcsc' ? 4 : 1)) {
|
|
1702
|
+
const code = String(entry.score.item.code)
|
|
1703
|
+
if (requireStock === 'lcsc') {
|
|
1704
|
+
const cn = await queryRetail(code)
|
|
1705
|
+
const retail = cn?.ok === true ? asInteger(cn.stock) : undefined
|
|
1706
|
+
if (retail === undefined || retail <= 0) {
|
|
1707
|
+
skipped.push({ lcsc: code, reason: retail === 0 ? 'lcsc-stock-0' : 'lcsc-stock-unknown' })
|
|
1708
|
+
continue
|
|
1709
|
+
}
|
|
1710
|
+
}
|
|
1711
|
+
best = entry.score
|
|
1712
|
+
break
|
|
1713
|
+
}
|
|
1714
|
+
if (best === undefined) {
|
|
1715
|
+
return { blocked: true, require_stock: requireStock, skipped }
|
|
1716
|
+
}
|
|
1717
|
+
const retail = includeCny ? await queryRetail(String(best.item.code)) : undefined
|
|
1718
|
+
return {
|
|
1719
|
+
lcsc: best.item.code,
|
|
1720
|
+
model: best.item.model,
|
|
1721
|
+
package: best.item.package,
|
|
1722
|
+
library: 'base',
|
|
1723
|
+
stock: asInteger(best.item.stock) ?? 0,
|
|
1724
|
+
stock_smt: asInteger(best.item.stock) ?? 0,
|
|
1725
|
+
stock_retail: retail?.ok === true ? asInteger(retail.stock) : null,
|
|
1726
|
+
stock_asof: retail?.ok === true ? retail.fetched_at : new Date().toISOString(),
|
|
1727
|
+
stock_scope_note: requireStock === 'lcsc'
|
|
1728
|
+
? '按立创零售库存筛选（DIY 配单）'
|
|
1729
|
+
: 'SMT 库存；立创零售库存见 stock_retail',
|
|
1730
|
+
require_stock: requireStock,
|
|
1731
|
+
skipped,
|
|
1732
|
+
unit_usd: best.unitUsd === undefined ? undefined : money(best.unitUsd),
|
|
1733
|
+
fee_saved_usd: money(feeUsd),
|
|
1734
|
+
component_delta_usd: money(best.componentDelta),
|
|
1735
|
+
net_saving_usd: money(best.net),
|
|
1736
|
+
footprint_compatible: footprintCompatible(packageName, asString(best.item.package)),
|
|
1737
|
+
}
|
|
1738
|
+
}
|
|
1739
|
+
|
|
1740
|
+
/**
|
|
1741
|
+
* Audit an existing BOM.
|
|
1742
|
+
* @param {ReturnType<typeof createLcscService>} service
|
|
1743
|
+
* @param {Record<string, unknown>} args
|
|
1744
|
+
* @param {{ signal?: AbortSignal }} [options]
|
|
1745
|
+
*/
|
|
1746
|
+
export async function auditBom(service, args, options = {}) {
|
|
1747
|
+
const { rows, skipped } = parseBomInput(args.bom)
|
|
1748
|
+
if (rows.length === 0) {
|
|
1749
|
+
throw new Error(
|
|
1750
|
+
`audit_lcsc_bom parsed 0 rows from the BOM input${skipped.length > 0 ? `（其中 ${skipped.length} 行缺少可识别的 LCSC 编号）` : ''}`,
|
|
1751
|
+
)
|
|
1752
|
+
}
|
|
1753
|
+
const assembly = args.assembly === 'smt' ? 'smt' : 'hand'
|
|
1754
|
+
const boards = clampInteger(args.boards, 1, 100000, 1)
|
|
1755
|
+
let includeCny = args.include_cny === true
|
|
1756
|
+
const requireStock = ['lcsc', 'smt', 'any'].includes(args.require_stock) ? args.require_stock : 'any'
|
|
1757
|
+
const stockScope = requireStock === 'any' ? (assembly === 'smt' ? 'smt' : 'lcsc') : requireStock
|
|
1758
|
+
const suggestAlternatives = args.suggest_alternatives !== false
|
|
1759
|
+
const exportBom = args.export_bom === true
|
|
1760
|
+
const region = args.region === 'cn' ? 'cn' : 'global'
|
|
1761
|
+
const settings = service.settings ?? {}
|
|
1762
|
+
const feeUsd = asNumber(settings.extendedPartFeeUsd) ?? EXTENDED_PART_FEE_USD
|
|
1763
|
+
const setupFeeUsd = asNumber(settings.setupFeeUsd) ?? 0
|
|
1764
|
+
const stencilFeeUsd = asNumber(settings.stencilFeeUsd) ?? 0
|
|
1765
|
+
const usdToCnyFactor = asNumber(settings.usdToCnyFactor) ?? 6.0
|
|
1766
|
+
const notes = []
|
|
1767
|
+
const hints = []
|
|
1768
|
+
const errors = []
|
|
1769
|
+
|
|
1770
|
+
const merged = mergeBomRows(rows, assembly)
|
|
1771
|
+
const codes = [...new Set(merged.map((entry) => entry.code).filter((code) => code !== ''))]
|
|
1772
|
+
if (args.include_cny === undefined && assembly === 'hand' && merged.length <= 8) includeCny = true
|
|
1773
|
+
if (args.include_cny === undefined && assembly === 'hand' && merged.length > 8) {
|
|
1774
|
+
hints.push('BOM 较大，默认跳过 Chrome 逐料取人民币价（较慢）：设 include_cny=true 可强制获取真实 CNY（有 24h 缓存）。')
|
|
1775
|
+
}
|
|
1776
|
+
|
|
1777
|
+
// ---- JLCPCB library data (one exact lookup per unique code) --------------
|
|
1778
|
+
const jlcEntries = await mapLimit(codes, 3, async (code) => {
|
|
1779
|
+
try {
|
|
1780
|
+
const result = await service.searchRaw(code, { pageSize: 5, signal: options.signal })
|
|
1781
|
+
const hit = result.items.find((candidate) => String(candidate.code).toUpperCase() === code)
|
|
1782
|
+
return [code, hit, hit === undefined ? 'not found in JLCPCB library' : undefined]
|
|
1783
|
+
} catch (error) {
|
|
1784
|
+
return [code, undefined, error instanceof Error ? error.message : String(error)]
|
|
1785
|
+
}
|
|
1786
|
+
})
|
|
1787
|
+
/** @type {Map<string, Record<string, unknown> | undefined>} */
|
|
1788
|
+
const jlcByCode = new Map()
|
|
1789
|
+
for (const entry of jlcEntries) {
|
|
1790
|
+
const [code, hit, error] = entry
|
|
1791
|
+
jlcByCode.set(code, hit)
|
|
1792
|
+
if (hit === undefined && error !== undefined) errors.push(`${code}: ${error}`)
|
|
1793
|
+
}
|
|
1794
|
+
|
|
1795
|
+
// ---- LCSC domestic CNY data (Chrome adapter, capped) ----------------------
|
|
1796
|
+
/** @type {Map<string, Record<string, unknown>>} */
|
|
1797
|
+
const cnyByCode = new Map()
|
|
1798
|
+
if (includeCny && codes.length > 0) {
|
|
1799
|
+
const targets = codes.slice(0, MAX_AUDIT_CNY_LOOKUPS)
|
|
1800
|
+
const budgetMs = asNumber(settings.cnQueryBudgetMs) ?? 90000
|
|
1801
|
+
const deadline = budgetMs > 0 ? Date.now() + budgetMs : Number.POSITIVE_INFINITY
|
|
1802
|
+
const results = await mapLimit(targets, 2, async (code) => {
|
|
1803
|
+
if (Date.now() > deadline) return { ok: false, reason: 'cn-budget-exceeded' }
|
|
1804
|
+
try {
|
|
1805
|
+
if (typeof service.cn?.query === 'function') {
|
|
1806
|
+
const cn = await service.cn.query(code)
|
|
1807
|
+
// Keep the adapter's own failure reason (chrome-not-found, WAF, …) so
|
|
1808
|
+
// the caller can see WHY real CNY is missing and how to fix it.
|
|
1809
|
+
if (cn !== undefined && cn !== null) return cn
|
|
1810
|
+
}
|
|
1811
|
+
if (typeof service.cny === 'function') return await service.cny(code, options.signal)
|
|
1812
|
+
return { ok: false, reason: 'cny-adapter-unavailable' }
|
|
1813
|
+
} catch (error) {
|
|
1814
|
+
return { ok: false, reason: error instanceof Error ? error.message : String(error) }
|
|
1815
|
+
}
|
|
1816
|
+
})
|
|
1817
|
+
results.forEach((result, index) => cnyByCode.set(targets[index], result))
|
|
1818
|
+
const covered = [...cnyByCode.values()].filter((result) => result?.ok === true).length
|
|
1819
|
+
const budgetHit = results.some((result) => result?.reason === 'cn-budget-exceeded')
|
|
1820
|
+
if (budgetHit) {
|
|
1821
|
+
hints.push(`人民币价查询达到时间预算（${Math.round(budgetMs / 1000)}s）后提前返回；已取到的结果已写入 24h 缓存，直接再调用一次会更快补齐剩余料号。`)
|
|
1822
|
+
}
|
|
1823
|
+
notes.push(
|
|
1824
|
+
`国内站人民币价：${covered}/${targets.length} 个料取到真实 CNY（Chrome 渲染 + 24h 缓存）；未取到的行回退为批量档 USD×${usdToCnyFactor} 估算并标 estimated=true。`,
|
|
1825
|
+
)
|
|
1826
|
+
const cnyFailure = cnFailureHint(results, service.cn)
|
|
1827
|
+
if (cnyFailure !== undefined) hints.push(cnyFailure)
|
|
1828
|
+
if (targets.length < codes.length) {
|
|
1829
|
+
notes.push(`CNY 查询上限 ${MAX_AUDIT_CNY_LOOKUPS} 个料号，其余行只有 USD 参考；可用 include_cny 配合缓存分批复核。`)
|
|
1830
|
+
}
|
|
1831
|
+
}
|
|
1832
|
+
|
|
1833
|
+
// ---- Build rows -----------------------------------------------------------
|
|
1834
|
+
const auditRows = merged.map((entry) => {
|
|
1835
|
+
const jlc = jlcByCode.get(entry.code)
|
|
1836
|
+
const cn = cnyByCode.get(entry.code)
|
|
1837
|
+
const place = entry.place
|
|
1838
|
+
const qty = entry.qty
|
|
1839
|
+
const orderQty = qty * boards
|
|
1840
|
+
const rawLibrary = jlc === undefined ? undefined : String(jlc.libraryType ?? '').toLowerCase()
|
|
1841
|
+
const library = rawLibrary === 'base' ? 'base' : rawLibrary === 'expand' ? 'expand' : undefined
|
|
1842
|
+
const tier = jlc === undefined ? undefined : pickTier(jlc.priceUsdTiers, orderQty)
|
|
1843
|
+
const unitUsd = tier?.unit
|
|
1844
|
+
const cnOk = cn?.ok === true
|
|
1845
|
+
const unitCny = cnOk ? asNumber(cn.unit) : undefined
|
|
1846
|
+
const stockSmt = jlc === undefined ? undefined : asInteger(jlc.stock)
|
|
1847
|
+
const stockLcsc = cnOk ? asInteger(cn.stock) : undefined
|
|
1848
|
+
const bulkUsd = jlc === undefined ? undefined : bulkTierUsd(jlc)
|
|
1849
|
+
const unitCnyEstimate = unitCny === undefined ? estimateCnyFromUsd(bulkUsd, usdToCnyFactor) : undefined
|
|
1850
|
+
const billableSmt = assembly === 'smt' && place === 'smt' && jlc !== undefined
|
|
1851
|
+
const billableHand = place !== 'dnp' && (assembly === 'hand' || place === 'hand')
|
|
1852
|
+
const countsForUsd = assembly === 'hand' ? billableHand : billableSmt
|
|
1853
|
+
const subtotalUsd = countsForUsd && unitUsd !== undefined ? unitUsd * orderQty : undefined
|
|
1854
|
+
const subtotalCny = unitCny !== undefined && (billableSmt || billableHand) ? unitCny * orderQty : undefined
|
|
1855
|
+
const flags = []
|
|
1856
|
+
if (place === 'dnp') flags.push('DNP：不贴/不计元件与上料费')
|
|
1857
|
+
else if (assembly === 'smt' && place === 'hand') flags.push('手焊：不计入 SMT 贴片与上料费')
|
|
1858
|
+
if (jlc === undefined && cnOk) flags.push('不在嘉立创 SMT 库，但立创商城有货（手焊可买）')
|
|
1859
|
+
if (library === 'expand' && billableSmt) flags.push(`扩展库：$${feeUsd}/料号上料费`)
|
|
1860
|
+
if (library === 'expand' && !billableSmt) flags.push('扩展库（手焊/DNP 无上料费）')
|
|
1861
|
+
const stockForMode = assembly === 'smt' ? stockSmt : (stockLcsc ?? stockSmt)
|
|
1862
|
+
if (place !== 'dnp' && stockForMode !== undefined) {
|
|
1863
|
+
if (stockForMode <= 0) flags.push('无库存')
|
|
1864
|
+
else if (stockForMode < orderQty) flags.push(`库存不足（需 ${orderQty}）`)
|
|
1865
|
+
}
|
|
1866
|
+
if (tier === undefined && jlc !== undefined) flags.push('无价格数据')
|
|
1867
|
+
if (place !== 'dnp' && jlc === undefined && !cnOk) flags.push('嘉立创/立创均未查到')
|
|
1868
|
+
let status = 'verified'
|
|
1869
|
+
if (place === 'dnp') status = 'DNP'
|
|
1870
|
+
else if (jlc === undefined && !cnOk) status = 'NOT-FOUND'
|
|
1871
|
+
else if (assembly === 'smt' && place !== 'smt') status = place === 'hand' ? 'HAND' : 'DNP'
|
|
1872
|
+
else if (stockForMode === 0) status = 'NO-STOCK'
|
|
1873
|
+
return {
|
|
1874
|
+
lcsc: entry.code || '(missing)',
|
|
1875
|
+
designators: entry.designators.length > 0 ? entry.designators : undefined,
|
|
1876
|
+
qty,
|
|
1877
|
+
lines: entry.lines,
|
|
1878
|
+
place,
|
|
1879
|
+
status,
|
|
1880
|
+
model: jlc === undefined ? (cnOk ? cn.model : undefined) : jlc.model,
|
|
1881
|
+
brand: jlc === undefined ? (cnOk ? cn.brand : undefined) : jlc.brand,
|
|
1882
|
+
package: jlc === undefined ? (cnOk ? cn.package : undefined) : jlc.package,
|
|
1883
|
+
library,
|
|
1884
|
+
billable_smt: billableSmt,
|
|
1885
|
+
billable: countsForUsd,
|
|
1886
|
+
stock: stockForMode,
|
|
1887
|
+
stock_retail: stockLcsc,
|
|
1888
|
+
stock_smt: stockSmt,
|
|
1889
|
+
stock_global: null,
|
|
1890
|
+
stock_lcsc: stockLcsc,
|
|
1891
|
+
stock_asof: cnOk ? (cn.fetched_at ?? new Date().toISOString()) : new Date().toISOString(),
|
|
1892
|
+
stock_scope: assembly,
|
|
1893
|
+
stock_scope_note: assembly === 'smt'
|
|
1894
|
+
? (requireStock === 'lcsc' ? '按立创零售库存约束；SMT 库存另列' : 'SMT 库存（嘉立创 PCBA 备料仓）')
|
|
1895
|
+
: '立创商城零售库存（DIY 配单）；SMT 库存另列',
|
|
1896
|
+
data_warnings: (() => {
|
|
1897
|
+
const warnings = []
|
|
1898
|
+
if (stockLcsc === 0 && stockSmt !== undefined && stockSmt > 0) warnings.push('retail_out_of_stock_smt_ok')
|
|
1899
|
+
if (stockLcsc !== undefined && stockLcsc > 0 && stockSmt === 0) warnings.push('smt_out_of_stock_retail_ok')
|
|
1900
|
+
return warnings.length === 0 ? undefined : warnings
|
|
1901
|
+
})(),
|
|
1902
|
+
stock_source: assembly === 'smt' ? 'jlcpcb-smt' : (stockLcsc !== undefined ? 'lcsc_cn_render' : 'jlcpcb-smt'),
|
|
1903
|
+
coverage: orderQty > 0 && stockForMode !== undefined ? Math.min(1, Math.round((stockForMode / orderQty) * 100) / 100) : undefined,
|
|
1904
|
+
price_source: jlc === undefined ? (cnOk ? 'lcsc_cn_render' : undefined) : 'jlcpcb-smt',
|
|
1905
|
+
unit_usd: unitUsd === undefined ? undefined : money(unitUsd),
|
|
1906
|
+
price_usd_tier: tier?.label,
|
|
1907
|
+
price_usd_ladder: jlc === undefined ? undefined : (jlc.priceUsdTiers ?? []).slice(0, 8).map((item) => ({ qty: item.qty, unit: money(item.unit) })),
|
|
1908
|
+
subtotal_usd: subtotalUsd === undefined ? undefined : money(subtotalUsd),
|
|
1909
|
+
unit_cny: unitCny === undefined ? undefined : money(unitCny),
|
|
1910
|
+
price_cny_source: unitCny === undefined ? undefined : (cn.source ?? 'lcsc_cn_render'),
|
|
1911
|
+
price_cny_estimated: false,
|
|
1912
|
+
subtotal_cny: subtotalCny === undefined ? undefined : money(subtotalCny),
|
|
1913
|
+
unit_cny_estimate: unitCnyEstimate === undefined ? undefined : money(unitCnyEstimate),
|
|
1914
|
+
subtotal_cny_estimate: unitCnyEstimate === undefined ? undefined : money(unitCnyEstimate * orderQty),
|
|
1915
|
+
fetched_at: new Date().toISOString(),
|
|
1916
|
+
flags,
|
|
1917
|
+
}
|
|
1918
|
+
})
|
|
1919
|
+
|
|
1920
|
+
// ---- Summary --------------------------------------------------------------
|
|
1921
|
+
const smtRows = auditRows.filter((row) => row.billable_smt)
|
|
1922
|
+
const handRows = auditRows.filter((row) => row.billable_smt !== true && row.place !== 'dnp' && row.status !== 'NOT-FOUND')
|
|
1923
|
+
const dnpRows = auditRows.filter((row) => row.place === 'dnp')
|
|
1924
|
+
const extendedUnique = new Set(smtRows.filter((row) => row.library === 'expand').map((row) => row.lcsc))
|
|
1925
|
+
const costRows = assembly === 'hand' ? handRows : smtRows
|
|
1926
|
+
const componentUsd = costRows.reduce((sum, row) => sum + (row.subtotal_usd ?? 0), 0)
|
|
1927
|
+
const componentCny = costRows.reduce((sum, row) => sum + (row.subtotal_cny ?? 0), 0)
|
|
1928
|
+
const componentCnyEstimate = costRows.reduce((sum, row) => sum + (row.subtotal_cny_estimate ?? 0), 0)
|
|
1929
|
+
const handUsd = handRows.reduce((sum, row) => sum + (row.unit_usd ?? 0) * row.qty * boards, 0)
|
|
1930
|
+
const handCny = handRows.reduce((sum, row) => sum + (row.subtotal_cny ?? 0), 0)
|
|
1931
|
+
const dnpUsd = dnpRows.reduce((sum, row) => sum + (row.unit_usd ?? 0) * (row.qty * boards), 0)
|
|
1932
|
+
const extendedFee = assembly === 'smt' ? extendedUnique.size * feeUsd : 0
|
|
1933
|
+
const setupFees = setupFeeUsd + stencilFeeUsd
|
|
1934
|
+
const totalUsd = componentUsd + extendedFee + setupFees
|
|
1935
|
+
const cnyCovered = auditRows.filter((row) => row.unit_cny !== undefined).length
|
|
1936
|
+
|
|
1937
|
+
// Batch amortisation table: price tiers are re-evaluated per scenario.
|
|
1938
|
+
const scenarioBoards = [...new Set([20, 100, 300, 1000, boards])].filter((value) => value <= 100000).sort((left, right) => left - right)
|
|
1939
|
+
const costTable = scenarioBoards.map((scenario) => {
|
|
1940
|
+
let scenarioComponents = 0
|
|
1941
|
+
for (const row of costRows) {
|
|
1942
|
+
const jlc = jlcByCode.get(row.lcsc)
|
|
1943
|
+
if (jlc === undefined) continue
|
|
1944
|
+
const tier = pickTier(jlc.priceUsdTiers, row.qty * scenario)
|
|
1945
|
+
if (tier !== undefined) scenarioComponents += tier.unit * row.qty * scenario
|
|
1946
|
+
}
|
|
1947
|
+
const scenarioFee = extendedUnique.size * feeUsd
|
|
1948
|
+
const scenarioTotal = scenarioComponents + scenarioFee + setupFees
|
|
1949
|
+
return {
|
|
1950
|
+
boards: scenario,
|
|
1951
|
+
components_usd: money(scenarioComponents),
|
|
1952
|
+
extended_fee_usd: money(scenarioFee),
|
|
1953
|
+
setup_fees_usd: money(setupFees),
|
|
1954
|
+
total_usd: money(scenarioTotal),
|
|
1955
|
+
per_board_usd: money(scenarioTotal / scenario),
|
|
1956
|
+
extended_fee_per_board_usd: money(scenarioFee / scenario),
|
|
1957
|
+
}
|
|
1958
|
+
})
|
|
1959
|
+
|
|
1960
|
+
// ---- Alternatives & net-saving optimisation ------------------------------
|
|
1961
|
+
const optimize = {
|
|
1962
|
+
require_stock: requireStock,
|
|
1963
|
+
stock_scope: stockScope,
|
|
1964
|
+
stock_scope_note: requireStock === 'any'
|
|
1965
|
+
? `未限制库存口径；建议按 assembly=${assembly} 看 ${assembly === 'smt' ? 'stock_smt' : 'stock_retail'}。DIY 配单请传 require_stock="lcsc"。`
|
|
1966
|
+
: `建议已按 ${stockScope === 'lcsc' ? '立创零售库存' : '嘉立创 SMT 库存'}（require_stock=${requireStock}）筛选。`,
|
|
1967
|
+
extended_parts_before: extendedUnique.size,
|
|
1968
|
+
extended_parts_after: extendedUnique.size,
|
|
1969
|
+
fee_before_usd: money(assembly === 'smt' ? extendedUnique.size * feeUsd : 0),
|
|
1970
|
+
fee_after_usd: money(assembly === 'smt' ? extendedUnique.size * feeUsd : 0),
|
|
1971
|
+
saving_usd_per_order: 0,
|
|
1972
|
+
actions: [],
|
|
1973
|
+
alternatives: [],
|
|
1974
|
+
blocked: [],
|
|
1975
|
+
}
|
|
1976
|
+
if (suggestAlternatives && assembly === 'smt') {
|
|
1977
|
+
const originalNeed = parseNeed('')
|
|
1978
|
+
const expandCodes = [...extendedUnique].slice(0, MAX_ALTERNATIVE_LOOKUPS)
|
|
1979
|
+
const pairs = await mapLimit(expandCodes, 2, async (code) => {
|
|
1980
|
+
const item = jlcByCode.get(code)
|
|
1981
|
+
const entry = smtRows.find((candidate) => candidate.lcsc === code)
|
|
1982
|
+
if (item === undefined || entry === undefined) return [code, undefined]
|
|
1983
|
+
const orderQty = entry.qty * boards
|
|
1984
|
+
try {
|
|
1985
|
+
return [code, await findAlternative(service, item, originalNeed, {
|
|
1986
|
+
signal: options.signal,
|
|
1987
|
+
orderQty,
|
|
1988
|
+
feeUsd,
|
|
1989
|
+
requireStock,
|
|
1990
|
+
includeCny,
|
|
1991
|
+
})]
|
|
1992
|
+
} catch {
|
|
1993
|
+
return [code, undefined]
|
|
1994
|
+
}
|
|
1995
|
+
})
|
|
1996
|
+
let saving = 0
|
|
1997
|
+
let replaced = 0
|
|
1998
|
+
const alternativesByCode = new Map()
|
|
1999
|
+
for (const [code, alternative] of pairs) {
|
|
2000
|
+
if (alternative === undefined) continue
|
|
2001
|
+
if (alternative.blocked === true) {
|
|
2002
|
+
optimize.blocked.push({ from: code, ...alternative })
|
|
2003
|
+
optimize.actions.push(
|
|
2004
|
+
`${code}：按 require_stock=${requireStock} 未找到有库存的基础库替代（跳过 ${(alternative.skipped ?? []).map((item) => `${item.lcsc}:${item.reason}`).join(', ')}）`,
|
|
2005
|
+
)
|
|
2006
|
+
continue
|
|
2007
|
+
}
|
|
2008
|
+
alternativesByCode.set(code, alternative)
|
|
2009
|
+
optimize.alternatives.push({ from: code, ...alternative })
|
|
2010
|
+
if (alternative.net_saving_usd > 0) {
|
|
2011
|
+
saving += alternative.net_saving_usd
|
|
2012
|
+
replaced += 1
|
|
2013
|
+
const packageNote = alternative.footprint_compatible === false
|
|
2014
|
+
? `封装不同（${jlcByCode.get(code)?.package ?? '?'}→${alternative.package ?? '?'}，需改 PCB）`
|
|
2015
|
+
: '封装兼容'
|
|
2016
|
+
const stockNote = stockScope === 'lcsc'
|
|
2017
|
+
? `立创零售 ${alternative.stock_retail ?? '?'}`
|
|
2018
|
+
: `SMT 库存 ${alternative.stock_smt ?? '?'}${alternative.stock_retail === 0 ? '；⚠ 立创零售 0' : ''}`
|
|
2019
|
+
const skippedNote = Array.isArray(alternative.skipped) && alternative.skipped.length > 0
|
|
2020
|
+
? `（已跳过 ${alternative.skipped.map((item) => `${item.lcsc}:${item.reason}`).join(', ')}）`
|
|
2021
|
+
: ''
|
|
2022
|
+
optimize.actions.push(
|
|
2023
|
+
`${code}→${alternative.lcsc}：${packageNote}，${stockNote}，上料费省 $${feeUsd}，元件成本变化 $${alternative.component_delta_usd}，净省 $${alternative.net_saving_usd}${skippedNote}`,
|
|
2024
|
+
)
|
|
2025
|
+
}
|
|
2026
|
+
}
|
|
2027
|
+
optimize.extended_parts_after = extendedUnique.size - replaced
|
|
2028
|
+
optimize.fee_after_usd = money(Math.max(0, optimize.extended_parts_after * feeUsd))
|
|
2029
|
+
optimize.fee_before_usd = money(extendedUnique.size * feeUsd)
|
|
2030
|
+
optimize.saving_usd_per_order = money(saving)
|
|
2031
|
+
for (const row of auditRows) {
|
|
2032
|
+
if (row.place === 'hand' && assembly === 'smt') optimize.actions.push(`${row.lcsc} place=hand：不占上料费（已从 SMT 费用中剔除）`)
|
|
2033
|
+
}
|
|
2034
|
+
for (const row of dnpRows) optimize.actions.push(`${row.lcsc} DNP：不贴片、不计元件与上料费`)
|
|
2035
|
+
if (optimize.blocked.length > 0) {
|
|
2036
|
+
notes.push(`${optimize.blocked.length} 个扩展库料号在 require_stock=${requireStock} 下没有有库存的替代；可用 require_stock="any" 查看候选并按 stock_retail/stock_smt 人工判断。`)
|
|
2037
|
+
}
|
|
2038
|
+
if (expandCodes.length < extendedUnique.size) {
|
|
2039
|
+
notes.push(`替代料建议仅检查了 ${expandCodes.length}/${extendedUnique.size} 个扩展库料号（每次最多 ${MAX_ALTERNATIVE_LOOKUPS} 个）。`)
|
|
2040
|
+
}
|
|
2041
|
+
if (alternativesByCode.size > 0) {
|
|
2042
|
+
for (const row of auditRows) {
|
|
2043
|
+
const alternative = alternativesByCode.get(row.lcsc)
|
|
2044
|
+
if (alternative !== undefined) row.alternative = alternative
|
|
2045
|
+
}
|
|
2046
|
+
}
|
|
2047
|
+
}
|
|
2048
|
+
|
|
2049
|
+
// ---- Optional JLCPCB BOM CSV export ---------------------------------------
|
|
2050
|
+
let bomCsv
|
|
2051
|
+
if (exportBom) {
|
|
2052
|
+
const lines = ['Comment,Designator,Footprint,LCSC Part #']
|
|
2053
|
+
for (const row of smtRows) {
|
|
2054
|
+
if (row.lcsc === '(missing)') continue
|
|
2055
|
+
const designators = Array.isArray(row.designators) ? row.designators.join(',') : ''
|
|
2056
|
+
const comment = row.model ?? row.lcsc
|
|
2057
|
+
const footprint = row.package ?? ''
|
|
2058
|
+
lines.push([comment, designators, footprint, row.lcsc].map((cell) => `"${String(cell).replaceAll('"', '""')}"`).join(','))
|
|
2059
|
+
}
|
|
2060
|
+
bomCsv = lines.join('\n')
|
|
2061
|
+
}
|
|
2062
|
+
|
|
2063
|
+
// ---- Notes ---------------------------------------------------------------
|
|
2064
|
+
notes.push(
|
|
2065
|
+
assembly === 'smt'
|
|
2066
|
+
? 'assembly=smt：价格与库存取嘉立创 SMT 元件库（USD 阶梯价按采购数量取档）；上料费只计 smt 且为扩展库的唯一料号。'
|
|
2067
|
+
: 'assembly=hand：不计嘉立创上料费；价格优先取立创商城国内站人民币价（Chrome 渲染），未取到的行给 estimated 估算。',
|
|
2068
|
+
)
|
|
2069
|
+
notes.push('USD 与 CNY 并列展示、不互相换算；每行带 price_source / fetched_at / estimated。')
|
|
2070
|
+
notes.push(
|
|
2071
|
+
assembly === 'smt'
|
|
2072
|
+
? `上料费按每唯一扩展库料号 $${feeUsd}/单估算；工程费 $${setupFeeUsd}、钢网费 $${stencilFeeUsd} 已单列（默认 0，可在插件 config 配置）。`
|
|
2073
|
+
: `上料费 0；工程费 $${setupFeeUsd}、钢网费 $${stencilFeeUsd} 可配置。`,
|
|
2074
|
+
)
|
|
2075
|
+
if (region === 'cn') {
|
|
2076
|
+
notes.push('region=cn：国内嘉立创 SMT 的费用规则以官方计价页为准；本工具仍按 USD 上料费估算并显式标注。')
|
|
2077
|
+
}
|
|
2078
|
+
notes.push('优选扩展库（Preferred Extended）分类未在公开接口暴露，若需免上料费请到嘉立创 SMT 下单页确认。')
|
|
2079
|
+
if (skipped.length > 0) {
|
|
2080
|
+
const list = skipped
|
|
2081
|
+
.slice(0, 30)
|
|
2082
|
+
.map((row) => {
|
|
2083
|
+
const label = asString(row.comment) ?? asString(row.raw) ?? ''
|
|
2084
|
+
return `${row.designators === undefined ? '' : `${row.designators} `}${label}`.trim()
|
|
2085
|
+
})
|
|
2086
|
+
.filter((text) => text !== '')
|
|
2087
|
+
.join('；')
|
|
2088
|
+
notes.push(`BOM 中有 ${skipped.length} 行没有可识别的 LCSC 编号，未计入成本：${list}${skipped.length > 30 ? ' 等' : ''}`)
|
|
2089
|
+
hints.push('以上行需先选型（补上 LCSC 编号）再重新审计，否则单板成本会偏低。')
|
|
2090
|
+
}
|
|
2091
|
+
if (costTable.length > 0) {
|
|
2092
|
+
const scenario = costTable.find((row) => row.boards === 100) ?? costTable[costTable.length - 1]
|
|
2093
|
+
notes.push(`批量摊销参考：${scenario.boards} 片时约 $${scenario.per_board_usd}/片（含上料费 $${scenario.extended_fee_per_board_usd}/片 + 工程/钢网 $${money(setupFees / scenario.boards)}/片）。`)
|
|
2094
|
+
}
|
|
2095
|
+
|
|
2096
|
+
const summary = {
|
|
2097
|
+
lines: auditRows.length,
|
|
2098
|
+
lines_in_bom: rows.length,
|
|
2099
|
+
skipped_lines: skipped.length,
|
|
2100
|
+
smt_lines: smtRows.length,
|
|
2101
|
+
hand_lines: handRows.length,
|
|
2102
|
+
dnp_lines: dnpRows.length,
|
|
2103
|
+
unique_parts: codes.length,
|
|
2104
|
+
verified: auditRows.filter((row) => row.status === 'verified').length,
|
|
2105
|
+
no_stock: auditRows.filter((row) => row.status === 'NO-STOCK').length,
|
|
2106
|
+
not_found: auditRows.filter((row) => row.status === 'NOT-FOUND').length,
|
|
2107
|
+
base_parts: costRows.filter((row) => row.library === 'base').length,
|
|
2108
|
+
expand_parts: new Set(costRows.filter((row) => row.library === 'expand').map((row) => row.lcsc)).size,
|
|
2109
|
+
expanded_fee_parts: extendedUnique.size,
|
|
2110
|
+
library_unknown: costRows.filter((row) => row.library === undefined).length,
|
|
2111
|
+
extended_fee_per_order_usd: money(extendedFee),
|
|
2112
|
+
setup_fee_usd: money(setupFeeUsd),
|
|
2113
|
+
stencil_fee_usd: money(stencilFeeUsd),
|
|
2114
|
+
components_usd: money(componentUsd),
|
|
2115
|
+
components_per_board_usd: money(componentUsd / Math.max(1, boards)),
|
|
2116
|
+
total_usd: money(totalUsd),
|
|
2117
|
+
total_per_board_usd: money(totalUsd / Math.max(1, boards)),
|
|
2118
|
+
hand_components_usd_reference: money(handUsd),
|
|
2119
|
+
hand_components_cny: money(handCny),
|
|
2120
|
+
dnp_components_usd_excluded: money(dnpUsd),
|
|
2121
|
+
cny_covered_lines: cnyCovered,
|
|
2122
|
+
cny_total_basis: 'per_order',
|
|
2123
|
+
cny_price_tier: 'retail_1pc',
|
|
2124
|
+
components_cny: money(componentCny),
|
|
2125
|
+
components_cny_per_order: money(componentCny),
|
|
2126
|
+
components_cny_per_board: money(componentCny / Math.max(1, boards)),
|
|
2127
|
+
cny_estimated_lines: auditRows.filter((row) => row.unit_cny_estimate !== undefined).length,
|
|
2128
|
+
components_cny_estimate: money(componentCnyEstimate),
|
|
2129
|
+
cost_table: costTable,
|
|
2130
|
+
require_stock: requireStock,
|
|
2131
|
+
stock_scope: stockScope,
|
|
2132
|
+
}
|
|
2133
|
+
|
|
2134
|
+
const dataWarnings = [...new Set(auditRows.flatMap((row) => row.data_warnings ?? []))]
|
|
2135
|
+
if (dataWarnings.includes('retail_out_of_stock_smt_ok')) {
|
|
2136
|
+
notes.push('注意：有料号「立创零售仓缺货、嘉立创 SMT 仓有货」——不是停产；DIY 配单看 stock_retail，PCBA 看 stock_smt。')
|
|
2137
|
+
}
|
|
2138
|
+
return {
|
|
2139
|
+
assembly,
|
|
2140
|
+
boards,
|
|
2141
|
+
region,
|
|
2142
|
+
require_stock: requireStock,
|
|
2143
|
+
stock_scope: stockScope,
|
|
2144
|
+
currency: includeCny ? 'USD + CNY（并列，不混算）' : 'USD（CNY 为参考估算）',
|
|
2145
|
+
summary,
|
|
2146
|
+
rows: auditRows,
|
|
2147
|
+
optimize,
|
|
2148
|
+
bom_csv: bomCsv,
|
|
2149
|
+
skipped: skipped.slice(0, 50),
|
|
2150
|
+
errors,
|
|
2151
|
+
hints,
|
|
2152
|
+
notes,
|
|
2153
|
+
data_warnings: dataWarnings,
|
|
2154
|
+
fetched_at: new Date().toISOString(),
|
|
2155
|
+
}
|
|
2156
|
+
}
|
|
2157
|
+
|
|
2158
|
+
/* -------------------------------------------------------------------------- */
|
|
2159
|
+
/* Rendering */
|
|
2160
|
+
/* -------------------------------------------------------------------------- */
|
|
2161
|
+
|
|
2162
|
+
/** @param {Record<string, unknown>} value */
|
|
2163
|
+
export function renderFindText(value) {
|
|
2164
|
+
const candidates = Array.isArray(value.candidates) ? value.candidates : []
|
|
2165
|
+
const header =
|
|
2166
|
+
`Find "${value.need}" [${value.assembly}${value.require_stock && value.require_stock !== 'any' ? `/stock=${value.require_stock}` : ''}] qty ${value.quantity}/board x ${value.boards} board(s)` +
|
|
2167
|
+
(value.exact === true ? ' (exact part query)' : '') +
|
|
2168
|
+
(value.relaxed === true ? ` (relaxed stage ${value.relax_stage})` : '') +
|
|
2169
|
+
` => ${candidates.length} candidate(s)`
|
|
2170
|
+
const lines = [header]
|
|
2171
|
+
for (const candidate of candidates) {
|
|
2172
|
+
if (!isRecord(candidate)) continue
|
|
2173
|
+
const priceUsd = isRecord(candidate.price_usd) ? `USD ${candidate.price_usd.unit} @${candidate.price_usd.tier}` : 'USD n/a'
|
|
2174
|
+
const priceCny = isRecord(candidate.price_cny)
|
|
2175
|
+
? `CNY ${candidate.price_cny.unit}${candidate.price_cny.estimated === true ? '(est.)' : ''}`
|
|
2176
|
+
: 'CNY n/a'
|
|
2177
|
+
lines.push(
|
|
2178
|
+
`- ${candidate.lcsc} | ${candidate.model ?? '?'} | ${candidate.package ?? '?'} | lib ${candidate.library} | ` +
|
|
2179
|
+
`stock smt ${candidate.stock_smt ?? '?'} / retail ${candidate.stock_retail ?? '?'} | ${priceUsd} | ${priceCny} | score ${candidate.score}`,
|
|
2180
|
+
)
|
|
2181
|
+
if (Array.isArray(candidate.data_warnings) && candidate.data_warnings.length > 0) {
|
|
2182
|
+
lines.push(` ⚠ ${candidate.data_warnings.join(', ')}`)
|
|
2183
|
+
}
|
|
2184
|
+
if (Array.isArray(candidate.reasons) && candidate.reasons.length > 0) lines.push(` ${candidate.reasons.join('; ')}`)
|
|
2185
|
+
if (Array.isArray(candidate.mismatch_reasons) && candidate.mismatch_reasons.length > 0) {
|
|
2186
|
+
lines.push(` 不匹配原因: ${candidate.mismatch_reasons.join('; ')}`)
|
|
2187
|
+
}
|
|
2188
|
+
}
|
|
2189
|
+
for (const hint of Array.isArray(value.hints) ? value.hints : []) lines.push(`hint: ${hint}`)
|
|
2190
|
+
for (const note of Array.isArray(value.notes) ? value.notes : []) lines.push(`note: ${note}`)
|
|
2191
|
+
return lines.join('\n')
|
|
2192
|
+
}
|
|
2193
|
+
|
|
2194
|
+
/** @param {Record<string, unknown>} value */
|
|
2195
|
+
export function renderAuditText(value) {
|
|
2196
|
+
const summary = isRecord(value.summary) ? value.summary : {}
|
|
2197
|
+
const rows = Array.isArray(value.rows) ? value.rows : []
|
|
2198
|
+
const optimize = isRecord(value.optimize) ? value.optimize : {}
|
|
2199
|
+
const lines = [
|
|
2200
|
+
`BOM audit [${value.assembly}] region=${value.region ?? 'global'} boards=${value.boards}: ` +
|
|
2201
|
+
`${summary.lines ?? 0} lines (${summary.smt_lines ?? 0} smt / ${summary.hand_lines ?? 0} hand / ${summary.dnp_lines ?? 0} dnp), ` +
|
|
2202
|
+
`${summary.unique_parts ?? 0} unique | base ${summary.base_parts ?? 0} / expand ${summary.expand_parts ?? 0}`,
|
|
2203
|
+
`components USD ${summary.components_usd ?? 0} + extended fee USD ${summary.extended_fee_per_order_usd ?? 0}` +
|
|
2204
|
+
` + setup USD ${money((summary.setup_fee_usd ?? 0) + (summary.stencil_fee_usd ?? 0))} = USD ${summary.total_usd ?? 0}` +
|
|
2205
|
+
` (USD ${summary.total_per_board_usd ?? 0}/board)` +
|
|
2206
|
+
(summary.cny_covered_lines > 0
|
|
2207
|
+
? ` | CNY retail: ¥${summary.components_cny_per_order ?? summary.components_cny ?? 0}/order = ¥${summary.components_cny_per_board ?? '?'}/board (${summary.cny_covered_lines} lines)`
|
|
2208
|
+
: '') +
|
|
2209
|
+
(summary.components_cny_estimate > 0 ? ` | CNY est. ≈ ${summary.components_cny_estimate}` : ''),
|
|
2210
|
+
]
|
|
2211
|
+
for (const row of rows) {
|
|
2212
|
+
if (!isRecord(row)) continue
|
|
2213
|
+
const flags = Array.isArray(row.flags) && row.flags.length > 0 ? ` [${row.flags.join('; ')}]` : ''
|
|
2214
|
+
const designators = Array.isArray(row.designators) && row.designators.length > 0 ? ` {${row.designators.join(',')}}` : ''
|
|
2215
|
+
const priceUsd = row.unit_usd === undefined ? 'USD -' : `USD ${row.unit_usd}@${row.price_usd_tier ?? '?'}`
|
|
2216
|
+
const priceCny = row.unit_cny !== undefined
|
|
2217
|
+
? `CNY ${row.unit_cny}`
|
|
2218
|
+
: row.unit_cny_estimate !== undefined ? `CNY≈${row.unit_cny_estimate}(est.)` : 'CNY -'
|
|
2219
|
+
const alternative = isRecord(row.alternative) && typeof row.alternative.lcsc === 'string'
|
|
2220
|
+
? ` -> base alt: ${row.alternative.lcsc} (${row.alternative.model ?? '?'}, net $${row.alternative.net_saving_usd ?? '?'})`
|
|
2221
|
+
: ''
|
|
2222
|
+
lines.push(
|
|
2223
|
+
`${row.lcsc} x${row.qty}${designators} | ${row.place ?? '?'} | ${row.status} | lib ${row.library ?? '?'} | ` +
|
|
2224
|
+
`stock smt ${row.stock_smt ?? '?'} / retail ${row.stock_retail ?? '?'} | ${priceUsd} | ${priceCny}${flags}${alternative}`,
|
|
2225
|
+
)
|
|
2226
|
+
}
|
|
2227
|
+
const costTable = Array.isArray(summary.cost_table) ? summary.cost_table : []
|
|
2228
|
+
if (costTable.length > 0) {
|
|
2229
|
+
lines.push('批量摊销: ' + costTable.map((row) => `${row.boards}片≈$${row.per_board_usd}/片`).join(' | '))
|
|
2230
|
+
}
|
|
2231
|
+
if (Array.isArray(value.data_warnings) && value.data_warnings.length > 0) {
|
|
2232
|
+
lines.push(`⚠ data_warnings: ${value.data_warnings.join(', ')}`)
|
|
2233
|
+
}
|
|
2234
|
+
if (isRecord(optimize) && (optimize.require_stock !== undefined || optimize.stock_scope !== undefined)) {
|
|
2235
|
+
lines.push(`优化建议库存口径: require_stock=${optimize.require_stock ?? 'any'} / scope=${optimize.stock_scope ?? '?'}`)
|
|
2236
|
+
}
|
|
2237
|
+
if (Array.isArray(optimize.actions) && optimize.actions.length > 0) {
|
|
2238
|
+
lines.push(`优化建议（净省 $${optimize.saving_usd_per_order ?? 0}/单，扩展库 ${optimize.extended_parts_before}→${optimize.extended_parts_after}）:`)
|
|
2239
|
+
for (const action of optimize.actions) lines.push(` * ${action}`)
|
|
2240
|
+
}
|
|
2241
|
+
for (const error of Array.isArray(value.errors) ? value.errors : []) lines.push(`error: ${error}`)
|
|
2242
|
+
for (const hint of Array.isArray(value.hints) ? value.hints : []) lines.push(`hint: ${hint}`)
|
|
2243
|
+
for (const note of Array.isArray(value.notes) ? value.notes : []) lines.push(`note: ${note}`)
|
|
2244
|
+
if (typeof value.bom_csv === 'string' && value.bom_csv !== '') lines.push('BOM CSV: 已生成（bom_csv 字段，可直接用于嘉立创 BOM 下单）')
|
|
2245
|
+
return lines.join('\n')
|
|
2246
|
+
}
|
|
2247
|
+
|
|
2248
|
+
/* -------------------------------------------------------------------------- */
|
|
2249
|
+
/* Tool definitions */
|
|
2250
|
+
/* -------------------------------------------------------------------------- */
|
|
2251
|
+
|
|
2252
|
+
const FIND_DESCRIPTION =
|
|
2253
|
+
'Find LCSC / JLCPCB components that match a real requirement (package, capacitance, voltage rating, current, resistance, tolerance, dimensions, …) ' +
|
|
2254
|
+
'and return up to 8 candidates ranked by practical cost-effectiveness: unit price at the actual order quantity, stock coverage, parameter match, and ' +
|
|
2255
|
+
'basic-vs-extended JLCPCB library. ' +
|
|
2256
|
+
'Part numbers and LCSC codes are detected first and queried exactly (e.g. "SMF5.0A", "AO3401A", "TP4054", "C307331"), so digit-letter patterns are never misread as values; ' +
|
|
2257
|
+
'otherwise the requirement is parsed, filtered, and relaxed in stages when nothing matches (each relaxed candidate carries mismatch reasons). ' +
|
|
2258
|
+
'Default assembly="hand" for DIY parts you buy and solder yourself (library type ignored; LCSC domestic CNY retail price via Chrome render when reachable, USD reference otherwise). ' +
|
|
2259
|
+
'Set assembly="smt" only when the board will be assembled by JLCPCB: extended-library parts then add a USD 3 feeder fee per part number per order, amortized per board. ' +
|
|
2260
|
+
'Every candidate reports stock_smt AND stock_lcsc, price_usd AND price_cny side by side (never mixed), the used price tier, and package/pin count. ' +
|
|
2261
|
+
'When the real CNY price is unavailable, a clearly-labelled reference CNY estimate (bulk-tier USD × configurable factor, default 6.0) is included; USD stays the actual reference. ' +
|
|
2262
|
+
'This is NOT a generic keyword search tool: it parses requirements, filters candidates and explains the ranking.'
|
|
2263
|
+
|
|
2264
|
+
const AUDIT_DESCRIPTION =
|
|
2265
|
+
'Audit an existing BOM against the JLCPCB parts library and the LCSC domestic store: per line USD price (tier shown, taken at qty x boards), stock_smt, stock_lcsc, ' +
|
|
2266
|
+
'basic-vs-extended library, placement (smt / hand / dnp), and for assembly="smt" the USD 3 extended-part feeder fee, plus basic-library alternative suggestions with NET saving. ' +
|
|
2267
|
+
'Input `bom` as CSV/TSV text (LCSC codes required; header optional; optional place/mount column) or a JSON array like [{"lcsc":"C1581","qty":5,"place":"smt"}]. ' +
|
|
2268
|
+
'Duplicate LCSC lines are merged (feeder fee charged once, tier taken at the combined quantity). DNP and hand lines are excluded from the SMT component/fee totals and reported separately. ' +
|
|
2269
|
+
'Default assembly="hand" (no feeder fees); set assembly="smt" for JLCPCB assembly cost planning. ' +
|
|
2270
|
+
'Outputs a batch amortisation table (20/100/300/1000 boards), an optimisation summary of net savings, and optionally a JLCPCB BOM CSV for ordering (export_bom=true). ' +
|
|
2271
|
+
'Real CNY retail prices are fetched via headless Chrome (24h cache) when include_cny=true; otherwise a reference estimate from bulk-tier USD × the configurable factor is reported and marked estimated=true. ' +
|
|
2272
|
+
'USD and CNY are never mixed into one total.'
|
|
2273
|
+
|
|
2274
|
+
/** Build the two DSH tool definitions bound to a service instance. */
|
|
2275
|
+
export function createToolDefinitions(service) {
|
|
2276
|
+
return [
|
|
2277
|
+
{
|
|
2278
|
+
name: 'find_lcsc_parts',
|
|
2279
|
+
description: FIND_DESCRIPTION,
|
|
2280
|
+
parameters: {
|
|
2281
|
+
type: 'object',
|
|
2282
|
+
additionalProperties: false,
|
|
2283
|
+
required: ['need'],
|
|
2284
|
+
properties: {
|
|
2285
|
+
need: {
|
|
2286
|
+
type: 'string',
|
|
2287
|
+
description: 'Requirement in natural language (Chinese or English), e.g. "0402 100nF 50V X7R capacitor", "3.3V LDO SOT-23-5 500mA", "10kΩ 0402 resistor", "TP4054", "C1581".',
|
|
2288
|
+
},
|
|
2289
|
+
assembly: {
|
|
2290
|
+
type: 'string',
|
|
2291
|
+
enum: ['hand', 'smt'],
|
|
2292
|
+
description: 'hand = you buy parts and solder yourself (default; library type ignored); smt = JLCPCB assembly (basic library preferred, USD 3 extended-part feeder fee amortized).',
|
|
2293
|
+
},
|
|
2294
|
+
quantity: { type: 'integer', minimum: 1, maximum: 100000, description: 'Parts needed per board (default 1).' },
|
|
2295
|
+
boards: { type: 'integer', minimum: 1, maximum: 100000, description: 'Number of boards to build (default 1; used for price tiers and SMT fee amortization).' },
|
|
2296
|
+
sort: { type: 'string', enum: ['balanced', 'cost', 'stock'], description: 'Ranking preference (default balanced).' },
|
|
2297
|
+
limit: { type: 'integer', minimum: 1, maximum: 8, description: 'Candidates to return (default 5, max 8).' },
|
|
2298
|
+
include_cny: { type: 'boolean', description: 'Fetch real LCSC domestic CNY retail prices for the top candidates via headless Chrome (default true in hand mode, false in smt mode; 24h cache). When unavailable, a marked reference estimate is shown.' },
|
|
2299
|
+
exclude_lcsc: { type: 'array', items: { type: 'string' }, description: 'LCSC codes to exclude, e.g. when looking for an alternative to a part you already have.' },
|
|
2300
|
+
base_only: { type: 'boolean', description: 'Only return JLCPCB basic-library parts (no feeder fee). If none exist the tool says so instead of silently returning extended parts.' },
|
|
2301
|
+
require_stock: { type: 'string', enum: ['any', 'lcsc', 'smt'], description: 'Stock scope filter. any = no filter (default); lcsc = 立创商城零售仓有货 (DIY 配单); smt = 嘉立创 SMT 仓有货 (PCBA). lcsc forces a real CNY/stock lookup.' },
|
|
2302
|
+
},
|
|
2303
|
+
},
|
|
2304
|
+
output: {
|
|
2305
|
+
schema: {
|
|
2306
|
+
type: 'object',
|
|
2307
|
+
additionalProperties: false,
|
|
2308
|
+
required: ['need', 'assembly', 'candidates', 'notes'],
|
|
2309
|
+
properties: {
|
|
2310
|
+
need: { type: 'string' },
|
|
2311
|
+
assembly: { type: 'string' },
|
|
2312
|
+
quantity: { type: 'integer' },
|
|
2313
|
+
boards: { type: 'integer' },
|
|
2314
|
+
order_qty: { type: 'integer' },
|
|
2315
|
+
currency: { type: 'string' },
|
|
2316
|
+
candidates: { type: 'array', items: { type: 'object' } },
|
|
2317
|
+
hints: { type: 'array', items: { type: 'string' } },
|
|
2318
|
+
notes: { type: 'array', items: { type: 'string' } },
|
|
2319
|
+
relaxed: { type: 'boolean' },
|
|
2320
|
+
relax_stage: { type: 'integer' },
|
|
2321
|
+
exact: { type: 'boolean' },
|
|
2322
|
+
require_stock: { type: 'string' },
|
|
2323
|
+
stock_scope_note: { type: 'string' },
|
|
2324
|
+
data_warnings: { type: 'array', items: { type: 'string' } },
|
|
2325
|
+
fetched_at: { type: 'string' },
|
|
2326
|
+
},
|
|
2327
|
+
},
|
|
2328
|
+
render: (_args, value) => [{ type: 'text', text: renderFindText(value) }],
|
|
2329
|
+
},
|
|
2330
|
+
presentCall: (args) => ({ card: 'generic', title: 'Find LCSC parts', kind: 'read', rawInput: args }),
|
|
2331
|
+
async execute(args, exec) {
|
|
2332
|
+
return toLossless(await findParts(service, args, { signal: exec?.signal }))
|
|
2333
|
+
},
|
|
2334
|
+
},
|
|
2335
|
+
{
|
|
2336
|
+
name: 'audit_lcsc_bom',
|
|
2337
|
+
description: AUDIT_DESCRIPTION,
|
|
2338
|
+
parameters: {
|
|
2339
|
+
type: 'object',
|
|
2340
|
+
additionalProperties: false,
|
|
2341
|
+
required: ['bom'],
|
|
2342
|
+
properties: {
|
|
2343
|
+
bom: {
|
|
2344
|
+
type: 'string',
|
|
2345
|
+
description: 'BOM as CSV/TSV text with LCSC codes and quantities (header optional), or a JSON array string like [{"lcsc":"C1581","qty":5}].',
|
|
2346
|
+
},
|
|
2347
|
+
assembly: {
|
|
2348
|
+
type: 'string',
|
|
2349
|
+
enum: ['hand', 'smt'],
|
|
2350
|
+
description: 'hand = no JLCPCB feeder fees (default); smt = include USD 3 per extended part number per order.',
|
|
2351
|
+
},
|
|
2352
|
+
boards: { type: 'integer', minimum: 1, maximum: 100000, description: 'Number of boards the BOM is for (default 1).' },
|
|
2353
|
+
include_cny: { type: 'boolean', description: 'Fetch real LCSC domestic CNY prices via headless Chrome (24h cache, capped; default true in hand mode for small BOMs, false for large BOMs — pass true to force).' },
|
|
2354
|
+
require_stock: { type: 'string', enum: ['any', 'lcsc', 'smt'], description: 'Stock scope for basic-library substitution suggestions. any = no filter (default); lcsc = only suggest parts with 立创零售仓库存 (DIY 配单); smt = only suggest parts with 嘉立创 SMT 仓库存 (PCBA). Each suggestion always reports stock_retail and stock_smt.' },
|
|
2355
|
+
suggest_alternatives: { type: 'boolean', description: 'For extended-library parts, suggest a basic-library substitute with net saving (default true; only in smt mode).' },
|
|
2356
|
+
export_bom: { type: 'boolean', description: 'Also return a JLCPCB BOM CSV (Comment/Designator/Footprint/LCSC Part) for the smt-placed lines (default false).' },
|
|
2357
|
+
region: { type: 'string', enum: ['global', 'cn'], description: 'Fee/currency context label. global = JLCPCB international (USD); cn = 嘉立创国内 (fee rules shown as assumptions, always labelled). Default global.' },
|
|
2358
|
+
},
|
|
2359
|
+
},
|
|
2360
|
+
output: {
|
|
2361
|
+
schema: {
|
|
2362
|
+
type: 'object',
|
|
2363
|
+
additionalProperties: false,
|
|
2364
|
+
required: ['assembly', 'summary', 'rows', 'notes'],
|
|
2365
|
+
properties: {
|
|
2366
|
+
assembly: { type: 'string' },
|
|
2367
|
+
boards: { type: 'integer' },
|
|
2368
|
+
region: { type: 'string' },
|
|
2369
|
+
require_stock: { type: 'string' },
|
|
2370
|
+
stock_scope: { type: 'string' },
|
|
2371
|
+
currency: { type: 'string' },
|
|
2372
|
+
summary: { type: 'object' },
|
|
2373
|
+
data_warnings: { type: 'array', items: { type: 'string' } },
|
|
2374
|
+
optimize: { type: 'object' },
|
|
2375
|
+
bom_csv: { type: 'string' },
|
|
2376
|
+
rows: { type: 'array', items: { type: 'object' } },
|
|
2377
|
+
skipped: { type: 'array', items: { type: 'object' } },
|
|
2378
|
+
errors: { type: 'array', items: { type: 'string' } },
|
|
2379
|
+
hints: { type: 'array', items: { type: 'string' } },
|
|
2380
|
+
notes: { type: 'array', items: { type: 'string' } },
|
|
2381
|
+
fetched_at: { type: 'string' },
|
|
2382
|
+
},
|
|
2383
|
+
},
|
|
2384
|
+
render: (_args, value) => [{ type: 'text', text: renderAuditText(value) }],
|
|
2385
|
+
},
|
|
2386
|
+
presentCall: (args) => ({ card: 'generic', title: 'Audit LCSC BOM', kind: 'read', rawInput: args }),
|
|
2387
|
+
async execute(args, exec) {
|
|
2388
|
+
return toLossless(await auditBom(service, args, { signal: exec?.signal }))
|
|
2389
|
+
},
|
|
2390
|
+
},
|
|
2391
|
+
]
|
|
2392
|
+
}
|
|
2393
|
+
|
|
2394
|
+
/* -------------------------------------------------------------------------- */
|
|
2395
|
+
/* Plugin entry */
|
|
2396
|
+
/* -------------------------------------------------------------------------- */
|
|
2397
|
+
|
|
2398
|
+
/**
|
|
2399
|
+
* DSH plugin entry: called by the Loader once the `tools` service is available.
|
|
2400
|
+
* @param {unknown} ctx
|
|
2401
|
+
* @param {unknown} [config] row `config` from cordis.patch.yml
|
|
2402
|
+
*/
|
|
2403
|
+
export function apply(ctx, config) {
|
|
2404
|
+
const warnings = []
|
|
2405
|
+
const settings = normalizeConfig(config, { onWarning: (message) => warnings.push(message) })
|
|
2406
|
+
const logger = safeLogger(ctx)
|
|
2407
|
+
for (const warning of warnings) logger?.warn?.(`[lcsc] ${warning}`)
|
|
2408
|
+
const service = createLcscService(settings)
|
|
2409
|
+
// Domestic CNY adapter: headless Chrome + 24h cache. Kept optional so the
|
|
2410
|
+
// plugin still works on hosts without Chrome (falls back to USD estimates).
|
|
2411
|
+
let cnAdapter
|
|
2412
|
+
if (settings.cnRender !== false) {
|
|
2413
|
+
try {
|
|
2414
|
+
cnAdapter = createCnAdapter({
|
|
2415
|
+
chromePath: settings.chromePath ?? undefined,
|
|
2416
|
+
cacheDir: settings.cnCacheDir ?? undefined,
|
|
2417
|
+
cacheTtlMs: settings.cnCacheTtlMs,
|
|
2418
|
+
timeoutMs: settings.cnTimeoutMs,
|
|
2419
|
+
concurrency: settings.cnConcurrency,
|
|
2420
|
+
browserIdleTtlMs: settings.cnBrowserIdleTtlMs,
|
|
2421
|
+
cacheMaxEntries: settings.cnCacheMaxEntries,
|
|
2422
|
+
verbose: settings.verbose,
|
|
2423
|
+
logger,
|
|
2424
|
+
})
|
|
2425
|
+
service.cn = cnAdapter
|
|
2426
|
+
if (settings.verbose) {
|
|
2427
|
+
logger?.info?.(cnAdapter.chromePath === undefined
|
|
2428
|
+
? '[lcsc] Chrome not found: CNY prices will fall back to USD estimates'
|
|
2429
|
+
: `[lcsc] CNY adapter ready (chrome: ${cnAdapter.chromePath})`)
|
|
2430
|
+
}
|
|
2431
|
+
} catch (error) {
|
|
2432
|
+
logger?.warn?.(`[lcsc] CNY adapter init failed: ${error instanceof Error ? error.message : String(error)}`)
|
|
2433
|
+
}
|
|
2434
|
+
}
|
|
2435
|
+
/** @type {{ effect?: (fn: () => (() => void)) => void, tools?: { register: (definition: unknown) => void } }} */
|
|
2436
|
+
const context = isRecord(ctx) ? ctx : {}
|
|
2437
|
+
context.effect?.(() => () => {
|
|
2438
|
+
service.clearCache()
|
|
2439
|
+
cnAdapter?.dispose?.()
|
|
2440
|
+
cnAdapter?.clearMemory?.()
|
|
2441
|
+
})
|
|
2442
|
+
for (const definition of createToolDefinitions(service)) {
|
|
2443
|
+
context.tools?.register(definition)
|
|
2444
|
+
}
|
|
2445
|
+
if (settings.verbose) logger?.info?.('[lcsc] tools registered: find_lcsc_parts, audit_lcsc_bom')
|
|
2446
|
+
}
|
|
2447
|
+
|
|
2448
|
+
/** @param {unknown} ctx */
|
|
2449
|
+
function safeLogger(ctx) {
|
|
2450
|
+
try {
|
|
2451
|
+
if (!isRecord(ctx)) return undefined
|
|
2452
|
+
const logger = ctx.logger
|
|
2453
|
+
if (typeof logger !== 'function') return undefined
|
|
2454
|
+
const named = logger('lcsc')
|
|
2455
|
+
return isRecord(named) ? named : undefined
|
|
2456
|
+
} catch {
|
|
2457
|
+
return undefined
|
|
2458
|
+
}
|
|
2459
|
+
}
|