论坛界面改动与站外服务须知（运营用）
日期：2026-10-07
适用于：想对论坛的外观、界面或功能提出修改需求的所有人
提需求之前请先读完这份文档。
一、先说结论
论坛是在现成的 Discourse 系统上搭起来的，不是我们自己从 零写的。这有两个后果：
- 改“长相”很便宜：颜色、Logo、字体、间距，大部分在后台点几下就能改。
- 改“结构”和“用法”很贵：每多改一处，就多一份永远甩不掉的维护负担。Discourse 每隔几周更新一次，改得越深，每次更新坏得越多。
所以，所有界面需求都按下面的 四个等级 分类处理。等级越高，门槛越高。
| 等级 | 一句话 | 谁来做 | 要多久 | 态度 |
|---|---|---|---|---|
| 1 | 后台有现成选项 | 运营自己 | 几分钟到几小时 | 随便 提 |
| 2 | 只改样子，不加东西 | 懂 CSS 的人 | 几小时到几天 | 可以提，说清楚改哪 |
| 3 | 页面上多出原来没有的东西 | 程序员 | 几天到几周，之后一直要维护 | 默认不做，要过审 |
| 4 | 改变页面的结构或操作方式 | 一整个前端团队 | 几个月，之后永远要维护 | 不做 |
二、四个等级的判断标准
等级 1：后台设置
标准：在后台（/admin）的设置搜索框或 外观 菜单里，能找到对应的选项。
例子：
- 换配色方案、换 Logo 和网站图标
- 换字体
- 首页默认显示“最新”还是“分类”
- 顶栏、侧边栏加减链接
- 全站横幅公告
怎么判断：先自己去后台搜。搜得到，就是等级 1，自己改，或者告诉管理员改。
等级 2：只改样式
标准：页面上的东西 一样都不多、一样都不少、用法完 全不变，只是看起来不一样。
例子：
- 某个按钮换个颜色、变大一点
- 帖子之间的间距调小
- 某个用不上的元素藏起来
- 卡片改成圆角
怎么判断：拿一张现在页面的截图，用红笔标注“这里改颜 色”、“这里大一点”、“这里藏掉”。如果红笔标注能说清楚全 部需求，就是等级 2。
提需求时必须附上：标注好的截图，电脑版和手机版各一张。
等级 3：添加新东西 
标准：页面上要 出现原来没有的东西，或者要 根据数据显示不同内容。
例子：
- 首页加一个“本周热门画师”区块
- 帖子旁边加一个自定义的小部件
- 根据用户身份显示不同的横幅
- 重新设计顶栏
这一级要说清楚的事：
- 这是写代码，不是改设置。 需要一个专门懂 Discourse 前端（Ember 框架）的程序员，普通前端不一定会。
- 做完不是结束，而是开始。 每一个等级 3 的改动都是 长期负债。Discourse 会定期淘汰旧接口，论坛每次升级， 这些改动都可能悄悄坏掉，每次都要有人检查、修复。
- 没有人长期维护，就不做。 一个做完就没人管的小部件 ，迟早变成一个坏掉的小部件。
- 能用等级 1、2 解决的，绝不升到等级 3。 能用现成的 社区组件解决的，也绝不自己写。
提需求时必须回答下面全部问题，缺一项不予受理：
- 这个东西解决什么 真实发生过 的问题？请举出具体的 用户、具体的事例。“我觉得会更好看”、“别的网站有”不算。
- 谁会用？多久用一次？
- 不做的话，会发生什么坏事？
- 有没有用现有功能加人工操作代替的办法？为什么不行？
- 画出来：放在哪个页面、哪个位置、长什么样（草图即可） ，电脑版和手机版都要。
等级 4：改变结构或操作方式 
标准：下面任何一条成立，就是等级 4：
- 话题列表、帖子页、发帖编辑器的 排版结构 要变
- 用户的 操作流程 要变（比如“发帖的方式改成……”）
- “做成像 小红书 / Instagram / 某某 App 那样”
- “我们自己做一套前端，后台用 Discourse”
这一级原则上不做，理由如下：
- 这等于重写论坛。 工作量按月计算，需要一个前端团队 ，不是一个人。
- 做完之后，我们就背上了一个自己的论坛分支。 以后 Discourse 的每一次更新，包括 安全补丁，都要先跟我们的 改动对一遍才能装。实际结果通常是：不敢升级 → 安全漏洞补 不上 → 论坛变得不安全。
- 我们选 Discourse，就是为了不做这些事。 真想要一个 完全不同的界面，正确的做法是重新评估“要不要用 Discourse”，而不是去改它。
如果你的想法落在这一级，请不要提需求。请先回头想一想：你真正要解决的问题是什么？这个问题能不能用等级 1 到 3 的办法解决？
三、提需求之前的自查
按顺序问自己，在第一个回答“是”的地方停下：
- 后台搜得到对应的设置吗？ → 等级 1，自己去改。
- 只改颜色、大小、间距、显示或隐藏吗？ → 等级 2，带上标注截图来提。
- 要加新东西吗？ → 等级 3，先回答第二节里的五个问题，再来提。
- 都不是？ → 等级 4，先别提，回到“我到底要解决什么 问题”。
如果你要的不是“界面”，而是“一个新功能”（涉及钱、数据、自动流程），请看第四节。
提醒：一个模糊的想法，比如“首页不好看”、“想要更有氛 围”，不是需求，是感受。把感受变成等级 1、2 的具体改动， 是提需求的人的工作，不是技术的工作。
四、站外服务（svc）：另一条路，但不是捷径
1. 它是什么
任务单、付款这些功能，不是论坛自己的功能。它们运行在我们自己的另一台小服务器上（下文叫 svc，地址是论坛域名下的一个子域名），然后以“窗口”的形式嵌进论坛帖子里。用户看起来是在论坛里操作，实际上操作的是 svc。
它的工作方式：
- svc 的机器人账号在帖子里发一个 svc 链接，单独占一行，论坛就会把它显示成一个嵌入窗口。普通用户贴同样的链接 ，只会显示成普通链接。
- 用户第一次在窗口里操作时，会弹出一次论坛登录确认，之后 svc 就知道他是谁。
- svc 里发生的事（比如任务单状态变了），由机器人在对应的论坛帖子里发帖通知。
- 付款时整个页面跳到 Stripe 付款页，付完再跳回原来的帖子。
2. 为什么有这条路
论坛（Discourse）只管“发帖、回帖、分类、私信”。需要保 存业务数据、涉及钱、需要自动按规则推进的东西，论坛做不了，硬塞进论坛就是第二节说的等级 3、4。
svc 把这些东西放在论坛外面做：
- 论坛本身一行代码都不用改，论坛升级不受影响。
- 新增一个服务，论坛这边只要在设置里加一行地址。
- svc 出故障时，嵌入窗口会变成空白，但论坛照常可用。
3. 代价：它不是免费的
在 svc 里做一个新服务，本质上就是开发一个新的小网站 。门槛和等级 3 一样高，甚至更高：
- 要写代码，要长期维护。 服务器、数据库、备份、安全 更新，全都是我们自己的事，没有 Discourse 社区帮我们兜底 。
- 数据分在两个地方。 任务单的数据在 svc，聊天记录在 论坛。查一件事，经常两边都要看。
- 嵌入窗口永远是“二等公民”：
- 样式和论坛不完全一致，看得出是嵌进去的；
- 手机上的显示效果要单独调；
- 论坛的搜索搜不到窗口里的内容；
- 窗口里的事情不会出现在论坛的通知铃铛里，只能靠机器人发帖提醒。
- 权限是分开的。 论坛管理员、版主的身份，在 svc 里不自动生效。svc 里谁能处理任务单、谁能改费率，在 svc 里单独授权。这是刻意的安全设计，不会改。
4. 什么时候用，什么时候不用
适合放进 svc 的，必须至少满足一条：
- 涉及 钱（收款、退款记录、费用）；
- 需要 保存结构化数据，而且要按规则改状态（比如任务 单的“草稿 → 已锁定 → 执行中 → 已完成”）；
- 必须 自动发生，不能等运营手动操作（比如付款后自动 出现付款按钮）。
不适合放进 svc 的：
- 论坛现有功能（分类、私信、标签、投票、置顶）加上运营手动操作就能做到的。这是默认方案。 先用人工跑起来，确 实跑不动了再谈自动化。
- 只是想要“一个更好看的页面”。那是界面需求，回到第二节按等级处理。
- “把整个论坛首页或帖子页在 svc 里重做一遍，再嵌回论坛。” 这就是换了个地方做等级 4，代价一样，而且体验更差。不做。
5. 只能嵌我们自己的服务
嵌入窗口 只接受我们自己子域名下的 svc 地址。下面这些请求不会被接受：
- “把 Google 表单 / 腾讯问卷 / 某某工具嵌进帖子里”：第三方网站拿不到论坛的登录身份，用户在窗口里填的数据也会直接交给别人的公司。需要用第三方工具，发普通链接即可。
- “把某个外部网站整个嵌进来”：同上，而且对方随时可以改内容，我们控制不了。
6. 提 svc 需求之前要回答的问题
在第二节等级 3 的五个问题之外，再加三个：
- 上面第 4 小节里的三条（钱、结构化数据、必须自动），满足哪一条？
- 先用论坛加人工的办法跑过吗？跑了多久，具体卡在哪里？
- 这个服务出故障停掉一天，运营能不能手动顶上？怎么顶？
五、运营不要自己做的事
- 不要在正式论坛后台直接改 CSS 或 HTML。 所有样式改 动都由技术保存到代码库里，先在测试环境试过，再上线。直接在后台改，出了问题没法追查，也没法撤回。
- 不要自己新建、安装或切换主题。 任务单、付款这些嵌 入页面，依赖一个挂在现有主题上的组件。换成新主题而没有重新挂上这个组件，任务单和付款会直接失效，而且页面不会报错，很难发现。
- 不要自己在嵌入组件的设置里添加服务地址，也不要改“哪 些账号的链接会被嵌入”。 这两项决定了哪些网页能出现在论坛帖子里，改错了等于给别的网站开门。
- 不要手动在帖子里模仿机器人发 svc 链接，指望它变成窗 口。 只有机器人账号发的链接才会嵌入。需要嵌入窗口时， 按
artist-onboarding-ops-guide.md的步骤操作