HK//HACKERSHACKATHONS · KAGGLE · FOR BEGINNERSEN
HACKERS / 黑客松

Codex x TwitchCon Hackathon 2026:面向 Twitch 聊天的新手开发指南

OpenAI 和 Twitch 拿出 $25,000,奖励用 Codex 做出的 Twitch 互动项目,前五名将于 11 月 15 日在 TwitchCon San Diego 的 Codex 展台舞台上展示。截止时间是 2026 年 11 月 2 日 2:00 pm PT(太平洋时间),大约还有一周。这里的大多数点子都要经过聊天室,所以动手之前,我们在 10 月 26 日录了 5 分钟真实的 Twitch 聊天。最热闹的频道 5 分钟里有 957 人发了 2,230 条消息,最忙的一秒达到 37 条。而非管理员的机器人每秒只能发 1 条。只有 2% 的消息是 "1"、"A"、"yes" 这类单独的回答,一半的发言者只说了一句。照这样的人群来设计:统计投票而不是逐条回复,命令要短,让观众的第一条消息就有效果。

这场比赛已经结束,攻略保留作参考。下一届的规则、评审和日期可能会变,请先看官方页面。

截止已截止
奖金—
官方页面 ↗

头脑风暴词云

公开页面上的文字还太少,暂时提取不出关键词。赛题或作品集内容多起来后,词云会自动出现。

关键信息

要做什么
面向 Twitch 主播及其社区的互动体验,必须在提交期内用 OpenAI Codex 开发。它必须连接 Twitch,例如通过聊天、直播叠加层(overlay)、Twitch API、EventSub 或扩展(Extension),并且要能像视频里展示的那样运行 ↗
奖金
第一名 $10,000,第二名 $6,000,第三名 $4,000,两名优胜奖各 $2,500,均附 TwitchCon 舞台展示时间。前往 TwitchCon 的差旅自费,不到场也不会失去奖金 ↗
提交内容
GitHub、GitLab 或 Bitbucket 仓库,包含全部代码和运行说明(私有仓库须在 GitHub 或 GitLab 上,并共享给 testing@devpost.com);一段说明如何使用 Codex 的文字介绍;主要开发所在 Codex 线程的会话 ID(在 Codex 中输入 /status 查看);以及一段公开的 YouTube 视频,短于 3 分钟 ↗
视频需要两类画面
规则要求视频既展示项目在 Twitch 上运行,也展示它是如何用 Codex 做出来的。评委不必看超过 3 分钟的部分,也可以只看视频和文字评审,不实际测试 ↗
谁能参加
年满 18 岁(或居住地法定成年年龄,取较大者)的个人和团队。组织机构不能参加,巴西、魁北克、俄罗斯、克里米亚、古巴、伊朗、朝鲜及其他受全面制裁地区的居民也不能参加。每人可提交多个作品,但每个都必须有实质区别 ↗
聊天到底有多快(我们的实测)
2026 年 10 月 26 日 05:57 UTC 起,我们用匿名 IRC 连接读取了 5 分钟公开聊天。caseoh_ 有 957 人发了 2,230 条消息,平均每秒约 7.4 条,最忙的一秒 37 条,消息长度中位数 10 个字符;其中 491 人只发了一条。summit1g 峰值每秒 11 条;amouranth 有 42% 的消息只有表情 ↗
机器人能发多快
不是主播、管理员或 VIP 的机器人,每 30 秒最多 20 条、每个频道每秒最多 1 条;身为主播、管理员或 VIP 时每 30 秒 100 条。超限后 Twitch 会在 1 小时内忽略该机器人的消息。30 秒内发送相同内容会被以 msg_duplicate 拒绝 ↗
这周别指望认证机器人
认证机器人每 30 秒可发 7,500 条,但 Twitch 表示聊天机器人认证审核目前暂停,所以请按普通限额来规划 ↗
加入频道
一个账号最多同时在 100 个聊天室(自 2024 年 5 月 15 日起),每 10 秒最多尝试加入 20 次。超过 1,000 人的房间里,机器人收不到 JOIN 和 PART 消息,因此不能靠它来数观众 ↗
Skill Rank 的数据
2026 年 10 月 26 日 PocketPlay Skill Rank 收录的 1,024 个智能体技能中,没有一个提到 Twitch、EventSub 或直播。这个目录里没有现成的技能可用,要留出读 Twitch 文档的时间 ↗

选题方向

以下是我们根据官方方向和聊天实测给新手的选题思路,不是官方命题。

只计票不回复的观众投票(观众参与)

读取每条消息,按 10 秒窗口统计答案,并在叠加层上显示结果。每个窗口只发一条机器人消息,即使聊天每秒 37 条,也远低于每秒 1 条的限制。提示要清楚:没有提示时,只有 2% 的消息像投票。

Raid 欢迎包(主播协作)

监听 raid 事件(IRC 中 msg-id 为 raid 的 USERNOTICE,或对应的 EventSub 事件),给前来 raid 的社区在屏幕上设一个简短的共同目标。黑客松论坛已经有人组织 raid 互换,可以为视频拿到真实的 raid 画面。

第一条消息就上屏(观众参与)

caseoh_ 上一半的发言者只说了一句。把观众的第一条消息变成看得见的东西,比如名字加入地图或队伍;可以利用 viewermilestone 通知,Twitch 文档说它用于观众首次发言等里程碑。

只用表情的游戏输入(内容增强)

amouranth 有 42% 的消息只有表情。把表情当作操作的游戏,在房间开启只允许表情模式、屏蔽普通文字时依然能玩。

感知房间模式的叠加层(设计)

房间会在 ROOMSTATE 中通告仅关注者、慢速、仅表情和 r9k 模式。告诉观众在当前模式下哪种输入还能用,免得大家刷一个被房间屏蔽的命令。

评审标准

规则:第一阶段按是否符合主题、是否使用 Codex 做通过/不通过筛选。通过的项目按四项同等权重的标准评分,得分最高的五个成为决赛入围者。平分时先比创新/创意(Innovation/Idea)得分,再比下一项。规则允许专家评审、同行评审和自动化 AI 分析。 来源 ↗

创新/创意(Innovation/Idea)25%

概念与现有想法相比有多新。主办方把 Twitch Plays 游戏、投票和骰子工具列为起点而非模板,照搬这些会吃亏。

潜在影响(Potential Impact)25%

对主播及其社区有多有用或有趣。展示真实主播或真实 raid 在使用,而不是空荡荡的测试频道。

技术实现(Technological implementation)25%

做得有多好、Codex 用得有多好。会话 ID 和视频里的 Codex 画面就是证据。

设计(Design)25%

是否好用、看起来是否有趣。观众每条消息大约只打 10 个字符,所以在直播画面上,一个单词的命令比表单更好用。

入门技术栈

  • Example Chatbot (Twitch docs) Twitch 文档里的示例聊天机器人,也是主办方推荐的入门教程。这是一个 Node.js 机器人,监听 EventSub WebSocket wss://eventsub.wss.twitch.tv/ws,需要 user:bot、user:read:chat 和 user:write:chat 权限,通过 POST https://api.twitch.tv/helix/chat/messages 回复。它会用 VoHiYo 回应 HeyGuys ↗
  • Chat & Chatbots overview 速率限制、加入限制、Chat Bot 徽章(主播用 App Access Token 和 channel:bot 权限授权 Channel Chat Message 订阅后获得)以及认证暂停的说明 ↗
  • Twitch IRC irc://irc.chat.twitch.tv:6697 或 wss://irc-ws.chat.twitch.tv:443。请求 tags 和 commands 能力,才能收到 ROOMSTATE、USERNOTICE 和表情位置。我们用匿名 justinfan 登录读取聊天,能用,但文档里没有写;只用于原型,提交的版本请换成经过授权的机器人 ↗
  • OpenAI Codex 为项目开一个线程,并把大部分开发放在里面;提交时要填这个线程的会话 ID ↗
  • TwitchDev Discord 主办方的答疑频道是 #codex-twitchcon-hackathon ↗

时间线

  1. 提交期开始(10:00 am PT)
  2. 提交截止(2:00 pm PT),之后草稿锁定
  3. 评审开始(9:00 am PT)
  4. 评审结束(5:00 pm PT);获奖者约在 11 月 15 日于 TwitchCon San Diego 公布

新手怎么做完

  1. 确认参赛资格

    阅读规则第 3 节。组织机构和被排除地区的居民无法获奖。

  2. 先开 Codex 线程

    为项目新开一个 Codex 线程,用 /status 记下会话 ID。Codex 开发时录几分钟屏幕,因为视频必须展示这一部分。

  3. 跑通示例聊天机器人

    在 dev.twitch.tv 创建应用,获取带 user:bot、user:read:chat 和 user:write:chat 的令牌,让 HeyGuys 到 VoHiYo 的回复在你自己的频道跑通。其余功能都建立在这个循环上。

  4. 规划机器人的发言额度

    按每秒 1 条、每 30 秒 20 条来设计。把回复合并成每个窗口一条汇总消息,30 秒内不要重复同样的文字。

  5. 处理房间模式

    读取 ROOMSTATE,在自己的频道打开慢速模式和仅表情模式测试项目。

  6. 让真实观众入镜

    11 月 1 日前参加黑客松论坛的 raid 互换,或请主播朋友帮忙,让视频展示有人在 Twitch 上实时使用你的项目。

  7. 剪一段 3 分钟以内的视频

    先放 Twitch 画面,再放 Codex 画面,最后一句话说明主播能得到什么。以公开方式上传到 YouTube。

  8. 11 月 2 日 2:00 pm PT 前提交

    仓库附运行说明、说明如何使用 Codex 的介绍、会话 ID 和视频链接。尽早保存草稿:截止后什么都不能改。