@rainynest/ext 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,27 @@
-# Temporary Holding Version
+# @rainynest/ext
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+RainyNest 插件/主题开发 CLI。
+
+## 快速开始
+
+```bash
+npm create rainynest-ext my-plugin   # 生成插件工程（推荐）
+cd my-plugin && npm install
+npm run dev                          # 联调热更新
+npm run pack                         # 产出发布包
+```
+
+## 命令
+
+| 命令 | 作用 |
+|---|---|
+| `ext new plugin\|theme <名称>` | 在当前目录生成模板工程 |
+| `ext build <目录> -o dist` | esbuild 编译 → 安装态产物 |
+| `ext build-all --src . --out ../scripts` | 全量编译多扩展目录 |
+| `ext pack <目录> [--format zip\|gz]` | 打发布包（`.zip.rainy-plugin` / `.gz.rainy-theme`） |
+| `ext dev <目录> --site <url>` | watch 编译 + 热更新（需 `EXT_DEV_TOKEN`） |
+
+## 说明
+
+- 类型定义请安装 `@rainynest/plugin-types`
+- 插件/主题包上传到 RainyNest 后台「系统 → 插件 / 主题」即可安装

package/bin/ext.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+// tools/ext-cli/bin/ext.js — RainyNest 扩展 CLI
+// 用法：
+//   ext new plugin <name>              生成插件模板工程
+//   ext new theme <name>               生成主题模板工程
+//   ext build <srcDir> [-o outDir]     编译单个扩展为安装态产物
+//   ext build-all --src packages --out scripts   批量编译（内置包迁移用）
+//   ext pack <builtDir> [--format zip|gz] [-o dist]   打包发布产物 *.zip.rainy-plugin 等
+//   ext dev <srcDir> [--site url]      watch + 热更新上传（管理 token）
+const fs = require('node:fs');
+const path = require('node:path');
+
+const { buildOne } = require('../lib/bundle');
+const { validateManifest, scanArtifacts } = require('../lib/validate');
+const { pack } = require('../lib/pack');
+
+function fail(msg) {
+  console.error('[ext] ✗ ' + msg);
+  process.exit(1);
+}
+
+function parseArgs(argv) {
+  const args = { _: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith('--')) {
+      const key = a.slice(2);
+      const next = argv[i + 1];
+      if (next !== undefined && !next.startsWith('--')) { args[key] = next; i++; }
+      else args[key] = true;
+    } else if (a === '-o') {
+      args.out = argv[++i];
+    } else {
+      args._.push(a);
+    }
+  }
+  return args;
+}
+
+// ─── ext new ───
+function cmdNew(args) {
+  const kind = args._[1]; // plugin | theme
+  const name = args._[2];
+  if (!['plugin', 'theme'].includes(kind)) fail('用法: ext new plugin|theme <名称>');
+  if (!name || !/^[a-z0-9][a-z0-9-]*$/.test(name)) fail('名称只允许小写字母/数字/连字符');
+
+  const tplDir = path.join(__dirname, '..', 'templates', kind);
+  const dest = path.join(process.cwd(), name);
+  if (fs.existsSync(dest)) fail(`目录已存在: ${dest}`);
+
+  fs.mkdirSync(dest, { recursive: true });
+  copyTpl(tplDir, dest, name);
+  console.log(`[ext] ✓ 已生成${kind === 'plugin' ? '插件' : '主题'}模板: ${dest}`);
+  console.log('  下一步: 修改清单与 src/ 源码 → ext build ' + name + ' -o dist');
+}
+
+function copyTpl(src, dest, name) {
+  for (const item of fs.readdirSync(src)) {
+    const s = path.join(src, item);
+    const d = path.join(dest, item);
+    if (fs.statSync(s).isDirectory()) { fs.mkdirSync(d, { recursive: true }); copyTpl(s, d, name); continue; }
+    let content = fs.readFileSync(s, 'utf-8').replace(/__SLUG__/g, name);
+    fs.writeFileSync(d, content);
+  }
+}
+
+// ─── ext build ───
+function cmdBuild(args) {
+  const srcDir = path.resolve(args._[1] || '.');
+  const outDir = path.resolve(args.out || path.join(process.cwd(), 'dist'));
+  const check = validateManifest(srcDir);
+  if (check.errors.length) fail(check.errors.join('; '));
+  for (const w of check.warnings) console.warn('[ext] ! ' + w);
+
+  const built = buildOne(srcDir, outDir);
+  const artifactErrors = scanArtifacts(outDir);
+  if (artifactErrors.length) fail(artifactErrors.join('; '));
+
+  console.log(`[ext] ✓ ${check.kind}「${check.manifest.slug}」→ ${outDir}  [${built.join(', ')}]`);
+}
+
+// ─── ext build-all ───
+function cmdBuildAll(args) {
+  const srcRoot = path.resolve(args.src || 'packages');
+  const outRoot = path.resolve(args.out || 'scripts');
+  if (!fs.existsSync(srcRoot)) fail(`源码目录不存在: ${srcRoot}`);
+
+  let total = 0;
+  for (const kind of ['plugins', 'themes']) {
+    const srcDir = path.join(srcRoot, kind);
+    if (!fs.existsSync(srcDir)) continue;
+    for (const slug of fs.readdirSync(srcDir)) {
+      const dir = path.join(srcDir, slug);
+      if (!fs.statSync(dir).isDirectory()) continue;
+      const check = validateManifest(dir);
+      if (check.errors.length) { console.error(`[ext] ✗ ${slug}: ${check.errors.join('; ')}`); continue; }
+      const built = buildOne(dir, path.join(outRoot, kind, slug));
+      const errs = scanArtifacts(path.join(outRoot, kind, slug));
+      if (errs.length) { console.error(`[ext] ✗ ${slug}: ${errs.join('; ')}`); continue; }
+      console.log(`[ext] ✓ ${kind}/${slug}  [${built.join(', ') || '静态复制'}]`);
+      total++;
+    }
+  }
+  console.log(`[ext] ✓ 共 ${total} 个扩展已编译到 ${outRoot}`);
+}
+
+// ─── ext pack ───
+function cmdPack(args) {
+  const dir = path.resolve(args._[1] || '.');
+  const check = validateManifest(dir);
+  if (check.errors.length) fail(check.errors.join('; '));
+  // 默认格式：插件 zip、主题 gz（用户决策），--format 可覆盖
+  const format = args.format ? (args.format === 'gz' ? 'gz' : 'zip') : (check.kind === 'theme' ? 'gz' : 'zip');
+  const outDir = path.resolve(args.out || path.join(process.cwd(), 'dist'));
+  const file = pack(dir, check.kind, format, outDir);
+  console.log(`[ext] ✓ ${path.basename(file)}  (${(fs.statSync(file).size / 1024).toFixed(1)} KB)`);
+}
+
+// ─── ext dev ───
+async function cmdDev(args) {
+  const srcDir = path.resolve(args._[1] || '.');
+  const site = args.site || process.env.EXT_SITE || 'http://localhost:3000';
+  let token = args.token || process.env.EXT_DEV_TOKEN;
+  // 未显式给 token 时，尝试从主项目 .env 读取（向上找两级）
+  if (!token) {
+    for (const dir of [process.cwd(), path.dirname(process.cwd())]) {
+      const envFile = path.join(dir, '.env');
+      if (!fs.existsSync(envFile)) continue;
+      const m = fs.readFileSync(envFile, 'utf-8').match(/^EXT_DEV_TOKEN\s*=\s*"?([^"\r\n]+)"?/m);
+      if (m) { token = m[1].trim(); break; }
+    }
+  }
+  if (!token) fail('缺少管理 token：--token 或环境变量 EXT_DEV_TOKEN（见主项目 .env）');
+
+  const check = validateManifest(srcDir);
+  if (check.errors.length) fail(check.errors.join('; '));
+  const slug = check.manifest.slug;
+  console.log(`[ext] dev 模式: ${slug} → ${site}`);
+
+  let timer = null;
+  const upload = async (reason) => {
+    const tmp = path.join(process.cwd(), '.ext-dev');
+    const check2 = validateManifest(srcDir);
+    if (check2.errors.length) { console.error(`[ext] ✗ 编译失败: ${check2.errors.join('; ')}`); return; }
+    buildOne(srcDir, tmp);
+    const file = pack(tmp, check2.kind, 'zip', tmp);
+    try {
+      const form = new FormData();
+      form.append('file', new Blob([fs.readFileSync(file)]), path.basename(file));
+      const res = await fetch(`${site}/api/console/extensions/dev-install`, {
+        method: 'POST',
+        headers: { 'x-ext-token': token },
+        body: form,
+      });
+      const body = await res.json().catch(() => ({}));
+      if (res.ok) console.log(`[ext] ✓ 已热更新 ${slug}（${reason}）`);
+      else console.error(`[ext] ✗ 上传失败 ${res.status}: ${JSON.stringify(body)}`);
+    } catch (err) {
+      console.error(`[ext] ✗ 无法连接站点: ${err.message}`);
+    }
+  };
+
+  await upload('首次构建');
+  console.log('[ext] 监听源码变更中… Ctrl+C 退出');
+  fs.watch(srcDir, { recursive: true }, () => {
+    clearTimeout(timer);
+    timer = setTimeout(() => upload('源码变更'), 500);
+  });
+  // 保持进程
+  setInterval(() => {}, 1 << 30);
+}
+
+// ─── main ───
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const cmd = args._[0];
+  try {
+    if (cmd === 'new') return cmdNew(args);
+    if (cmd === 'build') return cmdBuild(args);
+    if (cmd === 'build-all') return cmdBuildAll(args);
+    if (cmd === 'pack') return cmdPack(args);
+    if (cmd === 'dev') return await cmdDev(args);
+    console.log(`RainyNest 扩展 CLI
+
+用法:
+  ext new plugin|theme <名称>            生成模板工程
+  ext build <srcDir> [-o dist]           编译为安装态产物
+  ext build-all --src packages --out scripts   批量编译
+  ext pack <builtDir> [--format zip|gz]  打包发布产物
+  ext dev <srcDir> [--site url]          watch 热更新`);
+  } catch (err) {
+    fail(err.message);
+  }
+}
+main();

package/lib/bundle.js

@@ -0,0 +1,92 @@
+// tools/ext-cli/lib/bundle.js — esbuild 编译：插件 index.ts/admin.tsx、主题 theme.ts
+// bundle: true → 依赖全打进产物（自包含）；react/next/@prisma/client 由宿主提供
+const esbuild = require('esbuild');
+const fs = require('node:fs');
+const path = require('node:path');
+
+// 宿主提供的运行时模块，禁止打进包里
+const EXTERNALS = ['react', 'react/jsx-runtime', 'react/jsx-dev-runtime', 'react-dom', 'next', 'next/*', '@prisma/client', '@rainynest/plugin-types', 'better-sqlite3'];
+
+const BASE = {
+  format: 'cjs',
+  platform: 'node',
+  target: 'node20',
+  bundle: true,
+  // 统一 automatic：index.ts 动态 import('./admin.js') 会按 TS 规则解析到 admin.tsx，
+  // classic JSX 在无 React 导入的产物里运行时会报 React is not defined
+  jsx: 'automatic',
+  minify: process.env.EXT_MINIFY === '1',
+  sourcemap: false,
+  logLevel: 'silent',
+};
+
+const STATIC_FILES = [
+  'plugin.json', 'config.json', 'theme.json', 'theme.css', 'preview.png', 'preview.jpg',
+  'README.md', 'LICENSE',
+];
+
+// 编译单个扩展源码目录 → 安装态产物目录（index.js 与 admin.js 同目录，import('./admin.js') 才能解析）
+function buildOne(srcDir, outDir) {
+  fs.mkdirSync(outDir, { recursive: true });
+  const built = [];
+
+  const compile = (entry, outfile) => {
+    if (!fs.existsSync(entry)) return;
+    esbuild.buildSync({
+      entryPoints: [entry],
+      outfile,
+      external: EXTERNALS,
+      ...BASE,
+    });
+    built.push(path.basename(outfile));
+  };
+
+  const pick = (name) => {
+    // 兼容根目录与 src/ 两种源码布局
+    for (const p of [path.join(srcDir, name), path.join(srcDir, 'src', name)]) {
+      if (fs.existsSync(p)) return p;
+    }
+    return null;
+  };
+
+  // 插件入口
+  const entry = pick('index.ts') || pick('index.js');
+  if (entry) {
+    compile(entry, path.join(outDir, 'index.js'));
+    if (!fs.existsSync(path.join(outDir, 'index.js'))) {
+      fs.copyFileSync(entry, path.join(outDir, 'index.js'));
+      built.push('index.js');
+    }
+  }
+
+  // 后台页面
+  const admin = pick('admin.tsx');
+  if (admin) compile(admin, path.join(outDir, 'admin.js'));
+
+  // 主题配置映射
+  const theme = pick('theme.ts');
+  if (theme) compile(theme, path.join(outDir, 'theme.js'));
+
+  // 静态资源原样复制
+  for (const name of STATIC_FILES) {
+    const src = path.join(srcDir, name);
+    if (fs.existsSync(src)) fs.copyFileSync(src, path.join(outDir, name));
+  }
+  copyDir(path.join(srcDir, 'assets'), path.join(outDir, 'assets'));
+  copyDir(path.join(srcDir, 'migrations'), path.join(outDir, 'migrations'));
+  copyDir(path.join(srcDir, 'templates'), path.join(outDir, 'templates'));
+
+  return built;
+}
+
+function copyDir(src, dest) {
+  if (!fs.existsSync(src)) return;
+  fs.mkdirSync(dest, { recursive: true });
+  for (const item of fs.readdirSync(src)) {
+    const s = path.join(src, item);
+    if (fs.statSync(s).isDirectory()) copyDir(s, path.join(dest, item));
+    else fs.copyFileSync(s, path.join(dest, item));
+  }
+}
+
+module.exports = { buildOne, EXTERNALS };

package/lib/pack.js

@@ -0,0 +1,61 @@
+// tools/ext-cli/lib/pack.js — 打包为发布产物
+// 命名规则：{slug}.zip.rainy-plugin / {slug}.gz.rainy-theme（格式标记在类型后缀之前）
+const AdmZip = require('adm-zip');
+const { execFileSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const KIND_EXT = { plugin: 'rainy-plugin', theme: 'rainy-theme' };
+
+// 与主项目 dev-install 白名单一致：发布包只装产物，不装源码
+const ALLOWED = new Set(['.js', '.json', '.css', '.png', '.jpg', '.jpeg', '.svg', '.webp', '.sql', '.md', '.txt', '.woff', '.woff2', '.ttf']);
+const SKIP_DIRS = new Set(['src', 'node_modules', 'dist']);
+
+function collectFiles(dir, base = dir) {
+  const out = [];
+  for (const item of fs.readdirSync(dir)) {
+    const full = path.join(dir, item);
+    if (fs.statSync(full).isDirectory()) {
+      if (SKIP_DIRS.has(item)) continue;
+      out.push(...collectFiles(full, base));
+    } else if (ALLOWED.has(path.extname(item).toLowerCase())) {
+      out.push(path.relative(base, full));
+    }
+  }
+  return out;
+}
+
+// dir: 安装态产物目录；kind: plugin|theme；format: zip|gz；outDir: 产物输出目录
+function pack(dir, kind, format, outDir) {
+  const slug = require('./validate').validateManifest(dir).manifest?.slug;
+  if (!slug) throw new Error('打包失败：清单无效或缺少 slug');
+
+  const name = `${slug}.${format}.${KIND_EXT[kind]}`;
+  const outFile = path.join(outDir, name);
+  fs.mkdirSync(outDir, { recursive: true });
+
+  if (format === 'zip') {
+    const zip = new AdmZip();
+    // 包内条目不带顶层目录，解压即清单所在目录
+    for (const rel of collectFiles(dir)) {
+      zip.addLocalFile(path.join(dir, rel), path.dirname(rel) === '.' ? '' : path.dirname(rel));
+    }
+    zip.writeZip(outFile);
+  } else {
+    // gz = tar.gz，用系统 tar（Windows 10+ 自带 bsdtar）；先收集白名单文件避免打包源码
+    const tmp = fs.mkdtempSync(path.join(require('node:os').tmpdir(), 'ext-pack-'));
+    try {
+      for (const rel of collectFiles(dir)) {
+        const target = path.join(tmp, rel);
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        fs.copyFileSync(path.join(dir, rel), target);
+      }
+      execFileSync('tar', ['-czf', outFile, '-C', tmp, '.'], { stdio: 'pipe' });
+    } finally {
+      fs.rmSync(tmp, { recursive: true, force: true });
+    }
+  }
+  return outFile;
+}
+
+module.exports = { pack, KIND_EXT };

package/lib/validate.js

@@ -0,0 +1,89 @@
+// tools/ext-cli/lib/validate.js — 清单校验（specVersion 1.0）
+const fs = require('node:fs');
+const path = require('node:path');
+
+const SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
+const SPEC_VERSION = '1.0';
+
+// 校验清单，返回 { kind: 'plugin'|'theme', manifest, errors, warnings }
+function validateManifest(dir) {
+  const errors = [];
+  const warnings = [];
+
+  const pluginPath = path.join(dir, 'plugin.json');
+  const themePath = path.join(dir, 'theme.json');
+  let kind = null;
+  let manifest = null;
+
+  if (fs.existsSync(pluginPath)) {
+    kind = 'plugin';
+    manifest = readJson(pluginPath, errors);
+  } else if (fs.existsSync(themePath)) {
+    kind = 'theme';
+    manifest = readJson(themePath, errors);
+  } else {
+    return { kind: null, manifest: null, errors: ['缺少 plugin.json 或 theme.json'], warnings };
+  }
+  if (!manifest) return { kind, manifest: null, errors, warnings };
+
+  const entryName = kind === 'plugin' ? 'plugin.json' : 'theme.json';
+
+  // 必填字段
+  for (const field of ['slug', 'name', 'version']) {
+    if (!manifest[field]) errors.push(`${entryName}: 缺少必填字段 ${field}`);
+  }
+  if (manifest.slug && !SLUG_RE.test(manifest.slug)) {
+    errors.push(`${entryName}: slug 只允许小写字母/数字/连字符（${manifest.slug}）`);
+  }
+
+  // specVersion
+  if (!manifest.specVersion) {
+    warnings.push(`${entryName}: 缺少 specVersion，按 1.0 处理`);
+    manifest.specVersion = SPEC_VERSION;
+  } else if (manifest.specVersion !== SPEC_VERSION) {
+    errors.push(`${entryName}: 不支持的 specVersion ${manifest.specVersion}（宿主支持 ${SPEC_VERSION}）`);
+  }
+
+  // 入口文件存在性（校验源码目录或产物目录都行）
+  if (kind === 'plugin') {
+    const entry = manifest.entry || 'index.ts';
+    const inRoot = (n) => fs.existsSync(path.join(dir, n)) || fs.existsSync(path.join(dir, 'src', n));
+    if (!inRoot(entry) && !inRoot(entry.replace(/\.tsx?$/, '.js'))) errors.push(`插件入口不存在: ${entry}`);
+  } else {
+    const hasThemeJs = fs.existsSync(path.join(dir, 'theme.js')) || fs.existsSync(path.join(dir, 'theme.ts'));
+    if (!hasThemeJs && manifest.configSchema && Object.keys(manifest.configSchema).length > 0) {
+      warnings.push('theme.js/theme.ts 不存在，配置映射将不生效');
+    }
+  }
+
+  return { kind, manifest, errors, warnings };
+}
+
+// 产物目录安全扫描：禁止原生模块
+function scanArtifacts(dir) {
+  const errors = [];
+  walk(dir, (file) => {
+    if (file.endsWith('.node')) errors.push(`产物包含原生模块: ${path.relative(dir, file)}`);
+  });
+  return errors;
+}
+
+function walk(dir, fn) {
+  if (!fs.existsSync(dir)) return;
+  for (const item of fs.readdirSync(dir)) {
+    const full = path.join(dir, item);
+    if (fs.statSync(full).isDirectory()) walk(full, fn);
+    else fn(full);
+  }
+}
+
+function readJson(file, errors) {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf-8'));
+  } catch (err) {
+    errors.push(`${path.basename(file)} 解析失败: ${err.message}`);
+    return null;
+  }
+}
+
+module.exports = { validateManifest, scanArtifacts, SPEC_VERSION, SLUG_RE };

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "@rainynest/ext",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "RainyNest 插件/主题开发 CLI：new / build / build-all / pack / dev",
+  "bin": { "ext": "bin/ext.js" },
+  "type": "commonjs",
+  "files": [
+    "bin/",
+    "lib/",
+    "templates/"
+  ],
+  "dependencies": {
+    "adm-zip": "^0.6.1",
+    "esbuild": "^0.25.0"
+  },
+  "engines": { "node": ">=20" },
+  "keywords": [
+    "rainynest",
+    "plugin",
+    "theme",
+    "cli"
+  ],
+  "license": "MIT"
+}

package/templates/plugin/README.md

@@ -0,0 +1,20 @@
+# __SLUG__
+
+RainyNest 插件。
+
+## 开发
+
+```bash
+npm i -D @rainynest/plugin-types typescript
+npx @rainynest/ext dev . --site http://localhost:3000
+```
+
+需要主项目 `.env` 里的 `EXT_DEV_TOKEN`（放本目录 `.env` 亦可）。
+
+## 发布
+
+```bash
+npx @rainynest/ext build . -o dist
+npx @rainynest/ext pack dist --format zip
+# 产出 dist/__SLUG__.zip.rainy-plugin
+```

package/templates/plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "slug": "__SLUG__",
+  "name": "__SLUG__",
+  "version": "0.1.0",
+  "description": "插件描述",
+  "author": "",
+  "specVersion": "1.0",
+  "requiresCore": ">=1.0.0",
+  "entry": "index.ts",
+  "permissions": [],
+  "roleTemplates": [],
+  "database": { "enabled": false },
+  "configSchema": {
+    "basic": {
+      "label": "基础",
+      "fields": {
+        "enabled": { "type": "switch", "label": "启用", "default": true }
+      }
+    }
+  }
+}

package/templates/plugin/src/admin.tsx

@@ -0,0 +1,11 @@
+// src/admin.tsx — 可选后台页面（customAdminRoutes 引用）
+import React from 'react';
+
+export default function AdminPage() {
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-bold">__SLUG__</h1>
+      <p className="text-sm text-gray-500">插件管理页</p>
+    </div>
+  );
+}

package/templates/plugin/src/index.ts

@@ -0,0 +1,12 @@
+// src/index.ts — __SLUG__ 插件入口
+import type { PluginContext, ExtensionHandlers } from '@rainynest/plugin-types';
+
+export default function createPlugin(ctx: PluginContext): ExtensionHandlers {
+  ctx.logger.info('__SLUG__ 已加载，版本', ctx.version);
+
+  return {
+    // 在这里实现扩展点，例如：
+    // onMount(ctx) {},
+    // injectFooter() { return []; },
+  };
+}

package/templates/theme/src/theme.ts

@@ -0,0 +1,8 @@
+// src/theme.ts — 配置值 → CSS 变量
+export function configToCssVariables(config: Record<string, any>): Record<string, string> {
+  const vars: Record<string, string> = {};
+  if (config?.basic?.accentColor) {
+    vars['--color-primary'] = config.basic.accentColor;
+  }
+  return vars;
+}

package/templates/theme/theme.css

@@ -0,0 +1 @@
+/* __SLUG__ 主题样式 */

package/templates/theme/theme.json

@@ -0,0 +1,26 @@
+{
+  "slug": "__SLUG__",
+  "name": "__SLUG__",
+  "version": "0.1.0",
+  "description": "主题描述",
+  "author": "",
+  "specVersion": "1.0",
+  "minRainyNestVersion": ">=1.0.0",
+  "preview": "preview.png",
+  "supports": ["posts", "pages", "moments", "gallery", "links"],
+  "configSchema": {
+    "basic": {
+      "label": "基础",
+      "fields": {
+        "accentColor": { "type": "color", "label": "强调色", "default": "#3b82f6" }
+      }
+    },
+    "advanced": {
+      "label": "高级",
+      "fields": {
+        "customCss": { "type": "textarea", "label": "自定义 CSS", "default": "" },
+        "customJs": { "type": "textarea", "label": "自定义 JS", "default": "" }
+      }
+    }
+  }
+}