e10-data 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# e10-data
+
+泛微 E10 数据接口统一命令行工具（「数据助手」data-assistant 专家配套）。将专家内散落的 HTTP 接口调用收敛为统一的 CLI 命令面。
+
+## 安装
+
+```bash
+npm i -g e10-data        # 全局安装
+e10-data --version       # 验证
+```
+
+> 依赖：认证复用 `weaver-e10-login` 的登录态（用户级缓存 `~/.workbuddy/e10-login-cache.md`）。请先安装并登录 weaver-e10-login（`e10-login oidc`），登录态失效时 CLI 会提示重新登录。
+
+## 命令总览
+
+```
+e10-data query   <--conn <connId> --model <ebuilder|flow|eteams|attend|hr|document|dw|blog> --schema <数据库> [--table-id <流程ID>] --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 exp     status|manifest|commits|file|pull|init|commit|lock|release|rollback   专家包版本管理
+```
+
+## 通用约定
+
+- `--json`：原样输出接口 JSON（供脚本/Agent 消费）；默认人读输出。
+- 复杂 JSON/中文参数：推荐 `@文件` 承载（如 `--dsl @q.json`、`--where @cond.json`）。
+- 认证：进程内读取 `~/.workbuddy/e10-login-cache.md`；失效提示重新执行 `e10-login oidc`。
+- 版本更新：`npm i -g e10-data@latest`；查看源上最新 `npm view e10-data version`。
+
+## 用法示例
+
+```bash
+e10-data query --conn 1144919996804022272 --model dw --schema dw --dsl @q.json
+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 exp status --expert data-assistant
+e10-data exp pull --expert data-assistant --dir <本地专家包目录> --dry-run
+```

package/bin/e10-data.mjs

@@ -0,0 +1,747 @@
+#!/usr/bin/env node
+// -*- coding: utf-8 -*-
+/**
+ * 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 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
+ *
+ * 通用：--json 原样输出；复杂 JSON 参数支持 @文件 或 内联（中文走 @文件 更稳）
+ * 认证：进程内读取用户级登录缓存 ~/.workbuddy/e10-login-cache.md；不存在/失效提示先 e10-login
+ *
+ * 用法示例：
+ *   node e10-data.mjs query  --conn 1144919996804022272 --model dw --schema dw --dsl @q.json
+ *   node e10-data.mjs ds count --group weaver-project-servicetask --table 715738355537494016
+ *   node e10-data.mjs doc count --name 测试
+ *   node e10-data.mjs noun list --skill rd-department
+ *   node e10-data.mjs field id2name --module ebuilder/form --type ebuilder \
+ *        --ids 3194494277170470571 --form-param '{"fieldId":"966849910772850766","module":"ebuilderform"}'
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import crypto from "node:crypto";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function cliVersion() {
+  try { return JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8")).version; }
+  catch { return "dev"; }
+}
+
+const UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/151.0.0.0 Safari/537.36";
+const EB_BIZ_ID = "10000000000000000";
+
+// ---------------- 认证 ----------------
+function loadAuth() {
+  const p = path.join(os.homedir(), ".workbuddy", "e10-login-cache.md");
+  if (!fs.existsSync(p)) throw new Error("未找到登录缓存 " + p + "，请先执行 e10-login oidc / set 登录");
+  const txt = fs.readFileSync(p, "utf-8");
+  const get = (key) => {
+    const m = txt.match(new RegExp("\\*\\*" + key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\*\\*\\s*[:：]\\s*`?([^`\\n]+)`?"));
+    return m ? m[1].trim() : "";
+  };
+  const auth = { baseUrl: get("baseUrl"), eteamsid: get("ETEAMSID"), cookie: get("完整 Cookie 串"), userId: get("userId") || get("employeeId"), tenantKey: get("tenantKey") };
+  if (!auth.baseUrl || !auth.eteamsid) throw new Error("登录缓存缺少 baseUrl/ETEAMSID，请重新登录（e10-login oidc）");
+  if (!auth.cookie) auth.cookie = "langType=zh_CN; ETEAMSID=" + auth.eteamsid + "; agentType=workbuddy; isAgent=true";
+  return auth;
+}
+const auth = loadAuth();
+const BASE = auth.baseUrl.replace(/\/+$/, "");
+const USER = { id: auth.userId || "", tenantKey: auth.tenantKey || "" };
+
+// ---------------- HTTP ----------------
+function checkAuthFail(resp, text, j) {
+  if (resp.status === 401 || (j && String(j.code) === "-1" && /token|登录|失效/i.test(String(j.msg || "")))) {
+    throw new Error("登录态失效(" + (j.msg || resp.status) + ")，请重新 e10-login oidc 登录");
+  }
+}
+async function postJson(endpoint, bodyObj, extraHeaders = {}) {
+  const resp = await fetch(BASE + endpoint, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json;charset=UTF-8",
+      "accept": "application/json, text/plain, */*",
+      "langType": "zh_CN",
+      "cookie": auth.cookie,
+      "eteamsid": auth.eteamsid,
+      "ebbusinessid": EB_BIZ_ID,
+      "user-agent": UA,
+      "timezoneoffset": "-480",
+      ...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)); }
+  checkAuthFail(resp, text, j);
+  return j;
+}
+async function getUrl(url) {
+  const resp = await fetch(BASE + url, {
+    method: "GET",
+    headers: {
+      "accept": "application/json, text/plain, */*",
+      "langType": "zh_CN",
+      "cookie": auth.cookie,
+      "eteamsid": auth.eteamsid,
+      "ebbusinessid": EB_BIZ_ID,
+      "user-agent": UA,
+    },
+  });
+  const text = await resp.text();
+  let j; try { j = JSON.parse(text); } catch { throw new Error("HTTP " + resp.status + " 非JSON响应: " + text.slice(0, 300)); }
+  checkAuthFail(resp, text, j);
+  return j;
+}
+async function postMultipart(endpoint, formObj) {
+  const fd = new FormData();
+  for (const [k, v] of Object.entries(formObj)) fd.append(k, typeof v === "string" ? v : JSON.stringify(v));
+  const resp = await fetch(BASE + endpoint, {
+    method: "POST",
+    headers: {
+      "accept": "application/json, text/plain, */*",
+      "langType": "zh_CN",
+      "cookie": auth.cookie,
+      "eteamsid": auth.eteamsid,
+      "ebbusinessid": EB_BIZ_ID,
+      "user-agent": UA,
+      "timezoneoffset": "-480",
+      "referer": BASE + "/sp/ebddesigner/1282331905881874436",
+    },
+    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)); }
+  checkAuthFail(resp, text, j);
+  return j;
+}
+
+// ---------------- 参数解析 ----------------
+function parseArgs(argv) {
+  const args = {};
+  const pos = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      const key = a.slice(2);
+      const v = argv[i + 1];
+      if (v === undefined || v.startsWith("--")) { args[key] = true; }
+      else { args[key] = v; i++; }
+    } else pos.push(a);
+  }
+  return { args, pos };
+}
+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); }
+}
+function need(arg, args) { if (!args[arg]) throw new Error("缺少必填参数 --" + arg); return args[arg]; }
+
+// ---------------- 展示 ----------------
+function fmt(v) {
+  if (v === null || v === undefined) return "";
+  if (typeof v === "object") { const s = JSON.stringify(v); return s.length > 80 ? s.slice(0, 80) + "…" : s; }
+  return String(v);
+}
+function printHuman(title, rows, cols) {
+  if (title) console.log("== " + title + " ==");
+  if (!rows || !rows.length) { console.log("(空)"); return; }
+  if (cols) {
+    console.log(cols.join("\t"));
+    for (const r of rows) console.log(cols.map((c) => fmt(r[c])).join("\t"));
+  } else {
+    for (const r of rows.slice(0, 100)) console.log(JSON.stringify(r));
+    if (rows.length > 100) console.log("... 共 " + rows.length + " 行（--json 取全量）");
+  }
+}
+
+// ---------------- query：DSL 查询 ----------------
+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 });
+  if (json) return r;
+  if (String(r.code) !== "200" && r.code !== undefined && String(r.code) !== "0") {
+    console.log("code=" + r.code + " msg=" + (r.msg || ""));
+    if (/没有权限|无权限|权限不足|未授权|无权访问|无查询权限/i.test(String(r.msg || ""))) {
+      throw new Error("当前用户对该数据无查询权限，请检查 ETEAMSID 是否有效或联系管理员开通");
+    }
+    return;
+  }
+  const rows = r.data || [];
+  if (!rows.length) { console.log("(空：0 行)"); return; }
+  printHuman("结果 " + rows.length + " 行", rows);
+}
+
+// ---------------- ds：数据源 ----------------
+function dyn() {
+  return { eteamsId: auth.eteamsid, userId: auth.userId || "", tenantKey: auth.tenantKey || "", langId: 7, formatDate: "yyyy-MM-dd HH:mm:ss", isPublic: false };
+}
+function baseDto(tableId, groupId, pageNo, pageSize, queryType) {
+  return { tableId: String(tableId), groupId, pageNo, pageSize, queryType, containDetailTable: false, needFormat: true, dynamicParams: dyn() };
+}
+function parseWhere(val) {
+  if (!val) return null;
+  const arr = readJsonArg(val, "--where");
+  const list = Array.isArray(arr) ? arr : (arr.conditionList || []);
+  if (!list.length) return null;
+  const ts = Date.now(), rootKey = "root_" + ts;
+  return {
+    key: rootKey, relationship: "1", isParent: true, parentNode: "", mainField: true,
+    conditionList: list.map((c, i) => ({
+      key: rootKey + "_" + i, relationship: "1", isParent: false, parentNode: rootKey,
+      objId: c.objId || "", conditionId: c.fieldId, fieldName: c.fieldName || c.fieldId,
+      conditionType: c.conditionType || "", compareType: c.compareType, conditionValue: c.conditionValue ?? "",
+      fieldValue: c.fieldValue || "", mainField: c.mainField !== false, ignoreCaseMark: c.ignoreCaseMark || false,
+    })),
+  };
+}
+function parseStat(val) {
+  const arr = readJsonArg(val, "--stat");
+  const list = Array.isArray(arr) ? arr : [arr];
+  return list.map((s) => ({ fieldId: s.fieldId, fieldName: s.fieldId, objId: "", mainField: true, aggregator: s.aggregator || "SUM", ...(s.fieldAlias ? { fieldAlias: s.fieldAlias } : {}) }));
+}
+function parseOrder(val) {
+  if (!val) return [];
+  return val.split(",").map((s) => {
+    const [f, dir] = s.trim().split(/\s+/);
+    return { fieldId: f, fieldName: f, objId: "", isAsc: (dir || "asc").toLowerCase() !== "desc", mainField: true };
+  });
+}
+async function cmdTables(args, json) {
+  const gid = need("group", args);
+  const form = { name: args.name || "", pageNo: args.page || "1", pageSize: args.size || "100", groupId: gid, sourceType: args["source-type"] || "LOGIC", dataUsage: "" };
+  const r = await postMultipart("/api/ebuilder/common/ds/listByPage", form);
+  if (json) return r;
+  const recs = ((r.data || {}).records) || [];
+  printHuman("分组表清单 (total=" + ((r.data || {}).total) + ")", recs, ["id", "name", "tableText", "detailTable", "usage"]);
+}
+async function cmdFields(args, json) {
+  const gid = need("group", args), tid = need("table", args);
+  const form = { groupId: gid, sourceId: tid, sourceType: args["source-type"] || "LOGIC", detailFieldsGroup: "true", enableMerge: "true", needTableName: "true", params: "[]" };
+  const r = await postMultipart("/api/ebuilder/common/ds/fields", form);
+  if (json) return r;
+  for (const d of (r.data || [])) {
+    console.log("== 表: " + d.name + " (id=" + d.id + ") 字段 " + (d.fields || []).length + " 个 ==");
+    for (const f of (d.fields || [])) console.log([f.name, f.text, f.type, f.mainPrimaryKey ? "PK" : ""].filter(Boolean).join("\t"));
+  }
+}
+async function cmdList(args, json) {
+  const gid = need("group", args), tid = need("table", args), fld = need("fields", args);
+  const fields = fld.split(",").map((f) => ({ fieldId: f, fieldName: f, objId: String(tid), mainField: true }));
+  const dto = baseDto(tid, gid, parseInt(args.page || "1", 10), parseInt(args.size || "20", 10), "getListData");
+  dto.queryFields = fields;
+  dto.orderFields = parseOrder(args.order);
+  const ct = parseWhere(args.where); if (ct) dto.conditionTrees = ct;
+  dto.queryCount = true;
+  const r = await postMultipart("/api/dw/newetl/chatBi/ds/getListDatas", { sourceType: args["source-type"] || "LOGIC", queryDto: dto });
+  if (json) return r;
+  const data = r.data || {};
+  console.log("== 数据列表 count=" + data.count + " 行=" + (data.list || []).length + " ==");
+  printHuman("", data.list || [], fields.map((f) => f.fieldId));
+}
+async function cmdChart(args, json) {
+  const gid = need("group", args), tid = need("table", args), gb = need("group-by", args);
+  const dto = baseDto(tid, gid, parseInt(args.page || "1", 10), parseInt(args.size || "100", 10), "getChartData");
+  dto.groupFields = gb.split(",").map((f) => ({ fieldId: f, fieldName: f, objId: String(tid), mainField: true }));
+  dto.groupStatFields = parseStat(need("stat", args)).map((s) => ({ ...s, objId: String(tid) }));
+  const ct = parseWhere(args.where); if (ct) dto.conditionTrees = ct;
+  const r = await postMultipart("/api/dw/newetl/chatBi/ds/getChartDatas", { sourceType: args["source-type"] || "LOGIC", queryDto: dto });
+  if (json) return r;
+  printHuman("分组聚合 rows=" + (r.data || []).length, r.data || []);
+}
+async function cmdStat(args, json) {
+  const gid = need("group", args), tid = need("table", args);
+  const dto = baseDto(tid, gid, 1, 10, "getStatData");
+  dto.statFields = parseStat(need("stat", args)).map((s) => ({ ...s, objId: String(tid) }));
+  const ct = parseWhere(args.where); if (ct) dto.conditionTrees = ct;
+  const r = await postMultipart("/api/dw/newetl/chatBi/ds/getStatDatas", { sourceType: args["source-type"] || "LOGIC", queryDto: dto });
+  if (json) return r;
+  const data = r.data || {};
+  if (data.fields && data.fields.length) { for (const f of data.fields) console.log(JSON.stringify(f)); }
+  else console.log("(无统计结果)");
+}
+async function cmdCount(args, json) {
+  const gid = need("group", args), tid = need("table", args);
+  const dto = baseDto(tid, gid, 1, 10, "getCountData");
+  const ct = parseWhere(args.where); if (ct) dto.conditionTrees = ct;
+  const r = await postMultipart("/api/dw/newetl/chatBi/ds/getCountData", { sourceType: args["source-type"] || "LOGIC", queryDto: dto });
+  if (json) return r;
+  const data = r.data || {};
+  console.log("totalCount = " + (data.totalCount ?? "-"));
+}
+
+// ---------------- doc：文档查询 ----------------
+function docBaseBody(pageNo, pageSize) {
+  return {
+    curMenuType: "", limitedFolderIncludeSub: "", limitedFolderIds: "", docAppConsole: "",
+    viewType: "DOC_PAGINATION", pageNo, pageSize, morePageId: "", dimension: "ALL", includeBelongFolders: true,
+    order: { property: "default", direction: "DESC" }, searchType: "all", conditions: [], customConditions: [],
+    userId: auth.userId || "", current: pageNo,
+    columnOrders: [{ orderKey: "default", orderType: "" }], getColumn: false, quickSearchType: "normal",
+    withFullSearch: false, fetchFullSearchParam: true,
+  };
+}
+function buildDocConditions(args) {
+  const conds = [];
+  if (args.name) conds.push({ id: "name", type: "string", value: args.name });
+  if (args.creator) conds.push({ id: "creator", operate: args["creator-neq"] ? "neq" : "eq", type: "array", value: args.creator });
+  if (args.author) conds.push({ id: "author", operate: args["author-neq"] ? "neq" : "eq", type: "array", value: args.author });
+  if (args["content-type"]) conds.push({ id: "contentType", operate: "eq", type: "array", value: args["content-type"] });
+  if (args.time) conds.push({ id: "create_time", type: "date", value: args.time });
+  if (args["last-time"]) conds.push({ id: "last_update_time", type: "date", value: args["last-time"] });
+  if (args.folder) conds.push({ id: "folder", operate: "eq", type: "folder", value: args.folder });
+  if (args["folder-neq"]) conds.push({ id: "folder", operate: "neq", type: "folder", value: args["folder-neq"] });
+  return conds;
+}
+async function cmdDocCount(args, json) {
+  const body = docBaseBody(1, parseInt(args.size || "20", 10));
+  body.conditions = buildDocConditions(args);
+  const r = await postJson("/api/doc/documents/documentListCount", body);
+  if (json) return r;
+  const data = r.data || {};
+  console.log("total = " + (data.total ?? "-"));
+}
+async function cmdDocList(args, json) {
+  const pageSize = parseInt(args.size || "100", 10);
+  const body = docBaseBody(1, pageSize);
+  body.conditions = buildDocConditions(args);
+  const r1 = await postJson("/api/doc/documents/documentListCount", body);
+  if (json) return r1;
+  const total = (r1.data || {}).total || 0;
+  if (!total) { console.log("total = 0（未查询到符合条件的文档）"); return; }
+  const totalPages = Math.ceil(total / pageSize);
+  const maxPages = args.all ? totalPages : Math.min(parseInt(args.page || "1", 10), totalPages);
+  const startPage = args.all ? 1 : parseInt(args.page || "1", 10);
+  const allRows = [];
+  for (let pno = startPage; pno <= maxPages; pno++) {
+    const b = docBaseBody(pno, pageSize);
+    b.conditions = buildDocConditions(args);
+    const rr = await postJson("/api/doc/documents/documentList", b);
+    const rows = ((rr.data || {}).data) || [];
+    for (const row of rows) if (!allRows.some((x) => x.id === row.id)) allRows.push(row);
+    if (!args.all && pno === maxPages) break;
+  }
+  console.log("== 文档列表 total=" + total + " 本批=" + allRows.length + " 行 ==");
+  printHuman("", allRows, ["id", "name", "docCreatorName", "createTime", "folder"]);
+}
+
+// ---------------- noun：词库 ----------------
+async function cmdNoun(args, json) {
+  const skill = need("skill", args);
+  const q = new URLSearchParams({ skillKey: skill });
+  if (args["source-type"]) q.append("sourceType", args["source-type"]);
+  if (args["source-group"]) q.append("sourceGroupId", args["source-group"]);
+  if (args["source-table"]) q.append("sourceTableId", args["source-table"]);
+  const r = await getUrl("/api/dw/newetl/chatBi/skill/getChatDocsBySkillKey?" + q.toString());
+  if (json) return r;
+  const data = r.data;
+  if (!data || !data.nouns) {
+    console.log("(该 skill 词库不存在或为空) msg=" + (r.msg || ""));
+    return;
+  }
+  console.log("== 名词解释 " + data.nouns.length + " 条 (skill=" + skill + ") ==");
+  for (const n of data.nouns) {
+    console.log("【" + (n.keyword || "") + "】" + (n.synonyms ? " 同义:" + n.synonyms : ""));
+    if (n.wordExplain) console.log("  " + String(n.wordExplain).replace(/\n/g, " "));
+  }
+}
+
+// ---------------- field：关联字段翻译 ----------------
+function customParamFromArgs(args) {
+  if (args["form-param"]) return { formParam: args["form-param"] };
+  if (args["eb-browser-param"]) return { ebBrowserForEditParam: readJsonArg(args["eb-browser-param"], "--eb-browser-param") };
+  if (args["property-type"]) return { propertyType: args["property-type"] };
+  return {};
+}
+function extractRemoteRows(r, browserType) {
+  const remote = r.remote || {};
+  const keys = Object.keys(remote);
+  const out = [];
+  for (const k of keys) {
+    if (Array.isArray(remote[k])) for (const it of remote[k]) out.push({ key: k, id: it.id, content: it.content ?? it.name ?? "" });
+  }
+  return out;
+}
+async function cmdFieldId2name(args, json) {
+  const module = need("module", args), type = need("type", args), idsVal = need("ids", args);
+  const dataIds = idsVal.split(",").map((s) => s.trim()).filter(Boolean);
+  const body = [{ module, browserType: type, dataIds, user: USER, customParam: customParamFromArgs(args) }];
+  const r = await postJson("/api/bcw/test/testRemoteBrowser", body);
+  if (json) return r;
+  const rows = extractRemoteRows(r, type);
+  if (!rows.length) {
+    const nf = (r.notFound || {});
+    const list = nf && nf[module + "_" + type] && nf[module + "_" + type].ids ? nf[module + "_" + type].ids : [];
+    console.log("(未翻译到名称) notFound ids: " + (list.join(",") || "全部"));
+    return;
+  }
+  printHuman("id→name (" + rows.length + "/" + dataIds.length + ")", rows, ["id", "content"]);
+}
+async function cmdFieldName2id(args, json) {
+  const module = need("module", args), type = need("type", args), name = need("name", args);
+  const body = { newly: 1, searchValue: name, ...customParamFromArgs(args) };
+  const url = "/api/" + module + "/common/browser/complete/" + type;
+  const r = await postJson(url, body);
+  if (json) return r;
+  const rows = ((r.data || {}).data) || [];
+  if (!rows.length) { console.log("(未匹配到名称对应 ID)"); return; }
+  printHuman("name→id 候选 " + rows.length + " 条", rows.map((x) => ({ id: x.id, name: x.name ?? x.title ?? "" })), ["id", "name"]);
+}
+
+// ---------------- exp：专家包版本管理（expert-repository） ----------------
+async function expGet(url) {
+  // 返回 {raw, j}：raw 用于正则提取大整数 id（commitId 19 位超 JS Number 精度，JSON.parse 会丢精度！）
+  const resp = await fetch(BASE + url, {
+    method: "GET",
+    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)); }
+  if (resp.status === 401 || (j && String(j.code) === "-1" && /token|登录|失效/i.test(String(j.msg || "")))) throw new Error("登录态失效，请重新 e10-login oidc 登录");
+  return { raw, j };
+}
+function rawNum(raw, key) {
+  // 从原始 JSON 文本提取整数字段为精确字符串（避免 JSON.parse 大数丢精度，如 commitId）
+  const m = raw.match(new RegExp('"' + key + '":\\s*(\\d+)'));
+  return m ? m[1] : "";
+}
+function rawNumSeq(raw, key) {
+  // 提取某 key 全部整数序列（按出现顺序），如提交历史里的 commitId
+  const re = new RegExp('"' + key + '":\\s*(\\d+)', "g");
+  const out = []; let m;
+  while ((m = re.exec(raw)) !== null) out.push(m[1]);
+  return out;
+}
+const EXP_ALLOWED_DIRS = [".codebuddy-plugin", "agents", "avatars", "skills"];
+const EXP_SKIP_DIRS = [".git", ".workbuddy", "node_modules", "__pycache__"];
+function sha256(buf) { return crypto.createHash("sha256").update(buf).digest("hex"); }
+function walkDir(dir, root) {
+  const out = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const abs = path.join(dir, entry.name);
+    const rel = path.relative(root, abs).split(path.sep).join("/");
+    if (entry.isDirectory()) {
+      if (EXP_SKIP_DIRS.includes(entry.name)) continue;
+      const top = rel.split("/")[0];
+      if (rel.includes("/") && !EXP_ALLOWED_DIRS.includes(top)) continue; // 仅允许根文件+四大目录
+      walkDir(abs, root).forEach((x) => out.push(x));
+    } else if (entry.isFile()) {
+      const top = rel.split("/")[0];
+      if (!rel.includes("/") || EXP_ALLOWED_DIRS.includes(top)) out.push({ rel, abs });
+    }
+  }
+  return out;
+}
+function collectPackage(dir) {
+  if (!fs.existsSync(dir)) throw new Error("本地专家包目录不存在: " + dir);
+  return walkDir(dir, dir).map(({ rel, abs }) => {
+    const buf = fs.readFileSync(abs);
+    if (buf.length > 10 * 1024 * 1024) throw new Error("文件超 10MB 上限: " + rel);
+    return { relativePath: rel, contentBase64: buf.toString("base64"), sha256: sha256(buf), abs };
+  });
+}
+function localShaMap(dir) {
+  const map = {};
+  for (const f of walkDir(dir, dir)) map[f.rel] = sha256(fs.readFileSync(f.abs));
+  return map;
+}
+function expOk(r) {
+  if (!r) return false;
+  if (r.actionMsg) return String(r.actionMsg.code) === "0";
+  const code = r.code;
+  if (code === undefined) return !r.fail;
+  return String(code) === "0" || String(code) === "200";
+}
+function expFailMsg(r) {
+  if (r && r.actionMsg && String(r.actionMsg.code) !== "0") return r.actionMsg.message;
+  if (r && r.msg) return r.msg;
+  return "请求失败";
+}
+function printExpData(r, title) {
+  if (!expOk(r)) throw new Error(expFailMsg(r));
+  if (title) console.log("== " + title + " ==");
+  console.log(JSON.stringify(r.data ?? {}, null, 1));
+}
+async function rawGet(url) {
+  const resp = await fetch(BASE + url, {
+    method: "GET",
+    headers: { "accept": "*/*", "langType": "zh_CN", "cookie": auth.cookie, "eteamsid": auth.eteamsid, "ebbusinessid": EB_BIZ_ID, "user-agent": UA },
+  });
+  if (resp.status === 401) throw new Error("登录态失效，请重新 e10-login oidc 登录");
+  return Buffer.from(await resp.arrayBuffer());
+}
+async function expStatus(args, json) {
+  const expert = need("expert", args);
+  const { raw, j: r } = await expGet("/api/dw/expert-repository/v1/repositories/status?expertCode=" + encodeURIComponent(expert) + "&branchName=" + (args.branch || "main"));
+  if (json) return r;
+  if (!expOk(r)) throw new Error(expFailMsg(r));
+  const d = r.data || {};
+  console.log("== 仓库状态 " + expert + " ==");
+  console.log("expertCode = " + (d.expertCode ?? ""));
+  console.log("displayName = " + (d.displayName ?? ""));
+  console.log("branchName = " + (d.branchName ?? ""));
+  console.log("headCommitId = " + (rawNum(raw, "headCommitId") || d.headCommitId));
+  console.log("headRevision = " + (d.headRevision ?? ""));
+  for (const k of ["headCommitHash", "headCommitMessage", "headCommitTime", "headAuthor", "protected"]) if (d[k] !== undefined) console.log(k + " = " + d[k]);
+  if (Array.isArray(d.locks) && d.locks.length) { console.log("有效锁:"); for (const l of d.locks) console.log("  " + JSON.stringify(l)); }
+}
+async function expManifest(args, json) {
+  const expert = need("expert", args);
+  let url = "/api/dw/expert-repository/v1/repositories/manifest?expertCode=" + encodeURIComponent(expert) + "&branchName=" + (args.branch || "main");
+  if (args.commit) url += "&commitId=" + encodeURIComponent(args.commit);
+  const r = await getUrl(url);
+  if (json) return r;
+  if (!expOk(r)) throw new Error(expFailMsg(r));
+  const items = r.data || [];
+  console.log("== 文件清单 " + items.length + " 项 ==");
+  printHuman("", items, ["relativePath", "sha256", "size", "action"]);
+}
+async function expCommits(args, json) {
+  const expert = need("expert", args);
+  const { raw, j: r } = await expGet("/api/dw/expert-repository/v1/repositories/commits?expertCode=" + encodeURIComponent(expert) + "&branchName=" + (args.branch || "main"));
+  if (json) return r;
+  if (!expOk(r)) throw new Error(expFailMsg(r));
+  const rows = (r.data || []).map((x, i) => ({ ...x, commitId: (rawNumSeq(raw, "commitId")[i] || x.commitId) }));
+  console.log("== 提交历史 " + rows.length + " 条（commitId 为精确值，可复制用于 file/release/rollback）==");
+  printHuman("", rows, ["commitId", "submitMode", "author", "createTime", "message"]);
+}
+async function expFile(args, json) {
+  const expert = need("expert", args), commit = need("commit", args), rp = need("path", args);
+  const buf = await rawGet("/api/dw/expert-repository/v1/repositories/file?expertCode=" + encodeURIComponent(expert) + "&commitId=" + encodeURIComponent(commit) + "&relativePath=" + encodeURIComponent(rp));
+  if (args.out) { fs.writeFileSync(args.out, buf); console.log("已下载 " + buf.length + " 字节 -> " + args.out); return; }
+  if (json) { console.log(JSON.stringify({ relativePath: rp, size: buf.length, base64: buf.toString("base64") })); return; }
+  process.stdout.write(buf.toString("utf-8"));
+}
+async function expPull(args, json) {
+  const expert = need("expert", args), dir = need("dir", args);
+  const dry = !!args["dry-run"];
+  const st = await expGet("/api/dw/expert-repository/v1/repositories/status?expertCode=" + encodeURIComponent(expert) + "&branchName=" + (args.branch || "main"));
+  if (!expOk(st.j)) throw new Error(expFailMsg(st.j));
+  const headId = rawNum(st.raw, "headCommitId") || String((st.j.data || {}).headCommitId);
+  const mf = await expGet("/api/dw/expert-repository/v1/repositories/manifest?expertCode=" + encodeURIComponent(expert) + "&branchName=" + (args.branch || "main"));
+  if (!expOk(mf.j)) throw new Error(expFailMsg(mf.j));
+  const items = (mf.j.data || []).filter((f) => f.relativePath && f.relativePath !== "DELETE");
+  const local = fs.existsSync(dir) ? localShaMap(dir) : {};
+  let downloaded = 0, unchanged = 0, changed = 0, missing = 0;
+  const plan = [];
+  for (const it of items) {
+    const lp = path.join(dir, it.relativePath.split("/").join(path.sep));
+    const ls = local[it.relativePath];
+    if (ls === it.sha256) { unchanged++; continue; }
+    changed++;
+    if (ls === undefined) missing++;
+    plan.push({ rel: it.relativePath, lp, sha: it.sha256, size: it.size });
+    if (dry) continue;
+    fs.mkdirSync(path.dirname(lp), { recursive: true });
+    const buf = await rawGet("/api/dw/expert-repository/v1/repositories/file?expertCode=" + encodeURIComponent(expert) + "&commitId=" + encodeURIComponent(headId) + "&relativePath=" + encodeURIComponent(it.relativePath));
+    fs.writeFileSync(lp, buf);
+    downloaded++;
+  }
+  const out = { expert, headCommitId: headId, total: items.length, unchanged, changed, downloaded, missing, dryRun: !!dry };
+  if (json) { console.log(JSON.stringify(out)); return; }
+  console.log("== pull " + expert + "@" + headId + (dry ? " (dry-run)" : "") + " ==");
+  console.log("清单 " + out.total + " 项 | 未变 " + unchanged + " | 需更新 " + changed + "（缺失 " + missing + "）" + (dry ? "（dry-run 未下载）" : " | 已下载 " + downloaded));
+  for (const p of plan.slice(0, 30)) console.log("  " + (dry ? "[待下载]" : "[已下载]") + " " + p.rel + " (" + p.sha.slice(0, 12) + "…)");
+  if (plan.length > 30) console.log("  ... 共 " + plan.length + " 个文件待更新");
+}
+async function expInit(args, json) {
+  const expert = need("expert", args), dir = need("dir", args);
+  const files = collectPackage(dir);
+  const body = { expertCode: expert, displayName: args["display-name"] || expert, branchName: args.branch || "main",
+    description: args.description || "", initialCommitMessage: args.message || "初始化导入", files };
+  const r = await postJson("/api/dw/expert-repository/v1/repositories", body);
+  if (json) return r;
+  if (!expOk(r)) throw new Error(expFailMsg(r));
+  console.log("== 仓库已创建 =="); console.log(JSON.stringify(r.data ?? {}, null, 1));
+}
+async function expCommit(args, json) {
+  const expert = need("expert", args), dir = need("dir", args), msg = need("message", args);
+  const mode = (args.mode || "FULL_SNAPSHOT").toUpperCase();
+  const st = await expGet("/api/dw/expert-repository/v1/repositories/status?expertCode=" + encodeURIComponent(expert) + "&branchName=" + (args.branch || "main"));
+  if (!expOk(st.j)) throw new Error("无法获取基线: " + expFailMsg(st.j));
+  const base = st.j.data || {};
+  const body = {
+    branchName: base.branchName || "main",
+    baseCommitId: rawNum(st.raw, "headCommitId") || String(base.headCommitId), // 精确字符串，避免大数丢精度
+    baseRevision: base.headRevision,
+    commitMessage: msg,
+  };
+  if (mode === "FILE_PATCH") {
+    const mf = await expGet("/api/dw/expert-repository/v1/repositories/manifest?expertCode=" + encodeURIComponent(expert) + "&branchName=" + (args.branch || "main"));
+    if (!expOk(mf.j)) throw new Error("无法获取 manifest: " + expFailMsg(mf.j));
+    const remoteSha = {}; for (const f of (mf.j.data || [])) remoteSha[f.relativePath] = f.sha256;
+    const local = collectPackage(dir);
+    const localSha = {}; for (const f of local) localSha[f.relativePath] = f.sha256;
+    const changes = [];
+    for (const f of local) {
+      const rs = remoteSha[f.relativePath];
+      if (rs === undefined) changes.push({ operation: "ADD", relativePath: f.relativePath, contentBase64: f.contentBase64, sha256: f.sha256, baseFileSha256: "" });
+      else if (rs !== f.sha256) changes.push({ operation: "MODIFY", relativePath: f.relativePath, contentBase64: f.contentBase64, sha256: f.sha256, baseFileSha256: rs });
+    }
+    for (const rp of Object.keys(remoteSha)) if (localSha[rp] === undefined) changes.push({ operation: "DELETE", relativePath: rp, baseFileSha256: remoteSha[rp] });
+    if (!changes.length) throw new Error("本地与远端一致，无变更可提交");
+    body.submitMode = "FILE_PATCH"; body.changes = changes;
+  } else {
+    body.submitMode = "FULL_SNAPSHOT"; body.files = collectPackage(dir);
+  }
+  const r = await postJson("/api/dw/expert-repository/v1/repositories/commits?expertCode=" + encodeURIComponent(expert), body);
+  if (json) return r;
+  if (!expOk(r)) {
+    const m = expFailMsg(r);
+    if (/基线|过期|revision|冲突/i.test(m)) throw new Error("提交冲突: " + m + " —— 请先 exp pull 拉取最新并合并后重试");
+    throw new Error("提交失败: " + m);
+  }
+  console.log("== 提交成功 =="); console.log(JSON.stringify(r.data ?? {}, null, 1));
+}
+async function expLock(args, json) {
+  const expert = need("expert", args);
+  const act = (args.action || "").toLowerCase();
+  const branch = args.branch || "main";
+  if (act === "query") {
+    const r = await getUrl("/api/dw/expert-repository/v1/repositories/locks?expertCode=" + encodeURIComponent(expert) + "&branchName=" + encodeURIComponent(branch));
+    if (json) return r;
+    if (!expOk(r)) throw new Error(expFailMsg(r));
+    printExpData(r, "有效锁");
+    return;
+  }
+  const token = need("lock-token", args);
+  if (act === "heartbeat") {
+    const r = await postJson("/api/dw/expert-repository/v1/repositories/locks/heartbeat?lockToken=" + encodeURIComponent(token), {});
+    if (json) return r;
+    if (!expOk(r)) throw new Error(expFailMsg(r));
+    console.log("锁已续期: " + JSON.stringify(r.data ?? {}));
+    return;
+  }
+  if (act === "release") {
+    const req = new Request(BASE + "/api/dw/expert-repository/v1/repositories/locks?lockToken=" + encodeURIComponent(token), { method: "DELETE" });
+    const resp = await fetch(req, { headers: { "cookie": auth.cookie, "eteamsid": auth.eteamsid, "accept": "application/json" } });
+    const text = await resp.text();
+    let r; try { r = JSON.parse(text); } catch { r = { data: { raw: text } }; }
+    if (json) return r;
+    if (!expOk(r)) throw new Error(expFailMsg(r));
+    console.log("锁已释放");
+    return;
+  }
+  // acquire（默认）
+  const body = { branchName: branch, componentKey: args.component || "ROOT", ttlMinutes: parseInt(args.ttl || "30", 10) };
+  const r = await postJson("/api/dw/expert-repository/v1/repositories/locks?expertCode=" + encodeURIComponent(expert), body);
+  if (json) return r;
+  if (!expOk(r)) throw new Error(expFailMsg(r));
+  console.log("== 锁已获取（记录 lockToken 供 heartbeat/release/commit 使用）==");
+  console.log(JSON.stringify(r.data ?? {}, null, 1));
+}
+async function expRelease(args, json) {
+  const expert = need("expert", args);
+  const r = await postJson("/api/dw/expert-repository/v1/repositories/releases?expertCode=" + encodeURIComponent(expert),
+    { commitId: need("commit", args), versionTag: need("version", args), releaseNote: args.note || "" });
+  if (json) return r;
+  if (!expOk(r)) throw new Error(expFailMsg(r));
+  console.log("== 发布成功 =="); console.log(JSON.stringify(r.data ?? {}, null, 1));
+}
+async function expRollback(args, json) {
+  const expert = need("expert", args);
+  const r = await postJson("/api/dw/expert-repository/v1/repositories/releases/rollback?expertCode=" + encodeURIComponent(expert) + "&versionTag=" + encodeURIComponent(need("version", args)), {});
+  if (json) return r;
+  if (!expOk(r)) throw new Error(expFailMsg(r));
+  console.log("== 回滚成功 =="); console.log(JSON.stringify(r.data ?? {}, null, 1));
+}
+
+// ---------------- main ----------------
+function usage() {
+  console.log(`e10-data CLI（data-assistant 数据接口统一命令行，2026-09-03 扩展）
+用法: 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|'{...}'
+ds      数据源（业务模块）取数与元数据
+  ds tables  --group <gid> [--name 关键词]
+  ds fields  --group <gid> --table <tid>
+  ds list    --group <gid> --table <tid> --fields a,b [--where @f|json] [--order "f asc"] [--page N] [--size N]
+  ds chart   --group <gid> --table <tid> --group-by g1,g2 --stat '[{"fieldId":"x","aggregator":"SUM"}]' [--where ...]
+  ds stat    --group <gid> --table <tid> --stat '[...]' [--where ...]
+  ds count   --group <gid> --table <tid> [--where ...]
+  （ds 通用 --source-type LOGIC|ETEAMS，默认 LOGIC）
+doc     文档查询
+  doc count  [--name 关键词] [--creator id1,id2] [--author id1,id2] [--content-type office] [--time "起~止"] [--last-time "起~止"] [--folder id,id|--folder-neq id,id]
+  doc list   [同上条件] [--all 翻页到底] [--page N] [--size 100]
+noun    词库查询
+  noun list --skill <skillKey> [--source-type LOGIC] [--source-group gid] [--source-table tid]（数据源场景带三参数）
+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 名称 [同上附加参数]
+exp     专家包版本管理（expert-repository/v1，响应以 data.actionMsg.code=0 判成功）
+  exp status    --expert <code> [--branch main]                       # 仓库状态（headCommitId/headRevision=提交基线）
+  exp manifest  --expert <code> [--commit <id>]                       # 文件清单（sha256）
+  exp commits   --expert <code>                                       # 提交历史
+  exp file      --expert <code> --commit <id> --path <相对路径> [--out 本地文件]
+  exp pull      --expert <code> --dir <本地专家包目录> [--dry-run]     # 按 manifest sha 差异下载缺失/不一致文件
+  exp init      --expert <code> --dir <本地目录> [--display-name X] [--message 初始化导入]
+  exp commit    --expert <code> --dir <本地目录> --message "..." [--mode FULL_SNAPSHOT|FILE_PATCH]
+  exp lock      --expert <code> --action query|acquire(默认)|heartbeat|release --component ROOT --ttl 30 --lock-token <token>
+  exp release   --expert <code> --commit <id> --version vX.Y.Z [--note 说明]
+  exp rollback  --expert <code> --version vX.Y.Z
+认证: 读 ~/.workbuddy/e10-login-cache.md；失效请先 e10-login oidc`);
+}
+
+async function main() {
+  const rawArgv = process.argv.slice(2);
+  if (rawArgv.includes("--version") || rawArgv.includes("-v") || rawArgv.includes("version")) {
+    console.log("e10-data " + cliVersion());
+    process.exit(0);
+  }
+  const { args, pos } = parseArgs(rawArgv);
+  if (!pos.length) { usage(); process.exit(1); }
+  const family = pos[0], sub = pos[1], json = !!args.json;
+  let result;
+  if (family === "ds") {
+    if (!sub) { usage(); process.exit(1); }
+    switch (sub) {
+      case "tables": result = await cmdTables(args, json); break;
+      case "fields": result = await cmdFields(args, json); break;
+      case "list": result = await cmdList(args, json); break;
+      case "chart": result = await cmdChart(args, json); break;
+      case "stat": result = await cmdStat(args, json); break;
+      case "count": result = await cmdCount(args, json); break;
+      default: usage(); process.exit(1);
+    }
+  } else if (family === "query") {
+    result = await cmdQuery(args, json);
+  } else if (family === "doc") {
+    if (sub === "count") result = await cmdDocCount(args, json);
+    else if (sub === "list") result = await cmdDocList(args, json);
+    else { usage(); process.exit(1); }
+  } else if (family === "noun") {
+    if (sub === "list") result = await cmdNoun(args, json);
+    else { usage(); process.exit(1); }
+  } else if (family === "field") {
+    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 === "exp") {
+    if (!sub) { usage(); process.exit(1); }
+    switch (sub) {
+      case "status": result = await expStatus(args, json); break;
+      case "manifest": result = await expManifest(args, json); break;
+      case "commits": result = await expCommits(args, json); break;
+      case "file": result = await expFile(args, json); break;
+      case "pull": result = await expPull(args, json); break;
+      case "init": result = await expInit(args, json); break;
+      case "commit": result = await expCommit(args, json); break;
+      case "lock": result = await expLock(args, json); break;
+      case "release": result = await expRelease(args, json); break;
+      case "rollback": result = await expRollback(args, json); break;
+      default: usage(); process.exit(1);
+    }
+  } else { usage(); process.exit(1); }
+  if (json && result !== undefined) console.log(JSON.stringify(result, null, 1));
+}
+main().catch((e) => { console.error("ERROR: " + e.message); process.exit(1); });

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "e10-data",
+  "version": "0.1.0",
+  "description": "泛微 E10 数据接口统一 CLI（data-assistant 专家配套）：DSL 查询/数据源/文档/词库/关联字段翻译/专家包版本管理，认证复用 weaver-e10-login 登录态",
+  "author": "e10-dw",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "e10-data": "bin/e10-data.mjs"
+  },
+  "main": "bin/e10-data.mjs",
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "keywords": [
+    "weaver",
+    "e10",
+    "ecology",
+    "cli",
+    "data",
+    "泛微"
+  ],
+  "scripts": {
+    "pack": "npm pack"
+  }
+}