sino-bc-cli 1.8.2 → 1.8.3
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 +24 -66
- package/dist/SKILL.md +4 -3
- package/dist/affordance/biz-line.md +5 -11
- package/dist/api-doc/README.md +9 -18
- package/dist/api-doc/biz-line-query.md +3 -5
- package/dist/generated/api-catalog.json +287 -0
- package/dist/index.js +1 -1
- package/dist/skills/sino-bc-biz-line/SKILL.md +6 -7
- package/dist/skills/sino-bc-biz-line/references/long-tail-api.md +18 -16
- package/dist/skills/sino-bc-shared/SKILL.md +1 -3
- package/package.json +2 -1
- package/dist/skills/sino-bc-shared/references/mcp-reload.md +0 -9
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: sino-bc-biz-line
|
|
3
3
|
description: >
|
|
4
4
|
Use when 查询或操作 BeyondClick 业务线数据:投放渠道、投放品类、
|
|
5
|
-
|
|
5
|
+
业务线列表/详情/策略与表现、周策略增删改查、
|
|
6
6
|
红绿灯、客户满意度、消耗、ROAS;或用户提到 biz-line、sino-opti-hive。
|
|
7
7
|
metadata:
|
|
8
8
|
requires:
|
|
@@ -16,9 +16,9 @@ metadata:
|
|
|
16
16
|
|
|
17
17
|
## When to Use
|
|
18
18
|
|
|
19
|
-
-
|
|
19
|
+
- 查投放渠道、投放行业/品类、业务线主数据、周策略与表现
|
|
20
20
|
- 新建/编辑/删除业务线或周策略(须先确认环境和写操作意图)
|
|
21
|
-
- 用户点名 `biz-line
|
|
21
|
+
- 用户点名 `biz-line`、sino-opti-hive
|
|
22
22
|
|
|
23
23
|
不要用本技能处理:配置/MCP(走 shared)、本仓库开发与发版。
|
|
24
24
|
|
|
@@ -26,7 +26,7 @@ metadata:
|
|
|
26
26
|
|
|
27
27
|
1. **优先 Shortcut**:`sino-bc-cli biz-line +<shortcut>`。WHEN 见仓库 `affordance/biz-line.md` 或 `sino-bc-cli biz-line --help`。
|
|
28
28
|
2. **没有 Shortcut 再点名**:`sino-bc-cli biz-line api <name> --data '<json>'`。长尾 name → [`references/long-tail-api.md`](references/long-tail-api.md)。
|
|
29
|
-
3. 组参前不确定字段口径就读本地文档。全局安装:`$(npm root -g)/sino-bc-cli/dist/api-doc/`;本仓库:`src/api-doc
|
|
29
|
+
3. 组参前不确定字段口径就读本地文档。全局安装:`$(npm root -g)/sino-bc-cli/dist/api-doc/`;本仓库:`src/api-doc/`。何时用哪条命令:`sino-bc-cli biz-line --help`。
|
|
30
30
|
4. `--name` 命中 0 条或多条都失败,按 hint 收窄或改用 `--id`,不要擅自选第一条。
|
|
31
31
|
5. 回复用业务语言摘要;文档路径写成 Markdown 链接。
|
|
32
32
|
|
|
@@ -46,9 +46,8 @@ CLI 未安装:`npm i sino-bc-cli@latest -g`(需 Node.js >= 24)。技能未
|
|
|
46
46
|
| --- | --- | --- |
|
|
47
47
|
| 有哪些投放渠道 | `biz-line +channels` | `code` = 业务线里的 `mediaChannelId` |
|
|
48
48
|
| 投放行业 / 品类树 | `biz-line +categories` | 一级行业(1=APP / 2=ECBR / 3=游戏),二级=品类 |
|
|
49
|
-
| 业务线有哪些 /
|
|
50
|
-
| 某条业务线的周策略和表现 | `biz-line +strategies --name` 或 `--id` | `--name` 命中 0
|
|
51
|
-
| 行业/品类里表现最好的业务线 | `biz-line +top --industry` 或 `--category` | 至少传一个;同时传则只按行业 |
|
|
49
|
+
| 业务线有哪些 / 按名或品类筛 | `biz-line +list --name / --id / --category` | 不传条件 = 全部(`pagination: false`) |
|
|
50
|
+
| 某条业务线的周策略和表现 | `biz-line +strategies --name` 或 `--id` | `--name` 命中 0 条或多条都会失败;`--id` 只接受单个 |
|
|
52
51
|
| 新建 / 编辑业务线 | `+save --data` / `+update --data` | ⚠️ 需 `--yes` |
|
|
53
52
|
| 切换业务线状态 | `+status --id --status` | ⚠️;枚举见 [`references/enums.md`](references/enums.md) |
|
|
54
53
|
| 删除业务线 | `+delete --id` | ⚠️ |
|
|
@@ -1,16 +1,18 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
用 `sino-bc-cli
|
|
4
|
-
|
|
5
|
-
| 用户在问 | name | 注意 |
|
|
6
|
-
| --- | --- | --- |
|
|
7
|
-
| 业务线分页列表 | `biz-line-list` | |
|
|
8
|
-
| 业务线详情 | `biz-line-detail` | `{ "id": <bizLineId> }` |
|
|
9
|
-
|
|
|
10
|
-
|
|
|
11
|
-
|
|
|
12
|
-
|
|
|
13
|
-
|
|
|
14
|
-
|
|
|
15
|
-
|
|
16
|
-
|
|
1
|
+
# 长尾接口(无手写 Shortcut)
|
|
2
|
+
|
|
3
|
+
用 `sino-bc-cli <domain> api <name> --data '<json>'`。`<name>` 取自 `src/api-doc/` 与该域技能 references,不要发明新 name。
|
|
4
|
+
|
|
5
|
+
| 用户在问 | name | 注意 |
|
|
6
|
+
| --- | --- | --- |
|
|
7
|
+
| 业务线分页列表 | `biz-line-list` | ⚠️ 需 `--yes` |
|
|
8
|
+
| 业务线详情 | `biz-line-detail` | `{ "id": <bizLineId> }`;⚠️ 需 `--yes` |
|
|
9
|
+
| 业务线列表导出 | `biz-line-list-export` | `result` 为文件 URL;⚠️ 需 `--yes` |
|
|
10
|
+
| 全部策略分页 | `biz-line-strategy-list` | ⚠️ 需 `--yes` |
|
|
11
|
+
| 策略详情(编辑返显) | `biz-line-strategy-detail` | ⚠️ 需 `--yes` |
|
|
12
|
+
| 策略周期列表 | `biz-line-strategy-period-list` | ⚠️ 需 `--yes` |
|
|
13
|
+
| 新建策略前置-上期摘要 | `biz-line-strategy-preview-info` | 周期为自然周 周一~周日;⚠️ 需 `--yes` |
|
|
14
|
+
| 策略对比 | `biz-line-strategy-compare` | ⚠️ 需 `--yes` |
|
|
15
|
+
| 策略周期消耗汇总 | `biz-line-strategy-spend` | ⚠️ 需 `--yes` |
|
|
16
|
+
| 导出全部策略 | `biz-line-strategy-exprot-all` | 路径拼写是 `exprot-all`,不要改成 export;⚠️ 需 `--yes` |
|
|
17
|
+
|
|
18
|
+
描述含 ⚠️ 的 name 同样走确认门。请求体按用户条件组装,禁止原样提交文档示例业务线 ID。
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: sino-bc-shared
|
|
3
3
|
description: >
|
|
4
4
|
Use for sino-bc-cli 配置、鉴权头、JSON 信封、写操作确认门、禁止拼 HTTP、
|
|
5
|
-
以及
|
|
5
|
+
以及 /init / /get-config / /set-config。
|
|
6
6
|
其他 sino-bc-* 技能执行前先读本文件。
|
|
7
7
|
metadata:
|
|
8
8
|
requires:
|
|
@@ -19,7 +19,6 @@ metadata:
|
|
|
19
19
|
2. **判断成功看 `ok == true` 或退出码 0**,不要看上游 `code`。信封与分流 → [`references/output-contract.md`](references/output-contract.md)。
|
|
20
20
|
3. **退出码 10 是写操作待确认,不是错误**。停下向用户确认环境和意图,得到同意后在原命令末尾追加 `--yes`。**不要自行补 `--yes`**。→ [`references/write-approval.md`](references/write-approval.md)。
|
|
21
21
|
4. **完整 API_KEY 不要回显。**
|
|
22
|
-
5. iCenter 不走本 CLI 接口清单:用户编辑 `~/.sino-bc-cli/mcp.json` 后执行 `/mcp-reload`。→ [`references/mcp-reload.md`](references/mcp-reload.md)。
|
|
23
22
|
|
|
24
23
|
## 环境与配置
|
|
25
24
|
|
|
@@ -29,7 +28,6 @@ metadata:
|
|
|
29
28
|
sino-bc-cli /init
|
|
30
29
|
sino-bc-cli /get-config --json
|
|
31
30
|
sino-bc-cli /set-config env prod
|
|
32
|
-
sino-bc-cli /mcp-reload
|
|
33
31
|
```
|
|
34
32
|
|
|
35
33
|
升级 CLI 后重新执行 `/init`,以刷新本机技能树。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sino-bc-cli",
|
|
3
|
-
"version": "1.8.
|
|
3
|
+
"version": "1.8.3",
|
|
4
4
|
"description": "BeyondClick CLI - 命令行工具集合,提供快捷访问 BeyondClick 平台的命令行接口",
|
|
5
5
|
"preferGlobal": true,
|
|
6
6
|
"bin": {
|
|
@@ -22,6 +22,7 @@
|
|
|
22
22
|
"build:no-mangle": "node --experimental-strip-types scripts/build.ts --no-mangle",
|
|
23
23
|
"typecheck": "tsc --noEmit",
|
|
24
24
|
"test": "node --require ts-node/register --test \"tests/**/*.test.ts\"",
|
|
25
|
+
"sync-api-doc": "node --require ts-node/register src/apifox/run-sync.ts",
|
|
25
26
|
"dev": "ts-node src/index.ts",
|
|
26
27
|
"start": "node dist/index.js",
|
|
27
28
|
"clean": "rimraf dist",
|
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
# MCP 配置分发
|
|
2
|
-
|
|
3
|
-
iCenter 及其他 MCP **不走**本 CLI 接口清单。
|
|
4
|
-
|
|
5
|
-
1. 用户把 Server 写进 `~/.sino-bc-cli/mcp.json`(与 Cursor 同结构)。
|
|
6
|
-
2. 执行 `sino-bc-cli /mcp-reload`(`/init` 结束时也会跑一次)。
|
|
7
|
-
3. CLI 同步到 Cursor / Codex / Claude / VS Code,并对带 `url` 的 Server 做 initialize 握手。
|
|
8
|
-
|
|
9
|
-
改了 `mcp.json` 却不重启,各 IDE 不会看到新 Server。查 iCenter 广告策略时用已配置的 MCP 工具,不要改走 `biz-line`。
|