toolguard-daemon-control

toolguard-daemon-control 是一款专为 macOS 设计的轻量级守护进程管理工具，旨在简化开发者将任意可执行程序转化为持久化后台服务的流程。通过封装 macOS 原生的 launchd 系统，该工具解决了开发环境中长期运行服务（如本地 API 服务器、代理工具或自定义脚本）时面临的进程保活、日志管理和开机自启等痛点，无需复杂的 plist 配置或 sudo 权限即可实现专业级的服务管理。

核心用法围绕五个 shell 脚本展开。install.sh 用于创建并启动服务，接受服务名称、可执行文件绝对路径及参数，支持指定工作目录和环境变量，自动生成 launchd 所需的 plist 配置文件并加载到 ~/Library/LaunchAgents/ 目录；uninstall.sh 负责卸载指定服务，停止进程并清理配置文件但保留日志；status.sh 和 list.sh 提供状态查询功能，前者支持查看特定服务详细状态，后者列出所有由该工具管理的服务；logs.sh 则方便开发者查看服务的标准输出和错误日志，支持实时追踪（--follow）和指定行数（--lines）。所有服务默认启用 KeepAlive 机制，崩溃后自动重启，日志统一归档于用户目录下的 ~/Library/Logs/toolguard/。

显著优点体现在其简洁性与安全性上。首先，完全基于用户权限运行，无需 sudo 即可管理系统服务，降低了误操作对系统造成影响的风险。其次，代码完全透明，由纯 shell 脚本构成，无二进制黑盒，便于安全审计。再者，零外部依赖，仅使用 macOS 系统自带的 launchctl、tail、grep 等工具，避免了包管理器带来的供应链风险。自动重启机制和结构化的日志管理大幅提升了开发效率，而清晰的路径隔离（所有文件操作均限于用户主目录）确保了系统的整洁性。

潜在缺点与局限性同样明显。该工具严格绑定 macOS 的 launchd 机制，无法跨平台使用于 Linux 或 Windows 系统。install.sh 脚本中使用 eval 命令展开工作目录路径，虽在实际场景中风险极低，但理论上存在命令注入的可能性，要求用户确保 --workdir 参数的可信度。此外，launchd 不支持直接运行 go run 这类需要解释器的命令，用户必须预先将 Go 程序编译为二进制文件，这对快速迭代开发略显不便。服务以当前用户身份运行，也意味着无法管理系统级守护进程或绑定 1024 以下的特权端口。

该技能主要面向 macOS 平台上的后端开发者、DevOps 工程师以及需要将开发工具长期驻留后台的高级用户。特别适合管理本地开发环境的多服务架构，如同时运行前端构建工具、后端 API 服务和数据库代理。对于需要确保关键进程持续运行、且希望避免 Docker 等容器化方案过重开销的场景，该工具提供了轻量级的替代方案。

使用过程中的常规风险主要包括配置失误导致的服务异常循环重启、日志文件长期积累占用磁盘空间，以及因 eval 使用不当引发的潜在路径解析问题。建议用户定期检查日志目录大小，卸载不再使用的服务以释放资源，并在指定工作目录时避免使用来源不明的变量输入。尽管代码已通过安全性认证（A 级），但在生产环境关键基础设施中仍建议谨慎使用，更适合作为开发测试环境的辅助工具。