Android
使用 Firefox Android 安装 Violentmonkey，再在同一个 Firefox 中安装脚本并打开 Showdown。
PSThonk 使用指南
PSThonk 与 Showdown 队伍同步
安装一次插件，在 Pokemon Showdown 中主动同步回放和所选队伍。
手机使用
Android 可用，iPhone / iPad 当前暂不支持
手机 Chrome
Android 和 iOS 的 Chrome 都不能直接安装桌面扩展，因此无法运行当前插件。
iPhone / iPad
Safari Userscripts 的 GM API 与注入模型不同，当前脚本尚未适配，不能保证连接与回放捕获。
安装与配对
先安装用户脚本，再用一次性配对码连接
- 1安装脚本管理器
浏览器安装 Tampermonkey 或兼容的用户脚本管理器。
- 2安装 PSThonk 插件
点击本页“安装插件”，在脚本管理器中确认安装。
- 3生成配对码
登录相连，打开“PS 连接与同步”，生成 6 位配对码。配对码 10 分钟有效且只能使用一次。
- 4在 Showdown 连接
刷新 Showdown，点击右下角“PSThonk”，输入配对码并连接。
回放同步
开启 PSThonk 后自动记录之后完成的对局
主动开启
在插件面板勾选“自动同步我的 PS 回放（PSThonk）”。该设置默认关闭。
只接收本人对局
当前 PS 用户必须是回放中的一方；旁观对局不会进入个人历史。
双重净化
聊天、私聊、HTML 和客户端私有 request 数据会在插件及服务端移除。
只同步开启开关后完成的对局，不会扫描历史。页面需要保持打开，直到 Showdown 收到胜者或平局消息。
战绩中心
同步后查询、分析和播放本人的 Showdown 对局
组合筛选
按日期、PS ID、规则和胜负结果查询，列表支持分页及 CSV 导出。
表现分析
查看胜率、分数、对手数、宝可梦使用率、规则战绩和相同队伍组合表现。
私人回放
播放完整战斗过程或下载脱敏日志；只有回放所属的相连账号可以访问。
队伍同步
勾选队伍后单向导入相连盒子
- 1打开 PSThonk
插件会读取 Showdown 队伍列表；远端队伍会先请求完整内容。
- 2选择队伍
使用全选、清空或逐项勾选。Showdown 的 24 格 Box 不会导入。
- 3执行同步
新增或更新完成后，在相连“宝可梦盒子”中检查结果。
不会自动删除
Showdown 中未选或已删除的队伍不会从相连删除。
不会覆盖冲突
相连侧已编辑或锁定的同步队伍会跳过，并显示原因。
当前为单向同步
相连队伍不会反向写回 Showdown。
连接管理
不再使用的浏览器应从相连撤销
key
插件不会上传 PS 密码、Cookie 或 SID。配对后得到的令牌只允许同步队伍和本人回放，相连数据库仅保存令牌哈希。
插件内“断开本机连接”只清除本机令牌；设备丢失或不再可信时，应在“PS 连接与同步”页面点击“撤销”。
排查问题
常见问题
Showdown 右下角没有 PSThonk
确认用户脚本已启用且匹配当前 Showdown 域名，然后刷新页面。
配对码无效或已过期
回到相连重新生成；旧码会立即作废，新码仍只有 10 分钟有效期。
回放没有出现
确认已开启回放同步、当前用户是参赛者、页面保持打开至对局结束，并检查连接是否已撤销。
提示客户端不支持队伍同步
回放同步支持经典和新版消息分发；队伍导出目前依赖经典客户端的 Storage API，请切换经典客户端。
队伍被跳过
常见原因是队伍文本无法解析、相连侧已手动修改、目标已锁定或个人队伍达到上限。