wow-site

wow-site 是一个个人《魔兽世界》粉丝站点，托管于 https://wow.batserver.au。它使用手写的 HTML、CSS 和 JavaScript， 没有框架或构建步骤，外加一个无依赖的小型 Node 服务器，用于暴雪角色装备 API。

目录

• site/index.html — 着陆页和工具索引

• site/gear-advisor.html — 装备顾问工具

• site/styles.css — 共享站点主题

• site/gear-advisor.css / site/gear-advisor.js — 仅装备顾问

• site/season-data.js — 共享赛季轨道和暴雪奖励 ID 映射

• site/assets/ — 网站图标和图片

• server.mjs — 静态交付、暴雪 API 适配器和内存缓存

• mcp_server.py — 官方 SDK v2 MCP 接口，由同一角色 API 支持

• Dockerfile.mcp / requirements-mcp.txt — 隔离的 MCP 边车镜像

• test/ — Node 内置测试套件

Related MCP server: wow-mcp

工具

装备顾问

将赛季的装备升级轨道与你的物品等级进行比较。移动滑块，每个等级会重新着色为升级、平级或降级；每个轨道还会报告第一个超过你的等级及其所需的纹章成本。

赛季编号和暴雪升级奖励 ID 是特定于补丁的，位于一个地方：site/season-data.js。

角色查询使用暴雪的服务器到服务器客户端凭证流程。角色装备在内存中缓存五分钟。对同一角色的并发请求会被合并，并且立即刷新可以在冷却一分钟后绕过常规缓存。暴雪媒体响应和 OAuth 令牌有各自更长的缓存。特定区域服务器下拉列表来自暴雪的 Realm Index API，并缓存一天。选择器从一个安全的占位符和一个简短的有用选项列表开始，在浏览器空闲时填充，并将获取的列表以及访问者上次的区域选择保存在浏览器存储中，以便下次立即访问。

当前第 2 赛季轨道通过暴雪的物品 bonus_list 解析，而不是从物品等级推断。没有已知当前赛季奖励的物品显示为旧版/未知，而特殊的 Ascendant 物品则获得明确的特殊状态。独立于该来源，每个已装备的槽位将其物品等级与每个第 2 赛季轨道进行比较，并显示该轨道上第一个严格物品等级升级的等级。此详细比较在每个物品卡片上独立折叠，因此当前路径摘要仍然是主要视图。

MCP v2

位于 /mcp 的公共 Streamable HTTP 端点使用官方 Python SDK v2，并公开五个只读的结构化工具：

• get_character_equipment 返回与站点使用的相同的角色、物品、当前路径、替换阈值、获取时间和缓存数据。

• get_character_talents 返回当前专精、英雄天赋树、当前职业/专精/英雄天赋选择以及游戏内导入代码。

• get_character_profile 返回简洁的身份和进度上下文，包括物品等级、成就点数、当前赛季史诗钥石评分和最佳副本记录。

• get_character_achievements 返回完成总数、点数以及最多 25 个近期成就，而不输出完整的数千条历史记录。

• list_realms 返回某个区域的暴雪服务器 ID、显示名称和别名，以便代理可以验证查询输入。

所有工具都调用现有的内部 JSON API，因此它们共享其每分钟 60 次请求的调用者限制、五分钟的角色缓存、一天的服务器缓存、请求合并和强制刷新冷却。每个工具调用，包括验证、上游和速率限制错误，都会作为结构化 JSON 写入容器日志和 /data/queries.jsonl。审计记录包括查询、结果、持续时间、缓存状态、协议/客户端元数据和调用者地址；它们从不包含暴雪凭据或访问令牌。持久文件以模式 0640 创建在 0750 状态目录内。

本地运行

npm test
docker build -t wow-site .
docker run --rm --env-file /path/to/wow-site.env -p 8080:80 wow-site

然后打开 http://localhost:8080。

部署

生产环境在基础设施仓库的规范 Compose 文件中定义，位于 /mnt/docker/infra/config/dockerconfigs/docker-compose.yml，作为 wow-site 和 wow-site-mcp 服务。两者都从此目录构建，因此完整部署为：

docker compose -p config -f /mnt/docker/infra/config/dockerconfigs/docker-compose.yml \
  up -d --build wow-site wow-site-mcp

Traefik 将 wow.${DOMAIN_PRIMARY} 路由到端口 80 上的站点，并将路径特定的 /mcp 路由到端口 8767 上的 MCP 边车。

生产环境加载 ${MOUNT_STATE}/secrets/wow-site.env，包含：

BLIZZARD_CLIENT_ID=...
BLIZZARD_CLIENT_SECRET=...

可选的调优变量包括 CHARACTER_CACHE_TTL_SECONDS（默认 300）、 REFRESH_COOLDOWN_SECONDS（默认 60）、MEDIA_CACHE_TTL_SECONDS（默认 86400）、REALM_CACHE_TTL_SECONDS（默认 86400）和 BLIZZARD_TIMEOUT_MS（默认 10000）。

备注

• 该站点目前是公开的 — 无需身份验证。*.batserver.au 解析为 WAN 地址，因此此处提供的任何内容都可以通过互联网访问。

• 公开查询既不保存也不预设个人角色。持久的个人角色状态属于保留的 /my/ URL 前缀下，该前缀目前为空，以后可以放在身份验证后面。

• robots.txt 禁止爬取。