@windypro-rourou/dsh-eda 0.1.0

package/src/nl-to-design.js

@@ -0,0 +1,158 @@
+// ============================================================================
+// dsh-lichuang-eda · 自然语言 → 结构化电路设计（翻译层 v0）
+// ============================================================================
+// 面向 0 基础用户：把「中文需求 / 模板 ID」翻译成 json-gen.js 能消费的
+// design 对象（{ name, components, wires, nets }）。
+//
+// v0 为规则版（模板 + 关键词匹配），生成器目前只支持 resistor / led，
+// 所以可生成的模板有限；其余能力如实返回 ok:false + 说明（不编造）。
+// 后续接入 LLM 后可这里挂一个"语义翻译"钩子（见 TODO 注释）。
+// ============================================================================
+
+import { coordKey } from './validate.js'
+
+/**
+ * 模板目录（供 UI 卡片墙 / agent 展示）。
+ * supported=false 的模板：真实生成暂不支持，但会给出解释。
+ */
+export const TEMPLATE_CATALOG = [
+  {
+    id: 'led-blink',
+    ico: '💡',
+    name: 'LED 点亮最小电路',
+    desc: '限流电阻 + LED，5V 供电，电阻接 5V、LED 接 GND',
+    supported: true,
+  },
+  {
+    id: 'voltage-divider',
+    ico: '⚡',
+    name: '电阻分压（降压基准）',
+    desc: '两电阻分压：5V → R1(1k) → R2(2k) → GND，中点 3.3V（近似）',
+    supported: true,
+  },
+  {
+    id: 'buck',
+    ico: '🔋',
+    name: '5V→3.3V 降压电路',
+    desc: '专业降压需电感/稳压芯片，v0 提供电阻分压近似 + 说明',
+    supported: 'approx',
+  },
+  {
+    id: 'esp32-min',
+    ico: '🛰️',
+    name: 'ESP32 最小系统',
+    desc: '需要主控芯片符号，v0 暂不支持该元件类型',
+    supported: false,
+  },
+  {
+    id: 'motor-drive',
+    ico: '🟢',
+    name: '电机驱动',
+    desc: '需要 MOSFET/驱动芯片符号，v0 暂不支持',
+    supported: false,
+  },
+  {
+    id: 'uart-convert',
+    ico: '🔌',
+    name: '接口转换',
+    desc: '需要电平转换/USB 芯片符号，v0 暂不支持',
+    supported: false,
+  },
+]
+
+/** 规则：生成 LED 点亮最小电路（R + LED 串联手拉手）。 */
+function buildLedDesign() {
+  return {
+    name: 'led-blink',
+    components: [
+      { ref: 'R1', type: 'resistor', value: '220', pos: { x: 400, y: 300 } },
+      { ref: 'LED1', type: 'led', value: 'red', pos: { x: 700, y: 300 } },
+    ],
+    // R1 右引脚(450,300) → LED1 阳极(740,300) 直连
+    wires: [[450, 300, 740, 300]],
+    nets: [
+      { name: '5V', points: [[350, 300]] },
+      { name: 'GND', points: [[660, 300]] },
+    ],
+  }
+}
+
+/** 规则：电阻分压（R1+R2 串联，中点网络标签 3.3V）。 */
+function buildDividerDesign() {
+  return {
+    name: 'voltage-divider',
+    components: [
+      { ref: 'R1', type: 'resistor', value: '1k', pos: { x: 400, y: 300 } },
+      { ref: 'R2', type: 'resistor', value: '2k', pos: { x: 900, y: 300 } },
+    ],
+    wires: [[450, 300, 850, 300]],
+    nets: [
+      { name: '5V', points: [[350, 300]] },
+      { name: '3.3V', points: [[650, 300]] },
+      { name: 'GND', points: [[950, 300]] },
+    ],
+  }
+}
+
+const TEMPLATE_BUILDERS = {
+  'led-blink': buildLedDesign,
+  'voltage-divider': buildDividerDesign,
+  buck: buildDividerDesign, // 近似：分压 + 说明
+}
+
+/**
+ * 按模板 ID 生成设计。
+ * @returns {{ ok:boolean, design?:object, note?:string, title:string }}
+ */
+export function templateById(id) {
+  const meta = TEMPLATE_CATALOG.find((t) => t.id === id)
+  if (meta === undefined) return { ok: false, title: id, note: `未知模板：${id}` }
+  if (meta.supported === false) {
+    return { ok: false, title: meta.name, note: `模板「${meta.name}」需要其他元件符号（${meta.desc}），v0 生成器暂仅支持 电阻/ LED。` }
+  }
+  const builder = TEMPLATE_BUILDERS[id]
+  if (builder === undefined) return { ok: false, title: meta.name, note: `模板「${meta.name}」尚未实现规则。` }
+  const design = builder()
+  const note = id === 'buck' ? '提示：电阻分压只适合小电流基准；真正的 5V→3.3V 降压建议用降压芯片（后续版本支持）。' : undefined
+  return { ok: true, design, title: meta.name, note }
+}
+
+/** 简单关键词匹配（规则版 NLU）。返回 { ok, design?, note?, title?, matched? } */
+function matchByKeywords(text) {
+  const t = String(text ?? '').toLowerCase()
+  if (/led|发光|灯.?闪|点.?亮/.test(t)) {
+    return templateById('led-blink')
+  }
+  if (/分压|降压|3\.3v|3v3|基准电压/.test(t)) {
+    return templateById('buck')
+  }
+  return null
+}
+
+/**
+ * 中文需求 → design。规则版：先模板匹配，未命中则提示。
+ * @param {string} text 用户的中文描述
+ * @param {object} opts { template?: string } 可指定模板 ID
+ * @returns {{ ok:boolean, design?:object, title:string, note?:string, matched?:string }}
+ */
+export function translateRequest(text, opts = {}) {
+  if (opts.template) return templateById(opts.template)
+  const byKw = matchByKeywords(text)
+  if (byKw !== null) return { ...byKw, matched: true }
+  return {
+    ok: false,
+    title: '待支持的电路',
+    note:
+      'v0 规则版只能识别「LED 点亮 / 电阻分压 / 降压」等简单需求。' +
+      '请用这些词（例：一个 LED 点亮电路、电阻分压）或从模板卡选择；' +
+      '完整自然语言理解将在接入 LLM 翻译层后支持。',
+  }
+}
+
+/** 给 UI/agent 用的设计摘要。 */
+export function describeDesign(design) {
+  if (design === undefined) return '（无设计）'
+  const comps = design.components.map((c) => `${c.ref}(${c.type}) ${c.value}@${coordKey(c.pos?.x, c.pos?.y)}`).join('、')
+  const nets = (design.nets ?? []).map((n) => n.name).join('、')
+  return `元件: ${comps || '无'}; 导线: ${(design.wires ?? []).length} 条; 网络: ${nets || '无'}`
+}

package/src/validate.js

@@ -0,0 +1,159 @@
+// ============================================================================
+// dsh-lichuang-eda · 结构校验 + 网表推导 + 连通性检查（供测试与插件调用）
+// ============================================================================
+// 纯 ESM、零 npm 依赖。基于 src/json-gen.js 的生成物与输入 design 做校验：
+//   - validateSchematic(obj)   : 结构校验（顶层/head/canvas/shape/BBox/colors）
+//   - deriveNetlist(design)    : 从 design（元件引脚/导线/网络）推导网表
+//   - checkConnectivity(design): 连通性检查（悬空引脚 / 孤立网络 / 未闭合）
+//
+// 说明：本次只支持 resistor / led 两种符号（与 SYMBOL_BUILDERS 一致），
+//       引脚几何与 buildResistorLib / buildLedLib 硬编码一致（旋转 0/180）。
+// ============================================================================
+
+/** 坐标归一化为键（保留 2 位小数），用于去重/连通。 */
+export function coordKey(x, y) {
+  return `${Math.round(Number(x) * 100) / 100},${Math.round(Number(y) * 100) / 100}`
+}
+
+/**
+ * 元件引脚点（resistor: 右+50/左-50；led: 阳极+40/阴极-40；与生成器一致）。
+ * @returns {Array<{x,y,ref,pin}>}
+ */
+export function pinPoints(comp) {
+  const cx = Number(comp.pos?.x ?? NaN)
+  const cy = Number(comp.pos?.y ?? NaN)
+  if (Number.isNaN(cx) || Number.isNaN(cy)) return []
+  if (comp.type === 'resistor') {
+    return [
+      { x: cx + 50, y: cy, ref: comp.ref, pin: 1 },
+      { x: cx - 50, y: cy, ref: comp.ref, pin: 2 },
+    ]
+  }
+  if (comp.type === 'led') {
+    return [
+      { x: cx + 40, y: cy, ref: comp.ref, pin: 1 },
+      { x: cx - 40, y: cy, ref: comp.ref, pin: 2 },
+    ]
+  }
+  return []
+}
+
+/** 极简 union-find。 */
+function makeUnionFind(keys) {
+  const parent = new Map()
+  for (const k of keys) parent.set(k, k)
+  const find = (x) => {
+    while (parent.get(x) !== x) { parent.set(x, parent.get(parent.get(x))); x = parent.get(x) }
+    return x
+  }
+  const union = (a, b) => { const ra = find(a), rb = find(b); if (ra !== rb) parent.set(ra, rb) }
+  return { find, union }
+}
+
+/**
+ * 从 design 推导网表：把导线顶点、元件引脚、网络标签/接地标志按坐标合并成
+ * 连通网络。返回 { nets: [ { name, pins:[{ref,pin}], points:[coords] } ],
+ *                  dangling: [ {ref,pin} ] }。
+ * @param {object} design { components, wires, nets, ... }
+ */
+export function deriveNetlist(design = {}) {
+  const components = design.components ?? []
+  const wires = design.wires ?? []
+  const nets = design.nets ?? []
+
+  // 收集所有节点坐标
+  const nodeKeys = new Set()
+  const wireLinks = [] // [ [key,key], ... ]
+  const pinList = []   // { key, ref, pin }
+  const labelPoints = [] // { key, name } (network label / GND flag)
+
+  for (const comp of components) {
+    for (const p of pinPoints(comp)) {
+      const k = coordKey(p.x, p.y)
+      nodeKeys.add(k)
+      pinList.push({ key: k, ref: comp.ref, pin: p.pin })
+    }
+  }
+  for (const w of wires) {
+    for (let i = 0; i + 1 < w.length; i += 2) {
+      const a = coordKey(w[i], w[i + 1])
+      const b = coordKey(w[i + 2], w[i + 3])
+      nodeKeys.add(a); nodeKeys.add(b)
+      wireLinks.push([a, b])
+    }
+  }
+  for (const net of nets) {
+    for (const [nx, ny] of net.points) {
+      const k = coordKey(nx, ny)
+      nodeKeys.add(k)
+      labelPoints.push({ key: k, name: net.name })
+    }
+  }
+
+  const uf = makeUnionFind([...nodeKeys])
+  for (const [a, b] of wireLinks) uf.union(a, b)
+
+  // 分组：root -> { pins:[], labels:Set, points:Set }
+  const groups = new Map()
+  const attach = (key) => {
+    const root = uf.find(key)
+    let g = groups.get(root)
+    if (g === undefined) { g = { pins: [], labels: new Set(), points: new Set() }; groups.set(root, g) }
+    g.points.add(key)
+    return g
+  }
+  for (const p of pinList) { const g = attach(p.key); g.pins.push({ ref: p.ref, pin: p.pin }) }
+  for (const l of labelPoints) { const g = attach(l.key); g.labels.add(l.name) }
+
+  // 每个连通组是 1 个"物理网"；网络名 = 组内标签名（GND 优先，取首个）。
+  const netsOut = []
+  const dangling = []
+  for (const [, g] of groups) {
+    const name = g.labels.size > 0 ? [...g.labels][0] : null // 网络标签/接地名（命名网）
+    netsOut.push({ name, pins: g.pins, points: [...g.points] })
+    // 悬空：某引脚所在的组只有它自己这一个引脚，且没有命名标签 → 未接入任何其他元件
+    if (g.pins.length === 1 && name === null) dangling.push(...g.pins)
+  }
+  return { nets: netsOut, dangling }
+}
+
+/**
+ * 结构校验：对生成物（平面单片对象）做字段级检查。
+ * @param {object} obj generateSchematic 的返回值
+ * @returns {{ ok:boolean, errors:string[] }}
+ */
+export function validateSchematic(obj) {
+  const errors = []
+  if (obj === null || typeof obj !== 'object') { return { ok: false, errors: ['not an object'] } }
+  const mustHave = ['head', 'canvas', 'shape', 'BBox', 'colors']
+  for (const k of mustHave) if (!(k in obj)) errors.push(`missing top-level key: ${k}`)
+  if (obj.head) {
+    for (const k of ['docType', 'editorVersion', 'newgId', 'c_para', 'c_spiceCmd', 'hasIdFlag', 'uuid', 'x', 'y', 'portOfADImportHack', 'importFlag', 'transformList']) {
+      if (!(k in obj.head)) errors.push(`missing head key: ${k}`)
+    }
+    if (obj.head.docType !== '1') errors.push(`head.docType expected "1", got ${obj.head.docType}`)
+  }
+  if (typeof obj.canvas === 'string') {
+    if (!obj.canvas.startsWith('CA~')) errors.push('canvas must start with CA~')
+    if (obj.canvas.split('~').length !== 15) errors.push(`canvas expected 15 segments, got ${obj.canvas.split('~').length}`)
+  } else errors.push('canvas must be a string')
+  if (Array.isArray(obj.shape)) {
+    if (obj.shape.length === 0) errors.push('shape is empty')
+  } else errors.push('shape must be an array')
+  if (!('BBox' in obj) || typeof obj.BBox !== 'object') errors.push('BBox missing or not object')
+  if (!('colors' in obj) || typeof obj.colors !== 'object') errors.push('colors missing or not object')
+  return { ok: errors.length === 0, errors }
+}
+
+/**
+ * 连通性检查：网表推导 + 悬空引脚判定。
+ * @param {object} design
+ * @returns {{ ok:boolean, errors:string[], netlist:{nets,dangling} }}
+ */
+export function checkConnectivity(design = {}) {
+  const { nets, dangling } = deriveNetlist(design)
+  const errors = []
+  // 每个元件引脚都必须落在某一命名网，或与其它元件引脚同网（即 ≥2 脚）。
+  for (const d of dangling) errors.push(`引脚 ${d.ref}.${d.pin} 悬空（未连线/未打网络标签）`)
+  return { ok: errors.length === 0, errors, netlist: { nets, dangling } }
+}