@windypro-rourou/dsh-eda 0.1.0

package/lib/installer.js

@@ -0,0 +1,162 @@
+/**
+ * dsh-lichuang-eda — one-click installer for the OFFICIAL EasyEDA bridge.
+ *
+ * Vendors the official `easyeda/easyeda-api-skill` (Skill easyeda-api,
+ * author JLCEDA, MIT) into ~/.dsh/eda/bridge/: downloads the source archive,
+ * extracts it, runs `npm install` (its only dependency is ws), and leaves the
+ * official Bridge Server at <dir>/scripts/bridge-server.mjs.
+ *
+ * No third-party backend (easyeda-agent etc.) is involved.
+ */
+
+import { createHash } from 'node:crypto'
+import { promises as fsp } from 'node:fs'
+import { existsSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { spawn } from 'node:child_process'
+
+export const DEFAULT_VERSION = 'main' // branch of the official skill repo
+export const OFFICIAL_REPO = 'easyeda/easyeda-api-skill'
+export const OFFICIAL_EXT_URL = 'https://jlc-ext.com/item/oshwhub/run-api-gateway' // 官方扩展 Run API Gateway
+
+export function bridgeDir() { return join(homedir(), '.dsh', 'eda', 'bridge') }
+
+/** Absolute path of the official bridge server script. */
+export function bridgeScriptPath() {
+  return join(bridgeDir(), 'scripts', 'bridge-server.mjs')
+}
+
+/** True when the official bridge was installed by this plugin. */
+export function isBridgeInstalled() {
+  return existsSync(join(bridgeDir(), 'package.json')) && existsSync(join(bridgeDir(), 'scripts', 'bridge-server.mjs')) && existsSync(join(bridgeDir(), 'node_modules', 'ws'))
+}
+
+const archiveUrl = (version) => `https://github.com/${OFFICIAL_REPO}/archive/refs/heads/${version}.tar.gz`
+
+function run(cmd, args, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, { ...opts, windowsHide: true })
+    const err = []
+    child.stderr?.on('data', (d) => err.push(String(d)))
+    child.on('exit', (code) => {
+      if (code === 0) resolve({ ok: true })
+      else reject(new Error(`${cmd} ${args.join(' ')} 退出码 ${code}：${err.join('').slice(-300)}`))
+    })
+    child.on('error', reject)
+  })
+}
+
+async function extractTarGz(archive, destTmp) {
+  // bsdtar (Windows 10+) / GNU tar (macOS/Linux) both handle .tar.gz.
+  await fsp.mkdir(destTmp, { recursive: true })
+  try {
+    await run('tar', ['-xf', archive, '-C', destTmp], { stdio: ['ignore', 'ignore', 'pipe'] })
+  } catch (error) {
+    throw new Error('解压失败（需要 tar；Windows 10 1803+ 自带 bsdtar）：' + (error instanceof Error ? error.message : String(error)))
+  }
+}
+
+/** Recursive copy (used to vendor `ws` — the bridge's only runtime dep). */
+async function copyDir(src, dst) {
+  const entries = await fsp.readdir(src, { withFileTypes: true })
+  await fsp.mkdir(dst, { recursive: true })
+  for (const e of entries) {
+    const s = join(src, e.name)
+    const d = join(dst, e.name)
+    if (e.isDirectory()) await copyDir(s, d)
+    else await fsp.copyFile(s, d)
+  }
+}
+
+/**
+ * Locate an existing `ws` package on this machine (the DSH host ships it via
+ * dsh-logcat's dependency) so we can vendor it WITHOUT npm — this machine has
+ * PowerShell ExecutionPolicy blocking `npm.ps1`, and offline copy is faster
+ * and never touches the registry.
+ */
+export async function findExistingWs() {
+  const profiles = join(homedir(), '.dsh', 'profiles')
+  const candidates = []
+  try {
+    for (const p of await fsp.readdir(profiles)) {
+      candidates.push(join(profiles, p, 'node_modules', 'ws'))
+    }
+  } catch { /* profiles dir missing */ }
+  // also the running web profile's hoisted location
+  for (const c of candidates) {
+    try {
+      await fsp.access(join(c, 'package.json'))
+      return c
+    } catch { /* keep looking */ }
+  }
+  return null
+}
+
+async function ensureWs(dir) {
+  // 1) offline vendor from the host's `ws` (no npm, no registry, no PS policy).
+  const src = await findExistingWs()
+  if (src !== null) {
+    const dst = join(dir, 'node_modules', 'ws')
+    await copyDir(src, dst)
+    await fsp.writeFile(join(dir, 'node_modules', 'ws', '.vendored-by-dsh'), 'yes\n', 'utf8')
+    return { method: 'vendored', src }
+  }
+  // 2) fallback: npm (Windows resolves npm.cmd; the .ps1 shim is disabled by policy).
+  const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm'
+  await run(npmCmd, ['install', '--prefix', dir, '--no-fund', '--no-audit'], { stdio: ['ignore', 'ignore', 'pipe'] })
+  return { method: 'npm', src: npmCmd }
+}
+
+/**
+ * Download + install the official bridge (easyeda-api-skill).
+ * @param {object} opts { version=DEFAULT_VERSION }
+ * @returns {Promise<{ok:true,dir,script,version,extUrl,wsMethod}>}
+ */
+export async function installOfficialBridge(opts = {}) {
+  const version = opts.version ?? DEFAULT_VERSION
+  const dir = bridgeDir()
+
+  // Already installed: never touch it (idempotent — keeps the vendored ws and
+  // the live bridge state intact if the user clicks install again).
+  if (isBridgeInstalled()) {
+    return { ok: true, dir, script: bridgeScriptPath(), version, extUrl: OFFICIAL_EXT_URL, already: true }
+  }
+
+  await fsp.mkdir(dir, { recursive: true })
+
+  const url = archiveUrl(version)
+  const res = await fetch(url, { signal: AbortSignal.timeout(120000), redirect: 'follow' })
+  if (!res.ok) throw new Error(`下载官方桥失败：HTTP ${res.status} ${url}`)
+  const buf = Buffer.from(await res.arrayBuffer())
+
+  const tmpRoot = join(homedir(), '.dsh', 'eda', '.tmp-bridge')
+  await fsp.rm(tmpRoot, { recursive: true, force: true })
+  const archive = join(tmpRoot, 'bridge.tar.gz')
+  await fsp.mkdir(tmpRoot, { recursive: true })
+  await fsp.writeFile(archive, buf)
+  const extracted = join(tmpRoot, 'src')
+  await extractTarGz(archive, extracted)
+
+  // Archive layout: <repo>-main/… — move its contents into place.
+  const entries = await fsp.readdir(extracted)
+  const inner = entries.length === 1 ? join(extracted, entries[0]) : extracted
+  for (const name of await fsp.readdir(inner)) {
+    await fsp.rm(join(dir, name), { recursive: true, force: true })
+    await fsp.rename(join(inner, name), join(dir, name))
+  }
+  await fsp.rm(tmpRoot, { recursive: true, force: true })
+
+  // Install the only runtime dependency (ws): offline vendor preferred.
+  await ensureWs(dir)
+
+  const script = bridgeScriptPath()
+  if (!existsSync(script)) throw new Error('官方桥脚本缺失：' + script)
+  const ok = isBridgeInstalled()
+  if (!ok) throw new Error('官方桥依赖（ws）未就绪：npm 被禁或 ws 不可用。请检查 ExecutionPolicy 或网络。')
+  return { ok: true, dir, script, version, extUrl: OFFICIAL_EXT_URL, wsMethod: ok ? 'vendored-or-npm' : 'none' }
+}
+
+export function sha256Hex(buf) {
+  return createHash('sha256').update(buf).digest('hex')
+}

package/lib/layout.js

@@ -0,0 +1,46 @@
+/**
+ * dsh-lichuang-eda — 框内定位（layout）核心。
+ *
+ * 实战固化（esp32_multitool 真机实测）：
+ *   - 原理图坐标单位 10mil，A4 页面 = 1170 × 825（titleBlockData.Width/Height）；
+ *   - 放置必须落在图框内（内边距 ≥ margin），100 单位网格步进；
+ *   - 与已有图元（含导线采样点）最小间距 minGap（Chebyshev）；
+ *   - 从未占用区域"右上→左下"逐行扫描，同排元素保持同一行/列间距 ≥ grid。
+ *
+ * 纯函数（可单测）：读页面交给工具层（桥端代码在 layout.js 之外）。
+ */
+
+/** 在页面上为 count 个元件挑选互不冲突的框内网格点。 */
+export function pickSpots({
+  pageWidth,
+  pageHeight,
+  used = [],
+  count = 1,
+  margin = 80,
+  grid = 100,
+  minGap = 150,
+}) {
+  const spots = []
+  const taken = used.map((u) => ({ x: Number(u.x) || 0, y: Number(u.y) || 0 }))
+  const conflict = (x, y) =>
+    taken.some((u) => Math.abs(u.x - x) < minGap && Math.abs(u.y - y) < minGap) ||
+    spots.some((s) => Math.abs(s.x - x) < minGap && Math.abs(s.y - y) < minGap)
+
+  let y = margin + grid
+  while (spots.length < count && y <= pageHeight - margin) {
+    let x = pageWidth - margin - grid
+    while (x >= margin && spots.length < count) {
+      if (!conflict(x, y)) {
+        spots.push({ x, y, inside: x >= margin && x <= pageWidth - margin && y >= margin && y <= pageHeight - margin })
+      }
+      x -= grid
+    }
+    y += grid
+  }
+  return spots
+}
+
+/** 校验一个点是否在两段式框内（margin 内）。 */
+export function insideFrame({ x, y, pageWidth, pageHeight, margin = 80 }) {
+  return x >= margin && x <= pageWidth - margin && y >= margin && y <= pageHeight - margin
+}

package/lib/snapshot.js

@@ -0,0 +1,252 @@
+/**
+ * dsh-lichuang-eda — 紧急保存（snapshot）核心。
+ *
+ * 「如果画板内容没同步上，用户手里也得有最后的工程」——把 agent 在画板上
+ * 做的东西完整抓到本地：
+ *
+ *   1. 画板现场（需官方桥连接，官方 API）：
+ *      - 当前工程信息 / 当前文档信息（dmt_Project / dmt_SelectControl）
+ *      - 当前文档/工程文件 `.epro2`（专业版原生，完整恢复；SYS_FileManager.getDocumentFile）
+ *      - 当前图页预览 `preview.svg`（通用：任何浏览器/标准版用户都能看）
+ *      - 网表 `netlist.json` + BOM `bom.json`（sch_ManufactureData，供核对）
+ *   2. agent 动作日志 `log.json`（服务端本就有：每次官方 API 调用记录；
+ *      即使画板断连/未连接，最后步骤也能留档）
+ *   3. `meta.json` + `README.txt`（打开方法：专业版恢复 / 标准版查看/重建）
+ *
+ * 设计原则：每一步独立失败（best-effort），一次失败绝不放弃整份快照；
+ * 大结果有上限保护；全部写入 ~/.dsh/eda/snapshots/<project>-<stamp>/。
+ *
+ * 兼容性说明（如实）：官方导出仅 epro/epro2（专业版原生）与 PDF/PNG/SVG，
+ * 无「标准版 v6 JSON」官方导出通道；因此快照 = 专业版完整恢复 +
+ * 通用预览 + 数据文件。标准版可编辑需离线重建（仅简单电路，见
+ * eda_generate_schematic_json / 对话内编排）。
+ */
+
+import { promises as fsp } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+/** Default snapshot root (~/.dsh/eda/snapshots). */
+export function defaultSnapshotDir() {
+  return join(homedir(), '.dsh', 'eda', 'snapshots')
+}
+
+/** Per-execute timeout: the bridge itself dies at 30s, stay under it. */
+export const STEP_TIMEOUT_MS = 25000
+/** Refuse to write a doc payload larger than this (sanity guard). */
+export const MAX_PAYLOAD_BYTES = 30 * 1024 * 1024
+
+const PROJECT_INFO_CODE = 'return await eda.dmt_Project.getCurrentProjectInfo();'
+const DOC_INFO_CODE = 'return await eda.dmt_SelectControl.getCurrentDocumentInfo();'
+
+function docFileCode(baseName) {
+  return `return await (async () => {
+  const f = await eda.sys_FileManager.getDocumentFile('${baseName}');
+  if (!f) return null;
+  const text = await f.text();
+  return { name: f.name, size: f.size, type: f.type, len: text.length, text };
+})();`
+}
+
+function previewSvgCode(baseName) {
+  return `return await (async () => {
+  const f = await eda.sch_ManufactureData.getExportDocumentFile('${baseName}-preview', 'SVG', undefined, 'Current Schematic');
+  if (!f) return null;
+  const text = await f.text();
+  return { name: f.name, size: f.size, len: text.length, text };
+})();`
+}
+
+function netlistCode() {
+  return `return await (async () => { const f = await eda.sch_ManufactureData.getNetlistFile(); return f ? await f.text() : null; })();`
+}
+
+function bomCode() {
+  return `return await (async () => { const f = await eda.sch_ManufactureData.getBomFile(); if (!f) return null; const bytes = new Uint8Array(await f.arrayBuffer()); let bin = ''; for (let i = 0; i < bytes.length; i += 0x8000) bin += String.fromCharCode.apply(null, bytes.subarray(i, i + 0x8000)); return { name: f.name, size: f.size, b64: btoa(bin) }; })();`
+}
+
+/** Write BOM binary (base64 → bytes to disk as .xlsx). */
+async function writeBom(outDir, files, addError, payload) {
+  if (payload == null || typeof payload !== 'object' || typeof payload.b64 !== 'string' || payload.b64 === '') {
+    addError('导出BOM', 'no bom file returned')
+    return null
+  }
+  const buf = Buffer.from(payload.b64, 'base64')
+  await fsp.mkdir(outDir, { recursive: true })
+  const target = join(outDir, 'bom.xlsx')
+  await fsp.writeFile(target, buf)
+  files.push({ name: 'bom.xlsx', size: buf.length })
+  return target
+}
+
+/** Parse a likely-JSON result string; return the original when it isn't. */
+export function parseMaybeJson(value) {
+  if (typeof value !== 'string') return value
+  try { return JSON.parse(value) } catch { return value }
+}
+
+/** Filesystem-safe base name (keeps CJK; drops path/illegal chars). */
+export function sanitizeName(name) {
+  const cleaned = String(name ?? 'eda-snapshot')
+    .replace(/[\\/:*?"<>|\u0000-\u001f]/g, '_')
+    .replace(/\s+/g, '-')
+    .trim()
+  return cleaned.length > 0 && cleaned.length <= 64 ? cleaned : cleaned.slice(0, 64) || 'eda-snapshot'
+}
+
+/** The 紧急保存 pipeline. Never throws for per-step failures (returns errors[]). */
+export async function createSnapshot(deps) {
+  const {
+    execute, // (code, timeoutMs) => Promise<{ok, result, error}>
+    activities, // () => array (newest first) — agent action log
+    connected, // whether the official bridge is connected now
+    dir: dirOverride,
+    now = () => new Date(),
+    stepTimeoutMs = STEP_TIMEOUT_MS,
+  } = deps
+
+  const stamp = now().toISOString().replace(/[:.]/g, '-').slice(0, 19)
+  const outDir = join(dirOverride ?? defaultSnapshotDir(), `snapshot-${stamp}`)
+  const files = [] // { name, size }
+  const errors = [] // degraded step descriptions
+  const project = { info: null, doc: null, docFile: null, preview: null, netlist: null, bom: null }
+  const addError = (label, message) => { errors.push(`${label}: ${message}`) }
+
+  const execJson = async (label, code) => {
+    try {
+      const r = await execute(code, stepTimeoutMs)
+      if (r?.ok) return parseMaybeJson(r.result)
+      addError(label, (r?.error ?? 'execute failed').slice(0, 200))
+      return null
+    } catch (error) {
+      addError(label, error instanceof Error ? error.message : String(error))
+      return null
+    }
+  }
+
+  async function writeFile(name, content) {
+    if (typeof content !== 'string' || content === '') return null
+    if (content.length > MAX_PAYLOAD_BYTES) {
+      addError(`write ${name}`, `payload too large (${content.length} bytes)`)
+      return null
+    }
+    await fsp.mkdir(outDir, { recursive: true })
+    const target = join(outDir, name)
+    await fsp.writeFile(target, content, 'utf8')
+    files.push({ name, size: content.length })
+    return target
+  }
+
+  // 1) board state — only when the bridge is actually connected.
+  if (connected) {
+    project.info = await execJson('工程信息', PROJECT_INFO_CODE)
+    project.doc = await execJson('当前文档信息', DOC_INFO_CODE)
+
+    const projectName = sanitizeName(
+      project.info && typeof project.info === 'object' && (project.info.name ?? project.info.projectName)
+        ? (project.info.name ?? project.info.projectName)
+        : 'eda-snapshot',
+    )
+    const baseName = projectName.replace(/-$/, '')
+
+    // 1a) native doc file (epro2) — the full-fidelity restore for 专业版.
+    const docFile = await execJson('导出文档文件(epro2)', docFileCode(baseName))
+    if (docFile && typeof docFile === 'object' && typeof docFile.text === 'string' && docFile.text !== '') {
+      const ext = (typeof docFile.name === 'string' && docFile.name.includes('.')) ? docFile.name.split('.').pop() : 'epro2'
+      project.docFile = { name: `${baseName}.${ext}` }
+      await writeFile(`${baseName}.${ext}`, docFile.text)
+    } else if (docFile === null && errors.length > 0) {
+      // already recorded by execJson
+    } else {
+      addError('导出文档文件(epro2)', 'no document file returned (可能无打开文档/权限不足)')
+    }
+
+    // 1b) universal preview (SVG is text — saves cleanly, opens anywhere).
+    const preview = await execJson('导出预览SVG', previewSvgCode(baseName))
+    if (preview && typeof preview === 'object' && typeof preview.text === 'string' && preview.text !== '') {
+      project.preview = { name: `${baseName}-preview.svg` }
+      await writeFile(`${baseName}-preview.svg`, preview.text)
+    } else if (preview === null && errors.length > 0) {
+      // recorded
+    } else {
+      addError('导出预览SVG', 'no SVG returned (当前图页可能不是原理图)')
+    }
+
+    // 1c) data files for cross-checking (netlist/BOM are File objects — the
+    // snippets above read f.text(), so keep the raw string on disk).
+    const netlist = await execJson('导出网表', netlistCode())
+    if (typeof netlist === 'string' && netlist !== '') {
+      project.netlist = { name: 'netlist.json' }
+      await writeFile('netlist.json', netlist)
+    } else if (netlist != null && typeof netlist === 'object') {
+      project.netlist = { name: 'netlist.json' }
+      await writeFile('netlist.json', JSON.stringify(netlist, null, 2))
+    } else if (netlist == null) {
+      addError('导出网表', 'no netlist file returned')
+    }
+    const bom = await execJson('导出BOM', bomCode())
+    if (typeof bom === 'object' && bom !== null && typeof bom.b64 === 'string') {
+      project.bom = { name: 'bom.xlsx' }
+      await writeBom(outDir, files, addError, bom)
+    } else if (typeof bom === 'object' && bom !== null && Object.keys(bom).length > 0) {
+      // Non-binary BOM payload (some netlist-like providers) — keep as JSON.
+      project.bom = { name: 'bom.json' }
+      await writeFile('bom.json', JSON.stringify(bom, null, 2))
+    } else if (bom == null) {
+      addError('导出BOM', 'no bom file returned')
+    }
+  } else {
+    addError('画板现场', '官方桥未连接——仅保存 agent 动作日志（步骤留档）')
+  }
+
+  // 2) agent action log — always (server-side, no bridge needed).
+  let logEntries = []
+  try { logEntries = Array.isArray(activities()) ? activities() : [] } catch { /* keep empty */ }
+  await writeFile('log.json', JSON.stringify({ entries: logEntries.slice(0, 200) }, null, 2) + '\n')
+
+  // 3) meta + README (last two writes; meta.files covers the whole bundle).
+  const bridgeInfo = project.info ?? null
+  const allFileNames = [...files.map((f) => f.name), 'meta.json', 'README.txt']
+  const meta = {
+    kind: 'dsh-eda-snapshot',
+    createdAt: now().toISOString(),
+    project: project.info ?? null,
+    document: project.doc ?? null,
+    connected,
+    files: allFileNames,
+    errors,
+  }
+  await writeFile('meta.json', JSON.stringify(meta, null, 2) + '\n')
+
+  const readme = [
+    `# 紧急保存快照 — ${sanitizeName(bridgeInfo && typeof bridgeInfo === 'object' ? (bridgeInfo.name ?? '') : '') || 'EDA 快照'}`,
+    '',
+    `生成时间: ${meta.createdAt}  来源: dsh-lichuang-eda（官方桥 ${connected ? '已连接' : '未连接'}）`,
+    '',
+    '## 打开方法（pro 与普通都兼容）',
+    `1. **专业版**（嘉立创EDA专业版 / pro.lceda.cn）：文件 → 打开（或把文件拖入编辑器）选择 ${(project.docFile?.name ?? '.epro2 文件')} 即可完整恢复 agent 的全部改动。`,
+    `2. **普通/标准版**（EasyEDA 网页标准版）：无法直接打开 .epro2；请双击 ${(project.preview?.name ?? 'preview.svg')} 用浏览器查看（通用预览），或把网表/BOM 数据交给 AI 用离线生成器重建（仅支持简单电路）。`,
+    '',
+    '## 文件清单',
+    ...meta.files.map((f) => `- ${f}`),
+    '',
+    '## 说明',
+    '- .epro2 为专业版原生格式（官方 API 仅能导出 epro/epro2 与 PDF/PNG/SVG，无标准版 JSON 通道），因此"pro 完整恢复 + 通用预览 + 数据文件"是官方能力下的最佳组合。',
+    '- log.json 记录 agent 每次官方 API 调用（放元件/连线/DRC/网表…），画板断连也能保留步骤。',
+    ...(errors.length > 0 ? ['', '## 本次降级项', ...errors.map((e) => `- ${e}`)] : []),
+    '',
+  ].join('\n')
+  await writeFile('README.txt', readme)
+
+  return {
+    ok: true,
+    dir: outDir,
+    files,
+    errors,
+    connected,
+    project: project.info,
+    document: project.doc,
+    docFile: project.docFile?.name ?? null,
+    preview: project.preview?.name ?? null,
+  }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@windypro-rourou/dsh-eda",
+  "description": "嘉立创 EDA 助手（dsh-lichuang-eda）——面向 0 基础开发者，在 DSH Web GUI 里自动生成嘉立创 EDA（专业版/标准版）原理图/PCB 草图的插件。当前为可加载的骨架版本：DSH 插件表面（提供服务、HTTP 路由、agent 工具、系统提示通告、浏览器面板）已接通，EDA 后端尚未接入（backend: not-wired）。Hot-pluggable — mounted via profile cordis.patch.yml + profile node_modules copy, no dsh source changes.",
+  "version": "0.1.0",
+  "type": "module",
+  "packageManager": "pnpm@11.22.0",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib/**/*.js",
+    "src/**/*.js",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/WindyPro-rourou/JCL-EDA.git"
+  }
+}