tego 1.3.52 → 1.3.54

package/lib/config.d.ts

@@ -5,25 +5,25 @@ export declare function getConfig(): Promise<{
     };
     plugins: string[];
     cacheManager: {
-        defaultStore: string;
+        defaultStore: any;
         stores: {
             redis?: {
-                url: string;
+                url: any;
             };
             memory: {
                 store: string;
-                max: number;
+                max: any;
             };
         };
     };
     logger: {
         request: {
             transports: ("console" | "file" | "dailyRotateFile")[];
-            level: string;
+            level: any;
         };
         system: {
             transports: ("console" | "file" | "dailyRotateFile")[];
-            level: string;
+            level: any;
         };
     };
     perfHooks: boolean;

package/lib/config.js

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var config_exports = {};
 __export(config_exports, {
@@ -22,6 +32,7 @@ __export(config_exports, {
 });
 module.exports = __toCommonJS(config_exports);
 var import_database = require("@tachybase/database");
+var import_globals = __toESM(require("@tachybase/globals"));
 var import_logger = require("@tachybase/logger");
 async function getConfig() {
   return {
@@ -33,15 +44,15 @@ async function getConfig() {
     },
     plugins: ["tachybase"],
     cacheManager: {
-      defaultStore: process.env.CACHE_DEFAULT_STORE || "memory",
+      defaultStore: import_globals.default.settings.cache.defaultStore ?? "memory",
       stores: {
         memory: {
           store: "memory",
-          max: parseInt(process.env.CACHE_MEMORY_MAX) || 2e3
+          max: import_globals.default.settings.cache.memoryMax ?? 2e3
         },
-        ...process.env.CACHE_REDIS_URL ? {
+        ...import_globals.default.settings.cache.redisUrl ? {
           redis: {
-            url: process.env.CACHE_REDIS_URL
+            url: import_globals.default.settings.cache.redisUrl
           }
         } : {}
       }

package/lib/constants.js

@@ -35,9 +35,21 @@ __export(constants_exports, {
   LAST_UPDATE_FILE_SUFFIX: () => LAST_UPDATE_FILE_SUFFIX
 });
 module.exports = __toCommonJS(constants_exports);
+var import_node_fs = __toESM(require("node:fs"));
 var import_node_path = __toESM(require("node:path"));
+var import_globals = __toESM(require("@tachybase/globals"));
 var import_utils = require("./utils");
 (0, import_utils.parseEnvironment)();
+if (!import_node_fs.default.existsSync(`${process.env.TEGO_RUNTIME_HOME}/settings.js`)) {
+  import_node_fs.default.mkdirSync(`${process.env.TEGO_RUNTIME_HOME}`, { recursive: true });
+  import_node_fs.default.copyFileSync(import_node_path.default.join(__dirname, "../presets/settings.js"), `${process.env.TEGO_RUNTIME_HOME}/settings.js`);
+}
+import_globals.default.settings = require(`${process.env.TEGO_RUNTIME_HOME}/settings.js`);
+for (const key in import_globals.default.settings.env) {
+  if (!process.env[key]) {
+    process.env[key] = import_globals.default.settings.env[key];
+  }
+}
 const DEFAULT_DEV_PLUGINS_PATH = import_node_path.default.join(process.env.TEGO_RUNTIME_HOME, "plugins", "dev");
 const DEFAULT_REMOTE_PLUGINS_PATH = import_node_path.default.join(process.env.TEGO_RUNTIME_HOME, "plugins", "remote");
 const DEFAULT_BUILTIN_PLUGINS_PATH = import_node_path.default.join(process.env.TEGO_RUNTIME_HOME, "plugins", "builtin");

package/lib/plugin-presets.d.ts

@@ -1,20 +1,15 @@
 import { Plugin } from '@tego/core';
 export declare class PluginPresets extends Plugin {
-    splitNames(name: string): string[];
-    getBuiltInPlugins(): string[];
-    parseNames(plugins: string): string[][];
-    getExternalPlugins(): {
-        installedPlugins: string[];
-        disabledPlugins: string[];
-    };
+    getBuiltInPlugins(): any;
+    getExternalPlugins(): any;
     getPackageJson(name: any): Promise<any>;
-    allPlugins(): Promise<any[]>;
-    getPluginToBeUpgraded(): Promise<any[]>;
+    allPlugins(): Promise<any>;
+    getPluginToBeUpgraded(): Promise<any>;
     updateOrCreatePlugins(): Promise<void>;
     createIfNotExists(): Promise<void>;
     install(): Promise<void>;
     upgrade(): Promise<void>;
-    getForbidSubAppPlugin(): string[];
+    getForbidSubAppPlugin(): any;
     forbidSubAppPlugin(): Promise<void>;
     filterForbidSubAppPlugin(plugins: any[]): Promise<void>;
 }

package/lib/plugin-presets.js

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var plugin_presets_exports = {};
 __export(plugin_presets_exports, {
@@ -22,35 +32,34 @@ __export(plugin_presets_exports, {
   default: () => plugin_presets_default
 });
 module.exports = __toCommonJS(plugin_presets_exports);
+var import_globals = __toESM(require("@tachybase/globals"));
 var import_core = require("@tego/core");
 const _PluginPresets = class _PluginPresets extends import_core.Plugin {
-  splitNames(name) {
-    return (name || "").split(",").filter(Boolean);
-  }
   getBuiltInPlugins() {
-    const { PRESETS_BULTIN_PLUGINS } = process.env;
-    if (!PRESETS_BULTIN_PLUGINS) {
+    if (!import_globals.default.settings.presets.builtinPlugins) {
       throw new Error(
-        "PRESETS_BUILTIN_PLUGINS is not defined! Please refer to the .env.example file for the correct configuration."
+        "presets.builtinPlugins is not defined! Please refer to the settings.js file for the correct configuration."
       );
     }
-    const [installedPlugins] = this.parseNames(PRESETS_BULTIN_PLUGINS);
-    return installedPlugins;
-  }
-  parseNames(plugins) {
-    const installedPlugins = this.splitNames(plugins).filter((name) => !name.startsWith("!"));
-    const disabledPlugins = this.splitNames(plugins).filter((name) => name.startsWith("!")).map((name) => name.slice(1));
-    return [installedPlugins, disabledPlugins];
+    return import_globals.default.settings.presets.builtinPlugins;
   }
   getExternalPlugins() {
-    const { PRESETS_EXTERNAL_PLUGINS } = process.env;
-    if (!PRESETS_EXTERNAL_PLUGINS) {
+    if (!import_globals.default.settings.presets.externalPlugins) {
       throw new Error(
-        "PRESETS_EXTERNAL_PLUGINS is not defined! Please refer to the .env.example file for the correct configuration."
+        "presets.externalPlugins is not defined! Please refer to the settings.js file for the correct configuration."
       );
     }
-    const [installedPlugins, disabledPlugins] = this.parseNames(PRESETS_EXTERNAL_PLUGINS);
-    return { installedPlugins, disabledPlugins };
+    return import_globals.default.settings.presets.externalPlugins.reduce(
+      (acc, cur) => {
+        if (cur.enabledByDefault) {
+          acc.installedPlugins.push(cur.name);
+        } else {
+          acc.disabledPlugins.push(cur.name);
+        }
+        return acc;
+      },
+      { installedPlugins: [], disabledPlugins: [] }
+    );
   }
   async getPackageJson(name) {
     let packageName = name;
@@ -192,8 +201,7 @@ const _PluginPresets = class _PluginPresets extends import_core.Plugin {
     if (this.app.name === "main") {
       return [];
     }
-    const { FORBID_SUB_APP_PLUGINS } = process.env;
-    return FORBID_SUB_APP_PLUGINS ? FORBID_SUB_APP_PLUGINS.split(",") : [];
+    return import_globals.default.settings.misc.forbidSubAppPlugins;
   }
   // 从环境变量读取禁止子应用装载的插件
   async forbidSubAppPlugin() {

package/lib/prepare.js

@@ -44,16 +44,6 @@ async function prepare({
   plugins = [],
   init = false
 }) {
-  if (init) {
-    if (import_node_fs.default.existsSync(name)) {
-      console.log(`project folder ${name} already exists, exit now.`);
-      return;
-    }
-    import_node_fs.default.mkdirSync(name);
-    (0, import_utils.initEnvFile)(name);
-  } else {
-    name = import_node_process.default.cwd();
-  }
   let npmExist = true;
   try {
     await (0, import_execa.default)("npm", ["--version"]);

package/lib/utils.d.ts

@@ -1,4 +1,3 @@
-export declare function initEnvFile(name: string): void;
 export declare function parseEnvironment(): void;
 export declare function guessServePath(): string | false;
 export declare function downloadTar(packageName: string, target: string): Promise<void>;
@@ -15,3 +14,4 @@ export declare class TegoIndexManager {
     private fetchIndexFile;
     getIndex(): Promise<any>;
 }
+export declare function convertEnvToSettings(flatEnv: Record<string, string | undefined>): any;

package/lib/utils.js

@@ -29,9 +29,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var utils_exports = {};
 __export(utils_exports, {
   TegoIndexManager: () => TegoIndexManager,
+  convertEnvToSettings: () => convertEnvToSettings,
   downloadTar: () => downloadTar,
   guessServePath: () => guessServePath,
-  initEnvFile: () => initEnvFile,
   parseEnvironment: () => parseEnvironment
 });
 module.exports = __toCommonJS(utils_exports);
@@ -46,60 +46,16 @@ var import_dotenv = require("dotenv");
 var import_npm_registry_fetch = __toESM(require("npm-registry-fetch"));
 var tar = __toESM(require("tar"));
 var import_constants = require("./constants");
-function initEnvFile(name) {
-  const envPath = (0, import_node_path.resolve)(name, ".env");
-  if (!import_node_fs.default.existsSync(envPath)) {
-    import_node_fs.default.copyFileSync((0, import_node_path.resolve)(__dirname, "../presets/.env.example"), envPath);
-    console.info(".env file created.");
-  } else {
-    console.info(".env file already exists.");
-  }
-}
-__name(initEnvFile, "initEnvFile");
-function parseEnv(name) {
-  if (name === "DB_UNDERSCORED") {
-    if (process.env.DB_UNDERSCORED === "true") {
-      return "true";
-    }
-    if (process.env.DB_UNDERSCORED) {
-      return "true";
-    }
-    return "false";
-  }
-}
-__name(parseEnv, "parseEnv");
 function parseEnvironment() {
   const env = {
-    APP_ENV: "development",
-    APP_KEY: "test-jwt-secret",
-    APP_PORT: 3e3,
-    API_BASE_PATH: "/api/",
-    DB_DIALECT: "sqlite",
-    DB_STORAGE: "storage/db/tachybase.sqlite",
-    DB_TIMEZONE: "+00:00",
-    DB_UNDERSCORED: parseEnv("DB_UNDERSCORED"),
-    DEFAULT_STORAGE_TYPE: "local",
-    RUN_MODE: "engine",
-    LOCAL_STORAGE_DEST: "storage/uploads",
-    PLUGIN_STORAGE_PATH: "storage/plugins",
-    MFSU_AD: "none",
-    WS_PATH: "/ws",
-    SOCKET_PATH: "storage/gateway.sock",
-    PLUGIN_PACKAGE_PREFIX: "@tachybase/plugin-,@tachybase/module-",
-    SERVER_TSCONFIG_PATH: "./tsconfig.server.json",
-    PLAYWRIGHT_AUTH_FILE: "storage/playwright/.auth/admin.json",
-    CACHE_DEFAULT_STORE: "memory",
-    CACHE_MEMORY_MAX: 2e3,
-    PLUGIN_STATICS_PATH: "/static/plugins/",
-    LOGGER_BASE_PATH: "storage/logs",
-    APP_SERVER_BASE_URL: "",
-    APP_PUBLIC_PATH: "/",
     TEGO_HOME: (0, import_node_path.join)(import_node_os.default.homedir(), ".tego"),
     TEGO_RUNTIME_NAME: "current"
   };
-  (0, import_dotenv.config)({
-    path: (0, import_node_path.resolve)(process.cwd(), process.env.APP_ENV_PATH || ".env")
-  });
+  if ((0, import_node_fs.existsSync)((0, import_node_path.resolve)(process.cwd(), ".env"))) {
+    (0, import_dotenv.config)({
+      path: (0, import_node_path.resolve)(process.cwd(), ".env")
+    });
+  }
   if (!process.env.TEGO_RUNTIME_HOME && !process.env.TEGO_RUNTIME_NAME && import_node_fs.default.existsSync((0, import_node_path.resolve)(process.cwd(), "storage"))) {
     process.env.TEGO_RUNTIME_HOME = process.cwd();
   }
@@ -206,7 +162,7 @@ const _TegoIndexManager = class _TegoIndexManager {
   constructor({
     indexUrl,
     baseDir,
-    lastUpdateSuffix = ".last-update-at"
+    lastUpdateSuffix = import_constants.LAST_UPDATE_FILE_SUFFIX
   }) {
     this.indexUrl = indexUrl;
     this.indexFile = (0, import_node_path.join)(baseDir, "index.tego.json");
@@ -242,11 +198,62 @@ const _TegoIndexManager = class _TegoIndexManager {
 };
 __name(_TegoIndexManager, "TegoIndexManager");
 let TegoIndexManager = _TegoIndexManager;
+function convertEnvToSettings(flatEnv) {
+  const settings = {
+    env: {},
+    logger: {},
+    database: {},
+    cache: {},
+    encryptionField: {},
+    presets: {},
+    worker: {},
+    export: {},
+    misc: {}
+  };
+  for (const key in flatEnv) {
+    const value = flatEnv[key];
+    if (value === void 0) continue;
+    if (key.startsWith("LOGGER_")) {
+      const subKey = key.replace("LOGGER_", "").toLowerCase();
+      if (subKey === "transport") {
+        settings.logger.transport = value.split(",").map((x) => x.trim());
+      } else if (subKey === "maxfiles") {
+        settings.logger.maxFiles = value;
+      } else if (subKey === "maxsize") {
+        settings.logger.maxSize = value;
+      } else if (subKey === "format") {
+        settings.logger.format = value;
+      } else {
+        settings.logger[subKey] = value;
+      }
+      continue;
+    }
+    if (key.startsWith("DB_")) {
+      const subKey = key.replace("DB_", "").toLowerCase();
+      if (subKey.startsWith("dialect_options_ssl_")) {
+        const sslKey = subKey.replace("dialect_options_ssl_", "");
+        settings.database.ssl = settings.database.ssl || {};
+        settings.database.ssl[sslKey] = value;
+      } else {
+        settings.database[subKey] = value;
+      }
+      continue;
+    }
+    if (key.startsWith("CACHE_")) {
+      const subKey = key.replace("CACHE_", "").toLowerCase();
+      settings.cache[subKey] = value;
+      continue;
+    }
+    settings.env[key] = value;
+  }
+  return settings;
+}
+__name(convertEnvToSettings, "convertEnvToSettings");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TegoIndexManager,
+  convertEnvToSettings,
   downloadTar,
   guessServePath,
-  initEnvFile,
   parseEnvironment
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tego",
-  "version": "1.3.52",
+  "version": "1.3.54",
   "description": "",
   "keywords": [
     "tego",
@@ -24,7 +24,7 @@
   "dependencies": {
     "@koa/cors": "5.0.0",
     "@koa/multer": "3.1.0",
-    "@socketregistry/yocto-spinner": "1.0.20",
+    "@socketregistry/yocto-spinner": "1.0.23",
     "async-mutex": "0.5.0",
     "axios": "0.29.0",
     "cache-manager": "5.7.6",
@@ -35,39 +35,39 @@
     "execa": "^5.1.1",
     "i18next": "23.16.8",
     "jsonwebtoken": "8.5.1",
-    "koa": "^2.16.1",
+    "koa": "^2.16.2",
     "koa-bodyparser": "4.4.1",
     "lodash": "4.17.21",
     "multer": "2.0.2",
-    "mysql2": "3.14.3",
+    "mysql2": "3.14.4",
     "npm-registry-fetch": "19.0.0",
     "pg": "^8.16.3",
     "react": "18.3.1",
     "sequelize": "6.37.7",
     "sqlite3": "5.1.7",
-    "tar": "7.4.3",
+    "tar": "7.5.1",
     "umzug": "3.8.2",
     "winston": "3.17.0",
     "winston-daily-rotate-file": "^5.0.0",
-    "@tachybase/actions": "1.3.52",
-    "@tachybase/cache": "1.3.52",
-    "@tachybase/auth": "1.3.52",
-    "@tachybase/acl": "1.3.52",
-    "@tachybase/database": "1.3.52",
-    "@tachybase/evaluators": "1.3.52",
-    "@tachybase/loader": "1.3.52",
-    "@tachybase/globals": "1.3.52",
-    "@tachybase/data-source": "1.3.52",
-    "@tachybase/logger": "1.3.52",
-    "@tachybase/resourcer": "1.3.52",
-    "@tachybase/schema": "1.3.52",
-    "@tachybase/utils": "1.3.52",
-    "@tego/server": "1.3.52",
-    "@tego/core": "1.3.52"
+    "@tachybase/acl": "1.3.54",
+    "@tachybase/actions": "1.3.54",
+    "@tachybase/auth": "1.3.54",
+    "@tachybase/data-source": "1.3.54",
+    "@tachybase/cache": "1.3.54",
+    "@tachybase/database": "1.3.54",
+    "@tachybase/evaluators": "1.3.54",
+    "@tachybase/globals": "1.3.54",
+    "@tachybase/logger": "1.3.54",
+    "@tachybase/resourcer": "1.3.54",
+    "@tachybase/loader": "1.3.54",
+    "@tachybase/schema": "1.3.54",
+    "@tego/server": "1.3.54",
+    "@tego/core": "1.3.54",
+    "@tachybase/utils": "1.3.54"
   },
   "devDependencies": {
     "@types/lodash": "4.17.20",
-    "@yao-pkg/pkg": "6.5.1"
+    "@yao-pkg/pkg": "6.6.0"
   },
   "pkg": {
     "targets": [

package/presets/settings.js

@@ -0,0 +1,293 @@
+/** @type {import('@tachybase/globals').Settings} */
+module.exports = {
+  /**
+   * 如果对应的环境变量没设置，则使用这里面的值，如果有设置，不用这里的值
+   */
+  env: {
+    APP_ENV: 'development',
+    APP_PORT: 3000,
+    APP_KEY: 'test-key',
+    API_BASE_PATH: '/api/',
+    INIT_APP_LANG: 'en-US',
+    INIT_ROOT_EMAIL: 'admin@tachybase.com',
+    INIT_ROOT_USERNAME: 'tego',
+    INIT_ROOT_PASSWORD: 'tego',
+    INIT_ROOT_NICKNAME: 'Admin',
+    PLUGIN_STORAGE_PATH: 'storage/plugins',
+    WS_PATH: '/ws',
+    SOCKET_PATH: 'storage/gateway.sock',
+    PLUGIN_PACKAGE_PREFIX: '@tachybase/plugin-,@tachybase/module-',
+    SERVER_TSCONFIG_PATH: './tsconfig.server.json',
+    PLAYWRIGHT_AUTH_FILE: 'storage/playwright/.auth/admin.json',
+    PLUGIN_STATICS_PATH: '/static/plugins/',
+    APP_SERVER_BASE_URL: '',
+    APP_PUBLIC_PATH: '/',
+    // 开发环境测试locale 强制使用 cache
+    // FORCE_LOCALE_CACHE: '1',
+  },
+  logger: {
+    /**
+     *  console | file | dailyRotateFile
+     */
+    transport: ['console', 'dailyRotateFile'],
+
+    /**
+     *
+     */
+    basePath: 'storage/logs',
+    /**
+     *
+     *  error | warn | info | debug
+     * /
+    // level: 'warn',
+
+    /**
+     * If LOGGER_TRANSPORT is dailyRotateFile and using days, add 'd' as the suffix.
+     */
+    // maxFiles: '14d',
+
+    /**
+     * add 'k', 'm', 'g' as the suffix.
+     */
+    // maxSize: '10m',
+
+    /**
+     * json | splitter, split by '|' character
+     */
+    // format: '',
+  },
+
+  database: {
+    /**
+     *
+     */
+    dialect: 'sqlite',
+
+    /**
+     *
+     */
+    storage: 'storage/db/tego.sqlite',
+
+    /**
+     *
+     */
+    // tablePrefix: ''
+
+    /**
+     *
+     */
+    // host: 'localhost'
+
+    /**
+     *
+     */
+    // port: 5432,
+
+    /**
+     *
+     */
+    // database: 'tego',
+
+    /**
+     *
+     */
+    // user: 'tego',
+
+    /**
+     *
+     */
+    // password: 'tego',
+
+    /**
+     *
+     */
+    // logging: true,
+
+    /**
+     *
+     */
+    underscored: false,
+
+    /**
+     * mysql/postgres
+     */
+    timezone: '+00:00',
+
+    /**
+     * ssl config
+     */
+    ssl: {
+      // ca: '',
+      // key: '',
+      // cert: '',
+      // rejectUnauthorized: true,
+    },
+  },
+
+  cache: {
+    /**
+     *
+     */
+    defaultStore: 'memory',
+
+    /**
+     * max number of items in memory cache
+     */
+    memoryMax: 2000,
+
+    /**
+     *
+     */
+    // redisUrl: ''
+  },
+
+  encryptionField: {
+    /**
+     *
+     */
+    // key: '',
+  },
+
+  presets: {
+    /**
+     * 默认启用，并且不可删除
+     */
+    builtinPlugins: [
+      'acl',
+      'app-info',
+      'auth',
+      'backup',
+      'cloud-component',
+      'collection',
+      'cron',
+      'data-source',
+      'error-handler',
+      'event-source',
+      'file',
+      'workflow',
+      'message',
+      'pdf',
+      'ui-schema',
+      'user',
+      'web',
+      'worker-thread',
+      'env-secrets',
+    ],
+    /**
+     * 可删除
+     */
+    externalPlugins: [
+      { name: 'action-bulk-edit', enabledByDefault: true },
+      { name: 'action-bulk-update', enabledByDefault: true },
+      { name: 'action-custom-request', enabledByDefault: true },
+      { name: 'action-duplicate', enabledByDefault: true },
+      { name: 'action-export', enabledByDefault: true },
+      { name: 'action-import', enabledByDefault: true },
+      { name: 'action-print', enabledByDefault: true },
+      { name: 'block-calendar', enabledByDefault: true },
+      { name: 'block-charts', enabledByDefault: true },
+      { name: 'block-gantt', enabledByDefault: true },
+      { name: 'block-kanban', enabledByDefault: true },
+      { name: 'block-presentation', enabledByDefault: true },
+      { name: 'field-china-region', enabledByDefault: true },
+      { name: 'field-formula', enabledByDefault: true },
+      { name: 'field-sequence', enabledByDefault: true },
+      { name: 'field-encryption', enabledByDefault: true },
+      { name: 'log-viewer', enabledByDefault: true },
+      { name: 'otp', enabledByDefault: true },
+      { name: 'instrumentation', enabledByDefault: true },
+      { name: 'full-text-search', enabledByDefault: true },
+      { name: 'password-policy', enabledByDefault: true },
+      { name: 'auth-pages', enabledByDefault: true },
+      { name: 'manual-notification', enabledByDefault: true },
+      { name: 'auth-main-app', enabledByDefault: true },
+
+      { name: 'adapter-bullmq', enabledByDefault: false },
+      { name: 'adapter-red-node', enabledByDefault: false },
+      { name: 'adapter-remix', enabledByDefault: false },
+      { name: 'api-keys', enabledByDefault: false },
+      { name: 'audit-logs', enabledByDefault: false },
+      { name: 'auth-cas', enabledByDefault: false },
+      { name: 'auth-dingtalk', enabledByDefault: false },
+      { name: 'auth-lark', enabledByDefault: false },
+      { name: 'auth-oidc', enabledByDefault: false },
+      { name: 'auth-saml', enabledByDefault: false },
+      { name: 'auth-sms', enabledByDefault: false },
+      { name: 'auth-wechat', enabledByDefault: false },
+      { name: 'auth-wecom', enabledByDefault: false },
+      { name: 'block-comments', enabledByDefault: false },
+      { name: 'block-map', enabledByDefault: false },
+      { name: 'block-step-form', enabledByDefault: false },
+      { name: 'data-source-common', enabledByDefault: false },
+      { name: 'demos-game-runesweeper', enabledByDefault: false },
+      { name: 'devtools', enabledByDefault: false },
+      { name: 'field-markdown-vditor', enabledByDefault: false },
+      { name: 'field-snapshot', enabledByDefault: false },
+      { name: 'hera', enabledByDefault: false },
+      { name: 'i18n-editor', enabledByDefault: false },
+      { name: 'multi-app', enabledByDefault: false },
+      { name: 'multi-app-share-collection', enabledByDefault: false },
+      { name: 'online-user', enabledByDefault: false },
+      { name: 'simple-cms', enabledByDefault: false },
+      { name: 'sub-accounts', enabledByDefault: false },
+      { name: 'theme-editor', enabledByDefault: false },
+      { name: 'workflow-approval', enabledByDefault: false },
+      { name: 'ai-chat', enabledByDefault: false },
+      { name: 'department', enabledByDefault: false },
+      { name: 'workflow-analysis', enabledByDefault: false },
+      { name: 'api-logs', enabledByDefault: false },
+      { name: 'ocr-convert', enabledByDefault: false },
+      { name: 'text-copy', enabledByDefault: false },
+      { name: 'user-manual-feishu', enabledByDefault: false },
+      { name: 'form-design', enabledByDefault: false },
+    ],
+
+    /**
+     *
+     */
+    runtimePlugins: [],
+  },
+
+  worker: {
+    /**
+     * -1 为不限制，自动设置为核心数量
+     * 0 禁用 worker
+     * 其他值为 worker 数量
+     */
+    count: -1,
+
+    /**
+     * -1 为最大为核心数量
+     * 其他值为最大 worker 数量
+     */
+    countMax: -1,
+
+    /**
+     * 错误尝试次数
+     */
+    // errorRetry: 3
+
+    /**
+     * MB
+     */
+    // maxMemory: 4096
+  },
+
+  /**
+   * export config, max length of export data to use main thread and page size in worker thread
+   */
+  export: {
+    /**
+     *
+     */
+    // lengthMax: 2000,
+    /**
+     *
+     */
+    // workerPageSize: 1000
+  },
+
+  misc: {
+    forbidSubAppPlugins: ['multi-app', 'manual-notification', 'multi-app-share-collection'],
+  },
+};

package/src/__tests__/utils.test.ts

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+
+import { convertEnvToSettings } from '../utils';
+
+describe('convertEnvToSettings', () => {
+  it('should convert flat env into structured settings object', () => {
+    const input = {
+      LOGGER_TRANSPORT: 'console,dailyRotateFile',
+      LOGGER_MAX_FILES: '7d',
+      DB_STORAGE: 'storage/db/tachybase.sqlite',
+      CACHE_DEFAULT_STORE: 'memory',
+      INIT_APP_LANG: 'zh-CN',
+    };
+
+    const result = convertEnvToSettings(input as any);
+
+    expect(result.logger.transport).toEqual(['console', 'dailyRotateFile']);
+    expect(result.logger.max_files).toBeUndefined(); // 未提供
+    expect(result.logger.maxFiles).toBe('7d');
+    expect(result.database.storage).toBe('storage/db/tachybase.sqlite');
+    expect(result.cache.default_store).toBe('memory');
+    expect(result.env.INIT_APP_LANG).toBe('zh-CN');
+  });
+});

package/src/config.ts

@@ -1,4 +1,5 @@
 import { parseDatabaseOptionsFromEnv } from '@tachybase/database';
+import TachybaseGlobal from '@tachybase/globals';
 import { getLoggerLevel, getLoggerTransport } from '@tachybase/logger';
 
 export async function getConfig() {
@@ -11,16 +12,16 @@ export async function getConfig() {
     },
     plugins: ['tachybase'],
     cacheManager: {
-      defaultStore: process.env.CACHE_DEFAULT_STORE || 'memory',
+      defaultStore: TachybaseGlobal.settings.cache.defaultStore ?? 'memory',
       stores: {
         memory: {
           store: 'memory',
-          max: parseInt(process.env.CACHE_MEMORY_MAX) || 2000,
+          max: TachybaseGlobal.settings.cache.memoryMax ?? 2000,
         },
-        ...(process.env.CACHE_REDIS_URL
+        ...(TachybaseGlobal.settings.cache.redisUrl
           ? {
               redis: {
-                url: process.env.CACHE_REDIS_URL,
+                url: TachybaseGlobal.settings.cache.redisUrl,
               },
             }
           : {}),

package/src/constants.ts

@@ -1,10 +1,25 @@
+import fs from 'node:fs';
 import path from 'node:path';
+import TachybaseGlobal from '@tachybase/globals';
 
 import { parseEnvironment } from './utils';
 
 // 解析环境变量
 parseEnvironment();
 
+// 读取配置
+if (!fs.existsSync(`${process.env.TEGO_RUNTIME_HOME}/settings.js`)) {
+  fs.mkdirSync(`${process.env.TEGO_RUNTIME_HOME}`, { recursive: true });
+  fs.copyFileSync(path.join(__dirname, '../presets/settings.js'), `${process.env.TEGO_RUNTIME_HOME}/settings.js`);
+}
+TachybaseGlobal.settings = require(`${process.env.TEGO_RUNTIME_HOME}/settings.js`);
+
+for (const key in TachybaseGlobal.settings.env) {
+  if (!process.env[key]) {
+    process.env[key] = TachybaseGlobal.settings.env[key];
+  }
+}
+
 export const DEFAULT_DEV_PLUGINS_PATH = path.join(process.env.TEGO_RUNTIME_HOME, 'plugins', 'dev');
 export const DEFAULT_REMOTE_PLUGINS_PATH = path.join(process.env.TEGO_RUNTIME_HOME, 'plugins', 'remote');
 export const DEFAULT_BUILTIN_PLUGINS_PATH = path.join(process.env.TEGO_RUNTIME_HOME, 'plugins', 'builtin');

package/src/plugin-presets.ts

@@ -1,41 +1,35 @@
+import TachybaseGlobal from '@tachybase/globals';
 import { Plugin, PluginManager } from '@tego/core';
+
 import _ from 'lodash';
 
 export class PluginPresets extends Plugin {
-  splitNames(name: string) {
-    return (name || '').split(',').filter(Boolean);
-  }
-
   getBuiltInPlugins() {
-    const { PRESETS_BULTIN_PLUGINS } = process.env;
-    if (!PRESETS_BULTIN_PLUGINS) {
+    if (!TachybaseGlobal.settings.presets.builtinPlugins) {
       throw new Error(
-        'PRESETS_BUILTIN_PLUGINS is not defined! Please refer to the .env.example file for the correct configuration.',
+        'presets.builtinPlugins is not defined! Please refer to the settings.js file for the correct configuration.',
       );
     }
-    const [installedPlugins] = this.parseNames(PRESETS_BULTIN_PLUGINS);
-    return installedPlugins;
-  }
-
-  parseNames(plugins: string) {
-    const installedPlugins = this.splitNames(plugins).filter((name) => !name.startsWith('!'));
-    const disabledPlugins = this.splitNames(plugins)
-      .filter((name) => name.startsWith('!'))
-      .map((name) => name.slice(1));
-
-    return [installedPlugins, disabledPlugins];
+    return TachybaseGlobal.settings.presets.builtinPlugins;
   }
 
   getExternalPlugins() {
-    const { PRESETS_EXTERNAL_PLUGINS } = process.env;
-    if (!PRESETS_EXTERNAL_PLUGINS) {
+    if (!TachybaseGlobal.settings.presets.externalPlugins) {
       throw new Error(
-        'PRESETS_EXTERNAL_PLUGINS is not defined! Please refer to the .env.example file for the correct configuration.',
+        'presets.externalPlugins is not defined! Please refer to the settings.js file for the correct configuration.',
       );
     }
-    const [installedPlugins, disabledPlugins] = this.parseNames(PRESETS_EXTERNAL_PLUGINS);
-
-    return { installedPlugins, disabledPlugins };
+    return TachybaseGlobal.settings.presets.externalPlugins.reduce(
+      (acc, cur) => {
+        if (cur.enabledByDefault) {
+          acc.installedPlugins.push(cur.name);
+        } else {
+          acc.disabledPlugins.push(cur.name);
+        }
+        return acc;
+      },
+      { installedPlugins: [] as string[], disabledPlugins: [] as string[] },
+    );
   }
 
   async getPackageJson(name) {
@@ -189,8 +183,7 @@ export class PluginPresets extends Plugin {
     if (this.app.name === 'main') {
       return [];
     }
-    const { FORBID_SUB_APP_PLUGINS } = process.env;
-    return FORBID_SUB_APP_PLUGINS ? FORBID_SUB_APP_PLUGINS.split(',') : [];
+    return TachybaseGlobal.settings.misc.forbidSubAppPlugins;
   }
   // 从环境变量读取禁止子应用装载的插件
   async forbidSubAppPlugin() {

package/src/prepare.ts

@@ -5,13 +5,8 @@ import process from 'node:process';
 import yoctoSpinner from '@socketregistry/yocto-spinner/index.cjs';
 import execa from 'execa';
 
-import {
-  DEFAULT_BUILTIN_PLUGINS_PATH,
-  DEFAULT_WEB_PACKAGE_NAME,
-  INDEX_TEGO_URL,
-  LAST_UPDATE_FILE_SUFFIX,
-} from './constants';
-import { downloadTar, initEnvFile, TegoIndexManager } from './utils';
+import { DEFAULT_BUILTIN_PLUGINS_PATH, DEFAULT_WEB_PACKAGE_NAME, INDEX_TEGO_URL } from './constants';
+import { downloadTar, TegoIndexManager } from './utils';
 
 export async function prepare({
   name,
@@ -22,17 +17,6 @@ export async function prepare({
   plugins: string[];
   init?: boolean;
 }) {
-  if (init) {
-    if (fs.existsSync(name)) {
-      console.log(`project folder ${name} already exists, exit now.`);
-      return;
-    }
-    fs.mkdirSync(name);
-    initEnvFile(name);
-  } else {
-    name = process.cwd();
-  }
-
   let npmExist = true;
   // 判断 npm 是否存在
   try {

package/src/utils.ts

@@ -15,64 +15,22 @@ import { config } from 'dotenv';
 import npmRegistryFetch from 'npm-registry-fetch';
 import * as tar from 'tar';
 
-import { DEFAULT_WEB_PACKAGE_NAME, INDEX_TEGO_URL, LAST_UPDATE_FILE_SUFFIX } from './constants';
-
-export function initEnvFile(name: string) {
-  const envPath = resolve(name, '.env');
-  if (!fs.existsSync(envPath)) {
-    fs.copyFileSync(resolve(__dirname, '../presets/.env.example'), envPath);
-    console.info('.env file created.');
-  } else {
-    console.info('.env file already exists.');
-  }
-}
-
-function parseEnv(name: string) {
-  if (name === 'DB_UNDERSCORED') {
-    if (process.env.DB_UNDERSCORED === 'true') {
-      return 'true';
-    }
-    if (process.env.DB_UNDERSCORED) {
-      return 'true';
-    }
-    return 'false';
-  }
-}
+import { DEFAULT_WEB_PACKAGE_NAME, LAST_UPDATE_FILE_SUFFIX } from './constants';
 
 export function parseEnvironment() {
   const env = {
-    APP_ENV: 'development',
-    APP_KEY: 'test-jwt-secret',
-    APP_PORT: 3000,
-    API_BASE_PATH: '/api/',
-    DB_DIALECT: 'sqlite',
-    DB_STORAGE: 'storage/db/tachybase.sqlite',
-    DB_TIMEZONE: '+00:00',
-    DB_UNDERSCORED: parseEnv('DB_UNDERSCORED'),
-    DEFAULT_STORAGE_TYPE: 'local',
-    RUN_MODE: 'engine',
-    LOCAL_STORAGE_DEST: 'storage/uploads',
-    PLUGIN_STORAGE_PATH: 'storage/plugins',
-    MFSU_AD: 'none',
-    WS_PATH: '/ws',
-    SOCKET_PATH: 'storage/gateway.sock',
-    PLUGIN_PACKAGE_PREFIX: '@tachybase/plugin-,@tachybase/module-',
-    SERVER_TSCONFIG_PATH: './tsconfig.server.json',
-    PLAYWRIGHT_AUTH_FILE: 'storage/playwright/.auth/admin.json',
-    CACHE_DEFAULT_STORE: 'memory',
-    CACHE_MEMORY_MAX: 2000,
-    PLUGIN_STATICS_PATH: '/static/plugins/',
-    LOGGER_BASE_PATH: 'storage/logs',
-    APP_SERVER_BASE_URL: '',
-    APP_PUBLIC_PATH: '/',
     TEGO_HOME: join(os.homedir(), '.tego'),
     TEGO_RUNTIME_NAME: 'current',
   };
 
-  config({
-    path: resolve(process.cwd(), process.env.APP_ENV_PATH || '.env'),
-  });
+  // 允许 .env 不存在
+  if (_existsSync(resolve(process.cwd(), '.env'))) {
+    config({
+      path: resolve(process.cwd(), '.env'),
+    });
+  }
 
+  // 如果存在 storage 的话，TEGO_RUNTIME_HOME 默认指向当前路径
   if (
     !process.env.TEGO_RUNTIME_HOME &&
     !process.env.TEGO_RUNTIME_NAME &&
@@ -87,6 +45,7 @@ export function parseEnvironment() {
     }
   }
 
+  // 如果 TEGO_RUNTIME_HOME 还未设置，那就设置为 TEGO_HOME/TEGO_RUNTIME_NAME
   if (!process.env.TEGO_RUNTIME_HOME) {
     process.env.TEGO_RUNTIME_HOME = join(process.env.TEGO_HOME!, process.env.TEGO_RUNTIME_NAME!);
   }
@@ -205,7 +164,7 @@ export class TegoIndexManager {
   constructor({
     indexUrl,
     baseDir,
-    lastUpdateSuffix = '.last-update-at',
+    lastUpdateSuffix = LAST_UPDATE_FILE_SUFFIX,
   }: {
     indexUrl: string;
     baseDir: string;
@@ -248,3 +207,65 @@ export class TegoIndexManager {
     return await this.fetchIndexFile();
   }
 }
+
+export function convertEnvToSettings(flatEnv: Record<string, string | undefined>) {
+  const settings: any = {
+    env: {},
+    logger: {},
+    database: {},
+    cache: {},
+    encryptionField: {},
+    presets: {},
+    worker: {},
+    export: {},
+    misc: {},
+  };
+
+  // LOGGER_
+  for (const key in flatEnv) {
+    const value = flatEnv[key];
+    if (value === undefined) continue;
+
+    if (key.startsWith('LOGGER_')) {
+      const subKey = key.replace('LOGGER_', '').toLowerCase();
+      if (subKey === 'transport') {
+        settings.logger.transport = value.split(',').map((x) => x.trim());
+      } else if (subKey === 'maxfiles') {
+        settings.logger.maxFiles = value;
+      } else if (subKey === 'maxsize') {
+        settings.logger.maxSize = value;
+      } else if (subKey === 'format') {
+        settings.logger.format = value;
+      } else {
+        settings.logger[subKey] = value;
+      }
+      continue;
+    }
+
+    // DB_
+    if (key.startsWith('DB_')) {
+      const subKey = key.replace('DB_', '').toLowerCase();
+      if (subKey.startsWith('dialect_options_ssl_')) {
+        // e.g. DB_DIALECT_OPTIONS_SSL_CA
+        const sslKey = subKey.replace('dialect_options_ssl_', '');
+        settings.database.ssl = settings.database.ssl || {};
+        settings.database.ssl[sslKey] = value;
+      } else {
+        settings.database[subKey] = value;
+      }
+      continue;
+    }
+
+    // CACHE_
+    if (key.startsWith('CACHE_')) {
+      const subKey = key.replace('CACHE_', '').toLowerCase();
+      settings.cache[subKey] = value;
+      continue;
+    }
+
+    // 其它 => 默认归到 settings.env
+    settings.env[key] = value;
+  }
+
+  return settings;
+}

package/presets/.env.example

@@ -1,105 +0,0 @@
-################# TACHYBASE APPLICATION #################
-APP_ENV=development
-APP_PORT=3000
-APP_KEY=test-key
-
-# 默认为 ~/.tego
-TEGO_HOME=
-# 默认为 current
-TEGO_RUNTIME_NAME=
-# 默认为 ~/.tego/current，设置后会覆盖 TEGO_RUNTIME_NAME
-TEGO_RUNTIME_HOME=
-
-# experimental support
-EXTENSION_UI_BASE_PATH=/adapters/
-
-API_BASE_PATH=/api/
-API_BASE_URL=
-
-# console | file | dailyRotateFile
-LOGGER_TRANSPORT=
-LOGGER_BASE_PATH=storage/logs
-# error | warn | info | debug
-LOGGER_LEVEL=
-# If LOGGER_TRANSPORT is dailyRotateFile and using days, add 'd' as the suffix.
-LOGGER_MAX_FILES=
-# add 'k', 'm', 'g' as the suffix.
-LOGGER_MAX_SIZE=
-# json | splitter, split by '|' character
-LOGGER_FORMAT=
-
-################# DATABASE #################
-
-DB_DIALECT=sqlite
-DB_STORAGE=storage/db/tachybase.sqlite
-DB_TABLE_PREFIX=
-# DB_HOST=localhost
-# DB_PORT=5432
-# DB_DATABASE=postgres
-# DB_USER=tachybase
-# DB_PASSWORD=tachybase
-# DB_LOGGING=on
-# DB_UNDERSCORED=false
-
-#== SSL CONFIG ==#
-# DB_DIALECT_OPTIONS_SSL_CA=
-# DB_DIALECT_OPTIONS_SSL_KEY=
-# DB_DIALECT_OPTIONS_SSL_CERT=
-# DB_DIALECT_OPTIONS_SSL_REJECT_UNAUTHORIZED=true
-
-################# CACHE #################
-CACHE_DEFAULT_STORE=memory
-# max number of items in memory cache
-CACHE_MEMORY_MAX=2000
-# CACHE_REDIS_URL=
-
-################# STORAGE (Initialization only) #################
-
-INIT_APP_LANG=zh-CN
-INIT_ROOT_EMAIL=admin@tachybase.com
-INIT_ROOT_PASSWORD=!Admin123.
-INIT_ROOT_NICKNAME=Super Admin
-INIT_ROOT_USERNAME=tachybase
-
-################# ENCRYPTION FIELD #################
-
-ENCRYPTION_FIELD_KEY=
-
-##### PRESETS #####
-
-# Built-in plugins: Enabled by default.
-# When the plugin list is updated, any plugins no longer in the list will be removed,（TODO）
-# and newly added plugins will be included to stay aligned with the latest configuration.
-PRESETS_BULTIN_PLUGINS=acl,app-info,auth,backup,cloud-component,collection,cron,data-source,error-handler,event-source,file,workflow,message,pdf,ui-schema,user,web,worker-thread,env-secrets
-# External plugins: Enabled by default.
-# Prefixing a plugin name with ! marks it as disabled.
-# When the plugin list is updated, only newly added plugins will be included;
-# existing plugin states will remain unchanged.
-PRESETS_EXTERNAL_PLUGINS=action-bulk-edit,action-bulk-update,action-custom-request,action-duplicate,action-export,action-import,action-print,block-calendar,block-charts,block-gantt,block-kanban,block-presentation,field-china-region,field-formula,field-sequence,field-encryption,log-viewer,otp,instrumentation,full-text-search,password-policy,auth-pages,manual-notification,auth-main-app,!adapter-bullmq,!adapter-red-node,!adapter-remix,!api-keys,!audit-logs,!auth-cas,!auth-dingtalk,!auth-lark,!auth-oidc,!auth-saml,!auth-sms,!auth-wechat,!auth-wecom,!block-comments,!block-map,!block-step-form,!data-source-common,!demos-game-runesweeper,!devtools,!field-markdown-vditor,!field-snapshot,!hera,!i18n-editor,!multi-app,!multi-app-share-collection,!online-user,!simple-cms,!sub-accounts,!theme-editor,!workflow-approval,!ai-chat,!department,!workflow-analysis,!api-logs,!ocr-convert,!text-copy,!user-manual-feishu
-# Runtime plugins: Not persisted to the database and are loaded with the highest priority among all plugins.
-# RUNTIME_PLUGINS=
-
-# 主应用工作线程默认数量
-WORKER_COUNT=0
-# WORKER_TIMEOUT=1800
-# 主应用工作线程最大数量
-WORKER_COUNT_MAX=8
-# WORKER_ERROR_RETRY=3
-# 子应用工作线程默认数量
-WORKER_COUNT_SUB=0
-# 子应用工作线程最大数量
-WORKER_COUNT_MAX_SUB=1
-
-# export config, max length of export data to use main thread and page size in worker thread
-# EXPORT_LENGTH_MAX=2000
-# EXPORT_WORKER_PAGESIZE=1000
-
-# 开发环境测试locale 强制使用 cache
-#FORCE_LOCALE_CACHE=1
-
-# 禁止子应用装载的插件，多个用逗号分隔
-# FORBID_SUB_APP_PLUGINS=multi-app,manual-notification,multi-app-share-collection
-
-
-# 工作线程最大内存，单位为MB
-# WORKER_MAX_MEMORY=4096