@seandong/seno 0.1.7 → 0.2.0

package/dist/commands/plugin-init.js

@@ -0,0 +1,313 @@
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+import ora from 'ora';
+// ─── Helpers ─────────────────────────────────────────────────
+/** 安全执行 shell 命令，返回 stdout 或 null（失败时） */
+function runCommand(cmd, timeout = 15000) {
+    try {
+        return execSync(cmd, {
+            encoding: 'utf-8',
+            timeout,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** 获取 nvm 目录路径 */
+function getNvmDir() {
+    return process.env.NVM_DIR || path.join(process.env.HOME || '~', '.nvm');
+}
+/** 检查 nvm 是否已安装 */
+function isNvmInstalled() {
+    const nvmScript = path.join(getNvmDir(), 'nvm.sh');
+    try {
+        fs.accessSync(nvmScript);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 通过 nvm 执行命令（先 source nvm.sh） */
+function runWithNvm(cmd) {
+    const nvmDir = getNvmDir();
+    const script = `source "${nvmDir}/nvm.sh"\n${cmd}`;
+    try {
+        return execSync('bash', {
+            input: script,
+            encoding: 'utf-8',
+            timeout: 300000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** 检查 nvm 中是否已安装 Node.js 18，返回版本号或 null */
+function getNode18Version() {
+    const result = runWithNvm('nvm ls 18');
+    if (!result)
+        return null;
+    const match = result.match(/v(18\.\d+\.\d+)/);
+    return match ? match[1] : null;
+}
+/** 确保 nvm 已安装 */
+async function ensureNvm() {
+    if (isNvmInstalled())
+        return true;
+    const spinner = ora({ text: '安装 nvm...', indent: 2, discardStdin: false });
+    spinner.start();
+    try {
+        execSync('curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 120000,
+        });
+        if (!isNvmInstalled()) {
+            spinner.fail('nvm 安装失败');
+            return false;
+        }
+        spinner.succeed('nvm 安装成功');
+        return true;
+    }
+    catch {
+        spinner.fail('nvm 安装失败');
+        return false;
+    }
+}
+/** 确保 nvm 中存在 Node.js 18 */
+async function ensureNode18() {
+    if (!(await ensureNvm()))
+        return false;
+    const existing = getNode18Version();
+    if (existing) {
+        console.log(chalk.green('  ✓ ') + `${'Node.js 18'.padEnd(12)}${chalk.gray(`v${existing}`)}`);
+        return true;
+    }
+    const spinner = ora({ text: '通过 nvm 安装 Node.js 18...', indent: 2, discardStdin: false });
+    spinner.start();
+    runWithNvm('nvm install 18');
+    const installed = getNode18Version();
+    if (installed) {
+        spinner.succeed(`Node.js 18 安装成功 ${chalk.gray(`v${installed}`)}`);
+        return true;
+    }
+    spinner.fail('Node.js 18 安装失败');
+    return false;
+}
+/** 自动安装 ONES CLI */
+async function installOnesCli() {
+    const spinner = ora({ text: '安装 ONES CLI...', indent: 2, discardStdin: false });
+    spinner.start();
+    try {
+        execSync('npm install -g @ones/cli --registry=https://npm.partner.ones.cn/registry/', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 120000,
+        });
+        const version = runCommand('ones --version');
+        if (version) {
+            spinner.succeed(`ONES CLI 安装成功 ${chalk.gray(version)}`);
+            return true;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    spinner.fail('ONES CLI 安装失败');
+    console.log(chalk.gray('  手动安装: npm install -g @ones/cli --registry=https://npm.partner.ones.cn/registry/'));
+    return false;
+}
+/** 自动安装 npx */
+async function installNpx() {
+    const spinner = ora({ text: '安装 npx...', indent: 2, discardStdin: false });
+    spinner.start();
+    try {
+        execSync('npm install -g npx', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 120000,
+        });
+        const version = runCommand('npx --version');
+        if (version) {
+            spinner.succeed(`npx 安装成功 ${chalk.gray(version)}`);
+            return true;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    spinner.fail('npx 安装失败');
+    console.log(chalk.gray('  手动安装: npm install -g npx'));
+    return false;
+}
+// ─── Core Logic ──────────────────────────────────────────────
+/**
+ * 环境预检：检查所有必需依赖
+ * 返回是否全部通过
+ */
+export async function checkEnvironment() {
+    const details = [];
+    console.log(chalk.bold('  环境预检:'));
+    console.log();
+    const node18Ok = await ensureNode18();
+    if (!node18Ok)
+        details.push('Node.js 18 未安装');
+    const checks = [
+        { label: 'npm', cmd: 'npm --version' },
+        {
+            label: 'ONES CLI',
+            cmd: 'ones --version',
+            autoFix: installOnesCli,
+        },
+        {
+            label: 'npx',
+            cmd: 'npx --version',
+            autoFix: installNpx,
+        },
+    ];
+    let allRequiredPassed = node18Ok;
+    for (const check of checks) {
+        let version = runCommand(check.cmd);
+        if (version) {
+            console.log(chalk.green('  ✓ ') + `${check.label.padEnd(12)}${chalk.gray(version)}`);
+            continue;
+        }
+        if (check.autoFix) {
+            const fixed = await check.autoFix();
+            if (fixed) {
+                version = runCommand(check.cmd);
+                if (version)
+                    continue;
+            }
+        }
+        allRequiredPassed = false;
+        details.push(`${check.label} 未安装`);
+        console.log(chalk.red('  ✗ ') + `${check.label} 未安装`);
+    }
+    console.log();
+    return { passed: allRequiredPassed, details };
+}
+/**
+ * 插件初始化核心逻辑（无交互依赖）
+ * 参数由调用方提供（LLM 工具调用或斜杠命令收集）
+ */
+export async function pluginInitCore(options) {
+    const { pluginName, pluginDir } = options;
+    // ── 参数校验 ──
+    if (!pluginName) {
+        return { success: false, projectPath: '', message: '插件名称不能为空' };
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(pluginName)) {
+        return {
+            success: false,
+            projectPath: '',
+            message: '插件名称只能包含字母、数字、连字符(-)和下划线(_)',
+        };
+    }
+    // ── 环境预检 ──
+    console.log();
+    console.log(chalk.bold('  ONES 插件项目初始化'));
+    console.log();
+    const envCheck = await checkEnvironment();
+    if (!envCheck.passed) {
+        return {
+            success: false,
+            projectPath: '',
+            message: `环境预检未通过: ${envCheck.details.join('、')}。请先安装缺失的依赖。`,
+        };
+    }
+    console.log(chalk.green('  环境预检通过'));
+    console.log();
+    // ── 创建项目 ──
+    const projectPath = path.resolve(pluginDir || '.');
+    if (pluginDir) {
+        try {
+            fs.mkdirSync(path.resolve(pluginDir), { recursive: true });
+        }
+        catch {
+            return {
+                success: false,
+                projectPath,
+                message: `目录创建失败: ${pluginDir}`,
+            };
+        }
+    }
+    console.log(chalk.gray(`  正在创建插件项目: ${pluginName}`) +
+        (pluginDir ? chalk.gray(` → ${pluginDir}/`) : '') +
+        chalk.gray(' ...'));
+    console.log();
+    let createCmd = `ones create -d ${pluginName}`;
+    if (pluginDir) {
+        createCmd += ` -s ${pluginDir}`;
+    }
+    const appId = crypto.randomBytes(4).toString('hex');
+    try {
+        execSync(createCmd, {
+            input: appId + '\n',
+            stdio: ['pipe', 'inherit', 'inherit'],
+            timeout: 300000,
+        });
+    }
+    catch (error) {
+        const err = error;
+        if (err.status) {
+            return {
+                success: false,
+                projectPath,
+                message: `创建失败 (exit code: ${err.status})`,
+            };
+        }
+        return {
+            success: false,
+            projectPath,
+            message: `创建失败: ${err.message ?? error}`,
+        };
+    }
+    if (!fs.existsSync(projectPath)) {
+        return {
+            success: false,
+            projectPath,
+            message: `创建失败: 项目目录不存在 ${projectPath}`,
+        };
+    }
+    console.log(chalk.green(`  ✓ 插件项目 "${pluginName}" 创建成功`));
+    // ── 写入 .nvmrc ──
+    try {
+        fs.writeFileSync(path.join(projectPath, '.nvmrc'), '18\n', 'utf-8');
+        console.log(chalk.green('  ✓ ') + '.nvmrc 已写入');
+    }
+    catch {
+        console.log(chalk.yellow('  ⚠ .nvmrc 写入失败'));
+    }
+    console.log();
+    const nextSteps = [
+        `cd ${projectPath}`,
+        'npx op login',
+        'npx op pickteam local',
+        'npx op invoke run',
+    ];
+    // ── 后续指引 ──
+    console.log(chalk.bold('  本地调试步骤:'));
+    console.log();
+    nextSteps.forEach((step, i) => {
+        console.log(chalk.cyan(`  ${i + 1}. `) + step);
+    });
+    console.log();
+    console.log(chalk.bold('  开发文档: ') +
+        chalk.underline('https://developer.ones.cn/zh-CN/docs/guide/getting-started/development'));
+    console.log();
+    return {
+        success: true,
+        projectPath,
+        message: `插件项目 "${pluginName}" 创建成功`,
+        nextSteps,
+    };
+}
+//# sourceMappingURL=plugin-init.js.map

package/dist/commands/plugin-init.js.map

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

package/dist/commands/server.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 服务器管理：UI 层拆分
+ *
+ * 将 serverAdd 的 prompt / validate / persist 三层职责分离，
+ * 使校验和持久化逻辑可独立测试。
+ */
+import type { Interface as ReadlineInterface } from 'readline';
+import type { SshServerConfig } from '../config/types.js';
+/**
+ * 服务器输入数据（prompt 层的输出、validate 层的输入）
+ */
+export interface ServerInput {
+    name: string;
+    host: string;
+    user: string;
+    port: number;
+    auth_type: 'password' | 'ssh-key';
+    identity_file?: string;
+    password?: string;
+    description: string;
+}
+/**
+ * UI 层：收集用户输入
+ * 纯交互逻辑，不做业务校验
+ */
+export declare function promptServerDetails(rl: ReadlineInterface): Promise<ServerInput>;
+/**
+ * 校验层：纯校验，返回错误列表
+ * 空数组表示校验通过
+ */
+export declare function validateServerInput(input: ServerInput, existingNames: string[]): string[];
+/**
+ * 持久化层：读取现有配置，追加新服务器，写回
+ */
+export declare function persistServer(server: SshServerConfig): Promise<void>;
+/**
+ * 编排层：prompt → validate → persist
+ */
+export declare function serverAdd(rl: ReadlineInterface): Promise<boolean>;

package/dist/commands/server.js

@@ -0,0 +1,102 @@
+import chalk from 'chalk';
+import { loadServers, saveServers } from '../config/manager.js';
+import { promptQuestion, promptChoice, CancelError } from '../cli/prompt.js';
+/**
+ * UI 层：收集用户输入
+ * 纯交互逻辑，不做业务校验
+ */
+export async function promptServerDetails(rl) {
+    console.log();
+    console.log(chalk.gray('  添加服务器 [按 ESC 键取消]'));
+    console.log();
+    const name = await promptQuestion(rl, chalk.cyan('  Server name: '));
+    const host = await promptQuestion(rl, chalk.cyan('  Host: '));
+    const userInput = await promptQuestion(rl, chalk.cyan('  User [root]: '));
+    const user = userInput || 'root';
+    const portInput = await promptQuestion(rl, chalk.cyan('  Port [22]: '));
+    const port = portInput ? parseInt(portInput, 10) : 22;
+    // 认证方式选择
+    console.log();
+    console.log(chalk.cyan('  Auth method:'));
+    const authIdx = await promptChoice(rl, '', ['SSH Key', 'Password'], 0);
+    const authType = authIdx === 1 ? 'password' : 'ssh-key';
+    let identity_file;
+    let password;
+    if (authType === 'ssh-key') {
+        const identityInput = await promptQuestion(rl, chalk.cyan('  Identity file [~/.ssh/id_rsa]: '));
+        identity_file = identityInput || '~/.ssh/id_rsa';
+    }
+    else {
+        password = await promptQuestion(rl, chalk.cyan('  Password: '));
+    }
+    const description = await promptQuestion(rl, chalk.cyan('  Description: '));
+    return { name, host, user, port, auth_type: authType, identity_file, password, description };
+}
+/**
+ * 校验层：纯校验，返回错误列表
+ * 空数组表示校验通过
+ */
+export function validateServerInput(input, existingNames) {
+    const errors = [];
+    if (!input.name)
+        errors.push('服务器名称不能为空');
+    if (!input.host)
+        errors.push('主机地址不能为空');
+    if (isNaN(input.port) || input.port < 1 || input.port > 65535) {
+        errors.push('端口号无效（需为 1–65535 之间的整数）');
+    }
+    if (input.auth_type === 'password' && !input.password) {
+        errors.push('密码不能为空');
+    }
+    if (existingNames.includes(input.name)) {
+        errors.push(`服务器 "${input.name}" 已存在，请使用其他名称`);
+    }
+    return errors;
+}
+/**
+ * 持久化层：读取现有配置，追加新服务器，写回
+ */
+export async function persistServer(server) {
+    const config = await loadServers();
+    config.servers.push(server);
+    await saveServers(config);
+}
+/**
+ * 编排层：prompt → validate → persist
+ */
+export async function serverAdd(rl) {
+    try {
+        const input = await promptServerDetails(rl);
+        // 获取已有名称用于去重校验
+        const existing = await loadServers();
+        const existingNames = existing.servers.map((s) => s.name);
+        const errors = validateServerInput(input, existingNames);
+        if (errors.length > 0) {
+            for (const err of errors) {
+                console.log(chalk.yellow(`\n  ${err}`));
+            }
+            console.log();
+            return true;
+        }
+        await persistServer({
+            name: input.name,
+            host: input.host,
+            user: input.user,
+            port: input.port,
+            auth_type: input.auth_type,
+            identity_file: input.identity_file,
+            password: input.password,
+            description: input.description,
+        });
+        console.log(chalk.green(`\n  ✓ Server "${input.name}" added successfully\n`));
+        return true;
+    }
+    catch (error) {
+        if (error instanceof CancelError) {
+            console.log();
+            return true;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/commands/server.js.map

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

package/dist/config/manager.d.ts

@@ -21,6 +21,7 @@ export declare function getLogsDir(): string;
 export declare function ensureConfigDir(): Promise<void>;
 /**
  * 解析 "provider/model_name" 格式的模型 ID
+ * 对 provider 名称做白名单校验，不合法时抛出错误
  */
 export declare function parseModelId(modelId: string): {
     provider: LLMProviderName;
@@ -39,10 +40,23 @@ export declare function getActiveProvider(config: SenoConfig): {
     model: string;
     providerConfig: ProviderConfig;
 } | null;
+/**
+ * 验证配置对象的结构和必需字段
+ * 纯函数，不涉及文件 I/O
+ *
+ * @param raw 待验证的原始对象
+ * @returns 验证结果：valid 标识是否通过，errors 包含所有错误描述
+ */
+export declare function validateConfig(raw: unknown): {
+    valid: boolean;
+    errors: string[];
+};
 /**
  * 读取配置文件 ~/.seno/config.json
  * 自动检测并迁移旧格式配置
+ *
  * @returns 配置对象，文件不存在返回 null
+ * @throws ConfigValidationError 配置文件存在但内容无效时抛出
  */
 export declare function loadConfig(): Promise<SenoConfig | null>;
 /**