dxkj 0.1.0 → 0.1.2

package/src/lib/config.js

@@ -1,93 +1,93 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-/** 默认服务地址：dxkj 工具站在服务器上的子域名 */
-export const DEFAULT_SERVER_URL = 'https://tools.dxkj.online';
-
-/** 目录 API 路径（由 NavLink 的 ai-catalog 插件提供） */
-export const REGISTRY_PATH = '/api/plugins/ai-catalog/api/registry';
-
-export const CONFIG_DIR = path.join(os.homedir(), '.dxkj');
-export const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
-
-export function defaultConfig() {
-  return {
-    serverUrl: DEFAULT_SERVER_URL,
-    target: 'generic',
-    editor: 'opencode',
-    targets: {
-      aiEditor: {
-        opencode: {
-          base: path.join(os.homedir(), '.config', 'opencode'),
-          map: { skill: 'skills', agent: 'agent', prompt: 'command', plugin: 'plugin', tool: 'tool' }
-        },
-        claude: {
-          base: path.join(os.homedir(), '.claude'),
-          map: { skill: 'skills', agent: 'agents', prompt: 'commands', plugin: 'plugins', tool: 'tools' }
-        }
-      },
-      navlink: { pluginsDir: '' },
-      generic: { dir: '' }
-    }
-  };
-}
-
-function isObject(v) {
-  return v && typeof v === 'object' && !Array.isArray(v);
-}
-
-export function deepMerge(base, over) {
-  if (!isObject(over)) return base;
-  const out = Array.isArray(base) ? [...base] : { ...base };
-  for (const [k, v] of Object.entries(over)) {
-    out[k] = isObject(v) && isObject(out[k]) ? deepMerge(out[k], v) : v;
-  }
-  return out;
-}
-
-export function readConfigFile() {
-  try {
-    return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8').replace(/^\uFEFF/, ''));
-  } catch {
-    return {};
-  }
-}
-
-export function loadConfig() {
-  return deepMerge(defaultConfig(), readConfigFile());
-}
-
-export function saveConfig(cfg) {
-  fs.mkdirSync(CONFIG_DIR, { recursive: true });
-  fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 4) + '\n', 'utf-8');
-}
-
-export function getByPath(obj, dotted) {
-  return dotted.split('.').reduce((acc, k) => (acc == null ? acc : acc[k]), obj);
-}
-
-/** 把 "a.b.c" 写成嵌套对象 */
-export function setByPath(obj, dotted, value) {
-  const keys = dotted.split('.');
-  let cur = obj;
-  for (let i = 0; i < keys.length - 1; i++) {
-    if (!isObject(cur[keys[i]])) cur[keys[i]] = {};
-    cur = cur[keys[i]];
-  }
-  cur[keys[keys.length - 1]] = value;
-  return obj;
-}
-
-/** serverUrl 解析优先级：--server > DXKJ_SERVER_URL > 配置文件 > 默认 */
-export function resolveServerUrl(opts = {}, cfg = loadConfig()) {
-  const raw = opts.server || process.env.DXKJ_SERVER_URL || cfg.serverUrl || DEFAULT_SERVER_URL;
-  return String(raw).replace(/\/+$/, '');
-}
-
-export function expandHome(p) {
-  if (!p) return p;
-  if (p === '~') return os.homedir();
-  if (p.startsWith('~/') || p.startsWith('~\\')) return path.join(os.homedir(), p.slice(2));
-  return p;
-}
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+/** 默认服务地址：dxkj 工具站在服务器上的子域名 */
+export const DEFAULT_SERVER_URL = 'https://tools.dxkj.online';
+
+/** 目录 API 路径（由 NavLink 的 ai-catalog 插件提供） */
+export const REGISTRY_PATH = '/api/plugins/ai-catalog/api/registry';
+
+export const CONFIG_DIR = path.join(os.homedir(), '.dxkj');
+export const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
+
+export function defaultConfig() {
+  return {
+    serverUrl: DEFAULT_SERVER_URL,
+    target: 'generic',
+    editor: 'opencode',
+    targets: {
+      aiEditor: {
+        opencode: {
+          base: path.join(os.homedir(), '.config', 'opencode'),
+          map: { skill: 'skills', agent: 'agent', prompt: 'command', plugin: 'plugin', tool: 'tool' }
+        },
+        claude: {
+          base: path.join(os.homedir(), '.claude'),
+          map: { skill: 'skills', agent: 'agents', prompt: 'commands', plugin: 'plugins', tool: 'tools' }
+        }
+      },
+      navlink: { pluginsDir: '' },
+      generic: { dir: '' }
+    }
+  };
+}
+
+function isObject(v) {
+  return v && typeof v === 'object' && !Array.isArray(v);
+}
+
+export function deepMerge(base, over) {
+  if (!isObject(over)) return base;
+  const out = Array.isArray(base) ? [...base] : { ...base };
+  for (const [k, v] of Object.entries(over)) {
+    out[k] = isObject(v) && isObject(out[k]) ? deepMerge(out[k], v) : v;
+  }
+  return out;
+}
+
+export function readConfigFile() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8').replace(/^\uFEFF/, ''));
+  } catch {
+    return {};
+  }
+}
+
+export function loadConfig() {
+  return deepMerge(defaultConfig(), readConfigFile());
+}
+
+export function saveConfig(cfg) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 4) + '\n', 'utf-8');
+}
+
+export function getByPath(obj, dotted) {
+  return dotted.split('.').reduce((acc, k) => (acc == null ? acc : acc[k]), obj);
+}
+
+/** 把 "a.b.c" 写成嵌套对象 */
+export function setByPath(obj, dotted, value) {
+  const keys = dotted.split('.');
+  let cur = obj;
+  for (let i = 0; i < keys.length - 1; i++) {
+    if (!isObject(cur[keys[i]])) cur[keys[i]] = {};
+    cur = cur[keys[i]];
+  }
+  cur[keys[keys.length - 1]] = value;
+  return obj;
+}
+
+/** serverUrl 解析优先级：--server > DXKJ_SERVER_URL > 配置文件 > 默认 */
+export function resolveServerUrl(opts = {}, cfg = loadConfig()) {
+  const raw = opts.server || process.env.DXKJ_SERVER_URL || cfg.serverUrl || DEFAULT_SERVER_URL;
+  return String(raw).replace(/\/+$/, '');
+}
+
+export function expandHome(p) {
+  if (!p) return p;
+  if (p === '~') return os.homedir();
+  if (p.startsWith('~/') || p.startsWith('~\\')) return path.join(os.homedir(), p.slice(2));
+  return p;
+}

package/src/lib/format.js

@@ -1,49 +1,49 @@
-export function truncate(str, len) {
-  const s = String(str ?? '');
-  return s.length > len ? s.slice(0, Math.max(0, len - 1)) + '…' : s;
-}
-
-export function renderList(items, { showIntro = false } = {}) {
-  if (!items.length) return '(空)';
-  const rows = items.map((it) => ({
-    no: String(it.number).padStart(4, ' '),
-    kind: truncate(it.kind, 7).padEnd(7, ' '),
-    id: it.id,
-    status: it.status,
-    desc: truncate(it.description, showIntro ? 60 : 40)
-  }));
-  const idw = Math.min(52, Math.max(4, ...rows.map((r) => r.id.length)));
-  return rows
-    .map((r) => `${r.no}  ${r.kind}  ${r.id.padEnd(idw, ' ')}  ${r.desc}`)
-    .join('\n');
-}
-
-export function renderDetail(it, serverUrl) {
-  const lines = [];
-  lines.push(`#${it.number}  ${it.name}  [${it.kind}]`);
-  lines.push(`  id         ${it.id}`);
-  lines.push(`  分类       ${it.category}`);
-  lines.push(`  状态       ${it.status}`);
-  if (it.version) lines.push(`  版本       ${it.version}`);
-  if (it.author) lines.push(`  作者       ${it.author}`);
-  if (it.tags.length) lines.push(`  标签       ${it.tags.join(', ')}`);
-  lines.push(`  简介       ${it.description}`);
-  if (it.intro) {
-    lines.push('  ———— 简介区 ————');
-    for (const l of String(it.intro).split(/\r?\n/)) lines.push(`  ${l}`);
-  }
-  if (it.images.length) {
-    lines.push('  ———— 图片展示区 ————');
-    for (const img of it.images) lines.push(`  ${img}`);
-  }
-  lines.push(`  安装       dxkj install ${it.number}`);
-  return lines.join('\n');
-}
-
-export function pluck(value, keys) {
-  for (const k of keys) {
-    if (value == null) return value;
-    value = value[k];
-  }
-  return value;
-}
+export function truncate(str, len) {
+  const s = String(str ?? '');
+  return s.length > len ? s.slice(0, Math.max(0, len - 1)) + '…' : s;
+}
+
+export function renderList(items, { showIntro = false } = {}) {
+  if (!items.length) return '(空)';
+  const rows = items.map((it) => ({
+    no: String(it.number).padStart(4, ' '),
+    kind: truncate(it.kind, 7).padEnd(7, ' '),
+    id: it.id,
+    status: it.status,
+    desc: truncate(it.description, showIntro ? 60 : 40)
+  }));
+  const idw = Math.min(52, Math.max(4, ...rows.map((r) => r.id.length)));
+  return rows
+    .map((r) => `${r.no}  ${r.kind}  ${r.id.padEnd(idw, ' ')}  ${r.desc}`)
+    .join('\n');
+}
+
+export function renderDetail(it, serverUrl) {
+  const lines = [];
+  lines.push(`#${it.number}  ${it.name}  [${it.kind}]`);
+  lines.push(`  id         ${it.id}`);
+  lines.push(`  分类       ${it.category}`);
+  lines.push(`  状态       ${it.status}`);
+  if (it.version) lines.push(`  版本       ${it.version}`);
+  if (it.author) lines.push(`  作者       ${it.author}`);
+  if (it.tags.length) lines.push(`  标签       ${it.tags.join(', ')}`);
+  lines.push(`  简介       ${it.description}`);
+  if (it.intro) {
+    lines.push('  ———— 简介区 ————');
+    for (const l of String(it.intro).split(/\r?\n/)) lines.push(`  ${l}`);
+  }
+  if (it.images.length) {
+    lines.push('  ———— 图片展示区 ————');
+    for (const img of it.images) lines.push(`  ${img}`);
+  }
+  lines.push(`  安装       dxkj install ${it.number}`);
+  return lines.join('\n');
+}
+
+export function pluck(value, keys) {
+  for (const k of keys) {
+    if (value == null) return value;
+    value = value[k];
+  }
+  return value;
+}

package/src/lib/installer.js

@@ -1,68 +1,69 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { pipeline } from 'node:stream/promises';
-import AdmZip from 'adm-zip';
-
-export const MANIFEST = '.dxkj.json';
-
-export async function downloadToTemp(url) {
-  const tmp = path.join(os.tmpdir(), `dxkj-${Date.now()}-${Math.random().toString(36).slice(2)}`);
-  fs.mkdirSync(tmp, { recursive: true });
-  const target = path.join(tmp, 'package.zip');
-
-  if (/^https?:\/\//i.test(url)) {
-    const res = await fetch(url, { headers: { 'User-Agent': 'dxkj-cli/0.1.0' } });
-    if (!res.ok) throw new Error(`下载失败 HTTP ${res.status}：${url}`);
-    await pipeline(res.body, fs.createWriteStream(target));
-  } else {
-    const local = path.resolve(process.cwd(), url);
-    if (!fs.existsSync(local)) throw new Error(`安装包文件不存在：${local}`);
-    fs.copyFileSync(local, target);
-  }
-  return target;
-}
-
-/** 解压 zip 到 destDir（含 Zip Slip 防护） */
-export function extractZip(zipPath, destDir) {
-  const zip = new AdmZip(zipPath);
-  const resolvedDest = path.resolve(destDir);
-  fs.mkdirSync(resolvedDest, { recursive: true });
-
-  for (const entry of zip.getEntries()) {
-    const targetPath = path.resolve(resolvedDest, entry.entryName);
-    if (targetPath !== resolvedDest && !targetPath.startsWith(resolvedDest + path.sep)) {
-      throw new Error(`压缩包存在非法路径（Zip Slip）：${entry.entryName}`);
-    }
-  }
-  zip.extractAllTo(resolvedDest, true);
-}
-
-export function writeManifest(destDir, meta) {
-  fs.writeFileSync(path.join(destDir, MANIFEST), JSON.stringify(meta, null, 4) + '\n', 'utf-8');
-}
-
-export function readManifest(destDir) {
-  try {
-    return JSON.parse(fs.readFileSync(path.join(destDir, MANIFEST), 'utf-8'));
-  } catch {
-    return null;
-  }
-}
-
-export function removeDirSafe(destDir) {
-  const resolved = path.resolve(destDir);
-  const parsed = path.parse(resolved);
-  if (resolved === parsed.root || resolved === os.homedir()) {
-    throw new Error(`拒绝删除高危目录：${resolved}`);
-  }
-  fs.rmSync(resolved, { recursive: true, force: true });
-}
-
-export function cleanup(tempFile) {
-  try {
-    fs.rmSync(path.dirname(tempFile), { recursive: true, force: true });
-  } catch {
-    /* ignore */
-  }
-}
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import AdmZip from 'adm-zip';
+import { USER_AGENT } from './version.js';
+
+export const MANIFEST = '.dxkj.json';
+
+export async function downloadToTemp(url) {
+  const tmp = path.join(os.tmpdir(), `dxkj-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+  fs.mkdirSync(tmp, { recursive: true });
+  const target = path.join(tmp, 'package.zip');
+
+  if (/^https?:\/\//i.test(url)) {
+    const res = await fetch(url, { headers: { 'User-Agent': USER_AGENT } });
+    if (!res.ok) throw new Error(`下载失败 HTTP ${res.status}：${url}`);
+    await pipeline(res.body, fs.createWriteStream(target));
+  } else {
+    const local = path.resolve(process.cwd(), url);
+    if (!fs.existsSync(local)) throw new Error(`安装包文件不存在：${local}`);
+    fs.copyFileSync(local, target);
+  }
+  return target;
+}
+
+/** 解压 zip 到 destDir（含 Zip Slip 防护） */
+export function extractZip(zipPath, destDir) {
+  const zip = new AdmZip(zipPath);
+  const resolvedDest = path.resolve(destDir);
+  fs.mkdirSync(resolvedDest, { recursive: true });
+
+  for (const entry of zip.getEntries()) {
+    const targetPath = path.resolve(resolvedDest, entry.entryName);
+    if (targetPath !== resolvedDest && !targetPath.startsWith(resolvedDest + path.sep)) {
+      throw new Error(`压缩包存在非法路径（Zip Slip）：${entry.entryName}`);
+    }
+  }
+  zip.extractAllTo(resolvedDest, true);
+}
+
+export function writeManifest(destDir, meta) {
+  fs.writeFileSync(path.join(destDir, MANIFEST), JSON.stringify(meta, null, 4) + '\n', 'utf-8');
+}
+
+export function readManifest(destDir) {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(destDir, MANIFEST), 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+export function removeDirSafe(destDir) {
+  const resolved = path.resolve(destDir);
+  const parsed = path.parse(resolved);
+  if (resolved === parsed.root || resolved === os.homedir()) {
+    throw new Error(`拒绝删除高危目录：${resolved}`);
+  }
+  fs.rmSync(resolved, { recursive: true, force: true });
+}
+
+export function cleanup(tempFile) {
+  try {
+    fs.rmSync(path.dirname(tempFile), { recursive: true, force: true });
+  } catch {
+    /* ignore */
+  }
+}

package/src/lib/registry.js

@@ -1,92 +1,93 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { loadConfig, resolveServerUrl, REGISTRY_PATH } from './config.js';
-
-/** 去除 Windows 写文件常见的 UTF-8 BOM，避免 JSON.parse 失败 */
-export function stripBom(text) {
-  return String(text).replace(/^\uFEFF/, '');
-}
-
-/**
- * 解析数据源。
- * 优先级：--source > DXKJ_REGISTRY > <serverUrl>/api/plugins/ai-catalog/api/registry
- */
-export function resolveSource(opts = {}, cfg = loadConfig()) {
-  if (opts.source) return opts.source;
-  if (process.env.DXKJ_REGISTRY) return process.env.DXKJ_REGISTRY;
-  return resolveServerUrl(opts, cfg) + REGISTRY_PATH;
-}
-
-function normalizeItem(raw, index) {
-  const install = raw.install || {};
-  return {
-    number: raw.number ?? raw.no ?? index + 1,
-    id: raw.id || '',
-    kind: raw.kind || raw.type || 'unknown',
-    name: raw.name || '',
-    category: raw.category || '',
-    description: raw.description || '',
-    intro: raw.intro || '',
-    version: raw.version || '',
-    status: raw.status || 'active',
-    author: raw.author || '',
-    tags: Array.isArray(raw.tags) ? raw.tags : [],
-    images: Array.isArray(raw.images) ? raw.images : [],
-    install: {
-      format: install.format || raw.install_format || 'zip',
-      url: install.url || raw.downloadUrl || raw.package_url || '',
-      entry: install.entry || raw.entry || ''
-    },
-    raw
-  };
-}
-
-/** 从 URL 或本地文件读取注册表 JSON */
-export async function loadRegistry(opts = {}, cfg = loadConfig()) {
-  const source = resolveSource(opts, cfg);
-  let json;
-
-  if (/^https?:\/\//i.test(source)) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), 15000);
-    try {
-      const res = await fetch(source, {
-        signal: controller.signal,
-        headers: { 'User-Agent': 'dxkj-cli/0.1.0', Accept: 'application/json' }
-      });
-      if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      json = await res.json();
-    } catch (err) {
-      throw new Error(
-        `无法读取目录数据源 ${source}\n  ${err.message}\n  提示：站点尚未集成时，可用 --source ./fixtures/sample-registry.json 本地验证`
-      );
-    } finally {
-      clearTimeout(timer);
-    }
-  } else {
-    const file = path.resolve(process.cwd(), source);
-    if (!fs.existsSync(file)) throw new Error(`数据源文件不存在：${file}`);
-    json = JSON.parse(stripBom(fs.readFileSync(file, 'utf-8')));
-  }
-
-  const list = Array.isArray(json) ? json : json.items || json.plugins || [];
-  const items = list.map(normalizeItem);
-  return { source, items, schemaVersion: json.schemaVersion || '1.0', raw: json };
-}
-
-export function filterItems(items, opts = {}) {
-  return items.filter((it) => {
-    if (opts.kind && it.kind !== opts.kind) return false;
-    if (opts.category && !it.category.toLowerCase().includes(String(opts.category).toLowerCase())) return false;
-    if (opts.status && it.status !== opts.status) return false;
-    if (opts.tag && !it.tags.map((t) => String(t).toLowerCase()).includes(String(opts.tag).toLowerCase())) return false;
-    return true;
-  });
-}
-
-/** 按编号或 id 查找 */
-export function findByRef(items, ref) {
-  const r = String(ref).trim();
-  if (/^\d+$/.test(r)) return items.find((it) => String(it.number) === r) || null;
-  return items.find((it) => it.id === r || it.name === r) || null;
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadConfig, resolveServerUrl, REGISTRY_PATH } from './config.js';
+import { USER_AGENT } from './version.js';
+
+/** 去除 Windows 写文件常见的 UTF-8 BOM，避免 JSON.parse 失败 */
+export function stripBom(text) {
+  return String(text).replace(/^\uFEFF/, '');
+}
+
+/**
+ * 解析数据源。
+ * 优先级：--source > DXKJ_REGISTRY > <serverUrl>/api/plugins/ai-catalog/api/registry
+ */
+export function resolveSource(opts = {}, cfg = loadConfig()) {
+  if (opts.source) return opts.source;
+  if (process.env.DXKJ_REGISTRY) return process.env.DXKJ_REGISTRY;
+  return resolveServerUrl(opts, cfg) + REGISTRY_PATH;
+}
+
+function normalizeItem(raw, index) {
+  const install = raw.install || {};
+  return {
+    number: raw.number ?? raw.no ?? index + 1,
+    id: raw.id || '',
+    kind: raw.kind || raw.type || 'unknown',
+    name: raw.name || '',
+    category: raw.category || '',
+    description: raw.description || '',
+    intro: raw.intro || '',
+    version: raw.version || '',
+    status: raw.status || 'active',
+    author: raw.author || '',
+    tags: Array.isArray(raw.tags) ? raw.tags : [],
+    images: Array.isArray(raw.images) ? raw.images : [],
+    install: {
+      format: install.format || raw.install_format || 'zip',
+      url: install.url || raw.downloadUrl || raw.package_url || '',
+      entry: install.entry || raw.entry || ''
+    },
+    raw
+  };
+}
+
+/** 从 URL 或本地文件读取注册表 JSON */
+export async function loadRegistry(opts = {}, cfg = loadConfig()) {
+  const source = resolveSource(opts, cfg);
+  let json;
+
+  if (/^https?:\/\//i.test(source)) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 15000);
+    try {
+      const res = await fetch(source, {
+        signal: controller.signal,
+        headers: { 'User-Agent': USER_AGENT, Accept: 'application/json' }
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      json = await res.json();
+    } catch (err) {
+      throw new Error(
+        `无法读取目录数据源 ${source}\n  ${err.message}\n  提示：站点尚未集成时，可用 --source ./fixtures/sample-registry.json 本地验证`
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+  } else {
+    const file = path.resolve(process.cwd(), source);
+    if (!fs.existsSync(file)) throw new Error(`数据源文件不存在：${file}`);
+    json = JSON.parse(stripBom(fs.readFileSync(file, 'utf-8')));
+  }
+
+  const list = Array.isArray(json) ? json : json.items || json.plugins || [];
+  const items = list.map(normalizeItem);
+  return { source, items, schemaVersion: json.schemaVersion || '1.0', raw: json };
+}
+
+export function filterItems(items, opts = {}) {
+  return items.filter((it) => {
+    if (opts.kind && it.kind !== opts.kind) return false;
+    if (opts.category && !it.category.toLowerCase().includes(String(opts.category).toLowerCase())) return false;
+    if (opts.status && it.status !== opts.status) return false;
+    if (opts.tag && !it.tags.map((t) => String(t).toLowerCase()).includes(String(opts.tag).toLowerCase())) return false;
+    return true;
+  });
+}
+
+/** 按编号或 id 查找 */
+export function findByRef(items, ref) {
+  const r = String(ref).trim();
+  if (/^\d+$/.test(r)) return items.find((it) => String(it.number) === r) || null;
+  return items.find((it) => it.id === r || it.name === r) || null;
+}