本文档面向 EndProtocol 最终用户，说明账号登录、仪表板、游戏启动器、系统托盘与设置的使用方法。
进入「账户」页面，点击「添加账户」，选择登录方式：
| 方式 | 说明 |
|---|---|
| 手机号 + 密码 | 森空岛 / 鹰角通行证 账号密码登录 |
| 短信验证码 | 输入手机号获取短信验证码后登录 |
| 二维码扫码 | 用森空岛 / 鹰角通行证 App 扫描登录二维码 |
多角色账号登录成功后，会弹出角色选择窗口，选择要同步的角色。登录后账号出现在账号列表中，支持批量登出与账号切换。
凭证（cred / token）会自动检查与刷新，支持懒加载与手动重试。后台任务每 300 秒刷新一次账号数据。
仪表板基于可拖拽卡片网格，支持多标签页分组。
- 点击右下角悬浮按钮或侧边栏添加卡片
- 长按卡片约 1.2 秒进入编辑模式，随后可拖拽调整位置与顺序
- 右键卡片可切换角色、打开设置、选择勋章、切换领域或删除
- 通过标签页把卡片分组管理，标签页支持自定义名称、图标与标签
| 卡片 | 展示内容 |
|---|---|
| 账户概览 | 昵称、头像、等级、世界等级、服务器、主线进度、角色/武器/档案数量 |
| 进度条 | 理智（含恢复倒计时）、每日活跃、每周事务、通行证等级 |
| 角色列表 | 支持单列 / 双列 / 三列显示模式 |
| 每日签到 | 今日与明日奖励、签到按钮、自动签到开关 |
| 成就勋章 | 蚀刻章勋章墙，六边形裁切图标与等级解析 |
| 帝江号飞船 | 舱室等级与驻留干员的情绪、信赖 |
| 领域信息 | 等级经验、资金与上限、据点干员、工厂 |
角色浏览器支持按职业 / 星级 / 属性 / 武器 / 主词条 / 副词条六维筛选。
角色详情包含：技能、天赋、潜能、精英化、模组。
Wiki 数据集成：词条目录、物品详情、升级材料解析、技能描述富文本渲染。
- 完整抽卡历史，支持角色池与武器池分别同步，增量拉取（遇本地已有记录即停止翻页）
- 卡池分类：全部 / 限定 / 联合 / 标准 / 武器
- 多维筛选：卡池、关键词、星级、仅新获取、仅免费
- 实时同步进度（进度弹窗可关闭后后台继续）
- ECharts 图表：星级分布饼图、6★ 间隔分布直方图（含期望线）、6★ 累计曲线、卡池保底横向条形图
需要在账户页按角色授权：抽卡接口用的访问令牌是按角色授予的。绑定角色后会出现「按角色授权抽卡数据」页面，可以逐个授权或先跳过；之后在「账户」页展开对应森空岛账户，用角色行上的「授权抽卡 / 取消授权」随时调整。用扫码或验证码登录过的账户，官服角色点一下就能拿到令牌；只输过密码的账户会要求针对该角色单独登录一次以确认设备。B 服（渠道服）角色暂不支持。
进入标题栏的模式切换按钮进入游戏模式。标题栏左侧显示当前选中的游戏的名字。
鼠标靠近窗口左边缘会展开一列游戏图标（终末地 / 明日方舟），点击即可切换。切换后标题栏标题、操作面板以及该游戏的安装目录、渠道、DX11 设置整套一起换掉，两个游戏的配置互不覆盖。
- 在操作面板选择渠道（《终末地》官服 / B 服 / 国际服 / Google Play，《明日方舟》官服 / B 服），并指定安装目录——目录会被自动扫描并识别渠道
- 若目录为空则执行安装；已有安装则检测版本并提供更新
- 可选操作：
- 校验修复：快速或完整校验，损坏文件自动重新下载
- 预下载：提前下载官方预发布补丁分卷
- 切换渠道：在已安装渠道之间迁移，含进度与取消回滚
- 启动游戏 / 结束进程
- 底部信息栏展示官方 Banner 与公告，点击在内置浏览器中打开
《终末地》四个渠道：官服（official）、B 服（bilibili）、国际服（global）、Google Play（google_play）；《明日方舟》两个渠道：官服（arknights）、B 服（arknights_bilibili）。两款游戏都支持换服，切换前会检查游戏进程并锁定安装目录。
渠道自动识别：《终末地》依据安装目录中的标记文件（PCGameSDK.dll、hgsdk.dll、gfsdk.dll、glextra.dll 等），《明日方舟》读取 config.ini 的 channel（2 为 B 服，其余为官服）。
- 关闭主窗口时默认弹出询问（可在设置中改为直接关闭或最小化到托盘）
- 双击托盘图标唤起主窗口（跨虚拟桌面强制置顶）
- 右键弹出托盘面板（独立的 288×376 无边框窗口）
- 面板右上角徽标显示所选账号的游戏账号等级；正文展示理智（含倒计时）、每日活跃、每周事务与通行证四条进度
- 可指定托盘展示的账号；托盘数据由主进程定期推送
| 分组 | 可配置项 |
|---|---|
| 通用 | 语言、切换账号时刷新、详情懒加载、Wiki 预加载、关闭行为、托盘账号 |
| 游戏启动 | 校验修复线程数 |
| 外观 | 主题模式、强调色、自定义配色、背景图片与透明度、窗口背景透明度 |
| 开发者 | 开发者模式（开启后显示开发者工具页） |
| 更新 | 更新通道（稳定 / 预览）、更新源（GitHub / 镜像）、版本信息 |
开启开发者模式后可见：
- 日志查看器：前端 + 后端日志，支持来源与级别筛选
- Wiki 数据调试：目录 / 角色 / 武器词条转储
- 用户信息转储
- 图片缓存管理：智能 / 手动模式，条目数与容量上限、统计表、一键打开缓存目录
所有本地数据集中存放在：
%LOCALAPPDATA%\cn.msk-network.endprotocol\
├── app_config.json # 应用配置与卡片设置（**不含账户凭据**）
├── image_cache/ # 图片缓存（avatars、skill_icons、weapon_icons 等 9 类）
├── backgrounds/ # 自定义背景图
├── wiki_detail_cache/ # Wiki 词条磁盘缓存
├── gacha_records/ # 抽卡记录（按 userId_serverId 分文件）
├── secrets.enc / secrets.key # 机密降级存储（仅在系统凭据库不可用时出现）
└── logs/ # 日志 app-<日期>.log
登录凭证（cred / token / hytoken / device_token / 手机号）
不写进 app_config.json，而是存放在操作系统的凭据库里：
| 系统 | 存放位置 |
|---|---|
| Windows | 控制面板 → 凭据管理器 → Windows 凭据 → 通用凭据（cn.msk-network.endprotocol） |
| macOS | 钥匙串访问（cn.msk-network.endprotocol） |
| Linux | Secret Service（GNOME Keyring / KWallet） |
这些数据由操作系统用当前登录用户的凭据加密，其他用户、其他程序（无用户授权）无法读取。 应用可以随时正常使用，不需要额外解锁。
若在 Linux 上找不到系统凭据库，应用会降级为在数据目录写
secrets.enc（AES-256-GCM 加密） 与secrets.key—— 保护强度低于系统凭据库。
- 双更新通道：稳定版 (Stable) 与预览版 (Preview)
- 双更新源：GitHub Releases 与 Cloudflare R2 镜像（
updates.msk-network.cn） - 应用内更新：Tauri updater 插件 + minisign 签名验证，含更新日志、下载进度与取消
- 启动自动检查：启动 3 秒后自动检查更新
Windows、macOS 与 Linux 均通过 Tauri updater 插件更新，下载包经 minisign 签名验证。