certd/packages/ui/certd-server/export-plugin-yaml.js

// 扫描目录，列出文件，然后加载为模块

import path, { join } from "path";
import fs from "fs";
import { pathToFileURL } from "node:url";
import * as yaml from "js-yaml";
import { AbstractTaskPlugin, BaseAccess, BaseNotification } from "@certd/pipeline";
import { BaseAddon } from "@certd/lib-server";
import { dnsProviderRegistry } from "@certd/plugin-cert";
import { pluginRegistry, accessRegistry, notificationRegistry, pluginGroups } from "@certd/pipeline";

function scanDir(dir) {
  const files = fs.readdirSync(dir);
  const result = [];
  // 扫描目录及子目录
  for (const file of files) {
    const filePath = join(dir, file);
    const stat = fs.statSync(filePath);
    if (stat.isDirectory()) {
      result.push(...scanDir(filePath));
    } else {
      if (!file.endsWith(".js")) {
        continue;
      }
      result.push(filePath);
    }
  }
  return result;
}

export default async function loadModules(dir) {
  const files = scanDir(dir);
  const modules = {};
  for (const file of files) {
    if (file === "dist/plugins/index.js" || file === "dist\\plugins\\index.js") {
      continue;
    }
    const content = fs.readFileSync(file, "utf8");
    if (content.includes(" abstract ")) {
      continue;
    }
    const lines = content.split("\n");
    let allExport = true;
    for (let line of lines) {
      line = line.trim();
      if (!line || line.startsWith("//")) {
        continue;
      }
      if (!line.startsWith("export ")) {
        allExport = false;
        break;
      }
    }
    if (allExport) {
      continue;
    }
    try {
      // 转换为 file:// URL（Windows 必需）
      const moduleUrl = pathToFileURL(file).href;
      const module = await import(moduleUrl);

      // 如果模块有默认导出，优先使用
      modules[file] = module.default || module;
    } catch (err) {
      console.error(`加载模块 ${file} 失败:`, err);
    }
  }
  return modules;
}

function isPrototypeOf(value, cls) {
  return cls.prototype.isPrototypeOf(value.prototype);
}
async function genMetadata() {
  const modules = await loadModules("./dist/plugins");

  fs.rmSync("./metadata", { recursive: true });
  fs.mkdirSync("./metadata", { recursive: true });
  for (const key in modules) {
    const module = modules[key];
    const entry = Object.entries(module);
    if (entry.length > 1) {
      console.log(`[warning] 文件 ${key} 导出了 ${entry.length} 个对象: ${entry.map(([name, value]) => name).join(", ")}`);
    }
    for (const [name, value] of entry) {
      //如果有define属性
      if (value.define) {
        //那么就是插件
        let location = key.substring(4);
        location = location.substring(0, location.length - 3);
        location = location.replaceAll("\\", "/");
        location += ".js";
        location = `${location}`; // 从modules/plugin/plugin-service 加载 ../../plugins目录下的文件

        const pluginDefine = {
          ...value.define,
        };
        let subType = "";
        if (pluginDefine.accessType) {
          pluginDefine.pluginType = "dnsProvider";
        } else if (isPrototypeOf(value, AbstractTaskPlugin)) {
          pluginDefine.pluginType = "deploy";
        } else if (isPrototypeOf(value, BaseNotification)) {
          pluginDefine.pluginType = "notification";
        } else if (isPrototypeOf(value, BaseAccess)) {
          pluginDefine.pluginType = "access";
        } else if (isPrototypeOf(value, BaseAddon)) {
          pluginDefine.pluginType = "addon";
          subType = "_" + pluginDefine.addonType;
        } else {
          console.log(`[warning] 未知的插件类型：${pluginDefine.name}`);
        }
        pluginDefine.type = "builtIn";

        const filePath = path.join(`./metadata/${pluginDefine.pluginType}${subType}_${pluginDefine.name}.yaml`);

        pluginDefine.scriptFilePath = location;
        console.log(location);
        const data = yaml.dump(pluginDefine);
        fs.writeFileSync(filePath, data, "utf8");
      }
    }
  }
}

async function genPluginMd() {
  const plugins = {
    access: [],
    deploy: [],
    dnsProvider: [],
    notification: [],
  };

  plugins.access = accessRegistry.getDefineList();
  plugins.deploy = pluginRegistry.getDefineList();
  plugins.dnsProvider = dnsProviderRegistry.getDefineList();
  plugins.notification = notificationRegistry.getDefineList();

  //   function genMd(list) {
  //     let mdContent = `<table style='width:100%'>
  // <thead style='width:100%'>
  // <tr >
  //   <th width='70'>序号</th><th width='265'>名称</th><th>说明</th>
  // </tr>
  // </thead>
  // <tbody>
  // `;
  //     let i = 0;
  //     for (const x of list) {
  //       i++
  //       mdContent += `<tr> <td>${i}.</td> <td style='font-weight: bold'>${x.title}</td> <td>${x.desc||''}</td> </tr>`;
  //     }
  //     mdContent += `</tbody></table>`;
  //     return mdContent;
  //   }

  //   function genMd(list) {
  //   let mdContent = ``;
  //   let i = 0;
  //   for (const x of list) {
  //     i++
  //     mdContent += `${i}. **${x.title}**     \n${x.desc||''}  \n\n\n`;
  //   }
  //   return mdContent;
  // }

  function genMd(list) {
    let mdContent = `
| 序号 | 名称 | 说明 |
|-----|-----|-----|
`;
    let i = 0;
    for (const x of list) {
      i++;
      const desc = x.desc || "";
      mdContent += `| ${i}.| **${x.title}** | ${desc.replaceAll("\n", " ")} | \n`;
    }
    return mdContent;
  }

  function addTableStyle() {
    return `
<style module>
table th:first-of-type {
        width: 65px;
    }
table th:nth-of-type(2) {
        width: 240px;
    }
</style>
    `;
  }

  let mdContent = "";
  mdContent = "# 授权列表\n";
  mdContent += genMd(plugins.access);
  mdContent += addTableStyle();
  fs.writeFileSync("../../../docs/guide/plugins/access.md", mdContent);

  mdContent = "# DNS提供商\n";
  mdContent += genMd(plugins.dnsProvider);
  mdContent += addTableStyle();
  fs.writeFileSync("../../../docs/guide/plugins/dns-provider.md", mdContent);

  mdContent = "# 通知插件\n";
  mdContent += genMd(plugins.notification);
  mdContent += addTableStyle();
  fs.writeFileSync("../../../docs/guide/plugins/notification.md", mdContent);

  mdContent = "# 任务插件\n";
  mdContent += `共 \`${plugins.deploy.length}\` 款任务插件    \n`;
  let index = 0;
  for (const key in pluginGroups) {
    index++;
    const group = pluginGroups[key];
    mdContent += `## ${index}. ${group.title}\n`;
    mdContent += genMd(group.plugins);
  }
  mdContent += addTableStyle();
  fs.writeFileSync("../../../docs/guide/plugins/deploy.md", mdContent);
}

// import why from 'why-is-node-running'
// setTimeout(() => why(), 100); // 延迟打印原因
async function main() {
  await genMetadata();
  console.log("genMetadata success");
  // 获取args genmd
  const args = process.argv.slice(2);
  if (!args.includes("docoff")) {
    await genPluginMd();
    console.log("genPluginMd success");
  }
  process.exit();
}

main();