| sidebar_position | 3 | ||||||
|---|---|---|---|---|---|---|---|
| title | ReactPress 4.0 扩展版 | ||||||
| description | ReactPress 4.0 扩展版 — 插件系统、Electron 桌面客户端、npm 主题 catalog。在 3.x 平台能力之上的当前推荐版本。 | ||||||
| keywords |
|
当前推荐版本。 3.x 的平台能力 + 插件生态 + 桌面写作 — 仍是一条 CLI,一套 Admin。
4.0(代号 Extend)在 3.0 平台版 与 3.1 Toolkit 主题重构 之上,交付三件大事:
| 重点 | 用户感知 | 4.0 交付 |
|---|---|---|
| 插件 | 像 WordPress 一样装插件扩能力 | Hook + plugin.json + Admin 插槽;内置 SEO、自动摘要 |
| 桌面 | 不开浏览器也能写作管理 | Electron 壳 + SQLite 本地模式,可同步到远程 |
| 主题 | 官方主题从 npm 一键安装 | theme-starter catalog + hello-world 入门模板 |
npm i -g @fecommunity/reactpress
mkdir my-blog && cd my-blog
reactpress init默认 SQLite,无需 Docker。init 会自动启动服务;停止用 reactpress stop。
| 服务 | 端口 | 说明 |
|---|---|---|
| 管理后台 | 3001 /admin/ |
reactpress init 默认 |
| 访客主题 | 3001 | 激活的 Next.js 主题 |
| API | 3002 | NestJS REST |
| 主题预览 | 3003 | 后台 iframe 预览 |
| Admin(Monorepo 开发) | 3000 | 独立 Vite dev server |
全局 CLI 命令:init · doctor · logs · stop。详见 CLI 命令参考。
无需 Docker,适合本地写作:
# 在 monorepo 根目录
pnpm dev:desktop| 项 | 说明 |
|---|---|
| 内嵌 API | SQLite,默认 http://127.0.0.1:3002/api |
| 默认账号 | admin / admin |
| 远程模式 | 设置 → 桌面客户端,连接已有 API |
| 同步 | 本地内容可推送到远程站点 |
打包:pnpm build:desktop → desktop/release/。
预构建安装包:桌面客户端文档 · GitHub Releases
详见仓库 desktop/README.md。
| 入口 | 说明 |
|---|---|
| 后台 → 插件 | 安装、启用、配置(终端用户推荐) |
Monorepo:reactpress plugin list/install |
完整 CLI 仅在仓库检出中可用 |
内置插件:
| id | 能力 |
|---|---|
hello-world |
发布时自动生成摘要 |
seo |
别名、关键词、meta 描述;文章编辑器 Admin 插槽 |
image-optimizer |
历史图片素材分析与批量 WebP 优化 |
开发插件见 plugins/README.md · 脚手架:reactpress-plugin-starter
| 模板 | 来源 | 适用 |
|---|---|---|
| hello-world | 仓库 local | 学习、复制改 |
| reactpress-plugin-starter | GitHub | 独立仓库开发第三方插件 |
| 主题 | 来源 | 适用 |
|---|---|---|
| hello-world | 仓库 local | 学习、复制改 |
| reactpress-theme-starter | npm | 生产站点(搜索、知识库、评论) |
init 会自动安装并启用官方 featured 主题。也可在 Admin → 外观 → 主题 中安装。
Monorepo 贡献者:
reactpress theme add @fecommunity/reactpress-theme-starter@1.0.0-beta.0(theme / plugin 子命令不在全局 npm CLI 中。)
| 命令 | 说明 |
|---|---|
reactpress init |
初始化并启动(终端用户) |
reactpress doctor |
环境诊断 |
reactpress logs |
查看 API 日志 |
reactpress stop |
停止服务 |
pnpm dev:desktop |
桌面开发(SQLite + Electron,Monorepo) |
pnpm build:desktop |
打包桌面安装程序 |
pnpm build:plugins |
编译官方插件 |
见 3.x → 4.0 迁移指南。无强制 Breaking。注意:全局 CLI 已移除 dev / theme / plugin / build / start 等命令,请改用 Admin 或 Monorepo 脚本。
- 插件 npm catalog、
reactpress plugin create(脚手架:reactpress-plugin-starter) - Desktop 自动更新、托盘、快捷键
reactpress theme create脚手架- 主题/插件市场