@hcmai/cli 0.3.4 → 0.3.6

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.
@@ -0,0 +1,49 @@
1
+ ---
2
+ name: hcm-delivery-doctor
3
+ title: 现场探活:四条锚点
4
+ description: 到客户现场敲的第一条命令。连不上、身份不对、没权限、站错层——这四件事分开问,不要合成一句「环境有问题」。
5
+ category: cli-operations
6
+ stages:
7
+ - baseline
8
+ actionSurface: cli
9
+ requires: []
10
+ ---
11
+
12
+ # 现场探活:四条锚点
13
+
14
+ 到一个陌生环境,先回答四个问题,**一条锚点一个**:
15
+
16
+ ```
17
+ hcm delivery doctor --env <环境别名> --output table
18
+ ```
19
+
20
+ | 锚点 | 它回答什么 | 红了先看哪 |
21
+ |---|---|---|
22
+ | `connectivity` | 模型清单可达吗 | 网络 / endpoint 写对没有 |
23
+ | `identity` | token 归属的租户,是不是你要的那个 | **停下**,别爬;先确认 `--tenant` |
24
+ | `config-admin` | 当前账号读得到租户 meta 清单吗 | 403 找客户管理员加角色;其他先排连通 |
25
+ | `layer` | 你站在哪个 workspace 层 | 按它给的那句话走,几种成因下一步不同 |
26
+
27
+ ## 四条锚点恒存在
28
+
29
+ 失败时**不会**少发一条。看到「三条都绿」不等于第四条没问题——
30
+ 如果哪天真的只有三条,那是本命令出了 bug,不是那一层被跳过了。
31
+
32
+ ## 三件容易误判的事
33
+
34
+ **`identity` 红 ≠ 网络问题。** 它判的是「token 实际归属的租户 vs 你要的租户」。
35
+ 两者不一致时,爬出来的基线**看上去完全正常**,里面却是另一个客户的 schema。
36
+ 这一条红了就地停,不要继续 recon。
37
+
38
+ **`config-admin` 报 0 条不是错。** 有权限且清单真的是空的,是合法状态:
39
+ 克隆库带得走 workspace 绑定,带不走 workspace 文件。403 才是没权限。
40
+
41
+ **`layer` 报 unknown 有几种,下一步不同。** 命令会明说是哪一种:
42
+ 「一个模型都没得试」指向 connectivity 或模型清单本身;
43
+ 「答应了但没回显 `X-HCM-Extension-Source`」指向反代把 `X-HCM-*` 响应头剥了;
44
+ 「一个都没答应」——本命令**分不出**是连通、权限还是中间有人挡了,它会直说分不出。
45
+
46
+ ## 退出码
47
+
48
+ 四条全绿是 `0`,任一条没过是 `1`。写进脚本当前置闸时按这个判,
49
+ 不要去 grep 输出文本。
@@ -0,0 +1,11 @@
1
+ # HCM CLI · 自带技能
2
+
3
+ > 随 `@hcmai/cli` 一起发布的技能。它们讲的是**本 CLI 的命令**(`actionSurface: cli`),
4
+ > 因此随 CLI 版本走:`npm i -g @hcmai/cli@latest` 就是升级它们。
5
+ > 讲产品概念 / 业务口径的技能不在这里,在睿戎(Chiron)那一侧,随后端升版。
6
+ >
7
+ > 机器可读的完整清单(含命令面):同目录 `manifest.json`,由 `hcm skills manifest` 产出。
8
+
9
+ ## 清单
10
+
11
+ - `hcm-delivery-doctor` — 到客户现场敲的第一条命令:连不上 / 身份不对 / 没权限 / 站错层,四件事分开问。 → `hcm-delivery-doctor/SKILL.md`