望远系列，因需而变，为多元场景而生——
是公益组织的温暖桥梁，让离散家庭重聚的希望之光永不熄灭；
是企业机构的数字名片，让品牌形象与核心资讯高效触达每一寸屏幕；
是个人创作者的灵感花园，让文字、影像与思想自由生长、有序沉淀；
是技术社区的分享驿站，让代码、经验与讨论在开发者之间流畅传递；
是教育平台的知识殿堂，让课程、资源与师生互动在线上轻松展开；
是政府单位的公开窗口，让政策、通知与服务信息透明可及；
是媒体资讯的发布枢纽，让新闻、报道与专题内容即时呈现、持续更新；
是图片社区的视觉画廊，让摄影作品与视觉故事在光影中绽放。
无论身处哪个行业，望远系列始终以轻量、兼容、易用的核心能力，为您构建专属的内容生态。
一、设计理念
1.1 核心目标
本系统旨在无缝兼容 Discuz! 数据库结构，实现从 Discuz! 到轻量级内容管理系统（CMS）的平滑过渡。核心设计原则：
零数据迁移：直接读取 Discuz! 原有数据表，不进行数据复制或迁移，避免数据丢失风险。
统一表前缀：安装时将保留的核心表前缀统一为 pre_，使系统整洁易维护。
保留核心功能：只保留用户、帖子、内容、附件（图片）等核心数据表，移除 Discuz! 的插件、门户、群组、积分等冗余功能。
简化架构：核心功能集中在帖子（内容）展示、发布、编辑、图片上传、UBB 解析、评论，无复杂权限体系（仅管理员/普通用户）。
附件分类管理：将帖子图片、用户头像、站点 Logo、页面背景、页头背景等按类型分目录存储，实现清晰、可维护的附件管理体系。
1.2 技术选型
后端：PHP 7.4+，PDO_MySQL 扩展。
前端：HTML5 + CSS3 + 原生 JavaScript（无复杂框架）。
编辑器：WangEditor（富文本编辑器），用于内容所见即所得编辑，支持编辑器图片上传。
图片存储：按类型分目录存储（forum/、avatar/、logo/、background/、header_bg/），按 年/月/日 自动创建子目录。
UBB 解析：从 Discuz! 内容（message 字段）提取 UBB 标签，在前台渲染为 HTML，支持 [size]、[url]、[list]、[attach]、[color]、[backcolor] 等常用标签。
版本号规范：主版本号.次版本号.修订号（如 v3.0），主版本号变更表示重大架构调整，次版本号变更表示功能新增，修订号变更表示 Bug 修复。
1.3 数据库保留清单
安装程序只保留以下 19 张核心表：
Discuz! 核心表（16 张）：
用户相关：pre_common_member、pre_common_member_count、pre_common_member_status
帖子相关：pre_forum_thread（新增 image 字段）、pre_forum_post
附件相关：pre_forum_attachment（主表）+ pre_forum_attachment_0 ~ pre_forum_attachment_9（10 张分表）
系统新增表（3 张）：
pre_settings：系统设置表（存储 Logo 路径、背景图路径、站点名称等）
pre_ads：广告管理表
pre_home_photos：首页照片墙表
其余 Discuz! 表（如 pre_common_setting、pre_forum_forum、pre_home_*、pre_portal_*、pre_plugin_*）在安装时根据用户选择删除或保留。
1.4 图片处理流程
1.4.1 帖子（内容）图片
存储路径：data/attachment/forum/（兼容 Discuz! 原路径）
上传方式：编辑器内上传（upload_editor_image.php）或封面上传（edit_post.php / post.php）
存储规则：按 年/月/日 自动创建子目录，生成唯一文件名
封面提取：编辑保存时自动从正文中提取第一张图片，更新到 pre_forum_thread.image 字段
前台显示：ubb2html() 函数解析 [attach] 标签，从附件分表获取路径，生成 <img> 标签
1.4.2 用户头像
存储路径：data/attachment/avatar/
上传接口：upload_avatar.php
占位机制：用户未上传头像时，自动显示人像影印占位图标（SVG）
删除策略：用户删除头像时，自动恢复默认占位（不删除物理文件，仅清空数据库记录）
更新方式：上传新头像时，自动删除旧头像文件，避免冗余
1.4.3 站点 Logo
存储路径：data/attachment/logo/
上传管理：管理后台（admin_setting.php）提供 Logo 上传功能
默认占位：系统自带望远景系统 Logo 占位图，安装时自动部署
删除策略：用户删除 Logo 时，自动恢复默认占位
添加覆盖不删除：上传新 Logo 时，保留旧 Logo 文件（不删除），仅更新数据库中的路径
1.4.4 页面背景
存储路径：data/attachment/background/
上传管理：管理后台（admin_setting.php）提供背景图上传功能
删除策略：用户删除背景图时，自动恢复为默认背景色（白色）
应用范围：全站页面背景（body 样式）
1.4.5 页头背景
存储路径：data/attachment/header_bg/
上传管理：管理后台（admin_setting.php）提供页头背景图上传功能
删除策略：用户删除页头背景图时，自动恢复为默认渐变色
应用范围：页面头部区域（.header 样式）
1.5 附件分类管理方案
附件类型 存储路径 数据库字段 上传接口 占位机制
帖子图片 data/attachment/forum/ pre_forum_thread.image upload_editor_image.php 无（空则显示“无图”）
用户头像 data/attachment/avatar/ pre_common_member.avatar upload_avatar.php 人像影印 SVG 占位
站点 Logo data/attachment/logo/ pre_settings.logo_path admin_setting.php 望远景系统 Logo 占位
页面背景 data/attachment/background/ pre_settings.background_path admin_setting.php 默认白色背景
页头背景 data/attachment/header_bg/ pre_settings.header_bg_path admin_setting.php 默认蓝色渐变
二、当前状态（v3.0）
2.1 已实现功能
功能模块 状态 说明
用户登录/注册 ✅ 完成 使用 pre_common_member 表，密码兼容 Discuz! 加密
用户头像 ✅ 完成 支持上传、删除、自动恢复默认占位（人像影印）
内容发布（帖子） ✅ 完成 标题 + 内容（WangEditor 富文本），支持图片上传（编辑器内 + 表单）
内容编辑 ✅ 完成 可编辑标题和内容，支持删除封面图，自动提取正文第一张图片
内容删除 ✅ 完成 仅管理员或作者可删除
首页图文列表 ✅ 完成 三列布局，支持“左图右文”/“上图下文”切换，无限滚动分页
内容详情页 ✅ 完成 显示完整内容、作者信息、浏览量、评论区（登录后可评论）
UBB 解析 ✅ 完成 支持常用 UBB 标签
图片上传 ✅ 完成 编辑器内图片上传与封面上传均正常
封面图提取 ✅ 完成 编辑保存时自动从正文提取第一张图片作为封面
搜索功能 ✅ 完成 支持按标题关键词搜索，分页显示
管理员权限 ✅ 完成 基于 adminid 和 allowadmincp 判断
管理后台 ✅ 完成 包含首页设置、广告管理、用户管理、照片墙管理、批量提取封面图、Logo/背景上传
站点 Logo ✅ 完成 支持上传/删除/自动恢复默认占位
页面/页头背景 ✅ 完成 支持上传/删除/自动恢复默认背景
评论删除 ✅ 完成 管理员、评论作者、内容作者均可删除评论
复制分享 ✅ 完成 一键复制“标题 + 链接 + 出处”
站内搜索 ✅ 完成 导航栏搜索框，按标题模糊搜索
无限滚动 ✅ 完成 首页第三组标题列表无限加载，无页码
2.2 v3.0 完成总结
望远系列 v3.0 已实现完整的轻量级 CMS 核心功能，满足通用内容发布平台（如企业官网、个人博客、技术社区、信息展示等）的基本使用需求。系统从 Discuz! 迁移平滑，数据完整保留，所有核心模块均已完成并经过测试。当前版本可作为正式产品对外发布使用。
三、发展目标
🟢 近期目标（已完成）—— v3.0 核心功能
望远系列 v3.0 已全部完成，达到可对外发布标准。
模块 任务 状态
兼容性 Discuz! 数据迁移（16 张核心表） ✅ 完成
兼容性 UBB 标签完整解析 ✅ 完成
兼容性 附件路径兼容（data/attachment/forum/） ✅ 完成
用户系统 登录/注册（兼容 Discuz! 密码） ✅ 完成
用户系统 用户头像上传/删除/占位 ✅ 完成
用户系统 管理员权限判断 ✅ 完成
内容系统 发布/编辑/删除（富文本编辑器） ✅ 完成
内容系统 封面图自动提取 ✅ 完成
内容系统 无限滚动分页 ✅ 完成
内容系统 搜索功能 ✅ 完成
评论系统 发布/删除评论 ✅ 完成
管理后台 首页设置、广告管理、用户管理 ✅ 完成
管理后台 照片墙管理、批量提取封面图 ✅ 完成
管理后台 Logo/背景/页头背景上传管理 ✅ 完成
前端体验 复制分享（标题+链接+出处） ✅ 完成
前端体验 手机/电脑自适应 ✅ 完成
近期目标验收结果：
✅ 站长可以从 Discuz! 平滑迁移到望远景
✅ 用户可以完整使用内容发布与管理功能
✅ 管理员可以完整管理网站内容和外观
✅ 系统达到对外发布标准
🟡 中期目标（2026年9月 - 2026年12月）—— 增强体验，深化应用场景
在 v3.0 稳定运行的基础上，围绕内容管理与社区运营，增强用户体验，提升系统的灵活性和适用性。
模块 任务 说明 优先级
移动端 开发微信小程序 / H5 轻应用 降低内容访问和发布门槛，适配移动端场景 ⭐⭐⭐
内容增强 标签/分类系统 支持自定义分类与标签，便于内容聚合与检索 ⭐⭐⭐
内容增强 多图/视频上传 支持批量上传与视频附件，丰富内容形式 ⭐⭐⭐
内容推荐 相似内容自动推荐 基于标题和内容关键词，推荐相关阅读 ⭐⭐
社交互动 点赞/收藏功能 增加互动性，提升用户粘性 ⭐⭐
用户体系 微信扫码/手机号登录 降低注册门槛，方便用户快速参与 ⭐⭐
数据分析 内容热度统计 统计浏览量、评论量、点赞量等，分析热门内容 ⭐⭐
数据分析 后台数据看板 管理员可视化查看内容、用户、互动数据 ⭐⭐
通知系统 评论回复通知 通过邮件/站内信通知作者 ⭐⭐
通知系统 系统公告推送 管理员可向全站或特定用户组推送消息 ⭐
安全加固 CSRF 防护、XSS 过滤 增强系统安全性 ⭐⭐⭐
性能优化 页面加载速度优化、数据库索引优化 提升响应速度 ⭐⭐⭐
扩展性 开放 RESTful API 为第三方应用或小程序提供数据接口 ⭐⭐⭐
中期目标验收标准：
用户可通过小程序或移动端便捷访问和发布内容
内容分类与推荐功能帮助用户发现感兴趣的信息
互动功能（点赞、收藏）提升社区活跃度
管理员可通过数据看板全面了解平台运营状况
系统具备开放 API，方便后续扩展
🔵 远期目标（2027年及以后）—— 品牌独立，构建内容生态
望远系列发展成为具有品牌影响力的通用内容平台，形成完整的开源生态与服务体系。
模块 任务 说明
品牌独立 独立品牌视觉体系 形成“望远”品牌的独特识别
平台化 多站点/多租户支持 支持一套系统管理多个独立站点，适用于企业集团或SAAS
平台化 插件/模板市场 开发者可贡献插件和主题，用户可按需安装
平台化 公益/商业机构入驻（可选） 允许认证机构发布内容，支持商业化运营
AI 应用 智能内容审核 基于AI自动检测违规内容，减轻管理员负担
AI 应用 图像智能识别与分类 自动识别图片内容并打标，便于检索
AI 应用 个性化推荐算法 根据用户行为推荐可能感兴趣的内容
多终端 iOS/Android App 原生应用提升移动端体验
多终端 小程序生态 完善微信小程序功能，探索更多平台
商业化 广告系统升级 支持多种广告位与计费模式，实现可持续盈利
生态建设 开发者社区 建立开发者社区，鼓励二次开发与贡献
国际化 多语言支持 支持内容国际化，拓展海外用户
国际化 跨国内容交换 对接国际CMS平台，实现内容互推
远期目标愿景：
望远系列成为轻量级 CMS 领域有影响力的开源项目
形成“安装 → 使用 → 扩展 → 贡献”的完整用户生态
可覆盖企业官网、个人博客、技术社区、内容聚合、图片分享等多样化场景
让每一份内容都能被高效管理、便捷传播、充分互动
四、产品路线图（总览）
text
复制
下载
2026年7-8月 2026年9-12月 2027年+ │ │ │ ▼ ▼ ▼┌─────────────┐ ┌─────────────────┐ ┌─────────────────┐│ 近期 │ ──▶ │ 中期 │ ──▶ │ 远期 ││ v3.0 完成 │ │ 体验增强 │ │ 生态构建 ││ ✅ 已达成 │ │ 场景深化 │ │ 平台化 │└─────────────┘ └─────────────────┘ └─────────────────┘兼容 Discuz ✅ 小程序/移动端 🔄 插件/模板市场 🟡核心功能 ✅ 内容分类/推荐 🔄 AI智能应用 🟡管理后台 ✅ 互动功能 🔄 多终端App 🟡手机自适应 ✅ 数据看板 🔄 多语言/国际化 🟡UBB解析 ✅ 开放API 🔄 开发者生态 🟡
五、总结
望远系列 与 望塬系列 同根同源，但使命不同。望远系列 致力于提供 灵活、易用、高性能的轻量级内容管理系统，帮助各类用户（个人、企业、组织、开发者）快速搭建属于自己的内容展示与互动平台；望塬系列 则专注于“建站”这一广泛需求，帮助站长轻松拥有自己的社区。
两个系列相互独立、互为补充，共同构成望远景品牌家族。v3.0 的完成标志着望远系列已具备对外服务的完整能力，中期和远期的规划将进一步拓展应用场景、增强扩展性，让技术真正服务于多样化的内容管理需求。
文档版本：v2.1（通用版）
更新日期：2026-07-12
作者：望远开发团队