openxiangda 1.0.0

package/lib/config.js

@@ -0,0 +1,121 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const CONFIG_DIR = path.join(os.homedir(), '.openxiangda');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'profiles.json');
+const PROJECT_DIR = '.openxiangda';
+const PROJECT_STATE_FILE = path.join(PROJECT_DIR, 'state.json');
+
+function emptyConfig() {
+  return {
+    version: 1,
+    currentProfile: null,
+    profiles: {},
+  };
+}
+
+function ensureUserConfigDir() {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+  try {
+    fs.chmodSync(CONFIG_DIR, 0o700);
+  } catch {
+    // chmod is best-effort on non-POSIX filesystems.
+  }
+}
+
+function readJson(file, fallback) {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return fallback;
+  }
+}
+
+function loadConfig() {
+  ensureUserConfigDir();
+  const config = readJson(CONFIG_FILE, emptyConfig());
+  return {
+    ...emptyConfig(),
+    ...config,
+    profiles: config.profiles || {},
+  };
+}
+
+function saveConfig(config) {
+  ensureUserConfigDir();
+  const normalized = {
+    ...emptyConfig(),
+    ...config,
+    profiles: config.profiles || {},
+  };
+  const tempFile = `${CONFIG_FILE}.${process.pid}.tmp`;
+  fs.writeFileSync(tempFile, `${JSON.stringify(normalized, null, 2)}\n`, {
+    mode: 0o600,
+  });
+  fs.renameSync(tempFile, CONFIG_FILE);
+  try {
+    fs.chmodSync(CONFIG_FILE, 0o600);
+  } catch {
+    // chmod is best-effort on non-POSIX filesystems.
+  }
+}
+
+function normalizeBaseUrl(value) {
+  const raw = String(value || '').trim();
+  if (!raw) throw new Error('平台地址不能为空');
+  const url = new URL(raw);
+  if (!/^https?:$/.test(url.protocol)) {
+    throw new Error('平台地址必须使用 http 或 https');
+  }
+  const cleanPath = url.pathname.replace(/\/+$/, '');
+  if (
+    !cleanPath ||
+    cleanPath === '/platform' ||
+    cleanPath.startsWith('/platform/') ||
+    cleanPath === '/view' ||
+    cleanPath.startsWith('/view/')
+  ) {
+    return `${url.origin}/service`;
+  }
+  return `${url.origin}${cleanPath}`.replace(/\/+$/, '');
+}
+
+function getProfile(config, name) {
+  const profileName = name || config.currentProfile;
+  if (!profileName) {
+    throw new Error('未选择平台 profile，请先执行 openxiangda platform add <name> <url>');
+  }
+  const profile = config.profiles[profileName];
+  if (!profile) {
+    throw new Error(`平台 profile 不存在: ${profileName}`);
+  }
+  return { profileName, profile };
+}
+
+function loadProjectState(cwd = process.cwd()) {
+  return readJson(path.join(cwd, PROJECT_STATE_FILE), {
+    version: 1,
+    profiles: {},
+  });
+}
+
+function saveProjectState(state, cwd = process.cwd()) {
+  const dir = path.join(cwd, PROJECT_DIR);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(
+    path.join(cwd, PROJECT_STATE_FILE),
+    `${JSON.stringify({ version: 1, ...state }, null, 2)}\n`
+  );
+}
+
+module.exports = {
+  CONFIG_FILE,
+  PROJECT_STATE_FILE,
+  getProfile,
+  loadConfig,
+  loadProjectState,
+  normalizeBaseUrl,
+  saveConfig,
+  saveProjectState,
+};

package/lib/http.js

@@ -0,0 +1,47 @@
+const { maskText } = require('./utils');
+
+async function requestJson(baseUrl, apiPath, options = {}) {
+  if (typeof fetch !== 'function') {
+    throw new Error('当前 Node.js 版本不支持 fetch，请使用 Node.js 18 或更高版本');
+  }
+
+  const url = `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+  const headers = {
+    accept: 'application/json',
+    ...(options.headers || {}),
+  };
+  if (options.body !== undefined) {
+    headers['content-type'] = 'application/json';
+  }
+  if (options.accessToken) {
+    headers.authorization = `Bearer ${options.accessToken}`;
+  }
+
+  const response = await fetch(url, {
+    method: options.method || 'GET',
+    headers,
+    body:
+      options.body === undefined ? undefined : JSON.stringify(options.body),
+  });
+
+  const text = await response.text();
+  let payload = null;
+  if (text) {
+    try {
+      payload = JSON.parse(text);
+    } catch {
+      payload = { message: text };
+    }
+  }
+
+  if (!response.ok) {
+    const message = payload?.message || response.statusText || 'request failed';
+    throw new Error(maskText(`HTTP ${response.status}: ${message}`));
+  }
+
+  return payload;
+}
+
+module.exports = {
+  requestJson,
+};

package/lib/skills.js

@@ -0,0 +1,371 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { version: packageVersion } = require('../package.json');
+
+const ROOT_DIR = path.join(__dirname, '..');
+const SOURCE_SKILLS_DIR = path.join(ROOT_DIR, 'openxiangda-skills');
+const SOURCE_REFERENCES_DIR = path.join(SOURCE_SKILLS_DIR, 'references');
+const INSTALL_MANIFEST = '.openxiangda-skill-install.json';
+const MANAGER = 'openxiangda';
+
+const SKILL_SPECS = [
+  {
+    name: 'openxiangda',
+    displayName: 'OpenXiangda',
+    shortDescription: '私有化低代码平台 CLI 与 AI skill 入口。',
+    sourceRelativePath: 'openxiangda-skills',
+    type: 'root',
+  },
+  {
+    name: 'openxiangda-core',
+    displayName: 'OpenXiangda Core',
+    shortDescription: '登录、profile、workspace 绑定与发布上下文。',
+    sourceRelativePath: 'openxiangda-skills/skills/openxiangda-core',
+    type: 'subskill',
+  },
+  {
+    name: 'openxiangda-app',
+    displayName: 'OpenXiangda App',
+    shortDescription: '应用、菜单、快照和资源状态管理。',
+    sourceRelativePath: 'openxiangda-skills/skills/openxiangda-app',
+    type: 'subskill',
+  },
+  {
+    name: 'openxiangda-form',
+    displayName: 'OpenXiangda Form',
+    shortDescription: '表单页和流程表单页开发发布。',
+    sourceRelativePath: 'openxiangda-skills/skills/openxiangda-form',
+    type: 'subskill',
+  },
+  {
+    name: 'openxiangda-page',
+    displayName: 'OpenXiangda Page',
+    shortDescription: '自定义代码页开发、绑定和发布。',
+    sourceRelativePath: 'openxiangda-skills/skills/openxiangda-page',
+    type: 'subskill',
+  },
+  {
+    name: 'openxiangda-workflow-automation',
+    displayName: 'OpenXiangda Workflow Automation',
+    shortDescription: '流程、自动化、触发器和 JS_CODE 节点。',
+    sourceRelativePath: 'openxiangda-skills/skills/openxiangda-workflow-automation',
+    type: 'subskill',
+  },
+  {
+    name: 'openxiangda-permission-settings',
+    displayName: 'OpenXiangda Permission Settings',
+    shortDescription: '角色、权限组、表单设置和公开访问。',
+    sourceRelativePath: 'openxiangda-skills/skills/openxiangda-permission-settings',
+    type: 'subskill',
+  },
+  {
+    name: 'openxiangda-inspect',
+    displayName: 'OpenXiangda Inspect',
+    shortDescription: '只读快照、资源诊断和状态核对。',
+    sourceRelativePath: 'openxiangda-skills/skills/openxiangda-inspect',
+    type: 'subskill',
+  },
+];
+
+function getDefaultCodexSkillsDir(env = process.env) {
+  const codexHome = env.CODEX_HOME || path.join(os.homedir(), '.codex');
+  return path.join(codexHome, 'skills');
+}
+
+function getDefaultClaudeSkillsDir(env = process.env) {
+  const claudeHome = env.CLAUDE_HOME || path.join(os.homedir(), '.claude');
+  return path.join(claudeHome, 'skills');
+}
+
+function getDefaultQoderSkillsDir(env = process.env) {
+  const qoderHome = env.QODER_HOME || path.join(os.homedir(), '.qoder');
+  return path.join(qoderHome, 'skills');
+}
+
+function resolveSkillsDir(dest, env = process.env) {
+  if (!dest) return getDefaultCodexSkillsDir(env);
+  if (typeof dest !== 'string') {
+    throw new Error('缺少 --dest 参数值');
+  }
+  if (dest === '~') return os.homedir();
+  if (dest.startsWith('~/')) return path.join(os.homedir(), dest.slice(2));
+  return path.resolve(dest);
+}
+
+function validateAgent(agent) {
+  const normalized = agent || 'dual';
+  if (normalized !== 'codex' && normalized !== 'claude' && normalized !== 'qoder' && normalized !== 'dual') {
+    throw new Error(`不支持的 skill agent: ${normalized}。支持的选项: codex, claude, qoder, dual`);
+  }
+  return normalized;
+}
+
+function getDualSkillsDirs(agent, env = process.env) {
+  if (agent === 'codex') {
+    return [getDefaultCodexSkillsDir(env)];
+  } else if (agent === 'claude') {
+    return [getDefaultClaudeSkillsDir(env)];
+  } else if (agent === 'qoder') {
+    return [getDefaultQoderSkillsDir(env)];
+  } else if (agent === 'dual') {
+    return [getDefaultCodexSkillsDir(env), getDefaultClaudeSkillsDir(env), getDefaultQoderSkillsDir(env)];
+  }
+  throw new Error(`不支持的 agent: ${agent}`);
+}
+
+function listLegacySkills(skillsDir) {
+  try {
+    return fs
+      .readdirSync(skillsDir, { withFileTypes: true })
+      .filter(entry => entry.isDirectory() && entry.name.startsWith('ai-lowcode-'))
+      .map(entry => entry.name)
+      .sort();
+  } catch {
+    return [];
+  }
+}
+
+function readManifest(targetDir) {
+  try {
+    return JSON.parse(
+      fs.readFileSync(path.join(targetDir, INSTALL_MANIFEST), 'utf8')
+    );
+  } catch {
+    return null;
+  }
+}
+
+function getSkillStatus(spec, skillsDir) {
+  const targetDir = path.join(skillsDir, spec.name);
+  if (!fs.existsSync(targetDir)) {
+    return {
+      name: spec.name,
+      status: 'missing',
+      targetDir,
+      sourceRelativePath: spec.sourceRelativePath,
+    };
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest || manifest.manager !== MANAGER) {
+    return {
+      name: spec.name,
+      status: 'foreign',
+      targetDir,
+      sourceRelativePath: spec.sourceRelativePath,
+    };
+  }
+
+  const isCurrent =
+    manifest.packageVersion === packageVersion &&
+    manifest.sourceRelativePath === spec.sourceRelativePath;
+  return {
+    name: spec.name,
+    status: isCurrent ? 'installed' : 'outdated',
+    targetDir,
+    sourceRelativePath: spec.sourceRelativePath,
+    installedVersion: manifest.packageVersion || null,
+    installedAt: manifest.installedAt || null,
+  };
+}
+
+function getSkillStatusReport(options = {}) {
+  const agent = validateAgent(options.agent);
+  const env = options.env || process.env;
+
+  // 获取目标目录列表
+  const skillsDirs = getDualSkillsDirs(agent, env);
+
+  const results = [];
+  for (const skillsDir of skillsDirs) {
+    const skills = SKILL_SPECS.map(spec => getSkillStatus(spec, skillsDir));
+    results.push({
+      agent,
+      skillsDir,
+      skills,
+    });
+  }
+
+  const legacySkills = listLegacySkills(skillsDirs[0]); // 只取第一个目录的遗留技能
+  const warnings = buildWarnings(legacySkills);
+
+  return {
+    agent,
+    skillsDirs,
+    packageVersion,
+    results,
+    legacySkills,
+    warnings,
+  };
+}
+
+function installSkills(options = {}) {
+  const agent = validateAgent(options.agent);
+  const dryRun = Boolean(options.dryRun);
+  const force = Boolean(options.force);
+
+  // 获取目标目录列表
+  const skillsDirs = getDualSkillsDirs(agent, options.env);
+
+  const results = [];
+  for (const skillsDir of skillsDirs) {
+    const before = SKILL_SPECS.map(spec => getSkillStatus(spec, skillsDir));
+    const conflicts = before.filter(item => item.status === 'foreign');
+
+    if (conflicts.length > 0 && !force && !dryRun) {
+      const names = conflicts.map(item => item.name).join(', ');
+      throw new Error(
+        `目标目录存在非 OpenXiangda 管理的同名 skill: ${names}。如需覆盖请传 --force`
+      );
+    }
+
+    const operations = before.map(item => ({
+      name: item.name,
+      operation: planOperation(item.status, force),
+      targetDir: item.targetDir,
+      sourceRelativePath: item.sourceRelativePath,
+    }));
+
+    if (!dryRun) {
+      fs.mkdirSync(skillsDir, { recursive: true });
+      for (const spec of SKILL_SPECS) {
+        installOneSkill(spec, skillsDir);
+      }
+    }
+
+    const after = dryRun
+      ? before
+      : SKILL_SPECS.map(spec => getSkillStatus(spec, skillsDir));
+
+    results.push({
+      agent,
+      skillsDir,
+      packageVersion,
+      dryRun,
+      force,
+      operations,
+      skills: after,
+    });
+  }
+
+  const legacySkills = listLegacySkills(skillsDirs[0]); // 只取第一个目录的遗留技能
+  const warnings = buildWarnings(legacySkills);
+
+  return {
+    agent,
+    skillsDirs,
+    packageVersion,
+    dryRun,
+    force,
+    results,
+    legacySkills,
+    warnings,
+    message: dryRun
+      ? 'dry-run completed; no files were changed'
+      : agent === 'dual'
+        ? 'OpenXiangda skills installed to Claude, Codex, and Qoder. Restart all to pick up new skills.'
+        : `OpenXiangda skills installed to ${agent}. Restart ${agent} to pick up new skills.`,
+  };
+}
+
+function planOperation(status, force) {
+  if (status === 'missing') return 'install';
+  if (status === 'foreign') return force ? 'overwrite-foreign' : 'blocked';
+  if (status === 'outdated') return 'update';
+  return 'refresh';
+}
+
+function installOneSkill(spec, skillsDir) {
+  const targetDir = path.join(skillsDir, spec.name);
+  const stagingDir = path.join(
+    skillsDir,
+    `.openxiangda-${spec.name}-${process.pid}-${Date.now()}.tmp`
+  );
+
+  fs.rmSync(stagingDir, { recursive: true, force: true });
+  try {
+    if (spec.type === 'root') {
+      copyRootSkill(stagingDir);
+    } else {
+      copySubskill(spec, stagingDir);
+    }
+    writeAgentMetadata(spec, stagingDir);
+    writeInstallManifest(spec, stagingDir);
+
+    fs.rmSync(targetDir, { recursive: true, force: true });
+    fs.renameSync(stagingDir, targetDir);
+  } catch (error) {
+    fs.rmSync(stagingDir, { recursive: true, force: true });
+    throw error;
+  }
+}
+
+function copyRootSkill(stagingDir) {
+  fs.cpSync(SOURCE_SKILLS_DIR, stagingDir, {
+    recursive: true,
+    dereference: false,
+  });
+}
+
+function copySubskill(spec, stagingDir) {
+  const sourceDir = path.join(ROOT_DIR, spec.sourceRelativePath);
+  fs.mkdirSync(stagingDir, { recursive: true });
+  const skillMarkdown = fs
+    .readFileSync(path.join(sourceDir, 'SKILL.md'), 'utf8')
+    .replace(/\.\.\/\.\.\/references\//g, 'references/');
+  fs.writeFileSync(path.join(stagingDir, 'SKILL.md'), skillMarkdown);
+  fs.cpSync(SOURCE_REFERENCES_DIR, path.join(stagingDir, 'references'), {
+    recursive: true,
+    dereference: false,
+  });
+}
+
+function writeAgentMetadata(spec, skillDir) {
+  const agentsDir = path.join(skillDir, 'agents');
+  fs.mkdirSync(agentsDir, { recursive: true });
+  const defaultPrompt =
+    spec.name === 'openxiangda'
+      ? '使用 $openxiangda 处理私有化低代码平台的登录、发布和诊断任务。'
+      : `使用 $${spec.name} 处理对应的 OpenXiangda 低代码平台任务。`;
+  const content = [
+    'interface:',
+    `  display_name: ${yamlQuote(spec.displayName)}`,
+    `  short_description: ${yamlQuote(spec.shortDescription)}`,
+    `  default_prompt: ${yamlQuote(defaultPrompt)}`,
+    '',
+  ].join('\n');
+  fs.writeFileSync(path.join(agentsDir, 'openai.yaml'), content);
+}
+
+function writeInstallManifest(spec, skillDir) {
+  const manifest = {
+    manager: MANAGER,
+    packageVersion,
+    sourceRelativePath: spec.sourceRelativePath,
+    installedAt: new Date().toISOString(),
+  };
+  fs.writeFileSync(
+    path.join(skillDir, INSTALL_MANIFEST),
+    `${JSON.stringify(manifest, null, 2)}\n`
+  );
+}
+
+function yamlQuote(value) {
+  return JSON.stringify(String(value));
+}
+
+function buildWarnings(legacySkills) {
+  if (legacySkills.length === 0) return [];
+  return [
+    `检测到旧 ai-lowcode skills: ${legacySkills.join(', ')}。OpenXiangda 不会自动删除它们，请按需手动清理以避免混用。`,
+  ];
+}
+
+module.exports = {
+  INSTALL_MANIFEST,
+  SKILL_SPECS,
+  getSkillStatusReport,
+  installSkills,
+  resolveSkillsDir,
+};

package/lib/utils.js

@@ -0,0 +1,87 @@
+const { spawn } = require('child_process');
+const os = require('os');
+
+function maskText(value) {
+  return String(value || '')
+    .replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/g, '***token***')
+    .replace(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/gi, match => {
+      const [name, domain] = match.split('@');
+      return `${name.slice(0, 2)}***@${domain}`;
+    })
+    .replace(/\b1[3-9]\d{9}\b/g, match => `${match.slice(0, 3)}****${match.slice(-4)}`);
+}
+
+function print(value) {
+  console.log(maskText(value));
+}
+
+function warn(value) {
+  console.warn(maskText(value));
+}
+
+function fail(value) {
+  throw new Error(maskText(value));
+}
+
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const item = argv[index];
+    if (!item.startsWith('--')) {
+      positional.push(item);
+      continue;
+    }
+
+    const eqIndex = item.indexOf('=');
+    if (eqIndex > 0) {
+      flags[item.slice(2, eqIndex)] = item.slice(eqIndex + 1);
+      continue;
+    }
+
+    const key = item.slice(2);
+    const next = argv[index + 1];
+    if (next && !next.startsWith('--')) {
+      flags[key] = next;
+      index += 1;
+    } else {
+      flags[key] = true;
+    }
+  }
+  return { flags, positional };
+}
+
+function openBrowser(url) {
+  const platform = os.platform();
+  const command =
+    platform === 'darwin'
+      ? 'open'
+      : platform === 'win32'
+        ? 'cmd'
+        : 'xdg-open';
+  const args = platform === 'win32' ? ['/c', 'start', '', url] : [url];
+  const child = spawn(command, args, {
+    detached: true,
+    stdio: 'ignore',
+  });
+  child.unref();
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+function writeJson(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+
+module.exports = {
+  fail,
+  maskText,
+  openBrowser,
+  parseArgs,
+  print,
+  sleep,
+  warn,
+  writeJson,
+};