- 在
/admin登录,进入“文章”或“独立页面”,新建内容。 - 输入标题、摘要和访问地址。地址只支持小写字母、数字及连字符;修改后在发布时生效,旧链接跳转到新地址,不同内容的地址不能重复。
- 使用正文工具栏排版,点击“插入”或输入
/插入图片集、音视频、表格、网页嵌入、代码块和分栏。支持图片粘贴/拖入上传;完整操作见 丰富编辑器。正文 HTML 会在后端净化。 - 可选择分类、多个标签和封面,点击“保存草稿”。未发布内容对访客不可见,预览入口需要已登录的管理权限。
- 点击“保存并发布”后,公开快照原子更新,前台立即读取最新发布内容。
封面、Logo、Favicon 和页面搭建模块的图片选择统一使用附件预览窗口:点击“选择图片”,通过缩略图或文件名搜索查找,点击“预览”查看大图,再确认使用。搜索覆盖整个附件库,支持分页;关闭窗口或按 Escape 不会修改原图片。“移除图片”只清除当前引用,不删除附件。正文图片和图片集也使用同一界面,图片集可跨页勾选;音视频可先播放,PDF 提供原文件下载。
附件选择的隔离浏览器验收入口为 python tests/asset_picker_browser.py,覆盖搜索分页、预览、键盘关闭、取消保留原值、图片集跨页选择、站点图标和模板图片。
编辑已发布文章后只保存草稿,线上仍展示上一次发布版本。下架会撤销公开文章、sitemap 记录及不再有公开引用的附件访问。需要再次展示时重新发布。
内容保存、发布、下架与删除都检查版本号。另一位管理员抢先修改时会提示冲突;请先保留自己的改动文本,再重新加载并合并修改,不会自动覆盖对方内容。发布请求失败但草稿保存成功时保留已保存版本,可以重试发布。
正文输入与图片上传期间会提示保存状态;保存/发布处理中禁用继续编辑。文章、独立页面、站点设置、分类标签、菜单、成员和修改密码表单都有未保存保护:离开、刷新、关闭标签、后退/前进以及退出登录前提醒;取消会保留输入和登录状态。成功保存后解除提醒,保存失败时仍保留保护。切换编辑对象或取消编辑也会确认放弃。后台使用浏览器原生页面导航,保证历史前进/后退经过同一离开检查。
离开确认文字由浏览器决定。编辑器现在支持停止输入 5 秒自动保存、按账号隔离的本机恢复副本和最后保存时间;失败保留输入并有限重试,冲突可另存为新草稿。清理浏览器数据会删除本机副本,重要内容仍应确认已同步到服务器。历史版本、回收站和定时发布详见 内容运营功能。
在对应列表右上角使用“导入”和“导出筛选结果”:
- 不勾选内容时,导出当前关键词、状态、分类和标签匹配的全部结果,不受当前分页影响。勾选后按钮变为“导出所选”,仅导出所选内容;回收站内容不导出。
- 导出的是最新草稿,包括标题、摘要、正文、封面、关联附件及分组、分类标签、产品/案例业务字段、SEO 和页面布局。相同附件在一个包内只保存一份。
- 在目标站点打开同类型列表,点击“导入”,选择 ZIP 后点击“导入为新草稿”。成功后显示新增内容链接和地址调整结果,检查后按原发布流程上线。管理员和编辑均可操作。
- 每次导入都会创建新草稿和附件,已有内容不会被覆盖;地址被草稿、回收站、旧链接或发布计划占用时自动添加导入后缀。分类/标签的类型、地址和名称一致时复用;同地址但名称不同则创建新条目。
公共区块按当前已发布版本展开为独立模块,保留手机样式和隐藏状态,导入后可独立编辑。包内内容之间的相对链接、附件地址和相关分类链接会重映射;其他链接保持原地址。动态内容列表保留查询条件,导入后读取目标站点对应分类下的内容,不自动携带列表里的全部文章/产品。
每包最多 100 条内容、500 个附件,ZIP 不超过 50 MiB,解压后总量不超过 150 MiB,正文/布局清单不超过 8 MiB。单个附件沿用目标站点的 Storage:MaxBytes(默认 10 MiB)及格式限制。超过限制时请缩小筛选范围或分批处理。损坏、缺失附件、路径异常、类型不匹配的内容包会被拒绝;导入中途失败会回滚本次数据和新增文件,可修复后重试。
内容包使用 content.json 清单和 assets/{id} 附件,格式标识 cms-content、版本 1;支持本 CMS 导出的对应类型 ZIP。历史版本、评论、访问统计、定时发布、主题、导航、咨询表单及站点配置不随包迁移。整站备份与恢复仍使用“备份与维护”。
验收入口:python tests/content_transfer_acceptance.py 验证隔离站点往返、重复地址、权限、坏包拒绝及文件/事务回滚;web/tests/content-transfer.spec.ts 在隔离浏览器站点验证三类列表的下载/上传、超过 10 MiB 的 ZIP 经前端代理导入、移动端布局和失败提示。此次不改变数据库版本,现有 Docker 镜像需重新构建才包含该功能。
附件库支持 PNG、JPEG、GIF、WebP、PDF、MP4、WebM、MP3 和 WAV,默认每个文件最多 10 MiB。检查扩展名、签名与大小,不接受 HTML、SVG 或可执行文件。PDF 作为下载附件返回;上传不代表已公开,音视频支持 HTTP Range。
正文图片可通过工具栏上传插入,也可点击“从附件库插入图片”选择已有图片。PDF 可在附件库复制地址,通过编辑器链接按钮引用。附件库地址格式为 /media/{id},不要改写或编码这个地址。正文、Logo 和封面图片选择都支持翻页。
被草稿、发布快照、定时快照、历史版本、回收站或站点图片引用的附件不能删除。附件库支持文件名和类型筛选,点击“引用位置”定位相关内容;仅移除当前正文引用不会释放历史版本仍使用的附件。
支持批量上传、文件名修改和分组,附件选择窗口也可按组筛选。图片支持比例裁剪和主体位置调整,另存新附件,原文件及历史引用保留。操作及限制见 页面搭建与业务工具。
分类与标签管理中设置显示名称和归档地址。分类页面为 /category/{slug},标签页面为 /tag/{slug}。被内容引用时禁止直接删除。
独立页面位于 /pages/{slug},文章位于 /posts/{slug},产品与案例位于 /products/{slug} 和 /cases/{slug}。管理员在“导航菜单”选择上级菜单项、类型、打开方式和同级排序,支持最多 5 级。类型包括自定义链接、文章、自定义页面、产品、案例、分类、标签;资源类型自动同步已发布名称及地址。自定义链接支持站内路径、页内锚点或 HTTPS 外部地址。
点击树形列表的“新增子菜单”按钮可以直接建立下级入口,调整“上级菜单项”可以移动分支;序号越小在同级中越靠前。存在子项时须先移动或删除子项,再删除父项。下架资源对应的菜单及其子项暂不对访客显示,重新发布后恢复;仍被菜单引用的内容、分类或标签不能直接删除。详细规则见 多级菜单说明。
关键词搜索匹配已发布标题、摘要、正文和产品/案例业务字段,并提供关键词附近的摘要。列表按首次发布时间倒序分页,重新发布不会让旧文章置顶;文章提供前后篇和相关文章,RSS 地址为 /rss.xml。
文章及独立页面显示阅读次数;后台文章列表提供累计 / 今日浏览量、独立访客和按浏览量排序。管理员在“访问统计”查看趋势与内容排行,在“访客记录”查看浏览器访问轨迹,在“客户咨询”处理前台提交的需求与联系方式。咨询入口位于公开页面底部,客户主动勾选联系授权后提交;联系方式仅管理员和该咨询的负责专员可见。详细口径、跟进操作和升级步骤见 访问统计与客户咨询。
管理员可在“咨询表单”配置附加字段;后台详情和导出保留客户提交时的字段名称及内容。“通知记录”查看咨询、逾期、备份或发布计划的通知结果;通知需先由部署环境启用邮件或企业微信,见 配置说明。
访客在已发布文章下提交姓名和纯文本评论。评论需审核后才公开;不会把评论作为 HTML 渲染。管理员和编辑可以审核、隐藏或删除,管理员可以回复或修改一条官方回复;支持按所属内容筛选及批量审核,无楼中楼讨论。每个 IP 每分钟最多提交 5 次,登录每 IP 每分钟最多 10 次。
管理员管理全部功能;编辑管理文章、页面、分类标签、附件与评论,并可修改自己的密码。菜单、站点设置、其他账号和审计日志只有管理员可以修改或管理。
咨询专员只处理分配给自己的咨询,可使用“我的待办”、查看跟进记录和导出自己的客户;不获得内容编辑、访客轨迹或整站管理权限。
账号由管理员创建,无公开注册。管理员可以调整角色、启停账号及重设密码;停用、删除、角色/密码变更会使已有会话失效。系统会保留至少一名启用的管理员,禁止删除、降级或停用最后一名。
“修改密码”需要当前密码。密码长度为 12–200 字符,修改成功后重新登录。会话最长 8 小时。唯一管理员忘记密码时,由服务器维护人员使用 管理员应急恢复。
登录时还需填写 6 位图形验证码,可点击“换一张”。同一账号连续 5 次密码失败后限制 15 分钟;失败后保留账号密码并更换验证码。验证码有效期、接口变化及部署边界见 登录保护说明。
“站点设置”保存名称、介绍、Logo 和 SEO 关键词。文章摘要用于详情页描述,页面标题、canonical、sitemap、robots 由前台生成,站点域名取部署配置 SITE_URL。
每份内容还可设置独立 SEO 标题、描述、分享图片和禁止收录;保存草稿不影响线上,发布后生效。页面搭建支持撤销/重做、手机独立样式、真实页眉页脚预览,以及公共区块的独立复制或同步引用,详见 页面搭建与业务工具。
“操作记录”支持按成员、时间、动作和对象筛选,展示关键写操作的操作者、动作、时间,以及操作对象的类型、ID 和当时名称;对象被重命名或删除后,原日志仍可辨认。日志与业务数据库写入处于同一事务,失败回滚时不记录成功操作。升级前的记录不具备对象信息,会明确标识。日志不记录密码和正文内容,也不提供历史版本恢复功能。
站点名称用于所有页面标题的站点后缀,站点介绍用于默认 SEO 描述;文章摘要优先作为自身描述。关键词设置由公开页面继承,分类、标签归档也纳入站点地图。保存设置后公开页面实时读取,无需清理页面缓存。
后台列表和编辑页显示加载状态;读取失败时显示原因、追踪编号(服务器提供时)和“重新加载”,不会把故障误报为空数据。手机导航打开后焦点进入菜单,Tab 在菜单内移动,Escape 关闭并把焦点还给导航按钮。
后台“站点设置”按基本信息、文章显示、搜索引擎、评论、页脚五组编辑,一次保存。可设置副标题、Favicon、内容语言、首页/分类/标签/搜索每页条数、禁止收录、评论启停与审核/登录要求、纯文本页脚。所有主题实时生效;文章和独立页面共用评论策略。保存时检查版本号,冲突保留输入。详细使用和升级边界见 站点设置说明。