@fecommunity/reactpress 4.0.0-beta.15 → 4.0.0-beta.17

package/plugins/seo/admin/ArticleEditorSeoPanel.tsx

@@ -0,0 +1,67 @@
+import type {
+  ArticleEditorAdminSlotContext,
+  PluginAdminSlotComponentProps,
+} from "@fecommunity/reactpress-toolkit/plugin/admin";
+import { useState } from "react";
+
+import styles from "./article-editor-seo-panel.module.css";
+
+type SeoPanelProps = PluginAdminSlotComponentProps<ArticleEditorAdminSlotContext>;
+
+export function ArticleEditorSeoPanel({ context, config }: SeoPanelProps) {
+  if (config.enabled === false) return null;
+
+  const { draft, patch, translate: t } = context;
+  const [open, setOpen] = useState(true);
+
+  return (
+    <section className={styles.panel}>
+      <header className={styles.header} onClick={() => setOpen((value) => !value)}>
+        <span className={styles.title}>{t("article.seoTitle")}</span>
+        <span className={styles.toggle} aria-hidden>
+          {open ? "▲" : "▼"}
+        </span>
+      </header>
+      {open ? (
+        <div className={styles.body}>
+          <label className={styles.label} htmlFor="article-seo-slug">
+            {t("article.seoSlug")}
+          </label>
+          <input
+            id="article-seo-slug"
+            className={styles.input}
+            value={draft.slug}
+            placeholder={t("article.seoSlugPlaceholder")}
+            onChange={(e) => patch("slug", e.target.value)}
+          />
+          <p className={styles.hint}>{t("article.seoSlugHint")}</p>
+
+          <label className={styles.label} htmlFor="article-seo-keywords">
+            {t("article.seoKeywords")}
+          </label>
+          <input
+            id="article-seo-keywords"
+            className={styles.input}
+            value={draft.seoKeywords}
+            placeholder={t("article.seoKeywordsPlaceholder")}
+            onChange={(e) => patch("seoKeywords", e.target.value)}
+          />
+          <p className={styles.hint}>{t("article.seoKeywordsHint")}</p>
+
+          <label className={styles.label} htmlFor="article-seo-description">
+            {t("article.seoDescription")}
+          </label>
+          <textarea
+            id="article-seo-description"
+            className={styles.textarea}
+            value={draft.seoDescription}
+            rows={4}
+            placeholder={t("article.seoDescriptionPlaceholder")}
+            onChange={(e) => patch("seoDescription", e.target.value)}
+          />
+          <p className={styles.hint}>{t("article.seoDescriptionHint")}</p>
+        </div>
+      ) : null}
+    </section>
+  );
+}

package/plugins/seo/admin/article-editor-seo-panel.module.css

@@ -0,0 +1,74 @@
+.panel {
+  border: 1px solid var(--editor-border, #dcdcde);
+  border-radius: 2px;
+  background: var(--editor-surface, #fff);
+}
+
+.header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 10px 12px;
+  cursor: pointer;
+  user-select: none;
+}
+
+.title {
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--editor-text, #1d2327);
+}
+
+.toggle {
+  display: inline-flex;
+  color: var(--editor-text-secondary, #646970);
+}
+
+.body {
+  padding: 0 12px 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.label {
+  display: block;
+  margin-top: 8px;
+  margin-bottom: 6px;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--editor-text, #1d2327);
+}
+
+.hint {
+  margin: 6px 0 0;
+  font-size: 12px;
+  color: var(--editor-text-secondary, #646970);
+  line-height: 1.5;
+}
+
+.input,
+.textarea {
+  width: 100%;
+  box-sizing: border-box;
+  padding: 8px 12px;
+  font-size: 14px;
+  line-height: 1.5;
+  color: var(--editor-text, #1d2327);
+  background: var(--editor-surface, #fff);
+  border: 1px solid var(--editor-border-secondary, #dcdcde);
+  border-radius: 2px;
+}
+
+.input:focus,
+.textarea:focus {
+  outline: none;
+  border-color: var(--editor-accent, #2271b1);
+  box-shadow: 0 0 0 1px var(--editor-accent, #2271b1);
+}
+
+.textarea {
+  min-height: 96px;
+  resize: vertical;
+}

package/plugins/seo/admin/index.ts

@@ -0,0 +1,18 @@
+import {
+  AdminSlotIds,
+  type PluginAdminModule,
+  type PluginAdminRegistry,
+  type PluginAdminContext,
+} from "@fecommunity/reactpress-toolkit/plugin/admin";
+
+import { ArticleEditorSeoPanel } from "./ArticleEditorSeoPanel";
+
+export function registerAdmin(registry: PluginAdminRegistry, _ctx: PluginAdminContext): void {
+  registry.registerSlot(AdminSlotIds.ARTICLE_EDITOR_META_AFTER_SUMMARY, ArticleEditorSeoPanel, {
+    priority: 10,
+  });
+}
+
+const pluginAdmin: PluginAdminModule = { registerAdmin };
+
+export default pluginAdmin;

package/plugins/seo/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { PluginContext } from '@fecommunity/reactpress-toolkit/plugin/server';
+import type { SeoPluginConfig } from './types';
+export declare const DEFAULT_CONFIG: SeoPluginConfig;
+export declare function resolveConfig(ctx: PluginContext): SeoPluginConfig;

package/plugins/seo/dist/config.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.resolveConfig = resolveConfig;
+exports.DEFAULT_CONFIG = {
+    enabled: true,
+    autoSlug: true,
+    autoDescription: true,
+    autoKeywords: true,
+    descriptionMaxLength: 160,
+    descriptionSuffix: '…',
+};
+function resolveConfig(ctx) {
+    const patch = ctx.config;
+    return {
+        ...exports.DEFAULT_CONFIG,
+        ...patch,
+    };
+}

package/plugins/seo/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { HookService, PluginContext } from '@fecommunity/reactpress-toolkit/plugin/server';
+/**
+ * SEO 增强：文章别名（slug）、关键词、meta 描述。
+ * 创建/发布前若字段为空，按插件配置自动补全。
+ */
+export declare function register(hooks: HookService, ctx: PluginContext): void;
+declare const _default: {
+    register: typeof register;
+};
+export default _default;

package/plugins/seo/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const config_1 = require("./config");
+const seo_1 = require("./seo");
+/**
+ * SEO 增强：文章别名（slug）、关键词、meta 描述。
+ * 创建/发布前若字段为空，按插件配置自动补全。
+ */
+function register(hooks, ctx) {
+    const config = () => (0, config_1.resolveConfig)(ctx);
+    const handler = async (article) => (0, seo_1.applySeoDefaults)(article, config());
+    hooks.addFilter('article.beforeCreate', handler, {
+        priority: 20,
+        pluginId: ctx.id,
+    });
+    hooks.addFilter('article.beforePublish', handler, {
+        priority: 20,
+        pluginId: ctx.id,
+    });
+    ctx.logger.log(`registered (enabled=${config().enabled}, autoSlug=${config().autoSlug}, autoDescription=${config().autoDescription})`);
+}
+exports.default = { register };

package/plugins/seo/dist/seo.d.ts

@@ -0,0 +1,3 @@
+import type { ArticleDraft, SeoPluginConfig } from './types';
+/** 补全 slug、seoKeywords、seoDescription。 */
+export declare function applySeoDefaults(article: ArticleDraft, config: SeoPluginConfig): ArticleDraft;

package/plugins/seo/dist/seo.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySeoDefaults = applySeoDefaults;
+const slug_1 = require("./slug");
+function stripMarkdown(text) {
+    return String(text || '')
+        .replace(/```[\s\S]*?```/g, ' ')
+        .replace(/`[^`]+`/g, ' ')
+        .replace(/!\[[^\]]*]\([^)]+\)/g, ' ')
+        .replace(/\[([^\]]*)]\([^)]+\)/g, '$1')
+        .replace(/^#{1,6}\s+/gm, '')
+        .replace(/^>\s?/gm, '')
+        .replace(/[*_~`]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function truncate(text, max, suffix) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max) + suffix;
+}
+function collectTagLabels(tags) {
+    if (!tags)
+        return [];
+    const list = Array.isArray(tags) ? tags : String(tags).split(',');
+    const labels = [];
+    for (const item of list) {
+        if (typeof item === 'string') {
+            const label = item.trim();
+            if (label)
+                labels.push(label);
+            continue;
+        }
+        if (item && typeof item === 'object') {
+            const label = String(item.label ?? item.value ?? '').trim();
+            if (label)
+                labels.push(label);
+        }
+    }
+    return labels;
+}
+function buildKeywords(title, tags) {
+    const parts = [title.trim(), ...collectTagLabels(tags)].filter(Boolean);
+    const unique = [...new Set(parts.map((p) => p.replace(/\s+/g, ' ').trim()))];
+    return unique.join(', ');
+}
+function buildDescription(article, config) {
+    const summary = String(article.summary ?? '').trim();
+    if (summary)
+        return summary;
+    const content = stripMarkdown(String(article.content ?? article.html ?? ''));
+    const title = String(article.title ?? '').trim();
+    const source = content || title;
+    if (!source)
+        return '';
+    const max = Math.max(80, config.descriptionMaxLength);
+    return truncate(source, max, config.descriptionSuffix);
+}
+/** 补全 slug、seoKeywords、seoDescription。 */
+function applySeoDefaults(article, config) {
+    if (!config.enabled)
+        return article;
+    const next = { ...article };
+    const title = String(article.title ?? '').trim();
+    if (config.autoSlug && !String(article.slug ?? '').trim() && title) {
+        next.slug = (0, slug_1.slugify)(title) || null;
+    }
+    if (config.autoDescription && !String(article.seoDescription ?? '').trim()) {
+        const description = buildDescription(article, config);
+        if (description)
+            next.seoDescription = description;
+    }
+    if (config.autoKeywords && !String(article.seoKeywords ?? '').trim() && title) {
+        const keywords = buildKeywords(title, article.tags);
+        if (keywords)
+            next.seoKeywords = keywords;
+    }
+    return next;
+}

package/plugins/seo/dist/slug.d.ts

@@ -0,0 +1,2 @@
+/** URL-friendly slug from title or custom alias. */
+export declare function slugify(value: string): string;

package/plugins/seo/dist/slug.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugify = slugify;
+/** URL-friendly slug from title or custom alias. */
+function slugify(value) {
+    return String(value || '')
+        .trim()
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^\w\u4e00-\u9fff-]/g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}

package/plugins/seo/dist/types.d.ts

@@ -0,0 +1,23 @@
+/** 插件 Hook 使用的文章字段子集。 */
+export interface ArticleDraft {
+    title?: string;
+    summary?: string | null;
+    content?: string | null;
+    html?: string | null;
+    slug?: string | null;
+    seoKeywords?: string | null;
+    seoDescription?: string | null;
+    tags?: Array<{
+        label?: string;
+        value?: string;
+    } | string> | string;
+    [key: string]: unknown;
+}
+export interface SeoPluginConfig {
+    enabled: boolean;
+    autoSlug: boolean;
+    autoDescription: boolean;
+    autoKeywords: boolean;
+    descriptionMaxLength: number;
+    descriptionSuffix: string;
+}

package/plugins/seo/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/plugins/seo/locales/en.json

@@ -0,0 +1,32 @@
+{
+  "meta": {
+    "name": "SEO",
+    "description": "Per-article slug, keywords, and meta description with optional auto-fill on publish."
+  },
+  "settings": {
+    "enabled": {
+      "title": "Enable SEO auto-fill",
+      "description": "When off, slug, keywords, and description are not auto-generated on publish."
+    },
+    "autoSlug": {
+      "title": "Auto-generate URL slug",
+      "description": "Create a slug from the title when slug is empty."
+    },
+    "autoDescription": {
+      "title": "Auto-generate meta description",
+      "description": "Use summary first, otherwise excerpt from body when description is empty."
+    },
+    "autoKeywords": {
+      "title": "Auto-generate keywords",
+      "description": "Use title and tag names when keywords are empty."
+    },
+    "descriptionMaxLength": {
+      "title": "Description max length",
+      "description": "Max characters when excerpting from body (80–320)."
+    },
+    "descriptionSuffix": {
+      "title": "Description truncation suffix",
+      "description": "Appended when text exceeds max length, e.g. …"
+    }
+  }
+}

package/plugins/seo/locales/zh.json

@@ -0,0 +1,32 @@
+{
+  "meta": {
+    "name": "SEO 增强",
+    "description": "为文章提供 URL 别名、SEO 关键词与 meta 描述，发布时可自动补全。"
+  },
+  "settings": {
+    "enabled": {
+      "title": "启用 SEO 自动补全",
+      "description": "关闭后，发布时不再自动写入别名、关键词或描述。"
+    },
+    "autoSlug": {
+      "title": "自动生成 URL 别名",
+      "description": "别名为空时，从文章标题生成 slug。"
+    },
+    "autoDescription": {
+      "title": "自动生成 SEO 描述",
+      "description": "SEO 描述为空时，优先使用摘要，否则从正文截取。"
+    },
+    "autoKeywords": {
+      "title": "自动生成 SEO 关键词",
+      "description": "关键词为空时，使用文章标题与标签名称。"
+    },
+    "descriptionMaxLength": {
+      "title": "描述最大长度",
+      "description": "从正文截取 SEO 描述的最大字符数（80–320）。"
+    },
+    "descriptionSuffix": {
+      "title": "描述截断后缀",
+      "description": "超出最大长度时追加在末尾，例如 …"
+    }
+  }
+}

package/plugins/seo/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@fecommunity/reactpress-plugin-seo",
+  "version": "1.0.0",
+  "private": true,
+  "description": "SEO plugin for ReactPress — slug, keywords, meta description",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@fecommunity/reactpress-toolkit": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3"
+  }
+}

package/plugins/seo/plugin.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "../plugin.manifest.schema.json",
+  "id": "seo",
+  "name": "SEO 增强",
+  "version": "1.0.0",
+  "description": "为文章提供 URL 别名、SEO 关键词与 meta 描述，发布时可自动补全。",
+  "author": "ReactPress",
+  "requires": ">=3.5.0",
+  "server": {
+    "module": "./dist/index.js",
+    "hooks": {
+      "subscribe": ["article.beforeCreate", "article.beforePublish"]
+    }
+  },
+  "admin": {
+    "slots": {
+      "subscribe": ["article.editor.meta.afterSummary"]
+    },
+    "menu": {
+      "title": "SEO 增强",
+      "path": "/plugins/seo/settings",
+      "permission": "extension:manage",
+      "sort": 20
+    }
+  },
+  "settings": {
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "title": "启用 SEO 自动补全",
+          "description": "关闭后，发布时不再自动写入别名、关键词或描述。",
+          "default": true
+        },
+        "autoSlug": {
+          "type": "boolean",
+          "title": "自动生成 URL 别名",
+          "description": "别名为空时，从文章标题生成 slug。",
+          "default": true
+        },
+        "autoDescription": {
+          "type": "boolean",
+          "title": "自动生成 SEO 描述",
+          "description": "SEO 描述为空时，优先使用摘要，否则从正文截取。",
+          "default": true
+        },
+        "autoKeywords": {
+          "type": "boolean",
+          "title": "自动生成 SEO 关键词",
+          "description": "关键词为空时，使用文章标题与标签名称。",
+          "default": true
+        },
+        "descriptionMaxLength": {
+          "type": "integer",
+          "title": "描述最大长度",
+          "description": "从正文截取 SEO 描述的最大字符数（80–320）。",
+          "minimum": 80,
+          "maximum": 320,
+          "default": 160
+        },
+        "descriptionSuffix": {
+          "type": "string",
+          "title": "描述截断后缀",
+          "description": "超出最大长度时追加在末尾，例如 …",
+          "default": "…"
+        }
+      }
+    }
+  },
+  "permissions": ["article:read"],
+  "capabilities": {
+    "headless": true
+  }
+}

package/plugins/seo/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/server/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@fecommunity/reactpress-server",
-  "version": "4.0.0-beta.15",
+  "version": "4.0.0-beta.16",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@fecommunity/reactpress-server",
-      "version": "4.0.0-beta.15",
+      "version": "4.0.0-beta.16",
       "deprecated": "Bundled in @fecommunity/reactpress CLI from v3.1. Run `npx @fecommunity/reactpress init` for new projects.",
       "license": "MIT",
       "dependencies": {
@@ -91,7 +91,7 @@
     },
     "../toolkit": {
       "name": "@fecommunity/reactpress-toolkit",
-      "version": "4.0.0-beta.15",
+      "version": "4.0.0-beta.16",
       "dependencies": {
         "ajv": "^8.17.1",
         "axios": "^1.12.2",

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fecommunity/reactpress-server",
-  "version": "4.0.0-beta.15",
+  "version": "4.0.0-beta.17",
   "deprecated": "Bundled in @fecommunity/reactpress CLI from v3.1. Run `npx @fecommunity/reactpress init` for new projects.",
   "description": "ReactPress NestJS REST API (deprecated). Bundled in @fecommunity/reactpress CLI from v3.1. Headless CMS for articles, media, plugins, and themes",
   "author": "fecommunity",

package/toolkit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fecommunity/reactpress-toolkit",
-  "version": "4.0.0-beta.15",
+  "version": "4.0.0-beta.17",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {