@huaqiu/dsh-hqsch 0.4.8

package/skills/hqsch-scenario-b/template/scripts/read-circuit.ts

@@ -0,0 +1,357 @@
+/**
+ * 读电路模板 —— 理解已有设计的标准流程（只读，不修改任何东西）
+ *
+ * 用法：
+ *   npx tsx scripts/read-circuit.ts
+ *   REF=VR201 npx tsx scripts/read-circuit.ts
+ *   NET=+3.3V npx tsx scripts/read-circuit.ts
+ *   REF=VR201 TRACE=1 npx tsx scripts/read-circuit.ts
+ */
+import { connect } from "@huaqiu/huaqiu-client";
+
+const INSTANCE = process.env.HQ_INSTANCE_ID;
+const REF = process.env.REF;
+const NET = process.env.NET;
+const TRACE = process.env.TRACE === "1" || process.env.TRACE === "true";
+const TRACE_DEPTH = Math.max(1, Math.min(4, parseInt(process.env.TRACE_DEPTH ?? "2", 10) || 2));
+
+const bigintSafe = (_k: string, v: unknown) => (typeof v === "bigint" ? String(v) : v);
+const js = (v: unknown, n = 400) => {
+  const s = JSON.stringify(v, bigintSafe, 1) ?? "(undefined)";
+  return s.length > n ? s.slice(0, n) + " …" : s;
+};
+const pos = (v: unknown) => {
+  const o = v as { x?: unknown; y?: unknown } | undefined;
+  return o && o.x !== undefined ? `(${o.x},${o.y})` : js(v, 60);
+};
+function propVal(v: unknown): string {
+  if (v === null || v === undefined) return "";
+  if (typeof v === "object") {
+    const o = v as Record<string, unknown>;
+    return "value" in o ? propVal(o.value) : js(v, 120);
+  }
+  return String(v);
+}
+const isRailName = (n: string) =>
+  /^[+-]?\d+(\.\d+)?V$/i.test(n) || /^V(CC|DD|EE|BAT|IN|OUT)?[A-Z0-9_]*$/i.test(n) || /^\+/.test(n);
+
+type Sym = Record<string, unknown>;
+type Pin = Record<string, unknown>;
+type Net = { name?: string; netClass?: number; pinInstanceIds?: string[] };
+type Def = { name?: string; pins?: Array<{ number?: string; name?: string; electricalType?: number }> };
+type PinRow = { num: string; name: string; net: string; pos: unknown };
+
+const NET_CLASS: Record<number, string> = { 0: "UNSPECIFIED", 1: "SIGNAL", 2: "POWER", 3: "GROUND", 4: "BUS" };
+
+function metaId(obj: Record<string, unknown> | undefined): string {
+  return String((obj?.metadata as Record<string, unknown> | undefined)?.id ?? "");
+}
+function symMetaId(sym: Sym): string {
+  return metaId(sym as Record<string, unknown>) || String(sym.canvasObjectId ?? "");
+}
+function pinMetaId(pin: Pin): string {
+  return metaId(pin as Record<string, unknown>);
+}
+function refPrefix(ref: string): string {
+  const m = /^([A-Za-z_]+)/.exec(ref);
+  return m?.[1] ?? ref;
+}
+function isPassiveBridgePrefix(ref: string): boolean {
+  return /^(C|R|L|FB|FL|BEAD)$/i.test(refPrefix(ref));
+}
+function isActivePrefix(ref: string): boolean {
+  const p = refPrefix(ref).toUpperCase();
+  return /^(U|VR|Q|IC|D|J|X|Y|K|SW|S|T|M)/.test(p) && !isPassiveBridgePrefix(ref);
+}
+function isPowerRailNet(name: string, netClass?: number): boolean {
+  if ((netClass ?? 0) >= 2) return true;
+  return /^(GND|VCC|VDD|VEE|VSS|\+|\-)/i.test(name) || isRailName(name);
+}
+function neighborRoleHint(ref: string): string {
+  const p = refPrefix(ref).toUpperCase();
+  if (/^C/.test(p)) return "旁路/滤波电容";
+  if (/^R/.test(p)) return "电阻(上拉/下拉/分压)";
+  if (/^(L|FB|FL|BEAD)/.test(p)) return "电感/磁珠";
+  if (/^(U|VR|IC)/.test(p)) return "有源器件";
+  if (/^(D|Q)/.test(p)) return "二极管/晶体管";
+  if (/^(VCC|VDD|GND)/.test(ref)) return "电源轨符号";
+  return "无源/其它";
+}
+function symValue(sym: Sym | undefined): string {
+  if (!sym) return "";
+  const props = ((sym.metadata as Record<string, unknown> | undefined)?.properties as Array<{ key: string; value: unknown }>) ?? [];
+  const v = props.find((p) => p.key === "Value");
+  return v ? propVal(v.value).slice(0, 40) : "";
+}
+
+class SnapCtx {
+  readonly syms: Sym[];
+  readonly pins: Pin[];
+  readonly nets: Net[];
+  readonly defs: Def[];
+  readonly netOf = new Map<string, string>();
+  readonly pinById = new Map<string, Pin>();
+  readonly symByMetaId = new Map<string, Sym>();
+  readonly symByDesignator = new Map<string, Sym>();
+  readonly defByName = new Map<string, Def>();
+  readonly netByName = new Map<string, Net>();
+
+  constructor(raw: Record<string, unknown[]>) {
+    this.syms = (raw.symbolInstances ?? []) as Sym[];
+    this.pins = (raw.pinInstances ?? []) as Pin[];
+    this.nets = (raw.nets ?? []) as unknown as Net[];
+    this.defs = (raw.symbolDefinitions ?? []) as unknown as Def[];
+    for (const net of this.nets) {
+      if (net.name) this.netByName.set(net.name, net);
+      for (const pid of net.pinInstanceIds ?? []) this.netOf.set(pid, net.name ?? "?");
+    }
+    for (const p of this.pins) this.pinById.set(pinMetaId(p), p);
+    for (const s of this.syms) {
+      if (s.designator) this.symByDesignator.set(String(s.designator), s);
+      this.symByMetaId.set(symMetaId(s), s);
+    }
+    for (const d of this.defs) if (d.name) this.defByName.set(d.name, d);
+  }
+
+  pinNameTable(definitionId: unknown): Map<string, string> {
+    const d = this.defByName.get(String(definitionId));
+    const m = new Map<string, string>();
+    for (const p of d?.pins ?? []) m.set(String(p.number), String(p.name));
+    return m;
+  }
+  pinsOfRef(ref: string): Pin[] {
+    const sym = this.symByDesignator.get(ref);
+    if (!sym) return [];
+    return this.pins.filter((p) => String(p.symbolInstanceId) === symMetaId(sym));
+  }
+  pinRows(ref: string): PinRow[] {
+    const sym = this.symByDesignator.get(ref);
+    if (!sym) return [];
+    const pn = this.pinNameTable(sym.definitionId);
+    return this.pinsOfRef(ref)
+      .map((p) => ({
+        num: String(p.pinDefinitionId),
+        name: pn.get(String(p.pinDefinitionId)) ?? "?",
+        net: this.netOf.get(pinMetaId(p)) ?? "(未连接)",
+        pos: p.position,
+      }))
+      .sort((a, b) => Number(a.num) - Number(b.num));
+  }
+  netMembers(netName: string, excludeRef?: string): Array<{ ref: string; pinLabel: string }> {
+    const net = this.netByName.get(netName);
+    if (!net) return [];
+    const out: Array<{ ref: string; pinLabel: string }> = [];
+    for (const pid of net.pinInstanceIds ?? []) {
+      const p = this.pinById.get(pid);
+      if (!p) continue;
+      const sym = this.symByMetaId.get(String(p.symbolInstanceId));
+      const ref = String(sym?.designator ?? "?");
+      if (excludeRef && ref === excludeRef) continue;
+      const pn = this.pinNameTable(sym?.definitionId);
+      const num = String(p.pinDefinitionId);
+      out.push({ ref, pinLabel: `${num}(${pn.get(num) ?? "?"})` });
+    }
+    return out;
+  }
+  prefixStats(members: Array<{ ref: string }>): string {
+    const cnt = new Map<string, number>();
+    const refs = new Set<string>();
+    for (const m of members) {
+      if (refs.has(m.ref)) continue;
+      refs.add(m.ref);
+      cnt.set(refPrefix(m.ref), (cnt.get(refPrefix(m.ref)) ?? 0) + 1);
+    }
+    return [...cnt.entries()].sort((a, b) => b[1] - a[1]).map(([k, v]) => `${k}×${v}`).join(", ");
+  }
+}
+
+type SeriesBridge = { ref: string; value: string; netA: string; netB: string };
+
+function buildSeriesBridgeGraph(ctx: SnapCtx): SeriesBridge[] {
+  const bridges: SeriesBridge[] = [];
+  const seen = new Set<string>();
+  for (const sym of ctx.syms) {
+    const ref = String(sym.designator ?? "");
+    if (!ref || !isPassiveBridgePrefix(ref)) continue;
+    const myPins = ctx.pinsOfRef(ref).filter((p) => ctx.netOf.get(pinMetaId(p)));
+    if (myPins.length !== 2) continue;
+    const nets = [...new Set(myPins.map((p) => ctx.netOf.get(pinMetaId(p))!))];
+    if (nets.length !== 2) continue;
+    const [netA, netB] = nets;
+    if (refPrefix(ref).toUpperCase() === "C") {
+      const aRail = isPowerRailNet(netA, ctx.netByName.get(netA)?.netClass);
+      const bRail = isPowerRailNet(netB, ctx.netByName.get(netB)?.netClass);
+      if (aRail !== bRail) continue;
+    }
+    const key = [ref, ...nets.sort()].join("|");
+    if (seen.has(key)) continue;
+    seen.add(key);
+    bridges.push({ ref, value: symValue(sym), netA, netB });
+  }
+  return bridges;
+}
+function bridgesFromNet(bridges: SeriesBridge[], netName: string): SeriesBridge[] {
+  return bridges.filter((b) => b.netA === netName || b.netB === netName);
+}
+function otherNet(bridge: SeriesBridge, netName: string): string {
+  return bridge.netA === netName ? bridge.netB : bridge.netA;
+}
+
+function expandNeighborhood(ctx: SnapCtx, ref: string, rows: PinRow[]): void {
+  console.log(`\n  ── 邻域展开（同网 1 跳）──`);
+  for (const r of rows) {
+    if (r.net === "(未连接)") {
+      console.log(`    pin${r.num} ${r.name.padEnd(10)} → (未连接)`);
+      continue;
+    }
+    const allMembers = ctx.netMembers(r.net);
+    const neighbors = ctx.netMembers(r.net, ref);
+    const net = ctx.netByName.get(r.net);
+    const nc = NET_CLASS[net?.netClass ?? -1] ?? String(net?.netClass ?? "?");
+    console.log(`    pin${r.num} ${String(r.name).padEnd(10)} → ${String(r.net).padEnd(16)} [${nc}]`);
+    if (allMembers.length <= 8) {
+      const list = neighbors.map((m) => `${m.ref}(${m.pinLabel})`).join(", ");
+      console.log(`      同网邻居: ${list || "(仅本器件)"}  [${new Set(allMembers.map((m) => m.ref)).size} 器件 / ${neighbors.length} 脚]`);
+    } else {
+      console.log(`      同网邻居: (大网摘要) ${new Set(allMembers.map((m) => m.ref)).size} 器件 / ${allMembers.length} 脚 | ${ctx.prefixStats(neighbors)}`);
+      console.log(`      代表: ${neighbors.slice(0, 5).map((m) => `${m.ref}(${m.pinLabel})`).join(", ")}${neighbors.length > 5 ? " …" : ""}`);
+    }
+    const roles = [...new Set(neighbors.slice(0, 6).map((m) => neighborRoleHint(m.ref)))];
+    if (roles.length) console.log(`      角色推断: ${roles.join("；")}`);
+    for (const m of neighbors.slice(0, 4)) {
+      const val = symValue(ctx.symByDesignator.get(m.ref));
+      if (val) console.log(`        ${m.ref} Value=${val}`);
+    }
+  }
+}
+
+function traceThroughPassives(ctx: SnapCtx, ref: string, rows: PinRow[], bridges: SeriesBridge[], maxDepth: number): void {
+  console.log(`\n  ── 串联穿透（C/R/L/FB，max ${maxDepth} 跳）──`);
+  let found = 0;
+  for (const r of rows) {
+    if (r.net === "(未连接)") continue;
+    type QItem = { net: string; path: string[]; depth: number };
+    const queue: QItem[] = [{ net: r.net, path: [r.net], depth: 0 }];
+    const visited = new Set<string>();
+    while (queue.length) {
+      const { net, path, depth } = queue.shift()!;
+      if (depth >= maxDepth) continue;
+      for (const br of bridgesFromNet(bridges, net)) {
+        const next = otherNet(br, net);
+        if (path.includes(next)) continue;
+        if (isPowerRailNet(next, ctx.netByName.get(next)?.netClass) && depth > 0) continue;
+        const label = br.value ? `${br.ref} ${br.value}` : br.ref;
+        console.log(`    pin${r.num} ${r.name}: ${path.join(" → ")} —[${label}]— ${next}`);
+        const active = ctx.netMembers(next, ref).filter((m) => isActivePrefix(m.ref));
+        if (active.length) console.log(`      对侧有源: ${active.slice(0, 5).map((m) => `${m.ref}(${m.pinLabel})`).join(", ")}`);
+        else {
+          const passive = ctx.netMembers(next, ref).slice(0, 4).map((m) => `${m.ref}(${m.pinLabel})`).join(", ");
+          if (passive) console.log(`      对侧: ${passive}`);
+        }
+        found++;
+        const vkey = `${next}|${depth + 1}`;
+        if (!visited.has(vkey)) {
+          visited.add(vkey);
+          queue.push({ net: next, path: [...path, next], depth: depth + 1 });
+        }
+      }
+    }
+  }
+  if (!found) console.log(`    (未发现可穿透的串联 C/R/L/FB 链路)`);
+}
+
+function printRoleSummary(ref: string, sym: Sym, rows: PinRow[], props: Array<{ key: string; value: unknown }>): void {
+  console.log(`\n  ── 作用回答要点（供 agent 组织自然语言）──`);
+  const desc = props.find((p) => p.key === "Description");
+  const mpn = props.find((p) => p.key === "MPN");
+  if (desc) console.log(`    身份: ${propVal(desc.value).slice(0, 120)}`);
+  else console.log(`    身份: ${String(sym.definitionId)}（无 Description，勿编造 datasheet）`);
+  if (mpn) console.log(`    MPN: ${propVal(mpn.value)}`);
+  console.log(`    连接: ${rows.map((r) => `${r.name}→${r.net}`).join("; ")}`);
+  console.log(`    总结: 结合邻域${TRACE ? "/穿透" : ""}块描述 ${ref} 在局部子电路中的功能`);
+}
+
+async function resolveCanvasIds(
+  client: Awaited<ReturnType<typeof connect>>,
+  ctx: ReturnType<Awaited<ReturnType<typeof connect>>["createProjectContext"]>,
+  ref: string,
+  sym: Sym,
+): Promise<void> {
+  console.log(`\n  ── canvas 编辑 id（读懂 → 改电路桥接）──`);
+  console.log(`    snapshot metadata.id:  ${symMetaId(sym)}`);
+  console.log(`    canvasObjectId:       ${sym.canvasObjectId ?? "(空)"}`);
+  try {
+    const found = await client.canvasOps.findObjectByProperty({ context: ctx, propKey: "Reference", propValue: ref });
+    console.log(`    FindObject(Reference): ${found.objectIds?.[0] ?? "(未找到)"}`);
+  } catch {
+    console.log(`    FindObject(Reference): (调用失败)`);
+  }
+}
+
+async function main() {
+  const client = INSTANCE ? await connect({ instanceId: INSTANCE }) : await connect();
+  const active = await client.project.getActiveProject({ context: client.createEditorContext() });
+  const projectId = active.project?.projectId;
+  if (!projectId) throw new Error("请先打开原理图工程");
+  const pctx = client.createProjectContext(projectId);
+  console.log(`工程 projectId: ${projectId}\n`);
+
+  const t = Date.now();
+  const snap = await client.kernel.getSnapshot({ context: pctx });
+  const ctx = new SnapCtx(snap.snapshot as unknown as Record<string, unknown[]>);
+  console.log(`[快照] ${Date.now() - t}ms — ${ctx.syms.length} 器件 / ${ctx.pins.length} 引脚 / ${ctx.nets.length} 网络\n`);
+
+  if (!REF && !NET) {
+    console.log("=== 网络分类（netClass）===");
+    const byClass = new Map<number, number>();
+    for (const n of ctx.nets) byClass.set(n.netClass ?? -1, (byClass.get(n.netClass ?? -1) ?? 0) + 1);
+    for (const [k, v] of [...byClass.entries()].sort()) console.log(`  ${(NET_CLASS[k] ?? k).padEnd(12)} ${v}`);
+    const bridges = buildSeriesBridgeGraph(ctx);
+    console.log(`\n=== 可穿透串联无源件: ${bridges.length} 个 ===`);
+    for (const b of bridges.slice(0, 8)) console.log(`  ${b.ref}  ${b.netA} ↔ ${b.netB}`);
+    console.log(`\n提示：REF= / NET= ；串联穿透 TRACE=1`);
+    return;
+  }
+
+  if (REF) {
+    const sym = ctx.symByDesignator.get(REF);
+    if (!sym) {
+      const cands = ctx.syms.filter((x) => String(x.designator ?? "").includes(REF));
+      console.log(`未找到位号 ${REF}`);
+      if (cands.length) console.log(`  相近: ${cands.slice(0, 8).map((x) => x.designator).join(", ")}`);
+      return;
+    }
+    console.log(`=== ${REF} ===`);
+    console.log(`  definitionId: ${sym.definitionId}  position: ${pos(sym.position)}`);
+    const props = ((sym.metadata as Record<string, unknown> | undefined)?.properties as Array<{ key: string; value: unknown }>) ?? [];
+    if (props.filter((p) => p.key !== "pins").length) {
+      console.log(`\n  ── 器件参数 ──`);
+      for (const p of props.filter((x) => x.key !== "pins")) console.log(`    ${p.key} = ${propVal(p.value).slice(0, 100)}`);
+    } else console.log(`\n  ── 器件参数 ── (空) 禁止编造 datasheet`);
+    const rows = ctx.pinRows(REF);
+    console.log(`\n  ── 引脚 → 网络 ──`);
+    for (const r of rows) console.log(`    pin${r.num} ${String(r.name).padEnd(10)} → ${r.net}`);
+    expandNeighborhood(ctx, REF, rows);
+    const bridges = buildSeriesBridgeGraph(ctx);
+    if (TRACE) traceThroughPassives(ctx, REF, rows, bridges, TRACE_DEPTH);
+    else console.log(`\n  (设 TRACE=1 开启串联穿透)`);
+    printRoleSummary(REF, sym, rows, props);
+    await resolveCanvasIds(client, pctx, REF, sym);
+  }
+
+  if (NET) {
+    const net = ctx.netByName.get(NET);
+    if (!net) { console.log(`未找到网络 ${NET}`); return; }
+    console.log(`\n=== 网络 "${NET}" === netClass=${net.netClass} 成员=${net.pinInstanceIds?.length ?? 0} 脚`);
+    const byRef = new Map<string, string[]>();
+    for (const m of ctx.netMembers(NET)) {
+      if (!byRef.has(m.ref)) byRef.set(m.ref, []);
+      byRef.get(m.ref)!.push(m.pinLabel);
+    }
+    for (const [ref, list] of [...byRef.entries()].sort()) console.log(`    ${ref}: ${list.join(", ")} (${neighborRoleHint(ref)})`);
+    for (const b of bridgesFromNet(buildSeriesBridgeGraph(ctx), NET))
+      console.log(`    串联: ${b.ref} → 对侧 ${otherNet(b, NET)}`);
+  }
+}
+
+main().catch((e) => { console.error("❌", e.message); process.exit(1); });

package/skills/hqsch-scenario-b/template/scripts/replace-part-by-ref.ts

@@ -0,0 +1,44 @@
+/**
+ * Flow C 配方：删旧放新（骨架 — 需补 part-search 与 pin 重连列表）
+ * OLD_REF=U3 CONFIRM=1 npx tsx scripts/replace-part-by-ref.ts
+ *
+ * 完整替换需：searchParts → placeKicadSymbol → 按 OLD 的 pin→net 逐脚 autoConnect
+ */
+import { connect } from "@huaqiu/huaqiu-client";
+
+const OLD_REF = process.env.OLD_REF;
+const CONFIRM = process.env.CONFIRM === "1";
+const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
+
+async function main() {
+  if (!OLD_REF) throw new Error("需要 OLD_REF=");
+  const client = await connect({ instanceId: process.env.HQ_INSTANCE_ID });
+  const active = await client.project.getActiveProject({ context: client.createEditorContext() });
+  const projectId = active.project?.projectId;
+  if (!projectId) throw new Error("请先打开工程");
+  const ctx = client.createProjectContext(projectId);
+  console.log("projectId:", projectId);
+
+  const snap = await client.kernel.getSnapshot({ context: ctx });
+  const s = snap.snapshot as Record<string, unknown[]>;
+  const sym = (s.symbolInstances as Array<Record<string, unknown>>)?.find((x) => x.designator === OLD_REF);
+  if (!sym) throw new Error(`快照无 ${OLD_REF}`);
+
+  console.log(`\n计划: 删除 ${OLD_REF} @ ${JSON.stringify(sym.position)} rotation=${sym.rotation}`);
+  console.log("  ⚠ 替换需指定 NEW_MPN + placeKicadSymbol + 重连 — 本脚本仅演示定位与删除前检查");
+  if (!CONFIRM) { console.log("未执行。设 CONFIRM=1 且补全新器件放置逻辑。"); return; }
+
+  const found = await client.canvasOps.findObjectByProperty({ context: ctx, propKey: "Reference", propValue: OLD_REF });
+  const id = found.objectIds?.[0];
+  if (!id) throw new Error("FindObject 失败");
+  await client.canvasOps.deleteObjectsByIds({ context: ctx, objectIds: [id] });
+  for (let i = 0; i < 10; i++) {
+    await sleep(300);
+    const occ = await client.canvasOps.getPageOccupancy({ context: ctx });
+    const ids = (occ.objectIds ?? []).map(String);
+    if (!ids.includes(String(id))) break;
+  }
+  console.log(`✓ 已删除 ${OLD_REF} — 请 placeKicadSymbol 并 autoConnect 各 pin`);
+}
+
+main().catch((e) => { console.error("❌", e.message); process.exit(1); });

package/skills/hqsch-scenario-b/template/scripts/rewire-pin-by-ref.ts

@@ -0,0 +1,42 @@
+/**
+ * Flow C 配方：把 REF 的某 pin 接到 TARGET_REF 的 TARGET_PIN（autoConnect）
+ * REF=R201 PIN=1 TARGET_REF=U301 TARGET_PIN=14 CONFIRM=1 npx tsx scripts/rewire-pin-by-ref.ts
+ */
+import { connect } from "@huaqiu/huaqiu-client";
+
+const REF = process.env.REF;
+const PIN = process.env.PIN;
+const TARGET_REF = process.env.TARGET_REF;
+const TARGET_PIN = process.env.TARGET_PIN ?? "1";
+const CONFIRM = process.env.CONFIRM === "1";
+
+async function main() {
+  if (!REF || !PIN || !TARGET_REF) throw new Error("需要 REF= PIN= TARGET_REF=");
+  const client = await connect({ instanceId: process.env.HQ_INSTANCE_ID });
+  const active = await client.project.getActiveProject({ context: client.createEditorContext() });
+  const projectId = active.project?.projectId;
+  if (!projectId) throw new Error("请先打开工程");
+  const ctx = client.createProjectContext(projectId);
+  console.log("projectId:", projectId);
+
+  const a = await client.canvasOps.findObjectByProperty({ context: ctx, propKey: "Reference", propValue: REF });
+  const b = await client.canvasOps.findObjectByProperty({ context: ctx, propKey: "Reference", propValue: TARGET_REF });
+  const id1 = a.objectIds?.[0];
+  const id2 = b.objectIds?.[0];
+  if (!id1 || !id2) throw new Error("找不到 objectId");
+
+  console.log(`\n计划: ${REF}.pin${PIN} autoConnect → ${TARGET_REF}.pin${TARGET_PIN}`);
+  console.log(`  id1=${id1}  id2=${id2}`);
+  if (!CONFIRM) { console.log("未执行。设 CONFIRM=1"); return; }
+
+  await client.canvasOps.autoConnectObjectsById({
+    context: ctx,
+    objectId1: id1,
+    pinNum1: [Number(PIN)],
+    objectId2: id2,
+    pinNum2: [Number(TARGET_PIN)],
+  });
+  console.log("✓ autoConnect 完成 — 请 GetSnapshot 验收 pin→net");
+}
+
+main().catch((e) => { console.error("❌", e.message); process.exit(1); });

package/skills/hqsch-scenario-b/template/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["scripts/**/*.ts"]
+}

package/src/config.ts

@@ -0,0 +1,25 @@
+/**
+ * Configuration for `@huaqiu/dsh-hqsch`.
+ *
+ * This plugin only bundles and registers the HQSCH scenario-b skill. The skill
+ * itself guides the agent to generate and run local TypeScript scripts against
+ * HQ EDA, so there is no host connection configured here.
+ *
+ * @module
+ */
+
+/** Canonical skill directory name shipped by this package. */
+export const HQSCH_SKILL_NAME = 'hqsch-scenario-b'
+
+/** Configuration accepted by the plugin's `apply()`. */
+export interface HqschConfig {
+  /** Bundled skill directory override (defaults to this package's skills/). */
+  skillsDir?: string
+}
+
+export type HqschConfigInput = Partial<HqschConfig>
+
+/** Whether any host configuration was supplied (used for startup logging). */
+export function hasHostConfig(input: HqschConfigInput = {}): boolean {
+  return Boolean(input.skillsDir ?? process.env['DSH_HQSCH_SKILLS_DIR'])
+}

package/src/index.ts

@@ -0,0 +1,186 @@
+/**
+ * `@huaqiu/dsh-hqsch` - node plugin entry.
+ *
+ * This plugin ships the HQSCH scenario-b skill as a DSH bundled skill. It does
+ * not register DSH tools: scenario-b's execution model is for the coding agent
+ * to generate TypeScript scripts under the bundled template and run them
+ * locally against HQ EDA.
+ *
+ * @module @huaqiu/dsh-hqsch
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import { getLogger } from '@huaqiu/dsh-plugin-log'
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+import {
+  hasHostConfig,
+  HQSCH_SKILL_NAME,
+  type HqschConfig,
+  type HqschConfigInput,
+} from './config.js'
+import { requireSkillDir, resolveSkillDir } from './paths.js'
+
+/** Plugin id - matches package.json. */
+export const name = '@huaqiu/dsh-hqsch'
+
+/**
+ * `skills` is REQUIRED: it is the DSH runtime's plugin-bundled skill registry.
+ */
+export const inject = ['skills'] as const
+
+export type { HqschConfig, HqschConfigInput } from './config.js'
+export { HQSCH_SKILL_NAME } from './config.js'
+export { requireSkillDir, resolveSkillDir } from './paths.js'
+
+/** The `skills` service shape consumed by this plugin. */
+export interface SkillRegistration {
+  /** Skill id - must match DSH's discoverable skill id format. */
+  name: string
+  /** Catalog description shown to the model. */
+  description: string
+  /** Full SKILL.md body. */
+  content: string
+  /** Discovery source for plugin-bundled skills. */
+  source: 'runtime'
+  /** Where docs/ and template/ live for progressive disclosure. */
+  resourceBase: { kind: 'directory'; path: string }
+}
+
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    /** DSH skill registry, provided by the runtime skill service. */
+    skills: {
+      /** Register a plugin-bundled skill; returns its unregister disposer. */
+      register(skill: SkillRegistration): () => void
+    }
+  }
+}
+
+const COMPONENT = 'dsh-hqsch'
+const log = getLogger(COMPONENT)
+
+log.info('dsh-hqsch: module loaded (waiting for the skills service)')
+
+const FALLBACK_SKILL_DESCRIPTION =
+  'HQSCH scenario-b automation skill for HQ EDA schematic drawing, reading and ' +
+  'local surgical edits through generated TypeScript scripts.'
+
+/**
+ * Extract the `description` field from SKILL.md YAML frontmatter.
+ *
+ * Supports both single-line values and the folded block form used by
+ * hqeda-scenario-b (`description: >-` followed by indented lines).
+ */
+export function skillDescription(markdown: string): string | undefined {
+  const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---/.exec(markdown)
+  if (!frontmatter?.[1]) return undefined
+
+  const lines = frontmatter[1].split(/\r?\n/)
+  const lineIndex = lines.findIndex((candidate) => /^\s*description\s*:/.test(candidate))
+  if (lineIndex < 0) return undefined
+
+  const raw = lines[lineIndex]!.slice(lines[lineIndex]!.indexOf(':') + 1).trim()
+  if (raw === '>-' || raw === '>' || raw === '|-' || raw === '|') {
+    const block: string[] = []
+    for (const line of lines.slice(lineIndex + 1)) {
+      if (/^\s+\S/.test(line)) {
+        block.push(line.trim())
+        continue
+      }
+      if (line.trim().length === 0) continue
+      break
+    }
+    const text = block.join(' ').trim()
+    return text.length > 0 ? text : undefined
+  }
+
+  const unquoted = raw.replace(/^["']/, '').replace(/["']$/, '')
+  return unquoted.length > 0 ? unquoted : undefined
+}
+
+/** Read the bundled HQSCH scenario-b SKILL.md. */
+export function readBundledSkill(moduleUrl: string, override?: string): {
+  dir: string
+  name: string
+  description: string
+  content: string
+} {
+  const dir = requireSkillDir(moduleUrl, override)
+  const content = readFileSync(join(dir, 'SKILL.md'), 'utf8')
+  return {
+    dir,
+    name: HQSCH_SKILL_NAME,
+    description: skillDescription(content) ?? FALLBACK_SKILL_DESCRIPTION,
+    content,
+  }
+}
+
+/**
+ * Read the bundled skill, or `null` when the installed package does not carry
+ * one. A missing skill is a packaging failure, but it should degrade this
+ * plugin instead of killing the whole DSH process.
+ */
+export function tryReadBundledSkill(
+  moduleUrl: string,
+  override?: string,
+): { dir: string; name: string; description: string; content: string } | null {
+  try {
+    return readBundledSkill(moduleUrl, override)
+  } catch (err) {
+    log.error(
+      'dsh-hqsch: bundled skill unavailable - continuing degraded without skill registration',
+      {
+        expectedDir: resolveSkillDir(moduleUrl, override),
+        error: String((err as Error)?.message ?? err),
+      },
+    )
+    return null
+  }
+}
+
+/**
+ * Host plugin body - register the bundled HQSCH scenario-b skill.
+ */
+export function apply(ctx: Context, config: HqschConfigInput = {}): () => void {
+  if (!ctx.skills || typeof ctx.skills.register !== 'function') {
+    throw new Error('@huaqiu/dsh-hqsch requires the DSH `skills` service (ctx.skills.register).')
+  }
+
+  const skill = tryReadBundledSkill(import.meta.url, config.skillsDir)
+
+  log.info('applying dsh-hqsch node half', {
+    hasConfigHost: hasHostConfig(config),
+    skillDir: skill?.dir ?? resolveSkillDir(import.meta.url, config.skillsDir),
+    skillPresent: skill !== null,
+  })
+
+  const disposers: Array<() => void> = []
+
+  if (skill) {
+    disposers.push(
+      ctx.skills.register({
+        name: skill.name,
+        description: skill.description,
+        content: skill.content,
+        source: 'runtime',
+        resourceBase: { kind: 'directory', path: skill.dir },
+      }),
+    )
+  }
+
+  log.info('dsh-hqsch node half ready', {
+    skill: skill?.name ?? null,
+    degraded: skill === null,
+  })
+
+  return () => {
+    for (const dispose of disposers.reverse()) {
+      try {
+        dispose()
+      } catch (err) {
+        log.warn('dsh-hqsch disposer failed', { error: String((err as Error)?.message ?? err) })
+      }
+    }
+  }
+}