@zhoujinandrew/te-cli 1.0.0

package/dist/raw-YVFTDHSI.js

@@ -0,0 +1,59 @@
+import {
+  httpGet,
+  httpPost
+} from "./chunk-KNKRSOCY.js";
+import {
+  printError,
+  printOutput
+} from "./chunk-KM57HI5B.js";
+import {
+  resolveHost
+} from "./chunk-P7NQZGSZ.js";
+import "./chunk-CFCHSAMQ.js";
+
+// src/api/raw.ts
+function registerApi(program) {
+  program.command("api").description("Raw API call: te-cli api <METHOD> <PATH> [options]").argument("<method>", "HTTP method (GET, POST)").argument("<path>", "API path (e.g., /v1/ta/event/catalog/listEvent)").option("--params <json>", "URL parameters as JSON").option("--data <json>", "Request body as JSON").action(async (method, apiPath, opts) => {
+    const globalOpts = program.opts();
+    const host = resolveHost(globalOpts.host);
+    const format = globalOpts.format || "json";
+    const jq = globalOpts.jq;
+    if (!host) {
+      printError("config", "No TE host configured.", "Run: te-cli config set-host");
+      process.exit(1);
+    }
+    try {
+      let params = {};
+      let body = void 0;
+      if (opts.params) {
+        try {
+          params = JSON.parse(opts.params);
+        } catch {
+          printError("validation", `Invalid JSON for --params: ${opts.params}`);
+          process.exit(1);
+        }
+      }
+      if (opts.data) {
+        try {
+          body = JSON.parse(opts.data);
+        } catch {
+          printError("validation", `Invalid JSON for --data: ${opts.data}`);
+          process.exit(1);
+        }
+      }
+      let result;
+      if (method.toUpperCase() === "GET") {
+        result = await httpGet(apiPath, params, host);
+      } else {
+        result = await httpPost(apiPath, params, body, host);
+      }
+      printOutput(result, format, jq);
+    } catch (err) {
+      printError("api", err.message);
+      process.exit(1);
+    }
+  });
+}
+export {
+  registerApi
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@zhoujinandrew/te-cli",
+  "version": "1.0.0",
+  "description": "CLI tool for ThinkingEngine (TE) analytics platform",
+  "type": "module",
+  "bin": {
+    "te-cli": "bin/te-cli.js"
+  },
+  "main": "dist/index.js",
+  "files": ["bin/", "dist/", "skills/", "README.md"],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup src/index.ts --format esm --outDir dist",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "test": "npx tsx src/index.ts --help"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zjandrew/te-cli.git"
+  },
+  "keywords": ["thinkingengine", "analytics", "cli"],
+  "author": "zjandrew",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/skills/te-analysis/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: te-analysis
+version: 1.0.0
+description: "TE 分析查询：报告管理、仪表盘管理、SQL 查询、报告数据查询"
+metadata:
+  requires:
+    bins: ["te-cli"]
+  cliHelp: "te-cli analysis --help"
+---
+
+# te-analysis
+
+> **前置条件:** 使用本技能前，请先阅读 [`te-shared/SKILL.md`](../te-shared/SKILL.md)，了解认证、全局参数和安全约束。
+
+TE 分析域（`te-cli analysis`）提供报告与仪表盘的管理能力，以及通过 WebSocket 进行数据查询的能力。
+
+## 核心场景
+
+### 1. 查询数据
+
+- **报告数据查询** — 通过 `+query-report-data` 使用 WebSocket 获取已有报告的计算结果
+- **SQL 查询** — 通过 `+query-sql` 直接执行 SQL 查询，灵活获取任意数据
+
+### 2. 报告管理
+
+- **列出报告** — `+list-reports` 获取项目下所有报告
+- **查看报告** — `+get-report` 获取单个报告的完整定义
+- **保存报告** — `+save-report` 创建或修改报告（write 操作，需确认）
+
+### 3. 仪表盘管理
+
+- **列出仪表盘** — `+list-dashboards` 获取项目下所有仪表盘
+- **查看仪表盘** — `+get-dashboard` 获取仪表盘详情
+- **创建仪表盘** — `+create-dashboard` 新建仪表盘（write 操作）
+- **更新仪表盘** — `+update-dashboard` 更新仪表盘布局（write 操作）
+- **仪表盘报告列表** — `+list-dashboard-reports` 列出仪表盘中的报告
+
+## 示例
+
+### 查询已有报告数据
+
+```bash
+# 查询报告 ID 为 42 的数据
+te-cli analysis +query-report-data -p 1 --report-id 42
+
+# 指定时间范围
+te-cli analysis +query-report-data -p 1 --report-id 42 \
+  --start-time "2026-01-01 00:00:00" --end-time "2026-01-31 23:59:59"
+```
+
+### SQL 自由查询
+
+```bash
+# 按事件分组统计
+te-cli analysis +query-sql -p 1 \
+  --sql "SELECT event, count(*) FROM ta.v_event_1 GROUP BY event LIMIT 20"
+```
+
+### 报告管理流程
+
+```bash
+# 列出所有报告
+te-cli analysis +list-reports -p 1
+
+# 查看某个报告定义
+te-cli analysis +get-report -p 1 --report-id 42
+
+# 创建新报告（write，需确认）
+te-cli analysis +save-report -p 1 --report-name "DAU 趋势" \
+  --report-model 0 \
+  --events '[...]' --event-view '{...}'
+```
+
+### 仪表盘管理流程
+
+```bash
+# 列出仪表盘
+te-cli analysis +list-dashboards -p 1
+
+# 创建新仪表盘
+te-cli analysis +create-dashboard -p 1 --dashboard-name "运营日报"
+
+# 向仪表盘添加报告
+te-cli analysis +update-dashboard -p 1 --dashboard-id 10 \
+  --reports '[{"reportId": 42, "reportWidth": 6, "indexOrder": 0}]'
+
+# 查看仪表盘中的报告
+te-cli analysis +list-dashboard-reports -p 1 --dashboard-id 10
+```
+
+## 参考文档
+
+详细的命令 Flags 和用法请查看 [`references/`](./references/) 目录下的各命令文档。

package/skills/te-analysis/references/create-dashboard.md

@@ -0,0 +1,30 @@
+# analysis +create-dashboard
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+创建新仪表盘。
+
+映射命令: `te-cli analysis +create-dashboard`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--dashboard-name` | string | 是 | 仪表盘名称 |
+
+## 安全约束
+
+- **risk: write** — 创建仪表盘，请确认仪表盘名称
+- 执行前会要求确认，除非传入 `--yes`
+- 建议先使用 `--dry-run` 预览请求
+
+## 示例
+
+```bash
+# 创建仪表盘
+te-cli analysis +create-dashboard -p 1 --dashboard-name "运营日报"
+
+# 预览请求
+te-cli analysis +create-dashboard -p 1 --dashboard-name "运营日报" --dry-run
+```

package/skills/te-analysis/references/get-dashboard.md

@@ -0,0 +1,24 @@
+# analysis +get-dashboard
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+获取仪表盘详情。
+
+映射命令: `te-cli analysis +get-dashboard`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--dashboard-id` | number | 是 | 仪表盘 ID |
+
+## 示例
+
+```bash
+# 获取仪表盘详情
+te-cli analysis +get-dashboard -p 1 --dashboard-id 10
+
+# 提取仪表盘名称
+te-cli analysis +get-dashboard -p 1 --dashboard-id 10 --jq '.dashboardName'
+```

package/skills/te-analysis/references/get-report.md

@@ -0,0 +1,24 @@
+# analysis +get-report
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+获取单个报告的完整定义。
+
+映射命令: `te-cli analysis +get-report`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--report-id` | number | 是 | 报告 ID |
+
+## 示例
+
+```bash
+# 获取报告定义
+te-cli analysis +get-report -p 1 --report-id 42
+
+# 仅提取事件配置
+te-cli analysis +get-report -p 1 --report-id 42 --jq '.events'
+```

package/skills/te-analysis/references/list-dashboard-reports.md

@@ -0,0 +1,24 @@
+# analysis +list-dashboard-reports
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+列出仪表盘中包含的所有报告。
+
+映射命令: `te-cli analysis +list-dashboard-reports`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--dashboard-id` | number | 是 | 仪表盘 ID |
+
+## 示例
+
+```bash
+# 列出仪表盘中的报告
+te-cli analysis +list-dashboard-reports -p 1 --dashboard-id 10
+
+# 表格格式输出
+te-cli analysis +list-dashboard-reports -p 1 --dashboard-id 10 --format table
+```

package/skills/te-analysis/references/list-dashboards.md

@@ -0,0 +1,23 @@
+# analysis +list-dashboards
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+列出项目下所有仪表盘。
+
+映射命令: `te-cli analysis +list-dashboards`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+# 列出所有仪表盘
+te-cli analysis +list-dashboards -p 1
+
+# 表格格式输出
+te-cli analysis +list-dashboards -p 1 --format table
+```

package/skills/te-analysis/references/list-reports.md

@@ -0,0 +1,26 @@
+# analysis +list-reports
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+列出项目下所有报告。
+
+映射命令: `te-cli analysis +list-reports`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+# 列出项目 1 的所有报告
+te-cli analysis +list-reports -p 1
+
+# 以表格格式输出
+te-cli analysis +list-reports -p 1 --format table
+
+# 用 jq 提取报告名称
+te-cli analysis +list-reports -p 1 --jq '.[].reportName'
+```

package/skills/te-analysis/references/query-report-data.md

@@ -0,0 +1,34 @@
+# analysis +query-report-data
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+通过 WebSocket 查询报告数据，获取报告的计算结果。
+
+映射命令: `te-cli analysis +query-report-data`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--report-id` | number | 是 | 报告 ID |
+| `--dashboard-id` | number | 否 | 仪表盘 ID（从仪表盘上下文查询时指定） |
+| `--start-time` | string | 否 | 开始时间，格式 `YYYY-MM-DD HH:mm:ss` |
+| `--end-time` | string | 否 | 结束时间，格式 `YYYY-MM-DD HH:mm:ss` |
+
+## 示例
+
+```bash
+# 查询报告数据（使用报告默认时间范围）
+te-cli analysis +query-report-data -p 1 --report-id 42
+
+# 指定时间范围
+te-cli analysis +query-report-data -p 1 --report-id 42 \
+  --start-time "2026-01-01 00:00:00" --end-time "2026-01-31 23:59:59"
+
+# 从仪表盘上下文查询
+te-cli analysis +query-report-data -p 1 --report-id 42 --dashboard-id 10
+
+# 用 jq 提取结果
+te-cli analysis +query-report-data -p 1 --report-id 42 --jq '.data'
+```

package/skills/te-analysis/references/query-sql.md

@@ -0,0 +1,31 @@
+# analysis +query-sql
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+通过 WebSocket 执行 SQL 查询，灵活获取任意数据。
+
+映射命令: `te-cli analysis +query-sql`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--sql` | string | 是 | SQL 查询语句 |
+
+## 示例
+
+```bash
+# 按事件分组统计
+te-cli analysis +query-sql -p 1 \
+  --sql "SELECT event, count(*) FROM ta.v_event_1 GROUP BY event LIMIT 20"
+
+# 查询用户属性
+te-cli analysis +query-sql -p 1 \
+  --sql "SELECT * FROM ta.v_user_1 LIMIT 10"
+
+# 用 jq 提取特定字段
+te-cli analysis +query-sql -p 1 \
+  --sql "SELECT event, count(*) as cnt FROM ta.v_event_1 GROUP BY event LIMIT 20" \
+  --jq '.data'
+```

package/skills/te-analysis/references/save-report.md

@@ -0,0 +1,42 @@
+# analysis +save-report
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+创建或更新报告定义。
+
+映射命令: `te-cli analysis +save-report`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--report-name` | string | 是 | 报告名称 |
+| `--report-model` | number | 是 | 报告模型类型：0=Event, 1=Retention, 2=Funnel, 10=Distribution |
+| `--events` | json | 是 | 事件配置 JSON |
+| `--event-view` | json | 是 | 事件视图配置 JSON |
+
+## 安全约束
+
+- **risk: write** — 创建或修改报告，请确认报告名称和配置
+- 执行前会要求确认，除非传入 `--yes`
+- 建议先使用 `--dry-run` 预览请求
+
+## 示例
+
+```bash
+# 创建事件分析报告
+te-cli analysis +save-report -p 1 \
+  --report-name "DAU 趋势" \
+  --report-model 0 \
+  --events '[{"eventName":"ta_session"}]' \
+  --event-view '{"timeRange":"last_7_days"}'
+
+# 预览请求（不实际执行）
+te-cli analysis +save-report -p 1 \
+  --report-name "留存分析" \
+  --report-model 1 \
+  --events '[...]' \
+  --event-view '{...}' \
+  --dry-run
+```

package/skills/te-analysis/references/update-dashboard.md

@@ -0,0 +1,33 @@
+# analysis +update-dashboard
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+更新仪表盘布局，设置仪表盘中包含的报告及其排列。
+
+映射命令: `te-cli analysis +update-dashboard`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--dashboard-id` | number | 是 | 仪表盘 ID |
+| `--reports` | json | 是 | 报告布局配置：`[{reportId, reportWidth?, indexOrder}]` |
+
+## 安全约束
+
+- **risk: write** — 更新仪表盘布局，请确认仪表盘 ID 和报告配置
+- 执行前会要求确认，除非传入 `--yes`
+- 建议先使用 `--dry-run` 预览请求
+
+## 示例
+
+```bash
+# 设置仪表盘包含两个报告
+te-cli analysis +update-dashboard -p 1 --dashboard-id 10 \
+  --reports '[{"reportId": 42, "reportWidth": 6, "indexOrder": 0}, {"reportId": 43, "reportWidth": 6, "indexOrder": 1}]'
+
+# 预览请求
+te-cli analysis +update-dashboard -p 1 --dashboard-id 10 \
+  --reports '[{"reportId": 42, "indexOrder": 0}]' --dry-run
+```

package/skills/te-audience/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: te-audience
+version: 1.0.0
+description: "TE 受众管理：用户标签、分群、受众属性"
+metadata:
+  requires:
+    bins: ["te-cli"]
+  cliHelp: "te-cli audience --help"
+---
+
+# te-audience
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`] 了解认证、项目选择和通用约定。
+
+## 概述
+
+`te-audience` 域负责 TE 平台的受众管理能力，包括：
+
+- **用户标签** — 查询和管理用户标签体系
+- **用户分群** — 查看分群列表、预估分群人数
+- **受众事件** — 获取受众相关事件定义
+- **受众属性** — 加载受众属性（用户属性、事件属性等）
+
+所有命令通过 `te-cli audience +<command>` 调用。
+
+## 核心场景
+
+### 1. 查看用户标签体系
+```bash
+# 列出项目下所有用户标签
+te-cli audience +list-tags -p <project-id>
+
+# 获取某个标签的详细信息
+te-cli audience +get-tag -p <project-id> --tag-id 42
+```
+
+### 2. 用户分群管理
+```bash
+# 列出所有用户分群
+te-cli audience +list-clusters -p <project-id>
+
+# 预估满足条件的实体数量
+te-cli audience +predict-cluster-count -p <project-id> --conditions '{"property":"age","op":"gt","value":18}'
+```
+
+### 3. 受众事件与属性
+```bash
+# 列出受众事件
+te-cli audience +list-audience-events -p <project-id>
+
+# 加载受众属性（并行调用 3 个 API）
+te-cli audience +load-audience-props -p <project-id>
+
+# 可选传入 events 过滤
+te-cli audience +load-audience-props -p <project-id> --events '[{"name":"login"}]'
+```
+
+## 参考文档
+
+详见 `references/` 目录下各命令文档。

package/skills/te-audience/references/te-audience-get-tag.md

@@ -0,0 +1,21 @@
+# te-audience +get-tag
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+获取指定标签的详细信息。
+
+映射命令: `te-cli audience +get-tag`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+| `--tag-id` | number | 是 | 标签 ID |
+
+## 示例
+
+```bash
+# 获取标签 ID 为 42 的详情
+te-cli audience +get-tag -p my-project --tag-id 42
+```

package/skills/te-audience/references/te-audience-list-audience-events.md

@@ -0,0 +1,20 @@
+# te-audience +list-audience-events
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+列出项目下的受众事件定义。
+
+映射命令: `te-cli audience +list-audience-events`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+
+## 示例
+
+```bash
+# 列出受众事件
+te-cli audience +list-audience-events -p my-project
+```

package/skills/te-audience/references/te-audience-list-clusters.md

@@ -0,0 +1,20 @@
+# te-audience +list-clusters
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+列出项目下所有用户分群。
+
+映射命令: `te-cli audience +list-clusters`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+
+## 示例
+
+```bash
+# 列出所有用户分群
+te-cli audience +list-clusters -p my-project
+```

package/skills/te-audience/references/te-audience-list-tags.md

@@ -0,0 +1,23 @@
+# te-audience +list-tags
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+列出项目下所有用户标签。
+
+映射命令: `te-cli audience +list-tags`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+
+## 示例
+
+```bash
+# 列出默认项目的用户标签
+te-cli audience +list-tags
+
+# 指定项目
+te-cli audience +list-tags -p my-project
+```

package/skills/te-audience/references/te-audience-load-audience-props.md

@@ -0,0 +1,25 @@
+# te-audience +load-audience-props
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+加载受众属性信息。内部并行调用 3 个 API 以提升性能。
+
+映射命令: `te-cli audience +load-audience-props`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+| `--events` | json | 否 | 事件过滤条件 JSON |
+
+## 示例
+
+```bash
+# 加载所有受众属性
+te-cli audience +load-audience-props -p my-project
+
+# 传入事件过滤条件
+te-cli audience +load-audience-props -p my-project \
+  --events '[{"name":"login"},{"name":"purchase"}]'
+```