python-library-ff14-the-hunt 0.0.0__tar.gz → 0.0.2__tar.gz

python_library_ff14_the_hunt-0.0.2/.cursor/skills/ff14_the_hunt-package-changelog/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: ff14-the-hunt-package-changelog
+description: ff14_the_hunt 包：要求与决议；最新在上。
+---
+
+# ff14_the_hunt · Changelog
+
+（规则见 `~/.cursor/skills/agent-project-changelog/SKILL.md`。）
+
+## 2026-06-08
+
+- **决议**：发布 ``0.0.2``：包级导出 ``HuntCrawlPacket``、locale、poll 等；与 ff14hub 首版所需 API 对齐。
+
+## 2026-06-07
+
+- **决议**：发布 ``0.0.1``，与 PyPI 及 ``ff14-agent`` 依赖下限对齐。
+
+- **决议**：移除包内地图标点/裁剪与 Pillow 依赖。刚刷新记录输出 ``spawn_map_layout``、含 ``pixel_x/y`` 的 ``spawn_points``、站点 ``region_map`` 原图 base64；外部自行叠加标点。
+
+- **决议**：仅 ``recently_spawned`` 记录填充刷点与原图；有 ``active`` 存活点时只保留存活点。``include_spawn_maps`` 默认 True（拉取区域原图）。
+
+- **决议**：轮询改为三模式状态机（``PollMonitorMode``）：全 ``ALMOST_OPEN`` 时睡到最近开窗（``WAIT_UNTIL_OPEN``），不再叠 30 分钟固定间隔；存在开窗/强制期/刚刷新/FATE 进行中时用短间隔（``ACTIVE``）；无触发计时用 ``fallback_poll_interval_seconds``（``FALLBACK``）。实现分层于 ``poll/monitor_mode``、``window_remaining``、``sleep_settings``、``sleep_plan``。门面新增 ``active_poll_interval_seconds``（默认 600）、``recent_poll_interval_seconds``（默认 300）、``fallback_poll_interval_seconds``（默认 1800）；``poll_interval_seconds`` 废弃为 fallback 别名。
+
+- **决议**：``HuntQueryFilter.include_untimed_marks`` / 构造参数 ``include_untimed_marks`` 默认 ``False``，过滤无触发/条件/FATE 计时的占位行（SS 级噬灵王、维护占位等）；设为 ``True`` 时恢复返回 Bear Tracker 全部计时行。
+
+- **决议**：``crawl_packet_to_display_dict`` 默认按数据中心区域选择 ``HuntDisplayLocale``（中国区输出中文狩猎名与地图区域，国际区输出英文）；名称对照表打包在 ``locale/data/*.json``，可用 ``tools/build_locale_data.py`` 从 ffxiv-datamining-mixed 重建。
+
+- **决议**：``locale.cn`` 提供 ``crawl_packet_to_display_dict`` 等中文导出；``patches`` 构造参数接受中文资料片名（如金曦之遗辉）；example 演示猫小胖 / 静语庄园 / 金曦之遗辉 / S 级并输出该条件下全部怪物。
+
+- **决议**：``TimerDisplay`` 增加 ``bar_color`` / ``hex_color`` / ``counts_up`` / ``kind``，色值对齐 Bear Tracker 前端 MUI 主题；FATE 链写入 ``fate_timer``（不再占用 ``condition_timer``）；条件时间（天气/月相）仍待移植。
+
+- **决议**：`FF14TheHunt` 构造时以平铺关键字参数配置筛选与轮询（非传入 `HuntQueryFilter`）；对外提供 `crawl_once`、`start` / `run` / `stop`、`on_crawl`（实例可作装饰器）；回调入参为 `HuntCrawlPacket`。`HuntPollScheduler` 仍保留供底层调度使用。
+
+- **决议**：新增 `HuntPollScheduler` 与 `compute_poll_sleep_seconds`：固定爬取间隔默认 30 分钟；按上次结果中最近「距离开窗」触发计时提前唤醒；每次爬取后重置等待；触发唤醒下限默认 2 分钟。
+
+## 2026-06-04
+
+- **决议**：包目录由 **`ff14_world_boss`** 重命名为 **`ff14_the_hunt`**；PyPI 名 **`python-library-ff14-the-hunt`**；包级 skill 同步为 **`ff14_the_hunt-package-*`**。不考虑旧名兼容。
+- **决议**：在 monorepo 初始化空包（初名 **ff14_world_boss**），并建立包级三件套。

python_library_ff14_the_hunt-0.0.2/.cursor/skills/ff14_the_hunt-package-design/SKILL.md

@@ -0,0 +1,150 @@
+---
+
+name: ff14-the-hunt-package-design
+
+description: >-
+
+  ff14_the_hunt 包：当前有效的设计意图；变更见 ff14_the_hunt-package-changelog。
+
+---
+
+
+
+# ff14_the_hunt · 设计笔记
+
+
+
+> 变更见 `.cursor/skills/ff14_the_hunt-package-changelog/SKILL.md`；矛盾以 changelog 最新为准。
+
+
+
+## 设计意图
+
+
+
+- **FF14 狩猎（The Hunt）**：从 Bear Tracker 拉取狩猎计时、触发窗与刷点，供 Agent 或本地工具轮询与提醒。
+
+
+
+## 硬性要求
+
+
+
+- 包目录名 **`ff14_the_hunt`**（snake_case）；PyPI 名 **`python-library-ff14-the-hunt`**。
+
+- 中文禁用词见 `~/.cursor/skills/forbidden-doc-comment-vocabulary/SKILL.md`。
+
+- 对外门面 **`FF14TheHunt`**：构造时以平铺参数配置筛选与轮询；``crawl_once`` 手动爬取；``start`` / ``run`` / ``stop`` 自动服务（``run`` 支持 Ctrl+C）；``on_crawl`` / 实例装饰器登记回调，入参 **`HuntCrawlPacket`**。
+
+- 计时展示与 Bear Tracker 页面同色：``TimerDisplay.bar_color`` + ``hex_color`` + ``counts_up``；``trigger_timer`` / ``condition_timer`` / ``fate_timer`` 分列。
+
+
+
+## 自动轮询节奏
+
+
+
+实现拆在 ``ff14_the_hunt/poll/``：
+
+
+
+| 模块 | 职责 |
+
+| --- | --- |
+
+| ``monitor_mode.py`` | 判定 ``PollMonitorMode``（活跃 / 睡到开窗 / 兜底） |
+
+| ``window_remaining.py`` | 最短「距离开窗」剩余秒数 |
+
+| ``sleep_settings.py`` | ``PollSleepSettings`` 间隔与下限 |
+
+| ``sleep_plan.py`` | ``compute_poll_sleep_seconds`` |
+
+| ``scheduler.py`` | ``HuntPollScheduler`` 爬取循环 |
+
+
+
+每次 ``fetch`` 后根据**上次** ``marks`` 选模式，再算下次休眠。
+
+
+
+### 模式判定
+
+
+
+1. **``ACTIVE``（活跃轮询）** — 下列任一成立：
+
+   - ``trigger_timer.phase`` 为 ``OPEN``（开窗中）或 ``CAPPED``（强制期）
+
+   - ``recently_spawned`` 为 True（含刚标记）
+
+   - ``fate_timer.phase`` 为 ``OPEN``（FATE 进行中）
+
+
+
+2. **``WAIT_UNTIL_OPEN``（睡到开窗）** — 无活跃项，且至少一条 ``trigger_timer.phase`` 为 ``ALMOST_OPEN``（即将开窗）。  
+
+   此模式下按触发机制尚不能刷新，休眠取 ``min(各只 remaining_seconds)``（扣掉距上次爬取已过时间），**不再**叠 ``fallback`` 固定间隔。  
+
+   距开窗不足 ``min_wakeup_seconds`` 时钳到该下限。
+
+
+
+3. **``FALLBACK``（兜底）** — 无触发计时（占位行等）；按 ``fallback_poll_interval_seconds`` 固定间隔。
+
+
+
+### 休眠秒数
+
+
+
+| 模式 | 计算 |
+
+| --- | --- |
+
+| ``ACTIVE`` | 距上次爬取已过时间后，``recent_poll_interval_seconds``（有刚刷新）或 ``active_poll_interval_seconds`` |
+
+| ``WAIT_UNTIL_OPEN`` | ``max(min_wakeup_seconds, 最近开窗剩余)`` |
+
+| ``FALLBACK`` | ``fallback_poll_interval_seconds`` 减去已过时间 |
+
+
+
+默认值：活跃 600s、刚刷新 300s、兜底 1800s、开窗下限 120s。门面构造参数与 ``PollSleepSettings`` 一致。
+
+
+
+### 边界备忘
+
+
+
+- **强制期**归入 ``ACTIVE``，不可与「全未开窗」合并长睡。
+
+- 长睡期间站上他人更新死亡/标记时间，本地 ``marks`` 会滞后，到点唤醒后才纠正。
+
+- 天气/月相 ``condition_timer`` 未移植；带条件老式 S 不能单靠开窗剩余覆盖。
+
+- ``poll_interval_seconds`` 构造参数已废弃，等同 ``fallback_poll_interval_seconds``。
+
+## 刷点与区域原图
+
+实现于 ``ff14_the_hunt/spawn_map/``；**不在包内标点或裁剪**，交给外部。
+
+| 模块 | 职责 |
+| --- | --- |
+| ``points.py`` | 刚刷新刷点筛选 |
+| ``layout.py`` | ``SpawnMapLayout``（格点尺度、展示点数等） |
+| ``coordinates.py`` | ``pixel_x/y = norm * 原图宽高`` |
+| ``png_meta.py`` | 无第三方库读 PNG 尺寸 |
+| ``region_fetch.py`` / ``region_image.py`` | 拉取站点 ``HuntRegions`` 原图 |
+| ``attach.py`` | 补全 ``spawn_points`` / ``spawn_map_layout`` / ``region_map`` |
+
+- **非刚刷新**：上述字段均为空。
+- **刚刷新**：``querySpawnPoints`` 取存活点；``include_spawn_maps``（默认 True）拉取 ``RegionMapImage``。
+- 外部叠加标点：用 ``地图布局`` 公式 + ``刷点`` 的 ``像素X/Y`` 或 ``地图X/Y``。
+
+## 备忘与待定
+
+- 提醒方式、上层 Agent 集成待定。
+- 长睡期间可选低频校验爬取（防死亡时间被他人更新）尚未实现。
+

{python_library_ff14_the_hunt-0.0.0 → python_library_ff14_the_hunt-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-library-ff14-the-hunt
-Version: 0.0.0
+Version: 0.0.2
 Requires-Python: >=3.10
 Requires-Dist: pydantic>=2.0
 Provides-Extra: dev

python_library_ff14_the_hunt-0.0.2/README.md

@@ -0,0 +1,93 @@
+# ff14_the_hunt
+
+从 [Bear Tracker](https://tracker.beartoolkit.com/timer) 拉取狩猎计时，解析触发窗/条件窗，并判断「刚刷新」。
+
+## 用法
+
+构造时直接传入数据中心、世界、Rank 等参数；之后可手动爬取或启动自动轮询。
+
+```python
+from ff14_the_hunt import FF14TheHunt, HuntRankKind
+
+hunt = FF14TheHunt(
+    data_centers=["猫小胖"],
+    worlds=["静语庄园"],
+    rank_kinds=[HuntRankKind.S, HuntRankKind.A],
+    patches=["金曦之遗辉"],
+)
+
+packet = hunt.crawl_once()
+recent = hunt.recently_spawned()
+```
+
+临时换筛选条件时仍可用 ``HuntQueryFilter`` 传给 ``query_marks`` / ``recently_spawned``。
+
+默认 **不** 返回无触发/条件/FATE 计时的占位行（如 SS 级噬灵王、维护占位）；与 Bear Tracker 主列表一致。需要完整 API 原始行时设 ``include_untimed_marks=True``（构造参数或 ``HuntQueryFilter`` 字段均可）。
+
+## 自动轮询与回调
+
+轮询按上次结果分三种模式（见包内设计笔记 ``ff14_the_hunt-package-design``）：
+
+- **全未开窗**：睡到筛选内最短「距离开窗」再爬（下限默认 2 分钟），此期间不叠固定间隔。
+- **已有开窗/强制期/刚刷新/FATE 进行中**：短间隔轮询（默认 10 分钟；有刚刷新条目时默认 5 分钟）。
+- **无触发计时**：退回固定间隔（默认 30 分钟）。
+
+构造参数 ``active_poll_interval_seconds``、``recent_poll_interval_seconds``、``fallback_poll_interval_seconds``、``min_wakeup_seconds`` 可配。``poll_interval_seconds`` 已废弃，等同 ``fallback_poll_interval_seconds``。
+
+```python
+@hunt.on_crawl
+def on_hunt(packet):
+    print(len(packet.marks), "条", packet.crawled_at)
+
+# 后台线程
+hunt.start()
+# ...
+hunt.stop()
+
+# 或阻塞到 Ctrl+C
+hunt.run()
+```
+
+也可用实例作装饰器：`@hunt`。
+
+单次爬取结果在 ``HuntCrawlPacket`` 里，含 ``crawled_at``、``marks``、``query``。
+
+## 示例
+
+```bat
+example.bat
+```
+
+或 `python -m example`。输出写入 `example/output/`（已列入 `.gitignore`），JSON 使用 ``crawl_packet_to_display_dict`` 生成；语言默认跟随所选数据中心（中国区为中文狩猎名与地图区域，国际区为英文）。
+
+## API 说明
+
+| 站点接口 | 用途 |
+| --- | --- |
+| `POST /api/syncSession` | 狩猎库、刷点坐标、数据中心/世界列表 |
+| `POST /api/lastDeathTimers` | 计时行；`RankType` 为 `aRank` / `sRank` / `fate` |
+| `POST /api/querySpawnPoints` | 刚刷新记录的各刷点存活状态（需 `LastDeath`） |
+
+刚刷新记录才填充 ``spawn_points``、``spawn_map_layout`` 与 ``region_map``。包内不标点、不裁剪；``region_map`` 为站点 ``HuntRegions`` 原图 base64。刷点含 ``地图X/Y``、``格点X/Y``、``像素X/Y``（按原图尺寸算好）；``地图布局`` 含格点尺度与归一化公式。默认 ``include_spawn_maps=True`` 拉取原图。示例 ``python -m example`` 将 PNG 写入 ``example/output/maps/``，JSON 用 ``区域地图.地图文件`` 引用。
+
+`QueryDeathTimers` 为世界名列表（由所选数据中心展开）。
+
+构造参数 ``patches`` 可写 Bear Tracker 缩写（如 ``DT``）或中文资料片名（如 ``金曦之遗辉``）；内部统一为 `Patch` 字段。``crawl_packet_to_display_dict`` 可按 ``locale`` 或 ``detect_display_locale`` 推断的语言导出；也可显式传入 ``HuntDisplayLocale.ZH`` / ``EN``。
+
+触发时间窗算法与站点前端主计时列一致；带 `fateLastSeen` / `fateLastDeath` 的 7.0 S 链写入 ``fate_timer``。部分老式 S（如 Laideronnette）的天气条件窗尚未移植。
+
+每条 ``TimerDisplay`` 含 ``bar_color``（站点 MUI 色键）与 ``hex_color``（Bear Tracker 主题主色），便于自建界面与网页同色展示：
+
+| 表头 | 站点说明 | bar_color | hex |
+| --- | --- | --- | --- |
+| 触发时间 | 红：不可触发期（倒计时） | error | #e31a1a |
+| 触发时间 | 绿：可触发期（正计时，% 为进度） | success | #01b574 |
+| 触发时间 | 蓝：强制期（正计时） | info | #0075ff |
+| 条件时间 | 红：未满足条件（倒计时） | error / warning | #e31a1a / #ffb547 |
+| 条件时间 | 绿：已满足条件（倒计时） | success | #01b574 |
+| FATE | 绿：距最近发现 | success | #01b574 |
+| FATE | 红：距上次死亡 | error | #e31a1a |
+
+``counts_up`` 标明正计时或倒计时。条件时间行待天气/月相逻辑移植后填充 ``condition_timer``。
+
+「刚刷新」：触发窗开启后默认 15 分钟内，或 `lastMarkTime` 在默认 15 分钟内。

python_library_ff14_the_hunt-0.0.2/example/__main__.py

@@ -0,0 +1,99 @@
+"""示例：中国服务器 · 猫小胖 · 静语庄园 · 金曦之遗辉 · S 狩猎（全部怪物）。"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from .spawn_map_io import write_region_map_files
+
+from ff14_the_hunt import (
+    FF14TheHunt,
+    HuntRankKind,
+    crawl_packet_to_display_dict,
+    detect_display_locale,
+)
+from ff14_the_hunt.locale.names import translate_hunt_name, translate_region
+
+DC_MOOGLE = "\u732b\u5c0f\u80d6"
+WORLD_MANOR = "\u9759\u8bed\u5e84\u56ed"
+PATCH_DAWNTRAIL_CN = "\u91d1\u66e6\u4e4b\u9057\u8f89"
+
+
+def main() -> None:
+    hunt = FF14TheHunt(
+        data_centers=[DC_MOOGLE],
+        worlds=[WORLD_MANOR],
+        rank_kinds=[HuntRankKind.S],
+        patches=[PATCH_DAWNTRAIL_CN],
+        include_spawn_maps=True,
+    )
+    print("中国区数据中心:", hunt.list_data_centers(region="CN"))
+
+    packet = hunt.crawl_once()
+    marks = packet.marks
+    recent = hunt.recently_spawned()
+
+    out_dir = Path(__file__).resolve().parent / "output"
+    out_dir.mkdir(parents=True, exist_ok=True)
+
+    region_map_files = write_region_map_files(marks, out_dir)
+
+    locale = detect_display_locale(packet.query)
+    payload = crawl_packet_to_display_dict(
+        packet,
+        recently_spawned=recent,
+        locale=locale,
+        resources=hunt.ensure_resources(),
+        embed_region_map_data=False,
+        region_map_file_names=region_map_files,
+    )
+    out_path = out_dir / "bear_moogle_manor_dt_s.json"
+    out_path.write_text(
+        json.dumps(payload, ensure_ascii=False, indent=2),
+        encoding="utf-8",
+    )
+
+    print(f"写入 {out_path}")
+    if region_map_files:
+        print(f"区域原图 {len(region_map_files)} 张 -> {out_dir / 'maps'}")
+    print(f"配置: {payload['配置']}")
+    print(f"共 {len(marks)} 条怪物")
+    for mark in marks:
+        print("---")
+        print(
+            translate_hunt_name(mark.hunt_key, locale),
+            mark.world_name,
+            mark.patch,
+            translate_region(mark.region, locale),
+        )
+        if mark.trigger_timer:
+            t = mark.trigger_timer
+            print(f"  触发 [{t.bar_color.value} {t.hex_color}]:", t.summary)
+        if mark.condition_timer:
+            t = mark.condition_timer
+            print(f"  条件 [{t.bar_color.value} {t.hex_color}]:", t.summary)
+        if mark.fate_timer:
+            t = mark.fate_timer
+            print(f"  FATE [{t.bar_color.value} {t.hex_color}]:", t.summary)
+        if mark.spawn_points:
+            pt = mark.spawn_points[0]
+            print(
+                f"  刷点: {pt.point_key} "
+                f"grid=({pt.grid_x}, {pt.grid_y}) "
+                f"norm=({pt.x:.3f}, {pt.y:.3f}) "
+                f"px=({pt.pixel_x}, {pt.pixel_y})"
+            )
+        if mark.region_map is not None:
+            rel = region_map_files.get((mark.hunt_key, mark.world_name), "")
+            print(
+                f"  区域原图: {rel} "
+                f"({mark.region_map.width}x{mark.region_map.height})"
+            )
+        print("  刚刷新:", mark.recently_spawned)
+
+    print(f"同条件下刚刷新 {len(recent)} 条")
+
+
+if __name__ == "__main__":
+    main()

python_library_ff14_the_hunt-0.0.2/example/spawn_map_io.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+import base64
+import re
+from pathlib import Path
+
+from ff14_the_hunt.models import HuntMarkRecord
+
+
+def _safe_map_basename(hunt_key: str, world_name: str) -> str:
+    raw = f"{hunt_key}_{world_name}"
+    cleaned = re.sub(r"[^\w.\-]+", "_", raw, flags=re.UNICODE)
+    return cleaned.strip("_") or "region_map"
+
+
+def write_region_map_files(
+    marks: list[HuntMarkRecord],
+    out_dir: Path,
+) -> dict[tuple[str, str], str]:
+    """将 ``region_map`` 原图解码为 PNG 文件。
+
+    Returns:
+        ``(hunt_key, world_name) -> 相对 out_dir 的路径``。
+    """
+    map_dir = out_dir / "maps"
+    map_dir.mkdir(parents=True, exist_ok=True)
+    names: dict[tuple[str, str], str] = {}
+    for mark in marks:
+        if mark.region_map is None:
+            continue
+        file_name = f"{_safe_map_basename(mark.hunt_key, mark.world_name)}.png"
+        path = map_dir / file_name
+        path.write_bytes(base64.b64decode(mark.region_map.data_base64))
+        names[(mark.hunt_key, mark.world_name)] = f"maps/{file_name}"
+    return names

python_library_ff14_the_hunt-0.0.2/ff14_the_hunt/__init__.py

@@ -0,0 +1,62 @@
+from ff14_the_hunt.ff14_the_hunt import FF14TheHunt
+from ff14_the_hunt.bear_tracker.timer_theme import BEAR_TRACKER_BAR_HEX, bar_hex
+from ff14_the_hunt.models import (
+    HuntCrawlPacket,
+    HuntMarkRecord,
+    HuntQueryFilter,
+    HuntRankKind,
+    MapCoordinate,
+    RegionMapImage,
+    SpawnMapLayout,
+    SpawnWindowPhase,
+    TimerBarColor,
+    TimerDisplay,
+    TimerKind,
+)
+from ff14_the_hunt.locale import (
+    HuntDisplayLocale,
+    crawl_packet_to_display_dict,
+    detect_display_locale,
+    mark_to_display_dict,
+    normalize_patch_codes,
+    query_to_display_dict,
+)
+from ff14_the_hunt.poll import (
+    HuntPollScheduler,
+    PollMonitorMode,
+    PollSleepSettings,
+    compute_poll_sleep_seconds,
+    nearest_trigger_remaining_seconds,
+    nearest_window_open_remaining_seconds,
+    resolve_poll_monitor_mode,
+)
+
+__all__ = [
+    "BEAR_TRACKER_BAR_HEX",
+    "FF14TheHunt",
+    "HuntDisplayLocale",
+    "HuntCrawlPacket",
+    "HuntMarkRecord",
+    "HuntQueryFilter",
+    "HuntPollScheduler",
+    "HuntRankKind",
+    "PollMonitorMode",
+    "PollSleepSettings",
+    "MapCoordinate",
+    "RegionMapImage",
+    "SpawnMapLayout",
+    "SpawnWindowPhase",
+    "TimerBarColor",
+    "TimerDisplay",
+    "TimerKind",
+    "bar_hex",
+    "compute_poll_sleep_seconds",
+    "crawl_packet_to_display_dict",
+    "detect_display_locale",
+    "mark_to_display_dict",
+    "nearest_trigger_remaining_seconds",
+    "nearest_window_open_remaining_seconds",
+    "resolve_poll_monitor_mode",
+    "normalize_patch_codes",
+    "query_to_display_dict",
+]

{python_library_ff14_the_hunt-0.0.0 → python_library_ff14_the_hunt-0.0.2}/ff14_the_hunt/bear_tracker/client.py

@@ -20,6 +20,14 @@ class BearTrackerClient:
         self._base_url = base_url.rstrip("/")
         self._timeout_seconds = timeout_seconds
 
+    @property
+    def base_url(self) -> str:
+        return self._base_url
+
+    @property
+    def timeout_seconds(self) -> float:
+        return self._timeout_seconds
+
     def sync_session(self) -> dict[str, Any]:
         """拉取会话与 ``resources``（含 DatabaseHunt、SpawnPoint、DataCenters）。"""
         return self._post("/syncSession", {})

{python_library_ff14_the_hunt-0.0.0 → python_library_ff14_the_hunt-0.0.2}/ff14_the_hunt/bear_tracker/enrich.py

@@ -3,17 +3,25 @@ from __future__ import annotations
 import time
 from typing import Any
 
-from ff14_the_hunt.models import HuntMarkRecord, HuntQueryFilter, TimerDisplay
+from ff14_the_hunt.models import HuntMarkRecord, HuntQueryFilter
 
-from ff14_the_hunt.bear_tracker.fate_timer import compute_fate_condition_timer
+from ff14_the_hunt.bear_tracker.fate_timer import compute_fate_timer
 from ff14_the_hunt.bear_tracker.resources import BearResources
-from ff14_the_hunt.bear_tracker.spawn_points import list_map_coordinates
 from ff14_the_hunt.bear_tracker.spawn_window import (
     compute_trigger_timer,
     is_recently_in_window,
 )
 
 
+def mark_has_display_timer(record: HuntMarkRecord) -> bool:
+    """记录是否带有站点主列表会展示的任一条计时。"""
+    return (
+        record.trigger_timer is not None
+        or record.condition_timer is not None
+        or record.fate_timer is not None
+    )
+
+
 def _passes_filter(
     *,
     hunt_key: str,
@@ -40,7 +48,6 @@ def build_hunt_record(
     *,
     timer_row: dict[str, Any],
     resources: BearResources,
-    spawn_states: dict[str, Any] | None,
     query: HuntQueryFilter,
     now: float | None = None,
     recent_grace_seconds: float = 900.0,
@@ -75,17 +82,12 @@ def build_hunt_record(
             now=now,
         )
 
-    condition = compute_fate_condition_timer(
-        last_death_time=float(last_death or 0.0),
+    fate_timer = compute_fate_timer(
         fate_last_seen=timer_row.get("fateLastSeen"),
         fate_last_death=timer_row.get("fateLastDeath"),
         now=now,
     )
 
-    map_key = resources.spawn_map_key(hunt_key, meta)
-    spawn_entry = resources.spawn_point.get(map_key) if map_key else None
-    points = list_map_coordinates(spawn_entry, api_states=spawn_states)
-
     recently = is_recently_in_window(trigger, grace_seconds=recent_grace_seconds)
     if last_mark and now is not None:
         if now - float(last_mark) <= recent_grace_seconds:
@@ -109,8 +111,8 @@ def build_hunt_record(
         fate_last_seen=timer_row.get("fateLastSeen"),
         fate_last_death=timer_row.get("fateLastDeath"),
         trigger_timer=trigger,
-        condition_timer=condition,
-        spawn_points=points,
+        condition_timer=None,
+        fate_timer=fate_timer,
         recently_spawned=recently,
         raw_timer=dict(timer_row),
     )

python_library_ff14_the_hunt-0.0.2/ff14_the_hunt/bear_tracker/fate_timer.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import time
+
+from ff14_the_hunt.bear_tracker.spawn_window import _format_duration
+from ff14_the_hunt.bear_tracker.timer_theme import build_timer_display
+from ff14_the_hunt.models import (
+    SpawnWindowPhase,
+    TimerBarColor,
+    TimerDisplay,
+    TimerKind,
+)
+
+
+def compute_fate_timer(
+    *,
+    fate_last_seen: float | None,
+    fate_last_death: float | None,
+    now: float | None = None,
+) -> TimerDisplay | None:
+    """7.0 部分 S 猎 FATE 链计时（站点组件 ``lo`` 的 FATE 分支）。"""
+    if fate_last_seen is None or fate_last_death is None:
+        return None
+    if now is None:
+        now = time.time()
+    now_ms = now * 1000.0
+    seen_ms = fate_last_seen * 1000.0
+    death_ms = fate_last_death * 1000.0
+
+    if death_ms > seen_ms:
+        delta = now_ms - death_ms
+        return build_timer_display(
+            kind=TimerKind.FATE,
+            phase=SpawnWindowPhase.CLOSED,
+            bar_color=TimerBarColor.ERROR,
+            counts_up=True,
+            elapsed_seconds=delta / 1000.0,
+            summary=f"FATE 已结束 {_format_duration(delta / 1000.0)}",
+        )
+
+    delta = now_ms - seen_ms
+    return build_timer_display(
+        kind=TimerKind.FATE,
+        phase=SpawnWindowPhase.OPEN,
+        bar_color=TimerBarColor.SUCCESS,
+        counts_up=True,
+        elapsed_seconds=delta / 1000.0,
+        summary=f"FATE 进行中 {_format_duration(delta / 1000.0)}",
+    )
+
+
+def compute_fate_condition_timer(
+    *,
+    last_death_time: float,
+    fate_last_seen: float | None,
+    fate_last_death: float | None,
+    now: float | None = None,
+) -> TimerDisplay | None:
+    """兼容旧名；``last_death_time`` 未使用。"""
+    del last_death_time
+    return compute_fate_timer(
+        fate_last_seen=fate_last_seen,
+        fate_last_death=fate_last_death,
+        now=now,
+    )