第一步：首次启动，指定存档文件夹
解压后运行可执行文件即可，无需安装。首次启动时，软件还不知道你的存档在哪，需要手动指定一次：
- 在窗口左下角点击「选择存档文件夹」。
- 在弹出的目录选择框中定位到你的存档目录，通常是：
Steam\userdata\<你的好友邀请码>\2868840\remote\profile1\saves - 确认后，软件会自动扫描该目录下的
.run文件并记住路径，之后启动不再需要重新选择。
如果列表一直为空，请回到这一步确认目录是否选到了 saves 这一层（详见「常见问题」）。
顶栏导航：四个页面
软件顶栏中央是一组胶囊导航，点击即可在四个页面间切换。切页时页面状态会被缓存，回到同一页不会重新加载、也不会有空白闪烁：
- 🏠 首页：Steam 资料、最近游玩、新闻、更新公告。
- 📊 生涯：跨对局的统计仪表盘。
- ⚔️ 战斗：
.run战斗记录列表与详情复盘（核心功能）。 - ⚙️ 设置：所有配置项的集中管理。
🏠 首页
首页是「打开软件能看到什么」的汇总。大部分内容需要先在「设置」里填一次 SteamID64 才能显示。
- 个人栏：显示 Steam 头像与昵称（带本地缓存，秒开，后台补缺）。底部固定一个「开始游戏」按钮，点击通过
steam://rungameid/直接启动《杀戮尖塔 2》。 - 游玩时长：从 Steam 的
localconfig.vdf读取总时长与最近两周时长，离线也能看。 - 更新公告：版本检查与一键更新置顶展示，发现新版本会有提示。
- 新闻区：拉取远端资讯展示游戏本体相关消息，首次加载用本地缓存秒开、再静默刷新。读不到时会显示一个动图占位 +「当前新闻正在施工中」，不会留死板空白。
⚔️ 战斗（核心）
这是软件的核心页面，也就是早期版本的全部功能。它分为左侧对局列表与右侧对局详情两部分。
对局列表
左侧按时间倒序列出扫描到的每一局，每张卡片展示：角色头像、升级等级（A 几）、当前楼层、用时、Seed、胜负结果。点击任意一张卡片即可在右侧载入该局详情。
首次进入战斗页时会建立解析缓存（可能略慢）；之后再进入秒开，只有新出现或被修改过的 .run 才会重新解析。
对局详情：逐层时间线
选中一局后，右侧呈现这局的完整复盘。概况栏、卡组、AI 复盘卡片会立即显示，逐层时间轴在约 0.2 秒内流式补全，期间界面始终可响应。详情包含：
- 基础信息：角色、难度、结果、Seed（点击可复制，带成功浮层提示）。
- 楼层时间线：逐层展示进入时间、用时、HP 变化、卡牌增 / 删 / 改 / 转化、遗物获取、商店买卖等事件。
- 本层跳过：折叠时一行灰色 ✕ 简要列出本层放弃的卡；展开后以卡片完整展示这层跳过的所有卡牌。覆盖所有给卡牌奖励的楼层。
- 行内展开：点击卡牌 / 遗物 / 药水可展开查看其效果与属性，全部中文化。
- 最终状态：终局卡组、遗物、药水一览；联机对局会按玩家分别列出。
逐回合战斗时间线（需 Pro 模式）
启用 Pro 模式并打过新对局后，出现过战斗的楼层会显示徽章。点开徽章可查看该场战斗的逐回合时间线：每回合抽了什么牌、打了什么牌、造成 / 承受多少伤害、护甲与能力（Power）如何变化。联机对局的回合日志会显示玩家昵称。
数据存疑角标（v0.3.5 新增）：当某局的回合/伤害数据因采集异常而不完整时（常见于游戏本体更新后 mod 短暂不兼容，导致整局战斗被压缩进一个回合），战斗徽章旁会额外出现一枚橙色「数据存疑」角标，鼠标悬停可查看具体说明。出现该角标时，这一局的逐回合统计仅供参考；建议确认 Pro 模式 mod 已升级到最新版本后，重新打一局验证即可恢复正常。
📊 生涯
生涯页把多次对局聚合成一张可视化报表，与战斗记录共用同一份扫盘结果（切页不会重复读盘）。
筛选面板
入口是底部居中的悬浮按钮，点击后面板上滑弹出、再次点击滑回收起。可按职业 / 难度多选组合筛选（例如「只看 A20 的某职业」），所有 KPI、排行、卡牌分析都会随筛选实时重算。职业筛选会依据你的 SteamID 锁定本人，联机队友的职业不会混进选项。
概览 KPI
- 胜率（含放弃局）、最高连胜、A10 胜率、A20 胜率。
- 平均承伤、平均时长、累计总时长、最快获胜。
- 平均精英数 / 局、卡组平均大小。
排行与卡牌分析
- 平均掉血排行：哪些敌人对你伤害最大。
- 致命死因排行：你最容易被谁送走。
- 上分卡 / 战犯卡：按「拿取胜率」排序，自动筛掉样本太少的卡（见过 ≥5 局且拿过 ≥2 局），并附「收益」列。
- 卡牌收益率分析：采用 STS 社区常用的 delta 口径（持有该卡的胜率 − 当前筛选基准胜率），量化每张卡对胜率的真实贡献，随筛选变化。
以上「本人向」指标（承伤、掉血、上分 / 战犯卡等）只统计本人，已排除联机队友干扰。
职业明细 + 生涯档案
- 职业明细表：按职业拆分局数 / 胜率 / 平均时长 / 最快获胜，紧凑卡片呈现。
- 生涯档案：直接读取游戏本体
progress.save，展示建筑师伤害与各职业累计数据，无需 mod、无需 Pro 模式。若该区域为空，请确认游戏本体存档可被读取。
⚙️ 设置
设置页采用「左侧分类导航 + 右侧详情」结构，按类别分组。常用配置项：
- 存档目录：查看或重新选择
.run存档所在文件夹。 - SteamID64：填入 17 位纯数字（见下方获取方式），用于首页资料与生涯的本人识别。
- Steam 路径：Pro 模式定位游戏所需。通常自动识别；有多个 Steam Library 的用户建议确认一下识别结果。
- Pro 模式：一键启用 / 禁用 Mod（见下节）。
- AI 复盘：填写 BaseURL、API Key、模型名（见下节）。
- 检查更新：手动触发版本检查。
- 清理日志：手动清理 7 天前的战斗日志，避免占用磁盘。
如何获取 SteamID64
访问 SteamID.io 或 SteamIDFinder，输入你的个人资料链接，复制其中的 steamID64（17 位纯数字）填入设置即可。
启用 Pro 模式（逐回合复盘）
.run 存档只记录「这局打完是什么样」，不记录「每回合具体抽了什么、打了什么、被打了多少」。Pro 模式通过随软件附带的 Harmony Mod（SnL2.EliteLogger）把战斗过程实时写盘，让复盘深入到回合级别。
- 进入「设置 → Pro 模式」，点击启用。软件会自动定位 Steam 中的《杀戮尖塔 2》安装路径、探测游戏文件并部署 Mod。
- 若提示找不到游戏，先到「设置 → Steam 路径」确认路径正确；必要时以管理员身份运行软件再试。
- 启动游戏打一局新对局，对局结束后回到战斗页，对应楼层就会出现战斗徽章，点开即可看逐回合时间线。
说明：Mod 会捕获所有战斗（普通怪、精英、Boss）；即便软件本体已关闭，Mod 仍会在游戏运行时持续记录。卸载 Mod 不会删除已生成的战斗日志，想彻底清除需在设置里手动清理。联机对局下只捕获本地玩家行为。
配置 AI 复盘
AI 复盘让大模型基于这局数据给出建议。它会自动注入卡组、每层取舍、跳过的卡、以及（开启 Pro 模式时）战斗摘要。两种用法：
- 仅生成提示词：不填接口也能用，软件生成一段提示词，你手动复制到任意外部 AI（网页版 ChatGPT 等）使用。
- 直连 API 自动生成：在「设置 → AI 复盘」填写兼容 OpenAI 规范的 BaseURL、API Key、模型名，软件直接调用并展示复盘结果。
API Key 使用 Windows DPAPI 加密保存在本地，不会上传到任何服务器。