Skip to content

v4.3.0

Choose a tag to compare

@adaex adaex released this 11 Sep 16:33
· 305 commits to main since this release
v4.3.0
5576f14

用户体验打磨:把「成功路径」的确认从「进程活着」推进到「代理真的通」,补齐首次上手引导与自助排障。单测 203 → 225。

新增

  • mihomo doctor 体检命令:逐项检查内核可执行性、数据目录可写、settings 有效性、订阅配置与新鲜度、服务状态(含遗留 root 服务)、端口占用、配置可构建性、代理连通性,每项 ✓/!/✗ 并附修复命令;有异常项时退出码 1

  • mihomo completion <zsh|bash|fish>:生成 shell 补全脚本,覆盖全部命令、订阅/覆写/目录子命令与常用选项

  • 代理连通性探测:status 与 start 结尾的状态展示从二态变三态——运行中但经混合端口发不出真实请求时显示「● 运行中(代理不通)」黄灯,并归因到订阅过期 / 流量用尽 / 节点失效(src/proxy-probe.ts,curl 经 127.0.0.1:7890 请求 gstatic generate_204)

  • status --json(-j):机器可读的状态快照(运行状态、连通性、端口、订阅流量/到期/紧急度、服务位),供菜单栏 widget 等脚本集成

  • mihomo use <name> 顶层快捷命令(= subscription use,与 tun 快捷方式同范式);mihomo restart 作为 start 的别名(start 本身即重启)

变更

  • 首次上手引导:无参运行的短帮助从静态清单改为上下文感知——缺内核/订阅/服务时按顺序列出「开始使用」步骤,齐全后才显示常用命令;status 的「内核: 未安装」「订阅: 未配置」补上行内修复提示

  • kernel --mirror 记住偏好:显式 --mirror(裸或带值)把镜像写入 settings,之后裸 mihomo kernel 默认走镜像;--no-mirror 本次直连并清除偏好。国内用户不必每次更新都带参数

  • 状态紧急度着色:订阅到期 7 天内黄色、过期红色;流量 >=90% 黄色、用尽红色

  • 长操作等待反馈:订阅添加/更新、内核版本检查、CLI 自更新查询在 TTY 下显示转圈动画与计时,非 TTY 降级为静态行(src/spinner.ts)

  • ui 密钥顺手复制:配置了 controller_secret 时自动 pbcopy 到剪贴板,失败回退原提示

  • 订阅列表相对时间:更新时间显示「绝对时间(3 小时前)」,对「该不该更新」更直观


npm: https://www.npmjs.com/package/mihomo-cli/v/4.3.0