@vobs/cli 1.7.5 → 1.7.7

package/dist/cli.cjs

@@ -102,13 +102,13 @@ function ensureDir(dir) {
 __name(ensureDir, "ensureDir");
 async function copyDirRecursive(srcDir, destDir, context) {
   const { readdirSync } = await import("fs");
-  const { join } = await import("path");
+  const { join: join2 } = await import("path");
   const entries = readdirSync(srcDir, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = join(srcDir, entry.name);
+    const srcPath = join2(srcDir, entry.name);
     const isHbs = entry.name.endsWith(".hbs");
     const destName = isHbs ? entry.name.slice(0, -4) : entry.name;
-    const destPath = join(destDir, destName);
+    const destPath = join2(destDir, destName);
     if (entry.isDirectory()) {
       ensureDir(destPath);
       await copyDirRecursive(srcPath, destPath, context);
@@ -122,8 +122,11 @@ async function copyDirRecursive(srcDir, destDir, context) {
   }
 }
 __name(copyDirRecursive, "copyDirRecursive");
-async function scaffoldProject(targetDir, context) {
-  const templateDir = (0, import_node_path.resolve)(TEMPLATES_ROOT, "basic");
+async function scaffoldProject(targetDir, context, template = "basic") {
+  const templateDir = (0, import_node_path.resolve)(TEMPLATES_ROOT, template);
+  if (!(0, import_node_fs.existsSync)(templateDir)) {
+    throw new Error(`\u6A21\u677F\u4E0D\u5B58\u5728: ${template}\uFF08\u53EF\u7528\u6A21\u677F\u89C1 ${TEMPLATES_ROOT}\uFF09`);
+  }
   ensureDir(targetDir);
   await copyDirRecursive(templateDir, targetDir, context);
 }
@@ -354,6 +357,535 @@ async function addCommand(options) {
 }
 __name(addCommand, "addCommand");
 
+// packages/cli/src/commands/dsh.ts
+var import_node_fs3 = require("fs");
+var import_promises = require("fs/promises");
+var import_node_child_process3 = require("child_process");
+var import_node_http = require("http");
+var import_node_module = require("module");
+var import_node_path5 = require("path");
+var p4 = __toESM(require("@clack/prompts"), 1);
+var PLATFORM_MODULES = ["react", "react-dom"];
+var vobsVersion = /* @__PURE__ */ __name(() => {
+  try {
+    const manifest = JSON.parse(
+      (0, import_node_fs3.readFileSync)(new URL("../../package.json", __VOBS_CJS_FILE_URL), "utf8")
+    );
+    return manifest.version ?? "1.7.5";
+  } catch {
+    return "1.7.5";
+  }
+}, "vobsVersion");
+function toRowId(packageName) {
+  return packageName.replace(/^@[^/]+\//u, "");
+}
+__name(toRowId, "toRowId");
+async function dshInitCommand(target, options) {
+  const name = target ?? await p4.text({
+    message: "\u63D2\u4EF6\u5305\u540D\uFF08npm \u5305\u540D\uFF0C\u5C0F\u5199\uFF09:",
+    placeholder: "dsh-plugin-my-panel",
+    validate: /* @__PURE__ */ __name((value) => /^[a-z0-9][a-z0-9._~-]*$/u.test(value) ? void 0 : "\u5FC5\u987B\u662F\u5408\u6CD5\u7684 npm \u5305\u540D", "validate")
+  });
+  if (p4.isCancel(name)) {
+    p4.cancel("\u5DF2\u53D6\u6D88");
+    return;
+  }
+  const packageManager = options.pm ?? await p4.select({
+    message: "\u5305\u7BA1\u7406\u5668:",
+    options: [
+      { value: "pnpm", label: "pnpm" },
+      { value: "npm", label: "npm" }
+    ]
+  });
+  if (p4.isCancel(packageManager)) {
+    p4.cancel("\u5DF2\u53D6\u6D88");
+    return;
+  }
+  const targetDir = options.dir !== void 0 ? (0, import_node_path5.resolve)(options.dir) : (0, import_node_path5.resolve)(process.cwd(), name);
+  const rowId = toRowId(name);
+  const displayName = rowId.replace(/^dsh-plugin-/u, "").split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+  logger.step(`\u521B\u5EFA DSH \u63D2\u4EF6\u9879\u76EE ${name} \u2026`);
+  await scaffoldProject(
+    targetDir,
+    { packageName: name, rowId, displayName, vobsVersion: vobsVersion() },
+    "dsh-plugin"
+  );
+  ensureDir(targetDir);
+  (0, import_node_fs3.writeFileSync)(
+    (0, import_node_path5.resolve)(targetDir, ".gitignore"),
+    ["node_modules/", "*.log", "*.tsbuildinfo", "", "# lib/ \u662F\u6784\u5EFA\u4EA7\u7269\uFF0C\u5FC5\u987B\u63D0\u4EA4\uFF1ADSH \u5B89\u88C5\u65F6\u4E0D\u4F1A\u6784\u5EFA\u4F60\u7684\u5305\u3002", ""].join("\n"),
+    "utf8"
+  );
+  logger.success("\u9879\u76EE\u5DF2\u751F\u6210");
+  logger.step("\u5B89\u88C5\u4F9D\u8D56 \u2026");
+  try {
+    installDependencies(targetDir, packageManager);
+    logger.success("\u4F9D\u8D56\u5DF2\u5B89\u88C5");
+  } catch {
+    logger.warn(`\u4F9D\u8D56\u5B89\u88C5\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u6267\u884C ${packageManager} install`);
+  }
+  logger.step("\u4E0B\u4E00\u6B65");
+  console.log(`
+  cd ${name}
+  ${packageManager} run dev     # \u672C\u5730\u9884\u89C8\uFF0C\u4E0D\u7528\u88C5\u8FDB DSH
+  ${packageManager} run build   # \u4EA7\u51FA lib/{index,client}.js
+
+  # \u63D0\u4EA4\u4EA7\u7269\u5E76\u6253 tag \u4E4B\u540E\uFF0C\u5728 DSH \u63D2\u4EF6\u9875\u586B\uFF1A
+  github:<owner>/<repo>#v0.1.0&path:/<\u672C\u5305\u5728\u4ED3\u5E93\u4E2D\u7684\u8DEF\u5F84>
+`);
+}
+__name(dshInitCommand, "dshInitCommand");
+async function dshBuildCommand() {
+  const projectDir = process.cwd();
+  const configFile = (0, import_node_path5.resolve)(projectDir, "vite.config.ts");
+  if (!(0, import_node_fs3.existsSync)(configFile)) {
+    logger.error("\u5F53\u524D\u76EE\u5F55\u6CA1\u6709 vite.config.ts\uFF0C\u8BF7\u5728\u63D2\u4EF6\u9879\u76EE\u6839\u76EE\u5F55\u8FD0\u884C\u3002");
+    process.exitCode = 1;
+    return;
+  }
+  const manifest = readManifest(projectDir);
+  if (manifest === void 0) {
+    logger.error("\u8BFB\u4E0D\u5230 package.json\u3002");
+    process.exitCode = 1;
+    return;
+  }
+  const hostEntry = resolveExport(manifest, ".");
+  if (hostEntry === void 0) {
+    logger.error('package.json \u7684 exports \u91CC\u6CA1\u6709 "."\uFF0CDSH \u52A0\u8F7D\u4E0D\u5230 Host \u4FA7\u63D2\u4EF6\u3002');
+    process.exitCode = 1;
+    return;
+  }
+  const { build: build2 } = await import("vite");
+  logger.info("\u6784\u5EFA\u5BA2\u6237\u7AEF\u4EA7\u7269 \u2026");
+  await build2({ configFile, mode: "production" });
+  logger.info("\u6784\u5EFA Host \u4EA7\u7269 \u2026");
+  const hostTarget = (0, import_node_path5.resolve)(projectDir, hostEntry.replace(/^\.\//u, ""));
+  const hostEntrySource = (0, import_node_path5.resolve)(projectDir, "src", "host", "index.ts");
+  if (!(0, import_node_fs3.existsSync)(hostEntrySource)) {
+    logger.warn(`\u6CA1\u6709\u627E\u5230 ${hostEntrySource}\uFF0C\u8DF3\u8FC7 Host \u6784\u5EFA\u3002`);
+    return;
+  }
+  await build2({
+    configFile: false,
+    root: projectDir,
+    logLevel: "warn",
+    build: {
+      outDir: (0, import_node_path5.relative)(projectDir, (0, import_node_path5.dirname)(hostTarget)) || ".",
+      emptyOutDir: false,
+      target: "es2022",
+      minify: false,
+      sourcemap: false,
+      lib: {
+        entry: hostEntrySource,
+        formats: ["es"],
+        fileName: /* @__PURE__ */ __name(() => (0, import_node_path5.basename)(hostTarget), "fileName")
+      }
+    }
+  });
+  logger.success("\u6784\u5EFA\u5B8C\u6210 \u2192 \u5BA2\u6237\u7AEF\u4E0E Host \u4EA7\u7269\u90FD\u5DF2\u5C31\u4F4D");
+}
+__name(dshBuildCommand, "dshBuildCommand");
+function resolveExport(manifest, key) {
+  const exportsField = manifest.exports ?? {};
+  const entry = exportsField[key];
+  if (typeof entry === "string") return entry;
+  if (typeof entry === "object" && entry !== null) {
+    const record = entry;
+    for (const condition of ["default", "import", "require"]) {
+      const value = record[condition];
+      if (typeof value === "string") return value;
+    }
+  }
+  return void 0;
+}
+__name(resolveExport, "resolveExport");
+function buildPreviewHtml(options) {
+  const name = JSON.stringify(options.packageName).replace(/</gu, "\\u003c");
+  const title = (options.title ?? options.packageName).replace(/[<>&]/gu, "");
+  return `<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>vobs preview \xB7 ${title}</title>
+</head>
+<body>
+<div id="root"></div>
+
+<!-- 1. \u5148\u88C5\u57AB\u7247\uFF1A\u5FC5\u987B\u5728\u63D2\u4EF6 bundle \u4E4B\u524D\uFF0C\u6355\u83B7\u5B83\u7684 factory \u6CE8\u518C -->
+<script>
+  window.__VOBS_DSH_PREVIEW__ = { factories: new Map() };
+  window.__ModuleLoader__ = {
+    load: function (entry) { window.__VOBS_DSH_PREVIEW__.factories.set(entry.id, entry.factory); }
+  };
+</script>
+
+<!-- 2. \u63D2\u4EF6\u4EA7\u7269\uFF1A\u5B83\u53EA\u6CE8\u518C factory\uFF0C\u4E0D\u4EA7\u751F\u526F\u4F5C\u7528 -->
+<script src="/client.js"></script>
+
+<!-- 3. \u542F\u52A8\u9884\u89C8\u5916\u58F3 -->
+<script type="module">
+  import { startPreview } from '/preview.js';
+  window.__VOBS_PREVIEW__ = startPreview({
+    container: document.getElementById('root'),
+    packageName: ${name}
+  });
+</script>
+
+<!-- 4. \u91CD\u5EFA\u540E\u81EA\u52A8\u5237\u65B0\uFF1B?static=1 \u5173\u6389\u957F\u8FDE\u63A5\uFF0C\u4FBF\u4E8E\u65E0\u5934\u622A\u56FE\u4E0E CI \u65AD\u8A00 -->
+<script>
+  if (!location.search.includes('static')) {
+    new EventSource('/events').addEventListener('reload', function () { location.reload(); });
+  }
+</script>
+</body>
+</html>
+`;
+}
+__name(buildPreviewHtml, "buildPreviewHtml");
+async function dshDevCommand(options) {
+  const projectDir = process.cwd();
+  const manifest = readManifest(projectDir);
+  if (manifest === void 0) {
+    logger.error("\u5F53\u524D\u76EE\u5F55\u6CA1\u6709\u53EF\u8BFB\u7684 package.json\u3002");
+    process.exitCode = 1;
+    return;
+  }
+  if (readManifest(projectDir)?.dsh === void 0) {
+    logger.error("\u8FD9\u4E0D\u662F\u4E00\u4E2A DSH \u63D2\u4EF6\u9879\u76EE\uFF08package.json \u91CC\u6CA1\u6709 dsh \u5B57\u6BB5\uFF09\u3002");
+    process.exitCode = 1;
+    return;
+  }
+  const packageName = typeof manifest.name === "string" ? manifest.name : "dsh-plugin";
+  const clientEntry = resolveExport(manifest, "./client");
+  if (clientEntry === void 0) {
+    logger.error('package.json \u7684 exports \u91CC\u6CA1\u6709 "./client"\uFF0C\u9875\u9762\u62FF\u4E0D\u5230\u5BA2\u6237\u7AEF bundle\u3002');
+    process.exitCode = 1;
+    return;
+  }
+  const clientFile = (0, import_node_path5.resolve)(projectDir, clientEntry.replace(/^\.\//u, ""));
+  let previewFile;
+  try {
+    const projectRequire = (0, import_node_module.createRequire)((0, import_node_path5.join)(projectDir, "package.json"));
+    let packageRoot;
+    try {
+      packageRoot = (0, import_node_path5.dirname)(projectRequire.resolve("@vobs/dsh/package.json"));
+    } catch {
+      packageRoot = (0, import_node_path5.dirname)((0, import_node_path5.dirname)(projectRequire.resolve("@vobs/dsh")));
+    }
+    const candidate = (0, import_node_path5.join)(packageRoot, "dist", "preview.js");
+    previewFile = (0, import_node_fs3.existsSync)(candidate) ? candidate : void 0;
+  } catch {
+    previewFile = void 0;
+  }
+  if (previewFile === void 0) {
+    logger.error("\u9879\u76EE\u91CC\u627E\u4E0D\u5230 @vobs/dsh \u7684\u9884\u89C8\u8FD0\u884C\u65F6\u3002\u5148\u5B89\u88C5\u4F9D\u8D56\uFF1Apnpm add -D @vobs/dsh");
+    process.exitCode = 1;
+    return;
+  }
+  const port = options.port ?? 5199;
+  const clients = /* @__PURE__ */ new Set();
+  const broadcast = /* @__PURE__ */ __name((event) => {
+    for (const client of clients) client.write(`event: ${event}
+data: 1
+
+`);
+  }, "broadcast");
+  logger.info("\u6784\u5EFA\u4EA7\u7269 \u2026");
+  const { build: build2 } = await import("vite");
+  const configFile = (0, import_node_path5.resolve)(projectDir, "vite.config.ts");
+  let buildError;
+  try {
+    const watcher = await build2({
+      configFile,
+      mode: "development",
+      logLevel: "warn",
+      build: { watch: {} }
+    });
+    watcher.on("event", (event) => {
+      if (event.code === "END") {
+        buildError = void 0;
+        logger.success("\u91CD\u65B0\u6784\u5EFA\u5B8C\u6210");
+        broadcast("reload");
+      } else if (event.code === "ERROR") {
+        buildError = event.error?.message ?? "\u6784\u5EFA\u5931\u8D25";
+        logger.error(buildError);
+      }
+    });
+    process.on("SIGINT", () => {
+      void watcher.close().then(() => process.exit(0));
+    });
+  } catch (error2) {
+    logger.error(`\u6784\u5EFA\u5931\u8D25\uFF1A${error2 instanceof Error ? error2.message : String(error2)}`);
+    process.exitCode = 1;
+    return;
+  }
+  const server = (0, import_node_http.createServer)((request, response) => {
+    const url = (request.url ?? "/").split("?")[0];
+    if (url === "/events") {
+      response.writeHead(200, {
+        "content-type": "text/event-stream",
+        "cache-control": "no-store",
+        connection: "keep-alive"
+      });
+      response.write(": connected\n\n");
+      clients.add(response);
+      request.on("close", () => clients.delete(response));
+      return;
+    }
+    const send = /* @__PURE__ */ __name((body, type) => {
+      response.writeHead(200, { "content-type": type, "cache-control": "no-store" });
+      response.end(body);
+    }, "send");
+    if (url === "/") {
+      send(buildPreviewHtml({ packageName }), "text/html; charset=utf-8");
+      return;
+    }
+    if (url === "/preview.js") {
+      void (0, import_promises.readFile)(previewFile).then((body) => send(body, "text/javascript; charset=utf-8"));
+      return;
+    }
+    if (url === "/client.js") {
+      if (!(0, import_node_fs3.existsSync)(clientFile)) {
+        response.writeHead(503, { "content-type": "text/plain; charset=utf-8" });
+        response.end(`\u8FD8\u6CA1\u6709\u4EA7\u7269\uFF1A${clientEntry}
+${buildError ?? ""}`);
+        return;
+      }
+      void (0, import_promises.readFile)(clientFile).then((body) => send(body, "text/javascript; charset=utf-8"));
+      return;
+    }
+    response.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
+    response.end("not found");
+  });
+  await new Promise((resolveListen) => {
+    server.listen(port, "127.0.0.1", resolveListen);
+  });
+  logger.success(`\u9884\u89C8\u5DF2\u5C31\u7EEA\uFF1Ahttp://127.0.0.1:${port}/`);
+  console.log("\n  \u6539\u4EE3\u7801\u4F1A\u81EA\u52A8\u91CD\u5EFA\u5E76\u5237\u65B0\u9875\u9762\uFF1BCtrl+C \u9000\u51FA\u3002\n");
+}
+__name(dshDevCommand, "dshDevCommand");
+function readManifest(dir) {
+  try {
+    return JSON.parse((0, import_node_fs3.readFileSync)((0, import_node_path5.resolve)(dir, "package.json"), "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+__name(readManifest, "readManifest");
+function collectIssues(dir) {
+  const result = { errors: [], warnings: [], passed: [] };
+  const manifest = readManifest(dir);
+  if (manifest === void 0) {
+    result.errors.push("\u8BFB\u4E0D\u5230 package.json\uFF08JSON \u8BED\u6CD5\u9519\u8BEF\u6216\u6587\u4EF6\u7F3A\u5931\uFF09");
+    return result;
+  }
+  const name = typeof manifest.name === "string" ? manifest.name : "";
+  if (name === "") result.errors.push("package.json \u7F3A\u5C11 name");
+  else result.passed.push(`\u5305\u540D ${name}`);
+  const dsh = manifest.dsh ?? {};
+  const bundle = dsh.bundle ?? {};
+  const client = dsh.client ?? {};
+  if (typeof bundle.patch !== "string") {
+    result.errors.push("\u7F3A\u5C11 dsh.bundle.patch \u2014\u2014 DSH \u4E0D\u4F1A\u628A\u8FD9\u4E2A\u5305\u5F53\u4F5C\u7EC4\u5408\u5305\uFF08bundle\uFF09");
+  } else {
+    const patchPath = (0, import_node_path5.resolve)(dir, bundle.patch.replace(/^\.\//u, ""));
+    if (!(0, import_node_fs3.existsSync)(patchPath)) {
+      result.errors.push(`dsh.bundle.patch \u6307\u5411\u7684 ${bundle.patch} \u4E0D\u5B58\u5728`);
+    } else {
+      const text5 = (0, import_node_fs3.readFileSync)(patchPath, "utf8");
+      if (!text5.includes("insert:")) result.errors.push("cordis.patch.yml \u91CC\u6CA1\u6709 insert: \u6BB5\u843D\uFF0C\u63D2\u4EF6\u884C\u4E0D\u4F1A\u8FDB\u7EC4\u5408\u6811");
+      else if (name !== "" && !text5.includes(name)) {
+        result.warnings.push(`cordis.patch.yml \u91CC\u6CA1\u6709\u51FA\u73B0\u5305\u540D ${name}\uFF0C\u786E\u8BA4 insert \u7684 name \u5199\u5BF9\u4E86`);
+      } else result.passed.push("cordis.patch.yml \u4F1A\u63D2\u5165\u672C\u5305\u7684\u884C");
+    }
+  }
+  if (client.platform !== "web") {
+    result.errors.push("dsh.client.platform \u5FC5\u987B\u662F 'web' \u2014\u2014 \u5426\u5219 DSH \u4E0D\u4F1A\u7ED9\u9875\u9762\u63D0\u4F9B\u5BA2\u6237\u7AEF bundle");
+  } else result.passed.push("dsh.client.platform = web");
+  const exportsField = manifest.exports ?? {};
+  const hostEntry = exportsField["."];
+  const clientEntry = exportsField["./client"];
+  if (typeof hostEntry !== "string") result.errors.push('exports["."] \u672A\u58F0\u660E \u2014\u2014 DSH \u52A0\u8F7D\u4E0D\u5230 Host \u4FA7\u63D2\u4EF6');
+  else if (!(0, import_node_fs3.existsSync)((0, import_node_path5.resolve)(dir, hostEntry.replace(/^\.\//u, "")))) {
+    result.errors.push(`exports["."] \u6307\u5411\u7684 ${hostEntry} \u4E0D\u5B58\u5728\uFF0C\u5148\u6784\u5EFA`);
+  } else result.passed.push("Host \u5165\u53E3\u5B58\u5728");
+  if (typeof clientEntry !== "string") result.errors.push('exports["./client"] \u672A\u58F0\u660E \u2014\u2014 \u9875\u9762\u62FF\u4E0D\u5230\u5BA2\u6237\u7AEF bundle');
+  const scripts = manifest.scripts ?? {};
+  if (scripts.prepare !== void 0 || scripts.postinstall !== void 0) {
+    result.errors.push("\u58F0\u660E\u4E86 prepare / postinstall \u2014\u2014 DSH \u5B89\u88C5\u65F6\u4E0D\u6784\u5EFA\uFF0C\u4EA7\u7269\u5FC5\u987B\u9884\u5148\u63D0\u4EA4");
+  } else result.passed.push("\u6CA1\u6709\u5B89\u88C5\u671F\u751F\u547D\u5468\u671F\u94A9\u5B50");
+  const dependencyText = JSON.stringify({
+    dependencies: manifest.dependencies,
+    peerDependencies: manifest.peerDependencies,
+    devDependencies: manifest.devDependencies
+  });
+  if (dependencyText.includes("workspace:")) {
+    result.errors.push("\u4F9D\u8D56\u91CC\u51FA\u73B0\u4E86 workspace: \u534F\u8BAE \u2014\u2014 GitHub \u5B50\u76EE\u5F55\u76F4\u88C5\u65F6\u89E3\u6790\u4E0D\u4E86");
+  } else result.passed.push("\u6CA1\u6709 workspace: \u534F\u8BAE\u4F9D\u8D56");
+  if (typeof clientEntry === "string") {
+    const clientPath = (0, import_node_path5.resolve)(dir, clientEntry.replace(/^\.\//u, ""));
+    if (!(0, import_node_fs3.existsSync)(clientPath)) {
+      result.errors.push(`\u5BA2\u6237\u7AEF\u4EA7\u7269 ${clientEntry} \u4E0D\u5B58\u5728\uFF0C\u5148\u8FD0\u884C\u6784\u5EFA`);
+    } else {
+      const code = (0, import_node_fs3.readFileSync)(clientPath, "utf8");
+      const loads = (code.match(/__ModuleLoader__\.load\(/gu) ?? []).length;
+      if (loads !== 1) result.errors.push(`\u5BA2\u6237\u7AEF\u4EA7\u7269\u91CC __ModuleLoader__.load \u51FA\u73B0 ${loads} \u6B21\uFF0C\u5E94\u4E3A 1 \u6B21\uFF08\u5148\u6784\u5EFA\uFF09`);
+      else result.passed.push("\u4EA7\u7269\u5F62\u6001\u662F DSH \u5BA2\u6237\u7AEF\u6A21\u5757\u534F\u8BAE");
+      if (code.includes("import(")) result.errors.push("\u5BA2\u6237\u7AEF\u4EA7\u7269\u91CC\u6709\u52A8\u6001 import()\uFF0CDSH \u53EA\u652F\u6301\u81EA\u5305\u542B chunk");
+      const requires = [...code.matchAll(/require\((['"])([^'"]+)\1\)/gu)].map((match) => match[2] ?? "");
+      const foreign = requires.filter((id) => !PLATFORM_MODULES.includes(id) && !id.startsWith("@deepseek-ai/"));
+      if (foreign.length > 0) {
+        result.errors.push(`\u4EA7\u7269 require \u4E86\u975E\u5E73\u53F0\u6A21\u5757\uFF1A${[...new Set(foreign)].join(", ")} \u2014\u2014 \u4F9D\u8D56\u6CA1\u6709\u88AB\u6253\u8FDB\u4EA7\u7269`);
+      } else if (requires.length > 0) {
+        result.passed.push(`\u4EA7\u7269\u53EA require \u5E73\u53F0\u6A21\u5757\uFF08${[...new Set(requires)].join(", ")}\uFF09`);
+      }
+      if (name !== "" && !code.includes(`"${name}"`) && !code.includes(`'${name}'`)) {
+        result.warnings.push(`\u4EA7\u7269\u91CC\u7684\u6A21\u5757 id \u4E0E\u5305\u540D ${name} \u4E0D\u4E00\u81F4\uFF0C\u68C0\u67E5 dshBundle({ id })`);
+      }
+    }
+  }
+  return result;
+}
+__name(collectIssues, "collectIssues");
+function dshCheckCommand() {
+  const dir = process.cwd();
+  const result = collectIssues(dir);
+  logger.step("DSH \u63D2\u4EF6\u88C5\u524D\u6821\u9A8C");
+  for (const item of result.passed) console.log(`  \u2714 ${item}`);
+  for (const item of result.warnings) console.log(`  \u26A0 ${item}`);
+  for (const item of result.errors) console.log(`  \u2716 ${item}`);
+  if (result.errors.length > 0) {
+    logger.error(`${result.errors.length} \u9879\u4E0D\u901A\u8FC7\uFF0C\u88C5\u8FDB DSH \u540E\u4E0D\u4F1A\u6B63\u5E38\u5DE5\u4F5C\u3002`);
+    process.exitCode = 1;
+    return;
+  }
+  logger.success(`\u5168\u90E8\u901A\u8FC7\uFF08${result.passed.length} \u9879${result.warnings.length > 0 ? `\uFF0C${result.warnings.length} \u6761\u8B66\u544A` : ""}\uFF09`);
+}
+__name(dshCheckCommand, "dshCheckCommand");
+function readPnpmVersion() {
+  try {
+    return (0, import_node_child_process3.execSync)("pnpm --version", { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return void 0;
+  }
+}
+__name(readPnpmVersion, "readPnpmVersion");
+var majorOf = /* @__PURE__ */ __name((version) => {
+  const major = Number.parseInt((version ?? "").split(".")[0] ?? "", 10);
+  return Number.isFinite(major) ? major : 0;
+}, "majorOf");
+function buildInstallSpec(options) {
+  if (options.spec !== void 0) return { spec: options.spec };
+  if (options.from !== void 0) {
+    const target = (0, import_node_path5.resolve)(options.from);
+    if (!(0, import_node_fs3.existsSync)(target)) return { error: `--from \u6307\u5411\u7684\u8DEF\u5F84\u4E0D\u5B58\u5728\uFF1A${target}` };
+    return { spec: target };
+  }
+  if (options.repo !== void 0) {
+    const ref = options.tag !== void 0 && options.tag !== "" ? `#${options.tag}` : "";
+    const sub = options.subpath !== void 0 && options.subpath !== "" ? `${ref === "" ? "#" : "&"}path:${options.subpath}` : "";
+    return { spec: `github:${options.repo}${ref}${sub}` };
+  }
+  return { error: "\u9700\u8981 --spec\u3001--from \u6216 --repo \u4E4B\u4E00\u6765\u6307\u5B9A\u5B89\u88C5\u6765\u6E90\u3002" };
+}
+__name(buildInstallSpec, "buildInstallSpec");
+var CMD_NEEDS_QUOTE = /[\s&|<>^()"']/u;
+function quoteForCmd(part) {
+  return CMD_NEEDS_QUOTE.test(part) ? `"${part.replace(/"/gu, '""')}"` : part;
+}
+__name(quoteForCmd, "quoteForCmd");
+function buildShellCommand(exe, args) {
+  return [exe, ...args].map(quoteForCmd).join(" ");
+}
+__name(buildShellCommand, "buildShellCommand");
+function spawnDsh(args, dry) {
+  if (dry) {
+    console.log(`
+  ${buildShellCommand("dsh", args)}
+`);
+    return 0;
+  }
+  if (process.platform === "win32") {
+    const result2 = (0, import_node_child_process3.spawnSync)(buildShellCommand("dsh", args), { stdio: "inherit", shell: true });
+    return result2.status ?? 1;
+  }
+  const result = (0, import_node_child_process3.spawnSync)("dsh", args, { stdio: "inherit" });
+  return result.status ?? 1;
+}
+__name(spawnDsh, "spawnDsh");
+function dshInstallCommand(options) {
+  const profile = options.profile ?? "desktop";
+  const { spec, error: error2 } = buildInstallSpec(options);
+  if (spec === void 0) {
+    logger.error(error2 ?? "\u672A\u77E5\u9519\u8BEF");
+    process.exitCode = 1;
+    return;
+  }
+  const usesSubpath = spec.includes("path:");
+  const pnpmVersion = readPnpmVersion();
+  if (usesSubpath && pnpmVersion !== void 0 && majorOf(pnpmVersion) < 11) {
+    logger.warn(
+      `\u68C0\u6D4B\u5230 pnpm ${pnpmVersion}\uFF1A11 \u4EE5\u4E0B\u4E0D\u652F\u6301 git \u5B50\u76EE\u5F55\u8BED\u6CD5\uFF08#\u2026&path:\uFF09\uFF0C\u4F1A\u9759\u9ED8\u88C5\u6210\u4ED3\u5E93\u6839\u800C\u4E0D\u662F\u4F60\u60F3\u8981\u7684\u5B50\u5305\u3002DSH \u5185\u7F6E\u7684 pnpm 11 \u4E0D\u53D7\u5F71\u54CD \u2014\u2014 \u5EFA\u8BAE\u6539\u7528 DSH \u63D2\u4EF6\u9875\u5B89\u88C5\u3002`
+    );
+  }
+  if (usesSubpath && process.platform === "win32") {
+    logger.info("Windows\uFF1A\u4F1A\u901A\u8FC7 cmd /d /s /c \u6267\u884C\uFF0C\u907F\u514D & \u88AB\u5F53\u6210\u547D\u4EE4\u5206\u9694\u7B26\u3002");
+  }
+  logger.step(`\u5B89\u88C5\u5230 profile\u300C${profile}\u300D`);
+  console.log(`  spec: ${spec}`);
+  if (!(0, import_node_path5.isAbsolute)(spec) && !spec.startsWith("github:") && !spec.startsWith("git+") && !spec.startsWith("http")) {
+    logger.warn("\u8FD9\u4E2A spec \u65E2\u4E0D\u662F\u7EDD\u5BF9\u8DEF\u5F84\u4E5F\u4E0D\u662F git/URL\uFF0C\u786E\u8BA4\u6CA1\u6709\u5199\u9519\u3002");
+  }
+  const status = spawnDsh(["plugin", "--profile", profile, "add", spec], options.dry === true);
+  if (options.dry === true) {
+    logger.info("dry run\uFF1A\u4EE5\u4E0A\u547D\u4EE4\u6CA1\u6709\u6267\u884C\u3002");
+    return;
+  }
+  if (status !== 0) {
+    logger.error(`\u5B89\u88C5\u5931\u8D25\uFF08\u9000\u51FA\u7801 ${status}\uFF09\u3002\u8BCA\u65AD\u65E5\u5FD7\u5728 ~/.dsh/profiles/${profile}/.plugin-manager/logs/`);
+    process.exitCode = status;
+    return;
+  }
+  logger.success("\u5B89\u88C5\u5B8C\u6210 \u2014\u2014 \u5B8C\u5168\u9000\u51FA DSH \u518D\u6253\u5F00\u5373\u53EF\u751F\u6548");
+}
+__name(dshInstallCommand, "dshInstallCommand");
+var ACTIONS = {
+  init: "\u521B\u5EFA\u4E00\u4E2A DSH \u63D2\u4EF6\u9879\u76EE",
+  dev: "\u672C\u5730\u9884\u89C8\uFF08\u6D4F\u89C8\u5668\u91CC\u770B\u9762\u677F\uFF0C\u4E0D\u7528\u88C5\u8FDB DSH\uFF09",
+  build: "\u6784\u5EFA lib/{index,client}.js",
+  check: "\u88C5\u524D\u4E00\u81F4\u6027\u6821\u9A8C",
+  install: "\u628A\u63D2\u4EF6\u88C5\u8FDB DSH profile"
+};
+async function dshCommand(action, target, options) {
+  switch (action) {
+    case "init":
+    case "create":
+      await dshInitCommand(target, options);
+      return;
+    case "dev":
+      await dshDevCommand(options);
+      return;
+    case "build":
+      await dshBuildCommand();
+      return;
+    case "check":
+      dshCheckCommand();
+      return;
+    case "install":
+      dshInstallCommand(options);
+      return;
+    default:
+      logger.error(`\u672A\u77E5\u5B50\u547D\u4EE4: ${action ?? "(\u7A7A)"}`);
+      console.log("\n  \u53EF\u7528\u5B50\u547D\u4EE4\uFF1A");
+      for (const [name, description] of Object.entries(ACTIONS)) {
+        console.log(`    vobs dsh ${name.padEnd(8)} ${description}`);
+      }
+      process.exitCode = 1;
+  }
+}
+__name(dshCommand, "dshCommand");
+
 // packages/cli/src/banner.ts
 var BANNER_LINE1 = "\u{1D5E9}\u{1D5E2}\u{1D5D5}\u{1D5E6} \u{1D5D6}\u{1D5DF}\u{1D5DC} \u{1D603}\u{1D7ED}.\u{1D7EC}";
 var BANNER_TAGLINE = "Signals First \xB7 Zero Re-renders \xB7 Ultra Lightweight";
@@ -430,6 +962,20 @@ function createCLI() {
       dev: options.dev
     });
   });
+  cli.command("dsh <action> [target]", "DSH \u63D2\u4EF6\u5DE5\u5177\u94FE\uFF08init / dev / build / check / install\uFF09").option("--dir <dir>", "init\uFF1A\u76EE\u6807\u76EE\u5F55").option("--pm <pm>", "init\uFF1A\u5305\u7BA1\u7406\u5668\uFF08pnpm/npm\uFF09").option("--port <port>", "dev\uFF1A\u9884\u89C8\u7AEF\u53E3", { default: 5199 }).option("--profile <name>", "install\uFF1ADSH profile \u540D", { default: "desktop" }).option("--spec <spec>", "install\uFF1A\u5B8C\u6574\u5B89\u88C5 spec").option("--repo <owner/name>", "install\uFF1AGitHub owner/name").option("--tag <ref>", "install\uFF1AGit tag / \u5206\u652F / commit").option("--subpath <path>", "install\uFF1A\u4ED3\u5E93\u5185\u5B50\u76EE\u5F55").option("--from <path>", "install\uFF1A\u4ECE\u672C\u5730\u76EE\u5F55\u5B89\u88C5").option("--dry", "install\uFF1A\u53EA\u6253\u5370\u547D\u4EE4\uFF0C\u4E0D\u6267\u884C").action(async (action, target, options) => {
+    await dshCommand(action, target, {
+      dir: options.dir,
+      pm: options.pm,
+      profile: options.profile,
+      spec: options.spec,
+      repo: options.repo,
+      tag: options.tag,
+      subpath: options.subpath,
+      from: options.from,
+      dry: options.dry === true,
+      port: options.port === void 0 ? void 0 : Number(options.port)
+    });
+  });
   cli.command("logo", "Show the vobs CLI logo and version info").action(() => {
     showLogo();
   });