dsh-plugin-lcsc 0.3.3 → 0.3.4

package/README.md

@@ -89,7 +89,7 @@ Host-only bundle，无 UI 面板；`engines.dsh >= 0.2.2-rc.1 < 0.3.0`。装完
   config:
     cnRender: true             # 国内站 Chrome 渲染（关掉则只有 USD + 估算）
     chromePath: ''             # 本机 Chrome/Chromium 路径；留空则自动嗅探（见下）
-    cnConcurrency: 4           # 常驻 Chrome 并发标签数 1-8
+    cnConcurrency: 2           # 常驻 Chrome 并发标签数 1-8（WAF 阵发，建议 ≤2）
     cnBrowserIdleTtlMs: 120000 # 空闲多久关 Chrome
     cnQueryBudgetMs: 90000     # 单次 BOM 取 CNY 时间预算；超时先返回，缓存续跑
     cnCacheTtlMs: 86400000     # JSON 缓存 24h TTL
@@ -132,6 +132,38 @@ node poc/test-improvements.mjs     # 联网验收（BOM v0.6 100 片 + 人民币
 
 准确性参考（2026-11-11 实测）：28 个料的 BOM 数据 28/28 取到真实 CNY，手焊总价 **¥4.0791**（Recording_card 官方口径 ¥4.0793）；单料如 C1581 ¥0.0239、C7434398 ¥1.097。
 
+## 已知问题（Known Issues）
+
+### 1. 国内站 WAF 阵发，会成批失败
+
+`item.szlcsc.com` 在阿里云 WAF 后面，触发后一段时间内**整批**请求都会被挑战。
+
+- **已缓解**：单料失败自动**重试 1 次**（1.5s 退避）；`cnConcurrency` 默认已降到 **2**
+- **失败不缓存，成功缓存 24h**：所以重跑只补失败项，已成功的直接命中缓存
+- 工具输出会写清 `失败原因：szlcsc-waf-challenge×N`，并提示**稍后重试即可、不需要改配置**
+- 若仍然频繁：把 `cnConcurrency` 降到 `1`
+
+### 2. `product-id-not-found` 是数据缺口，重试无用
+
+部分料号在 EasyEDA / lceda 查不到对应的国内商品 id（常见于新料、国内专属料、非零售料）。
+这类只能看 USD 价，`hints` 里会明确标注，**不要**把它当成 Chrome 配置问题去反复调。
+
+### 3. Chrome 必须装在本机
+
+真实人民币价依赖本机 Chrome/Chromium。查找顺序：`chromePath` → `CHROME_BIN` → 自动嗅探。
+找不到时 `hints` 会给出**已尝试的路径 + 修复方法**，按提示配 `chromePath` 即可，不需要改代码。
+
+### 4. 手焊模式下出现 NOT-FOUND 可能只是国内站暂时不可用
+
+判断条件是「嘉立创 SMT 没有 **且** 国内站查不到」。国内站被 WAF 挡住时，立创有货的料也会落到
+`NOT-FOUND`。隔几分钟重跑通常就恢复；`hints` 会告诉你当时的真实原因。
+
+### 5. 0.3.3 及更早：Chrome 适配器未初始化（0.3.4 已修）
+
+0.3.3 的 `index.js` 漏了 `createCnAdapter` 的 import，导致 `apply()` 里创建适配器时抛
+`createCnAdapter is not defined` 并被吞掉，**人民币链路整条不生效**（静默回退到旧路径）。
+0.3.4 修复，并在 `validate.mjs` 增加了接线回归断言。
+
 ## 局限（无法消除，只会缓解）
 
 1. 价格和库存是**快照**，不保证下单时一致；24h 缓存只提速，不改变这一点。

package/cn.js

@@ -66,6 +66,24 @@ const DEFAULT_USER_AGENT =
   'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 ' +
   '(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36'
 
+/** Ali yun WAF challenge markers: page is not the product page we asked for. */
+const WAF_HINT_RE = /aliyun|acw_sc__v2|_____tmd_____|验证码|captcha|challenge-platform|error code.*?5\d\d/i
+
+/**
+ * True when the rendered HTML is a WAF challenge page rather than a product
+ * page. A page carrying `__NEXT_DATA__` is always the real one.
+ * @param {unknown} html
+ */
+export function looksLikeWafChallenge(html) {
+  if (typeof html !== 'string' || html === '') return false
+  if (html.includes('__NEXT_DATA__')) return false
+  return WAF_HINT_RE.test(html)
+}
+
+/** One retry for transient failures; the domestic site challenges in bursts. */
+const RETRY_DELAY_MS = 1500
+const RETRYABLE_FAILURES = new Set(['szlcsc-waf-challenge', 'chrome-render-empty', 'page-parse-failed'])
+
 /**
  * How to fix a missing Chrome, phrased so an agent can act on it directly.
  * @param {{ path?: string, source?: string, tried: string[], configPath?: string, envPath?: string }} info
@@ -299,7 +317,7 @@ export function createCnAdapter(options = {}) {
   const profileDir = path.join(cacheDir, 'chrome-profile')
   const cacheTtlMs = Number.isFinite(options.cacheTtlMs) ? options.cacheTtlMs : 24 * 60 * 60 * 1000
   const timeoutMs = Number.isFinite(options.timeoutMs) ? options.timeoutMs : 30000
-  const concurrency = Math.max(1, Math.min(8, Math.floor(options.concurrency ?? 4)))
+  const concurrency = Math.max(1, Math.min(8, Math.floor(options.concurrency ?? 2)))
   const browserIdleTtlMs = Number.isFinite(options.browserIdleTtlMs) ? options.browserIdleTtlMs : 120000
   const cacheMaxEntries = Number.isFinite(options.cacheMaxEntries) ? Math.max(1, Math.floor(options.cacheMaxEntries)) : 800
   const legacyProfileDir = path.join(cacheDir, 'legacy-profile')
@@ -699,40 +717,56 @@ export function createCnAdapter(options = {}) {
       return cached
     }
     return withSlot(async () => {
-      try {
-        const pid = await resolvePid(normalized)
-        if (pid === undefined) return { ok: false, reason: 'product-id-not-found' }
-        const html = await renderHtml(`${ITEM_URL}${pid}.html`)
-        if (html === '') return { ok: false, reason: 'chrome-render-empty' }
-        const parsed = parseItemHtml(html)
-        if (parsed === undefined || parsed.price === undefined) {
-          return { ok: false, reason: 'page-parse-failed' }
-        }
-        const record = {
-          ok: true,
-          lcsc: normalized,
-          product_id: pid,
-          unit: parsed.price,
-          currency: 'CNY',
-          stock: parsed.stock,
-          model: parsed.model,
-          brand: parsed.brand,
-          package: parsed.package,
-          min_buy: parsed.min_buy,
-          packing: parsed.packing,
-          unit_name: parsed.unit,
-          category: parsed.category,
-          desc: parsed.desc,
-          source: 'lcsc_cn_render',
-          fetched_at: new Date().toISOString(),
-          cache_age_s: 0,
-          cached: false,
+      /** @type {{ ok: false, reason: string, attempts: number } | undefined} */
+      let failure
+      for (let attempt = 1; attempt <= 2; attempt += 1) {
+        if (attempt > 1) await sleep(RETRY_DELAY_MS)
+        try {
+          const pid = await resolvePid(normalized)
+          if (pid === undefined) return { ok: false, reason: 'product-id-not-found', attempts: attempt }
+          const html = await renderHtml(`${ITEM_URL}${pid}.html`)
+          if (html === '') {
+            failure = { ok: false, reason: 'chrome-render-empty', attempts: attempt }
+            continue
+          }
+          if (looksLikeWafChallenge(html)) {
+            failure = { ok: false, reason: 'szlcsc-waf-challenge', attempts: attempt }
+            continue
+          }
+          const parsed = parseItemHtml(html)
+          if (parsed === undefined || parsed.price === undefined) {
+            failure = { ok: false, reason: 'page-parse-failed', attempts: attempt }
+            continue
+          }
+          const record = {
+            ok: true,
+            lcsc: normalized,
+            product_id: pid,
+            unit: parsed.price,
+            currency: 'CNY',
+            stock: parsed.stock,
+            model: parsed.model,
+            brand: parsed.brand,
+            package: parsed.package,
+            min_buy: parsed.min_buy,
+            packing: parsed.packing,
+            unit_name: parsed.unit,
+            category: parsed.category,
+            desc: parsed.desc,
+            source: 'lcsc_cn_render',
+            fetched_at: new Date().toISOString(),
+            cache_age_s: 0,
+            cached: false,
+          }
+          writeCache(normalized, record)
+          return record
+        } catch (error) {
+          const reason = error instanceof Error ? error.message : String(error)
+          failure = { ok: false, reason, attempts: attempt }
+          if (!RETRYABLE_FAILURES.has(reason)) return failure
         }
-        writeCache(normalized, record)
-        return record
-      } catch (error) {
-        return { ok: false, reason: error instanceof Error ? error.message : String(error) }
       }
+      return failure ?? { ok: false, reason: 'cn-query-failed', attempts: 2 }
     })
   }
 

package/cordis.patch.yml

@@ -18,7 +18,7 @@
         # chromePath: 'C:\Program Files\Google\Chrome\Application\chrome.exe'
         cnCacheTtlMs: 86400000
         cnTimeoutMs: 30000
-        cnConcurrency: 4
+        cnConcurrency: 2
         cnBrowserIdleTtlMs: 120000
         cnQueryBudgetMs: 90000
         cnCacheMaxEntries: 800

package/data.js

@@ -86,7 +86,7 @@ export const DEFAULT_CONFIG = Object.freeze({
   cnCacheDir: null,
   cnCacheTtlMs: 86400000,
   cnTimeoutMs: 30000,
-  cnConcurrency: 4,
+  cnConcurrency: 2,
   cnBrowserIdleTtlMs: 120000,
   cnQueryBudgetMs: 90000,
   cnCacheMaxEntries: 800,

package/index.js

@@ -29,6 +29,7 @@ import {
   parseBomCsvDetailed,
   pickTierPrice,
 } from './data.js'
+import { createCnAdapter } from './cn.js'
 
 /** Plugin id used by the DSH loader. */
 export const name = 'lcsc-parts'
@@ -1296,18 +1297,32 @@ function cnFailureHint(results, adapter) {
     .map(([reason, count]) => `${reason}×${count}`)
     .join('，')
   const parts = [`国内站人民币价 ${total - failed.length}/${total} 成功，失败原因：${breakdown}。`]
+  const transient = ['szlcsc-waf-challenge', 'chrome-render-empty', 'page-parse-failed'].filter((reason) => counts.has(reason))
   if (counts.has('chrome-not-found')) {
     parts.push(
       typeof adapter?.chrome?.hint === 'string'
         ? adapter.chrome.hint
         : '未找到 Chrome/Chromium：请配置 chromePath 或设置环境变量 CHROME_BIN 后重试。',
     )
-  } else if (adapter?.chrome?.path !== undefined) {
-    parts.push(`当前 Chrome：${adapter.chrome.path}（来源 ${adapter.chrome.source ?? 'auto'}）。`)
+  } else if (transient.length > 0) {
+    parts.push(
+      '以上失败属阵发问题（阿里云 WAF 限流或页面渲染为空），已自动重试 1 次；' +
+        '稍后重试即可，不需要改配置。成功的料号已写入 24h 缓存，重跑只补失败项。' +
+        '若频繁出现，可把 cnConcurrency 降到 1（默认 2）以减少触发。',
+    )
+  }
+  if (counts.has('product-id-not-found')) {
+    parts.push('部分料号在 EasyEDA 查不到商品 id 映射（常见于新料或国内专属料），重试无效，只能参考 USD 价。')
+  }
+  if (counts.has('cny-adapter-unavailable')) {
+    parts.push('人民币适配器未初始化（Chrome 渲染器未挂载），请检查插件是否完整安装及宿主日志。')
   }
   if (counts.has('cn-budget-exceeded')) {
     parts.push('部分料号超出时间预算未查完；结果已写入 24h 缓存，再调用一次会更快补齐。')
   }
+  if (adapter?.chrome?.path !== undefined && counts.has('chrome-not-found') === false) {
+    parts.push(`当前 Chrome：${adapter.chrome.path}（来源 ${adapter.chrome.source ?? 'auto'}）。`)
+  }
   return parts.join('')
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-lcsc",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Requirement-driven LCSC/JLC part finder and BOM cost auditor for DeepSeek Harness agents: real CNY+USD dual pricing, basic-vs-extended library fees, DNP/hand placement, net-saving alternatives",
   "keywords": [
     "dsh-plugin",