用途:为运行在 macOS 上的 Telegram 机器人项目生成一份生产可用的 Makefile,并集成 LaunchAgent 后台服务管理。适用于新建 Telegram 机器人项目、需要为机器人添加 macOS LaunchAgent 服务管理、希望用快捷命令启停重启机器人,或把机器人作为后台服务运行的场景。
主要能力:生成的 Makefile 包含三类命令。快速开始:make setup(首次安装依赖并创建 .env)、make run(前台运行)、make dev(自动重载的 watch 模式)。后台服务(macOS LaunchAgent):make start(安装并启动后台服务)、make stop、make restart、make status、make logs(跟踪 stdout 日志)、make logs-err(跟踪 stderr 日志)、make uninstall。开发相关:make install、make test、make typecheck、make clean。
使用方式:生成前需确认项目具备 LaunchAgent plist 模板(launchagent/com.{project-name}.plist.template)、环境文件模板 .env.example,并以 Bun 作为运行时(或自行改为 npm/node)。先向用户收集项目名称、运行命令(默认 bun run src/index.ts)、日志路径(默认 /tmp/{project-name}.log),再生成 Makefile。start 目标通过 sed 替换 plist 模板中的占位符,常见替换包括机器人令牌、允许用户 ID、用户名与路径,可按需追加更多 -e 替换规则。验证流程为 make help、make setup、make run(先前台测试)、make start、make status。
限制:资料仅覆盖 macOS LaunchAgent 场景,未提供其他平台的服务管理方案;默认运行时为 Bun,改用 npm/node 需自行修改;未提供收费、价格或效果方面的信息。