@kriston-ai/kst-im-cli 0.0.10 → 0.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.js +78 -78
  2. package/package.json +1 -1
  3. package/skills/kst-im-cli/SKILL.md +21 -9
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kriston-ai/kst-im-cli",
3
- "version": "0.0.10",
3
+ "version": "0.0.12",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
package/skills/kst-im-cli/SKILL.md CHANGED
@@ -5,6 +5,10 @@ description: 快商通 IM CLI — 渠道账号/网页站点列表、渠道与网
5
5
 
6
6
  # kst-im-cli
7
7
 
8
+ ## 版本要求
9
+
10
+ 使用 `kst-im-cli` 前必须确认版本不低于 `0.0.12`；低于该版本时，先升级 CLI 后再执行任何业务命令。
11
+
8
12
  ## Quick Reference
9
13
 
10
14
  | 命令 | 说明 |
@@ -33,9 +37,9 @@ description: 快商通 IM CLI — 渠道账号/网页站点列表、渠道与网
33
37
 
34
38
  ## Overview
35
39
 
36
- `kst-im-cli` 是快商通 IM 数据查询 CLI。agent 使用时需先完成认证，所有命令默认输出 JSON 信封，stdout/stderr 分工严格。
40
+ `kst-im-cli` 是快商通 IM 数据查询 CLI。agent 可直接调用业务命令：CLI 优先使用已注入的环境变量，未注入时使用已有本地登录配置。所有命令默认输出 JSON 信封，stdout/stderr 分工严格。
37
41
 
38
- **Agent 推荐**：由编排系统注入环境变量 `KST_ONLINE_CLI_API_KEY`，直接调用业务命令，无需 `auth login`。环境变量优先级高于本地 `config.json`。
42
+ **环境变量名**：仅支持 `KST_ONLINE_CLI_API_KEY`。agent 只能使用执行环境中已存在的该变量，不得自行赋值、覆盖、复制其他产品线的 Key 或输出 Key。环境变量优先级高于本地 `config.json`；未设置时无需补设，直接调用业务命令即可使用已有本地配置。
39
43
 
40
44
  agent 查询历史记录前必须先调用 `history schema` 理解字段含义；不要依赖 schema 未声明的旧接口字段。
41
45
 
@@ -61,18 +65,22 @@ agent 查询历史记录前必须先调用 `history schema` 理解字段含义
61
65
 
62
66
  **方式一：环境变量（Agent 推荐）**
63
67
 
64
- 编排系统将 API Key 写入沙箱环境变量后，直接执行业务命令，无需 `auth login`：
68
+ 执行宿主已注入非空的 `KST_ONLINE_CLI_API_KEY` 时，直接执行业务命令，无需 `auth login`：
65
69
 
66
70
  ```bash
67
- export KST_ONLINE_CLI_API_KEY=<API_KEY>
68
71
  kst-im-cli channel type list
69
72
  ```
70
73
 
74
+ - agent 只使用已存在的 `KST_ONLINE_CLI_API_KEY`，不得自行设置、修改或从其他产品线复制 Key，也不得输出 Key
71
75
  - 环境变量 trim 后非空即生效，优先级高于本地 `config.json`
72
76
  - 空值或纯空格视为未设置，回退本地配置
73
- - 401 时 stderr 提示检查 `KST_ONLINE_CLI_API_KEY`，需重新申请 key
77
+ - 401 时提示调用方检查已注入的 `KST_ONLINE_CLI_API_KEY`，不要由 agent 自行替换 Key
78
+
79
+ **方式二：已有本地配置（无环境变量）**
80
+
81
+ 未设置 `KST_ONLINE_CLI_API_KEY` 时，直接执行业务命令；CLI 会使用已有的本地登录配置。无需为此补设环境变量。
74
82
 
75
- **方式二：auth login（终端用户）**
83
+ **本地配置初始化（终端用户）**
76
84
 
77
85
  ```bash
78
86
  kst-im-cli auth login -k <API_KEY>
@@ -84,10 +92,14 @@ kst-im-cli auth login -k <API_KEY>
84
92
 
85
93
  ```bash
86
94
  kst-im-cli auth status
95
+ # 环境变量模式（无需 auth login，不回显 Key）：
96
+ # stdout: { "ok": true, "data": { "source": "env" } }
97
+ # 本地登录模式：
87
98
  # stdout: { "ok": true, "data": { "key": "...", "compId": N, "customerId": N } }
88
99
  ```
89
100
 
90
- > `auth status` / `config get` 仍要求已执行 `auth login`；纯环境变量模式下请直接调用业务命令。
101
+ > `auth status` 的 `ok === true` 即具备可用凭据，可直接调用业务命令；`source === "env"` 表示凭据来自环境变量，不含 Key 与 compId/customerId。
102
+ > `config get` 仍要求已执行 `auth login`（仅读本地配置项）；纯环境变量模式下不要使用该命令。
91
103
 
92
104
  ---
93
105
 
@@ -312,8 +324,8 @@ stats init → channel / web 看板（中文字段映射，共用 stats.json）
312
324
 
313
325
  | type / 症状 | 原因 | 处理 |
314
326
  | -------------------------- | ------------------------------ | ----------------------------------------- |
315
- | `auth` | 未登录或 token 失效 | 环境变量模式：检查 `KST_ONLINE_CLI_API_KEY` 是否有效；本地模式：`auth login -k <key>` 后重试 |
316
- | `auth` + 含 `KST_ONLINE_CLI_API_KEY` | 环境变量 key 无效或过期 | 重新申请 key 并更新沙箱环境变量，不回退本地配置 |
327
+ | `auth` | 未登录或 token 失效 | 环境变量模式：由调用方检查已注入的 `KST_ONLINE_CLI_API_KEY`；本地模式：由终端用户完成 `auth login` 后重试 |
328
+ | `auth` + 含 `KST_ONLINE_CLI_API_KEY` | 环境变量 key 无效或过期 | 由调用方更新注入的 Key；agent 不替换 Key，且不回退本地配置 |
317
329
  | `validation` | 参数错误 | 修正参数后重试 |
318
330
  | `network` | 网络不通 | 检查网络连通性 |
319
331
  | `api` | 服务端业务错误 | 读 `.data.content` 查看服务端响应 |