e10-data 0.1.13 → 0.1.14

package/README.md

@@ -112,33 +112,37 @@ e10-data conf delete GET_WORKFLOW_LIST --type api --group workflow
 - 同一 `confKey` 可存在于多个 `confGroup`；`conf batch` / `batch-file` 的返回映射在带分组时以 `组|键` 为键，不会互相覆盖。
 - `--json` 输出：`conf group` 返回配置数组（带 `--key` 时返回单条），`conf batch` 返回映射对象。
 
-## ds appId 自动解析（v0.1.13 新增）
+## ds appId：由调用方显式传入（v0.1.14 变更，自动解析已移除）
 
-ChatBI 数据源取数接口（`getListDatas` / `getChartDatas` / `getStatDatas` / `getCountData`）对**部分 EB 应用（独立部署）**的数据集，必须在 `queryDto` 中携带 `appId`，否则后端一律返回 `code=500 请求失败`（实测：小餐厅应用 `840360791696547845` 名下 4 张表不传全 500、传即 200；低代码大赛等应用不传也正常）。
+ChatBI 数据源取数接口（`getListDatas` / `getChartDatas` / `getStatDatas` / `getCountData`）对**部分 EB 应用（独立部署）**的数据集，必须在 `queryDto` 中携带 `appId`，否则后端一律返回 `code=500 请求失败`（实测：小餐厅应用 `840360791696547845` 名下 4 张表不传全 500、传即 200；低代码大赛等应用不传也正常，**显式传其真实 appId 同样返回 200**）。
 
-`e10-data ds list|chart|stat|count` **默认自动解析并带上 appId**，解析顺序（**每次实时查，不做本地缓存**）：
+> ⚠️ **v0.1.14 行为变更（breaking）**：v0.1.13 的「自动解析 appId」已**整体移除**。原因：`chat_bi_eb_config_map` 是**权限表**——它的行代表「谁有权限查哪张表」，`app_id` 只是该行的附带字段。appId 应是**权限校验那一次查询的产物**，不应由 CLI 另开一条查询去反查（否则等于把权限表当普通字典使用，且 appId 来源对调用者不可见）。同步移除的还有 `ebdf_obj` 兜底来源（该表无权限语义）。
 
-1. `--app-id <id>` 显式指定（最高优先，0 额外请求）；
-2. **`chat_bi_eb_config_map`**（`dw` 库权限配置表，按 `obj_id = tableId` 取 `app_id`）—— **主来源**；
-3. **`ebdf_obj`**（`ec_edcapp` 库 EB 元数据表，按 `id = tableId` 取 `app_id`）—— 兜底；
-4. 都取不到 → 不带 appId 发送（兼容旧行为）。
+**正确姿势：先权限校验（顺带取到 appId），再显式传入取数。**
+
+**① 调用方（技能 / Agent）先做权限校验**，一条 DSL 同时得到「有没有权限」与「要带的 appId」：
 
 ```bash
-# 默认：自动解析（推荐）
-e10-data ds count --group weaver-ebuilder-form-service --table 840360795890851856
+# ① 权限校验（DSL，dw 库 / #{CONN_DW}）：obj_id 命中 → 有权限；未命中 → 无权限，直接返回提示、不取数
+#    SELECT obj_id, app_id FROM chat_bi_eb_config_map
+#    WHERE delete_type=0 AND tenant_key=<租户> AND enabled=1 AND (all_scop=1 OR target_id=<当前人员ID>)
 
-# 显式指定（跳过解析，最快）
-e10-data ds count --group weaver-ebuilder-form-service --table 840360795890851856 --app-id 840360791696547845
+# ② 取数：EB 建模表单必须带 --app-id（值 = ① 中该行的 app_id）
+e10-data ds count  --group weaver-ebuilder-form-service --table 840360795890851856 --app-id 840360791696547845
+e10-data ds fields --group weaver-ebuilder-form-service --table 840360795890851856 --app-id 840360791696547845
 
-# 完全跳过自动解析（明确不需要 appId 的数据集，省两次解析往返）
-e10-data ds count --group weaver-ebuilder-form-service --table 1081139888007225347 --no-app-id
+# 非 EB 数据集：无需 appId，照常调用
+e10-data ds count  --group weaver-project-servicetask --table 715738355537494016
 
-# 查看某张表的 appId：ds tables 输出含 appId 列（服务端返回字段，仅展示用）
+# 查看某张表的 appId：ds tables 输出含 appId 列（服务端返回字段，仅展示用，与取数参数无关）
 e10-data ds tables --group weaver-ebuilder-form-service --name 低代码大赛
 ```
 
-> 解析走两条 DSL：`chat_bi_eb_config_map` 用 `#{CONN_DW}`、`ebdf_obj` 用 `#{CONN_EC_EDCAPP}`（占位符由 CLI 内部向配置中心解析；解析不到则跳过该来源）。
-> 实测：小餐厅 4 张表的 appId 均由主来源 `chat_bi_eb_config_map` 直接拿到；解析失败的场景（非 EB 数据集）两次往返的耗时影响可忽略（冷启动 3.7s ≈ `--no-app-id` 基线 3.7s）。
+> - 仅 **EB 建模表单分组（`weaver-ebuilder-form-service`）** 需要 appId；其他数据集传了也无害。
+> - **不传时 CLI 不做拦截**（即使 EB 分组）：按原样发送，由后端报错（与后端行为一致）。
+> - `--app-id auto` / `--no-app-id` 自 v0.1.14 起为**空操作**（等同不传），仅为兼容旧脚本保留参数位。
+> - 同一 appId 覆盖同一应用下的多张表（实测小餐厅 4 张表共用 `840360791696547845`），按 `obj_id` 从权限表取到即可直接复用。
+> - 权限校验查询走 `#{CONN_DW}`（占位符由 CLI 向配置中心解析）；该表需在 DSL 表授权白名单内。
 
 ## ds --where 过滤条件（v0.1.8 起支持树形 OR）
 

package/bin/e10-data.mjs

@@ -6,9 +6,10 @@
  * 覆盖（数据查询链路全部家族；登录/HRM 复用 e10-login / hrm-cli，checkEbModulePermission 已废弃不提供）：
  *   e10-data query    DSL 查询 executeQueryDsl（conn/model/schema/tableId/dslQuery/debug）
  *   e10-data ds     tables|fields|list|chart|stat|count   数据源（业务模块）取数与元数据
- *                   取数（list/chart/stat/count）自动解析并携带 queryDto.appId（v0.1.13）：
- *                   顺序 chat_bi_eb_config_map(dw，按 obj_id) → ebdf_obj(ec_edcapp，按 id)，实时查、不缓存；
- *                   --app-id <id> 显式指定 / --app-id auto 强制自动 / --no-app-id 跳过（最快）
+ *                   appId 一律由调用方显式传入（v0.1.14 起 CLI 不再自动反查）：
+ *                   EB 建模表单（groupId=weaver-ebuilder-form-service）取数必须带 --app-id <id>，
+ *                   该值只能来自 chat_bi_eb_config_map 的权限校验查询（同一次查询给出权限与 appId）；
+ *                   不带 appId 时按原样发送，由后端报错（CLI 不做拦截）
  *   e10-data doc    count|list   文档查询 documentListCount / documentList
  *   e10-data noun   list         词库 getChatDocsBySkillKey
  *   e10-data field  id2name|name2id  关联字段翻译 testRemoteBrowser / complete
@@ -496,51 +497,24 @@ function parseOrder(val) {
     return { fieldId: f, fieldName: f, objId: "", isAsc: (dir || "asc").toLowerCase() !== "desc", mainField: true };
   });
 }
-// ---------------- ds appId 自动解析（v0.1.13）----------------
+// ---------------- ds appId：一律显式传入（v0.1.14，2026-09-11 用户确认调整）----------------
 // 背景：ChatBI 数据源取数接口（getListDatas / getChartDatas / getStatDatas / getCountData）
 // 对部分 EB 应用（独立部署）的数据集必须携带 queryDto.appId，否则后端一律返回 code=500。
-// 解析顺序（无缓存，每次实时查）：--app-id <id> 显式 > chat_bi_eb_config_map（dw 权限配置表，按 obj_id，主来源）
-//   > ebdf_obj（ec_edcapp，按 id，兜底） > 不带 appId 发送（兼容旧行为）。
-// 关闭自动解析：--no-app-id。
-const APPID_SOURCES = [
-  { confKey: "CONN_DW", model: "dw", schema: "dw", table: "chat_bi_eb_config_map", idField: "obj_id" },
-  { confKey: "CONN_EC_EDCAPP", model: "ebuilder", schema: "ec_edcapp", table: "ebdf_obj", idField: "id" },
-];
+// 设计：appId 属「权限校验」的产物 —— 调用方先查 dw.chat_bi_eb_config_map 判权限（无权限即终止），
+//   同一条记录的 app_id 即本次取数必须携带的 appId，再显式传入本 CLI：
+//   → CLI 不再自行反查 appId（v0.1.13 的「chat_bi_eb_config_map → ebdf_obj 自动解析」已整体移除），
+//     避免把权限表当普通字典使用、也避免 appId 来源不可见；
+//   → 仅 EB 建模表单（groupId = weaver-ebuilder-form-service）需要 appId，其它数据集可不传；
+//   → 不传也**不做拦截**，由后端按原样报错。
 function dsFieldsForm(gid, tid, st) {
   return { groupId: gid, sourceId: tid, sourceType: st, detailFieldsGroup: "true", enableMerge: "true", needTableName: "true", params: "[]" };
 }
-async function appIdByDsl(src, tid) {
-  const conn = await confGetData("conn", src.confKey, true);
-  const connId = (conn && conn.confValue) ? String(conn.confValue) : "";
-  if (!connId) return "";
-  const dslQuery = {
-    select: { columns: [{ field: "t1.app_id", alias: "app_id" }] },
-    from: { table: src.table, alias: "t1" },
-    where: { logic: "AND", conditions: [{ field: "t1." + src.idField, op: "=", value: String(tid) }, { field: "t1.delete_type", op: "=", value: 0 }] },
-    limit: { size: 1, offset: 0 },
-  };
-  const r = await postJson("/api/dw/dsl/executeQueryDsl", { connId, model: src.model, schema: src.schema, tableId: "", dslQuery });
-  const rows = Array.isArray(r && r.data) ? r.data : [];
-  return (rows[0] && rows[0].app_id) ? String(rows[0].app_id) : "";
-}
-async function resolveDsAppId(tid) {
-  for (const src of APPID_SOURCES) {
-    let appId = "";
-    try { appId = await appIdByDsl(src, tid); } catch { appId = ""; }
-    if (appId) return appId;
-  }
-  return "";
-}
-// ds 取数统一入口：--app-id <id> 显式 / --app-id auto 或省略=自动解析 / --no-app-id 跳过
+// ds 取数统一入口：appId 只认显式 --app-id <id>
+// （--app-id auto / --no-app-id 一律视为未传：v0.1.14 起不再自动解析，也不做缺失拦截）
 async function dsDto(args, tid, gid, pageNo, pageSize, queryType) {
   const dto = baseDto(tid, gid, pageNo, pageSize, queryType);
-  const explicit = args["app-id"];
-  if (typeof explicit === "string" && explicit !== "" && explicit !== "auto") {
-    dto.appId = explicit;
-  } else if (!args["no-app-id"]) {
-    const appId = await resolveDsAppId(tid);
-    if (appId) dto.appId = String(appId);
-  }
+  const appId = args["app-id"];
+  if (typeof appId === "string" && appId !== "" && appId !== "auto") dto.appId = appId;
   return dto;
 }
 async function cmdTables(args, json) {
@@ -1403,16 +1377,17 @@ function usage() {
 query   DSL 数据查询 executeQueryDsl
   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>
-  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 tables  --group <gid> [--name 关键词] [--app-id <id>]
+  ds fields  --group <gid> --table <tid> [--app-id <id>]
+  ds list    --group <gid> --table <tid> --fields a,b [--where @f|json] [--order "f asc"] [--page N] [--size N] [--app-id <id>]
+  ds chart   --group <gid> --table <tid> --group-by g1,g2 --stat @f.json [--where ...] [--app-id <id>]
+  ds stat    --group <gid> --table <tid> --stat @f.json [--where ...] [--app-id <id>]
+  ds count   --group <gid> --table <tid> [--where ...] [--app-id <id>]
   （ds 通用 --source-type LOGIC|ETEAMS，默认 LOGIC）
-  （ds 取数 list|chart|stat|count 的 appId：默认自动解析并带上——顺序 chat_bi_eb_config_map（dw 权限配置表，按 obj_id）
-     → ebdf_obj（ec_edcapp，按 id），每次实时查、不缓存；也可 --app-id <id> 显式指定、--app-id auto 强制自动、
-     --no-app-id 完全跳过自动解析（最快，适用于无需 appId 的数据集）；ds tables/fields 也接受 --app-id）
+  （ds 取数的 appId：一律**显式传入** --app-id <id>（v0.1.14 起 CLI 不再自动反查）。
+     EB 建模表单（groupId=weaver-ebuilder-form-service）必须带：该值取自 chat_bi_eb_config_map 的权限校验查询
+     ——调用方先查权限（无权限即终止、不取数），同一条记录的 app_id 即本次必带的 appId；
+     其他数据集可不传，CLI 不拦截、以接口报错为准；--app-id auto / --no-app-id 已废弃，等同不传）
   --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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "e10-data",
-  "version": "0.1.13",
-  "description": "泛微 E10 数据接口统一 CLI（data-assistant 专家配套）：DSL 查询/数据源/文档/词库/关联字段翻译/环境参数配置中心(conf，支持 confGroup 分组)/专家包版本管理；ds 取数（list/chart/stat/count）自动解析并携带 queryDto.appId（v0.1.13，chat_bi_eb_config_map → ebdf_obj；--app-id 显式/--no-app-id 跳过）；认证加解密全部交由 weaver-e10-login（本 CLI 不再自行解密，通过 e10-login 命令出口获取凭据）",
+  "version": "0.1.14",
+  "description": "泛微 E10 数据接口统一 CLI（data-assistant 专家配套）：DSL 查询/数据源/文档/词库/关联字段翻译/环境参数配置中心(conf，支持 confGroup 分组)/专家包版本管理；ds 取数（list/chart/stat/count）的 appId 由调用方显式传入 --app-id（v0.1.14 起 CLI 不再自动反查；EB 建模表单 weaver-ebuilder-form-service 必须带，appId 取自 chat_bi_eb_config_map 权限校验）；认证加解密全部交由 weaver-e10-login（本 CLI 不再自行解密，通过 e10-login 命令出口获取凭据）",
   "author": "e10-dw",
   "license": "MIT",
   "type": "module",