自己做了个能接大模型的 Steam 笔记管理助手

270878 · 发表于昨天 22:45 · 美国

本帖最后由 270878 于 2026-2-9 23:29 编辑

前情提要

《自己做了个 Steam 库管理助手（重大更新）》
《如何批量将 Steam 笔记和 Steam 分类上传到云？》

原本只是想让 AI 给我小号的游戏库生成一些"游戏介绍"笔记，好让我朋友登上我号时能快速判断该玩什么。没想到功能越做越多——从基础的笔记管理去重到 AI 批量生成，再到 Steam Cloud 直传和多账号管理，最终演变成了现在这个 Steam 笔记管理助手。因为完全是用 ai 做的，所以前后只花了三天时间左右。大部分精力用在调试 bug 和极端情形测试上面。

原则上这个软件应该和 Steam 库管理助手整合起来，发挥最大功效。比如说根据提示词给 Steam 游戏分类、根据 ai 对游戏的熟悉程度分类等等。但有位真的懂编程的大佬对我那个 Steam 库管理助手感兴趣，甚至体贴地帮我拆了架构，所以后续准备花点功夫研究他的工作成果。另一方面各种事情也多起来了，整合两个程序也得花时间，所以决定现在把这个能跑的先放出来。说实话，想做的事情真的太多太多了，想实现的功能也太多太多了。。。我慢慢搞

声明与风险提示

请务必做好数据备份！
本程序会直接修改 Steam 笔记的本地配置文件（位于 userdata/<用户ID>/2371090/remote/），虽然程序已经过大量测试，但仍然存在导致已有笔记丢失或恶性 bug 的风险。我自己就意外遇到过几个恶性的云存档冲突导致笔记不显示的问题，花了点时间修掉。
建议从未写过 Steam 笔记（或笔记不多）的朋友优先尝试。如果你已有大量重要笔记，请先手动备份笔记目录再使用。
之后会在帖子内陆续更新，提升可用性！增加新功能！降低使用门槛！

软件简介

Steam 笔记管理助手是一个基于 Python + Tkinter 的桌面工具，核心功能包括：
* 手动创建、编辑、删除 Steam 笔记（内置富文本编辑器，所见即所得）
* 调用 AI（Claude / GPT / DeepSeek 等）批量为游戏库生成"游戏说明"笔记
* 通过 Steamworks API 将笔记直接上传到 Steam Cloud
* 多账号管理、笔记导入导出、去重、搜索、筛选等

环境准备与运行方式

下载地址：GitHub - Steam-Game-Notes

环境要求：
* Python 3.12+（建议 3.12 或 3.13）

运行方式：
直接运行 Steam_Game_Notes.py 即可。

如需使用 AI 功能：
进入程序后，点击“🔑 API Key 设置”，配置你的 AI API Key。支持多个令牌，可选择不同提供商和模型。

如需使用 Steam Cloud 直传：
1. 确保 Steam 客户端正在运行
2. 库中至少有一个已安装游戏（程序需要其中的 libsteam_api 动态库）
3. 在程序主界面点击“☁️ 连接 Steam Cloud”
4. macOS 用户首次使用可能需要在系统设置中允许加载动态库

跨平台支持

* ✅ Windows
* ✅ macOS
* ✅ Linux
* ✅ WSL（Windows Subsystem for Linux）

主要功能详解

1. 富文本笔记编辑

这部分 bug 还比较多，但感觉不是什么很重要的功能，就没怎么修，使用体验很不好。
* 内置所见即所得（WYSIWYG）富文本编辑器，支持 Steam 笔记的全部 BBCode 标签：粗体、斜体、下划线、删除线、H1/H2/H3 标题、有序/无序列表、分隔线、代码块、URL 链接。
* 编辑器提供工具栏按钮，无需手写 BBCode。高级用户可随时切换到"源码模式"直接编辑 BBCode 原文。
* 支持嵌套标签（如 加粗斜体）和任意深度的复杂格式。
* 自动识别 URL 并高亮为可点击链接。

2. AI 批量生成游戏说明

这是本软件的核心功能之一。通过调用 AI API，为你 Steam 库中的游戏批量生成客观、实用的"游戏说明"笔记。

支持的 AI 提供商：
* Anthropic (Claude) — 支持可选的联网搜索功能（🔍 勾选即可让 Claude 上网查找游戏信息）
* OpenAI (GPT 系列)
* DeepSeek
* 任意 OpenAI 兼容 API（可自定义 URL，支持 new-api / one-api 等第三方中转）

AI 笔记的写作原则：
* 软件提供可编辑的默认提示词
* 每条笔记自动带有 AI 声明前缀（🤖AI:），标注模型名和确信程度，可按确信程度分类。

AI 生成的辅助信息源：
* 自动通过 Steam Store API 获取游戏详情（开发商、发行商、标签、Metacritic 评分、发行日期等）
* 自动抓取 Steam 玩家评测（好评/差评各取最有帮助的若干条，含好评率和评价等级）
* Claude 提供商可额外启用联网搜索

批量生成的控制功能：
* 支持暂停 / 继续 / 停止，暂停后队列自动保存，关闭窗口后再打开可从断点继续
* 可按 Steam 收藏夹（分类）筛选要处理的游戏
* 可选择跳过已有 AI 笔记的游戏，或重新生成覆盖
* 支持扫描他人 Steam 库（输入 Steam ID / 好友代码，适合家庭共享场景）
* 生成完成后可在同一界面直接上传到 Steam Cloud

多令牌管理：
* 支持保存多个 AI 令牌（每个含名称、提供商、模型、API URL、Key）
* 批量生成时通过下拉框自由切换不同令牌

3. Steam Cloud 直传

这是 v4.0 引入的重大改进。程序通过 Steamworks API（ISteamRemoteStorage::FileWrite）将笔记直接上传到 Steam Cloud，无需再手动在 Steam 客户端中触发云同步。

使用方式：
启动 Steam → 打开本程序 → 点击“☁️ 连接 Steam Cloud”→ 正常编辑/生成，保存后即上传

技术细节：
* 自动搜索已安装 Steam 游戏中的 libsteam_api 动态库（Windows / macOS / Linux）
* 账号匹配检测：连接时会核对 Steam 客户端当前登录的账号与程序选择的账号是否一致，不匹配则拒绝连接，防止笔记上传到错误账号
* 延迟上传机制：所有改动先保存到本地并标记"待上传"（dirty），用户可选择逐条或批量上传
* 持久化 dirty 检测：上传后记录文件 MD5 哈希，重启程序后能自动识别哪些笔记需要重新上传
* Steam 进程监控：连接后每 5 秒检测 Steam 是否在运行，关闭则自动断开 Cloud

4. 笔记管理功能

* 搜索：支持两种模式——按游戏名 / AppID 搜索，或按笔记内容搜索
* 筛选：全部 / AI 已处理 / AI 未处理 / 按具体 AI 模型分类 / 按确信度筛选（🟢很高 🔵较高 🟡中等 🟠较低 🔴很低）/ 有未上传改动
* 去重：一键扫描所有笔记中标题+内容完全匹配的重复项，可选择删除
* 全选：一键选中当前筛选条件下的所有游戏，方便批量操作
* 笔记排序：支持上移 / 下移调整笔记顺序

5. 导入 / 导出

导出两种模式：
* 逐条导出：每条笔记保存为独立 .txt 文件（文件名 = 笔记标题，内容 = BBCode）
* 合并导出：所有笔记写入单个结构化 .txt 文件（含 AppID 分隔标记），可在其他账号上导入还原
* 支持仅导出 AI 笔记（勾选“🤖 仅导出 AI 笔记”）

导入两种模式：
* 单条导入：选择一个 txt 文件，作为一条笔记导入到指定游戏下
* 批量导入：选择合并导出格式的 txt 文件，自动按 AppID 分发到对应游戏
* 导入时若存在 AI 笔记冲突，会弹出冲突处理窗口，可逐一对比、替换、追加或跳过
* 导入操作永远追加，不覆盖已有笔记（AI 笔记冲突除外）

6. 多账号管理

* 启动时自动扫描本机所有 Steam 账号
* 支持一键切换账号
* 每个账号的笔记目录自动定位

7. 游戏名称显示

* 笔记列表显示游戏名而非单纯的 AppID
* 通过 Steam 全量应用列表（约 15 万条）一次性获取，缓存到本地
* 无需 API Key 即可解析任意 AppID 对应的游戏名

注意事项与已知问题

重要注意事项：
* 使用前请备份笔记目录！笔记文件位于 <Steam安装目录>/userdata/<用户ID>/2371090/remote/
* 程序的配置文件和缓存统一存放在 ~/.steam_toolbox/ 目录下
* Steam Cloud 上传后，仍需等待 Steam 自动同步到云端（通常很快，但偶尔有延迟）
* 连接 Steam Cloud 时务必确保 Steam 客户端登录的账号与程序选择的账号一致，否则会被拒绝连接
* AI 生成的笔记质量取决于所用模型对该游戏的了解程度，冷门游戏的描述可能不够准确（确信度会标注为"较低"或"很低"）

AI 使用建议：
* Claude 的联网搜索功能可以显著提高冷门游戏的描述质量，但有额外费用（Anthropic 官方 API 约 $10/1000 次搜索）
* 使用第三方工具（自定义 URL）时，联网搜索功能不可用
* 生成大量笔记时建议分批进行，善用暂停/继续功能
* 建议先小批量试生成几条，确认效果满意后再大批量运行

已知问题：
* macOS 上 Python 如果未安装系统证书，SSL 连接可能失败（程序已内置 fallback 机制，但仍建议运行一次证书安装脚本）（作者注：我不知道这段话是什么意思，但 AI 强调了我也不好删掉）
* 富文本编辑器目前体验很差

更新日志摘要（v2.0 → v5.3）

* v2.0：带 GUI 的完整版本，基础笔记创建/查看/编辑/删除
* v2.1：富文本编辑器（WYSIWYG）+ 导入导出系统
* v2.2：AI 批量生成功能上线（调用 Claude API）
* v2.5：Steam Web API 在线扫描游戏库 + AI 声明前缀
* v2.7：多 AI 提供商支持（Claude / GPT / DeepSeek / 自定义）
* v3.0：持久化配置 + AI 前缀识别 + Steam 分类筛选
* v4.0：Steam Cloud 直传（重大改进，通过 Steamworks API 直接上传）
* v4.5：Steam 评测接入 + Claude 联网搜索 + 确信度 emoji
* v4.8：多令牌管理
* v5.0：批量生成暂停/继续/停止 + 关闭时上传提示
* v5.2：Cloud 账号不匹配检测 + 导入 AI 冲突处理 + 持久化 dirty 检测
* v5.3：主界面 UI 大幅重排 + 导入冲突双模式 + 笔记去重

致谢与反馈

本程序在 AI（Claude）的辅助下开发完成。欢迎在帖子下方反馈 Bug 或提出功能建议！
如遇问题，也可以到 GitHub 提 Issue。

前情提要

声明与风险提示

软件简介

环境准备与运行方式

跨平台支持

主要功能详解

1. 富文本笔记编辑

2. AI 批量生成游戏说明

3. Steam Cloud 直传

4. 笔记管理功能

5. 导入 / 导出

6. 多账号管理

7. 游戏名称显示

注意事项与已知问题

更新日志摘要（v2.0 → v5.3）

致谢与反馈

本帖子中包含更多资源

本帖被以下淘专辑推荐:

▘片十字花瓣

▘十字花瓣

积分封禁

预备会员

超级版主

研发支持

认证发行商

浪人

平台开发者

绿光作者

QQ游客

初阶会员

实习版主

管理员

版主

禁言会员

封禁帐户

封禁网段

游客

待验证用户

论坛贵宾

群组维护

进阶会员

高阶会员

精锐会员

支柱会员

核心会员

旗舰会员

毕业会员