富文本编辑器内容

一、插件简介

富文本编辑器插件通过钩子替换社区发帖/编辑页的正文输入区域，站长可在应用中心一键切换纯文本或多种富文本/Markdown 编辑器，无需改代码。

URL 后缀说明：发帖/编辑页路径受社区路由配置影响，示例 /topic/create.html。

二、核心能力

三、依赖与安装

1. 必须先安装并启用 `community`（BBS社区）——编辑器挂载在社区发帖/编辑模板。
2. 无数据库表，安装/卸载为空操作。
3. 静态资源位于 public/static/editor/（wangEditor、Quill、EasyMDE 等）；TinyMCE/Summernote 等部分使用 CDN。
4. 与 aiassistant 插件可配合使用 AI 优化正文。

四、应用中心基础配置

字段来自 EditorPlugin::configSchema()：

编辑器类型选项

五、后台/重点配置

无后台菜单。切换编辑器后建议：

1. 前台打开发帖页确认工具栏与上传正常
2. 发布测试帖检查详情页排版
3. 若从富文本切到 Markdown 编辑器，旧 HTML 帖编辑时会尝试转为 Markdown 回显

六、前台用户流程

1. 用户进入发帖或编辑页，钩子 compose_body 渲染所选编辑器。
2. 编辑内容；图片通过编辑器上传按钮走社区 topic/upload 接口。
3. 提交表单前 JS 调用 window.__composeEditorSync() 将内容同步到隐藏域 content。
4. 帖子详情页经 HookService::filterHtml() 链处理，本插件将 uc-music-netease、uc-audio 等占位转为播放器。

七、后台审核与运维

无审核流程。运维注意：

• CDN 编辑器（TinyMCE、Summernote 等）需服务器能访问外网
• 升级编辑器静态资源版本时同步 public/static/editor/ 目录

八、特殊说明

钩子插槽

filterHtml 链

EditorPlugin::filterHtml() 在帖子展示时执行：

• uc-music-netease / uc-music-netease-pl 链接 → 网易云 iframe 播放器
• uc-audio 链接（可选封面 uc-audio-cover）→ HTML5 audio 播放器

renderAssets

全站注入播放器相关 <style>，不依赖是否在发帖页。

全局 JS 约定

• window.__composeEditorSync()：提交前同步内容
• window.__composeEditorApply(html)：外部写入内容（AI 助手）

九、推荐上线清单

• 确认 community 已启用
• 应用中心启用插件并选择编辑器类型
• 测试发帖、编辑、图片上传
• 检查帖子详情页图片与排版
• 若使用 Markdown 编辑器，测试 MD 语法与预览
• 确认服务器可加载 CDN 资源（若选 TinyMCE 等）
• 与 aiassistant 联调 AI 润色回写（可选）

十、常见问题

Q：发帖页仍是纯文本框？ 确认 editor 插件已安装且 enabled 为开启；检查是否与其他插件冲突。

Q：图片上传失败？ 检查社区上传权限与 topic/upload 接口；浏览器控制台查看 __editorUploadFile 错误。

Q：TinyMCE/Summernote 空白？ 多为 CDN 无法访问，可改用本地资源的 wangEditor/Quill，或配置代理。

Q：编辑旧帖出现 HTML 标签？ EasyMDE/Vditor 会尝试 HTML→Markdown 转换；复杂排版可能需手动调整。

Q：网易云链接没有播放器？ 链接需带 uc-music-netease 类名（发帖时通过编辑器插入）；纯文本链接不会自动转换。