Windows 便携版

🪟 Windows 便携版

🧭 页面导航： Wiki 首页 · 配置说明 · 故障排查 · 下载最新版本

Windows 便携版无需安装。程序、配置和数据都保存在解压目录中，适用于 Windows 10、Windows 11 和 Windows Server。

📌 本页导航： 下载 · 配置 · 运行 · 自动更新 · 卸载

1. 下载并解压

从最新正式版本页面下载对应压缩包和 checksums.txt：

• 常见 Intel、AMD 处理器：windows_amd64.zip；
• Windows on ARM 设备：windows_arm64.zip。

把压缩包解压到当前账户可写、不会被系统自动清理的固定目录，例如 C:\Apps\Rule-Bot-Client。不要直接在压缩包、浏览器下载临时目录或只读目录中运行。

可在 PowerShell 中校验下载文件。以下示例使用 AMD64 版本，请把文件名替换为实际下载的名称：

$archive = 'rule-bot-client_v0.3.3_windows_amd64.zip'
$expected = (Select-String -LiteralPath .\checksums.txt -Pattern "  \./$([regex]::Escape($archive))$").Line.Split()[0]
$actual = (Get-FileHash -Algorithm SHA256 -LiteralPath ".\$archive").Hash.ToLowerInvariant()
if (-not $expected -or $actual -ne $expected) { throw 'SHA-256 校验失败' }

2. 编辑并检查配置

进入解压后的目录，把 config.example.json 复制为 config.json，再用文本编辑器打开：

Copy-Item .\config.example.json .\config.json
notepad .\config.json

至少需要修改 instances 中的 Mihomo 控制接口地址和密钥。首次使用时保持 rule_bot.enabled=false，先确认本地收集正常。完整字段说明见配置说明。

保存后检查配置：

.\rule-bot-client.exe --config .\config.json --check

出现 configuration is valid 只表示配置能够读取，不表示已经连接 Mihomo。

3. 运行并验证

在当前目录运行：

.\rule-bot-client.exe --config .\config.json

日志出现 instance=... connected 后，访问一个此前未收集、最终由 Mihomo 兜底规则 MATCH 处理的域名。等待最长一个刷新间隔，再检查 data\domains.txt。

关闭当前 PowerShell 窗口会结束程序。需要随 Windows 登录自动运行时，可以使用自己熟悉的启动项或任务计划程序；启动命令必须指向固定目录中的 rule-bot-client.exe 和 config.json。

自动更新

便携版示例默认设置 "auto_update": true。程序启动约 5 秒后检查一次最新稳定版，之后每 24 小时检查一次。发现新版本时会：

1. 下载与当前 Windows 架构完全匹配的正式版压缩包；
2. 核对文件大小和 SHA-256，并检查新版身份及现有配置；
3. 正常结束当前收集进程，替换程序，再使用原参数重新启动。

config.json 和 data 目录不会被覆盖。下载、校验或候选检查失败时，当前版本继续运行；新版无法启动时，会恢复原程序并重新启动，且当天不再自动重试。最近一次替换结果保存在 data\update-status.json。

可随时手工检查或立即安装：

.\rule-bot-client.exe --config .\config.json --update-check
.\rule-bot-client.exe --config .\config.json --update-apply

已经是最新版时，命令会正常结束。若不需要后台自动检查，把 config.json 中的 auto_update 改为 false；手工更新命令仍可使用。

查看版本

.\rule-bot-client.exe --version

输出包含版本、源码提交、构建时间和目标架构。

停用或卸载

先结束 Rule-Bot Client 进程。确认已经备份需要保留的 config.json 和 data 目录后，即可删除整个便携版目录。程序不会在其他位置安装服务或写入系统级配置。