你是不是也经历过这些瞬间？
- 本机同时跑着 SillyTavern、数据库面板、AI WebUI、小工具……
- 端口记不住，启动脚本散落在各个文件夹，每次都要翻半天
- 想关掉某个服务，却不知道是哪个进程、哪个黑窗口
- 明明开过一个 WebUI，过几天却忘了它在哪个目录
本地服务管理 就是为这种日常准备的：把
127.0.0.1上的本地 WebUI 登记 → 启停 → 打开 收进一个桌面小面板。
白天 / 夜间主题，卡片式管理运行状态、端口、进程与目录。
不知道本机还开着什么？一键扫描 TCP/UDP 监听，按进程分组，显示工作目录，点一下即可登记为服务。
服务跑着的时候，只填端口 →「从端口探测」，自动补全名称、目录和启动脚本。
| 能力 | 说明 |
|---|---|
| 服务卡片 | 登记端口、目录、启动脚本；一键打开 WebUI |
| 启动 / 无窗口启动 / 停止 | 跑 bat/ps1；停止时按端口结束进程树 |
| 本地监听端口探测 | 类似 FRP 风格的进程分组端口表；过滤 TCP/UDP、隐藏系统进程 |
| 从端口探测添加 | 运行中服务可自动识别目录与脚本 |
| 系统托盘 | 后台常驻；快捷面板 + 主窗口按需打开，减轻闲置占用 |
| 主题 | 白天 / 夜间，本地记忆 |
- 打开 Releases
- 下载
local-services-home.exe（单文件，复制即用） - 双击运行 → 托盘图标 → 快捷面板 / 主窗口
- 点 端口探测 看看本机都开了啥，或 添加服务 登记常用 WebUI
用户数据：%LOCALAPPDATA%\Local Services Home\
管理器地址：http://127.0.0.1:18888
pip install -r requirements.txt
python -m backend.desktop打包：
build.bat产物：dist\本地服务管理.exe（单文件）
- 先随便启动一次 你的本地服务（让端口监听起来）
- 打开本工具 → 端口探测 → 找到对应进程 / 端口
- 点击端口芯片 → 自动打开「添加服务」并尝试识别目录与脚本
- 保存后，以后只需在卡片上点 启动 / 停止 / 打开
- 前端：原生 HTML / CSS / JS，无构建
- 后端：FastAPI + Uvicorn，仅绑定本机
- 状态：以「端口是否可连 + 监听进程」为准，而不是 bat 是否还在
- 桌面：pywebview + 系统托盘；闲置时主窗口 / 弹窗按需创建
- 安全边界：默认
127.0.0.1；脚本路径限制在已登记目录内
backend/ # API、进程/端口、桌面入口
frontend/ # 主窗口 + 托盘快捷面板
docs/ # 截图与文档资源
build.bat # 一键打成单个 EXE
build.spec
个人本地工具。公开仓库时请勿提交含隐私路径的运行时配置。
如果你也受够了「又忘了这个 WebUI 怎么开」，欢迎 Star、Issue 和 PR。