dxkj 0.1.0 → 0.1.2

package/src/cli.js

@@ -1,321 +1,320 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { parseArgs } from 'node:util';
-import { loadConfig, saveConfig, resolveServerUrl, CONFIG_PATH, getByPath, setByPath } from './lib/config.js';
-import { loadRegistry, filterItems, findByRef, resolveSource } from './lib/registry.js';
-import { validateItem, formatReport } from './lib/validator.js';
-import { renderList, renderDetail } from './lib/format.js';
-import { resolveTargetDir } from './lib/targets.js';
-import { downloadToTemp, extractZip, writeManifest, cleanup } from './lib/installer.js';
-
-const VERSION = '0.1.0';
-
-const OPTIONS = {
-  source: { type: 'string' },
-  server: { type: 'string' },
-  kind: { type: 'string' },
-  category: { type: 'string' },
-  tag: { type: 'string' },
-  status: { type: 'string' },
-  target: { type: 'string' },
-  editor: { type: 'string' },
-  dir: { type: 'string' },
-  json: { type: 'boolean' },
-  all: { type: 'boolean' },
-  force: { type: 'boolean' },
-  help: { type: 'boolean', short: 'h' },
-  version: { type: 'boolean', short: 'v' },
-  yes: { type: 'boolean', short: 'y' }
-};
-
-function parse(argv) {
-  return parseArgs({ args: argv, options: OPTIONS, allowPositionals: true, strict: false });
-}
-
-function help() {
-  return `dxkj v${VERSION} — dxkj 目录 CLI（prompt / skill / agent / plugin / tool）
-
-用法：
-  dxkj list [--kind skill] [--category CG] [--tag x] [--source <url|file>] [--json]
-  dxkj search <关键词>
-  dxkj show <编号|id>
-  dxkj install <编号...> [--target ai-editor|navlink|generic] [--editor opencode|claude] [--dir 路径]
-  dxkj install --all [--kind skill]
-  dxkj uninstall <编号...>
-  dxkj validate <条目.json>
-  dxkj config get [键] | config set <键> <值> | config path
-  dxkj --help | --version
-
-默认服务地址：${resolveServerUrl()}
-配置文件：${CONFIG_PATH}
-站点未集成时可用 --source ./fixtures/sample-registry.json 本地验证。`;
-}
-
-async function cmdList(argv) {
-  const { values } = parse(argv);
-  const cfg = loadConfig();
-  const { items, source } = await loadRegistry(values, cfg);
-  const list = filterItems(items, values);
-  if (values.json) {
-    console.log(JSON.stringify({ source, count: list.length, items: list }, null, 2));
-    return 0;
-  }
-  console.log(`数据源: ${source}`);
-  console.log(renderList(list));
-  console.log(`\n共 ${list.length} 条`);
-  return 0;
-}
-
-async function cmdSearch(argv) {
-  const { values, positionals } = parse(argv);
-  const kw = positionals.slice(1).join(' ').toLowerCase();
-  if (!kw) {
-    console.error('用法：dxkj search <关键词>');
-    return 1;
-  }
-  const cfg = loadConfig();
-  const { items } = await loadRegistry(values, cfg);
-  const list = filterItems(items, values).filter((it) =>
-    [it.id, it.name, it.description, it.intro, it.category, ...it.tags].join(' ').toLowerCase().includes(kw)
-  );
-  console.log(renderList(list));
-  console.log(`\n命中 ${list.length} 条`);
-  return 0;
-}
-
-async function cmdShow(argv) {
-  const { values, positionals } = parse(argv);
-  const ref = positionals[1];
-  if (!ref) {
-    console.error('用法：dxkj show <编号|id>');
-    return 1;
-  }
-  const cfg = loadConfig();
-  const { items } = await loadRegistry(values, cfg);
-  const item = findByRef(items, ref);
-  if (!item) {
-    console.error(`未找到条目：${ref}`);
-    return 1;
-  }
-  if (values.json) {
-    console.log(JSON.stringify(item, null, 2));
-    return 0;
-  }
-  console.log(renderDetail(item, resolveServerUrl(values, cfg)));
-  return 0;
-}
-
-async function cmdInstall(argv) {
-  const { values, positionals } = parse(argv);
-  const cfg = loadConfig();
-  const { items } = await loadRegistry(values, cfg);
-
-  let targets = positionals.slice(1);
-  if (values.all) {
-    targets = filterItems(items, values).map((it) => String(it.number));
-  } else if (values.kind && targets.length === 0) {
-    targets = filterItems(items, values).map((it) => String(it.number));
-  }
-  if (targets.length === 0) {
-    console.error('用法：dxkj install <编号...> | dxkj install --all [--kind skill]');
-    return 1;
-  }
-
-  // navlink 目标可直接复用插件安装包（先支持 zip 解压方式）
-  let ok = 0;
-  let failed = 0;
-  for (const ref of targets) {
-    const item = findByRef(items, ref);
-    if (!item) {
-      console.error(`✗ 未找到条目：${ref}`);
-      failed++;
-      continue;
-    }
-    if (!item.install.url) {
-      console.error(`✗ #${item.number} ${item.name} 缺少安装包地址，跳过`);
-      failed++;
-      continue;
-    }
-    let dest;
-    try {
-      dest = resolveTargetDir(item, values, cfg);
-    } catch (err) {
-      console.error(`✗ #${item.number} ${item.name}: ${err.message}`);
-      failed++;
-      continue;
-    }
-    let temp = null;
-    try {
-      temp = await downloadToTemp(item.install.url);
-      extractZip(temp, dest.dir);
-      writeManifest(dest.dir, {
-        id: item.id,
-        number: item.number,
-        name: item.name,
-        kind: item.kind,
-        version: item.version,
-        source: item.install.url,
-        target: dest.target,
-        installedAt: new Date().toISOString()
-      });
-      console.log(`✓ 已安装 #${item.number} ${item.name} → ${dest.dir}  (${dest.hint})`);
-      ok++;
-    } catch (err) {
-      console.error(`✗ #${item.number} ${item.name}: ${err.message}`);
-      failed++;
-    } finally {
-      if (temp) cleanup(temp);
-    }
-  }
-  console.log(`\n完成：成功 ${ok}，失败 ${failed}`);
-  return failed === 0 ? 0 : 1;
-}
-
-async function cmdUninstall(argv) {
-  const { values, positionals } = parse(argv);
-  const cfg = loadConfig();
-  const { items } = await loadRegistry(values, cfg);
-  const { removeDirSafe, readManifest } = await import('./lib/installer.js');
-
-  const refs = positionals.slice(1);
-  if (refs.length === 0) {
-    console.error('用法：dxkj uninstall <编号...>');
-    return 1;
-  }
-  let ok = 0;
-  let failed = 0;
-  for (const ref of refs) {
-    const item = findByRef(items, ref);
-    if (!item) {
-      console.error(`✗ 未找到条目：${ref}`);
-      failed++;
-      continue;
-    }
-    let dest;
-    try {
-      dest = resolveTargetDir(item, values, cfg);
-    } catch (err) {
-      console.error(`✗ ${item.name}: ${err.message}`);
-      failed++;
-      continue;
-    }
-    if (!fs.existsSync(dest.dir)) {
-      console.error(`✗ ${item.name}: 未安装（${dest.dir} 不存在）`);
-      failed++;
-      continue;
-    }
-    const meta = readManifest(dest.dir);
-    removeDirSafe(dest.dir);
-    console.log(`✓ 已卸载 ${meta ? meta.name : item.name}（${dest.dir}）`);
-    ok++;
-  }
-  console.log(`\n完成：成功 ${ok}，失败 ${failed}`);
-  return failed === 0 ? 0 : 1;
-}
-
-async function cmdValidate(argv) {
-  const { positionals } = parse(argv);
-  const file = positionals[1];
-  if (!file) {
-    console.error('用法：dxkj validate <条目.json>');
-    return 1;
-  }
-  const abs = path.resolve(process.cwd(), file);
-  if (!fs.existsSync(abs)) {
-    console.error(`文件不存在：${abs}`);
-    return 1;
-  }
-  let data;
-  try {
-    data = JSON.parse(fs.readFileSync(abs, 'utf-8').replace(/^\uFEFF/, ''));
-  } catch (err) {
-    console.error(`JSON 解析失败：${err.message}`);
-    return 1;
-  }
-  const list = Array.isArray(data) ? data : [data];
-  let hasError = false;
-  for (const it of list) {
-    const report = formatReport(it.id || it.name || '(未命名)', validateItem(it));
-    console.log(report.text);
-    if (!report.ok) hasError = true;
-  }
-  return hasError ? 1 : 0;
-}
-
-async function cmdConfig(argv) {
-  const { values, positionals } = parse(argv);
-  const action = positionals[1] || 'get';
-  const cfg = loadConfig();
-
-  if (action === 'path') {
-    console.log(CONFIG_PATH);
-    return 0;
-  }
-  if (action === 'get') {
-    const key = positionals[2];
-    if (!key) {
-      console.log(JSON.stringify(cfg, null, 2));
-      return 0;
-    }
-    const val = getByPath(cfg, key);
-    console.log(typeof val === 'object' ? JSON.stringify(val, null, 2) : String(val));
-    return 0;
-  }
-  if (action === 'set') {
-    const key = positionals[2];
-    let val = positionals.slice(3).join(' ');
-    if (!key || val === '') {
-      console.error('用法：dxkj config set <键> <值>');
-      return 1;
-    }
-    // 数字/布尔简单转换
-    if (val === 'true') val = true;
-    else if (val === 'false') val = false;
-    const base = loadConfig();
-    setByPath(base, key, val);
-    saveConfig(base);
-    console.log(`✓ 已写入 ${key} = ${val}`);
-    return 0;
-  }
-  console.error(`未知 config 操作：${action}`);
-  return 1;
-}
-
-export async function run(argv) {
-  const command = argv[0];
-
-  if (!command || command === 'help' || argv.includes('--help') || argv.includes('-h')) {
-    console.log(help());
-    return 0;
-  }
-  if (command === 'version' || argv.includes('--version') || argv.includes('-v')) {
-    console.log(VERSION);
-    return 0;
-  }
-
-  switch (command) {
-    case 'list':
-      return cmdList(argv);
-    case 'search':
-      return cmdSearch(argv);
-    case 'show':
-    case 'info':
-      return cmdShow(argv);
-    case 'install':
-    case 'i':
-      return cmdInstall(argv);
-    case 'uninstall':
-    case 'remove':
-    case 'rm':
-      return cmdUninstall(argv);
-    case 'validate':
-    case 'lint':
-      return cmdValidate(argv);
-    case 'config':
-      return cmdConfig(argv);
-    default:
-      console.error(`未知命令：${command}\n`);
-      console.log(help());
-      return 1;
-  }
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { loadConfig, saveConfig, resolveServerUrl, CONFIG_PATH, getByPath, setByPath } from './lib/config.js';
+import { loadRegistry, filterItems, findByRef, resolveSource } from './lib/registry.js';
+import { validateItem, formatReport } from './lib/validator.js';
+import { renderList, renderDetail } from './lib/format.js';
+import { resolveTargetDir } from './lib/targets.js';
+import { downloadToTemp, extractZip, writeManifest, cleanup } from './lib/installer.js';
+import { VERSION } from './lib/version.js';
+
+const OPTIONS = {
+  source: { type: 'string' },
+  server: { type: 'string' },
+  kind: { type: 'string' },
+  category: { type: 'string' },
+  tag: { type: 'string' },
+  status: { type: 'string' },
+  target: { type: 'string' },
+  editor: { type: 'string' },
+  dir: { type: 'string' },
+  json: { type: 'boolean' },
+  all: { type: 'boolean' },
+  force: { type: 'boolean' },
+  help: { type: 'boolean', short: 'h' },
+  version: { type: 'boolean', short: 'v' },
+  yes: { type: 'boolean', short: 'y' }
+};
+
+function parse(argv) {
+  return parseArgs({ args: argv, options: OPTIONS, allowPositionals: true, strict: false });
+}
+
+function help() {
+  return `dxkj v${VERSION} — dxkj 目录 CLI（prompt / skill / agent / plugin / tool）
+
+用法：
+  dxkj list [--kind skill] [--category CG] [--tag x] [--source <url|file>] [--json]
+  dxkj search <关键词>
+  dxkj show <编号|id>
+  dxkj install <编号...> [--target ai-editor|navlink|generic] [--editor opencode|claude] [--dir 路径]
+  dxkj install --all [--kind skill]
+  dxkj uninstall <编号...>
+  dxkj validate <条目.json>
+  dxkj config get [键] | config set <键> <值> | config path
+  dxkj --help | --version
+
+默认服务地址：${resolveServerUrl()}
+配置文件：${CONFIG_PATH}
+站点未集成时可用 --source ./fixtures/sample-registry.json 本地验证。`;
+}
+
+async function cmdList(argv) {
+  const { values } = parse(argv);
+  const cfg = loadConfig();
+  const { items, source } = await loadRegistry(values, cfg);
+  const list = filterItems(items, values);
+  if (values.json) {
+    console.log(JSON.stringify({ source, count: list.length, items: list }, null, 2));
+    return 0;
+  }
+  console.log(`数据源: ${source}`);
+  console.log(renderList(list));
+  console.log(`\n共 ${list.length} 条`);
+  return 0;
+}
+
+async function cmdSearch(argv) {
+  const { values, positionals } = parse(argv);
+  const kw = positionals.slice(1).join(' ').toLowerCase();
+  if (!kw) {
+    console.error('用法：dxkj search <关键词>');
+    return 1;
+  }
+  const cfg = loadConfig();
+  const { items } = await loadRegistry(values, cfg);
+  const list = filterItems(items, values).filter((it) =>
+    [it.id, it.name, it.description, it.intro, it.category, ...it.tags].join(' ').toLowerCase().includes(kw)
+  );
+  console.log(renderList(list));
+  console.log(`\n命中 ${list.length} 条`);
+  return 0;
+}
+
+async function cmdShow(argv) {
+  const { values, positionals } = parse(argv);
+  const ref = positionals[1];
+  if (!ref) {
+    console.error('用法：dxkj show <编号|id>');
+    return 1;
+  }
+  const cfg = loadConfig();
+  const { items } = await loadRegistry(values, cfg);
+  const item = findByRef(items, ref);
+  if (!item) {
+    console.error(`未找到条目：${ref}`);
+    return 1;
+  }
+  if (values.json) {
+    console.log(JSON.stringify(item, null, 2));
+    return 0;
+  }
+  console.log(renderDetail(item, resolveServerUrl(values, cfg)));
+  return 0;
+}
+
+async function cmdInstall(argv) {
+  const { values, positionals } = parse(argv);
+  const cfg = loadConfig();
+  const { items } = await loadRegistry(values, cfg);
+
+  let targets = positionals.slice(1);
+  if (values.all) {
+    targets = filterItems(items, values).map((it) => String(it.number));
+  } else if (values.kind && targets.length === 0) {
+    targets = filterItems(items, values).map((it) => String(it.number));
+  }
+  if (targets.length === 0) {
+    console.error('用法：dxkj install <编号...> | dxkj install --all [--kind skill]');
+    return 1;
+  }
+
+  // navlink 目标可直接复用插件安装包（先支持 zip 解压方式）
+  let ok = 0;
+  let failed = 0;
+  for (const ref of targets) {
+    const item = findByRef(items, ref);
+    if (!item) {
+      console.error(`✗ 未找到条目：${ref}`);
+      failed++;
+      continue;
+    }
+    if (!item.install.url) {
+      console.error(`✗ #${item.number} ${item.name} 缺少安装包地址，跳过`);
+      failed++;
+      continue;
+    }
+    let dest;
+    try {
+      dest = resolveTargetDir(item, values, cfg);
+    } catch (err) {
+      console.error(`✗ #${item.number} ${item.name}: ${err.message}`);
+      failed++;
+      continue;
+    }
+    let temp = null;
+    try {
+      temp = await downloadToTemp(item.install.url);
+      extractZip(temp, dest.dir);
+      writeManifest(dest.dir, {
+        id: item.id,
+        number: item.number,
+        name: item.name,
+        kind: item.kind,
+        version: item.version,
+        source: item.install.url,
+        target: dest.target,
+        installedAt: new Date().toISOString()
+      });
+      console.log(`✓ 已安装 #${item.number} ${item.name} → ${dest.dir}  (${dest.hint})`);
+      ok++;
+    } catch (err) {
+      console.error(`✗ #${item.number} ${item.name}: ${err.message}`);
+      failed++;
+    } finally {
+      if (temp) cleanup(temp);
+    }
+  }
+  console.log(`\n完成：成功 ${ok}，失败 ${failed}`);
+  return failed === 0 ? 0 : 1;
+}
+
+async function cmdUninstall(argv) {
+  const { values, positionals } = parse(argv);
+  const cfg = loadConfig();
+  const { items } = await loadRegistry(values, cfg);
+  const { removeDirSafe, readManifest } = await import('./lib/installer.js');
+
+  const refs = positionals.slice(1);
+  if (refs.length === 0) {
+    console.error('用法：dxkj uninstall <编号...>');
+    return 1;
+  }
+  let ok = 0;
+  let failed = 0;
+  for (const ref of refs) {
+    const item = findByRef(items, ref);
+    if (!item) {
+      console.error(`✗ 未找到条目：${ref}`);
+      failed++;
+      continue;
+    }
+    let dest;
+    try {
+      dest = resolveTargetDir(item, values, cfg);
+    } catch (err) {
+      console.error(`✗ ${item.name}: ${err.message}`);
+      failed++;
+      continue;
+    }
+    if (!fs.existsSync(dest.dir)) {
+      console.error(`✗ ${item.name}: 未安装（${dest.dir} 不存在）`);
+      failed++;
+      continue;
+    }
+    const meta = readManifest(dest.dir);
+    removeDirSafe(dest.dir);
+    console.log(`✓ 已卸载 ${meta ? meta.name : item.name}（${dest.dir}）`);
+    ok++;
+  }
+  console.log(`\n完成：成功 ${ok}，失败 ${failed}`);
+  return failed === 0 ? 0 : 1;
+}
+
+async function cmdValidate(argv) {
+  const { positionals } = parse(argv);
+  const file = positionals[1];
+  if (!file) {
+    console.error('用法：dxkj validate <条目.json>');
+    return 1;
+  }
+  const abs = path.resolve(process.cwd(), file);
+  if (!fs.existsSync(abs)) {
+    console.error(`文件不存在：${abs}`);
+    return 1;
+  }
+  let data;
+  try {
+    data = JSON.parse(fs.readFileSync(abs, 'utf-8').replace(/^\uFEFF/, ''));
+  } catch (err) {
+    console.error(`JSON 解析失败：${err.message}`);
+    return 1;
+  }
+  const list = Array.isArray(data) ? data : [data];
+  let hasError = false;
+  for (const it of list) {
+    const report = formatReport(it.id || it.name || '(未命名)', validateItem(it));
+    console.log(report.text);
+    if (!report.ok) hasError = true;
+  }
+  return hasError ? 1 : 0;
+}
+
+async function cmdConfig(argv) {
+  const { values, positionals } = parse(argv);
+  const action = positionals[1] || 'get';
+  const cfg = loadConfig();
+
+  if (action === 'path') {
+    console.log(CONFIG_PATH);
+    return 0;
+  }
+  if (action === 'get') {
+    const key = positionals[2];
+    if (!key) {
+      console.log(JSON.stringify(cfg, null, 2));
+      return 0;
+    }
+    const val = getByPath(cfg, key);
+    console.log(typeof val === 'object' ? JSON.stringify(val, null, 2) : String(val));
+    return 0;
+  }
+  if (action === 'set') {
+    const key = positionals[2];
+    let val = positionals.slice(3).join(' ');
+    if (!key || val === '') {
+      console.error('用法：dxkj config set <键> <值>');
+      return 1;
+    }
+    // 数字/布尔简单转换
+    if (val === 'true') val = true;
+    else if (val === 'false') val = false;
+    const base = loadConfig();
+    setByPath(base, key, val);
+    saveConfig(base);
+    console.log(`✓ 已写入 ${key} = ${val}`);
+    return 0;
+  }
+  console.error(`未知 config 操作：${action}`);
+  return 1;
+}
+
+export async function run(argv) {
+  const command = argv[0];
+
+  if (!command || command === 'help' || argv.includes('--help') || argv.includes('-h')) {
+    console.log(help());
+    return 0;
+  }
+  if (command === 'version' || argv.includes('--version') || argv.includes('-v')) {
+    console.log(VERSION);
+    return 0;
+  }
+
+  switch (command) {
+    case 'list':
+      return cmdList(argv);
+    case 'search':
+      return cmdSearch(argv);
+    case 'show':
+    case 'info':
+      return cmdShow(argv);
+    case 'install':
+    case 'i':
+      return cmdInstall(argv);
+    case 'uninstall':
+    case 'remove':
+    case 'rm':
+      return cmdUninstall(argv);
+    case 'validate':
+    case 'lint':
+      return cmdValidate(argv);
+    case 'config':
+      return cmdConfig(argv);
+    default:
+      console.error(`未知命令：${command}\n`);
+      console.log(help());
+      return 1;
+  }
+}