Windows 10 / 11 Python 3.10+ 零第三方依赖 release MIT

my-service

面向 AI 时代的本地控制台——把你亲手写的那些小服务,收进一处统一管理。

写一个服务变容易了,但怎么起、怎么停、活着没有、开机要不要自启、到点跑不跑、出错去哪看, 每个小服务都得重来一遍——而这里,一份 JSON 注册条就能把这些接管掉。

下载最新版 在 GitHub 查看
控制台面板

每个自建服务,都在重复同一套脏活

这些和业务无关,但少一样,服务就"不像个正经服务"。

起停脚本
每写一个服务就配一份 start/stop,还要处理残留进程
健康判断
端口通了不等于活着,HTTP 200 也可能是别人的服务
开机自启
快捷方式、计划任务、系统服务……每家做法都不一样
定时执行
错过一次就断档,还得自己防重叠、防连发
日志与审计
出事了翻控制台窗口,找不到"几点几分谁重启的"
状态漂移
进程崩了,面板还显示 running

一份注册条,接管整套运维

声明式接入:写入 reg/services/<名字>.json 即生效,不用改框架代码。

📄

一份 JSON = 一个服务

路径、启停入口、健康判据、自启与超时全部写在注册条里;保存即生效,无需重启宿主。

🎛

三种托管形态

managed 常驻托管、on_demand 点开才起并空闲回收、task 到点跑一次。管不了进程时还有点火脚本形态。

🩺

健康 + 身份双判定

HTTP / 端口 / pidfile / 进程名可任意组合;还会核对"端口上跑的是不是你",不是就拒绝停止。

⏰

定时调度

daily / weekly / interval,超时强杀整棵进程树,错过计划可选补跑,绝不堆积连发。

📜

结构化审计

每次启停与调度写进 host.jsonl,面板内直接检索"谁在几点动了什么"。

🪶

零第三方依赖

纯 Python 标准库 + 原生 JavaScript,不用装包管理器,解压就能跑。

30 秒上手

解压、启动、打开面板——不需要装 Docker,也不需要写代码。

下载解压

从 Releases 取最新的 my-service-x.y.z.zip,解压到任意目录(需要系统 Python 3.10+)。

启动宿主

pwsh -File run/start.ps1

打开面板

浏览器访问 http://127.0.0.1:1236,或在 run/ 里双击 Dashboard.url。

懒得手写配置?把服务目录和启停方式告诉 AI,让它帮你生成一份注册条:

{
  "path": "C:/path/to/your-service",
  "display": "your-service",
  "mode": "on_demand",
  "start": { "entry": "src/server.py" },
  "stop":  { "script": "run/stop.ps1" },
  "identity": { "http": "http://127.0.0.1:33510/health" },
  "settings": { "state": "active", "idle_timeout_sec": 600 }
}

面板能做什么

服务卡片

状态、端口、置信度一眼可见;启动 / 停止 / 重启,点卡片直接打开服务页面。

定时任务

启用开关、立即运行、行内修改时刻与间隔,并展示上次执行结果。

事件登记簿

按服务或失败筛选,看清每次启停的耗时与原因。

编排器设置

空闲回收时长、开机自启、更新与备份,都在面板里完成。

适合谁

写了很多小工具的人
爬虫、签到、看板、模型服务,散在各处,缺一个统一入口。
24 小时开着的家用主机
需要开机自启、远程看状态,又不想为几个脚本上 Docker。
和 AI 会话一起写服务的人
AI 帮你把服务写出来了,运维这层交给它;CLI 与 API 也能直接给 agent 用。
不喜欢装依赖的人
只有 Python 标准库,卸掉只需要删掉一个目录。