使用 Discourse MCP 快速构建主题

,

通常,建立社区时最大的障碍在于“如何让它具有自己的特色”。

你希望字体、风格都能与你的品牌相匹配。

在这篇文章中,我想介绍如何通过以下方式相当直接地实现这一目标:

我选择 Codex,是因为最近发布的 GPT-6 Astra 是一位才华横溢的视觉艺术家。Kimi K3Fable 在这方面也很强,但在这个演示中,我使用的是 Astra。

步骤 1 - 生成 API 密钥

前往:your.site/admin/api/keys/new

生成一个全局 API 密钥。

安全提示:请妥善保管此密钥,考虑在工作完成后将其撤销,因为它提供了对站点的无限制访问权限。

步骤 2 - 添加 Discourse MCP

在本教程中,我使用的是 Codex:

编辑:~/.codex/config.toml

[mcp_servers.discourse]
command = "npx"
args = [
  "-y",
  "@discourse/mcp@latest",
  "--toolsets",
  "all",
  "--allow-writes",
  "--site",
  "https://figment123.discourse.group",
  "--auth_pairs",
  '[{"site":"YOUR_SITE","api_key":"YOUR_API_KEY","api_username":"system"}]',
]

(注意:Codex 不允许你选择启用或禁用哪些 MCP,配置中的所有 MCP 都会被启用。你可以添加 enabled = false 来临时禁用某个 MCP)

:writing_hand: 关于工具的一点说明:Discourse MCP 支持 140 多种工具,此配置使它们全部可用。像 Claude 和 Codex 这样的现代框架可以很好地处理这种情况,但许多框架可能会难以应对如此高的工具数量——例如,Grok build 将需要过滤)

添加 Discourse MCP 后,请确保你的智能体可以访问它:

步骤 3 - 为你的智能体提供完成工作所需的工具

如果智能体拥有以下工具,其表现会显著提升:

  1. 眼睛,即看到其工作成果的能力。(playwright MCP、计算机使用等)
  2. 上下文,Discourse MCP 有帮助,Discourse 源代码也有帮助
  3. 图像生成——如果你需要素材等。

ChatGPT 应用内置了浏览器,请确保它使用了该功能。请确保克隆 discourse/discourse 代码库,并从 Discourse 目录启动你的智能体。

这些都不是必需的,但拥有它们会带来显著更好的结果。

步骤 4 - 赋予你的智能体智能和清晰的简报

在这种情况下,鉴于我希望看到非常好的结果,我选择了 GPT-6 Astra XHIGH。

接下来,我用 AI 编写了一个小简报,说明我想要什么(一个《纽约客》风格的社区主题)

AI 编写的简报

构建 The Salon,一个精致的 Discourse 主题,展示客户如何彻底改变 Discourse 的身份。创意参考是*《纽约客》*:一个读者参与对话的编辑机构。创建一个原创的身份,而不是复制品——不要使用借用的标志或未经授权的专有字体。使用温暖的象牙色(#F7F4ED)、近黑色墨水(#20201E)、克制的编辑红色(#B52B32)、细线条、慷慨的留白、表现力强的衬线标题、易读的衬线正文文本和紧凑的无衬线元数据。单色插图应增添机智和个性。你拥有创作自由,可以获取、下载或生成演示所需的任何素材——字体、插图、摄影、头像和图标——使用适当许可的材料,并在需要时保留归属信息。避免通用的 SaaS 卡片、仿羊皮纸和装饰性杂乱。目标是创建一个拥有内部活跃社区的当代文学杂志,而不是一个颜色不同的库存论坛。

你被明确授权为演示实例设置类别、主题、回复、虚构的贡献者个人资料和支持内容,以使体验具有吸引力。 保留现有的真实内容,并保持虚构活动明显可识别为演示数据。创建五个编辑部门——The Commons, Arts & Letters, City Life, Science & Ideas, Table Talk——具有独特的描述和插图。构建一个强大的 THE SALON 报头、精选的领先讨论、次要标题和最新对话部分。播种深思熟虑、多样化的讨论,如“什么时候每个爱好都变成了副业?”和“什么才能真正改变你的想法?”,具有令人信服的开场帖、实质性的分歧、简短的回复、引用和精心选择的图片。填充足够的内容以展示密度、滚动和导航;不要使用重复的填充内容或让重要屏幕留空。每个标题都必须打开一个真实的话题,并且活动、回复计数和未读状态必须保持可见。将身份贯穿类别列表、主题页面、搜索和编辑器:开场帖应感觉像排版精美的文章,而回复保持紧凑、可用的对话。移动端应成为平静的单列体验,深色模式也应感觉同样刻意。

在选择实现细节之前,检查目标 Discourse 版本和支持的主题 API。优先选择可维护的主题和集中的主题组件;避免核心补丁、不必要的插件、脆弱的 DOM 操作和发明的功能。使编辑策展明确且可配置。自主处理可逆的设计、素材和设置决策,而不是在每个细节上寻求批准;用具有代表性的主页和填充的主题页面建立视觉语言,然后完成支持表面。交付可安装的主题、所需的组件、可重现的演示内容设置、素材来源和简明的安装说明。在真实的 Discourse 实例中验证结果,包括桌面和移动端的键盘导航、对比度、未读状态、搜索、引用和编写。捕获应用主题前后的相同阶段社区,以便转换不可否认。标准是客户就绪的演示——不是模型,不仅仅是漂亮的主页,而是一个连贯、工作的社区,具有完全不同的场所感。

  • 根据需要查阅 Discourse 源代码
  • https://figment123.discourse.group/ 是一个演示站点,你可以随意处理它,一边查看结果一边启用主题
  • 根据需要创建主题

步骤 5 - 看起来很棒!

一小时零十分钟后,Astra Xhigh 完成了。

一个受 New Yorker 启发的精美主题。

这个主题并不完美,它有一些边缘情况,我建议进行步骤 6 优化,在那里你可以粘贴设计出现偏差的区域,让智能体进行修复。但作为一个起点,我们今天能做的就是绝对惊人的。一年前这是不可能的。

实时优化示例:

3 个赞