siluzan-tso-cli 1.0.0-beta.5 → 1.0.0-beta.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.
- package/README.md +66 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# Siluzan TSO Skill — 给大模型的安装说明
|
|
2
|
+
|
|
3
|
+
当用户发来本页面的 **URL** 时，请按顺序协助用户完成安装（不要编造不存在的 npm 包名；若公司尚未发布，请改用用户提供的 Git 地址或本地 `tso-cli` 路径）。
|
|
4
|
+
|
|
5
|
+
## 1. 环境
|
|
6
|
+
|
|
7
|
+
- Node.js **18+**
|
|
8
|
+
- 可执行 `npm` 或 `pnpm`
|
|
9
|
+
|
|
10
|
+
## 2. 安装 CLI 并初始化 Skill
|
|
11
|
+
|
|
12
|
+
在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
npm install -g siluzan-tso-cli@beta
|
|
16
|
+
siluzan-tso init --ai cursor
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
> **注意**：当前为测试版（1.0.0-beta.6），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
|
|
20
|
+
|
|
21
|
+
| 助手 | 建议 `--ai` |
|
|
22
|
+
|------|-------------|
|
|
23
|
+
| Cursor | `cursor` |
|
|
24
|
+
| Claude Code | `claude` |
|
|
25
|
+
| OpenClaw（项目内技能） | `openclaw` 或 `openclaw-workspace` |
|
|
26
|
+
| OpenClaw（全局技能） | `openclaw-global` |
|
|
27
|
+
| WorkBuddy（项目内技能） | `workbuddy` 或 `workbuddy-workspace` |
|
|
28
|
+
| WorkBuddy（全局技能） | `workbuddy-global` |
|
|
29
|
+
| 一次写入多处 | `all` |
|
|
30
|
+
|
|
31
|
+
若 CLI 未发布：指导用户在克隆的仓库根目录执行 `npm install && npm run build`，再 `node tso-cli/dist/index.js init --ai cursor`。
|
|
32
|
+
|
|
33
|
+
## 3. 登录 / Token
|
|
34
|
+
|
|
35
|
+
`siluzan-tso` 与 `siluzan-cso` **共用同一个 Token**（存储在 `~/.siluzan/config.json`）。
|
|
36
|
+
|
|
37
|
+
**若用户已安装 siluzan-cso 并完成登录，无需重复操作，直接跳到第 4 步。**
|
|
38
|
+
|
|
39
|
+
若尚未登录，请先安装 `siluzan-cso-cli` 并完成登录：
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npm install -g siluzan-cso-cli
|
|
43
|
+
siluzan-cso login
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
向导会在终端中提示用户访问 [https://www.siluzan.com](https://www.siluzan.com) 注册登录，然后在控制台的「个人设置 → API Token」页面复制 Token，粘贴到命令行提示处，自动保存到 `~/.siluzan/config.json`，后续 `siluzan-tso` 命令自动读取。
|
|
47
|
+
|
|
48
|
+
提醒用户：**不要将 Token 提交到 Git。**
|
|
49
|
+
|
|
50
|
+
## 4. 验证
|
|
51
|
+
|
|
52
|
+
确认以下路径已存在且含 `SKILL.md`：
|
|
53
|
+
|
|
54
|
+
| 助手 | Skill 文件路径 |
|
|
55
|
+
|------|----------------|
|
|
56
|
+
| Cursor | `.cursor/skills/siluzan-tso/SKILL.md` |
|
|
57
|
+
| Claude Code | `.claude/skills/siluzan-tso/SKILL.md` |
|
|
58
|
+
| OpenClaw 工作区 | `skills/siluzan-tso/SKILL.md` |
|
|
59
|
+
| WorkBuddy 项目级 | `.workbuddy/skills/siluzan-tso/SKILL.md` |
|
|
60
|
+
| WorkBuddy 全局 | `~/.workbuddy/skills/siluzan-tso/SKILL.md` |
|
|
61
|
+
|
|
62
|
+
完成后，用户可在对话中描述广告账户管理需求（查账户、查余额、查消耗、充值、绑定 MCC/BC/BM 等），由已加载的 Skill 指导 `siluzan-tso` CLI 使用方式。
|
|
63
|
+
|
|
64
|
+
## 5. Token 续期
|
|
65
|
+
|
|
66
|
+
Token 过期后，重新运行 `siluzan-cso login` 即可更新，`siluzan-tso` 会自动读取新 Token，无需额外操作。
|