@edmund32/edx-cli 0.1.2

package/src/commands/alias.mjs

@@ -0,0 +1,301 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { detectPlatform } from '../platform/platform.mjs';
+import { commandExists as defaultCommandExists, runCommand as defaultRunCommand } from '../utils/process.mjs';
+import { fail, ok } from '../utils/result.mjs';
+
+function defaultConfigPath() {
+  return path.join(os.homedir(), '.edx', 'aliases.json');
+}
+
+function help() {
+  return [
+    '--- edx-alias 快捷指令 ---',
+    '用法:',
+    '  edx-alias add <名称> <路径> --type=dir|file [--app <应用>]',
+    '  edx-alias update <名称> <路径> --type=dir|file [--app <应用>]',
+    '  edx-alias open <名称> [--app <应用>]',
+    '  edx-alias ls',
+    '  edx-alias list',
+    '  edx-alias remove <名称>',
+    '提示: --app 的应用名包含空格时请加引号，例如 --app "Visual Studio Code"',
+    '',
+    `配置文件: ${defaultConfigPath()}`,
+  ].join('\n');
+}
+
+function loadConfig(configPath) {
+  if (!fs.existsSync(configPath)) {
+    return { version: 1, aliases: {} };
+  }
+
+  const parsed = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  return {
+    version: 1,
+    aliases: parsed.aliases && typeof parsed.aliases === 'object' ? parsed.aliases : {},
+  };
+}
+
+function saveConfig(configPath, config) {
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
+}
+
+function parseAliasArgs(args) {
+  const positionals = [];
+  let type = null;
+  let app = null;
+
+  for (let i = 0; i < args.length; i++) {
+    const item = args[i];
+    if (item === '--type') {
+      type = args[i + 1] ?? null;
+      i++;
+      continue;
+    }
+    if (item.startsWith('--type=')) {
+      type = item.slice('--type='.length);
+      continue;
+    }
+    if (item === '--app') {
+      app = args[i + 1] ?? null;
+      i++;
+      continue;
+    }
+    if (item.startsWith('--app=')) {
+      app = item.slice('--app='.length);
+      continue;
+    }
+    positionals.push(item);
+  }
+
+  return { positionals, type, app };
+}
+
+function validateName(name) {
+  return /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(name);
+}
+
+function typeLabel(type) {
+  return type === 'file' ? '文件' : '目录';
+}
+
+function resolveTarget(targetPath, type, options) {
+  const absolutePath = path.resolve(options.cwd ?? process.cwd(), targetPath);
+  if (!fs.existsSync(absolutePath)) {
+    return { error: `错误: '${absolutePath}' 不存在。` };
+  }
+
+  const stat = fs.statSync(absolutePath);
+  if (type === 'dir' && !stat.isDirectory()) {
+    return { error: `错误: '${absolutePath}' 不是一个目录。` };
+  }
+  if (type === 'file' && !stat.isFile()) {
+    return { error: `错误: '${absolutePath}' 不是一个文件。` };
+  }
+
+  return { absolutePath };
+}
+
+function colorType(type) {
+  const colors = {
+    dir: '\x1b[36m',
+    file: '\x1b[32m',
+    app: '\x1b[35m',
+    script: '\x1b[33m',
+  };
+  const color = colors[type];
+  return color ? `${color}${type}\x1b[0m` : type;
+}
+
+function addAlias(args, options) {
+  const parsed = parseAliasArgs(args);
+  const [name, targetPath] = parsed.positionals;
+
+  if (!name || !targetPath || parsed.positionals.length !== 2) {
+    return fail(help());
+  }
+  if (parsed.type !== 'dir' && parsed.type !== 'file') {
+    return fail('错误: 添加快捷项必须使用 --type=dir 或 --type=file。');
+  }
+  if (!validateName(name)) {
+    return fail('错误: 名称只能包含字母、数字、下划线和中划线，并且必须以字母或数字开头。');
+  }
+
+  const resolved = resolveTarget(targetPath, parsed.type, options);
+  if (resolved.error) {
+    return fail(resolved.error);
+  }
+
+  const configPath = options.configPath ?? defaultConfigPath();
+  const config = loadConfig(configPath);
+  config.aliases[name] = {
+    type: parsed.type,
+    path: resolved.absolutePath,
+    ...(parsed.type === 'file' && parsed.app ? { app: parsed.app } : {}),
+  };
+  saveConfig(configPath, config);
+
+  return ok(`已添加${typeLabel(parsed.type)}快捷项: ${name}\n路径: ${resolved.absolutePath}`);
+}
+
+function listAliases(options) {
+  const config = loadConfig(options.configPath ?? defaultConfigPath());
+  const entries = Object.entries(config.aliases)
+    .sort(([a], [b]) => a.localeCompare(b));
+
+  if (entries.length === 0) {
+    return ok('暂无快捷项。使用 edx-alias add <名称> <路径> --type=dir|file 添加。');
+  }
+
+  return ok([
+    'target\tpath\ttype',
+    ...entries.map(([name, value]) => `${name}\t${value.path}\t${colorType(value.type)}`),
+  ].join('\n'));
+}
+
+function launcherFor(platform, entry, options = {}) {
+  const targetPath = entry.path;
+  const app = options.app ?? entry.app;
+  if (platform === 'macos') {
+    if (entry.type === 'file' && app) {
+      return { command: 'open', args: ['-a', app, targetPath] };
+    }
+    return { command: 'open', args: [targetPath] };
+  }
+  if (platform === 'windows') {
+    if (entry.type === 'file' && app) {
+      return {
+        command: 'powershell.exe',
+        args: [
+          '-NoProfile',
+          '-Command',
+          `Start-Process -FilePath ${JSON.stringify(app)} -ArgumentList ${JSON.stringify(targetPath)}`,
+        ],
+      };
+    }
+    return entry.type === 'dir'
+      ? { command: 'explorer', args: [targetPath] }
+      : {
+          command: 'powershell.exe',
+          args: ['-NoProfile', '-Command', `Start-Process ${JSON.stringify(targetPath)}`],
+        };
+  }
+  if (platform === 'linux') {
+    if (entry.type === 'file' && app) {
+      return { command: app, args: [targetPath] };
+    }
+    return { command: 'xdg-open', args: [targetPath] };
+  }
+  return null;
+}
+
+function openAlias(name, options) {
+  if (!name) {
+    return fail(help());
+  }
+
+  const config = loadConfig(options.configPath ?? defaultConfigPath());
+  const entry = config.aliases[name];
+  if (!entry) {
+    return fail(`错误: 未找到快捷项 '${name}'。`);
+  }
+
+  const parsed = parseAliasArgs(options.openArgs ?? []);
+  const platform = options.platform ?? detectPlatform();
+  const launcher = launcherFor(platform, entry, { app: parsed.app });
+  if (!launcher) {
+    return fail(`错误: 当前平台不支持打开 '${entry.path}'。`);
+  }
+
+  const commandExists = options.commandExists ?? defaultCommandExists;
+  if (!commandExists(launcher.command)) {
+    return fail(`错误: 缺少打开目录命令 ${launcher.command}。`);
+  }
+
+  const runCommand = options.runCommand ?? defaultRunCommand;
+  const result = runCommand(launcher.command, launcher.args);
+  if (result.code === 0) {
+    return ok(`已打开快捷项: ${name}`);
+  }
+
+  return fail(`错误: 打开失败 ${result.stderr.trim()}`);
+}
+
+function removeAlias(name, options) {
+  if (!name) {
+    return fail(help());
+  }
+
+  const configPath = options.configPath ?? defaultConfigPath();
+  const config = loadConfig(configPath);
+  const entry = config.aliases[name];
+  if (!entry) {
+    return fail(`错误: 未找到快捷项 '${name}'。`);
+  }
+
+  delete config.aliases[name];
+  saveConfig(configPath, config);
+  return entry.type === 'dir' ? ok(`已删除目录快捷项: ${name}`) : ok(`已删除快捷项: ${name}`);
+}
+
+function updateAlias(args, options) {
+  const parsed = parseAliasArgs(args);
+  const [name, targetPath] = parsed.positionals;
+
+  if (!name || !targetPath || parsed.positionals.length !== 2) {
+    return fail(help());
+  }
+  if (parsed.type !== 'dir' && parsed.type !== 'file') {
+    return fail('错误: 更新快捷项必须使用 --type=dir 或 --type=file。');
+  }
+
+  const configPath = options.configPath ?? defaultConfigPath();
+  const config = loadConfig(configPath);
+  if (!config.aliases[name]) {
+    return fail(`错误: 未找到快捷项 '${name}'。`);
+  }
+
+  const resolved = resolveTarget(targetPath, parsed.type, options);
+  if (resolved.error) {
+    return fail(resolved.error);
+  }
+
+  config.aliases[name] = {
+    type: parsed.type,
+    path: resolved.absolutePath,
+    ...(parsed.type === 'file' && parsed.app ? { app: parsed.app } : {}),
+  };
+  saveConfig(configPath, config);
+
+  return ok(`已更新${typeLabel(parsed.type)}快捷项: ${name}\n路径: ${resolved.absolutePath}`);
+}
+
+export async function runAliasCommand(args, options = {}) {
+  const [command, ...rest] = args;
+
+  if (!command || command === '-a' || command === '--help' || command === 'help') {
+    return ok(help());
+  }
+
+  if (command === 'add') {
+    return addAlias(rest, options);
+  }
+  if (command === 'update') {
+    return updateAlias(rest, options);
+  }
+  if (command === 'open') {
+    const parsed = parseAliasArgs(rest);
+    return openAlias(parsed.positionals[0], { ...options, openArgs: rest });
+  }
+  if (command === 'ls' || command === 'list') {
+    return listAliases(options);
+  }
+  if (command === 'remove') {
+    return removeAlias(rest[0], options);
+  }
+
+  return fail(`错误: 未知动作 '${command}'\n${help()}`);
+}

package/src/commands/app.mjs

@@ -0,0 +1,318 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { detectPlatform } from '../platform/platform.mjs';
+import { commandExists as defaultCommandExists, runCommand } from '../utils/process.mjs';
+import { fail, ok } from '../utils/result.mjs';
+
+const APPS = [
+  {
+    id: 'clash',
+    label: 'ClashX Pro',
+    macos: { name: 'ClashX Pro' },
+    windows: { name: 'Clash' },
+    linux: { name: 'clash' },
+  },
+  {
+    id: 'snipaste',
+    label: 'Snipaste',
+    macos: { name: 'Snipaste' },
+    windows: { name: 'Snipaste' },
+    linux: { name: 'snipaste' },
+  },
+  {
+    id: 'betterdisplay',
+    label: 'BetterDisplay',
+    macos: { name: 'BetterDisplay' },
+  },
+  {
+    id: 'netease',
+    label: '网易云音乐',
+    macos: { name: 'NeteaseMusic' },
+    windows: { name: '网易云音乐' },
+    linux: { name: 'netease-cloud-music' },
+  },
+  {
+    id: 'vscode',
+    label: 'VS Code',
+    macos: { name: 'Visual Studio Code' },
+    windows: { name: 'Code' },
+    linux: { name: 'code' },
+  },
+];
+
+function help() {
+  return [
+    '--- edx-app 可用的指令集列表 ---',
+    '0. edx-app show        显示当前环境',
+    '1. edx-app start       启动所有应用',
+    '2. edx-app vscode      启动 VS Code',
+    '3. edx-app ls          列出可传给 --app 的应用值',
+    '4. edx-app run <APP>   打开指定应用',
+    '--------------------------',
+  ].join('\n');
+}
+
+function launcherFor(platform, app) {
+  const config = app[platform];
+  if (!config) {
+    return null;
+  }
+
+  if (platform === 'macos') {
+    return { command: 'open', args: ['-a', config.name] };
+  }
+  if (platform === 'windows') {
+    return {
+      command: 'powershell.exe',
+      args: ['-NoProfile', '-Command', `Start-Process ${JSON.stringify(config.name)}`],
+    };
+  }
+  if (platform === 'linux') {
+    return { command: config.name, args: [] };
+  }
+
+  return null;
+}
+
+function launcherForAppName(platform, appName) {
+  if (platform === 'macos') {
+    return { command: 'open', args: ['-a', appName] };
+  }
+  if (platform === 'windows') {
+    return {
+      command: 'powershell.exe',
+      args: ['-NoProfile', '-Command', `Start-Process -FilePath ${JSON.stringify(appName)}`],
+    };
+  }
+  if (platform === 'linux') {
+    return { command: appName, args: [] };
+  }
+
+  return null;
+}
+
+function show(options) {
+  const platform = options.platform ?? detectPlatform();
+  const lines = [`当前平台: ${platform}`, '----------------------------------------'];
+
+  for (const app of APPS) {
+    lines.push(`${app.label}: ${app[platform] ? '已配置' : '当前平台未配置'}`);
+  }
+
+  lines.push('----------------------------------------');
+  return ok(lines.join('\n'));
+}
+
+function defaultAppDirectories(platform) {
+  if (platform === 'macos') {
+    return [
+      '/Applications',
+      path.join(os.homedir(), 'Applications'),
+    ];
+  }
+  if (platform === 'linux') {
+    return [
+      '/usr/share/applications',
+      path.join(os.homedir(), '.local/share/applications'),
+    ];
+  }
+  if (platform === 'windows') {
+    return [
+      ...(process.env.ProgramData
+        ? [path.join(process.env.ProgramData, 'Microsoft/Windows/Start Menu/Programs')]
+        : []),
+      ...(process.env.APPDATA
+        ? [path.join(process.env.APPDATA, 'Microsoft/Windows/Start Menu/Programs')]
+        : []),
+    ];
+  }
+
+  return [];
+}
+
+function listDirectoryEntries(dir) {
+  if (!fs.existsSync(dir)) {
+    return [];
+  }
+
+  return fs.readdirSync(dir, { withFileTypes: true }).map((entry) => ({
+    name: entry.name,
+    isDirectory: entry.isDirectory(),
+    path: path.join(dir, entry.name),
+  }));
+}
+
+function readTextFile(filePath) {
+  return fs.readFileSync(filePath, 'utf8');
+}
+
+function extractDesktopExec(content) {
+  const execLine = content
+    .split(/\r?\n/)
+    .find((line) => line.startsWith('Exec='));
+  if (!execLine) {
+    return null;
+  }
+
+  const execValue = execLine
+    .slice('Exec='.length)
+    .replace(/\s+%[a-zA-Z]/g, '')
+    .trim();
+  const tokens = execValue.match(/"[^"]+"|'[^']+'|\S+/g) ?? [];
+  const command = tokens.find((token, index) => {
+    if (index === 0 && token === 'env') {
+      return false;
+    }
+    return !/^[A-Za-z_][A-Za-z0-9_]*=.*/.test(token);
+  });
+
+  return command ? command.replace(/^["']|["']$/g, '') : null;
+}
+
+function collectWindowsShortcuts(dir, listDirectory, names) {
+  for (const entry of listDirectory(dir)) {
+    const entryPath = entry.path ?? path.join(dir, entry.name);
+    if (entry.isDirectory) {
+      collectWindowsShortcuts(entryPath, listDirectory, names);
+      continue;
+    }
+    if (entry.name.endsWith('.lnk')) {
+      names.add(entryPath);
+    }
+  }
+}
+
+function listApps(options) {
+  const platform = options.platform ?? detectPlatform();
+  const appDirectories = options.appDirectories ?? defaultAppDirectories(platform);
+  const listDirectory = options.listDirectory ?? listDirectoryEntries;
+  const readFile = options.readFile ?? readTextFile;
+  const names = new Set();
+
+  if (platform === 'macos') {
+    for (const dir of appDirectories) {
+      for (const entry of listDirectory(dir)) {
+        if (!entry.isDirectory || !entry.name.endsWith('.app')) {
+          continue;
+        }
+        names.add(entry.name.slice(0, -'.app'.length));
+      }
+    }
+  } else if (platform === 'linux') {
+    for (const dir of appDirectories) {
+      for (const entry of listDirectory(dir)) {
+        if (entry.isDirectory || !entry.name.endsWith('.desktop')) {
+          continue;
+        }
+        const command = extractDesktopExec(readFile(entry.path ?? path.join(dir, entry.name)));
+        if (command) {
+          names.add(command);
+        }
+      }
+    }
+  } else if (platform === 'windows') {
+    for (const dir of appDirectories) {
+      collectWindowsShortcuts(dir, listDirectory, names);
+    }
+  } else {
+    return fail('错误: 当前平台不支持应用枚举。');
+  }
+
+  const sorted = [...names].sort((a, b) => a.localeCompare(b));
+  return sorted.length === 0 ? ok('未找到应用。') : ok(sorted.join('\n'));
+}
+
+function startApps(apps, options) {
+  const platform = options.platform ?? detectPlatform();
+  const commandExists = options.commandExists ?? defaultCommandExists;
+  const lines = [];
+  let failures = 0;
+
+  for (const app of apps) {
+    const launcher = launcherFor(platform, app);
+
+    if (!launcher) {
+      lines.push(`${app.label}: 当前平台未配置，跳过`);
+      continue;
+    }
+
+    if (!commandExists(launcher.command)) {
+      lines.push(`${app.label}: 缺少启动命令 ${launcher.command}，跳过`);
+      failures++;
+      continue;
+    }
+
+    if (options.dryRun) {
+      lines.push(`${app.label}: 将执行 ${launcher.command} ${launcher.args.join(' ')}`);
+      continue;
+    }
+
+    const result = runCommand(launcher.command, launcher.args);
+    if (result.code === 0) {
+      lines.push(`${app.label}: 已启动`);
+    } else {
+      lines.push(`${app.label}: 启动失败 ${result.stderr.trim()}`);
+      failures++;
+    }
+  }
+
+  return failures > 0 ? fail(lines.join('\n')) : ok(lines.join('\n'));
+}
+
+function runApp(args, options) {
+  const appName = args.join(' ').trim();
+  if (!appName) {
+    return fail(`用法: edx-app run <APP>\n${help()}`);
+  }
+
+  const platform = options.platform ?? detectPlatform();
+  const launcher = launcherForAppName(platform, appName);
+  if (!launcher) {
+    return fail(`错误: 当前平台不支持打开应用 '${appName}'。`);
+  }
+
+  const commandExists = options.commandExists ?? defaultCommandExists;
+  if (!commandExists(launcher.command)) {
+    return fail(`错误: 缺少启动命令 ${launcher.command}。`);
+  }
+
+  if (options.dryRun) {
+    return ok(`将执行 ${launcher.command} ${launcher.args.join(' ')}`);
+  }
+
+  const execute = options.runCommand ?? runCommand;
+  const result = execute(launcher.command, launcher.args);
+  if (result.code === 0) {
+    return ok(`已打开应用: ${appName}`);
+  }
+
+  return fail(`错误: 打开应用失败 ${result.stderr.trim()}`);
+}
+
+export async function runAppCommand(args, options = {}) {
+  const [command, ...rest] = args;
+
+  if (!command || command === '-a' || command === '--help' || command === 'help') {
+    return ok(help());
+  }
+
+  if (command === 'show') {
+    return show(options);
+  }
+  if (command === 'ls' || command === 'list') {
+    return listApps(options);
+  }
+  if (command === 'run') {
+    return runApp(rest, options);
+  }
+  if (command === 'start') {
+    return startApps(APPS.filter((app) => app.id !== 'vscode'), options);
+  }
+  if (command === 'vscode') {
+    return startApps(APPS.filter((app) => app.id === 'vscode'), options);
+  }
+
+  return fail(`错误: 未知动作 '${command}'\n${help()}`);
+}

package/src/commands/hw.mjs

@@ -0,0 +1,84 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { commandExists as defaultCommandExists, runCommand } from '../utils/process.mjs';
+import { fail, ok } from '../utils/result.mjs';
+
+function help() {
+  return [
+    '--- edx-hw 可用的指令集列表 ---',
+    '0. edx-hw show        显示当前环境',
+    '1. edx-hw publish     向远端推送包',
+    '2. edx-hw debug       启动鸿蒙调试',
+    '--------------------------',
+  ].join('\n');
+}
+
+function listHarFiles(cwd) {
+  return fs.readdirSync(cwd).filter((entry) => entry.endsWith('.har') && fs.statSync(path.join(cwd, entry)).isFile());
+}
+
+function show(commandExists) {
+  const lines = ['正在检查开发环境...', '----------------------------------------'];
+
+  for (const command of ['node', 'npm', 'ohpm']) {
+    lines.push(`${command}: ${commandExists(command) ? '已安装' : '未安装'}`);
+  }
+
+  lines.push('----------------------------------------');
+  return ok(lines.join('\n'));
+}
+
+function publish(options) {
+  const commandExists = options.commandExists ?? defaultCommandExists;
+  const cwd = options.cwd ?? process.cwd();
+
+  if (!commandExists('ohpm')) {
+    return fail('错误: 未找到 ohpm，无法执行 ohpm publish。');
+  }
+
+  const harFiles = listHarFiles(cwd);
+  if (harFiles.length === 0) {
+    return fail('错误: 当前目录没有可发布的 .har 文件。');
+  }
+
+  if (options.dryRun) {
+    return ok(`将执行: ohpm publish ${harFiles.join(' ')}`);
+  }
+
+  return runCommand('ohpm', ['publish', ...harFiles], { cwd });
+}
+
+function debug(options) {
+  const commandExists = options.commandExists ?? defaultCommandExists;
+
+  if (!commandExists('hw-dev')) {
+    return fail('错误: 未找到 hw-dev，当前机器未安装鸿蒙调试工具。');
+  }
+
+  if (options.dryRun) {
+    return ok('将执行: hw-dev');
+  }
+
+  return runCommand('hw-dev');
+}
+
+export async function runHwCommand(args, options = {}) {
+  const [command] = args;
+
+  if (!command || command === '-a' || command === '--help' || command === 'help') {
+    return ok(help());
+  }
+
+  if (command === 'show') {
+    return show(options.commandExists ?? defaultCommandExists);
+  }
+  if (command === 'publish') {
+    return publish(options);
+  }
+  if (command === 'debug') {
+    return debug(options);
+  }
+
+  return fail(`错误: 未知动作 '${command}'\n${help()}`);
+}