概览

站点 —

数据在服务器目录 data/：store.json（含各页组件编排 pageComposer）、product-cards.json（商品详情数据）、uploads/（文件库）。部署 HTTPS 后，将站点根地址写入小程序 config/contentApi.js 的 baseUrl。

—
页面组件条目
—
文件库
—
商品卡
—
注册会员
—
合作申请
—
待审灵感
—
待审评论

最近保存：—

  • 「页面编排」与小程序一致：探索为顶栏（花色、材料、门墙系统等）+ 左侧子目录（爱格、克诺斯邦…）；发现含推广区与三个 Tab；首页 / 智境 / 我的 为分级目录。左栏点选后可在右栏改目录名称、增删子级，并在当前目录下直接添加组件与开关（商品详情卡可暂不填 ID）。改目录显示名并保存时，会按节点内部 id 不变自动更新 /uploads/… 引用、product-cards.json 里的同路径，并尝试移动 data/uploads 下对应文件夹；若你改了节点的 id，则无法自动对应旧路径。删除此分类会经两次确认，确认后将一并递归删除 data/uploads 下与当前目录对应的本地文件夹（灵感目录 inspirations 受保护不可删）。
  • 旧版 v1 编排与错误示例分区会在保存时自动升级为 v2 树形；历史条目不保留时以小程序默认结构为准。
  • 公有部署请设置 ADMIN_API_TOKEN，并在「系统」填写密钥；多机/多环境请用「系统」里的从远程拉取 / 推送到远程统一 JSON，并让小程序 baseUrl 指向有数据的那台服务。
  • 公开只读：GET /content/product-cards/:id、GET /content/page-composer、GET /content/app-chrome、GET /content/ai-page、GET /content/search、会员注册与合作/灵感投稿等 /content/*；监控：GET /health。

部署 HTTPS（Nginx 反代示例）

免费证书可用 Let’s Encrypt（Certbot）。将 your-domain.com 换成你的域名；Node 监听 127.0.0.1:3780。

server {
  listen 443 ssl;
  server_name your-domain.com;
  location / {
    proxy_pass http://127.0.0.1:3780;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 20m;
  }
}

在顶栏选择页面后，从左栏目录进入具体分类，在右栏改名、增删分类并管理组件开关。

图片建议尺寸（全站按用途统一，详见各编辑栏）：详情轮播 9:12（如 1080×1440）；卡片封面 4:5（800×1000）；通栏横条约 3:1（1200×400）；中段图 9:12；Hero 16:9；视频封面 16:9。小程序端为自动适配、不裁剪主体。

主导航 Tab 与首页 Logo

底栏五个 Tab 的键位固定（首页 / 探索 / 智境 / 发现 / 我的），仅可改显示名称与图标 URL。首页顶栏需两套品牌图：logo1 用于未滑动、浅色顶栏；logo2 用于滑动后、深色顶栏。请先在「文件库」上传到对应目录再选图或粘贴 /uploads/... 地址。

加载中…

智境对话页外观

对应小程序「智境」全屏对话顶栏与输入框文案。Logo 请先在「文件库」上传（建议目录与页面编排「智境」一致），再选图或粘贴 /uploads/...。小程序通过公开接口 GET /content/ai-page 拉取（需在 contentApi.baseUrl 指向本后台）。

加载中…

注册会员

来自小程序「手机号注册」，数据在 data/members.json。

    合作申请

    小程序「申请合作」提交，data/cooperation.json。

      灵感投稿审核

      会员发布需审核通过后出现在发现 Tab；数据 data/inspirations.json。发现页「社区A/B」瀑布流上方的运营头图请在 页面编排 → 发现 中编辑对应组件（与商品详情卡相同表单）。

        灵感评论审核

        详情页提交的评论；通过后出现在小程序。数据 data/inspiration-comments.json。

          上传到文件库

          上传素材建议与页面编排一致：轮播/中段 9:12；通栏 约 3:1；卡片/封面类 4:5（与「页面编排」各栏说明相同）。

          保存页面编排或启动后台时，会自动在 data/uploads/ 下按树形分类建好同名文件夹（与文件库下拉路径一致），你也可直接在资源管理器里往对应目录拖图。

          全站专用目录（不占「一级/子级」树）：可直接切到 _详情页底部署名、_探索页顶部横栏、_首页顶部Logo、_首页Tab图标 上传，选中后无需再选子级。旧版曾用文件夹 _探索页_顶部通栏 会在启动/保存时自动合并进 _探索页顶部横栏。

          其余素材须先选「页面」再选一级 / 子级目录；有子分类时必须选到具体子夹，禁止堆在未归类的根目录或只选父级。发现页路径为 发现/顶部推广区、发现/实景案例 等。若你曾把图放在顶层 实景案例/，保存时会改写 JSON 引用；请把文件移到 data/uploads/发现/实景案例/ 后再同步云开发。

          当前目录：未选择

          可同时选多张，将依次上传。

          已上传文件

          组件库（固定类型）

          页面编排「新增组件」会从这里的固定类型中选择。可先按固定类型上线，后续如需再扩展自定义组件。

            商品详情卡数据源

            详情内容已统一在页面编排中维护：进入对应页面与目录，添加或选中「商品详情卡」组件后点编辑，即可编辑详情 ID、轮播、参数、中段图等；保存后仍写入本站的 product-cards 数据源（与小程序一致）。此处不再提供单独列表，避免两处重复维护。

            维护人员：按这几步做

            1. 启动本后台：web-admin 里运行 npm start（或双击 启动后台.cmd），窗口不要关。
            2. 改内容：在左侧「页面编排 / 文件库」里编辑；保存即写进本机 data/。
            3. 发到微信云：点下面「同步数据到云开发」（需 .env 已配腾讯云密钥，见下文）。
            4. 看小程序：微信开发者工具里点「编译」。图片若显示不出，看本页「图片说明」。

            正在读取服务状态…

            ① 云同步（微信云数据库）

            在 web-admin/.env 填写三项（勿提交到 Git）：TCB_CLOUD_ENV（环境 ID）、TCB_SECRET_ID、TCB_SECRET_KEY。保存后重启 npm start。 同步会把本机 store.json（含探索 + 发现编排）和 product-cards.json 写入云库。

            须用本页所在 Node 地址打开（不要只用 Live Server 打开静态页），否则同步按钮会失败。

            本机 data/uploads：保存编排 / 商品卡 / 启动服务时不会自动删除「未写进 JSON」的素材，可先放入文件夹再在选图里使用；确认无用后点此按钮或调用 POST /api/uploads/prune-unused 再清理。（若需恢复旧版「保存即删孤儿」，启动前设置环境变量 MOLISPACE_AUTO_PRUNE_UPLOADS=1。）

            说明：云函数只负责把数据库里的 JSON给小程序；图片要能显示，地址必须是小程序能访问的（cloud://、https:// 等）。不勾选上传时，/uploads/ 仍指向你电脑/自建站，真机常打不开。

            云存储清理（仅 molispace-admin/）：多次同步可能留下已不再被 JSON/数据库引用的图片。可先扫描再批量删除孤儿，无需去云开发控制台逐个找文件。

            ② 管理 API 密钥（可选）

            若服务器设置了环境变量 ADMIN_API_TOKEN，浏览器里也要保存相同密钥，否则「同步 / 导出 / 云存储扫描」等 /api/* 会 401。/content/* 只读接口一般不需要。

            ③ 复制给小程序同事用的地址

            当前站点根（无末尾斜杠），用于配置服务器域名或排查接口。

            商品详情：—

            页面编排：—

            ④ 多台电脑 / 远程统一数据（进阶）

            两台机器各跑一份后台时，可用远程根地址拉取 / 推送 JSON（不含 uploads 图片文件）。若设了 ADMIN_API_TOKEN，两端密钥须一致。

            ⑤ 导出备份

            详细说明见同目录 UPDATING.txt。