galaxy-opc 0.3.9 → 0.4.0

package/bin/cli.mjs

@@ -5,6 +5,7 @@
  *   npx galaxy-opc          # 安装并初始化（首次使用）
  *   npx galaxy-opc setup    # 重新配置 AI 模型
  *   npx galaxy-opc start    # 启动服务
+ *   npx galaxy-opc doctor   # 诊断安装状态
  */
 
 import fs from "node:fs";
@@ -137,6 +138,8 @@ if (command === "start") {
   await cmdStart();
 } else if (command === "setup") {
   await cmdSetup();
+} else if (command === "doctor") {
+  await cmdDoctor();
 } else {
   await cmdInstall();
 }
@@ -249,6 +252,19 @@ ${bold(cyan("  ╚════════════════════
     await installPlugin();
   }
 
+  // ── 安装后自检 ────────────────────────────────────────────────────────
+  const checks = verifyInstall();
+  const failures = checks.filter((c) => !c.ok && c.check !== "AI 模型" && c.check !== "Gateway Token");
+  if (failures.length > 0) {
+    separator();
+    console.log(yellow("\n  安装自检发现问题:"));
+    for (const f of failures) {
+      console.log(`  ${red("✗")} ${f.check}: ${f.msg}`);
+      if (f.fix) console.log(`    ${gray("修复: " + f.fix)}`);
+    }
+    console.log(gray("\n  可运行 npx galaxy-opc doctor 查看完整诊断\n"));
+  }
+
   // ── 步骤 4：配置模型 ────────────────────────────────────────────────────
   await cmdSetup();
 }
@@ -483,6 +499,128 @@ async function cmdSetup() {
   separator("═");
 }
 
+// ─── 安装后自检 ──────────────────────────────────────────────────────────────
+function verifyInstall() {
+  const issues = [];
+
+  // 检查 openclaw 命令
+  const ocVer = getOpenclawVersion();
+  if (!ocVer) {
+    issues.push({
+      check: "OpenClaw 命令",
+      ok: false,
+      msg: "openclaw 命令不可用",
+      fix: "npm install -g openclaw@latest --registry https://registry.npmmirror.com",
+    });
+  } else {
+    issues.push({ check: "OpenClaw 命令", ok: true, msg: `已安装 (${ocVer})` });
+  }
+
+  // 检查插件目录
+  const pluginDir = path.join(STATE_DIR, "extensions", "galaxy-opc-plugin");
+  const pluginEntry = path.join(pluginDir, "index.ts");
+  if (fs.existsSync(pluginEntry)) {
+    issues.push({ check: "OPC 插件", ok: true, msg: pluginDir });
+  } else {
+    issues.push({
+      check: "OPC 插件",
+      ok: false,
+      msg: "插件目录不存在或缺少入口文件",
+      fix: "openclaw plugins install galaxy-opc-plugin",
+    });
+  }
+
+  // 检查配置文件
+  if (fs.existsSync(CONFIG_PATH)) {
+    const cfg = readJson(CONFIG_PATH);
+    issues.push({ check: "配置文件", ok: true, msg: CONFIG_PATH });
+
+    // 检查模型配置
+    const model = cfg.agents?.defaults?.model?.primary;
+    if (model) {
+      issues.push({ check: "AI 模型", ok: true, msg: model });
+    } else {
+      issues.push({
+        check: "AI 模型",
+        ok: false,
+        msg: "未配置默认模型",
+        fix: "npx galaxy-opc setup",
+      });
+    }
+
+    // 检查 gateway token
+    const token = cfg.gateway?.auth?.token;
+    if (token && token !== "change-me-to-a-long-random-token") {
+      issues.push({ check: "Gateway Token", ok: true, msg: "已配置" });
+    } else {
+      issues.push({
+        check: "Gateway Token",
+        ok: false,
+        msg: "未配置访问令牌",
+        fix: "npx galaxy-opc setup",
+      });
+    }
+  } else {
+    issues.push({
+      check: "配置文件",
+      ok: false,
+      msg: "openclaw.json 不存在",
+      fix: "npx galaxy-opc setup",
+    });
+  }
+
+  // 检查数据库目录可写
+  const dbDir = path.join(STATE_DIR, "opc-platform");
+  if (fs.existsSync(dbDir)) {
+    issues.push({ check: "数据库目录", ok: true, msg: dbDir });
+  } else {
+    // 尝试创建
+    try {
+      fs.mkdirSync(dbDir, { recursive: true });
+      issues.push({ check: "数据库目录", ok: true, msg: `已创建 ${dbDir}` });
+    } catch {
+      issues.push({
+        check: "数据库目录",
+        ok: false,
+        msg: "无法创建数据库目录",
+        fix: `mkdir -p ${dbDir}`,
+      });
+    }
+  }
+
+  return issues;
+}
+
+// ─── doctor 命令 ──────────────────────────────────────────────────────────────
+async function cmdDoctor() {
+  console.log(`\n${bold(cyan("  Galaxy OPC — 安装诊断"))}\n`);
+  separator();
+
+  const issues = verifyInstall();
+  let hasError = false;
+
+  for (const item of issues) {
+    if (item.ok) {
+      console.log(`  ${green("✓")} ${bold(item.check)}: ${item.msg}`);
+    } else {
+      hasError = true;
+      console.log(`  ${red("✗")} ${bold(item.check)}: ${item.msg}`);
+      if (item.fix) {
+        console.log(`    ${gray("修复: " + item.fix)}`);
+      }
+    }
+  }
+
+  separator();
+  if (hasError) {
+    console.log(`\n  ${yellow("存在问题，请按上述提示修复。")}\n`);
+    process.exit(1);
+  } else {
+    console.log(`\n  ${green("所有检查通过，系统就绪！")}`);
+    console.log(`  ${dim("启动命令: openclaw gateway")}\n`);
+  }
+}
+
 // ─── start 命令 ──────────────────────────────────────────────────────────────
 async function cmdStart() {
   const ocVersion = getOpenclawVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "galaxy-opc",
-  "version": "0.3.9",
+  "version": "0.4.0",
   "description": "星环 Galaxy OPC — 一人公司孵化与赋能平台 AI 员工系统",
   "keywords": [
     "ai",