@cloudglab/yapi-cli 0.0.1

package/dist/tools/yapi/utils.js

@@ -0,0 +1,28 @@
+import { YApiService, YApiAuthService, requireConfig, YAPI_HOME } from '../../services/yapi/index.js';
+/** 从配置创建 YApi 服务实例 */
+export function createYApiServices() {
+    const config = requireConfig();
+    const auth = new YApiAuthService(YAPI_HOME);
+    const api = new YApiService(config.serverUrl, () => auth.getAuthHeaders(), () => auth.getToken() ?? config.token ?? '');
+    return { config, auth, api };
+}
+/** 格式化方法/状态标签 */
+export function formatMethod(method) {
+    const colors = {
+        GET: 'GET',
+        POST: 'POST',
+        PUT: 'PUT',
+        DELETE: 'DEL',
+        PATCH: 'PATCH',
+        HEAD: 'HEAD',
+        OPTIONS: 'OPT',
+    };
+    return colors[method] ?? method;
+}
+/** 截断字符串 */
+export function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return `${text.slice(0, maxLength - 3)}...`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/tools/yapi/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/tools/yapi/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEtG,sBAAsB;AACtB,MAAM,UAAU,kBAAkB;IAKhC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,WAAW,CACzB,MAAM,CAAC,SAAS,EAChB,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,EAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAC5C,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,MAAM,GAA2B;QACrC,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;QACV,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,KAAK;KACf,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;AAClC,CAAC;AAED,YAAY;AACZ,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAiB;IACtD,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC;AAC9C,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const CLI_VERSION = "0.0.0";

package/dist/version.js

@@ -0,0 +1,2 @@
+export const CLI_VERSION = '0.0.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@cloudglab/yapi-cli",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "yapi": "dist/bin/yapi.js",
+    "yapi-cli": "dist/bin/yapi.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && node scripts/copy-skills.mjs && tsc -p tsconfig.json && node scripts/fix-bin-mode.mjs",
+    "dev": "tsx src/bin/yapi.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.9",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "packageManager": "pnpm@10.24.0"
+}

package/skills/yapi-cli/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: yapi-cli
+description: YApi CLI 技能包 - 管理 YApi 项目/接口/分组的命令行工具
+triggers:
+  - yapi
+  - yapi-cli
+  - YApi
+  - 接口管理
+  - 接口文档
+  - mock
+argument-hint: "[command]"
+---
+
+# @cloudglab/yapi-cli
+
+## 概览
+
+把 YApi 接口管理能力暴露给命令行 / 智能体使用，默认带写保护。
+
+建议把它当成一个"命令行技能包"：先安装，再按 `reference/` 文档执行。
+
+## 命令选择强制规则
+
+- 不确定命令名或参数时，先查 `reference/*.md`，不要猜参数名。
+- 需要确认某条命令参数时，优先运行 `yapi help <command>`。
+- 如果 CLI 返回 `未知参数`，立即运行 `yapi help <command>` 校对参数；不要换一个看起来相似但未确认的参数。
+- 默认只预览（preview）；写操作必须显式传 `--confirm true`。
+- 如需全局禁用写操作，设置 `YAPI_DISABLE_WRITE=true`。
+
+## Reference 路由表
+
+- 分组 / 我的分组 / 分组详情 / 分组成员：`reference/group.md`
+- 项目 / 项目列表 / 项目详情 / 环境配置 / 项目成员 / 关注项目：`reference/project.md`
+- 接口 / 接口列表 / 接口详情 / 接口 CRUD / 分类 / Mock 开关 / Mock 脚本：`reference/interface.md`
+- 接口搜索：`reference/interface.md#搜索`
+- 测试 / HTTP 方法测试 / 上传测试 / 自动测试：`reference/test.md`
+- 用户 / 用户列表 / 用户搜索 / 头像：`reference/auth.md#用户管理`
+- 认证 / 登录 / 登出 / 当前用户：`reference/auth.md`
+- 配置 / 初始化 / 安装 / 更新 / 卸载 / 版本 / 自检：`reference/install.md`
+- 导出 / 日志 / 集合 / 文档同步：`reference/interface.md`
+
+## 入口优先级
+
+1. 本机已安装 `yapi`：直接执行
+2. 未安装时：`npm i -g @cloudglab/yapi-cli@latest`
+3. 只能临时使用时：`npx -y @cloudglab/yapi-cli@latest`
+4. 默认只 preview；写操作必须显式确认
+
+## 安装 / 更新
+
+一键安装 CLI + skill：
+
+```bash
+yapi install
+npx -y @cloudglab/yapi-cli@latest install
+```
+
+更新 CLI + skill：
+
+```bash
+yapi update
+yapi update --cli-only
+yapi update --skill-only
+```
+
+卸载：
+
+```bash
+yapi uninstall
+yapi uninstall --confirm true
+```
+
+## 启动方式
+
+```bash
+yapi --help
+yapi help
+yapi help <command>
+yapi version
+yapi whoami
+yapi doctor
+```
+
+或直接：
+
+```bash
+npx -y @cloudglab/yapi-cli@latest
+npx -y @cloudglab/yapi-cli@latest --help
+```
+
+## 文档入口
+
+- `reference/overview.md`
+- `reference/install.md`
+- `reference/cli.md`
+- `reference/commands.md`
+- `reference/auth.md`
+- `reference/group.md`
+- `reference/project.md`
+- `reference/interface.md`
+- `reference/test.md`
+
+## 典型能力
+
+- 查分组 / 项目 / 接口 / 分类
+- 接口搜索、CRUD、Mock 开关与脚本
+- 环境配置、成员管理、关注项目
+- HTTP 方法测试（GET/POST/PUT/DELETE/HEAD/OPTIONS/PATCH）
+- 上传测试、自动测试、接口导入导出
+- 用户管理、日志查询、集合管理
+- 配置初始化、安装 / 更新 / 卸载、自检
+
+## 写保护
+
+默认支持写操作；真实写入仍需要显式确认：
+
+- `--confirm true`
+
+如需禁用写操作，设置：
+
+- `YAPI_DISABLE_WRITE=true`
+
+## 运行时要求
+
+- 发布产物：`Node.js >= 18`
+- 开发 / 构建环境可以高于 18

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

@@ -0,0 +1,106 @@
+# 认证 & 用户管理
+
+## 强制判断
+
+在调用任何认证或用户管理命令前，先判断用户意图：
+
+1. **配置初始化** → 新用户首次使用，需要 `--server` + `--token`（或后面再 login）
+2. **登录** → 区分 token 登录 vs 密码登录（LDAP/本地账号均走密码登录）
+3. **查看当前用户** → `whoami`，不需要参数
+4. **用户管理** → 管理员操作，需要确认是否有权限
+
+## 认证
+
+### 初始化配置
+
+```bash
+yapi config-init --server https://yapi.example.com --token <token>
+yapi config-init --server https://yapi.example.com --email <email> --password <password>
+```
+
+- `--server`：YApi 服务地址（必填）
+- `--token`：API Token（认证用，二选一）
+- `--email` + `--password`：账号密码（认证用，二选一）
+- `--projectId`：默认项目 ID（可选）
+
+### Token 登录
+
+```bash
+yapi login --token <token>
+yapi login-by-token --token <token> --uid <uid>
+```
+
+`login-by-token` 需要同时传 `--uid` 用于设置 `_yapi_uid` cookie。
+
+### 密码登录
+
+```bash
+yapi login --email <email> --password <password>
+```
+
+支持 LDAP 和本地账号。YApi 服务端统一处理认证方式。
+
+### 登出
+
+```bash
+yapi logout
+```
+
+清除本地认证缓存，同时调用服务端登出接口。
+
+### 查看当前用户
+
+```bash
+yapi whoami
+```
+
+优先从本地认证缓存读取，失败时回退到服务端查询。
+
+## 用户管理
+
+### 用户列表
+
+```bash
+yapi user-list
+```
+
+列出所有注册用户。
+
+### 搜索用户
+
+```bash
+yapi user-search --q <keyword>
+```
+
+支持按用户名或邮箱搜索。
+
+### 注册用户
+
+```bash
+yapi user-register --username <name> --password <pass> --email <email> --confirm true
+```
+
+### 删除用户
+
+```bash
+yapi user-delete --uid <uid> --confirm true
+```
+
+### 用户头像
+
+```bash
+yapi user-avatar --uid <uid>
+yapi user-upload-avatar --uid <uid> --imagePath <path> --confirm true
+```
+
+## 参数对照
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| `server` | string | config-init | YApi 服务地址 |
+| `token` | string | login 二选一 | API Token |
+| `email` | string | login 二选一 | 登录邮箱 |
+| `password` | string | login 二选一 | 登录密码 |
+| `uid` | number | user-delete/avatar | 用户 ID |
+| `username` | string | user-register | 用户名 |
+| `confirm` | boolean | 写操作 | 确认执行 |

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

@@ -0,0 +1,60 @@
+# CLI 命令参考
+
+## 入口
+
+- `yapi --help` — 查看帮助
+- `yapi <command> --<key> <value>` — 执行命令
+- `yapi help <command>` — 查看单命令帮助
+- `yapi version` — 查看版本
+- `yapi doctor` — 自检
+- `yapi completion --shell bash` — 生成补全脚本
+
+## 参数规则
+
+- 参数名使用 kebab-case：`--project-id`、`--group-id`、`--interface-id`
+- 支持 `=` 语法：`--project-id=60`
+- 数组参数可重复：`--tag a --tag b`
+- JSON 对象参数：`--body '{"key":"value"}'`
+- 全局 `--json`：输出 JSON 格式（替代 pretty）
+- 写操作需要 `--confirm true`
+
+## 81 个命令总览
+
+### 认证 & 配置（5 个）
+
+`config-init` `login` `login-by-token` `logout` `whoami`
+
+### 分组（6 个）
+
+`group-list` `group-get` `group-add` `group-up` `group-del` `member-list`
+
+### 项目（10 个）
+
+`project-list` `project-get` `project-token` `env` `member` `member-change-role` `follow` `project-mock-toggle` `project-mock-script` `interface-upload`
+
+### 接口（15 个）
+
+`search` `interface-list` `interface-get` `interface-create` `interface-update` `interface-delete` `interface-mock-toggle` `interface-mock-script` `category-list` `interface-up-cat-index` `interface-up-index` `request` `log` `export` `interface-download-crx`
+
+### 用户（6 个）
+
+`user-list` `user-search` `user-register` `user-delete` `user-avatar` `user-upload-avatar`
+
+### 测试（14 个）
+
+`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` `run-auto-test` `project-interface-data`
+
+### 集合（2 个）
+
+`col-list` `col-cases`
+
+### 系统（8 个）
+
+`install` `update` `uninstall` `doctor` `changelog` `completion` `install-skill` `docs-sync`
+
+## 扩展
+
+- 新命令在 `src/tools/yapi/register-*.ts` 中用 `registry.tool(name, schema, handler, desc, metadata)` 注册
+- 参数类型用 Zod schema：`z.string()` / `z.coerce.number()` / `z.boolean()` / `z.enum([...])`
+- Handler 返回 `jsonResult({...})`，自动按 format 输出
+- 元数据：`costHint`（low/medium/high）+ `nextBestTools`（相关命令推荐）

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

@@ -0,0 +1,152 @@
+# 命令速查
+
+## 使用规则
+
+- 先按用户场景选命令，再用 `yapi help <command>` 校对参数。
+- 参数名以 `yapi help <command>` 输出为准；不要猜 `id`、`projectId`、`interfaceId` 这类相似参数。
+- 读命令不需要 `confirm=true`；写操作（create/update/delete/upload/toggle/script）必须显式传 `--confirm true`。
+- 如果命令返回 `未知参数`，立即运行 `yapi help <command>` 修正命令。
+- 本机没有 `yapi` 时，用 `npx -y @cloudglab/yapi-cli@latest <command> ...`。
+
+## 认证 & 配置
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 初始化配置 | `config-init` | `yapi config-init --server <url> [--token <t>] [--projectId <id>]` | 首次使用必做 |
+| Token 登录 | `login` | `yapi login --token <t>` | 用 token 认证 |
+| 密码登录 | `login` | `yapi login --email <e> --password <p>` | LDAP/本地账号均可 |
+| Token 快捷登录 | `login-by-token` | `yapi login-by-token --token <t> [--uid <uid>]` | 纯 token 登录 |
+| 登出 | `logout` | `yapi logout` | 清除本地认证缓存 + 服务端登出 |
+| 查看当前用户 | `whoami` | `yapi whoami` | 返回当前用户信息 |
+
+## 分组
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 分组列表 | `group-list` | `yapi group-list` | 列出可见分组 |
+| 分组详情 | `group-get` | `yapi group-get --groupId <id>` | 查分组详细信息 |
+| 创建分组 | `group-add` | `yapi group-add --groupName <name> [--groupDesc <d>] --confirm true` | 写操作 |
+| 更新分组 | `group-up` | `yapi group-up --groupId <id> [--groupName <n>] [--groupDesc <d>] --confirm true` | 写操作 |
+| 删除分组 | `group-del` | `yapi group-del --groupId <id> --confirm true` | 写操作 |
+| 分组成员 | `member-list` | `yapi member-list --groupId <id>` | 列出分组下的成员 |
+
+## 项目
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 项目列表 | `project-list` | `yapi project-list [--groupId <id>] [--page <n>] [--limit <n>]` | 可按分组过滤 |
+| 项目详情 | `project-get` | `yapi project-get --projectId <id>` | 查项目信息 |
+| 项目 Token | `project-token` | `yapi project-token --projectId <id>` | 获取项目 token |
+| 环境配置 | `env` | `yapi env --projectId <id>` | 项目环境变量 |
+| 项目成员 | `member` | `yapi member --projectId <id>` | 项目成员列表 |
+| 改成员角色 | `member-change-role` | `yapi member-change-role --projectId <id> --memberUid <uid> --role <role> --confirm true` | 写操作 |
+| 关注项目 | `follow` | `yapi follow` | 我关注的项目列表 |
+| Mock 开关 | `project-mock-toggle` | `yapi project-mock-toggle --projectId <id> [--open true] --confirm true` | 开关项目级 Mock |
+| Mock 脚本 | `project-mock-script` | `yapi project-mock-script --projectId <id> [--script <s>] --confirm true` | 设置项目 Mock 脚本 |
+| 导入接口 | `interface-upload` | `yapi interface-upload --projectId <id> --content <json> [--type swagger] --confirm true` | 批量导入 |
+
+## 接口
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 搜索接口 | `search` | `yapi search --q <keyword> [--projectId <id>] [--page <n>] [--limit <n>]` | 关键词搜索 |
+| 接口列表 | `interface-list` | `yapi interface-list --projectId <id> [--status <s>] [--method <m>] [--page <n>] [--limit <n>]` | 按项目查接口 |
+| 接口详情 | `interface-get` | `yapi interface-get --interfaceId <id>` | 查看接口定义 |
+| 创建接口 | `interface-create` | `yapi interface-create --projectId <n> --catId <n> --title <s> --path <s> [--method GET] [--desc <s>] --confirm true` | 写操作 |
+| 更新接口 | `interface-update` | `yapi interface-update --interfaceId <id> [--title <s>] [--path <s>] [--method <m>] --confirm true` | 写操作 |
+| 删除接口 | `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 <s>] --confirm true` | 设置接口 Mock 脚本 |
+| 分类列表 | `category-list` | `yapi category-list --projectId <id>` | 项目的接口分类 |
+| 分类排序 | `interface-up-cat-index` | `yapi interface-up-cat-index --catid <id> --index <n> --confirm true` | 调整分类排序 |
+| 接口排序 | `interface-up-index` | `yapi interface-up-index --interfaceId <id> --index <n> --confirm true` | 调整接口排序 |
+| 原始请求 | `request` | `yapi request --path <s> [--method GET] [--body <json>]` | 发送任意请求 |
+| 日志 | `log` | `yapi log --interfaceId <id> [--projectId <id>]` | 查看接口更新日志 |
+| 导出 | `export` | `yapi export --projectId <id> [--type json]` | 导出接口定义 |
+| 下载 CRX | `interface-download-crx` | `yapi interface-download-crx` | 下载 YApi 跨域插件 |
+
+## 用户管理
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 用户列表 | `user-list` | `yapi user-list` | 列出所有用户 |
+| 搜索用户 | `user-search` | `yapi user-search --q <keyword>` | 按关键词搜索用户 |
+| 注册用户 | `user-register` | `yapi user-register --username <u> --password <p> --email <e> [--role <r>] --confirm true` | 写操作 |
+| 删除用户 | `user-delete` | `yapi user-delete --uid <uid> --confirm true` | 写操作 |
+| 用户头像 | `user-avatar` | `yapi user-avatar --uid <uid>` | 查看用户头像 |
+| 上传头像 | `user-upload-avatar` | `yapi user-upload-avatar --uid <uid> --imagePath <path> --confirm true` | 写操作 |
+
+## 测试
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| GET 测试 | `test-get` | `yapi test-get --url <url> [--params <json>]` | HTTP GET 请求测试 |
+| POST 测试 | `test-post` | `yapi test-post --url <url> [--body <json>]` | HTTP POST 请求测试 |
+| PUT 测试 | `test-put` | `yapi test-put --url <url> [--body <json>]` | HTTP PUT 请求测试 |
+| DELETE 测试 | `test-delete` | `yapi test-delete --url <url>` | HTTP DELETE 请求测试 |
+| HEAD 测试 | `test-head` | `yapi test-head --url <url>` | HTTP HEAD 请求测试 |
+| OPTIONS 测试 | `test-options` | `yapi test-options --url <url>` | HTTP OPTIONS 请求测试 |
+| PATCH 测试 | `test-patch` | `yapi test-patch --url <url> [--body <json>]` | HTTP PATCH 请求测试 |
+| 文件上传 | `test-files-upload` | `yapi test-files-upload --url <url> --filePaths <p1> [--params <json>]` | 多文件上传测试 |
+| 单文件上传 | `test-single-upload` | `yapi test-single-upload --url <url> --filePath <p>` | 单文件上传测试 |
+| HTTP 状态码 | `test-http-code` | `yapi test-http-code --url <url>` | 检查响应状态码 |
+| 原始响应 | `test-raw` | `yapi test-raw --url <url>` | 查看原始响应 |
+| 响应结构 | `test-response` | `yapi test-response --url <url>` | 查看完整响应结构 |
+| 自动测试 | `run-auto-test` | `yapi run-auto-test --projectId <id> [--format json]` | 运行项目自动测试 |
+| 项目接口数据 | `project-interface-data` | `yapi project-interface-data --projectId <id>` | 查询项目接口测试数据 |
+
+## 集合
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 集合列表 | `col-list` | `yapi col-list --projectId <id>` | 项目下的测试集合列表 |
+| 集合用例 | `col-cases` | `yapi col-cases --projectId <id> --colId <id>` | 集合下的测试用例 |
+
+## 系统
+
+| 场景 | 命令 | 用法 | 说明 |
+| --- | --- | --- | --- |
+| 自检 | `doctor` | `yapi doctor` | 检查 Node/配置/网络连通性 |
+| 版本 | `version` | `yapi version [--json] [--verbose]` | 查看版本详情 |
+| 变更日志 | `changelog` | `yapi changelog [--limit <n>] [--version <v>]` | 查看版本变更历史 |
+| 更新 | `update` | `yapi update [--cli-only] [--skill-only]` | 更新 CLI + skill |
+| 安装 skill | `install-skill` | `yapi install-skill` | 安装 skill 到本地 |
+| 文档同步 | `docs-sync` | `yapi docs-sync [--path <p>] [--validate]` | 从 markdown 同步文档 |
+| Shell 补全 | `completion` | `yapi completion [--shell bash]` | 生成 shell 补全脚本 |
+
+## 常用组合
+
+### 查一个项目的完整上下文
+
+```bash
+yapi project-get --projectId <id>
+yapi interface-list --projectId <id> --limit 100
+yapi category-list --projectId <id>
+yapi env --projectId <id>
+yapi member --projectId <id>
+```
+
+### 创建并配置新接口
+
+```bash
+yapi category-list --projectId <id>          # 确认分类 ID
+yapi interface-create --projectId <id> --catId <cid> --title <t> --path <p> --confirm true
+yapi interface-list --projectId <id>          # 验证已创建
+yapi interface-mock-script --interfaceId <iid> --script <s> --confirm true
+```
+
+### 查接口详情 + 日志 + Mock 状态
+
+```bash
+yapi interface-get --interfaceId <id>
+yapi log --interfaceId <id>
+yapi interface-mock-toggle --interfaceId <id>
+```
+
+### 搜索 + 测试
+
+```bash
+yapi search --q <keyword> --limit 20
+yapi interface-get --interfaceId <id>
+yapi test-get --url <url>
+```

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

@@ -0,0 +1,77 @@
+# 分组
+
+## 强制判断
+
+先确认用户想查的是**分组**还是**项目**：
+
+- "分组" → YApi 的 Group，顶级容器
+- "项目" → YApi 的 Project，隶属于分组
+
+用户给分组名时，先用 `group-list` 查全部分组，匹配名称确认 `groupId`。
+
+## 查询
+
+### 分组列表
+
+```bash
+yapi group-list
+```
+
+返回可见的全部分组（id / group_name / group_desc）。
+
+### 分组详情
+
+```bash
+yapi group-get --groupId <id>
+```
+
+查分组基本信息、成员数等。
+
+## 写入
+
+### 创建分组
+
+```bash
+yapi group-add --groupName <name> [--groupDesc <desc>] --confirm true
+```
+
+### 更新分组
+
+```bash
+yapi group-up --groupId <id> [--groupName <name>] [--groupDesc <desc>] --confirm true
+```
+
+### 删除分组
+
+```bash
+yapi group-del --groupId <id> --confirm true
+```
+
+### 分组成员
+
+```bash
+yapi member-list --groupId <id>
+```
+
+## 参数对照
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| `groupId` | number | group-get/up/del/member-list | 分组 ID |
+| `groupName` | string | group-add | 分组名称 |
+| `groupDesc` | string | 否 | 分组描述 |
+| `confirm` | boolean | 写操作 | 确认执行 |
+
+## 常见链路
+
+```bash
+# 查全部分组 → 定位目标分组 → 查看详情
+yapi group-list
+yapi group-get --groupId <id>
+
+# 查分组下的项目
+yapi project-list --groupId <id>
+
+# 查分组成员
+yapi member-list --groupId <id>
+```

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

@@ -0,0 +1,82 @@
+# 安装 / 更新 / 卸载
+
+## 安装
+
+全量安装（CLI + skill + 配置）：
+
+```bash
+yapi install
+yapi install --server https://yapi.example.com --token <token>
+npx -y @cloudglab/yapi-cli@latest install
+```
+
+仅 skill：
+
+```bash
+yapi install --skill-only
+```
+
+仅 CLI 配置：
+
+```bash
+yapi install --cli-only --server https://yapi.example.com --token <token>
+```
+
+从源码安装 skill：
+
+```bash
+yapi install --skill-source git
+# 或
+npx -y @cloudglab/yapi-cli@latest install --skill-source git
+npx -y @cloudglab/yapi-cli@latest install --skill-local-path ./package
+```
+
+## 更新
+
+```bash
+yapi update
+yapi update --cli-only
+yapi update --skill-only
+yapi update --skip-config-check
+```
+
+更新会先检查 npm 版本，再刷新本地 skill。
+
+## 卸载
+
+```bash
+yapi uninstall
+yapi uninstall --confirm true           # 真实卸载
+yapi uninstall --confirm true --keep-config true   # 保留配置
+```
+
+## 自检
+
+```bash
+yapi doctor
+yapi doctor --verbose                   # 含网络探测
+yapi doctor --json                      # JSON 报告
+```
+
+## 全局安装
+
+```bash
+npm i -g @cloudglab/yapi-cli@latest
+yapi --version
+yapi --help
+```
+
+## 配置位置
+
+| 文件 | 路径 |
+|------|------|
+| CLI 配置 | `~/.yapi/config.json` |
+| 认证缓存 | `~/.yapi/.yapi-auth` |
+| API 缓存 | `~/.yapi/.yapi-cache/cache.json` |
+
+## 环境变量
+
+| 变量 | 作用 |
+|------|------|
+| `YAPI_DISABLE_WRITE=true` | 禁用所有写操作（preview 模式） |
+| `CI=true` | 非交互模式 |