e10-data 0.1.6 → 0.1.8

package/README.md

@@ -9,7 +9,7 @@ npm i -g e10-data        # 全局安装
 e10-data --version       # 验证
 ```
 
-> 依赖：认证复用 `weaver-e10-login` 的登录态（用户级缓存 `~/.workbuddy/e10-login-cache.md`）。请先安装并登录 weaver-e10-login（`e10-login oidc`），登录态失效时 CLI 会提示重新登录。
+> 依赖：认证复用 `weaver-e10-login` 的登录态。**认证单一权威源 = `~/.e10-cli/profiles/<active>/auth`**（e10-login 统一认证，与所有专家/工具共享）；CLI 进程内读取并解密（AES-256-GCM，seed 与 e10-login 一致），随后自动回写同步明文镜像 `~/.workbuddy/e10-login-cache.md`（仅供查看/兜底）。请先安装并登录 weaver-e10-login（`e10-login oidc`），登录态失效时 CLI 会提示重新登录。
 
 ## 命令总览
 
@@ -29,7 +29,7 @@ e10-data attend  statis   考勤假期余额统计 getAttendInfoStatis（hr-atte
 - `--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`。
+- 认证：优先读权威源 `~/.e10-cli/profiles/<active>/auth`（进程内 AES-256-GCM 解密）并自动同步明文镜像 `~/.workbuddy/e10-login-cache.md`；两者皆无提示先执行 `e10-login oidc`。
 - 版本更新：`npm i -g e10-data@latest`；查看源上最新 `npm view e10-data version`。
 
 ## 用法示例
@@ -53,6 +53,44 @@ e10-data attend statis                          # 查当前登录用户当月假
 e10-data attend statis --user 6264843388578732287 --begin 2026-09-01 --end 2026-09-30
 ```
 
+## ds --where 过滤条件（v0.1.8 起支持树形 OR）
+
+`e10-data ds list|chart|stat|count --where` 接收**条件数组**或**完整条件树**，均可递归嵌套表达 AND/OR：
+
+```bash
+# ① 数组 = AND 根（旧写法，行为不变）：满足全部条件的记录
+e10-data ds count --group <gid> --table <tid> \
+  --where '[{"fieldId":"fieldA","compareType":"range","conditionValue":"2026-09~2026-10"},{"fieldId":"fieldB","compareType":"eq","conditionValue":"1"}]'
+
+# ② 对象 = 完整条件树：relationship "0"=OR、"1"=AND（缺省 AND），conditionList 内可再嵌套条件组
+e10-data ds count --group <gid> --table <tid> \
+  --where '{"relationship":"0","conditionList":[{"fieldId":"fieldA","compareType":"range","conditionValue":"2026-09~2026-10"},{"fieldId":"fieldB","compareType":"range","conditionValue":"2026-09~2026-10"}]}'
+
+# ③ 数组元素内嵌条件组 → 复杂组合，如 (A AND B) OR (C AND D)
+e10-data ds list --group <gid> --table <tid> --fields a,b \
+  --where @cond.json   # 内容见下
+```
+
+```json
+// cond.json —— 组合条件示例
+[
+  { "relationship": "1", "conditionList": [
+      { "fieldId": "A", "compareType": "eq", "conditionValue": "x" },
+      { "fieldId": "B", "compareType": "eq", "conditionValue": "y" } ] },
+  { "relationship": "0", "conditionList": [
+      { "fieldId": "C", "compareType": "eq", "conditionValue": "m" },
+      { "fieldId": "D", "compareType": "eq", "conditionValue": "n" } ] }
+]
+```
+
+要点：
+
+- **叶子字段键**：`fieldId` 与 `conditionId` 均可（fieldId 优先），旧树形 `conditionId` 写法兼容；
+- **relationship**：`"0"`/`0`/`false` = OR，其余 = AND；子节点关系作用于其自身 `conditionList`；
+- 数组顶层恒为 AND 根，需要整体 OR 请用对象形态 `{"relationship":"0","conditionList":[...]}`；
+- 叶子缺少字段会**直接报错**（v0.1.8 起，不再静默产生空条件导致误返回全表）；
+- 其余条件属性（conditionType/compareType/conditionValue/objId/mainField/ignoreCaseMark 等）照旧透传。
+
 ## exp pull 智能拉取（v0.1.4 新增，防本地修改被覆盖）`exp pull` 不再盲目覆盖。CLI 在专家包本地目录维护基线文件 `.sync-state.json`（记录上次同步的 commitId/headRevision 与每文件 sha256），拉取时逐文件三方对比：
 
 | 场景 | 判定 | 处理 |
@@ -69,7 +107,7 @@ e10-data attend statis --user 6264843388578732287 --begin 2026-09-01 --end 2026-
 
 ## attend statis 考勤假期余额（v0.1.5 新增）
 
-封装 E10 考勤 REST 接口 `POST /api/attend/web/attendInfoV2/getAttendInfoStatis`（hr-attendance 场景六：病假/事假/年假余额统计，替代原手工 curl）。认证/绕代理由 CLI 进程内自动完成（读 `~/.workbuddy/e10-login-cache.md`）。
+封装 E10 考勤 REST 接口 `POST /api/attend/web/attendInfoV2/getAttendInfoStatis`（hr-attendance 场景六：病假/事假/年假余额统计，替代原手工 curl）。认证/绕代理由 CLI 进程内自动完成（权威源 `~/.e10-cli/profiles/<active>/auth`）。
 
 ```bash
 e10-data attend statis [--user <人员ID>] [--begin 2026-09-01] [--end 2026-09-30]

package/bin/e10-data.mjs

@@ -14,7 +14,7 @@
  *   e10-data attend statis     考勤假期余额统计 getAttendInfoStatis（hr-attendance 病假/事假，2026-09-07）
  *
  * 通用：--json 原样输出；复杂 JSON 参数支持 @文件 或 内联（中文走 @文件 更稳）
- * 认证：进程内读取用户级登录缓存 ~/.workbuddy/e10-login-cache.md；不存在/失效提示先 e10-login
+ * 认证：进程内读取权威源 ~/.e10-cli/profiles/<active>/auth（e10-login 统一认证，AES-256-GCM seed 硬编码纯 JS 解密，v0.1.7 起），并自动回写同步明文镜像 ~/.workbuddy/e10-login-cache.md；两者皆无时提示先 e10-login
  *
  * 用法示例：
  *   node e10-data.mjs query  --conn 1144919996804022272 --model dw --schema dw --dsl @q.json
@@ -40,19 +40,93 @@ const UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,
 const EB_BIZ_ID = "10000000000000000";
 
 // ---------------- 认证 ----------------
-function loadAuth() {
+// 认证单一权威源：~/.e10-cli/profiles/<active>/auth（e10-login / e10-cli 统一认证，与所有专家共享，无需各自存登录信息）。
+//   AES-256-GCM 加密，seed 与 e10-login 一致（ccw_eteams_auth_v1_8a3f2c1b9e4d → sha256），纯 JS 进程内可解、零外部依赖。
+// 明文镜像：~/.workbuddy/e10-login-cache.md（历史遗留，仅供查看/兜底；读到权威源后自动回写同步，不再需要手工维护）。
+const E10_AUTH_SEED = "ccw_eteams_auth_v1_8a3f2c1b9e4d";
+function decryptAuthWrapper(wrapper) {
+  try {
+    const combined = Buffer.from(wrapper.data, "base64");
+    const IV = 12, TAG = 16;
+    if (combined.length < IV + TAG + 1) return null;
+    const key = crypto.createHash("sha256").update(E10_AUTH_SEED).digest();
+    const decipher = crypto.createDecipheriv("aes-256-gcm", key, combined.subarray(0, IV), { authTagLength: TAG });
+    decipher.setAuthTag(combined.subarray(combined.length - TAG));
+    return JSON.parse(Buffer.concat([decipher.update(combined.subarray(IV, combined.length - TAG)), decipher.final()]).toString("utf-8"));
+  } catch { return null; }
+}
+function parseAuthPayload(raw) {
+  try { // 兼容两种形态：加密 wrapper（{enc:true,data:base64}）与明文 JSON（{cookies,userId,...}）
+    const obj = JSON.parse(raw);
+    if (obj && obj.enc === true && typeof obj.data === "string") return decryptAuthWrapper(obj);
+    if (obj && obj.cookies && (obj.userId || obj.cookies.ETEAMSID)) return obj;
+  } catch {}
+  return null;
+}
+function cookieFromAuthData(data) { // 组装完整 cookie 串：cookies.raw 优先，逐项补齐 langType/agentType/isAgent
+  const eteamsid = (data && data.cookies && data.cookies.ETEAMSID) || "";
+  const agent = (data && (data.agentType || data.agent_type)) || "workbuddy";
+  let c = (data && data.cookies && data.cookies.raw) || "";
+  if (c && !/langType=/.test(c)) c = "langType=zh_CN; " + c;
+  if (c && agent && !/agentType=/.test(c)) c += "; agentType=" + agent;
+  if (c && !/isAgent=/.test(c)) c += "; isAgent=true";
+  if (!c && eteamsid) c = "langType=zh_CN; ETEAMSID=" + eteamsid + "; agentType=" + agent + "; isAgent=true";
+  return { eteamsid, cookie: c };
+}
+function authFromE10Cli() { // ① 权威源：~/.e10-cli/profiles/<active>/auth
+  try {
+    const home = os.homedir();
+    let profile = "default";
+    try {
+      const activeFile = path.join(home, ".e10-cli", "profile");
+      if (fs.existsSync(activeFile)) { const n = fs.readFileSync(activeFile, "utf-8").trim(); if (n) profile = n; }
+    } catch {}
+    const p = path.join(home, ".e10-cli", "profiles", profile, "auth");
+    if (!fs.existsSync(p)) return null;
+    const data = parseAuthPayload(fs.readFileSync(p, "utf-8"));
+    if (!data || !data.cookies || !data.cookies.ETEAMSID || !data.baseUrl) return null;
+    const { eteamsid, cookie } = cookieFromAuthData(data);
+    return { baseUrl: data.baseUrl, eteamsid, cookie, userId: data.userId || "", tenantKey: data.tenantKey || "", profile };
+  } catch { return null; }
+}
+function authFromCacheMd() { // ② 兜底：历史明文缓存 ~/.workbuddy/e10-login-cache.md
   const p = path.join(os.homedir(), ".workbuddy", "e10-login-cache.md");
-  if (!fs.existsSync(p)) throw new Error("未找到登录缓存 " + p + "，请先执行 e10-login oidc / set 登录");
+  if (!fs.existsSync(p)) return null;
   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.baseUrl || !auth.eteamsid) return null;
   if (!auth.cookie) auth.cookie = "langType=zh_CN; ETEAMSID=" + auth.eteamsid + "; agentType=workbuddy; isAgent=true";
   return auth;
 }
+function syncCacheMd(auth) { // 读到权威源后自动回写明文镜像（内容无变化不写盘），根治"重登后手工同步"问题
+  try {
+    const p = path.join(os.homedir(), ".workbuddy", "e10-login-cache.md");
+    if (!fs.existsSync(p) || !/🔐 登录信息缓存/.test(fs.readFileSync(p, "utf-8"))) return; // 非标准缓存文件不动它
+    const d = new Date();
+    const ts = d.getFullYear() + "-" + String(d.getMonth() + 1).padStart(2, "0") + "-" + String(d.getDate()).padStart(2, "0") + " " + String(d.getHours()).padStart(2, "0") + ":" + String(d.getMinutes()).padStart(2, "0");
+    let txt = fs.readFileSync(p, "utf-8");
+    let changed = false;
+    const rep = (key, val) => {
+      const re = new RegExp("(\\*\\*" + key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\*\\*\\s*[:：]\\s*`?)([^`\\n]*)(`?)");
+      const n = txt.replace(re, (m, a, b, c) => { if (b === val && c === "`") return m; changed = true; return a + val + (c || "`"); });
+      txt = n;
+    };
+    rep("baseUrl", auth.baseUrl); rep("ETEAMSID", auth.eteamsid); rep("完整 Cookie 串", auth.cookie); rep("userId", auth.userId || ""); rep("tenantKey", auth.tenantKey || "");
+    rep("缓存记录时间", ts + "（e10-data 自动同步自 ~/.e10-cli/profiles/" + (auth.profile || "") + "/auth）");
+    if (changed) fs.writeFileSync(p, txt, "utf-8");
+  } catch {}
+}
+function loadAuth() {
+  const cli = authFromE10Cli();                       // ① 权威源优先（e10-login 统一认证，多专家共享）
+  if (cli) { syncCacheMd(cli); return cli; }
+  const cached = authFromCacheMd();                   // ② 权威源缺失时回退旧明文缓存
+  if (cached) return cached;
+  throw new Error("未找到登录认证（~/.e10-cli/profiles 与 ~/.workbuddy/e10-login-cache.md 均无），请先执行 e10-login oidc / set 登录");
+}
 const auth = loadAuth();
 const BASE = auth.baseUrl.replace(/\/+$/, "");
 const USER = { id: auth.userId || "", tenantKey: auth.tenantKey || "" };
@@ -247,21 +321,43 @@ function dyn() {
 function baseDto(tableId, groupId, pageNo, pageSize, queryType) {
   return { tableId: String(tableId), groupId, pageNo, pageSize, queryType, containDetailTable: false, needFormat: true, dynamicParams: dyn() };
 }
+// 条件树（conditionTrees）协议：根/组节点 { key, relationship("1"=AND|"0"=OR), isParent:true, parentNode, conditionList:[...] }
+// 叶子节点 { key, relationship:"1", isParent:false, parentNode, conditionId, conditionType, compareType, conditionValue, ... }
+// v0.1.8 起 parseWhere 支持递归树（OR）；向后兼容：数组=AND 根、叶子键 fieldId 优先（conditionId 兼容兜底）
+function normRel(r) { return (r === "0" || r === 0 || r === false) ? "0" : "1"; }
+function isCondGroup(c) { return !!c && Array.isArray(c.conditionList) && c.conditionList.length > 0; }
+function buildCondNode(c, key, parentKey) {
+  if (isCondGroup(c)) {
+    return {
+      key, relationship: normRel(c.relationship), isParent: true, parentNode: parentKey,
+      mainField: c.mainField !== false,
+      conditionList: c.conditionList.map((k, i) => buildCondNode(k, key + "_" + i, key)),
+    };
+  }
+  const fid = (c && (c.fieldId || c.conditionId)) || "";
+  if (!fid) throw new Error("--where 条件缺少字段：叶子须提供 fieldId（或 conditionId），条件组须提供非空 conditionList");
+  return {
+    key, relationship: "1", isParent: false, parentNode: parentKey,
+    objId: c.objId || "", conditionId: fid, fieldName: c.fieldName || fid,
+    conditionType: c.conditionType || "", compareType: c.compareType, conditionValue: c.conditionValue ?? "",
+    fieldValue: c.fieldValue || "", mainField: c.mainField !== false, ignoreCaseMark: c.ignoreCaseMark || false,
+  };
+}
 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 raw = readJsonArg(val, "--where");
+  if (!raw) 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,
-    })),
-  };
+  if (Array.isArray(raw)) { // 数组 → AND 根（元素可为叶子或内嵌条件组，组自带 relationship）
+    const kids = [];
+    raw.forEach((c, i) => { if (c && typeof c === "object") kids.push(buildCondNode(c, rootKey + "_" + i, rootKey)); });
+    if (!kids.length) return null;
+    return { key: rootKey, relationship: "1", isParent: true, parentNode: "", mainField: true, conditionList: kids };
+  }
+  if (typeof raw !== "object") throw new Error("--where 须为条件数组或条件树对象");
+  // 对象形态 = 完整条件树（{relationship, conditionList:[...]}，缺省 AND）；无 conditionList 视为无条件
+  if (!Array.isArray(raw.conditionList) || !raw.conditionList.length) return null;
+  return buildCondNode(raw, rootKey, "");
 }
 function parseStat(val) {
   const arr = readJsonArg(val, "--stat");
@@ -1059,6 +1155,11 @@ ds      数据源（业务模块）取数与元数据
   ds stat    --group <gid> --table <tid> --stat '[...]' [--where ...]
   ds count   --group <gid> --table <tid> [--where ...]
   （ds 通用 --source-type LOGIC|ETEAMS，默认 LOGIC）
+  --where 过滤条件（v0.1.8 起支持树形 OR，递归）：
+    数组 = AND 根： [{"fieldId":"f1","conditionType":"Date","compareType":"range","conditionValue":"2026-09~2026-10"},{"fieldId":"f2",...}]
+    对象 = 完整树： {"relationship":"0","conditionList":[{"fieldId":"f1",...},{"fieldId":"f2",...}]}   # "0"=OR、"1"=AND，缺省 AND
+    数组元素可内嵌条件组 {"relationship":"0","conditionList":[...]} 实现 (A AND B) OR (C AND D)
+    叶子键 fieldId/conditionId 均可（fieldId 优先）；缺少字段的叶子会直接报错（不再静默当全表）
 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]
@@ -1090,7 +1191,7 @@ exp     专家包版本管理（expert-repository/v1，响应以 data.actionMsg.
   exp rollback  --expert <code> --version vX.Y.Z
 attend  考勤 REST 接口（2026-09-07 新增，hr-attendance 病假/事假等假期余额）
   attend statis [--user <人员ID>] [--begin 2026-09-01] [--end 2026-09-30]   # getAttendInfoStatis 假期余额统计；--user 默认当前登录用户，--begin/--end 默认当月
-认证: 读 ~/.workbuddy/e10-login-cache.md；失效请先 e10-login oidc`);
+认证: 优先读权威源 ~/.e10-cli/profiles/<active>/auth（自动同步镜像 ~/.workbuddy/e10-login-cache.md）；皆无请先 e10-login oidc`);
 }
 
 async function main() {

package/package.json

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