Merge pull request #303 from modelstudioai/fix/telemetry-command-prefix

chore(release): prepare 2.8.2

Author: XXPermanentXX

CHANGELOG.md

@@ -6,6 +6,12 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 [中文版](CHANGELOG.zh.md) · [README](README.md) · [Contributing](CONTRIBUTING.md)
 
+## [2.8.2] - 2026-11-04
+
+### Internal
+
+- Improve CLI usage statistics.
+
 ## [2.8.1] - 2026-11-04
 
 ### Added

CHANGELOG.zh.md

@@ -6,6 +6,12 @@
 
 [English](CHANGELOG.md) · [README](README.zh.md) · [参与贡献](CONTRIBUTING.zh.md)
 
+## [2.8.2] - 2026-11-04
+
+### 内部维护
+
+- 完善 CLI 使用统计。
+
 ## [2.8.1] - 2026-11-04
 
 ### 新增

docs/agents/telemetry-change.md

@@ -95,6 +95,7 @@ source-config 只用于百炼 / DashScope API 侧消费，不发送到通用网
 
 - `command`、`timestamp`、`durationMs`、`success`
 - `cliVersion`、`nodeVersion`、`os`
+- `commandPrefix`（调用入口，来自 `Identity`）
 - `authMethod`
 - `callerType`（必填：`agent` 或 `unknown`）；`callerType=agent` 时可选 `callerName`、`skillName`、`skillVersion`
 - 失败时的 `errorMessage`、`exitCode`、`httpStatus`、`requestId`
@@ -119,20 +120,32 @@ source-config 只用于百炼 / DashScope API 侧消费，不发送到通用网
 
 底层 Node tracker 还会附加公共设备字段：OS 类型/版本、Node 应用名与版本、平台，以及由本机网络标识计算的 MD5 `device_id`。
 
-当前 AEM 事件没有 `binName` 或 `clientName` 产品维度，并且 `bl`、`kscli` 共用 `pid=bailian-cli-node`。两边相同路径的 `config show`、`config set`、`update` 无法仅凭当前事件稳定区分产品；Knowledge 命令虽然因路径映射不同而表现为 `knowledge chat` 与 `chat`，也不应把命令路径当作长期产品标识。后端 source-config 的 `t2` 已能区分 `bl/kscli`，但这个维度尚未进入 AEM 客户端事件。
+从 2.8.2 起，每条命令事件通过 `commandPrefix` 显式记录调用入口，三种入口仍共用 `pid=bailian-cli-node`：
+
+| 调用入口    | `commandPrefix` |
+| ----------- | --------------- |
+| `bl`        | `bl`            |
+| `kscli`     | `kscli`         |
+| `aliyun bl` | `aliyun bl`     |
+
+`commandPrefix` 使用 `formatCommand(identity)` 从结构化的 `commandInvocation` 生成，未设置时回落到 `binName`。Aliyun 兼容入口由产品入口识别并注入 `Identity.commandInvocation = { bin: "aliyun", path: ["bl"] }`；telemetry 不读取环境变量或 argv 猜测来源，也不采用旧的显示覆盖字段。命令路径保持不变：如三种入口的 `config show` 仍以 `config show` 为事件名，按 `commandPrefix` 区分入口。调用方 `callerType` / `callerName` 是独立维度。
+
+该字段同时进入本地 JSONL 与远端 AEM `ext`，成功与失败均携带。旧版本缺少入口字段的事件保留为入口未知，不能自动归为 `bl`，也不能靠命令路径可靠补回。后端 source-config 和 User-Agent 的既有口径不变。
+
+`createTrackingEvent()` 必须传入 `identity`，统一从中读取 `cliVersion` 并生成 `commandPrefix`。`trackCommandExecution()` 传入产品 `Identity`，因此本版 CLI 命令事件始终包含 `commandPrefix`。
 
 AEM 映射：
 
-| AEM 字段   | 内容                                                                             |
-| ---------- | -------------------------------------------------------------------------------- |
-| event name | 命令路径                                                                         |
-| `et`       | `EXP`                                                                            |
-| `ext`      | 除 `command`、`params` 外的结构化事件字段，含 `callerType` 与失败时的 `exitCode` |
-| `c1`       | allowlist 参数                                                                   |
-| `c2`       | `success` / `failure`                                                            |
-| `c3`       | HTTP status                                                                      |
-| `c4`       | 错误文案，最多 500 字符                                                          |
-| `c5`       | request ID                                                                       |
+| AEM 字段   | 内容                                                                                              |
+| ---------- | ------------------------------------------------------------------------------------------------- |
+| event name | 命令路径                                                                                          |
+| `et`       | `EXP`                                                                                             |
+| `ext`      | 除 `command`、`params` 外的结构化事件字段，含 `commandPrefix`、`callerType` 与失败时的 `exitCode` |
+| `c1`       | allowlist 参数                                                                                    |
+| `c2`       | `success` / `failure`                                                                             |
+| `c3`       | HTTP status                                                                                       |
+| `c4`       | 错误文案，最多 500 字符                                                                           |
+| `c5`       | request ID                                                                                        |
 
 远端发送是 best-effort，不得阻塞命令或改变退出码。正常退出最多等待 1 秒，SIGINT 最多等待 500 ms。
 
@@ -159,6 +172,7 @@ AEM 映射：
 
 - [ ] 更新 `TrackingEvent`、`createTrackingEvent()` 与 `buildRemoteAemOptions()` 的字段映射
 - [ ] 本地 JSONL 与远端 AEM 必须基于同一结构化事件，不能维护两套字段口径
+- [ ] 三种入口分别核对 `commandPrefix`；共享路径也必须可区分，旧数据缺字段保留为未知
 - [ ] 调用方字段经 `readCaller` → `TrackingDeps.caller` → 事件；仅显式 `agent` / `ai_agent` 为 `agent`，其余为 `unknown`
 - [ ] 成功与失败均覆盖；遥测异常必须静默且不改变业务退出码
 - [ ] runtime 本地语义错误应记录 `exitCode`；新增字段默认随 AEM `ext` 上报，无需占用新的 `c1`—`c5`

packages/bailian-kb-dsh/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bailian-kb-dsh",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "description": "Bailian knowledge-base tools for DeepSeek Harness: kb_search and kb_chat over the DashScope RAG API, plus the bl CLI management skill.",
   "keywords": [
     "alibaba-cloud",

packages/bailian-memo-dsh/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bailian-memo-dsh",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "description": "Bailian personal memory for DeepSeek Harness: automatic recall, silent curation, and user-controlled remember/forget.",
   "keywords": [
     "alibaba-cloud",

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bailian-cli",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "description": "CLI for Aliyun Model Studio (DashScope) AI Platform.",
   "keywords": [
     "agent",

packages/commands/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bailian-cli-commands",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "description": "Command library for bailian-cli products (knowledge, memory, media, …). See https://www.npmjs.com/package/bailian-cli for usage.",
   "homepage": "https://bailian.console.aliyun.com/cli",
   "bugs": {

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bailian-cli-core",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "description": "Core SDK for bailian-cli. See https://www.npmjs.com/package/bailian-cli for usage.",
   "homepage": "https://bailian.console.aliyun.com/cli",
   "bugs": {

packages/core/src/telemetry/event.ts

@@ -1,3 +1,5 @@
+import type { Identity } from "../config/schema.ts";
+import { formatCommand } from "../output/command.ts";
 import type { AuthRequirement } from "../types/command.ts";
 import type { CallerAttribution } from "./caller.ts";
 
@@ -11,6 +13,7 @@ export interface TrackingEvent {
   httpStatus?: number;
   requestId?: string;
   cliVersion: string;
+  commandPrefix: string;
   nodeVersion: string;
   os: string;
   authMethod?: AuthRequirement;
@@ -27,7 +30,7 @@ export function createTrackingEvent(opts: {
   durationMs: number;
   success: boolean;
   error?: { message?: string; exitCode?: number; httpStatus?: number; requestId?: string };
-  cliVersion: string;
+  identity: Identity;
   authMethod?: AuthRequirement;
   params?: Record<string, unknown>;
   caller: CallerAttribution;
@@ -37,7 +40,8 @@ export function createTrackingEvent(opts: {
     timestamp: new Date().toISOString(),
     durationMs: opts.durationMs,
     success: opts.success,
-    cliVersion: opts.cliVersion,
+    cliVersion: opts.identity.version,
+    commandPrefix: formatCommand(opts.identity),
     nodeVersion: process.version,
     os: process.platform,
     callerType: opts.caller.callerType,

packages/core/src/telemetry/tracker.ts

@@ -133,7 +133,7 @@ export async function trackCommandExecution(
       durationMs,
       success,
       error: success ? undefined : { message: errorMessage, exitCode, httpStatus, requestId },
-      cliVersion: deps.identity.version,
+      identity: deps.identity,
       authMethod: deps.authMethod,
       params: extractParams(flags),
       caller: deps.caller,