sino-bc-cli 1.8.7 → 1.8.9

package/README.md

@@ -322,10 +322,10 @@ sino-bc-cli /init
 
 | 命令        | 说明                                                                                          |
 | :---------- | :-------------------------------------------------------------------------------------------- |
-| `/init`       | 注册唯一技能 `sino-bc-cli` 到 Agent 技能目录（并删除旧平级 `sino-bc-shared` / `sino-bc-<domain>`），交互设置环境 / `API_KEY` |
+| `/init`       | 注册唯一技能 `sino-bc-cli` 到 Agent 技能目录（并删除旧平级 `sino-bc-shared` / `sino-bc-<domain>`），交互设置环境 / `API_KEY` / `APIFOX_TOKEN` |
 | `/skill`      | 列出包内 Agent 技能；传入 name 打开对应 `SKILL.md` |
 | `/get-config` | 查看变量配置；密钥默认打码，`--show-secret` 显示明文，`--json` 输出 JSON |
-| `/set-config` | 修改变量配置（环境 / API_KEY / 维护者的 `apifox-token`）；不带参数时逐项交互修改环境与 API_KEY |
+| `/set-config` | 修改变量配置（环境 / API_KEY / 维护者的 `APIFOX_TOKEN`）；不带参数时逐项交互修改环境与 API_KEY；`/set-config APIFOX_TOKEN` 省略取值写入内置默认 |
 | `/uninstall`  | 删除技能目录与变量配置文件，并从全局 npm 卸载本 CLI |
 | `/bc-api`     | **已下线**。只打印迁移提示并非 0 退出，改用 `biz-line +<shortcut>` 或 `biz-line api <name>` |
 
@@ -348,8 +348,8 @@ sino-bc-cli /init
 | 参数 | 说明 |
 | :--- | :--- |
 | `--format json\|table` | 输出格式。TTY 默认 `table`，非 TTY 默认 `json` |
-| `--dry-run` | 只打印将要发起的 method / URL / 请求体，不发请求 |
-| `--yes` | 跳过写操作确认，直接发起请求 |
+| `--dry-run` | 走与真实请求相同的本地 dry-run，只打印将要发起的 method / URL / 请求体，不发请求 |
+| `--yes` | 跳过写操作确认；本地 dry-run 通过后发起请求 |
 
 ### 输出契约与退出码
 
@@ -376,7 +376,7 @@ sino-bc-cli /init
 | :--- | :--------- | :----- | :--- |
 | `env` | `env` | `prod` | 目标环境，可选 `test` / `pre` / `prod` |
 | `apiKey` | `api-key` | 内置默认 Key | 网关鉴权用的 API Key（业务命令使用） |
-| `apifoxToken` | `apifox-token` | 空 | 仅维护者同步接口文档用（`npm run sync-api-doc`），与业务调用无关；`/init` 不会询问它 |
+| `apifoxToken` | `apifox-token` / `APIFOX_TOKEN` | 未配置为空；`/init` 或 `/set-config` 省略取值时写入内置默认 | 仅维护者同步接口文档用（`npm run sync-api-doc`），与业务调用无关；`/init` 会询问，裸 `/set-config` 不问 |
 
 ```bash
 # 查看（密钥打码）
@@ -390,11 +390,12 @@ sino-bc-cli /set-config --env=test
 # 不带参数则逐项交互修改，直接回车保留当前值（只问环境与 API_KEY）
 sino-bc-cli /set-config
 
-# 维护者才需要：配置 Apifox token（默认打码，--show-secret 看明文）
+# 维护者才需要：配置 Apifox token（省略取值写入内置默认；默认打码，--show-secret 看明文）
+sino-bc-cli /set-config APIFOX_TOKEN
 sino-bc-cli /set-config apifox-token <你的 token>
 ```
 
-> `/init` 在非交互环境（npm `postinstall`、CI、Agent 调用）下不提问：配置文件已存在则保持不变，不存在则按默认值创建。
+> `/init` 在非交互环境（npm `postinstall`、CI、Agent 调用）下不提问：已有配置保持，但空的 `apifoxToken` 会补上内置默认；不存在则按默认值创建（含 `APIFOX_TOKEN`）。
 
 ### 全局选项
 

package/dist/SKILL.md

@@ -65,7 +65,7 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 Agent 先读子技能 `sino-bc-shared`，再按意图读域技能。
 
 1. 配置、信封、确认门、禁止拼 HTTP：[`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)（仓库 [`skills/default/sino-bc-shared/SKILL.md`](skills/default/sino-bc-shared/SKILL.md)）
-2. 业务线、周策略、投放渠道/品类、关联项目、广告策略维度与成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/oapi/sino-bc-biz-line/SKILL.md`](skills/oapi/sino-bc-biz-line/SKILL.md)）
+2. 业务线、周策略生成、广告结构、广告成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/oapi/sino-bc-biz-line/SKILL.md`](skills/oapi/sino-bc-biz-line/SKILL.md)）
 3. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/oapi/sino-bc-sso/SKILL.md`](skills/oapi/sino-bc-sso/SKILL.md)）
 
 安装与刷新（会写入上面列出的子技能到本机 `sino-bc-cli/`，并删除旧的平级 `sino-bc-shared` / `sino-bc-<domain>` 技能目录）：

package/dist/affordance/biz-line.md

@@ -22,13 +22,13 @@
 
 ## +update
 
-- **WHEN**：编辑业务线 （写操作需 --yes）
+- **WHEN**：更新业务线 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +update --data '{...}'`
 
 ## +status
 
-- **WHEN**：切换业务线状态 （写操作需 --yes）
+- **WHEN**：更新业务线状态 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +status --data '{...}'`
 
@@ -38,39 +38,33 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +delete --data '{...}'`
 
-## +period-list
-
-- **WHEN**：策略周期列表
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +period-list --data '{...}'`
-
 ## +strategies
 
-- **WHEN**：查询策略分页列表
+- **WHEN**：查询投放策略分页列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategies --data '{...}'`
 
 ## +spend
 
-- **WHEN**：策略周期内关联项目周表消耗汇总
+- **WHEN**：查询投放策略消耗信息
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +spend --data '{...}'`
 
 ## +strategy-save
 
-- **WHEN**：新建策略 （写操作需 --yes）
+- **WHEN**：新建投放策略 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategy-save --data '{...}'`
 
 ## +strategy-update
 
-- **WHEN**：编辑策略 （写操作需 --yes）
+- **WHEN**：更新投放策略 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategy-update --data '{...}'`
 
 ## +strategy-delete
 
-- **WHEN**：删除策略 （写操作需 --yes）
+- **WHEN**：删除投放策略 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategy-delete --data '{...}'`
 
@@ -82,57 +76,57 @@
 
 ## +categories
 
-- **WHEN**：查询投放品类字典树
+- **WHEN**：查询投放品类字典
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +categories`
 
 ## +project-list
 
-- **WHEN**：业务线关联项目列表
+- **WHEN**：查询业务线关联项目和广告账号
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +project-list --data '{...}'`
 
 ## +queryByPage
 
-- **WHEN**：查询优化项目分页列表
+- **WHEN**：查询项目分页列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +queryByPage --data '{...}'`
 
-## +ad-list
+## +facebook-dimension
 
 - **WHEN**：Facebook广告策略维度数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +facebook-dimension --data '{...}'`
 
-## +google-ad-list
+## +google-dimension
 
 - **WHEN**：Google广告策略维度数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +google-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +google-dimension --data '{...}'`
 
-## +tiktok-ad-list
+## +tiktok-dimension
 
 - **WHEN**：TikTok广告策略维度数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +tiktok-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +tiktok-dimension --data '{...}'`
 
-## +facebook-ad-list
+## +facebook-metrics
 
 - **WHEN**：Facebook广告策略成效数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +facebook-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +facebook-metrics --data '{...}'`
 
-## +metrics-google-ad-list
+## +google-metrics
 
 - **WHEN**：Google广告策略成效数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +metrics-google-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +google-metrics --data '{...}'`
 
-## +metrics-tiktok-ad-list
+## +tiktok-metrics
 
 - **WHEN**：TikTok广告策略成效数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +metrics-tiktok-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +tiktok-metrics --data '{...}'`
 
 ## api
 

package/dist/api-doc/oapi/biz-line-query.md

@@ -10,10 +10,10 @@
 
 `GET /sino-opti-hive/biz-line-open/channels`
 
-无入参，返回 ChannelEnum 全量：code = 枚举 id（即 list 的 mediaChannelId），name = 渠道名称。
+查询投放渠道列表
 
-## 2. 查询投放品类字典树
+## 2. 查询投放品类字典
 
 `GET /sino-opti-hive/biz-line-open/placement-categories`
 
-无入参，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。
+查询投放品类字典，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。