@cloudglab/yapi-cli 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.0.0 - 2026-06-19
+
+- 初始化通用 CLI 骨架。

package/README.md

@@ -0,0 +1,131 @@
+# yapi-cli
+
+![yapi-cli hero](./assets/readme/yapi-cli-hero.svg)
+
+把 YApi 的查询、登录、同步、安装、更新、自检和补全能力接到命令行，方便在终端、脚本、CI 和 AI Skill 里直接调用。
+
+除了标准 REST API，本工具还补充了部分扩展场景：会在必要时读取配置、做更新探测、生成补全脚本，或把常见查询封装成可调用命令，适合自动化和 Agent 工作流。
+
+## 这版补了什么
+
+- 默认 JSON 输出适合 AI / 脚本消费：统一走 `jsonResult`，并可切到 `pretty` 人类可读模式。
+- 新增内置命令：`doctor`、`changelog`、`completion`，补齐安装 / 更新 / 卸载 / 版本查看链路。
+- 登录同时支持 `--token` 和 `--email --password`，可覆盖 token 认证、普通账号和 LDAP 登录场景。
+- 命令层统一使用 `InMemoryCliRegistry + Zod schema + jsonResult`，便于 Agent 稳定调用。
+- 共享了分页、项目 ID、可选文本、布尔值和导出格式等 Zod 片段，减少重复定义。
+- API 客户端加入超时、重试和错误分层，遇到认证 / 网络 / 配置错误时可直接判断。
+
+## 典型变化
+
+- **输出模式**：`yapi --json ...` 会返回 JSON 结果；默认模式在终端输出更适合人工阅读的文本。
+- **自检**：`yapi doctor --verbose` 可检查 Node 版本、配置、网络连通性和认证状态。
+- **版本记录**：`yapi changelog --limit 5`、`--version`、`--since`、`--raw` 都可用。
+- **补全**：`yapi completion bash|zsh|fish` 会生成对应 shell 的补全脚本。
+- **更新探测**：`yapi update` 会先探测 npm 版本，再刷新 skill 文件。
+
+## 版本要求
+
+- **Node.js 版本**：需要 **Node.js >= 18**。
+- **YApi 版本**：支持 YApi 常见 REST API 和登录接口；登录方式同时兼容 token、普通账号和 LDAP 后端。
+
+## 安装方式
+
+### 推荐：一键安装 CLI + Skill
+
+```bash
+npx -y yapi-cli@latest install
+```
+
+该命令会安装全局 CLI 和内置 Skill，并在配置缺失或登录失败时给出引导。配置完成后即可直接使用查询命令。
+
+如果需要重新安装 skill，可直接运行：
+
+```bash
+yapi install
+```
+
+如果想先检查更新再决定是否升级：
+
+```bash
+yapi update
+```
+
+## 常用命令示例
+
+```bash
+yapi help
+yapi list
+yapi version --verbose
+yapi doctor
+yapi changelog --limit 5
+yapi completion bash
+```
+
+```bash
+yapi config-init --server https://yapi.example.com
+yapi login --token xxx
+yapi login --email user@example.com --password secret
+yapi whoami
+```
+
+```bash
+yapi group-list
+yapi project-list --project-id 1
+yapi interface-list --project-id 1 --limit 20
+yapi request --path /api/user/status
+```
+
+```bash
+yapi user-list
+yapi user-search --query alice
+yapi col-list --project-id 1
+yapi docs-sync --file docs/api.md --project-id 1 --cat-id 2
+```
+
+## 可以这样问
+
+下面这些自然语言请求可以交给 AI Skill / Agent 转成对应的 yapi-cli 命令。
+
+### 账号 / 登录
+
+- 看我当前是否登录。
+- 用 token 登录。
+- 用邮箱和密码登录。
+- 检查当前配置是否可用。
+
+### 项目 / 分组 / 接口
+
+- 列出项目下的接口。
+- 看某个接口的详情。
+- 搜索某个关键词相关的接口。
+- 看某个项目的分类、成员和环境。
+
+### 用户 / 集合 / 导出
+
+- 列出用户。
+- 搜索用户。
+- 查看测试集合。
+- 导出项目数据。
+
+### 文档同步 / 维护
+
+- 把 Markdown 文档同步到 YApi。
+- 检查当前环境是否健康。
+- 看版本变更记录。
+- 生成 shell 补全脚本。
+
+## 目录结构
+
+- `src/core/`：命令注册、解析、输出、自检、更新、补全。
+- `src/services/yapi/`：YApi 服务层、认证、缓存和配置。
+- `src/tools/yapi/`：业务命令注册入口。
+- `.agents/skills/yapi-cli/`：skill 源目录。
+- `skills/yapi-cli/`：构建时复制后的发布目录。
+
+## 验证
+
+```bash
+pnpm typecheck
+pnpm build
+pnpm test
+```

package/dist/bin/yapi.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/yapi.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { runCli } from '../cli.js';
+await runCli(process.argv.slice(2)).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=yapi.js.map

package/dist/bin/yapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yapi.js","sourceRoot":"","sources":["../../src/bin/yapi.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC3D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export declare function runCli(rawArgs: string[], appName?: string): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,203 @@
+import { CLI_VERSION } from './version.js';
+import { runInstallCommand, runUninstallCommand, runUpdateCommand } from './install.js';
+import { formatCommandResult, printCommandHelp, printHelp } from './core/cli-output.js';
+import { InMemoryCliRegistry, parseCommandInput } from './core/cli-registry.js';
+import { registerTools } from './tools/index.js';
+import { runDoctor } from './core/doctor.js';
+import { runChangelog } from './core/changelog.js';
+import { generateCompletionScript } from './core/completion.js';
+import { checkForUpdates, getUpdateSuggestion } from './core/update-probe.js';
+import { handleCliError } from './core/errors.js';
+import { setOutputFormat, getOutputFormatter } from './tools/shared.js';
+const BUILTIN_COMMANDS = ['help', 'list', 'version', 'install', 'update', 'uninstall', 'remove', 'doctor', 'changelog', 'completion'];
+function parseTopLevelArgs(rawArgs) {
+    const args = [...rawArgs];
+    if (args.length === 0) {
+        return { commandArgs: [] };
+    }
+    if (args[0] === '--help' || args[0] === '-h') {
+        return { commandName: 'help', commandArgs: args.slice(1) };
+    }
+    if (args[0] === '--version' || args[0] === '-v') {
+        return { commandName: 'version', commandArgs: args.slice(1) };
+    }
+    return {
+        commandName: args[0],
+        commandArgs: args.slice(1),
+    };
+}
+function isHelpFlag(args) {
+    return args.includes('--help') || args.includes('-h');
+}
+function isJsonFlag(args) {
+    return args.includes('--json');
+}
+export async function runCli(rawArgs, appName = 'yapi-cli') {
+    // 检查全局 --json 标志，设置输出格式
+    if (isJsonFlag(rawArgs)) {
+        setOutputFormat('json');
+    }
+    else {
+        setOutputFormat('pretty');
+    }
+    const registry = new InMemoryCliRegistry();
+    registerTools(registry);
+    const { commandName, commandArgs } = parseTopLevelArgs(rawArgs);
+    // --- 无参 -> 总帮助 ---
+    if (!commandName || commandName === 'help') {
+        printHelp(appName, registry.listCommands());
+        return;
+    }
+    // --- list ---
+    if (commandName === 'list') {
+        printHelp(appName, registry.listCommands());
+        return;
+    }
+    // --- version ---
+    if (commandName === 'version') {
+        if (commandArgs.includes('--json')) {
+            process.stdout.write(`${JSON.stringify({ version: CLI_VERSION, name: appName }, null, 2)}\n`);
+        }
+        else if (commandArgs.includes('--verbose')) {
+            const updateInfo = checkForUpdates();
+            const lines = [
+                `${appName} v${CLI_VERSION}`,
+                `  包名: ${updateInfo.packageName}`,
+                `  Node: ${process.versions.node}`,
+                `  平台: ${process.platform}/${process.arch}`,
+            ];
+            if (updateInfo.error) {
+                lines.push(`  更新: ${updateInfo.error}`);
+            }
+            else if (updateInfo.latestVersion) {
+                lines.push(`  最新: ${updateInfo.latestVersion}`);
+                if (updateInfo.isUpdateAvailable) {
+                    lines.push(`  建议: ${getUpdateSuggestion(updateInfo)}`);
+                }
+            }
+            process.stdout.write(`${lines.join('\n')}\n`);
+        }
+        else {
+            process.stdout.write(`${CLI_VERSION}\n`);
+        }
+        return;
+    }
+    // --- install ---
+    if (commandName === 'install') {
+        await runInstallCommand(commandArgs, appName);
+        return;
+    }
+    // --- update ---
+    if (commandName === 'update') {
+        const updateInfo = checkForUpdates();
+        if (updateInfo.isUpdateAvailable) {
+            process.stdout.write(`${getUpdateSuggestion(updateInfo)}\n\n`);
+        }
+        else if (!updateInfo.error) {
+            process.stdout.write(`当前版本 ${CLI_VERSION} 已是最新。\n\n`);
+        }
+        else {
+            process.stdout.write(`${updateInfo.error}\n\n`);
+        }
+        await runUpdateCommand(commandArgs, appName);
+        return;
+    }
+    // --- uninstall / remove ---
+    if (commandName === 'uninstall' || commandName === 'remove') {
+        await runUninstallCommand(commandArgs, appName);
+        return;
+    }
+    // --- doctor ---
+    if (commandName === 'doctor') {
+        await runDoctor(commandArgs);
+        return;
+    }
+    // --- changelog ---
+    if (commandName === 'changelog') {
+        runChangelog(commandArgs);
+        return;
+    }
+    // --- completion ---
+    if (commandName === 'completion') {
+        const script = generateCompletionScript(registry.listCommands(), appName, commandArgs[0]);
+        process.stdout.write(script);
+        return;
+    }
+    // --- 业务命令 ---
+    const command = registry.getCommand(commandName);
+    if (!command) {
+        process.stderr.write(`未找到命令: ${commandName}\n运行 \`${appName} help\` 查看可用命令。\n`);
+        process.exitCode = 1;
+        return;
+    }
+    if (isHelpFlag(commandArgs)) {
+        printCommandHelp(appName, command);
+        return;
+    }
+    // 执行业务命令，统一错误处理
+    try {
+        const input = parseCommandInput(command.schema, commandArgs);
+        const result = await command.handler(input);
+        const output = getOutputFormatter();
+        output.printMessage(formatCommandResult(result));
+    }
+    catch (error) {
+        const msg = handleCliError(error);
+        process.stderr.write(`${msg}\n`);
+    }
+}
+function isBuiltin(name) {
+    return BUILTIN_COMMANDS.includes(name);
+}
+function printBuiltinHelp(appName, name) {
+    if (name === 'doctor') {
+        process.stdout.write([
+            `${appName} doctor [options]`,
+            '系统自检 — 检查 Node 版本、配置、网络连通性、认证状态。',
+            '',
+            '选项:',
+            '  --verbose    包含网络连通性检查（默认不检查）',
+            '  --json       以 JSON 格式输出报告',
+        ].join('\n') + '\n');
+    }
+    else if (name === 'changelog') {
+        process.stdout.write([
+            `${appName} changelog [options]`,
+            '查看版本变更历史。',
+            '',
+            '选项:',
+            '  --limit=<N>     只显示最近 N 个版本',
+            '  --version=<v>   显示指定版本',
+            '  --since=<v>     显示从该版本以来的变更',
+            '  --raw           输出原始 Markdown',
+        ].join('\n') + '\n');
+    }
+    else if (name === 'completion') {
+        process.stdout.write([
+            `${appName} completion [shell]`,
+            '生成 shell 补全脚本。支持 bash / zsh / fish。',
+            '',
+            '用法:',
+            `  source <(${appName} completion bash)  # bash`,
+            `  source <(${appName} completion zsh)   # zsh`,
+            `  ${appName} completion fish > ~/.config/fish/completions/${appName}.fish  # fish`,
+        ].join('\n') + '\n');
+    }
+    else if (name === 'update') {
+        process.stdout.write([
+            `${appName} update [options]`,
+            '检查 CLI 更新 + 刷新 skill 文件。',
+            '',
+            '选项:',
+            '  --cli-only   只检查 CLI 更新，不刷新 skill',
+            '  --skill-only 只刷新 skill，不检查 CLI 更新',
+        ].join('\n') + '\n');
+    }
+    else if (name === 'doctor' || name === 'install' || name === 'uninstall' || name === 'version') {
+        printHelp(appName, []);
+    }
+    else {
+        printHelp(appName, []);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/core/changelog.d.ts

@@ -0,0 +1,17 @@
+export interface ChangelogEntry {
+    version: string;
+    date: string;
+    lines: string[];
+}
+export interface ChangelogOptions {
+    limit?: number;
+    version?: string;
+    since?: string;
+    raw: boolean;
+}
+/** 解析 CHANGELOG.md 为结构化条目 */
+export declare function parseChangelog(content: string): ChangelogEntry[];
+/** 解析 changelog 命令行参数 */
+export declare function parseChangelogOptions(args: string[]): ChangelogOptions;
+/** 渲染 changelog 到 stdout */
+export declare function runChangelog(args: string[]): void;

package/dist/core/changelog.js

@@ -0,0 +1,117 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+/** 解析 CHANGELOG.md 为结构化条目 */
+export function parseChangelog(content) {
+    const entries = [];
+    const lines = content.split('\n');
+    let current = null;
+    for (const line of lines) {
+        const headerMatch = line.match(/^##\s+(\S+)\s*-\s*(.+)/);
+        if (headerMatch) {
+            if (current)
+                entries.push(current);
+            current = {
+                version: headerMatch[1],
+                date: headerMatch[2].trim(),
+                lines: [],
+            };
+            continue;
+        }
+        if (current) {
+            current.lines.push(line);
+        }
+    }
+    if (current)
+        entries.push(current);
+    return entries;
+}
+/** 解析 changelog 命令行参数 */
+export function parseChangelogOptions(args) {
+    const options = { raw: false };
+    for (let i = 0; i < args.length; i++) {
+        const token = args[i];
+        if (token === '--raw') {
+            options.raw = true;
+        }
+        else if (token.startsWith('--limit=')) {
+            options.limit = Number(token.slice('--limit='.length));
+        }
+        else if (token === '--limit') {
+            options.limit = Number(args[++i]);
+        }
+        else if (token.startsWith('--version=')) {
+            options.version = token.slice('--version='.length);
+        }
+        else if (token === '--version') {
+            options.version = args[++i];
+        }
+        else if (token.startsWith('--since=')) {
+            options.since = token.slice('--since='.length);
+        }
+        else if (token === '--since') {
+            options.since = args[++i];
+        }
+    }
+    return options;
+}
+/** 查找 CHANGELOG.md 文件路径 */
+function findChangelogPath() {
+    // 尝试多个位置：dist 附近、项目根目录
+    const candidates = [
+        join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'CHANGELOG.md'),
+        join(process.cwd(), 'CHANGELOG.md'),
+    ];
+    for (const path of candidates) {
+        try {
+            readFileSync(path, 'utf-8');
+            return path;
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error('未找到 CHANGELOG.md');
+}
+/** 渲染 changelog 到 stdout */
+export function runChangelog(args) {
+    const options = parseChangelogOptions(args);
+    const changelogPath = findChangelogPath();
+    const raw = readFileSync(changelogPath, 'utf-8');
+    if (options.raw) {
+        process.stdout.write(raw);
+        return;
+    }
+    const entries = parseChangelog(raw);
+    // 过滤
+    let filtered = entries;
+    if (options.version) {
+        filtered = filtered.filter((e) => e.version === options.version);
+        if (filtered.length === 0) {
+            throw new Error(`未找到版本 ${options.version}`);
+        }
+    }
+    if (options.since) {
+        const sinceIndex = filtered.findIndex((e) => e.version === options.since);
+        if (sinceIndex === -1) {
+            throw new Error(`未找到版本 ${options.since}`);
+        }
+        filtered = filtered.slice(0, sinceIndex + 1);
+    }
+    if (options.limit !== undefined) {
+        filtered = filtered.slice(0, options.limit);
+    }
+    // 渲染
+    const lines = [];
+    for (const entry of filtered) {
+        lines.push(`## ${entry.version} - ${entry.date}`);
+        for (const line of entry.lines) {
+            if (line.trim()) {
+                lines.push(line);
+            }
+        }
+        lines.push('');
+    }
+    process.stdout.write(lines.join('\n'));
+}
+//# sourceMappingURL=changelog.js.map

package/dist/core/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/core/changelog.ts"],"names":[],"mappings":"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"}

package/dist/core/cli-output.d.ts

@@ -0,0 +1,13 @@
+import { type CliCommandDefinition } from './cli-registry.js';
+export declare function getBuiltinCommandNames(): string[];
+/** 格式化 registry 注册命令的执行结果 */
+export declare function formatCommandResult(result: {
+    content?: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}): string;
+/** 打印总帮助 */
+export declare function printHelp(appName: string, commands: CliCommandDefinition[]): void;
+/** 打印单个命令帮助 */
+export declare function printCommandHelp(appName: string, command: CliCommandDefinition): void;

package/dist/core/cli-output.js

@@ -0,0 +1,65 @@
+import { describeSchema } from './cli-registry.js';
+import { CLI_VERSION } from '../version.js';
+export function getBuiltinCommandNames() {
+    return ['help', 'install', 'list', 'remove', 'uninstall', 'update', 'version', 'doctor', 'changelog', 'completion'];
+}
+/** 格式化 registry 注册命令的执行结果 */
+export function formatCommandResult(result) {
+    const text = result.content?.[0]?.text;
+    return text ?? '';
+}
+/** 打印总帮助 */
+export function printHelp(appName, commands) {
+    const lines = [
+        `${appName} v${CLI_VERSION}`,
+        '',
+        '用法:',
+        `  ${appName} <command> [options]`,
+        `  ${appName} help <command>`,
+        `  npx ${appName} <command> [options]`,
+        '',
+        '内置命令:',
+        '  help          显示帮助信息',
+        '  list          列出所有命令',
+        '  version       显示版本号',
+        '  install       安装 CLI（配置 + skill）',
+        '  update        检查更新 + 刷新 skill',
+        '  remove        卸载 CLI（skill + 配置）',
+        '  uninstall     卸载 CLI（skill + 配置）',
+        '  doctor        系统自检',
+        '  changelog     查看版本变更',
+        '  completion    生成 shell 补全脚本',
+        '',
+        '业务命令:',
+    ];
+    if (commands.length === 0) {
+        lines.push('  （暂无）');
+    }
+    else {
+        for (const command of commands) {
+            lines.push(`  ${command.name.padEnd(24)}${command.description ?? ''}`);
+        }
+    }
+    if (commands.length > 0) {
+        lines.push('');
+        lines.push(`共 ${commands.length} 个业务命令。使用 \`${appName} help <command>\` 查看参数详情。`);
+    }
+    process.stdout.write(`${lines.join('\n')}\n`);
+}
+/** 打印单个命令帮助 */
+export function printCommandHelp(appName, command) {
+    const schemaRows = describeSchema(command.schema).map((field) => {
+        const requiredLabel = field.required ? '必填' : '可选';
+        const description = field.description ? `：${field.description}` : '';
+        return `  --${field.name} <${field.type}> (${requiredLabel})${description}`;
+    });
+    const lines = [
+        `${appName} ${command.name}`,
+        command.description ?? '',
+        '',
+        '参数:',
+        ...(schemaRows.length > 0 ? schemaRows : ['  （暂无参数）']),
+    ];
+    process.stdout.write(`${lines.join('\n')}\n`);
+}
+//# sourceMappingURL=cli-output.js.map

package/dist/core/cli-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.js","sourceRoot":"","sources":["../../src/core/cli-output.ts"],"names":[],"mappings":"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"}

package/dist/core/cli-registry.d.ts

@@ -0,0 +1,38 @@
+import { z, type ZodRawShape } from 'zod';
+export interface JsonContentResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+export type CliHandler<TInput extends Record<string, unknown> = Record<string, unknown>> = (input: TInput) => Promise<JsonContentResult> | JsonContentResult;
+export interface CliCommandMetadata {
+    costHint?: 'low' | 'medium' | 'high';
+    nextBestTools?: string[];
+}
+export interface CliCommandDefinition<TInput extends Record<string, unknown> = Record<string, unknown>> {
+    name: string;
+    schema: ZodRawShape;
+    handler: CliHandler<any>;
+    description?: string;
+    metadata?: CliCommandMetadata;
+}
+export interface CliRegistry {
+    tool<TShape extends ZodRawShape>(name: string, schema: TShape, handler: CliHandler<z.infer<z.ZodObject<TShape>>>, description?: string, metadata?: CliCommandMetadata): void;
+    getCommand(name: string): CliCommandDefinition | undefined;
+    listCommands(): CliCommandDefinition[];
+}
+export declare class InMemoryCliRegistry implements CliRegistry {
+    private readonly commands;
+    tool<TShape extends ZodRawShape>(name: string, schema: TShape, handler: CliHandler<z.infer<z.ZodObject<TShape>>>, description?: string, metadata?: CliCommandMetadata): void;
+    getCommand(name: string): CliCommandDefinition | undefined;
+    listCommands(): CliCommandDefinition[];
+}
+export declare function describeSchema(schema: ZodRawShape): Array<{
+    name: string;
+    required: boolean;
+    type: string;
+    description?: string;
+}>;
+export declare function parseCommandInput<TShape extends ZodRawShape>(schema: TShape, args: string[]): z.infer<z.ZodObject<TShape>>;