e10-data 0.1.0 → 0.1.3

package/README.md

@@ -14,11 +14,12 @@ 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 三参数）
 e10-data field   id2name|name2id                       关联字段翻译（testRemoteBrowser / complete）
+e10-data conf    get|batch|batch-file|resolve|resolve-file|add|add-file|update|delete   环境参数配置中心（chatBi config map，替代 config-resolve 脚本 URL 直连；confType 默认按 CONN_/DS_/WF_ 前缀推导，可 --type 显式）
 e10-data exp     status|manifest|commits|file|pull|init|commit|lock|release|rollback   专家包版本管理
 ```
 
@@ -26,6 +27,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,12 +35,17 @@ 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 智能问数
 e10-data noun list --skill rd-department
 e10-data field id2name --module ebuilder/form --type ebuilder --ids 3194494277170470571 \
     --form-param '{"fieldId":"966849910772850766","module":"ebuilderform"}'
+e10-data conf get CONN_EC_EDCAPP                                     # 读配置中心单条
+e10-data conf resolve '{"connId":"#{CONN_EC_EDCAPP}"}'                # 占位符替换为真实值
+e10-data conf add CONN_EC_EDCAPP --value 10 --name "说明" --attrs '{"schema":"ec_edcapp"}'
+e10-data conf delete CONN_EC_EDCAPP
 e10-data exp status --expert data-assistant
 e10-data exp pull --expert data-assistant --dir <本地专家包目录> --dry-run
 ```

package/bin/e10-data.mjs

@@ -4,11 +4,13 @@
  * 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
  *   e10-data field  id2name|name2id  关联字段翻译 testRemoteBrowser / complete
+ *   e10-data conf   get|batch|batch-file|resolve|resolve-file|add|add-file|update|delete
+ *                              环境参数配置中心（chatBi config map，替代 config-resolve 脚本 URL 直连）
  *
  * 通用：--json 原样输出；复杂 JSON 参数支持 @文件 或 内联（中文走 @文件 更稳）
  * 认证：进程内读取用户级登录缓存 ~/.workbuddy/e10-login-cache.md；不存在/失效提示先 e10-login
@@ -77,7 +79,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 +96,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 +118,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 +138,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 +214,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 +231,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);
 }
@@ -397,6 +455,230 @@ async function cmdFieldName2id(args, json) {
   printHuman("name→id 候选 " + rows.length + " 条", rows.map((x) => ({ id: x.id, name: x.name ?? x.title ?? "" })), ["id", "name"]);
 }
 
+// ---------------- conf：环境参数配置中心（chatBi config map） ----------------
+// 覆盖 config-resolve 原 resolve_config.py 的 URL 直连调用：get/batch/batch-file/resolve/resolve-file
+// 与管理 add/add-file/update/delete。认证复用进程内登录缓存（完整 Cookie + eteamsid，同 query/ds/doc），
+// 无内置令牌；baseUrl 取登录缓存（与 executeQueryDsl 同域）。confType 默认由 key 前缀推导
+// （CONN_→conn / DS_→ds / WF_→wf），可用 --type 显式指定任意大类（如 data-source-query / system-config）。
+const CONF_PREFIX_TYPE = [["CONN_", "conn"], ["DS_", "ds"], ["WF_", "wf"]];
+const CONF_GET_PATH = "/api/dw/newetl/chatBi/getChatBiConfigMap";
+const CONF_BATCH_PATH = "/api/dw/newetl/chatBi/batchGetChatBiConfigMap";
+const CONF_ADD_PATH = "/api/dw/newetl/chatBi/batchAddChatBiConfigMap";
+const CONF_UPDATE_PATH = "/api/dw/newetl/chatBi/updateChatBiConfigMap";
+const CONF_DELETE_PATH = "/api/dw/newetl/chatBi/deleteChatBiConfigMap";
+const CONF_TOKEN_RE = /#\{([A-Z][A-Z0-9_]{2,})\}/g;
+function confKeyType(key, explicitType) {
+  if (explicitType) return explicitType;
+  for (const [p, t] of CONF_PREFIX_TYPE) if (key.startsWith(p)) return t;
+  throw new Error("无法由 confKey 推导 confType（需 CONN_/DS_/WF_ 前缀或显式 --type）: " + key);
+}
+function confFail(j, url) {
+  const m = (j && (j.msg || (j.actionMsg && j.actionMsg.message))) || "";
+  throw new Error("配置服务请求失败 [" + url + "]" + (m ? ": " + m : ""));
+}
+async function confRequest(method, url, bodyObj) {
+  const resp = await fetch(BASE + url, {
+    method,
+    headers: {
+      "accept": "application/json, text/plain, */*",
+      "langType": "zh_CN",
+      "cookie": auth.cookie,
+      "eteamsid": auth.eteamsid,
+      "ebbusinessid": EB_BIZ_ID,
+      "user-agent": UA,
+      ...(bodyObj !== undefined ? { "Content-Type": "application/json;charset=UTF-8" } : {}),
+    },
+    ...(bodyObj !== undefined ? { body: JSON.stringify(bodyObj) } : {}),
+  });
+  const text = await resp.text();
+  let j; try { j = parseJsonSafe(text); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + text.slice(0, 300)); }
+  checkAuthFail(resp, text, j);
+  return j;
+}
+async function confGetData(ctype, key, silent) {
+  const url = CONF_GET_PATH + "?confType=" + encodeURIComponent(ctype) + "&confKey=" + encodeURIComponent(key);
+  let r;
+  try { r = await confRequest("GET", url); }
+  catch (e) { if (silent) return null; throw e; }
+  const data = (r && r.data) || null;
+  if (!silent && (!data || data.confValue === undefined || data.confValue === null || data.confValue === "")) {
+    throw new Error("配置不存在或为空: confType=" + ctype + " confKey=" + key);
+  }
+  return data;
+}
+function confNormalizeBatch(payload) {
+  const data = (payload && payload.data) || null;
+  const out = {};
+  if (Array.isArray(data)) {
+    for (const row of data) {
+      if (!row || typeof row !== "object") continue;
+      const k = row.confKey || row.conf_key;
+      if (k) out[k] = row;
+    }
+  } else if (data && typeof data === "object") {
+    for (const [k, v] of Object.entries(data)) {
+      if (v && typeof v === "object" && !v.confKey) v.confKey = k;
+      out[k] = v;
+    }
+  }
+  return out;
+}
+async function cmdConfGet(args, json, keys) {
+  const key = keys[0];
+  if (!key) throw new Error("conf get 缺少 confKey（用法: conf get <key> [--type t]）");
+  const ctype = confKeyType(key, args.type);
+  const data = await confGetData(ctype, key);
+  if (json) return data;
+  console.log(JSON.stringify(data, null, 1));
+}
+async function cmdConfBatch(args, json, keys) {
+  if (!keys.length) throw new Error("conf batch 缺少 confKey 列表（用法: conf batch <key1> [key2 ...]）");
+  const items = keys.map((k) => ({ confType: confKeyType(k, args.type), confKey: k }));
+  let map = {};
+  try {
+    const r = await confRequest("POST", CONF_BATCH_PATH, items);
+    map = confNormalizeBatch(r);
+    for (const it of items) {
+      const c = map[it.confKey];
+      if (!c || c.confValue === undefined || c.confValue === null || c.confValue === "") {
+        throw new Error("批量响应缺失 confKey=" + it.confKey);
+      }
+    }
+  } catch (e) {
+    if (String(e.message).indexOf("批量响应缺失") === 0) throw e;
+    console.error("[config-resolve] 批量接口不可用，降级逐条单查: " + e.message);
+    map = {};
+    for (const it of items) map[it.confKey] = await confGetData(it.confType, it.confKey);
+  }
+  if (json) return map;
+  printHuman("配置 " + items.length + " 条", keys.map((k) => ({ key: k, confType: items.find((x) => x.confKey === k).confType, confValue: (map[k] || {}).confValue ?? "", confName: (map[k] || {}).confName ?? "" })), ["key", "confType", "confValue", "confName"]);
+}
+async function cmdConfBatchFile(args, json) {
+  if (!args["batch-file"]) throw new Error("conf batch-file 缺少参数（用法: conf batch-file @items.json）");
+  const items = readJsonArg(args["batch-file"], "--batch-file");
+  const list = Array.isArray(items) ? items : [items];
+  const map = {};
+  for (const it of list) {
+    if (!it.confKey || !it.confType) continue;
+    map[it.confKey] = await confGetData(it.confType, it.confKey);
+  }
+  if (json) return map;
+  printHuman("配置 " + Object.keys(map).length + " 条", Object.keys(map).map((k) => ({ key: k, confValue: (map[k] || {}).confValue ?? "", confName: (map[k] || {}).confName ?? "" })), ["key", "confValue", "confName"]);
+}
+async function confResolveAll(keys) {
+  // 多占位符：先批量预取一轮（失败降级逐条单查），返回 {key: data}
+  const items = keys.map((k) => ({ confType: confKeyType(k, ""), confKey: k }));
+  const map = {};
+  try {
+    const r = await confRequest("POST", CONF_BATCH_PATH, items);
+    const got = confNormalizeBatch(r);
+    for (const it of items) {
+      const c = got[it.confKey];
+      if (!c || c.confValue === undefined || c.confValue === null || c.confValue === "") throw new Error("缺失 " + it.confKey);
+      map[it.confKey] = c;
+    }
+  } catch {
+    for (const it of items) map[it.confKey] = await confGetData(it.confType, it.confKey);
+  }
+  return map;
+}
+async function confResolveText(text, json) {
+  const found = [...new Set([...text.matchAll(CONF_TOKEN_RE)].map((m) => m[1]))];
+  const map = found.length ? await confResolveAll(found) : {};
+  const out = text.replace(CONF_TOKEN_RE, (m0, k) => {
+    const cfg = map[k];
+    if (!cfg) throw new Error("配置不存在或为空: " + k);
+    return cfg.confValue ?? "";
+  });
+  if (json) return { input: text, output: out, resolved: Object.fromEntries(Object.entries(map).map(([k, v]) => [k, v.confValue ?? ""])) };
+  return out;
+}
+async function cmdConfResolve(args, json, keys) {
+  let text = keys[0];
+  if (!text) throw new Error("conf resolve 缺少文本（用法: conf resolve '<含#{KEY}文本>' | @file.txt）");
+  if (text.startsWith("@")) text = fs.readFileSync(text.slice(1), "utf-8");
+  const out = await confResolveText(text, json);
+  if (json) { console.log(JSON.stringify(out, null, 1)); return out; }
+  process.stdout.write(out + "\n");
+}
+async function cmdConfResolveFile(args, json) {
+  const p = args["resolve-file"];
+  if (!p) throw new Error("conf resolve-file 缺少文件路径（用法: conf resolve-file <文件路径>）");
+  if (!fs.existsSync(p)) throw new Error("文件不存在: " + p);
+  const text = fs.readFileSync(p, "utf-8");
+  const out = await confResolveText(text, json);
+  if (json) { console.log(JSON.stringify(out, null, 1)); return out; }
+  process.stdout.write(out + "\n");
+}
+async function cmdConfAdd(args, json, keys) {
+  const key = keys[0];
+  if (!key || args.value === undefined) throw new Error("conf add 缺少 confKey/confValue（用法: conf add <key> --value <真实值> [--name] [--attrs] [--type] [--force]）");
+  const ctype = confKeyType(key, args.type);
+  if (!args.force && await confGetData(ctype, key, true)) {
+    console.error("[config-resolve] 配置已存在，跳过新增（如需修改请用 conf update；确需重建可先 conf delete）: " + key);
+    return null;
+  }
+  const item = { confType: ctype, confKey: key, confValue: String(args.value), confAttrs: args.attrs || "", confName: args.name || "" };
+  const r = await confRequest("POST", CONF_ADD_PATH, [item]);
+  if (json) return r;
+  console.log("新增成功: " + key + " = " + item.confValue);
+}
+async function cmdConfAddFile(args, json) {
+  if (args["add-file"] === undefined) throw new Error("conf add-file 缺少参数（用法: conf add-file @items.json）");
+  const items = readJsonArg(args["add-file"], "--add-file");
+  const list = Array.isArray(items) ? items : [items];
+  const toAdd = [];
+  for (const it of list) {
+    if (!it.confKey || it.confValue === undefined) continue;
+    const ctype = it.confType || confKeyType(it.confKey, args.type);
+    const dup = await confGetData(ctype, it.confKey, true);
+    if (dup) { console.error("[config-resolve] 已存在跳过: " + it.confKey); continue; }
+    toAdd.push({ confType: ctype, confKey: it.confKey, confValue: String(it.confValue), confAttrs: it.confAttrs || "", confName: it.confName || "" });
+  }
+  if (!toAdd.length) { console.log("全部已存在，无新增"); return null; }
+  const r = await confRequest("POST", CONF_ADD_PATH, toAdd);
+  if (json) return r;
+  console.log("批量新增 " + toAdd.length + " 条成功");
+}
+async function cmdConfUpdate(args, json, keys) {
+  const key = keys[0];
+  if (!key) throw new Error("conf update 缺少 confKey（用法: conf update <key> [--value v] [--name n] [--attrs a] [--type t]）");
+  if (args.value === undefined && args.name === undefined && args.attrs === undefined) {
+    throw new Error("conf update 至少需提供 --value / --name / --attrs 之一");
+  }
+  const body = { confType: confKeyType(key, args.type), confKey: key };
+  if (args.value !== undefined) body.confValue = String(args.value);
+  if (args.name !== undefined) body.confName = args.name;
+  if (args.attrs !== undefined) body.confAttrs = args.attrs;
+  const r = await confRequest("POST", CONF_UPDATE_PATH, body);
+  if (json) return r;
+  console.log("更新成功: " + key);
+}
+async function cmdConfDelete(args, json, keys) {
+  const key = keys[0];
+  if (!key) throw new Error("conf delete 缺少 confKey（用法: conf delete <key> [--type t]）");
+  const ctype = confKeyType(key, args.type);
+  const url = CONF_DELETE_PATH + "?confType=" + encodeURIComponent(ctype) + "&confKey=" + encodeURIComponent(key);
+  const r = await confRequest("DELETE", url);
+  if (json) return r;
+  console.log("删除成功: " + key);
+}
+async function cmdConf(sub, args, json, pos) {
+  const keys = pos.slice(2);
+  switch (sub) {
+    case "get": return cmdConfGet(args, json, keys);
+    case "batch": return cmdConfBatch(args, json, keys);
+    case "batch-file": return cmdConfBatchFile(args, json);
+    case "resolve": return cmdConfResolve(args, json, keys);
+    case "resolve-file": return cmdConfResolveFile(args, json);
+    case "add": return cmdConfAdd(args, json, keys);
+    case "add-file": return cmdConfAddFile(args, json);
+    case "update": return cmdConfUpdate(args, json, keys);
+    case "delete": return cmdConfDelete(args, json, keys);
+    default: usage(); process.exit(1);
+  }
+}
+
 // ---------------- exp：专家包版本管理（expert-repository） ----------------
 async function expGet(url) {
   // 返回 {raw, j}：raw 用于正则提取大整数 id（commitId 19 位超 JS Number 精度，JSON.parse 会丢精度！）
@@ -405,7 +687,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 +943,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>
@@ -678,6 +960,16 @@ noun    词库查询
 field   关联字段翻译
   field id2name  --module <m> --type <t> --ids id1,id2 [--form-param '{"fieldId":"..","module":"ebuilderform"}'|--eb-browser-param '{..}'|--property-type x]
   field name2id  --module <m> --type <t> --name 名称 [同上附加参数]
+conf    环境参数配置中心（chatBi config map，替代 config-resolve 脚本 URL 直连；confType 默认由 CONN_/DS_/WF_ 前缀推导，可 --type 显式）
+  conf get <key> [--type t]                       # 单查（confValue/confAttrs/confName 全量 JSON）
+  conf batch <key1> [key2 ...]                    # 批量查（批量接口异常自动降级逐条单查）
+  conf batch-file @items.json                     # 按 [{confType,confKey}..] 显式批量查（支持任意 confType）
+  conf resolve '<含#{KEY}文本>'|@file.txt         # 文本占位符替换为真实值（含中文建议 @file）
+  conf resolve-file <文件路径>                     # 读文件替换全部占位符并打印（不改写原文件）
+  conf add <key> --value <真实值> [--name 说明] [--attrs '{"schema":..}'] [--type t] [--force]  # 新增（默认判重，已存在跳过）
+  conf add-file @items.json                       # JSON 数组批量新增（逐条判重）
+  conf update <key> [--value v] [--name n] [--attrs a] [--type t]   # 更新（confType+confKey 定位，传哪个字段更哪个）
+  conf delete <key> [--type t]                    # 删除
 exp     专家包版本管理（expert-repository/v1，响应以 data.actionMsg.code=0 判成功）
   exp status    --expert <code> [--branch main]                       # 仓库状态（headCommitId/headRevision=提交基线）
   exp manifest  --expert <code> [--commit <id>]                       # 文件清单（sha256）
@@ -694,7 +986,8 @@ exp     专家包版本管理（expert-repository/v1，响应以 data.actionMsg.
 
 async function main() {
   const rawArgv = process.argv.slice(2);
-  if (rawArgv.includes("--version") || rawArgv.includes("-v") || rawArgv.includes("version")) {
+  // 仅当顶层显式 -v/--version（无子命令）时打印版本；exp release/rollback 的 --version 是版本号参数、conf 文本可能含 version 字样，一律放行
+  if (rawArgv.length === 1 && (rawArgv[0] === "--version" || rawArgv[0] === "-v")) {
     console.log("e10-data " + cliVersion());
     process.exit(0);
   }
@@ -726,6 +1019,9 @@ async function main() {
     if (sub === "id2name") result = await cmdFieldId2name(args, json);
     else if (sub === "name2id") result = await cmdFieldName2id(args, json);
     else { usage(); process.exit(1); }
+  } else if (family === "conf") {
+    if (!sub) { usage(); process.exit(1); }
+    result = await cmdConf(sub, args, json, pos);
   } else if (family === "exp") {
     if (!sub) { usage(); process.exit(1); }
     switch (sub) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "e10-data",
-  "version": "0.1.0",
-  "description": "泛微 E10 数据接口统一 CLI（data-assistant 专家配套）：DSL 查询/数据源/文档/词库/关联字段翻译/专家包版本管理，认证复用 weaver-e10-login 登录态",
+  "version": "0.1.3",
+  "description": "泛微 E10 数据接口统一 CLI（data-assistant 专家配套）：DSL 查询/数据源/文档/词库/关联字段翻译/环境参数配置中心(conf)/专家包版本管理，认证复用 weaver-e10-login 登录态",
   "author": "e10-dw",
   "license": "MIT",
   "type": "module",
@@ -27,4 +27,4 @@
   "scripts": {
     "pack": "npm pack"
   }
-}
+}