检查一张图是否能下载。零网络调用，纯本地查询（filter.json + 死图缓存）。

适用场景：下载前预检、批量过滤。

查询单张地图的完整详情，包含 phase2 战役判定结果。

默认不返回 description（省 token），需要时设 include_description=True（截断到 500 字符）。

在工坊中搜索战役地图，用 phase2 多因子规则预筛， 自动过滤黑名单和 active 去重。

默认只返回 score≥3 的高可信结果。模棱两可的（score 1-2，可能是 mod） 默认不返回；如需查看，设 include_ambiguous=True。

识别一张图所属的完整系列（所有 Part）。

融合三路信号：①正向依赖(required_items+children+description) ②反向查询作者全部物品(/user-files) ③命名模式识别。

一站式下载：识别 → 解析依赖 → 下载 → 落盘 → 更新去重名单。

适用：用户给出 workshop_id、steam 链接或具体地图名要下载时。 workshop_id 与 title 至少传一个：

• workshop_id 可为纯数字 id、steamcommunity 链接（自动提取 id）

• title 为中文/英文标题时走内部解析链（curated 模糊 → 镜像搜索 → phase2 判定）， 唯一高可信匹配自动下载，多候选返回 candidates[] 待确认

解析地图标题为工坊候选（不下载）。

适用：用户说"XXX 有没有 / XXX 的 id 是什么"，或 install_campaign 传标题 前先看看候选。融合 echocn 人工策展名单与镜像站搜索，按 phase2 判定排序。

查询异步下载任务（install_campaign async_mode=True 时返回的 job_id）进度。

Returns: {job_id, status: "queued"|"running"|"done"|"error", elapsed_s, result: install 结果|null, error: str|null}

列出最近 N 天新增的战役地图（增量发现）。

自动跳过黑名单和 active 去重，融合 echocn 策展名单。

查询 echocn 人工策展的 461 条高质量战役地图名单。

含 16 种中文标签、章节信息、人工标注。 这是质量最高的数据源，应优先用于判定和推荐。

手动刷新 echocn 缓存。

MCP 启动时已自动拉取，每日后台也会自动刷新。 此工具用于：①首次部署验证 ②怀疑缓存过期 ③排障。

Returns: {success, total, sha256, cached_at, error?}

扫描闲置地图目录（已玩过的图），将未在 dedup 名单的 .vpk 加入去重列表。

适用场景：手动整理闲置目录后触发同步；install_campaign 完成后会自动调用一次。 已在 dedup 名单的会跳过，不会重复添加。

Returns: { "synced": int, # 新加入条数 "skipped_duplicates": int, # 已在名单跳过的条数 "scanned_total": int, # 扫描到的 .vpk 总数 "idle_dir": str }