adrastea

Adrastea 是一个采用 MIT 许可的 Python 项目 (3.10+)，它为自主任务编排提出了一种“共生双引擎”架构。其核心理念是将工作分为可预测的执行层和仅在出现问题时才干预的推理层。 **System Alpha —— 确定性执行引擎** Alpha 被描述为首先启动的主进程。它处理生命周期和引导，在生成 Beta 之前验证并稳定其环境。其职责包括一个调度本地脚本、二进制文件和任务定义的任务调度器，以及一个管理标准 I/O、错误日志和进程生命周期的本地程序运行器，重点在于可重复的执行。 一个 RL 规划器使用与延迟、退出代码、资源利用率和输出有效性等结果挂钩的评分函数来引导任务序列，并使用路径寻找启发式算法根据历史和调优权重选择执行分支。Alpha 还连接到本地推理运行时（运行在 `http://127.0.0.1:11434` 的 Ollama），用于解析、格式提取和基准文本分析等离线、低开销操作。 **System Beta —— 概率性决策与推理引擎** Beta 在 Alpha 稳定后由其生成，充当非确定性问题的决策层。它监控 Alpha 的遥测数据、健康指标和任务进度，并在 Alpha 遇到未处理的异常、环境漂移、重复失败状态或执行循环时介入。Beta 还负责调优 Alpha 的 RL 规划器所使用的奖励和惩罚权重，从而有效地将执行引导至更高效的路径。 Beta 运行一个具有四种模式的自主循环：空闲/观察（被动监控）、分诊与解困（诊断阻塞条件）、优化（从已完成的执行路径中删除冗余）以及发现与创新（假设新的任务序列和目标）。它与 Model Context Protocol (MCP) 服务器集成以获取外部工具和实时上下文，并可以咨询前沿或外部 LLM 进行深度推理、战略决策、代码生成和故障排除。 **进程间通信** Alpha 和 Beta 作为并发进程运行，通过低延迟的双向通道（如域套接字、命名管道或消息总线）进行通信，传输结构化的 JSON 或 Protocol Buffer 信封。记录的控制信号包括 `SIG_SPAWN`、`SIG_HEARTBEAT`、`SIG_SLEEP`、`SIG_WAKE`、`SIG_TELEMETRY`、`SIG_STUCK`、`SIG_INTERRUPT`、`SIG_DISPATCH`、`SIG_MUTATE` 和 `SIG_TUNE_WEIGHTS`。这些信号共同涵盖了进程引导、存活心跳、睡眠/唤醒转换、结果报告、卡死状态通知、任务中止、队列注入、运行中参数变更以及 RL 权重更新。 **保活与长睡眠模式** `KeepAliveProcess` 协调器允许系统长时间睡眠以减少 CPU、内存和 Token 使用量，同时保持 Alpha 的 IPC TCP 服务器（`127.0.0.1:8765`）、客户端通道和 `DIRECTIVES.txt` 监听器处于活动状态。心跳、唤醒、睡眠和分发的信号路由旨在快速响应；后台 Beta 子进程和任务运行器保持受监督状态，并在意外终止时被重启；传入的指令或分发信号会立即唤醒系统，而无需等待睡眠定时器。 **CLI** README 文档记录了诸如 `python -m adrastea.cli keepalive --sleep-interval 300`、`ping`、`sleep --duration 600` 和 `wake` 等命令。所述前提条件包括本地 Ollama 服务器（带有 `qwen3-coder:30b` 或更轻量级的指令模型）、MCP 客户端配置、本地执行运行时（如 PowerShell、Bash、Python 或 Node）以及异步跨进程传输。请注意，README 描述的是架构意图并包含“初步的”保活措辞；未提供基准测试或性能数据，因此所述行为应被视为项目的设计目标而非测量结果。欢迎通过 fork、特性分支以及针对 `main` 分支提交 pull request 来贡献代码。