为你的桌游收藏打造推荐助手

Piotr Grudzień
发布日期 阅读时间约 12 分钟
Shelf Night 在 Google Sheets 中的收藏和已记录的 Cascadia 对局,旁边是对应的 Quickchat AI 推荐

面向自家收藏的桌游推荐助手会根据今晚的人数、可用时间和偏好,筛选你已拥有的游戏。Shelf Night 从 Google Sheets 读取收藏,确认后记录已完成的对局,再利用日志避开最近玩过的游戏。

四个人围坐桌旁,有一小时可以玩,架子上放着 Azul 和 Cascadia。第一份候选清单包含这两款游戏。记录一局 Cascadia 后,下一次查询会排除它,只留下 Azul。

Google Sheets 中记录的 Cascadia 游玩日期,旁边是 Shelf Night 新给出的 Azul 推荐 最终目标:Cascadia 已记入游玩日志,请 Shelf Night 避开最近玩过的游戏时,它会推荐 Azul。

Google Sheets 截图展示的是我们已连接的测试文件。Quickchat AI 截图使用本地应用,显示实际运行的测试 Agent 所记录的回复和 Action 结果。

你会先搭建收藏读取功能,再加入确认后记录对局和检查近期游玩的功能。你将同时验证保存的行和助手的回答。

下载 Shelf Night 入门套件。其中包含两个以制表符分隔的电子表格文件、完整提示词、三份操作配置方案和测试清单。这些是可编辑的参考文件,不会自动导入为智能体。截图和可复制的设置使用英文界面标签。

按步骤整理收藏、连接电子表格、获取推荐、记录对局,并避开近期玩过的游戏。

你的桌游之夜选游助手会知道什么?

Shelf Night 将已记录的游戏信息与你家的偏好结合起来。表格用不同的列分别存放这些内容,便于助手解释推荐依据。

三项筛选检查:已拥有的游戏、匹配的人数和充足的时间 拥有状态、支持人数和计划用时,分别排除不同类型的不合适推荐。

示例使用两款真实的基础版游戏,以及两个刻意设置的边界案例。发行商标注 Azul 支持 2–4 人,Cascadia 支持 1–4 人。我们虚构的家庭为这两款游戏都预留 60 分钟,包括准备和规则讲解。这是我们自己的安排,不是发行商对时长的保证。

Azul 和 Cascadia 的产品图片、官方标注的支持人数和游玩时长,以及家庭预留的 60 分钟 请核对你架上游戏的版本。产品图片:Next Move Games / Asmodee 和 Alderac Entertainment Group / Flatout Games。发行商标注的时长与你们预留的时间是两个独立数值。

你需要一个 Quickchat AI 账户、一个可授权 Sheets 连接的 Google 账户,以及几款待录入的游戏。BoardGameGeek 账户不是必需的。请查看你账户当前的 AI 点数和操作额度;对话和 Simulation Testing 都会消耗点数。

第 1 步:如何整理你的桌游收藏?

先从少量可以逐一核实的游戏开始。在请助手挑选之前,为每款游戏记录固定 ID、拥有状态、支持人数范围和预留时间。

  1. 打开套件中的 Collection.tsv。保留表头名称和顺序。先完成首次测试,之后再将示例行替换为自己的游戏。
  2. 为每盒游戏分配固定的 game_id,例如 SHELF-001。如果版本或扩展会影响规则,请在标题中注明。不要把扩展当作独立游戏。
  3. 从包装盒、规则书或发行商处抄录支持人数。将 planning_minutes 设为你们这组玩家所需的时间,包括规则讲解。未经核实的值留空。
  4. 自行选择 complexity 标签,例如 light 或 medium。明确记录拥有状态。愿望单条目的 owned 应设为 FALSE。
示例游戏人数预留时间是否拥有演示要点
Azul,SHELF-0012–460 分钟TRUE信息完整的候选游戏
Cascadia(基础版),SHELF-0021–460 分钟TRUE稍后会记录游玩并排除的候选游戏
愿望单示例,SHELF-0032–445 分钟FALSE条件合适也可能尚未拥有
尚未编目的旅行游戏,SHELF-004最少 2 人;上限未知未知TRUE缺失的信息必须保留为未知

Google Sheets 的 Collection 标签页包含四款示例游戏,并放大显示人数、时间和拥有状态列 初始收藏中有两款资料完整的候选游戏、一条未拥有的游戏记录,以及一条资料不全的记录。每次排除的依据都能从源数据中看到。

其余列为 source_url、last_played 和 language_note。有来源链接时请保留,在语言备注中填写你所持版本的信息,并在第 5 步用公式填充 last_played。拥有游戏不代表盒子此刻就在家里:请告诉助手排除已借出的游戏。

能从 BoardGameGeek 收藏导出文件开始吗?

可以。登录你自己的 BGG 账户,打开收藏,使用收藏下载功能导出已拥有的游戏。单独保留原始 CSV,检查实际表头,再将相关值转入本模板。缺失的支持人数或预计时间,请根据你持有的版本补齐,不要让模型猜测。

BGG 的官方访问条款区分了登录后下载个人收藏与需要注册的自动化 API 访问。本方案采用手动导出或手动录入,不需要 BGG API 连接,也不会同步 BGG 上的变更。

第 2 步:如何将 Google Sheets 连接到助手?

请使用通过 Quickchat AI 的 Google Sheets 连接创建的电子表格。该连接的文件权限不会自动覆盖你云端硬盘中任意一份现有电子表格。

  1. 创建 Quickchat AI 账户。使用初始智能体,或选择 Add new AI Agent → Set up manually。将其命名为 Shelf Night。
  2. 打开 Your Website → Install → Availability and access。关闭 Widget & Embed access,并设置 Chat Page Access → Nobody。首个版本仅在需要登录的 AI Preview 中使用。
  3. 打开 Actions & MCPs → Add Action → Google Sheets,完成 Google 授权。该集成会请求有限的 drive.file 权限范围,并创建包含 Leads 工作表的电子表格。
  4. 修改前先停用自动生成的 log_lead_to_google_sheet 操作。保留名称,让连接仍能识别它。选择 Open sheet,将文件重命名为 Shelf Night。
  5. 将 Leads 重命名为 Plays,把 Plays.tsv 粘贴到 A1,替换旧表头,然后添加 Collection 工作表。Plays 至少保留 501 行,Collection 至少保留 101 行。
  6. 在 File → Settings 中,将区域设置选为 United States,以便使用套件中以逗号分隔参数的公式。输入日期前,将 Plays 的 A 列设为 Plain text。将 Collection.tsv 粘贴到 Collection!A1,让 I 列的公式正常计算。冻结每个表头行并加粗;加宽列或启用换行,方便阅读。

本文的紧凑视图暂时隐藏了 C:F、H 和 J 列,以便清晰显示游戏、拥有状态和最近游玩日期。原始 Collection 标签页仍有十列,Action 的 A:J 读取范围也没有变化。

Shelf Night 的网站访问设置,组件和嵌入访问已关闭,Chat Page Access 设为 Nobody 连接收藏之前,先设置这两项访问控制。本教程使用控制台中的 AI Preview。

Google Sheets 连接教程介绍了授权界面。不要把 BGG 私人评论和无关收藏数据放入这个小型演示文件。

第 3 步:如何从自家桌游架获取推荐?

添加一个只读操作,并为智能体设定使用响应的规则。这就足以生成第一份实用的候选清单;记录对局的操作可以继续保持关闭。

读取收藏

打开 Actions & MCPs → Add Action → API Action → Create manually。将操作命名为 Read Shelf Night collection,设置 When to run → AI decides,并输入:

GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101

Headers
Authorization: Bearer {{google_sheets_access_token}}

将 YOUR_CREATED_SHEET_ID 替换为已停用的初始操作 URL 中现有的 ID。从 Add AI Data → System Tokens 使用内置的 Google Sheets 令牌;保留变量形式,不要粘贴访问令牌。文件 ID 和范围应固定,不设输入参数、不设请求体、不设查询参数。将 Response filter 留空。

在 API Action Description 中使用以下内容:

Read the collection before recommending games. Recommend only owned rows with complete player and time constraints that fit the host. Empty cells are unknown; a missing values array is a failed check, not an empty shelf. Use only returned facts and owner notes.

Quickchat AI 中的收藏读取操作,使用固定的 Google Sheets 范围 同时读取表头和收藏数据行。不要让对话内容控制电子表格和读取范围。

保存并启用该操作。运行 Test Response,将 values 与表格对照。Google 的 values.get 端点默认返回格式化后的单元格值;数字和布尔值可能以字符串形式返回,末尾的空单元格可能被省略。行较短不代表可以编造缺失值。

为 Shelf Night 设定规则

打开 Identity → Main Prompt,粘贴套件中的 main-prompt.txt 并保存。筛选规则很明确:重新读取收藏,要求已拥有且限制信息完整,最多返回三款匹配游戏,并说明缺失的信息。

Shelf Night 的 Identity 页面及其 Main Prompt 摘录 Main Prompt 说明如何选择。这两张局部截图展示其位置和开头指令;操作负责提供当前收藏数据。

在 AI Preview 中提问:

Four players, 60 minutes, something light. What do we own that fits?

初始 Google Sheets 收藏,旁边是 Shelf Night 推荐的两款游戏 第一个实用回答:Azul 和 Cascadia 均满足已记录的拥有状态、人数和时间限制。

使用示例数据时,Azul 和 Cascadia 符合条件。愿望单条目因未拥有而被排除;旅行游戏则信息不足。在 Inbox 中打开已保存的对话,展开操作调用,检查返回值。通过操作卡片上的 View logs 查看完整请求记录。

在 Quickchat AI 的 Inbox 中展开收藏读取调用 将回复与背后的数据进行对照。操作标记表明发生过调用,而调用结果能告诉你助手实际收到了什么。

让 ChatGPT 或 Claude 帮忙准备设置

Quickchat AI 的账户管理连接可以准备 Main Prompt 和 HTTP 操作。按照账户管理指南,通过官方 ChatGPT 页面或 Claude 页面连接。附上套件并发送:

Use Quickchat AI to prepare Shelf Night from the attached main-prompt.txt and action-recipes.json. Identify the intended Agent before changing it. Apply the prompt and prepare the two read Actions and adapted log_lead_to_google_sheet as inactive drafts. Preserve the starter Action's name. Use the actual spreadsheet ID from my Google Sheets connection. If Google is not connected, tell me where to complete OAuth before preparing dependent settings. Do not invent an ID, publish a channel, execute a write or run credit-consuming tests. Show me the saved configuration and remaining manual steps.

你仍需授权 Google、填充表格并核对真实数据行。通过助手准备设置,并不代表这些步骤已经完成。

第 4 步:如何记录一场已完成的桌游对局?

每场已完成的对局记录一行,追加前必须确认。推荐 Cascadia 绝不能被当作已经玩过 Cascadia。

从报告对局、确认,到新增日志行和后续推荐的流程 日期和游戏 ID 将已完成的对局与下一份候选清单联系起来。

为游玩日志添加读取操作

创建第二个操作,命名为 Read Shelf Night plays,采用与第一个操作相同的 GET 设置和令牌请求头,将范围改为:

https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501

将其描述设为:

Read recorded plays when excluding repeats, before logging a confirmed play, after an append, and whenever a write result is uncertain. Match stable game IDs. An absent play is not proof that a game was never played.

保存并启用。即使日志为空,也应返回表头:played_date、game_id、players、duration_minutes、note。

修改初始操作,用于追加对局

编辑已停用的初始操作,保留名称 log_lead_to_google_sheet。替换原有的潜在客户参数、请求体、描述和思考提示消息。沿用的名称只是标识符;此操作现在将用于记录游戏。

在 What to ask the user first 下添加:

复制对局参数和追加请求
参数类型是否必填描述
played_dateText是已确认的确切日期,格式为 YYYY-MM-DD。遇到相对日期应询问,不要猜测。
game_idText是Collection 返回且经组织者确认的准确 ID。
playersNumber是已确认的实际参与人数。
duration_minutesNumber是已确认的实际时长,而非预留时间。
noteText否组织者提供的可选事实备注。未提供时留空。

对于 note,选择 Default value → Empty value。使用 AI decides,并将 Response filter 留空。将请求和 Query Params 设为:

POST https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A:E:append

Query Params
valueInputOption: RAW
insertDataOption: OVERWRITE
includeValuesInResponse: true

Headers
Authorization: Bearer {{google_sheets_access_token}}
Content-Type: application/json

在 Body 中,保持 JSON 模式启用,并将初始操作的旧请求正文替换为:

{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}

值的顺序必须与五列一致。RAW 会按原样保存文本,因此以 = 开头的备注不会变成公式。append 端点会找到表格后的下一行;OVERWRITE 会填入这条现有空行,保留其格式和最近游玩日期公式的范围。Google 的 append 参考文档解释了这些选项。让 Plays 保持为一份连续日志,不要在旁边放置其他表格。

从 action-recipes.json 复制追加操作描述。它要求单独确认、检查重复、追加一次,然后再次读取。将思考提示消息设为 Recording the confirmed play...,保存并启用操作。对此 POST 执行 Test Response 可能真的添加一行数据。

游玩、报告、确认

在 AI Preview 中发送:

We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.

助手应展示拟写入的字段,然后等待确认。确认之前,检查 Plays 是否仍未发生变化。

Shelf Night 请求确认五个字段,旁边是 Google Sheets 中空白的 Plays 标签页 Shelf Night 请求确认。实际的 Plays 标签页此时仍然只有表头。

回复 “确认。” 检查追加结果中的 updates.updatedRows: 1、对应的 updatedRange,以及随后的读取结果。实际表格中应包含 2026-11-08、SHELF-002、4、52 和空白备注。

Shelf Night 确认的 Cascadia 对局,旁边是 Google Sheets 中的新行 确认的对局在 Plays 中只出现一次,位于相同的五个表头之下。Agent 在报告成功之前重新读取了日志。

追加操作日志显示 Cascadia 已确认的字段、成功状态以及一行更新记录 追加操作返回了一个已更新的行。返回范围与 Google Sheets 中已填入数据的行一致。

确认和重复检查是智能体指令,不是原子性的数据库约束。请求超时时,请先检查日志再重试。两个并发对话仍可能追加同一份报告;这个小型个人日志并未实现预留机制或事务锁。

第 5 步:如何避开最近玩过的游戏?

使用明确的截止日期读取游玩历史。在示例中,排除 2026-11-01 当天或之后玩过的游戏,会移除 Cascadia,保留 Azul。

套件还在 Collection!I2 中添加了最近游玩日期公式,并向下填充到各示例行:

=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")

公式匹配固定的游戏 ID,将定长 ISO 日期字符串按从新到旧排序,并返回最近一次记录的日期。因此,补录较早的对局不会把它变成最近一次游玩。没有匹配对局时,单元格保持空白。

添加 Cascadia 记录后,检查 Collection!I3 是否显示 2026-11-08。如果单元格直接显示公式文本,请将其格式恢复为自动,再重新输入公式。保持 Plays 中的日期为纯文本;若公式报错,检查区域设置和工作表名称是否完全一致。Google 文档介绍了用于筛选匹配行的 FILTER 函数。

Google Sheets 展示 Collection I3 中的公式及计算出的 Cascadia 最近游玩日期 Collection!I3 根据 Plays 计算 Cascadia 最近一次有记录的游玩。选中的单元格同时展示公式和结果 2026-11-08。

新建对话并提问:

Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.

Shelf Night 排除已记录的 Cascadia 对局后,选择 Azul 新查询排除了已记录的 Cascadia 对局,并返回 Azul。last_played 单元格为空,表示这份日志中没有该游戏的游玩记录。

初始读取范围覆盖 100 款游戏和 500 场对局,不含表头。文件变大后,应让读取 Action 和公式范围与实际记录保持一致。追加设置保持为 insertDataOption: OVERWRITE,避免新记录将公式起始行推移到刚记录的对局之后。

第 6 步:如何检查推荐是否有据可依?

测试收藏无法满足需求的情况。实用的选游助手应解释限制,让你决定调整什么。

提出需求:六人、60 分钟、轻量游戏。两条信息完整且已拥有的游戏记录都不支持六人,而旅行游戏的人数上限未知。助手不应套用 Cascadia 扩展的支持人数,也不应推荐愿望单里的游戏。

Shelf Night 解释示例收藏为何没有已核实支持六人的游戏 没有匹配结果时,答案仍应清楚保留原始限制。你可以添加一款已核实支持六人的游戏,或调整当晚的安排。

使用 Testing → Simulation Testing 进行可重复的检查,并将操作结果与回复一起核对。确认过程应放在同一段对话中,确保“确认”对应一个明确的待批准方案。

Quickchat AI 中已完成的四项收藏测试,以及说明旅行游戏缺少时长信息的回复 保存的收藏测试涵盖正常推荐、六位玩家、未拥有的游戏和缺失信息。除了评分,还要检查对应的 Action 结果。

测试输入检查要点
四人、60 分钟、轻量游戏只有 Azul 和 Cascadia,且理由来自记录
六人没有已核实的匹配项;不编造支持人数
推荐愿望单示例游戏仍然按拥有状态排除
旅行游戏需要多久?缺失的时长仍为未知
报告对局,但尚未确认Plays 不新增行
确认,然后再次确认本次测试只有一行,不执行第二次追加
排除 2026-11-01 当天或之后玩过的游戏记录对局后,Cascadia 被排除

四项收藏检查已在 Simulation Testing 中通过。我们还验证了单独确认、仅追加一行、公式结果、重复确认不再追加,以及排除 Cascadia 的新推荐。在替换示例行之前,请用自己的文件重新执行套件中的检查清单。

检查通过后,将示例行替换为你的收藏。下次大家坐下来时,把人数、时间和想玩的风格告诉 Shelf Night,从返回的选项中挑一款,结束后记录对局。每记录一个夜晚,下一次选择就多一份参考。

如果你还想尝试其他基于收藏的项目,Steam 待玩游戏选择助手采用了相同思路,依据是已记录的游玩时长和个人备注。API 操作构建指南则介绍如何将这种模式应用于其他数据源。

常见问题

桌游推荐助手能否只推荐我拥有的游戏?

可以。这套配置会先读取你的 Collection 工作表,再提供推荐,并要求 owned 为 TRUE。它会核对已记录的人数限制和你的预留时间,然后解释每个匹配结果。请及时更新拥有状态和版本详情。

没有 API 密钥,也能使用我的 BoardGameGeek 收藏吗?

可以。你可以手动下载自己的 BGG 收藏 CSV 文件,或在模板中输入少量桌游。检查导出的列,并根据你持有的版本补齐缺失信息。此工作流程不会调用 BGG API,也不会自动同步你的收藏。

有桌游收藏电子表格模板吗?

Shelf Night 入门套件包含 Collection.tsv、Plays.tsv、最近游玩日期公式、三份操作配置方案、一份 Main Prompt 和测试清单。将工作表文件粘贴到通过 Quickchat AI 的 Google Sheets 连接创建的电子表格中。

预计时间包括规则讲解和开局准备吗?

planning_minutes 列是你家预留的时间,因此可以包含这两项。示例为 Azul 和 Cascadia 各预留了 60 分钟。实际时长在对局结束后填入游玩日志,与计划用时分开记录。

它能避开我们最近玩过的桌游吗?

可以,通过已记录的对局和精确的截止日期来筛选。在经过测试的示例中,记录 2026-11-08 的 Cascadia 对局,再排除 2026-11-01 当天及之后玩过的游戏,就会将它移出下一份候选清单。未记录的对局仍然未知,读取范围也必须覆盖相关历史。

如果已拥有的桌游都不适合这次聚会,会怎样?

助手应解释哪些已记录的限制排除了候选游戏,并询问你想调整什么。它不应编造支持人数、擅自延长预留时间,或改推你未拥有的游戏。

ChatGPT 或 Claude 能帮忙配置吗?

Quickchat AI 的账户管理连接可以根据套件准备智能体提示词和 HTTP 操作。你仍需授权 Google、录入收藏并核对真实电子表格。准备配置不会运行测试,也不会发布智能体。

Quickchat AI Quickchat AI Ask Quickchat AI a question