开源国风3D个人主页「玄玑洞府」:水墨为骨、低多边形为魂,六大游历场景配 GSAP 镜头与程序化贴图,GLB 模型压至 3.14MB,WebGL 失效自动降级 2D 不丢内容;Ant Design 水墨后台可视化管理档案、履历、馆藏与玉符,内容与展示完全分离。
玄玑洞府 · 国风3D个人主页系统开源
以东方水墨为骨、低多边形科技为魂的个人主页系统,前端3D洞府沉浸式游历搭配Ant Design水墨修仙后台可视化管理,内容与展示完全分离。
🎮 前端3D主页核心能力
- 六大游历场景:山门候客(加载)→ 洞府前厅 → 筑基概况 / 修行履历 / 丹器馆藏 / 传讯玉符,完整覆盖个人主页全内容模块
- 专业镜头系统:GSAP插值(power2.inOut,1.2s)、前厅待机公转(20s周期±15°)、鼠标跟随偏移,转场期间自动禁用交互避免误操作
- 轻量化虚拟形象:自研减面管线将43MB/149万三角形的GLB模型压至3.14MB/11万三角形,统一「生宣暖白」色调适配青绿水彩风格,支持待机呼吸、悬停放大、点击抱拳行礼+随机问候
- 全场景国风交互:玉简悬停展开、灵脉节点悬停涟漪与点击展开、法宝拖拽360°环绕与分类高亮、玉符点击复制/跳转
- 趣味彩蛋系统:修为值(浏览累积并进阶)、灵签、昼夜轮转三大特色玩法
- 全局适配能力:御剑归宗、精简模式、移动端底部导航、篆文进度加载、弱网提示
- 智能降级机制:WebGL 2.0检测失败自动切换2D水墨版主页,所有内容完全一致不丢失
- 零静态贴图:全部贴图由Canvas 2D程序化生成(八卦纹、玉简篆文、匾额、卷轴、光晕、水墨噪声),石壁卷轴支持按当前档案内容实时竖排文字排版(右起,含落款印)
⚙️ 水墨修仙管理后台
- 禁制验证登录:安全的后台入口校验机制
- 数据仪表盘:4张概览卡 + 近7日趋势折线 + 技术栈占比饼图 + 操作记录 + 品鉴排行 + 快捷入口,核心数据一目了然
- 筑基档案管理:支持基础信息编辑、功法配置(名称+炼气·筑基·金丹)、道心所向设置、形象立绘上传、粒子强度调节、问候语池自定义
- 修行履历管理:拖拽排序、置顶、批量上下架、批量删除,内置Markdown编辑器支持书写+实时预览
- 丹器馆藏管理:分类/品阶/状态筛选、一键导入GitHub、标签输入、封面上传、Markdown简介、拖拽排序
- 传讯玉符管理:四种内置类型,支持图标自定义、排序、显隐控制、拖拽排序
- 洞府全局禁制:基础设置(名称/副标题/三段加载文案/欢迎语/彩蛋开关)、外观设置(主题色/水墨浓度/粒子强度/昼夜模式/人物模型替换与朝向姿势)、账号设置(改密/JWT有效期/登录日志)
- 主题一致性优化:消息提示经
admin/src/utils/message.ts桥接到实例,解决静态message无法消费暗色主题上下文的问题;各页表单实例在页面挂载时即与Form元素连接(Tabs页签设forceRender、加载态用Spin覆盖而非提前return)







