3.5 KiB
3.5 KiB
Steam Monitor MVP
需求确认
- 产品：《帝国幻想乡~TOHOTOPIA》
- Steam AppID：
3774440 - 信息源：Steam 评测、Steam 讨论区主题和回复
- 刷新：每 30 分钟；第一轮全量，后续增量
- 分类模型：OpenRouter
deepseek/deepseek-v4-pro - 密钥：
.env/ 环境变量OPENROUTER_API_KEY - Dashboard：展示分类、原始链接、是否建议回复、处理状态、制作人/处理人备注
当前计划
- T1 建立 Python/FastAPI + SQLite MVP。
- T2 实现 Steam 评测 API 抓取。
- T3 实现 Steam 讨论区主题和回复抓取。
- T4 实现 SQLite 去重、处理状态和同步游标。
- T5 实现 OpenRouter 结构化分类。
- T6 实现 dashboard、手动同步、状态更新。
- T7 本机 smoke test 并启动局域网服务。
- T8 接入下一个社区平台。
执行记录
- 2026-05-16：创建任务记录，开始项目骨架实现。
- 2026-05-16：完成 Python/FastAPI + SQLite MVP，实现 Steam 评测、讨论区主题和回复抓取，dashboard 展示、手动同步、后台 30 分钟增量同步、处理状态更新。
- 2026-05-16：本机 smoke test 抓取 384 条：评测 132、讨论主题 75、回复 177。未配置
OPENROUTER_API_KEY，模型分析按预期进入 error，配置.env后可补跑。 - 2026-05-16：服务已启动在
http://127.0.0.1:8000。 - 2026-05-16：用户补充
.env后发现“补跑分析”视觉无反应。定位为旧 uvicorn 进程未读新.env，且补跑接口同步等待模型调用。已改为按钮立即返回、后台每批 20 条补跑，并在 dashboard 显示“已分析 / 待补跑”。 - 2026-05-16：服务改为局域网监听
0.0.0.0:8000，当前局域网地址曾检测为http://10.27.16.17:8000。 - 2026-05-16：修复讨论区排序问题。根因是 Steam 讨论区
published_at未解析，已支持x 小时以前、3 月 7 日 下午 4:52、2025 年 8 月 9 日 下午 3:29并回填 252 条讨论区记录。 - 2026-05-16：按用户要求补跑 2026-05-01 之后内容。共 209 条：评测 132、讨论主题 26、讨论回复 51，最终全部
done。 - 2026-05-16：Dashboard 页头新增“最近更新时间”，优先取最近成功同步完成时间，缺失时取最新采集时间。
恢复入口
- 方案文档：
任务/方案/steam社区监控一期计划.md - README：
README.md - CLI：
python -m app.cli sync --full、python -m app.cli analyze-pending --since 2026-05-01 --limit 20 - Dashboard：
python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 - 当前服务：局域网监听
0.0.0.0:8000
当前状态
- 已完成 Steam 一期 MVP。
- 当前数据文件：
data/tohotopia_monitor.sqlite3。 - 当前 dashboard 无登录认证，局域网可访问者可查看和修改处理状态。
- 当前排序：建议回复优先；同组内按发布时间新到旧。
- 当前后台任务：FastAPI 启动后每 30 分钟增量同步。
- 当前 OpenRouter key：来自
.env的OPENROUTER_API_KEY。
下一阶段入口
添加其它社区平台时：
- 先读
AGENTS.md、README.md、本任务文档和任务/方案/steam社区监控一期计划.md。 - 新平台采集器应输出
app.models.RawItem。 - 继续复用
raw_items、analysis_results、work_items。 - 新平台不要把平台私有字段直接塞到 dashboard 查询条件里；先进入
raw_json和统一字段。 - 需要登录态、API、反爬或浏览器自动化的平台，先验证当前事实再实现。