e10-data 0.1.0 → 0.1.2

package/README.md

@@ -14,7 +14,7 @@ e10-data --version       # 验证
 ## 命令总览
 
 ```
-e10-data query   <--conn <connId> --model <ebuilder|flow|eteams|attend|hr|document|dw|blog> --schema <数据库> [--table-id <流程ID>] --dsl @file.json>
+e10-data query   <--conn <connId> --model <ebuilder|flow|eteams|attend|hr|document|dw|blog> --schema <数据库> [--table-id <流程ID>] [--debug true|false] --dsl @file.json>
 e10-data ds      tables|fields|list|chart|stat|count   数据源（业务模块）取数与元数据
 e10-data doc     count|list                            文档查询（documentListCount + documentList）
 e10-data noun    list --skill <skillKey>               词库查询（可带 --source-type/--source-group/--source-table 三参数）
@@ -26,6 +26,7 @@ e10-data exp     status|manifest|commits|file|pull|init|commit|lock|release|roll
 
 - `--json`：原样输出接口 JSON（供脚本/Agent 消费）；默认人读输出。
 - 复杂 JSON/中文参数：推荐 `@文件` 承载（如 `--dsl @q.json`、`--where @cond.json`）。
+- ⚠️ 大整数精度（自动处理）：E10 的 ID 多为 19 位，超过 JS 安全整数（2^53-1≈9e15）。CLI 解析 JSON 时**自动把超范围裸整数转成字符串**再发请求/输出（实测后端接受字符串做 =/IN/BETWEEN 数值比较），无需手动加引号，也不误伤字符串正文。
 - 认证：进程内读取 `~/.workbuddy/e10-login-cache.md`；失效提示重新执行 `e10-login oidc`。
 - 版本更新：`npm i -g e10-data@latest`；查看源上最新 `npm view e10-data version`。
 
@@ -33,6 +34,7 @@ e10-data exp     status|manifest|commits|file|pull|init|commit|lock|release|roll
 
 ```bash
 e10-data query --conn 1144919996804022272 --model dw --schema dw --dsl @q.json
+e10-data query --conn 1144919996804022272 --model dw --schema dw --debug true --dsl @q.json   # debug 模式：额外打印实际执行 SQL
 e10-data ds count --group weaver-project-servicetask --table 715738355537494016
 e10-data ds fields --group weaver-formreport-service --table 1307487628041044060
 e10-data doc count --name 智能问数

package/bin/e10-data.mjs

@@ -4,7 +4,7 @@
  * e10-data CLI —— data-assistant 专家统一数据接口命令行（2026-09-03 扩展）
  *
  * 覆盖（数据查询链路全部家族；登录/HRM 复用 e10-login / hrm-cli，checkEbModulePermission 已废弃不提供）：
- *   e10-data query run|...  DSL 查询 executeQueryDsl（conn/model/schema/tableId/dslQuery）
+ *   e10-data query    DSL 查询 executeQueryDsl（conn/model/schema/tableId/dslQuery/debug）
  *   e10-data ds     tables|fields|list|chart|stat|count   数据源（业务模块）取数与元数据
  *   e10-data doc    count|list   文档查询 documentListCount / documentList
  *   e10-data noun   list         词库 getChatDocsBySkillKey
@@ -77,7 +77,7 @@ async function postJson(endpoint, bodyObj, extraHeaders = {}) {
     body: JSON.stringify(bodyObj),
   });
   const text = await resp.text();
-  let j; try { j = JSON.parse(text); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + text.slice(0, 300)); }
+  let j; try { j = parseJsonSafe(text); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + text.slice(0, 300)); }
   checkAuthFail(resp, text, j);
   return j;
 }
@@ -94,7 +94,7 @@ async function getUrl(url) {
     },
   });
   const text = await resp.text();
-  let j; try { j = JSON.parse(text); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + text.slice(0, 300)); }
+  let j; try { j = parseJsonSafe(text); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + text.slice(0, 300)); }
   checkAuthFail(resp, text, j);
   return j;
 }
@@ -116,7 +116,7 @@ async function postMultipart(endpoint, formObj) {
     body: fd,
   });
   const text = await resp.text();
-  let j; try { j = JSON.parse(text); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + text.slice(0, 300)); }
+  let j; try { j = parseJsonSafe(text); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + text.slice(0, 300)); }
   checkAuthFail(resp, text, j);
   return j;
 }
@@ -136,10 +136,56 @@ function parseArgs(argv) {
   }
   return { args, pos };
 }
+// ⚠️ 大整数精度保护（2026-09-03）：E10 主键/ID 多为 19 位大整数，超过 JS 安全整数 2^53-1
+// （9007199254740991）。JSON.parse 会将其舍入为近似 double（如 1297901170990161977 → ...1920），
+// 导致 DSL 条件查不到数据（静默空结果）或返回 ID 失真。此处把 JSON 中 >2^53 的裸数字字面量
+// 加引号转字符串（后端实测接受字符串形式做 = / IN / BETWEEN 数值比较），请求与响应两侧统一保护。
+function protectBigInts(raw) {
+  // 逐字符扫描：跟踪 JSON 字符串状态（含转义），仅在引号外的结构层把 >2^53 的裸整数加引号，
+  // 避免误伤字符串内容（如 avatar JSON、文档正文里含 ",大数字" 片段）。
+  let out = "", inStr = false, esc = false;
+  for (let i = 0; i < raw.length; i++) {
+    const ch = raw[i];
+    if (inStr) {
+      out += ch;
+      if (esc) esc = false;
+      else if (ch === "\\") esc = true;
+      else if (ch === '"') inStr = false;
+      continue;
+    }
+    if (ch === '"') { inStr = true; out += ch; continue; }
+    if (ch === "-" || (ch >= "0" && ch <= "9")) {
+      let j = i + 1;
+      while (j < raw.length && raw[j] >= "0" && raw[j] <= "9") j++;  // 纯整数 token（无小数点/指数）
+      let k = i - 1;
+      while (k >= 0 && /\s/.test(raw[k])) k--;
+      const prev = k < 0 ? "" : raw[k];
+      let n = j;
+      while (n < raw.length && /\s/.test(raw[n])) n++;
+      const next = n < raw.length ? raw[n] : "";
+      const token = raw.slice(i, j);
+      if ((prev === ":" || prev === "," || prev === "[") && (next === "," || next === "}" || next === "]")) {
+        try {
+          const bi = BigInt(token);
+          if (bi > 9007199254740991n || bi < -9007199254740991n) { out += '"' + token + '"'; i = j - 1; continue; }
+        } catch { /* 非纯整数不转换 */ }
+      }
+      out += raw.slice(i, j);
+      i = j - 1;
+      continue;
+    }
+    out += ch;
+  }
+  return out;
+}
+function parseJsonSafe(raw, label) {
+  try { return JSON.parse(protectBigInts(raw)); }
+  catch (e) { throw new Error((label || "JSON") + " 解析失败: " + e.message); }
+}
 function readJsonArg(val, label) {
   let raw = val;
   if (val.startsWith("@")) raw = fs.readFileSync(val.slice(1), "utf-8");
-  try { return JSON.parse(raw); } catch (e) { throw new Error(label + " JSON 解析失败: " + e.message); }
+  return parseJsonSafe(raw, label);
 }
 function need(arg, args) { if (!args[arg]) throw new Error("缺少必填参数 --" + arg); return args[arg]; }
 
@@ -166,8 +212,15 @@ async function cmdQuery(args, json) {
   const conn = need("conn", args), model = need("model", args), schema = need("schema", args);
   const tableId = args["table-id"] || "";
   const dslVal = need("dsl", args);
-  const dslQuery = dslVal.startsWith("@") ? readJsonArg(dslVal, "--dsl") : JSON.parse(dslVal);
-  const r = await postJson("/api/dw/dsl/executeQueryDsl", { connId: conn, model, schema, tableId, dslQuery });
+  const dslQuery = dslVal.startsWith("@") ? readJsonArg(dslVal, "--dsl") : parseJsonSafe(dslVal, "--dsl");
+  const body = { connId: conn, model, schema, tableId, dslQuery };
+  if (args.debug !== undefined) {  // --debug true|false，与 conn/model 同层级
+    const dbg = String(args.debug).toLowerCase();
+    if (dbg === "true" || dbg === "1") body.debug = true;
+    else if (dbg === "false" || dbg === "0") body.debug = false;
+    else throw new Error("--debug 值必须为 true 或 false（当前: " + args.debug + "）");
+  }
+  const r = await postJson("/api/dw/dsl/executeQueryDsl", body);
   if (json) return r;
   if (String(r.code) !== "200" && r.code !== undefined && String(r.code) !== "0") {
     console.log("code=" + r.code + " msg=" + (r.msg || ""));
@@ -176,7 +229,10 @@ async function cmdQuery(args, json) {
     }
     return;
   }
-  const rows = r.data || [];
+  const d = r.data;
+  // debug=true 时 data 为 { sql, records }；否则为行数组
+  const rows = Array.isArray(d) ? d : (d && Array.isArray(d.records) ? d.records : []);
+  if (d && !Array.isArray(d) && d.sql) console.log("SQL: " + d.sql);
   if (!rows.length) { console.log("(空：0 行)"); return; }
   printHuman("结果 " + rows.length + " 行", rows);
 }
@@ -405,7 +461,7 @@ async function expGet(url) {
     headers: { "accept": "application/json, text/plain, */*", "langType": "zh_CN", "cookie": auth.cookie, "eteamsid": auth.eteamsid, "ebbusinessid": EB_BIZ_ID, "user-agent": UA },
   });
   const raw = await resp.text();
-  let j; try { j = JSON.parse(raw); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + raw.slice(0, 300)); }
+  let j; try { j = parseJsonSafe(raw); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + raw.slice(0, 300)); }
   if (resp.status === 401 || (j && String(j.code) === "-1" && /token|登录|失效/i.test(String(j.msg || "")))) throw new Error("登录态失效，请重新 e10-login oidc 登录");
   return { raw, j };
 }
@@ -661,7 +717,7 @@ function usage() {
 用法: node e10-data.mjs <族> <子命令> [--参数]   通用 --json 原样输出
 
 query   DSL 数据查询 executeQueryDsl
-  query  --conn <connId> --model <ebuilder|flow|eteams|attend|hr|document|dw|blog> --schema <数据库> [--table-id <流程ID>] --dsl @file.json|'{...}'
+  query  --conn <connId> --model <ebuilder|flow|eteams|attend|hr|document|dw|blog> --schema <数据库> [--table-id <流程ID>] [--debug true|false] --dsl @file.json|'{...}'
 ds      数据源（业务模块）取数与元数据
   ds tables  --group <gid> [--name 关键词]
   ds fields  --group <gid> --table <tid>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "e10-data",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "泛微 E10 数据接口统一 CLI（data-assistant 专家配套）：DSL 查询/数据源/文档/词库/关联字段翻译/专家包版本管理，认证复用 weaver-e10-login 登录态",
   "author": "e10-dw",
   "license": "MIT",