march-control-cli 0.1.3

package/README.md

@@ -0,0 +1,220 @@
+# March Control
+
+`march` is a provider configuration manager for:
+
+- Codex
+- OpenCode
+- OpenClaw
+
+It provides both:
+
+- CLI (`march` / `mch`)
+- Desktop/web workspace in this repo (`src/`, `desktop/`, `src-tauri/`)
+
+## CLI Features
+
+- One-shot setup: write provider configs to multiple tools
+- Provider lifecycle commands per platform:
+  - `add`
+  - `list`
+  - `current`
+  - `use`
+  - `edit`
+  - `clone`
+  - `remove`
+- Preset management:
+  - `preset list`
+  - `preset add`
+  - `preset use`
+  - `preset remove`
+- URL probe before apply
+- Safe backup/rollback before writing config files
+
+## Install
+
+```bash
+npm install -g march-control-cli
+```
+
+Install now includes:
+
+- Chinese postinstall banner with quick-start commands
+- Branded setup flow with step-by-step output (`[1/4] ... [4/4]`)
+- Dual command entrypoints: `march` and `mch`
+
+## Quick Start
+
+Interactive quick setup:
+
+```bash
+march
+```
+
+Non-interactive setup:
+
+```bash
+march setup -k sk-your-key
+
+# Setup using a preset
+march setup --preset march -k sk-your-key
+```
+
+Open full interactive menu:
+
+```bash
+march menu
+
+# same command alias
+mch menu
+```
+
+## Command Examples
+
+```bash
+# Codex
+march cx list
+march cx current
+march cx add -n march -u https://gmncode.cn -k sk-xxx --model gpt-5.4
+march cx use march
+march cx edit march --model gpt-5.3-codex
+march cx clone march -n march-backup
+march cx remove march-backup
+
+# OpenCode / OpenClaw
+march oc list
+march ow list
+
+# Presets
+march preset list
+march preset add -n team-a --provider-name teama --base-url https://example.com
+march preset use team-a -k sk-xxx -p codex,opencode
+march preset remove team-a
+```
+
+Probe endpoints:
+
+```bash
+march probe -u https://gmncode.cn -u https://gmncode.cn/v1
+```
+
+## Local Development
+
+Run CLI directly from source:
+
+```bash
+npm run start
+```
+
+Syntax check CLI core:
+
+```bash
+npm run check
+```
+
+Type check frontend:
+
+```bash
+npm run typecheck
+```
+
+Run frontend dev server:
+
+```bash
+npm run dev
+```
+
+Default dev URL:
+
+```text
+http://127.0.0.1:3001
+```
+
+Build frontend:
+
+```bash
+npm run build:web
+```
+
+## 本地验证（CLI 体验）
+
+```bash
+# 1) 基础检查
+npm run check
+npm run desktop:check
+
+# 2) 查看安装后欢迎页（本地模拟）
+node scripts/postinstall.mjs
+
+# 3) 验证中文帮助
+node core/index.js --help
+node core/index.js preset --help
+node core/index.js cx --help
+```
+
+隔离目录实测（不污染当前用户目录）：
+
+```bash
+$env:MARCH_HOME="C:\\tmp\\march-smoke"
+node core/index.js setup --preset march -k sk-demo-1234 --platforms codex,opencode --no-probe --no-backup
+```
+
+## 客户安装模拟
+
+```bash
+# 在项目目录打包
+npm pack
+
+# 卸载旧版本（可选）
+npm uninstall -g march-control-cli
+
+# 安装你刚打出来的 tgz 包（把版本号替换成当前文件名）
+npm install -g .\\march-control-cli-0.1.3.tgz
+
+# 客户侧常用验证命令
+march --help
+mch --help
+march
+march setup --preset march -k sk-demo-1234 --platforms codex --no-probe
+```
+
+## Desktop
+
+Run desktop shell:
+
+```bash
+npm run desktop:dev
+```
+
+If Electron runtime is missing:
+
+```bash
+npm run desktop:install-runtime
+```
+
+Check desktop entry files:
+
+```bash
+npm run desktop:check
+```
+
+Build Windows packages:
+
+```bash
+npm run desktop:pack
+```
+
+## ccman Parity Roadmap
+
+Current parity focus completed:
+
+- Provider lifecycle parity (`edit/remove/clone`)
+- Scriptable non-interactive commands
+- Interactive menu aligned with lifecycle actions
+- Preset manager (`preset list/add/use/remove`)
+
+Next suggested parity items:
+
+1. Import/export command set
+2. MCP profile manager for Codex/OpenClaw ecosystem
+3. Optional WebDAV sync module for shared config state
+4. Desktop preset CRUD + one-click preset apply

package/core/apply.js

@@ -0,0 +1,152 @@
+import { createPlatformBackup, restorePlatformBackup } from "./backup.js";
+import { getPlatformTargetFiles } from "./paths.js";
+import {
+  cloneProvider,
+  getCurrentProvider,
+  removeProvider,
+  resolveStoredProvider,
+  switchProvider,
+  updateProvider,
+  upsertProvider
+} from "./store.js";
+import { writePlatformConfig } from "./writers/index.js";
+
+export function applyProvider(platform, providerInput, options = {}) {
+  const backup = options.backup === false ? null : createPlatformBackup(platform);
+
+  try {
+    const provider = upsertProvider(platform, providerInput, { activate: options.activate !== false });
+    writePlatformConfig(platform, provider, {
+      mode: options.overwrite ? "overwrite" : "merge"
+    });
+
+    return {
+      provider,
+      backupDir: backup?.backupDir || null,
+      targetFiles: getPlatformTargetFiles(platform)
+    };
+  } catch (error) {
+    if (backup) {
+      restorePlatformBackup(backup);
+    }
+
+    throw error;
+  }
+}
+
+export function applyStoredProvider(platform, nameOrId, options = {}) {
+  const backup = options.backup === false ? null : createPlatformBackup(platform);
+
+  try {
+    const provider = resolveStoredProvider(platform, nameOrId);
+    if (options.activate !== false) {
+      switchProvider(platform, nameOrId);
+    }
+
+    const current = getCurrentProvider(platform) || provider;
+    writePlatformConfig(platform, current, {
+      mode: options.overwrite ? "overwrite" : "merge"
+    });
+
+    return {
+      provider: current,
+      backupDir: backup?.backupDir || null,
+      targetFiles: getPlatformTargetFiles(platform)
+    };
+  } catch (error) {
+    if (backup) {
+      restorePlatformBackup(backup);
+    }
+
+    throw error;
+  }
+}
+
+export function applyEditedProvider(platform, nameOrId, updates, options = {}) {
+  const backup = options.backup === false ? null : createPlatformBackup(platform);
+
+  try {
+    const provider = updateProvider(platform, nameOrId, updates, {
+      activate: options.activate === true
+    });
+    const current = getCurrentProvider(platform);
+
+    if (current) {
+      writePlatformConfig(platform, current, {
+        mode: options.overwrite ? "overwrite" : "merge"
+      });
+    }
+
+    return {
+      provider,
+      activeProvider: current,
+      backupDir: backup?.backupDir || null,
+      targetFiles: getPlatformTargetFiles(platform)
+    };
+  } catch (error) {
+    if (backup) {
+      restorePlatformBackup(backup);
+    }
+
+    throw error;
+  }
+}
+
+export function applyClonedProvider(platform, nameOrId, input, options = {}) {
+  const backup = options.backup === false ? null : createPlatformBackup(platform);
+
+  try {
+    const provider = cloneProvider(platform, nameOrId, input, {
+      activate: options.activate === true
+    });
+    const current = getCurrentProvider(platform);
+
+    if (current) {
+      writePlatformConfig(platform, current, {
+        mode: options.overwrite ? "overwrite" : "merge"
+      });
+    }
+
+    return {
+      provider,
+      activeProvider: current,
+      backupDir: backup?.backupDir || null,
+      targetFiles: getPlatformTargetFiles(platform)
+    };
+  } catch (error) {
+    if (backup) {
+      restorePlatformBackup(backup);
+    }
+
+    throw error;
+  }
+}
+
+export function applyRemovedProvider(platform, nameOrId, options = {}) {
+  const backup = options.backup === false ? null : createPlatformBackup(platform);
+
+  try {
+    const result = removeProvider(platform, nameOrId, {
+      activateFallback: options.activateFallback !== false
+    });
+
+    if (result.currentProvider) {
+      writePlatformConfig(platform, result.currentProvider, {
+        mode: options.overwrite ? "overwrite" : "merge"
+      });
+    }
+
+    return {
+      removedProvider: result.removedProvider,
+      activeProvider: result.currentProvider,
+      backupDir: backup?.backupDir || null,
+      targetFiles: getPlatformTargetFiles(platform)
+    };
+  } catch (error) {
+    if (backup) {
+      restorePlatformBackup(backup);
+    }
+
+    throw error;
+  }
+}

package/core/backup.js

@@ -0,0 +1,53 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getBackupDirRoot, getPlatformTargetFiles } from "./paths.js";
+import { ensureDir, writeJson } from "./utils.js";
+
+export function createPlatformBackup(platform) {
+  const backupDir = path.join(
+    getBackupDirRoot(),
+    `${platform}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
+  );
+
+  ensureDir(backupDir);
+
+  const entries = getPlatformTargetFiles(platform).map((originalPath, index) => {
+    if (!fs.existsSync(originalPath)) {
+      return { originalPath, backupPath: null, existed: false };
+    }
+
+    const backupPath = path.join(
+      backupDir,
+      `${String(index).padStart(2, "0")}-${path.basename(originalPath).replace(/[^\w.-]/g, "_")}.bak`
+    );
+
+    fs.copyFileSync(originalPath, backupPath);
+    return { originalPath, backupPath, existed: true };
+  });
+
+  writeJson(path.join(backupDir, "manifest.json"), {
+    platform,
+    createdAt: new Date().toISOString(),
+    entries
+  });
+
+  return { backupDir, entries };
+}
+
+export function restorePlatformBackup(result) {
+  for (const entry of result.entries) {
+    if (entry.existed) {
+      if (!entry.backupPath || !fs.existsSync(entry.backupPath)) {
+        throw new Error(`Missing backup file: ${entry.backupPath || entry.originalPath}`);
+      }
+
+      ensureDir(path.dirname(entry.originalPath));
+      fs.copyFileSync(entry.backupPath, entry.originalPath);
+      continue;
+    }
+
+    if (fs.existsSync(entry.originalPath)) {
+      fs.rmSync(entry.originalPath, { force: true });
+    }
+  }
+}

package/core/constants.js

@@ -0,0 +1,55 @@
+export const APP_NAME = "march";
+export const DEFAULT_PROVIDER_NAME = "march";
+export const DEFAULT_BASE_URL = "https://gmncode.cn";
+export const DEFAULT_OPENCLAW_BASE_URL = "https://gmncode.cn/v1";
+export const DEFAULT_PRIMARY_MODEL = "gpt-5.4";
+
+export const PLATFORM_META = {
+  codex: {
+    label: "Codex",
+    command: "cx",
+    defaultBaseUrl: DEFAULT_BASE_URL
+  },
+  opencode: {
+    label: "OpenCode",
+    command: "oc",
+    defaultBaseUrl: DEFAULT_BASE_URL
+  },
+  openclaw: {
+    label: "OpenClaw",
+    command: "ow",
+    defaultBaseUrl: DEFAULT_OPENCLAW_BASE_URL
+  }
+};
+
+export const SUPPORTED_PLATFORMS = Object.keys(PLATFORM_META);
+export const DEFAULT_PLATFORM_SELECTION = [...SUPPORTED_PLATFORMS];
+export const DEFAULT_CANDIDATE_BASE_URLS = [DEFAULT_BASE_URL];
+
+export const BUILTIN_PRESETS = [
+  {
+    name: "march",
+    providerName: "march",
+    commonBaseUrl: "https://gmncode.cn",
+    openclawBaseUrl: "https://gmncode.cn/v1",
+    model: DEFAULT_PRIMARY_MODEL
+  },
+  {
+    name: "openai",
+    providerName: "openai",
+    commonBaseUrl: "https://api.openai.com/v1",
+    openclawBaseUrl: "https://api.openai.com/v1",
+    model: DEFAULT_PRIMARY_MODEL
+  }
+];
+
+export const MODEL_DEFINITIONS = [
+  { id: "gpt-5.4", reasoning: true, contextWindow: 1050000, maxTokens: 128000 },
+  { id: "gpt-5.3-codex", reasoning: false, contextWindow: 400000, maxTokens: 128000 },
+  { id: "gpt-5.2", reasoning: true, contextWindow: 1050000, maxTokens: 128000 },
+  { id: "gpt-5.2-codex", reasoning: false, contextWindow: 400000, maxTokens: 128000 },
+  { id: "gpt-5.1", reasoning: true, contextWindow: 1050000, maxTokens: 128000 },
+  { id: "gpt-5.1-codex", reasoning: false, contextWindow: 400000, maxTokens: 128000 },
+  { id: "gpt-5.1-codex-mini", reasoning: false, contextWindow: 400000, maxTokens: 128000 },
+  { id: "gpt-5.1-codex-max", reasoning: false, contextWindow: 400000, maxTokens: 128000 }
+];

package/core/desktop-service.js

@@ -0,0 +1,219 @@
+import { applyProvider, applyStoredProvider } from "./apply.js";
+import {
+  DEFAULT_BASE_URL,
+  DEFAULT_OPENCLAW_BASE_URL,
+  DEFAULT_PRIMARY_MODEL,
+  DEFAULT_PROVIDER_NAME,
+  MODEL_DEFINITIONS,
+  PLATFORM_META,
+  SUPPORTED_PLATFORMS
+} from "./constants.js";
+import {
+  deleteMcpServerFromDesktop as deleteMcpInState,
+  deletePromptFromDesktop as deletePromptInState,
+  deleteSkillFromDesktop as deleteSkillInState,
+  getDesktopState,
+  toggleMcpServerForPlatform,
+  togglePromptFromDesktop as togglePromptInState,
+  toggleSkillRepoFromDesktop as toggleSkillRepoInState,
+  upsertMcpServerFromDesktop as upsertMcpInState,
+  upsertPromptFromDesktop as upsertPromptInState,
+  upsertSkillFromDesktop as upsertSkillInState
+} from "./desktop-state.js";
+import { getPlatformTargetFiles } from "./paths.js";
+import { getBestProbeResult, probeBaseUrls } from "./probe.js";
+import { getCurrentProvider, listProviders } from "./store.js";
+import { buildOpenClawBaseUrl, maskApiKey, normalizeBaseUrl } from "./utils.js";
+
+function serializeProvider(provider, currentProviderId) {
+  return {
+    id: provider.id,
+    name: provider.name,
+    baseUrl: provider.baseUrl,
+    model: provider.model || DEFAULT_PRIMARY_MODEL,
+    maskedApiKey: maskApiKey(provider.apiKey),
+    createdAt: provider.createdAt || null,
+    updatedAt: provider.updatedAt || null,
+    isActive: provider.id === currentProviderId
+  };
+}
+
+function buildPlatformSnapshot(platform) {
+  const providers = listProviders(platform);
+  const currentProvider = getCurrentProvider(platform);
+
+  return {
+    id: platform,
+    label: PLATFORM_META[platform].label,
+    command: PLATFORM_META[platform].command,
+    defaultBaseUrl: platform === "openclaw" ? DEFAULT_OPENCLAW_BASE_URL : DEFAULT_BASE_URL,
+    defaultProviderName: DEFAULT_PROVIDER_NAME,
+    currentProviderId: currentProvider?.id || null,
+    currentProviderName: currentProvider?.name || null,
+    providerCount: providers.length,
+    targetFiles: getPlatformTargetFiles(platform),
+    providers: providers.map((provider) => serializeProvider(provider, currentProvider?.id || null))
+  };
+}
+
+function validatePlatform(platform) {
+  if (!SUPPORTED_PLATFORMS.includes(platform)) {
+    throw new Error(`Unsupported platform: ${platform}`);
+  }
+}
+
+function buildInputForPlatform(platform, input) {
+  const name = `${input?.name || DEFAULT_PROVIDER_NAME}`.trim() || DEFAULT_PROVIDER_NAME;
+  const apiKey = `${input?.apiKey || ""}`.trim();
+  const fallbackBaseUrl = platform === "openclaw" ? DEFAULT_OPENCLAW_BASE_URL : DEFAULT_BASE_URL;
+  const baseUrl = normalizeBaseUrl(`${input?.baseUrl || fallbackBaseUrl}`.trim());
+  const model = `${input?.model || DEFAULT_PRIMARY_MODEL}`.trim() || DEFAULT_PRIMARY_MODEL;
+
+  if (!apiKey) {
+    throw new Error("API Key 不能为空");
+  }
+
+  return {
+    name,
+    apiKey,
+    baseUrl,
+    model
+  };
+}
+
+export function getDesktopSnapshot() {
+  const desktopState = getDesktopState();
+
+  return {
+    appName: "March 控制台",
+    version: "0.3.0-alpha",
+    generatedAt: new Date().toISOString(),
+    models: MODEL_DEFINITIONS,
+    platforms: SUPPORTED_PLATFORMS.map((platform) => buildPlatformSnapshot(platform)),
+    mcpServers: desktopState.mcpServers,
+    prompts: desktopState.prompts,
+    skills: desktopState.skills,
+    skillRepos: desktopState.skillRepos
+  };
+}
+
+export function saveProviderFromDesktop(platform, input, options = {}) {
+  validatePlatform(platform);
+  const providerInput = buildInputForPlatform(platform, input);
+  const result = applyProvider(platform, providerInput, {
+    backup: options.backup !== false,
+    overwrite: options.overwrite === true,
+    activate: options.activate !== false
+  });
+
+  return {
+    snapshot: buildPlatformSnapshot(platform),
+    result: {
+      backupDir: result.backupDir,
+      targetFiles: result.targetFiles
+    }
+  };
+}
+
+export function activateProviderFromDesktop(platform, nameOrId, options = {}) {
+  validatePlatform(platform);
+  const result = applyStoredProvider(platform, nameOrId, {
+    backup: options.backup !== false,
+    overwrite: options.overwrite === true,
+    activate: true
+  });
+
+  return {
+    snapshot: buildPlatformSnapshot(platform),
+    result: {
+      backupDir: result.backupDir,
+      targetFiles: result.targetFiles
+    }
+  };
+}
+
+export function toggleMcpFromDesktop(serverId, platform) {
+  validatePlatform(platform);
+  toggleMcpServerForPlatform(serverId, platform);
+  return getDesktopSnapshot();
+}
+
+export function upsertMcpFromDesktop(input) {
+  upsertMcpInState(input);
+  return getDesktopSnapshot();
+}
+
+export function deleteMcpFromDesktop(serverId) {
+  deleteMcpInState(serverId);
+  return getDesktopSnapshot();
+}
+
+export function togglePromptFromDesktop(promptId) {
+  togglePromptInState(promptId);
+  return getDesktopSnapshot();
+}
+
+export function upsertPromptFromDesktop(input) {
+  upsertPromptInState(input);
+  return getDesktopSnapshot();
+}
+
+export function deletePromptFromDesktop(promptId) {
+  deletePromptInState(promptId);
+  return getDesktopSnapshot();
+}
+
+export function upsertSkillFromDesktop(input) {
+  upsertSkillInState(input);
+  return getDesktopSnapshot();
+}
+
+export function deleteSkillFromDesktop(skillId) {
+  deleteSkillInState(skillId);
+  return getDesktopSnapshot();
+}
+
+export function toggleSkillRepoFromDesktop(repoId) {
+  toggleSkillRepoInState(repoId);
+  return getDesktopSnapshot();
+}
+
+export async function probePlatformProvidersFromDesktop(platform) {
+  validatePlatform(platform);
+  const snapshot = buildPlatformSnapshot(platform);
+  const providerUrls = snapshot.providers.map((provider) => provider.baseUrl);
+
+  if (providerUrls.length === 0) {
+    return {
+      snapshot,
+      results: [],
+      best: null
+    };
+  }
+
+  const results = await probeBaseUrls(providerUrls, { timeoutMs: 5000 });
+  return {
+    snapshot,
+    results,
+    best: getBestProbeResult(results)
+  };
+}
+
+export async function probeCandidateFromDesktop(platform, baseUrl) {
+  validatePlatform(platform);
+  const normalizedBaseUrl = normalizeBaseUrl(`${baseUrl || ""}`.trim());
+
+  if (!normalizedBaseUrl) {
+    throw new Error("测试地址不能为空");
+  }
+
+  const finalUrl =
+    platform === "openclaw" && !normalizedBaseUrl.endsWith("/v1")
+      ? buildOpenClawBaseUrl(normalizedBaseUrl)
+      : normalizedBaseUrl;
+  const results = await probeBaseUrls([finalUrl], { timeoutMs: 5000 });
+
+  return {
+    result: results[0] || null
+  };
+}