@cloudglab/yapi-cli 0.0.7 → 0.0.9

package/skills/yapi-cli/reference/group.md

@@ -2,12 +2,9 @@
 
 ## 强制判断
 
-先确认用户想查的是**分组**还是**项目**：
-
-- "分组" → YApi 的 Group，顶级容器
-- "项目" → YApi 的 Project，隶属于分组
-
-用户给分组名时，先用 `group-list` 查全部分组，匹配名称确认 `groupId`。
+- **分组** = Group，顶级容器
+- **项目** = Project，隶属分组
+- 只给分组名时，先 `group-list` 再确认 `groupId`
 
 ## 查询
 
@@ -17,49 +14,79 @@
 yapi group-list
 ```
 
-返回可见的全部分组（id / group_name / group_desc）。
+返回可见分组列表。
+
+### 我的分组
+
+```bash
+yapi group-mine
+```
+
+返回当前用户参与的分组。
 
 ### 分组详情
 
 ```bash
-yapi group-get --groupId <id>
+yapi group-get --id <id>
 ```
 
-查分组基本信息、成员数等。
+查分组详情。
 
 ## 写入
 
 ### 创建分组
 
 ```bash
-yapi group-add --groupName <name> [--groupDesc <desc>] --confirm true
+yapi group-create --name <name> [--desc <desc>] --confirm true
 ```
 
 ### 更新分组
 
 ```bash
-yapi group-up --groupId <id> [--groupName <name>] [--groupDesc <desc>] --confirm true
+yapi group-update --groupId <id> [--name <name>] [--desc <desc>] --confirm true
 ```
 
 ### 删除分组
 
 ```bash
-yapi group-del --groupId <id> --confirm true
+yapi group-delete --groupId <id> --confirm true
+```
+
+### 分组成员列表
+
+```bash
+yapi group-member-list --groupId <id>
+```
+
+### 添加分组成员
+
+```bash
+yapi group-member-add --groupId <id> --uid <uid> [--role <role>] --confirm true
+```
+
+### 修改分组成员角色
+
+```bash
+yapi group-member-role --groupId <id> --memberUid <uid> --role <role> --confirm true
 ```
 
-### 分组成员
+### 移除分组成员
 
 ```bash
-yapi member-list --groupId <id>
+yapi group-member-remove --groupId <id> --memberUid <uid> --confirm true
 ```
 
 ## 参数对照
 
 | 参数名 | 类型 | 必填 | 说明 |
 |--------|------|------|------|
-| `groupId` | number | group-get/up/del/member-list | 分组 ID |
-| `groupName` | string | group-add | 分组名称 |
-| `groupDesc` | string | 否 | 分组描述 |
+| `id` | number | group-get | 分组 ID |
+| `groupId` | number | group-update/delete/member-* | 分组 ID |
+| `name` | string | group-create | 分组名称 |
+| `desc` | string | 否 | 分组描述 |
+| `uid` | number | group-member-add | 要加入分组的用户 UID |
+| `memberUid` | number | group-member-role/remove | 已在组内的成员 UID |
+| `role` | string | group-member-add/role | 成员角色 |
 | `confirm` | boolean | 写操作 | 确认执行 |
 
 ## 常见链路
@@ -67,11 +94,11 @@ yapi member-list --groupId <id>
 ```bash
 # 查全部分组 → 定位目标分组 → 查看详情
 yapi group-list
-yapi group-get --groupId <id>
+yapi group-get --id <id>
 
 # 查分组下的项目
 yapi project-list --groupId <id>
 
 # 查分组成员
-yapi member-list --groupId <id>
+yapi group-member-list --groupId <id>
 ```

package/skills/yapi-cli/reference/index.md

@@ -0,0 +1,32 @@
+# Reference 索引
+
+按场景分类的二级文档。SKILL.md 主入口保持精简，本目录覆盖 CLI 注册的全部命令。
+
+## 主链路（高频 / 日常）
+
+| 文档 | 场景 | 关键命令 |
+| --- | --- | --- |
+| [install.md](./install.md) | 安装 / 更新 / 卸载 | `install`, `update`, `uninstall` |
+| [cli.md](./cli.md) | CLI 基础 | `help`, `list`, `version`, `whoami`, `doctor`, `changelog` |
+| [overview.md](./overview.md) | 命令总览（按分组） | 全部命令的分组列表 |
+| [auth.md](./auth.md) | 认证 / 配置 / Token | `config-init`, `login`, `login-by-token`, `logout`, `whoami` |
+| [group.md](./group.md) | 分组 | `group-list`, `group-get`, `group-create`, `group-update`, `group-delete`, `group-member-add`, `group-member-role`, `group-member-remove` |
+| [project.md](./project.md) | 项目 | `project-list`, `project-get`, `project-create`, `project-update`, `project-copy`, `project-delete`, `project-token`, `project-snapshot`, `project-env-update`, `project-tag-update`, `project-mock-toggle`, `project-mock-script`, `project-member-add`, `project-member-remove`, `project-member-role`, `project-member-email-notice`, `project-follow`, `project-unfollow`, `project-check-name`, `project-swagger-url` |
+| [interface.md](./interface.md) | 接口 / 分类 | `interface-list`, `interface-get`, `interface-snapshot`, `interface-create`, `interface-update`, `interface-save`, `interface-delete`, `interface-upload`, `interface-up-index`, `interface-up-cat-index`, `interface-mock-toggle`, `interface-mock-script`, `interface-list-by-menu`, `interface-list-by-cat`, `interface-list-public`, `interface-download-crx`, `schema-to-json`, `request`, `log`, `category-list`, `category-get`, `category-create`, `category-update`, `category-delete` |
+| [mock.md](./mock.md) | 高级 Mock | `mock-script-get`, `mock-script-save`, `mock-expect-list`, `mock-expect-get`, `mock-expect-save`, `mock-expect-delete`, `mock-expect-toggle` |
+| [test.md](./test.md) | 测试桩 / 开放接口 | `test-get`, `test-post`, `test-put`, `test-delete`, `test-head`, `test-options`, `test-patch`, `test-files-upload`, `test-single-upload`, `test-http-code`, `test-raw`, `test-response`, `open-project-interface-data`, `open-run-auto-test` |
+| [tooling.md](./tooling.md) | 通用工具 / 集合 / 用例 / 用户 | `url-parse`, `workspace-snapshot`, `export`, `import`, `self-update`, `docs-sync`, `install-skill`, `search`, `log-list-by-update`, `col-list`, `col-cases`, `col-create`, `col-update`, `col-delete`, `col-up-index`, `col-case-up-index`, `col-case-clone`, `col-case-list-by-var-params`, `case-add`, `case-add-list`, `case-get`, `case-update`, `case-delete`, `case-run`, `case-env-list`, `user-list`, `user-search`, `user-get`, `user-avatar`, `user-projects`, `user-register`, `user-update`, `user-delete`, `user-change-password`, `user-upload-avatar` |
+| [commands.md](./commands.md) | 按场景命令速查 | 全部命令索引 |
+
+## 兜底
+
+| 文档 | 作用 |
+| --- | --- |
+| [cheatsheet.md](./cheatsheet.md) | 全量命令速查（一行一条） |
+| [scenarios.md](./scenarios.md) | 场景化组合（典型链路） |
+
+## 维护约定
+
+- 任何新增 / 删除 / 重命名命令必须在对应 reference 文档中同步更新；
+- 写命令（schema 含 `confirm` 字段）必须在引用文档中说明前置条件与回滚提示；
+- 不接受的命令（如 `request` 直接绕开 write-guard）必须在 cheatsheet 中标注「直连」标识。

package/skills/yapi-cli/reference/install.md

@@ -1,29 +1,44 @@
 # 安装 / 更新 / 卸载
 
+## 入口 / 发现命令
+
+```bash
+yapi list
+yapi help <command>
+yapi version
+yapi changelog
+yapi completion bash
+```
+
+- `list`：按分组列出全部业务命令
+- `help <command>`：看单命令参数
+- `changelog`：查看版本变更历史
+- `completion bash`：生成补全脚本
+
 ## 安装
 
-全量安装（CLI + skill + 配置）：
+默认安装 CLI + skill + 配置：
 
 ```bash
 yapi install
 npx -y @cloudglab/yapi-cli@latest install
 ```
 
-`install` 会在交互终端里逐步提示你填写 YApi 地址、登录用户名、登录密码和认证方式；`auth-mode` 会引导你选择 `native` 普通登录或 `ldap` 登录。
+`install` 会交互收集地址、用户名、密码和认证方式。
 
-仅 skill：
+仅装 skill：
 
 ```bash
 yapi install --skill-only
 ```
 
-仅 CLI 配置：
+仅装 CLI 配置：
 
 ```bash
 yapi install --cli-only
 ```
 
-从本地文件安装 skill：
+从本地文件装 skill：
 
 ```bash
 yapi install --skill-path ./SKILL.md
@@ -36,18 +51,27 @@ npx -y @cloudglab/yapi-cli@latest install --skill-path ./SKILL.md
 yapi update
 yapi update --cli-only
 yapi update --skill-only
+yapi self-update
+yapi install-skill
 ```
 
-更新会先检查 npm 版本，再刷新本地 skill。
+`update` 会检查 npm 版本并刷新本地 skill。
+
+- `update`：更新 CLI 并刷新 skill
+- `self-update`：只查 CLI 版本
+- `install-skill`：只刷新本地 skill 文件
 
 ## 卸载
 
 ```bash
 yapi uninstall
+yapi remove --confirm true              # uninstall 的别名
 yapi uninstall --confirm true           # 真实卸载
 yapi uninstall --confirm true --keep-config true   # 保留配置
 ```
 
+- `remove` 是 `uninstall` 别名
+
 ## 自检
 
 ```bash

package/skills/yapi-cli/reference/interface.md

@@ -2,93 +2,52 @@
 
 ## 强制判断
 
-先确认用户意图：
-- **搜索接口** → 关键词搜索，可选 `projectId` 收窄范围
-- **接口列表** → 按项目查询，支持 status/method 过滤
-- **接口详情** → 需要 `interfaceId`
-- **创建 / 更新 / 删除** → 写操作，需要 `--confirm true`
-- **分类（Category）** → 项目的接口分组
-- **Mock** → 接口级 Mock 开关和自定义脚本
-- **日志** → 接口变更历史
-- **导出** → 按项目导出接口定义
-- **集合（Collection）** → 测试集合和用例
-
-## 搜索
-
-### 接口搜索
-
-```bash
-yapi search --q <keyword> [--projectId <id>] [--page 1] [--limit 50]
-```
-
-全局关键词搜索，支持按项目收窄范围。
-
-### 接口列表
-
-```bash
-yapi interface-list --projectId <id> [--status <s>] [--method <m>] [--page <n>] [--limit <n>]
-```
-
-`--status`：`done`（已完成）、`undone`（未完成）
-`--method`：`GET`、`POST`、`PUT`、`DELETE`
-
-### 接口详情
-
-```bash
-yapi interface-get --interfaceId <id>
-```
-
-返回接口完整定义：路径、方法、请求参数、响应示例、Mock 状态等。
-
-## 分类
-
-### 分类列表
-
-```bash
-yapi category-list --projectId <id>
-```
-
-### 分类排序
-
-```bash
-yapi interface-up-cat-index --catid <id> --index <n> --confirm true
-```
-
-## CRUD
-
-### 创建接口
-
-```bash
-yapi interface-create --projectId <id> --catId <id> --title <title> --path <path> [--method GET] [--desc <desc>] --confirm true
-```
-
-### 更新接口
-
-```bash
-yapi interface-update --interfaceId <id> [--title <t>] [--path <p>] [--method <m>] --confirm true
-```
-
-### 删除接口
-
-```bash
-yapi interface-delete --interfaceId <id> --confirm true
-```
-
-## Mock
-
-### Mock 开关
-
-```bash
-yapi interface-mock-toggle --interfaceId <id> [--open true] --confirm true
-```
-
-### Mock 脚本
-
-```bash
-yapi interface-mock-script --interfaceId <id> --script <script> --confirm true
-```
-
-YApi Mock 脚本在沙箱中执行，支持：
+先分 10 类：搜索、列表、详情、写入、分类、Mock、日志、导出、治理、集合。
+
+## 高频查询
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 接口搜索 | `search` | `yapi search --q <keyword> [--projectId <id>] [--page 1] [--limit 50]` | 全局或按项目搜 |
+| 项目接口列表 | `interface-list` | `yapi interface-list --projectId <id> [--status done] [--method GET] [--page <n>] [--limit <n>]` | 常规入口 |
+| 接口详情 | `interface-get` | `yapi interface-get --interfaceId <id>` | 取完整定义 |
+| 分类列表 | `category-list` | `yapi category-list --projectId <id>` | 查项目分类 |
+| 分类内接口 | `interface-list-by-cat` | `yapi interface-list-by-cat --catId <id>` | 分类维度看接口 |
+| 菜单模式接口 | `interface-list-by-menu` | `yapi interface-list-by-menu --projectId <id>` | 适合树状浏览 |
+| 公开项目接口 | `interface-list-public` | `yapi interface-list-public --projectId <id> [--keyword <q>] [--page <n>] [--limit <n>]` | 浏览公开接口 |
+| 自定义字段 | `interface-custom-field` | `yapi interface-custom-field --projectId <id>` | 看自定义字段 |
+| 变更日志 | `log` | `yapi log --interfaceId <id> [--projectId <id>]` | 查更新日志 |
+| 原始请求 | `request` | `yapi request --path /api/endpoint [--method GET] [--body <json>]` | 直接发请求 |
+
+## 高频写入
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 创建接口 | `interface-create` | `yapi interface-create --projectId <id> --catId <id> --title <title> --path <path> [--method GET] [--status done|undone] [--tags a,b] [--desc <desc>] [--reqQuery <json>] [--reqHeaders <json>] [--reqParams <json>] [--reqBodyType json] [--reqBodyForm <json>] [--reqBody <json>] [--resBodyType json] [--resBody <json>] [--markdown <md>] [--apiOpened] --confirm true` | 建新接口。CLI 自动分析目标分类的风格（路径前缀、method 偏好、请求/响应字段），助力新接口与现有风格对齐。 |
+| 保存接口 | `interface-save` | `yapi interface-save --projectId <id> --catId <id> --title <title> --path <path> [--method GET] [--status done|undone] [--tags a,b] [--desc <desc>] [--reqQuery <json>] [--reqHeaders <json>] [--reqParams <json>] [--reqBodyType json] [--reqBodyForm <json>] [--reqBody <json>] [--resBodyType json] [--resBody <json>] [--markdown <md>] [--apiOpened] [--customFieldValue <v>] [--interfaceId <id>] --confirm true` | 一次写全。新建时也会分析目标分类风格。 |
+| 部分更新 | `interface-update` | `yapi interface-update --interfaceId <id> [--title <t>] [--path <p>] [--method <m>] [--catid <id>] [--status done|undone] [--tags a,b] [--desc <desc>] [--reqQuery <json>] [--reqHeaders <json>] [--reqParams <json>] [--reqBodyType <type>] [--reqBodyForm <json>] [--reqBody <json>] [--resBodyType <type>] [--resBody <json>] [--markdown <md>] [--apiOpened] [--customFieldValue <v>] [--switchNotice] [--message <text>] --confirm true` | 只改传入字段，reqQuery/reqHeaders/reqParams/reqBodyForm 整体覆盖。 |
+| 删除接口 | `interface-delete` | `yapi interface-delete --interfaceId <id> --confirm true` | 不可恢复 |
+| Mock 开关 | `interface-mock-toggle` | `yapi interface-mock-toggle --interfaceId <id> [--open true] --confirm true` | 开关接口级 Mock |
+| Mock 脚本 | `interface-mock-script` | `yapi interface-mock-script --interfaceId <id> --script <script> --confirm true` | 设置接口脚本 |
+| 导入接口 | `interface-upload` | `yapi interface-upload --projectId <id> --content <json> [--type swagger] --confirm true` | 导入 swagger/json |
+
+> 高级 Mock（期望 / 脚本）见 `reference/mock.md`：`mock-expect-*`、`mock-script-*`。
+
+## 低频治理 / 维护
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 分类详情 | `category-get` | `yapi category-get --catId <id>` | 看分类详情 |
+| 创建分类 | `category-create` | `yapi category-create --projectId <id> --name <name> [--desc <desc>] --confirm true` | 建目录 |
+| 更新分类 | `category-update` | `yapi category-update --catId <id> [--name <name>] [--desc <desc>] --confirm true` | 改分类信息（后端不支持 status 字段） |
+| 删除分类 | `category-delete` | `yapi category-delete --catId <id> --confirm true` | 会清理分类下接口 |
+| 分类排序 | `interface-up-cat-index` | `yapi interface-up-cat-index --catid <id> --index <n> --confirm true` | 调整分类顺序（后端接收数组） |
+| 接口排序 | `interface-up-index` | `yapi interface-up-index --id <id> --index <n> --confirm true` | 调整接口顺序（后端接收数组） |
+| 接口快照 | `interface-snapshot` | `yapi interface-snapshot --interfaceId <id> [--logLimit 5]` | 详情 + 最近日志 |
+| Schema 转 JSON | `schema-to-json` | `yapi schema-to-json --schema <json> [--required true]` | 生成 JSON 示例 |
+| 下载 CRX | `interface-download-crx` | `yapi interface-download-crx` | 下载浏览器扩展 |
+
+Mock 脚本在沙箱中执行，常用变量：
 - `mockJson` — 修改 Mock 返回 JSON
 - `httpCode` — 修改状态码（默认 200）
 - `resHeader` — 修改响应头
@@ -102,53 +61,12 @@ httpCode = 200;
 delay = 500;
 ```
 
-## 其他
-
-### 原始请求
-
-```bash
-yapi request --path /api/endpoint [--method GET] [--body <json>]
-```
-
-走 YApi 认证，发送任意 HTTP 请求。
-
-### 日志
-
-```bash
-yapi log --interfaceId <id> [--projectId <id>]
-```
-
-接口变更历史记录。
-
-### 导出
-
-```bash
-yapi export --projectId <id> [--type json]
-```
-
-`--type`：`json`、`swagger`、`openapi3`
-
-### 下载 CRX
-
-```bash
-yapi interface-download-crx
-```
-
-下载 YApi 跨域请求插件。
-
-## 集合
-
-### 集合列表
-
-```bash
-yapi col-list --projectId <id>
-```
-
-### 集合用例
+## 说明
 
-```bash
-yapi col-cases --projectId <id> --colId <id>
-```
+- 全量写定义优先 `interface-save`
+- 局部改字段优先 `interface-update`
+- 删分类前先 `category-get` 或 `interface-list-by-cat`
+- 导出、文档同步、集合 / 用例统一看 `reference/tooling.md`
 
 ## 参数对照
 
@@ -156,12 +74,26 @@ yapi col-cases --projectId <id> --colId <id>
 |--------|------|------|------|
 | `interfaceId` | number | get/update/delete/log/toggle/script | 接口 ID |
 | `projectId` | number | list/create/export/col | 项目 ID |
-| `catId` | number | interface-create | 分类 ID |
-| `catid` | number | up-cat-index | 分类 ID |
+| `catId` | number | create/list-by-cat/category-* | 分类 ID |
+| `catid` | number | save/update/up-cat-index | 分类 ID |
 | `title` | string | create/update | 接口标题 |
 | `path` | string | create | 接口路径 |
 | `method` | string | 否 | HTTP 方法 |
 | `q` | string | search | 搜索关键词 |
+| `keyword` | string | interface-list-public | 公开接口搜索词 |
+| `index` | number | up-index / up-cat-index | 排序位置 |
+| `logLimit` | number | interface-snapshot | 最近日志条数 |
+| `schema` | string | schema-to-json | JSON Schema 字符串 |
+| `required` | boolean | schema-to-json | 可选，是否生成必填字段示例 |
+| `reqQuery` | JSON 字符串 | create/update/save | 请求查询参数数组 `[{"name":"page","example":"1","desc":"页码","required":"1"}]` |
+| `reqHeaders` | JSON 字符串 | create/update/save | 请求头数组 `[{"name":"Authorization","value":"Bearer xxx"}]` |
+| `reqParams` | JSON 字符串 | create/update/save | URL 路径参数数组 `[{"name":"id","example":"123","desc":"用户ID"}]` |
+| `reqBodyForm` | JSON 字符串 | create/update/save | 请求体表单字段数组 `[{"name":"username","type":"string","required":"1"}]` |
+| `markdown` | string | create/update/save | 接口文档 Markdown |
+| `apiOpened` | boolean | 否 | 是否对外开放接口 |
+| `customFieldValue` | string | update/save | 自定义字段值 |
+| `switchNotice` | boolean | 否 | update 时发送变更通知 |
+| `message` | string | 否 | update 备注信息 |
 | `confirm` | boolean | 写操作 | 确认执行 |
 
 ## 常见链路
@@ -172,14 +104,8 @@ yapi search --q <keyword> --limit 10
 yapi interface-get --interfaceId <id>
 yapi log --interfaceId <id>
 
-# 创建接口步骤
-yapi category-list --projectId <id>
-yapi interface-create --projectId <id> --catId <cid> --title <t> --path <p> --confirm true
-yapi interface-mock-script --interfaceId <id> --script <s> --confirm true
-yapi interface-list --projectId <id>
-
-# 接口完整上下文
-yapi interface-get --interfaceId <id>
-yapi interface-mock-toggle --interfaceId <id>
-yapi log --interfaceId <id>
+# 创建接口 → 设 Mock → 测试
+yapi interface-create --projectId <id> --catId <cid> --title '用户列表' --path /api/user/list --confirm true
+yapi interface-mock-script --interfaceId <iid> --script 'mockJson = { code: 0, data: [] };' --confirm true
+yapi test-get --url 'https://mock.yapi.example.com/api/user/list'
 ```

package/skills/yapi-cli/reference/mock.md

@@ -0,0 +1,93 @@
+# 高级 Mock
+
+高级 Mock 包含两类能力：
+
+- **Mock 期望**：按请求参数 / IP 匹配，返回指定的 HTTP Code、Header、Body 和延迟。
+- **自定义 Mock 脚本**：在沙箱中执行 JS，动态修改响应内容。
+
+优先级：Mock 期望 > 自定义 Mock 脚本 > 项目全局 Mock 脚本 > 普通 Mock。
+
+## Mock 期望
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 列出期望 | `mock-expect-list` | `yapi mock-expect-list --interfaceId <id>` | 看某接口全部期望 |
+| 查看期望 | `mock-expect-get` | `yapi mock-expect-get --caseId <id>` | ObjectId 字符串 |
+| 新增/更新期望 | `mock-expect-save` | `yapi mock-expect-save --interfaceId <id> --projectId <id> --name <name> --resBody <json> [--params <json>] [--ipEnable false] [--ip <ip>] [--code 200] [--delay 0] [--headers <json>] [--caseId <id>] --confirm true` | caseId 存在则更新 |
+| 删除期望 | `mock-expect-delete` | `yapi mock-expect-delete --caseId <id> --confirm true` | 不可恢复 |
+| 启用/禁用期望 | `mock-expect-toggle` | `yapi mock-expect-toggle --caseId <id> --enable true --confirm true` | 快速开关 |
+
+## 自定义 Mock 脚本
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 获取脚本 | `mock-script-get` | `yapi mock-script-get --interfaceId <id>` | 读高级 Mock 脚本 |
+| 保存脚本 | `mock-script-save` | `yapi mock-script-save --interfaceId <id> --projectId <id> --script <js> [--enable true] --confirm true` | 空字符串可清空 |
+
+脚本沙箱可用变量：
+
+- `header` — 请求头
+- `params` — 合并后的 query + body 参数
+- `cookie` — 请求 Cookies
+- `mockJson` — 接口定义的 Mock 模板，可重写
+- `resHeader` — 响应头
+- `httpCode` — 响应状态码
+- `delay` — 响应延迟（毫秒）
+- `Random` — Mock.Random 方法
+
+示例脚本：
+
+```js
+if (params.type == 1) {
+  mockJson.errcode = 400;
+  mockJson.errmsg = 'error';
+}
+
+mockJson = {
+  errcode: 0,
+  email: Random.email('qq.com'),
+  data: [{ city: Random.city() + '银行' }]
+};
+httpCode = 200;
+delay = 500;
+```
+
+## 说明
+
+- 项目级 Mock 脚本（全局）在 `reference/project.md` 中管理：`project-mock-script`。
+- 接口级普通 Mock 脚本在 `reference/interface.md` 中管理：`interface-mock-script`。
+- 本页命令全部走 `/api/plugin/advmock/...`，需要 YApi 启用 `yapi-plugin-advanced-mock` 插件。
+
+## 参数对照
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| `interfaceId` | number | 是 | 接口 ID |
+| `projectId` | number | save 时必填 | 项目 ID |
+| `caseId` | string | get/delete/toggle/save(更新) | 期望 ID（MongoDB ObjectId） |
+| `name` | string | save | 期望名称 |
+| `resBody` | string | save | 期望返回 Body |
+| `params` | JSON 字符串 | 否 | 请求参数匹配条件 |
+| `ipEnable` | boolean | 否 | 是否启用 IP 过滤 |
+| `ip` | string | ipEnable=true 时必填 | 客户端 IP |
+| `code` | number | 否 | HTTP 状态码，默认 200 |
+| `delay` | number | 否 | 响应延迟，默认 0 |
+| `headers` | JSON 数组字符串 | 否 | 响应头 `[{"name":"X","value":"1"}]` |
+| `script` | string | mock-script-save | JS 脚本，空字符串清空 |
+| `enable` | boolean | 否 | 是否启用脚本/期望 |
+| `confirm` | boolean | 写操作 | 确认执行 |
+
+## 常见链路
+
+```bash
+# 配置高级 Mock 脚本
+yapi mock-script-get --interfaceId <id>
+yapi mock-script-save --interfaceId <id> --projectId <pid> --script '<js>' --confirm true
+
+# 添加 Mock 期望
+yapi mock-expect-list --interfaceId <id>
+yapi mock-expect-save --interfaceId <id> --projectId <pid> --name 'success' --resBody '{"code":0}' --params '{"type":"1"}' --confirm true
+
+# 开关期望
+yapi mock-expect-toggle --caseId <caseId> --enable false --confirm true
+```

package/skills/yapi-cli/reference/overview.md

@@ -6,13 +6,14 @@ yapi-cli 是 YApi 的命令行客户端，基于 InMemoryCliRegistry + Zod schem
 
 ```
 src/
-  bin/yapi.js               — 入口脚本
-  cli.ts                    — CLI 运行器（内置命令：help/version/doctor/changelog/completion）
+  bin/yapi.ts               — 入口脚本
+  cli.ts                    — CLI 运行器（内置命令：help/list/version/install/update/uninstall/remove/doctor/changelog/completion）
   core/
     cli-registry.ts         — InMemoryCliRegistry（命令注册 + 参数解析）
     cli-output.ts           — 帮助输出渲染
     errors.ts               — CliError 分层错误
-    output.ts               — OutputFormatter（pretty / json 双模式）
+    manifest.ts             — 命令清单加载与分组映射
+    output.ts               — OutputFormatter（pretty / compact / normal / verbose）
     write-guard.ts          — 写保护（YAPI_DISABLE_WRITE + confirm）
     doctor.ts               — 自检命令
     changelog.ts            — 版本变更解析
@@ -20,7 +21,7 @@ src/
     update-probe.ts         — npm 版本探测
   install.ts                — 安装/更新/卸载
   services/yapi/            — YApi 服务层
-    api.ts                  — YApi API 客户端（101 路由端点全覆盖）
+    api.ts                  — YApi API 客户端
     auth.ts                 — 认证管理（Token + JWT Cookie + LDAP）
     config.ts               — 配置管理（JSON）
     cache.ts                — 缓存
@@ -28,11 +29,12 @@ src/
     logger.ts               — 日志
     types.ts                — 类型定义
   tools/yapi/
-    register.ts             — 命令注册组合器
+    register.ts             — 命令注册组合器 + 分组清单
     register-auth.ts        — 认证/配置命令
     register-group.ts       — 分组命令
     register-project.ts     — 项目命令
     register-interface.ts   — 接口命令
+    register-mock.ts        — 高级 Mock 命令
     register-util.ts        — 用户/集合/工具命令
     register-test.ts        — 测试命令
     utils.ts                — 工具函数