ReactPress 4.0 扩展版
当前推荐版本。 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 中。）
常用命令（4.0）
| 命令 | 说明 |
|---|---|
reactpress init | 初始化并启动（终端用户） |
reactpress doctor | 环境诊断 |
reactpress logs | 查看 API 日志 |
reactpress stop | 停止服务 |
pnpm dev:desktop | 桌面开发（SQLite + Electron，Monorepo） |
pnpm build:desktop | 打包桌面安装程序 |
pnpm build:plugins | 编译官方插件 |
从 3.x 升级
见 3.x → 4.0 迁移指南。无强制 Breaking。注意：全局 CLI 已移除 dev / theme / plugin / build / start 等命令，请改用 Admin 或 Monorepo 脚本。
路线图（4.x 后续）
- 插件 npm catalog、
reactpress plugin create（脚手架：reactpress-plugin-starter） - Desktop 自动更新、托盘、快捷键
reactpress theme create脚手架- 主题/插件市场