Wishlist · 关注清单通信

每 2 小时自动收集你关注的游戏、动画、影视剧、商品、艺人演出的最新消息，编成报纸式的简报网页（GitHub Pages）。每个作品一个固定版面、用它自己的配色，新消息直接更新进各自的版面：一周内的按重要度和时间显示，更早的收进可展开的「更多消息」，旧消息永远保留。 有要紧消息（定档、开放预约、下次测试公布……）当天立刻通过 Discord 通知；其余的每周一发一次周报。

思路参考 agents-radar：信息由脚本从免费 RSS / API 抓取，AI 只负责把抓到的标题编排成几条报道，不让 AI 自己联网搜索，token 消耗很低。

架构图

哪个任务在哪个环境跑、数据怎么流、哪些要钱（网页版，其他图解见下面「流程」）：

愿望清单

看到喜欢的东西，跟 Claude 说「加进 wishlist」并附上截图或链接就行（做法写在 .claude/skills/wishlist/SKILL.md）。 数据在 wishlist.yaml，图片在 docs/wishlist/；网页上是单独的子页面（wishlist.html，主页报头右上角有入口，可按 想要 / 已入手 / 没买到 筛选），推送后 Discord 会收到一条带大图的通知。 填了 watch（关联的关注项）的，版面上会顺带显示那个关注项的最新消息。 愿望清单页顶部有「📷 拍照加愿望」：上传一张照片、选「想要」或「纠结」，照片先存进数据库；GitHub Actions 每 2 小时导出到 inbox/photos/，Claude 定时任务（「愿望清单 · 照片加愿望」）按 PHOTOS.md 认出物品、整理好加进 wishlist.yaml。网页上能看到每张照片的进度（排队中 → Claude 处理中 → 已加入）。 主页的「我会喜欢？」角落每条都写明真实的推荐理由，不让 AI 联网。已经在各个版面里的消息（和别家报道的同一件事）不放进来，投过票的也不再推荐：

• 因为你想要：消息标题命中愿望清单里某件东西的 likes（喜好标签，至少一个具体喜好；来自关注版面的要命中两个以上）；
• 你关注的「X」还有这条：关注的版面里收集到、但没上版面的其他消息（最近 3 天，每项最多 2 条，Reddit 网友帖不算）；
• 你赞过「那条」：和你赞过的消息有共同的喜好或是同一个作品时，理由后面补这一句；
• 同类新发现：按 items.yaml 里每个关注项的 similar（同类搜索词）搜 Google 新闻，去掉已经在关注的作品。

搜新消息每 12 小时一次，每次用新的随机种子：每个关注项随机挑 2 条 similar，再随机搜 6 个喜好关键词（赞过的更容易抽到），搜到的跨次累积；种子和搜索词记在 state/discover.json。 网页像 B 站首页：每次打开、每次「换一批」都先放没出现过的，点开看过的排到最后，全看过了按最早出现的轮回来；「上一批」可以回去。看过的记在这个浏览器里。

每条推荐下面有 👍 喜欢 / 👎 不感兴趣；版面上的每条消息右上角也有小的 👍 / 👎。投票存进 Supabase（Postgres 数据库，设置见下面「数据库」），每次出刊时从投票学习口味：

• 赞过的消息命中的喜好标签、具体关键词（如「猫」「Snoopy」）、所属作品各 +1，踩过的各 −1，累加起来给之后的候选加减分（最多 +4 / −6）。 普通消息按标题对照愿望清单的 likes 找标签；
• 同一条消息在页面上几处出现时（头条、版面），按钮状态一起变；
• 踩过的那条消息、和别家报道的同一件事不再推荐；
• 「同类新发现」常赞的同类排前面，净踩两次以上的同类先不推荐；
• 卡片上写明起作用的投票，如「按你的投票：猫 +2」。再点一次已选中的按钮是撤销。

流程

流程图：什么时候跑、隔多久、最快多久看到结果、哪些要钱（网页版）

其他图解想细看时再点开：

设计稿源文件在 design/（Claude 设计画布格式，修改时用）。

分两步，中间用 inbox/ 里的数据文件衔接。

GitHub Actions 的安排：

items.yaml
  │
  ├─ ingest（收集，免费）
  │    抓取  Google 新闻 / Bing 新闻 / Reddit / Steam / AniList / TMDB / 任意 RSS
  │    过滤  时间窗口 + 关键词 + 与往期去重
  │    输出  inbox/YYYY-MM-DD.json（原始条目、状态变化、封面）
  │
  └─ publish（出刊）
       编排  按优先级：inbox/YYYY-MM-DD.edit.json（人工或 Claude 写的）
                     > Claude API（summarize: true 时）
             版面只放 AI 整理过的报道；还没整理的条目不上版面，列在版面底部折叠的「整理待ち N 件」，
             例外是要紧消息（urgent_patterns）马上做「重大」（关键词规则 fallback_stories）。后台ゲート看到整理待ち就叫 AI 编辑
       配图  Reddit 图 / 文章预览图 / 作品封面；配色取自作品主视觉
       输出  reports/YYYY-MM-DD.json + docs/index.html（GitHub Pages）→ Discord 通知

版面规则：

• 直接回答你最关心问题的新消息（例如公布了测试时间、上线日期）标为重大，单独占满一整行
• 其余第一条做头条大图，后面两条放侧栏，剩下的三栏一排
• 没有新消息的关注项本期不出现；播出状态、价格等只在有变化时才显示

第一次设置

1. 开启 GitHub Pages：仓库 Settings → Pages → Build and deployment → Source 选 Deploy from a branch，分支选默认分支，文件夹选 /docs。 简报地址：https://cxelegy.github.io/Wishlist/

2. 连接 Claude API（可选，默认不用）：只有 summarize: true 时才需要，二选一

   A. Workload Identity Federation（推荐，不需要存任何 Key）

   1. 在 Claude Console → Settings → Workload identity → Connect workload → 选 GitHub Actions

   2. 按向导填写，匹配条件这样填（只允许这个仓库的默认分支）：

      • Subject prefix：repo:CxElegy/Wishlist:ref:refs/heads/main
      • Audience：https://api.anthropic.com
      • Claims：repository_owner = CxElegy

   3. 向导完成后会给出 federation rule ID（fdrl_ 开头）和 service account ID（svac_ 开头）；organization ID 在 Settings → Organization

   4. 回到 GitHub：仓库 Settings → Secrets and variables → Actions → Variables 标签页 → New repository variable，添加：

      Name	Value
      ANTHROPIC_FEDERATION_RULE_ID	fdrl_...
      ANTHROPIC_ORGANIZATION_ID	组织 ID（UUID）
      ANTHROPIC_SERVICE_ACCOUNT_ID	svac_...

      这些只是 ID，不是密码，所以放 Variables 而不是 Secrets。

   B. API Key：在 Secrets 标签页添加 ANTHROPIC_API_KEY。

   不配置时，没被 AI 编辑整理的条目先放在「整理待ち」里，等 Claude 定时任务（AI 编辑）整理后再上版面。

3. Discord 通知：在 Discord 频道 → 编辑频道 → 整合 → Webhook → 新建 Webhook → 复制 Webhook 网址， 然后在 GitHub 仓库 Settings → Secrets and variables → Actions → Secrets 添加 DISCORD_WEBHOOK_URL。

   其它可选的 Secrets：

   名称	用途
   REDDIT_CLIENT_ID / REDDIT_CLIENT_SECRET	Reddit 常拦截云服务器的匿名请求，用官方 API 才稳定。在 reddit.com/prefs/apps 创建一个 script 类型的应用即可（免费）
   TMDB_API_KEY	关注影视剧时需要，在 themoviedb.org 的账号设置里免费申请

4. 数据库（可选，Supabase / Postgres）：存「我会喜欢？」的 👍 / 👎 投票、收集到的每条消息、编排后的报道、价格 / 状态历史。没设置时网页上不显示投票按钮，消息也只存在 inbox/。

   1. 在 supabase.com 注册（免费），New project 新建一个项目（名字随意，数据库密码自己记下）。
   2. 左侧 SQL Editor → 把 db/feedback.sql 整段粘贴进去 → Run。建好 feedback 表：网页只能往里新增投票，读不到也改不了。 再新建一个查询，把 db/news.sql 粘贴进去 → Run。建好 news 表：每次收集后写入新消息（同一关注项的同一条链接只存一行），第一次运行会把 inbox/ 里已有的全部补进去；只有 secret key 能读写。 再运行 db/history.sql：stories 表存编排后的报道（某期重新编排就整期替换），price_history 表存价格 / 状态的变化（Steam 价格、播出状态、愿望清单里写的价格，值变了才新增一行）。 再把 db/sizes.sql 粘贴进去 → Run。建好 sizes 表：每个关注项的篇幅 S（少，每期最多 3 条、网页上约一行）/ M（中等，5 条）/ L（多，8 条、满满一整屏），表里没有的按 M。 只要建一次表：之后新关注项自动补进表里（items.yaml 写了 size 就用它，没写按 M），items.yaml 的 size 改了也会自动同步。 想自己改：打开网页右上角的 ⚙ 设置（settings.html），点 S / M / L 就行，下次出刊生效；简报正文里不显示篇幅。 设置页不用口令（网页是公开的，知道网址的人也能改；真被乱改，在 Table Editor 里改回来）：把 db/settings.sql 运行一次。
   3. 项目的 Connect 按钮（或 Project Settings → Data API）里复制 Project URL；Project Settings → API Keys 里复制 publishable key（sb_publishable_ 开头）和 secret key（sb_secret_ 开头）。
   4. 把 Project URL 和 publishable key 填进 items.yaml 的 settings → supabase_url / supabase_key（publishable key 本来就是公开给网页用的）。
   5. secret key 放进 GitHub 仓库 Settings → Secrets and variables → Actions → Secrets，名字 SUPABASE_SERVICE_KEY。不要写进任何文件。

   投票在每次出刊（每 2 小时）时读出来学习，同时存一份到 state/feedback.json。 消息、报道、价格每次运行后写进数据库，已同步到哪记在 state/db_news.json、db_stories.json、db_prices.json；数据库连不上不影响出刊，下次运行再补。想手动补一次：SUPABASE_SERVICE_KEY=… python scripts/digest.py sync-db。 注意：网页是公开的，知道网址的人理论上也能投票（只能新增）；真有乱投，在 Supabase 的 Table Editor 里删掉那几行即可。

5. 运行：Actions → 关注清单通信 → Run workflow（勾选“顺便发一次周报”可以测试 Discord）。之后会自动运行；想改频率，改 .github/workflows/digest.yml 里的 cron。

添加关注项

在网页上加：打开 ⚙ 设置页 最下面的「新增关注项」，只写个名字，然后一问一答： 是哪一个（自动去维基数据查，补上中日韩英的正式名称、Steam / AniList / TMDB 编号和官网）→ 这是什么 → 关注它的哪方面（比如游戏本体还是电竞比赛） → 哪些消息要当天推 Discord → 不想看什么 → 新闻语言 → 板块（可以起新板块）→ 篇幅，最后汇总成一张表，都能直接改，提交就行。 已有的关注项点列表里的「改」：直接改汇总表，或者「重新问一遍」。不用口令。 请求存进数据库 item_requests 表（db/item_requests.sql），一提交数据库就立刻叫 GitHub 的「网页请求」工作流处理（db/instant.sql，令牌存在 Supabase Vault），写进 items.yaml、网页更新（事件触发，没有定时轮询；设置页上会显示进度）： 新增的追加到末尾、开始收集（往前补抓 first_lookback_days 天），Discord 收到「新增关注项」通知；修改的只改提交了的字段，别的字段和注释不动。 没处理的（名字重复、规则写错）在设置页上写明原因。想更精细（status、配色、背景说明）跟 Claude 说「完善关注项」。

版面主题：每个新关注项都由「AI 编辑」按 TEMPLATES.md 设计版面主题（背景花纹、题字形状、照片边框、点 👍 的演出），先从库里的 30 套挑，挑不到就新做，相似的合并；主题库在 templates/（index.yaml 一览 + 每套一份 CSS，只用作品自己的配色），👍 演出 20 种在 scripts/likefx.py。一览和试玩：テーマ見本。设计好之前先按类型借用相近的主题。

手动加：编辑 items.yaml，文件开头有每个字段的说明。最重要的几个：

• keywords：各语言的正式名称都写上
• priority：你最关心它的什么，比如「什么时候能玩」「第二季什么时候播」「什么时候降价」
• type：game / anime / show / product / category
• urgent_patterns：什么样的标题算要紧消息（正则），命中就当天通知 Discord
• theme：可选，手写配色；不写就从封面自动取色
• news_langs：新闻语言区。中文用 zh-TW（港台媒体）；默认不收中国大陆网站（常拦海外服务器、图片防盗链，链接和配图容易失效），某一项确实要大陆新闻时再写上 zh-CN

本地运行

pip install -r requirements.txt
python scripts/digest.py --dry-run   # 只看抓到了什么，不写文件
python scripts/digest.py             # 收集 + 出刊
python scripts/digest.py ingest      # 只收集到 inbox/
python scripts/digest.py publish     # 只出刊（用最新一份 inbox，有 .edit.json 就按它编排）
python scripts/digest.py render      # 改了版式后，用已有数据重新生成网页
python scripts/digest.py notify-urgent   # 把还没通知过的要紧消息发到 Discord
python scripts/digest.py notify-weekly   # 发过去 7 天的周报
python scripts/digest.py sync-db         # 把消息、报道、价格历史写进数据库（需要 SUPABASE_SERVICE_KEY）
python -m unittest discover tests       # 运行测试（本地假网站，不联网）

成本

默认完全免费：收集、关键词编排、配图、取色都不调用任何付费接口。

想让 AI 按关注重点挑选和合并（标题保留原文，不翻译），有两种方式：

• 在 Claude 里让 Claude 读 inbox/ 写 .edit.json（用你的 Claude 订阅，不另外付费）
• 打开 summarize: true 并配置 Claude API（按量付费，默认 claude-haiku-5-5，十几个关注项每周大约几美分）

目录

素材のクレジット

• 版面の物のアイコン（テニスボール・ネコ・スキーヤー・剣と盾）：Twemoji（CC-BY 4.0）
• 作品の小元素の画像は各ファン Wiki・Wikipedia の画像。切り抜いたものは docs/emblems/、元の網址は items.yaml の source。