从 v0.1.0 到 v0.2.27：43 个工具、300+ 项测试，持续迭代。
完整记录见 GitHub CHANGELOG；这里只列对使用者有影响的变更。
telsonpteropilot --status [标识]：不开 MCP 客户端直接看服务器状态。不给标识时列出全部（并发拉取）——状态、健康度、CPU、内存；单台失败显示 ⚠ 且不盖住其余服务器；给标识时额外读一次日志推断在线玩家数（拿不到就显示 -，不编数字）。--json 输出结构化结果。退出码：全部健康才 0，否则 1——可直接当 cron 健康检查。test_cooldown_expiry_notifies_again 偶发失败：冷却正好 60 分钟，而测试把状态时间设成「正好 3600 秒前」，卡在边界上，一次浮点误差或几毫秒调度延迟就能让 elapsed < 3600 翻转。改成 7200 秒，测的还是「过期会再推」这件事本身。pteropilot-alerts --cpu / --memory ：资源阈值告警。此前只看「服务器还在不在线」——一台 running 但 CPU 打满、内存快爆的服务器不会叫。CPU 用绝对值百分比；内存用使用率（memory_bytes / memory_limit），面板不限额的服务器自动跳过该项，而不是拿 0 当分母算出假百分比。等于阈值即告警（运维习惯是「到 85 就叫」）。状态正常但资源超限时告警里的状态记为 high_load——否则标题会写成「状态异常（running）」，读起来自相矛盾。默认 0 = 关闭。--in / --at：让 --broadcast / --power 等到点再执行。--in 5m / --in 300 / --in 2h / --in 1d（省略单位当秒）；--at 03:00 取下一个该时刻，已过则顺延到明天。等待上限 24 小时（更长的请交给 cron / systemd，别让进程干等）。等待期间 Ctrl+C 取消，退出码 4，一个字都不会发。--in 与 --at 同时给算用法错误（不猜用户想哪个）。pteropilot --power --servers a,b ：批量电源信号后退出，与 batch_power 工具共用同一份结构化逻辑。--servers 必填——电源是写操作，不替用户猜范围。stop / restart / kill 与 "*"（全部服务器）都必须 --confirm；作用于全部时连 start 也要确认，防一次手滑把全站启动。支持 --json。broadcast_command 广播指令（第 45 个工具）：给多台服务器同时发同一条控制台指令——维护前统一通知、统一刷白名单、统一改游戏规则。面板只有单台 /command 端点，这里逐台并发调用。不传 server_ids 时只发给 running 的服务器（停机的发了也收不到），传 ["*"] 才含停机的。高危指令二次确认：stop / kill / op / ban / whitelist off / difficulty peaceful 必须 confirm=True——一条 op 误发会同时作用于所有服。只读模式整体拒绝；单台失败单独标注、不阻断其余。pteropilot --broadcast "指令"：不启动 MCP server，直接广播一次后退出——给 cron / 计划任务用（维护前定时通知不必先起客户端）。支持 --servers a,b 选服、--confirm 确认高危指令、--json 结构化输出；退出码 0 全部发出 / 1 有失败 / 2 用法错误 / 3 被拦截。player_stats 玩家在线历史统计（第 44 个工具）：每次 list_players 时顺带记录一次采样，长期积累后按天给出峰值 / 均值 / 采样数——面板本身不提供历史数据，「这个服一般几个人在线」以前只能靠记。采样写入 ~/.pteropilot/playerlog/.jsonl ，玩家集合没变时不重复记录，文件超 20000 行自动裁剪只留最近的。list_players 在记录成功后追加一行提示，让用户知道有历史在积累。pteropilot --doctor 环境自检：检查 Python 版本、面板配置、地址规范化（带 /api 会提示已剥掉）、密钥前缀角色（ptla_ 用错会指出）、面板连通（401/403/404 分别给出含义与修法）、告警渠道；输出不含密钥，可整段贴给他人排查。配套 --no-network 只查配置不联网list_mounts 挂载点查看工具（第 43 个）：列出服务器的额外存储挂载——名称、source → target 路径、只读/可写、是否用户可自行挂载。排查「我上传的文件怎么看不到」（挂载没配或只读）。只读。send_failed / send_errors，输出醒目警告并让进程退出码 3（此前混在查询错误里、退出码仍 0——服务器真挂了、告警又没发出去时，用户会以为有监控实际没人收到，属最危险的静默失败）；一条都没发出时也不推进冷却状态，下次扫描会重试（Fixed）pteropilot-alerts --reset：清空冷却/连续确认状态（调完灵敏度想立刻验证、或服务器已修好但还卡在冷却期时用）；只动状态文件、不碰按服务器配置，支持 --dry-run 与 --jsonscripts/release.py、scripts/sync_release_notes.py）的 GitHub API 调用加入指数退避重试：网络抖动（RemoteDisconnected / 超时 / 连接错误）自动重试 3 次，HTTP 4xx/5xx 仍立即失败——曾因一次连接中断导致打 tag 半途失败（Changed）pteropilot --version 在工具数明显偏少（<30）时额外提示「可能装到了旧版本（PyPI 发布可能滞后）」，避免用户以为功能缺失（Changed）--version 自检方法；把国内常不可用的 git+GitHub 安装方式换成 GitHub Release 下载 .whl，并明确说明本项目不提供代理方案（Changed）PANEL_URL 填成 https://panel.example.com/api（面板文档常见写法）时，原来会拼出 /api/api/client → 404，看着像密钥错；现在自动剥掉 /api、/api/client、/api/application 后缀与尾斜杠，真实子路径（如 /pterodactyl）保持不变。（Fixed）list_server_users 子用户权限查看工具（第 42 个）：列出能管理该服务器的子用户——邮箱/用户名 + 被授予的权限项数与权限大类，回答「谁能动我的服」。只读。analyze_player_activity 玩家活跃分析工具（第 41 个）：分析最近控制台日志里的加入/退出事件——活跃玩家排行（进/退次数）、高峰时段、日志末尾仍在线的人。只读，回答「谁最常来」「什么时候人多」；top 1-20 默认 10，并明确标注统计窗口受日志长度限制。scripts/release.py 整棵树一致性检查：本地 HEAD tree 必须等于远端 main tree，任何漏推文件都会在打 tag 前被拦下。scripts/sync_release_notes.py：把 CHANGELOG 对应版本章节搬进 GitHub Release 描述（含安装指引与变更历史链接）——自动生成的 release notes 只有一行链接，用户看不出改了什么。pteropilot --version（也支持 -V/-v）：打印版本与当前工具数，不校验面板配置、不启动 server。用于确认装的是不是最新版（PyPI 可能滞后于 GitHub Release）。scripts/release.py：用 GitHub API 打 tag 触发 release.yml 自动构建并发布 Release（绕开被墙的 git push --tags）；内置三道检查——远端 pyproject 版本必须与本地一致（防止 tag 打出旧版包）、工作区必须干净、tag 不可重复。release.yml 只上传 wheel 与 sdist：原来用 dist/* 会把 uv build 生成的 .gitignore 当成附件传到 Release。（Fixed）list_schedules 定时任务查看工具（第 40 个）：列出服务器在面板里配置的计划任务——cron 表达式、是否启用、仅在线时执行、上次/下次运行时间、每任务步骤数。只读，回答「自动重启配好了吗」「这个服有哪些定时任务」。pteropilot-alerts --test 通道自检：发一条测试消息验证 webhook/邮件配置是否正确（不读服务器、不写状态），失败时列出常见原因并以退出码 1 返回（便于脚本判断）。配置告警时先跑它，别等真崩服才发现没收到。scripts/install_alerts_task.ps1——一条命令建计划任务（默认每 5 分钟），自动生成包装脚本（面板凭据写进去，后台运行不依赖环境变量；中文日志 UTF-8 正常）、日志落 ~/.pteropilot/alerts.log，支持 -Status / -Remove / -DryRun / -Exe 与邮件通道。解决 README 只有 cron 示例、Windows 服主不会配的问题。get_console_log 工具：读取服务器控制台最近日志，补全「发指令 → 看回馈」闭环。stop 电源操作纳入二次确认（与 restart/kill 一致；start 免确认）。（Changed）PANEL_READONLY 容错增强：1/true/yes/on（大小写、空格不敏感）均能开启只读模式。（Changed）