@cloudglab/yapi-cli 0.0.1

package/dist/core/output.js

@@ -0,0 +1,208 @@
+/**
+ * 统一输出渲染。
+ *
+ * 支持两种模式：
+ *   json   — 纯 JSON 输出（默认，MCP 协议兼容）
+ *   pretty — 人类友好格式（列表、表格、颜色标记）
+ *
+ * 所有命令 handler 统一通过 `output.result(data)` 返回，
+ * 由 OutputFormatter 根据格式模式渲染。
+ */
+export class OutputFormatter {
+    constructor(format = 'json', appName = 'yapi-cli') {
+        this.format = format;
+        this.appName = appName;
+    }
+    /** 将数据包装为 MCP-compatible 结果 */
+    result(data) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: this.formatData(data),
+                },
+            ],
+        };
+    }
+    /** 格式化错误信息（输出到 stderr），返回人类可读的消息 */
+    printError(err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (this.format === 'pretty') {
+            process.stderr.write(`\n✗ ${message}\n`);
+        }
+        return message;
+    }
+    /** 打印帮助或状态信息到 stdout */
+    printMessage(msg) {
+        process.stdout.write(`${msg}\n`);
+    }
+    /** 将数据格式化为字符串 */
+    formatData(data) {
+        if (this.format === 'json') {
+            return JSON.stringify(data, null, 2);
+        }
+        if (!isRecord(data)) {
+            return String(data);
+        }
+        // 纯成功消息
+        if (data.success === true && data.message && !data.items && !data.projects && !data.interfaces && !data.categories && !data.users && !data.collections && !data.envs && !data.members && !data.logs && !data.groups && data.constructor === Object && Object.keys(data).length <= 3) {
+            return data.message;
+        }
+        // 错误消息
+        if (data.success === false && data.message) {
+            return `✗ ${data.message}`;
+        }
+        // 项目列表
+        if (data.projects && Array.isArray(data.projects)) {
+            return this.renderTable(['ID', '名称', '路径前缀', '分组 ID', '类型'], data.projects.map((p) => [
+                String(p.id ?? ''),
+                String(p.name ?? ''),
+                String(p.basepath ?? ''),
+                String(p.groupId ?? ''),
+                String(p.projectType ?? ''),
+            ]), `项目列表 (共 ${data.total ?? data.projects.length} 个)`);
+        }
+        // 接口列表
+        if (data.interfaces && Array.isArray(data.interfaces)) {
+            return this.renderTable(['ID', '方法', '路径', '标题', '状态'], data.interfaces.map((i) => [
+                String(i.id ?? ''),
+                String(i.method ?? ''),
+                String(i.path ?? ''),
+                String(i.title ?? ''),
+                String(i.status ?? ''),
+            ]), `接口列表 (共 ${data.total ?? data.interfaces.length} 个)`);
+        }
+        // 搜索结果
+        if (data.items && Array.isArray(data.items)) {
+            return this.renderTable(['ID', '方法', '路径', '标题', '项目'], data.items.map((i) => [
+                String(i.id ?? ''),
+                String(i.method ?? ''),
+                String(i.path ?? ''),
+                String(i.title ?? ''),
+                String(i.projectName ?? ''),
+            ]), `搜索结果 (共 ${data.total ?? data.items.length} 个)`);
+        }
+        // 分组列表
+        if (data.groups && Array.isArray(data.groups)) {
+            return this.renderTable(['ID', '名称', '项目数'], data.groups.map((g) => [
+                String(g.id ?? ''),
+                String(g.name ?? ''),
+                String(g.projectCount ?? ''),
+            ]), `分组列表 (共 ${data.groups.length} 个)`);
+        }
+        // 分类列表
+        if (data.categories && Array.isArray(data.categories)) {
+            return this.renderTable(['ID', '名称', '接口数'], data.categories.map((c) => [
+                String(c.id ?? ''),
+                String(c.name ?? ''),
+                String(c.interfaceCount ?? ''),
+            ]), `分类列表 (共 ${data.categories.length} 个)`);
+        }
+        // 用户列表
+        if (data.users && Array.isArray(data.users)) {
+            return this.renderTable(['ID', '用户名', '邮箱', '角色'], data.users.map((u) => [
+                String(u.id ?? ''),
+                String(u.username ?? ''),
+                String(u.email ?? ''),
+                String(u.role ?? ''),
+            ]), `用户列表 (共 ${data.total ?? data.users.length} 个)`);
+        }
+        // 环境列表
+        if (data.envs && Array.isArray(data.envs)) {
+            return this.renderTable(['ID', '名称', '域名'], data.envs.map((e) => [
+                String(e.id ?? ''),
+                String(e.name ?? ''),
+                String(e.domain ?? ''),
+            ]), `环境列表`);
+        }
+        // 成员列表
+        if (data.members && Array.isArray(data.members)) {
+            return this.renderTable(['ID', '用户名', '邮箱', '角色'], data.members.map((m) => [
+                String(m.id ?? ''),
+                String(m.username ?? ''),
+                String(m.email ?? ''),
+                String(m.role ?? ''),
+            ]), `成员列表 (共 ${data.members.length} 个)`);
+        }
+        // 集合列表
+        if (data.collections && Array.isArray(data.collections)) {
+            return this.renderTable(['ID', '名称'], data.collections.map((c) => [
+                String(c.id ?? ''),
+                String(c.name ?? ''),
+            ]), `集合列表 (共 ${data.collections.length} 个)`);
+        }
+        // 日志列表
+        if (data.logs && Array.isArray(data.logs)) {
+            return this.renderTable(['时间', '用户', '类型', '内容'], data.logs.map((l) => [
+                l.time ? formatTimestamp(l.time) : '',
+                String(l.username ?? ''),
+                String(l.type ?? ''),
+                String(String(l.content ?? '').slice(0, 60)),
+            ]), `日志 (共 ${data.total ?? data.logs.length} 条)`);
+        }
+        // 用户详情 / 项目详情 / 接口详情等单对象
+        if (data.user && isRecord(data.user)) {
+            return this.renderObject('用户信息', data.user);
+        }
+        if (data.project && isRecord(data.project)) {
+            return this.renderObject('项目信息', data.project);
+        }
+        if (data.interface && isRecord(data.interface)) {
+            return this.renderObject('接口详情', data.interface);
+        }
+        // 兜底：JSON
+        return JSON.stringify(data, null, 2);
+    }
+    renderTable(headers, rows, title) {
+        const lines = [];
+        if (title)
+            lines.push(title);
+        if (title)
+            lines.push('');
+        // 计算列宽
+        const colWidths = headers.map((h, i) => {
+            const maxData = rows.reduce((w, r) => Math.max(w, r[i]?.length ?? 0), 0);
+            return Math.max(h.length, maxData) + 2;
+        });
+        const hLine = headers.map((h, i) => h.padEnd(colWidths[i])).join('');
+        lines.push(hLine);
+        lines.push(headers.map((_, i) => '─'.repeat(colWidths[i])).join(''));
+        for (const row of rows) {
+            lines.push(row.map((c, i) => c.padEnd(colWidths[i])).join(''));
+        }
+        return lines.join('\n');
+    }
+    renderObject(title, obj) {
+        const lines = [title, ''];
+        const maxKeyLen = Math.max(...Object.keys(obj).map((k) => k.length));
+        for (const [key, value] of Object.entries(obj)) {
+            const val = prettyValue(value);
+            lines.push(`  ${key.padEnd(maxKeyLen)}  ${val}`);
+        }
+        return lines.join('\n');
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function prettyValue(value) {
+    if (value === null || value === undefined)
+        return '-';
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        return `[${value.length} 项]`;
+    }
+    if (typeof value === 'object')
+        return JSON.stringify(value).slice(0, 100);
+    return String(value);
+}
+function formatTimestamp(ts) {
+    try {
+        return new Date(ts * 1000).toISOString().slice(0, 19).replace('T', ' ');
+    }
+    catch {
+        return String(ts);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

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

package/dist/core/update-probe.d.ts

@@ -0,0 +1,14 @@
+export interface UpdateInfo {
+    currentVersion: string;
+    latestVersion: string | null;
+    isUpdateAvailable: boolean;
+    packageName: string;
+    error?: string;
+}
+/**
+ * 检查 npm registry 是否有更新版本。
+ * 不抛错 — 失败时静默返回当前版本。
+ */
+export declare function checkForUpdates(): UpdateInfo;
+/** 获取 npm install 更新命令提示 */
+export declare function getUpdateSuggestion(updateInfo: UpdateInfo, isGlobal?: boolean): string;

package/dist/core/update-probe.js

@@ -0,0 +1,67 @@
+import { execSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { CLI_VERSION } from '../version.js';
+/** 从 package.json 读取包名 */
+function getPackageName() {
+    try {
+        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return pkg.name || 'yapi-cli';
+    }
+    catch {
+        return 'yapi-cli';
+    }
+}
+/**
+ * 检查 npm registry 是否有更新版本。
+ * 不抛错 — 失败时静默返回当前版本。
+ */
+export function checkForUpdates() {
+    const packageName = getPackageName();
+    const result = {
+        currentVersion: CLI_VERSION,
+        latestVersion: null,
+        isUpdateAvailable: false,
+        packageName,
+    };
+    try {
+        const stdout = execSync(`npm view ${packageName} version 2>/dev/null || true`, {
+            timeout: 5000,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        const latest = stdout?.trim();
+        if (latest && latest !== CLI_VERSION) {
+            result.latestVersion = latest;
+            result.isUpdateAvailable = true;
+        }
+        else if (latest) {
+            result.latestVersion = latest;
+        }
+    }
+    catch {
+        // 静默失败 — 可能未发布、无网络等
+        result.error = '无法检查更新（可能未发布到 npm registry）';
+    }
+    return result;
+}
+/** 获取 npm install 更新命令提示 */
+export function getUpdateSuggestion(updateInfo, isGlobal = true) {
+    if (!updateInfo.isUpdateAvailable) {
+        return `当前版本 ${updateInfo.currentVersion} 已是最新。`;
+    }
+    const prefix = isGlobal ? '-g ' : '';
+    const pm = detectPackageManager();
+    return `可用更新: ${updateInfo.currentVersion} → ${updateInfo.latestVersion}\n  运行: ${pm} install ${prefix}${updateInfo.packageName}@latest`;
+}
+function detectPackageManager() {
+    const userAgent = process.env.npm_config_user_agent || '';
+    if (userAgent.includes('pnpm'))
+        return 'pnpm';
+    if (userAgent.includes('yarn'))
+        return 'yarn';
+    return 'npm';
+}
+//# sourceMappingURL=update-probe.js.map

package/dist/core/update-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-probe.js","sourceRoot":"","sources":["../../src/core/update-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAU5C,0BAA0B;AAC1B,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC1F,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,OAAO,GAAG,CAAC,IAAI,IAAI,UAAU,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,MAAM,GAAe;QACzB,cAAc,EAAE,WAAW;QAC3B,aAAa,EAAE,IAAI;QACnB,iBAAiB,EAAE,KAAK;QACxB,WAAW;KACZ,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,WAAW,8BAA8B,EAAE;YAC7E,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YACrC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC;YAC9B,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAClC,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC;QAChC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;QACpB,MAAM,CAAC,KAAK,GAAG,6BAA6B,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,mBAAmB,CAAC,UAAsB,EAAE,QAAQ,GAAG,IAAI;IACzE,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;QAClC,OAAO,QAAQ,UAAU,CAAC,cAAc,QAAQ,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAElC,OAAO,SAAS,UAAU,CAAC,cAAc,MAAM,UAAU,CAAC,aAAa,WAAW,EAAE,YAAY,MAAM,GAAG,UAAU,CAAC,WAAW,SAAS,CAAC;AAC3I,CAAC;AAED,SAAS,oBAAoB;IAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IAC1D,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/write-guard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * YApi CLI 写保护。
+ *
+ * 所有写入操作（create/update/delete）必须：
+ * 1. YAPI_DISABLE_WRITE 环境变量不为 'true'
+ * 2. 传入 confirm: true 确认
+ */
+export interface WriteGuardInput {
+    action: string;
+    confirm?: boolean;
+    payload: unknown;
+}
+export interface WritePreview {
+    ok: false;
+    preview: true;
+    reason: string;
+    action: string;
+    payload: unknown;
+}
+/** 是否启用写操作（环境变量 YAPI_DISABLE_WRITE） */
+export declare function isWriteEnabled(): boolean;
+/** 断言写操作允许，否则抛出异常 */
+export declare function assertWriteAllowed(input: WriteGuardInput): void;
+/** preview 模式：返回 preview 信息而非直接抛出 */
+export declare function previewOrAssertWriteAllowed(input: WriteGuardInput): WritePreview | null;

package/dist/core/write-guard.js

@@ -0,0 +1,36 @@
+/** 是否启用写操作（环境变量 YAPI_DISABLE_WRITE） */
+export function isWriteEnabled() {
+    return process.env.YAPI_DISABLE_WRITE !== 'true';
+}
+/** 断言写操作允许，否则抛出异常 */
+export function assertWriteAllowed(input) {
+    if (!isWriteEnabled()) {
+        throw new Error(`写操作已禁用。若要执行 ${input.action}，需要移除 YAPI_DISABLE_WRITE=true。`);
+    }
+    if (input.confirm !== true) {
+        throw new Error(`写操作缺少确认。若要执行 ${input.action}，需要传入 --confirm true。`);
+    }
+}
+/** preview 模式：返回 preview 信息而非直接抛出 */
+export function previewOrAssertWriteAllowed(input) {
+    if (!isWriteEnabled()) {
+        return {
+            ok: false,
+            preview: true,
+            reason: `写操作已禁用。若要执行 ${input.action}，需要移除 YAPI_DISABLE_WRITE=true。`,
+            action: input.action,
+            payload: input.payload,
+        };
+    }
+    if (input.confirm !== true) {
+        return {
+            ok: false,
+            preview: true,
+            reason: `写操作缺少确认。若要执行 ${input.action}，需要传入 --confirm true。`,
+            action: input.action,
+            payload: input.payload,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=write-guard.js.map

package/dist/core/write-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-guard.js","sourceRoot":"","sources":["../../src/core/write-guard.ts"],"names":[],"mappings":"AAqBA,uCAAuC;AACvC,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC;AACnD,CAAC;AAED,qBAAqB;AACrB,MAAM,UAAU,kBAAkB,CAAC,KAAsB;IACvD,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,eAAe,KAAK,CAAC,MAAM,gCAAgC,CAC5D,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,CAAC,MAAM,uBAAuB,CACpD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,2BAA2B,CACzC,KAAsB;IAEtB,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,eAAe,KAAK,CAAC,MAAM,gCAAgC;YACnE,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,gBAAgB,KAAK,CAAC,MAAM,uBAAuB;YAC3D,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { runCli } from './cli.js';
+export { CLI_VERSION } from './version.js';
+export { registerTools } from './tools/index.js';
+export type { CliCommandDefinition, CliRegistry, JsonContentResult } from './core/cli-registry.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { runCli } from './cli.js';
+export { CLI_VERSION } from './version.js';
+export { registerTools } from './tools/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,13 @@
+export interface InstallOptions {
+    cliOnly: boolean;
+    skillOnly: boolean;
+    skillPath?: string;
+    yes: boolean;
+    server?: string;
+    token?: string;
+    projectId?: number;
+}
+export declare function parseInstallOptions(args: string[]): InstallOptions;
+export declare function runInstallCommand(args: string[], _appName?: string): Promise<void>;
+export declare function runUpdateCommand(args: string[], _appName?: string): Promise<void>;
+export declare function runUninstallCommand(args: string[], _appName?: string): Promise<void>;

package/dist/install.js

@@ -0,0 +1,201 @@
+import { existsSync, mkdirSync, copyFileSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { YAPI_HOME, saveConfig, loadConfig } from './services/yapi/config.js';
+/** 获取当前模块目录（兼容 Node 18-20） */
+function getModuleDir(importMetaUrl) {
+    return dirname(fileURLToPath(importMetaUrl));
+}
+function parseBooleanFlag(value) {
+    if (value === undefined)
+        return true;
+    return ['1', 'true', 'yes', 'on'].includes(value.toLowerCase());
+}
+export function parseInstallOptions(args) {
+    const options = {
+        cliOnly: false,
+        skillOnly: false,
+        yes: false,
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const token = args[index];
+        if (token === '--cli-only')
+            options.cliOnly = true;
+        else if (token === '--skill-only')
+            options.skillOnly = true;
+        else if (token === '--yes' || token === '-y')
+            options.yes = true;
+        else if (token.startsWith('--skill-path='))
+            options.skillPath = token.slice('--skill-path='.length);
+        else if (token === '--skill-path') {
+            options.skillPath = args[index + 1];
+            index += 1;
+        }
+        else if (token.startsWith('--server='))
+            options.server = token.slice('--server='.length);
+        else if (token === '--server') {
+            options.server = args[index + 1];
+            index += 1;
+        }
+        else if (token.startsWith('--token='))
+            options.token = token.slice('--token='.length);
+        else if (token === '--token') {
+            options.token = args[index + 1];
+            index += 1;
+        }
+        else if (token.startsWith('--project-id='))
+            options.projectId = Number(token.slice('--project-id='.length));
+        else if (token === '--project-id') {
+            options.projectId = Number(args[index + 1]);
+            index += 1;
+        }
+        else if (token.startsWith('--yes='))
+            options.yes = parseBooleanFlag(token.slice('--yes='.length));
+        else if (token.startsWith('--cli-only='))
+            options.cliOnly = parseBooleanFlag(token.slice('--cli-only='.length));
+        else if (token.startsWith('--skill-only='))
+            options.skillOnly = parseBooleanFlag(token.slice('--skill-only='.length));
+    }
+    return options;
+}
+/** 安装 CLI 配置 */
+function installCli(options) {
+    const existingConfig = loadConfig();
+    if (existingConfig && !options.yes) {
+        process.stdout.write('配置文件已存在，使用 --yes/-y 覆盖\n');
+        return;
+    }
+    const config = {};
+    if (options.server) {
+        config.serverUrl = options.server.replace(/\/+$/, '');
+    }
+    else if (existingConfig?.serverUrl) {
+        config.serverUrl = existingConfig.serverUrl;
+    }
+    else {
+        throw new Error('请提供 --server 参数指定 YApi 服务器地址');
+    }
+    if (options.token) {
+        config.token = options.token;
+    }
+    else if (existingConfig?.token) {
+        config.token = existingConfig.token;
+    }
+    if (options.projectId) {
+        config.projectId = options.projectId;
+    }
+    else if (existingConfig?.projectId) {
+        config.projectId = existingConfig.projectId;
+    }
+    saveConfig(config);
+    process.stdout.write(`配置已写入 ${YAPI_HOME}/config.json\n`);
+    process.stdout.write(`  服务器: ${config.serverUrl}\n`);
+    process.stdout.write(`  Token: ${config.token ? '已设置' : '未设置'}\n`);
+    if (config.projectId) {
+        process.stdout.write(`  默认项目: ${config.projectId}\n`);
+    }
+}
+/** 安装 Skill */
+function installSkill(options) {
+    const moduleDir = getModuleDir(import.meta.url);
+    const opencodeAgentDir = join(process.env.HOME || '', '.opencode', 'agent');
+    // 如果没有指定 skill-path，从 CLI 包内复制默认 skill
+    if (options.skillPath) {
+        const target = join(opencodeAgentDir, 'yapi-cli.md');
+        if (!existsSync(dirname(target))) {
+            mkdirSync(dirname(target), { recursive: true });
+        }
+        copyFileSync(options.skillPath, target);
+        process.stdout.write(`Skill 已安装到: ${target}\n`);
+        return;
+    }
+    // 查找 CLI 自带的 skill 文件
+    const possiblePaths = [
+        join(moduleDir, '..', 'skills', 'yapi-cli', 'SKILL.md'),
+        join(moduleDir, '..', '..', 'skills', 'yapi-cli', 'SKILL.md'),
+        join(process.cwd(), 'skills', 'yapi-cli', 'SKILL.md'),
+    ];
+    for (const skillPath of possiblePaths) {
+        try {
+            if (existsSync(skillPath)) {
+                const target = join(opencodeAgentDir, 'yapi-cli.md');
+                if (!existsSync(dirname(target))) {
+                    mkdirSync(dirname(target), { recursive: true });
+                }
+                copyFileSync(skillPath, target);
+                process.stdout.write(`Skill 已安装到: ${target}\n`);
+                return;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    process.stdout.write('未找到内置 skill 文件。可通过 --skill-path 指定路径\n');
+}
+/** 测试连接 */
+async function testConnection() {
+    const config = loadConfig();
+    if (!config) {
+        process.stdout.write('跳过连接测试（未配置）\n');
+        return;
+    }
+    try {
+        const url = `${config.serverUrl}/api/user/status`;
+        const response = await fetch(url, {
+            headers: config.token ? { Authorization: config.token } : {},
+        });
+        if (response.ok) {
+            process.stdout.write('✅ 连接测试通过\n');
+        }
+        else {
+            process.stdout.write(`⚠️  连接测试返回 ${response.status}，请检查配置\n`);
+        }
+    }
+    catch (error) {
+        process.stdout.write(`⚠️  连接测试失败: ${error instanceof Error ? error.message : String(error)}\n`);
+    }
+}
+export async function runInstallCommand(args, _appName = 'yapi-cli') {
+    const options = parseInstallOptions(args);
+    if (!options.cliOnly) {
+        installSkill(options);
+    }
+    if (!options.skillOnly) {
+        installCli(options);
+    }
+    await testConnection();
+}
+export async function runUpdateCommand(args, _appName = 'yapi-cli') {
+    const options = parseInstallOptions(args);
+    // Update 只更新 skill（如果有），不覆盖配置
+    if (!options.cliOnly) {
+        installSkill(options);
+    }
+    if (!options.skillOnly) {
+        process.stdout.write('配置未变更（使用 `yapi install` 重新安装可覆盖配置）\n');
+    }
+}
+export async function runUninstallCommand(args, _appName = 'yapi-cli') {
+    const options = parseInstallOptions(args);
+    const opencodeAgentDir = join(process.env.HOME || '', '.opencode', 'agent');
+    if (!options.cliOnly) {
+        const skillFile = join(opencodeAgentDir, 'yapi-cli.md');
+        if (existsSync(skillFile)) {
+            unlinkSync(skillFile);
+            process.stdout.write('Skill 已移除\n');
+        }
+        else {
+            process.stdout.write('未找到已安装的 skill\n');
+        }
+    }
+    if (!options.skillOnly && options.yes) {
+        // 只有在 --yes 时才删除配置
+        const configFile = join(YAPI_HOME, 'config.json');
+        if (existsSync(configFile)) {
+            unlinkSync(configFile);
+            process.stdout.write('配置文件已删除\n');
+        }
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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