im0o b276c4a8fe 轻提示铺开到全部页面;内核状态悬停变重启;GEO 支持单文件下载
侧栏动作排撤掉重启图标,内核状态(圆点加版本号)本身变成按钮:悬停
换层显示「重启内核」,不在线时只当状态看。行高压成 1 修掉圆点和等宽
字体不居中的问题。

四个页面的一次性反馈(保存、删除、更新订阅、断开连接、测延迟结论)
全部改走 toast,commit() 改返回成败给「失败不关对话框」用;持续状态
(连接页轮询失败、请求页日志流失败)留在页内,会自动消失的提示装不下
需要一直可见的信息。toast 加 info 类别给中性结论用。

GEO 每行的更新改成单独下载那一个文件:内核只有全量更新的口子,单文件
只能服务端自己下(POST /api/geo/sync),代价是只有形状校验(MaxMind
末尾标记、geodata 首字节,shared/geo.ts 带测试)且内核重启后才换用新
文件;「更新全部」文字按钮保留内核的全量口子,有完整校验和热加载。
上传两行的按钮改「选择或拖放文件」,投放区拖入高亮,恢复策略挪到
恢复行下方。
2026-08-12 02:20:46 +08:00
2026-08-11 21:14:31 +08:00
2026-08-10 04:10:17 +08:00

Patchbay

一个跑在服务器上的网页,用来编辑那台机器上 mihomo 的 config.yaml 并让改动生效。

核心动作是把某一路入站接到某一个出站上——名字取自录音棚的插线板。典型用途是给每个容器开一个端口,各自指定走哪条线路。

聚合订阅不在范围内(那是 Sub-Store 的活),安装升级内核也不在(那是 mihomo-up.sh 的活)。

术语以 CONTEXT.md 为准。为什么这么设计记在仓库外面的 docs/adr/。

跑起来

需要 Bun 1.3 以上。

bun install
cp .env.example .env   # 按里面的注释填
bun run start          # 打包前端并启动,默认 http://127.0.0.1:7580

首次启动会生成一个访问令牌,打印在控制台上,同时存到配置文件旁边的 .patchbay-token。

内核不在线也能用,只是看不到订阅里有哪些线路、也没法让改动立刻生效。这是有意的——配置写坏导致内核起不来的时候,正是最需要这个界面的时候。

开发

改代码的时候用这个,前后端都不用重启:

bun run dev:kernel   # 终端 1:本地测试内核,开着不用管
bun run dev:all      # 终端 2:后端 + 前端,改了自动生效

然后访问 http://localhost:5173(不是 7580)。后端代码改动由 Bun 的 --hot 重载, 界面改动由 Vite 直接更新浏览器。

bun run start 不具备这个能力——它把前端打成静态文件再由后端提供,代码一改就得重新 打包重启。那种方式适合最终验证和部署。

本地测试内核的配置由模板生成(dev/config.yaml 进 git,订阅地址从 .env 取, 生成的 dev/home/config.yaml 不进 git):

bun run dev:reset    # 第一次,或想把测试配置恢复成模板时

检查

bun test        # 单元测试,不需要内核
bun run smoke   # 接口冒烟测试,需要内核和后端都在跑
bun run typecheck

另有两个一次性脚本:scripts/roundtrip.ts 验证改一处配置之后 diff 里只出现那一处,scripts/safety-net.ts 验证配置写坏时能不能把用户救回来。

目录

server/    后端。config-store.ts 是核心,那条保护链路在里面
web/       前端。styles/tokens.css 顶部写着设计基调的三条规则
shared/    两边共用的领域逻辑,纯函数,带测试
vendor/    从别的项目复制来的代码,来源和本地改动记在各自的 ORIGIN.md
scripts/   验证用的脚本,不参与打包
dev/       本地测试内核的配置
S
Description
No description provided
Readme
1.1 MiB
v0.1.3
Latest
2026-08-31 03:59:08 +08:00
Languages
TypeScript 49.2%
Vue 47.5%
Shell 2.2%
CSS 0.9%
HTML 0.2%