oltc-selector 1.0.0 → 1.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 填工况，给出 2025 目录里**最低满足**的型号。网页和 `oltc` CLI 共用同一份 `selectOltc` 引擎。
 
-**CLI（无报价）：** `npm i -g oltc-selector`，命令是 `oltc`。  
+**CLI（无报价）：** `npm i -g oltc-selector`，命令是 `oltc`。Agent 技能包：`skills/huaming-oltc-selector/`（站点 `/agents/` 可下载 zip）。  
 **网页：** [oltc-selector.vercel.app](https://oltc-selector.vercel.app/) · [GitHub Pages](https://erict16.github.io/oltc-selector/)
 
 私人辅助，不是厂家官网。型号是起点，出 OS 前要工程确认。

package/bin/oltc.js

@@ -1757,7 +1757,8 @@ function parseCliArgs(argv) {
     phases: "III",
     json: false,
     help: false,
-    pm: 8
+    pm: 8,
+    given: /* @__PURE__ */ new Set()
   };
   const take = (i, flag) => {
     const v = argv[i + 1];
@@ -1777,62 +1778,73 @@ function parseCliArgs(argv) {
       continue;
     }
     if (a === "--octc") {
+      out.given.add("octc");
       out.octc = true;
       continue;
     }
     if (a === "--oil") {
+      out.given.add("medium");
       out.oil = true;
       out.vacuum = false;
       continue;
     }
     if (a === "--vacuum") {
+      out.given.add("medium");
       out.vacuum = true;
       out.oil = false;
       continue;
     }
     if (a === "--iu" || a === "--imax") {
+      out.given.add("iu");
       const [v, n] = take(i, a);
       out.iu = num(v, a);
       i = n;
       continue;
     }
     if (a === "--mva") {
+      out.given.add("mva");
       const [v, n] = take(i, a);
       out.mva = num(v, a);
       i = n;
       continue;
     }
     if (a === "--kv") {
+      out.given.add("kv");
       const [v, n] = take(i, a);
       out.kv = num(v, a);
       i = n;
       continue;
     }
     if (a === "--um") {
+      out.given.add("um");
       const [v, n] = take(i, a);
       out.um = num(v, a);
       i = n;
       continue;
     }
     if (a === "--ust") {
+      out.given.add("ust");
       const [v, n] = take(i, a);
       out.ust = num(v, a);
       i = n;
       continue;
     }
     if (a === "--step-pct") {
+      out.given.add("stepPct");
       const [v, n] = take(i, a);
       out.stepPct = num(v, a);
       i = n;
       continue;
     }
     if (a === "--k") {
+      out.given.add("k");
       const [v, n] = take(i, a);
       out.k = num(v, a);
       i = n;
       continue;
     }
     if (a === "--conn" || a === "--connection") {
+      out.given.add("conn");
       const [v, n] = take(i, a);
       const c = v.toUpperCase();
       if (c !== "Y" && c !== "D") throw new CliError(`--conn must be Y or D`);
@@ -1841,6 +1853,7 @@ function parseCliArgs(argv) {
       continue;
     }
     if (a === "--reg") {
+      out.given.add("reg");
       const [v, n] = take(i, a);
       const r = v.toUpperCase();
       if (r === "W" || r === "REVERSING") out.reg = "reversing";
@@ -1852,18 +1865,21 @@ function parseCliArgs(argv) {
       continue;
     }
     if (a === "--pm") {
+      out.given.add("pm");
       const [v, n] = take(i, a);
       out.pm = num(v, a);
       i = n;
       continue;
     }
     if (a === "--positions" || a === "--pos") {
+      out.given.add("positions");
       const [v, n] = take(i, a);
       out.positions = num(v, a);
       i = n;
       continue;
     }
     if (a === "--structure") {
+      out.given.add("structure");
       const [v, n] = take(i, a);
       const s = v.toLowerCase();
       const map = {
@@ -1887,6 +1903,7 @@ function parseCliArgs(argv) {
       continue;
     }
     if (a === "--series") {
+      out.given.add("series");
       const [v, n] = take(i, a);
       const r = v.toUpperCase();
       const ok = ["II", "IV", "V", "VI", "VII", "VIII", "AUTO"];
@@ -1898,6 +1915,7 @@ function parseCliArgs(argv) {
       continue;
     }
     if (a === "--mount") {
+      out.given.add("mount");
       const [v, n] = take(i, a);
       const m = v.toLowerCase().replace("_", "-");
       if (m === "in-tank" || m === "intank") out.mount = "in_tank";
@@ -1908,12 +1926,14 @@ function parseCliArgs(argv) {
       continue;
     }
     if (a === "--contact") {
+      out.given.add("contact");
       const [v, n] = take(i, a);
       out.contact = v;
       i = n;
       continue;
     }
     if (a === "--phases") {
+      out.given.add("phases");
       const [v, n] = take(i, a);
       const p = v.toUpperCase();
       if (p !== "I" && p !== "II" && p !== "III") {
@@ -1924,6 +1944,7 @@ function parseCliArgs(argv) {
       continue;
     }
     if (a === "--duty") {
+      out.given.add("octc");
       const [v, n] = take(i, a);
       const d = v.toLowerCase();
       if (d === "octc" || d === "off" || d === "detc") out.octc = true;
@@ -2035,7 +2056,48 @@ function cliToSelectInput(args) {
   }
   return input;
 }
-function formatCliText(input) {
+var MOUNT_ZH = {
+  in_tank: "\u7BB1\u5185",
+  on_tank: "\u7BB1\u9876",
+  dry_type: "\u5E72\u5F0F"
+};
+function assumptionsFromArgs(args) {
+  const mark = (key) => args.given.has(key) ? "" : "\uFF08\u9ED8\u8BA4\uFF09";
+  const items = [
+    `conn=${args.conn} ${args.conn === "Y" ? "\u661F\u70B9" : "\u7EBF\u7AEF"}${mark("conn")}`
+  ];
+  if (args.octc) {
+    const pos = args.positions ?? (args.pm != null && args.pm > 0 ? Math.round(2 * args.pm + 1) : null);
+    items.push(pos != null ? `${pos} \u6863${mark("positions")}` : "\u6863\u6570\u672A\u6307\u5B9A");
+    const s = args.series ?? "auto";
+    items.push(
+      s === "auto" ? `\u63A5\u7EBF=\u81EA\u52A8\uFF08${args.conn === "Y" ? "IV" : "II"}\uFF09${mark("series")}` : `\u63A5\u7EBF=${s}${mark("series")}`
+    );
+    items.push(`${MOUNT_ZH[args.mount]}${mark("mount")}`);
+    return items;
+  }
+  items.push(
+    `reg=${args.reg === "reversing" ? "W \u6B63\u53CD\u8C03" : args.reg === "coarse_fine" ? "G \u7C97\u7EC6\u8C03" : "0 \u7EBF\u6027\u8C03"}${mark("reg")}`
+  );
+  if (args.reg === "linear") {
+    items.push(
+      args.positions != null ? `${args.positions} \u6863${mark("positions")}` : "\u6863\u6570\u672A\u6307\u5B9A"
+    );
+  } else {
+    items.push(`\xB1${args.pm ?? 8} \u6863${mark("pm")}`);
+  }
+  items.push(`${args.oil || !args.vacuum ? "\u6CB9\u6D78" : "\u771F\u7A7A"}${mark("medium")}`);
+  items.push(`${MOUNT_ZH[args.mount]}${mark("mount")}`);
+  return items;
+}
+function assumptionsLine(args) {
+  const items = assumptionsFromArgs(args);
+  if (items.every((i) => !i.includes("\uFF08\u9ED8\u8BA4\uFF09") && !i.includes("\u672A\u6307\u5B9A"))) {
+    return null;
+  }
+  return `\u5047\u5B9A\uFF1A${items.join(" \xB7 ")}`;
+}
+function formatCliText(input, args) {
   const out = selectOltc(input);
   if (!out.ok || !out.results.length) {
     const err = [...out.errorsZh, ...out.errorsEn].join("\n") || "No type found.";
@@ -2055,9 +2117,16 @@ function formatCliText(input) {
     lines.push("\u5176\u4ED6");
     for (const a of alts) lines.push(a.model);
   }
+  if (args) {
+    const assumed = assumptionsLine(args);
+    if (assumed) {
+      lines.push("");
+      lines.push(assumed);
+    }
+  }
   return lines.join("\n") + "\n";
 }
-function formatCliJson(input) {
+function formatCliJson(input, args) {
   const out = selectOltc(input);
   const primary = out.results[0] ?? null;
   const alts = pickOtherOptions(out.results, 3).map((r) => r.model);
@@ -2066,6 +2135,7 @@ function formatCliJson(input) {
     model: primary?.model ?? null,
     why: primary?.reasonsZh[0] ?? primary?.reasonsEn[0] ?? null,
     alts,
+    assumptions: args ? assumptionsFromArgs(args) : [],
     errors: out.errorsZh.length ? out.errorsZh : out.errorsEn
   };
   return JSON.stringify(payload, null, 2) + "\n";
@@ -2081,7 +2151,7 @@ function runCli(argv, io = {
       return 0;
     }
     const input = cliToSelectInput(args);
-    io.stdout(args.json ? formatCliJson(input) : formatCliText(input));
+    io.stdout(args.json ? formatCliJson(input, args) : formatCliText(input, args));
     return 0;
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oltc-selector",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Huaming OLTC/OCTC type selection CLI. No prices. Same engine as the web app.",
   "bin": {
     "oltc": "bin/oltc.js"
@@ -13,7 +13,7 @@
   "engines": {
     "node": ">=20"
   },
-  "license": "UNLICENSED",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/erict16/oltc-selector.git"