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

package/plugins/image-optimizer/locales/zh.json

@@ -0,0 +1,53 @@
+{
+  "meta": {
+    "name": "图片资源优化",
+    "description": "分析历史图片素材并批量压缩为 WebP 多尺寸变体，可选回写文章与页面中的图片 URL。"
+  },
+  "settings": {
+    "batchSize": {
+      "title": "每批处理数量",
+      "description": "单次任务最多处理的图片数量（1–200）。"
+    },
+    "skipGif": {
+      "title": "跳过 GIF",
+      "description": "GIF 转 WebP 后会失去动画，默认跳过。"
+    },
+    "rewriteContent": {
+      "title": "优化后回写内容 URL",
+      "description": "批量优化完成后，自动替换文章/页面中引用的旧图片地址。"
+    },
+    "cleanupOriginals": {
+      "title": "优化后删除原文件",
+      "description": "确认无误后再开启；删除后无法通过旧 URL 访问原图。"
+    }
+  },
+  "dashboard": {
+    "title": "资源分析",
+    "analyze": "分析现状",
+    "dryRun": "试运行（不写入）",
+    "dryRunDone": "试运行完成（未写入数据库）",
+    "run": "开始批量优化",
+    "refresh": "刷新",
+    "total": "素材总数",
+    "optimized": "已优化",
+    "pending": "待优化",
+    "estimatedSaved": "预估可节省",
+    "contentRefs": "内容引用",
+    "articles": "文章",
+    "pages": "页面",
+    "skipped": "已跳过",
+    "jobRunning": "优化任务进行中…",
+    "jobScanning": "正在扫描待优化素材…",
+    "jobEmpty": "没有待优化的图片（可能已全部优化，或原文件已不存在）。",
+    "jobDone": "任务已完成",
+    "jobFailed": "任务失败",
+    "processed": "已处理",
+    "succeeded": "成功",
+    "failed": "失败",
+    "savedBytes": "已节省空间",
+    "inactiveHint": "请先在插件列表中启用本插件，才能执行分析与优化。",
+    "analyzeFailed": "分析失败",
+    "runFailed": "启动任务失败",
+    "jobPollFailed": "获取任务进度失败，请重试"
+  }
+}

package/plugins/image-optimizer/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@fecommunity/reactpress-plugin-image-optimizer",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Legacy image optimization plugin for ReactPress",
+  "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/image-optimizer/plugin.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "../plugin.manifest.schema.json",
+  "id": "image-optimizer",
+  "name": "图片资源优化",
+  "version": "1.0.0",
+  "description": "分析历史图片素材并批量压缩为 WebP 多尺寸变体，可选回写文章与页面中的图片 URL。",
+  "author": "ReactPress",
+  "requires": ">=3.5.0",
+  "server": {
+    "module": "./dist/index.js"
+  },
+  "admin": {
+    "menu": {
+      "title": "图片优化",
+      "path": "/plugins/image-optimizer/settings",
+      "permission": "extension:manage",
+      "sort": 30
+    }
+  },
+  "settings": {
+    "schema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "batchSize": {
+          "type": "integer",
+          "title": "每批处理数量",
+          "description": "单次任务最多处理的图片数量（1–200）。",
+          "minimum": 1,
+          "maximum": 200,
+          "default": 50
+        },
+        "skipGif": {
+          "type": "boolean",
+          "title": "跳过 GIF",
+          "description": "GIF 转 WebP 后会失去动画，默认跳过。",
+          "default": true
+        },
+        "rewriteContent": {
+          "type": "boolean",
+          "title": "优化后回写内容 URL",
+          "description": "批量优化完成后，自动替换文章/页面中引用的旧图片地址。",
+          "default": false
+        },
+        "cleanupOriginals": {
+          "type": "boolean",
+          "title": "优化后删除原文件",
+          "description": "确认无误后再开启；删除后无法通过旧 URL 访问原图。",
+          "default": false
+        }
+      }
+    }
+  },
+  "permissions": ["file:read", "file:write", "article:read"],
+  "capabilities": {
+    "headless": true
+  }
+}

package/plugins/image-optimizer/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/plugins/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@fecommunity/reactpress-plugins",
+  "version": "1.0.0",
+  "private": true,
+  "description": "ReactPress plugin registry — local and npm plugin sources for the publishing platform",
+  "license": "MIT",
+  "scripts": {
+    "build": "pnpm --filter @fecommunity/reactpress-plugin-hello-world run build && pnpm --filter @fecommunity/reactpress-plugin-seo run build && pnpm --filter @fecommunity/reactpress-plugin-image-optimizer run build",
+    "typecheck": "pnpm --filter @fecommunity/reactpress-plugin-hello-world run typecheck && pnpm --filter @fecommunity/reactpress-plugin-seo run typecheck && pnpm --filter @fecommunity/reactpress-plugin-image-optimizer run typecheck"
+  },
+  "reactpress": {
+    "local": ["hello-world", "seo", "image-optimizer"]
+  }
+}

package/plugins/seo/README.md

@@ -0,0 +1,60 @@
+# seo (SEO Enhancement)
+
+Official plugin — **URL slug**, **SEO keywords**, and **meta description** with optional auto-fill and an Admin editor panel.
+
+> WordPress-style SEO fields · Headless-friendly meta for Next.js themes
+
+- **Plugin id**: `seo`
+- **Version**: see [`plugin.json`](./plugin.json)
+
+## Features
+
+| Field | Description |
+| :--- | :--- |
+| `slug` | URL alias, accessible at `/article/{slug}` |
+| `seoKeywords` | meta keywords, comma-separated |
+| `seoDescription` | meta description |
+
+| Scenario | Behavior (when plugin enabled and option on) |
+| :--- | :--- |
+| Slug empty | Generate slug from title |
+| SEO description empty | Prefer summary, else truncate body |
+| SEO keywords empty | Use title + tag names |
+
+## Hooks
+
+| Hook | Type | Description |
+| :--- | :--- | :--- |
+| `article.beforeCreate` | filter | Fill SEO fields on create |
+| `article.beforePublish` | filter | Fill SEO fields on publish |
+
+## Configuration
+
+| Field | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `enabled` | boolean | `true` | Master switch |
+| `autoSlug` | boolean | `true` | Auto-generate slug |
+| `autoDescription` | boolean | `true` | Auto-generate description |
+| `autoKeywords` | boolean | `true` | Auto-generate keywords |
+| `descriptionMaxLength` | number | `160` | Max description length |
+| `descriptionSuffix` | string | `…` | Truncation suffix |
+
+## Usage
+
+1. `pnpm dev` (plugins are compiled automatically)
+2. Admin → **Plugins** → install **SEO Enhancement** → **Enable**
+3. Fill slug, keywords, and description in the **SEO Settings** panel (leave empty for auto-fill)
+4. After publish, check `<meta name="description">` and `<meta name="keywords">` on the theme article page
+
+## Admin UI
+
+The **SEO Settings** panel in the article editor is injected via Admin slot `article.editor.meta.afterSummary` (see [`admin/`](./admin/)). The panel unmounts automatically when the plugin is deactivated.
+
+## Development
+
+```bash
+pnpm --filter @fecommunity/reactpress-plugin-seo run build
+pnpm --filter @fecommunity/reactpress-plugin-seo run typecheck
+```
+
+See [`../README.md`](../README.md) for the plugin system overview.

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"
+  }
+}