# Reina

> 仓库地址：https://github.com/Crustocean/reina
> 作者/组织：Crustocean
> 成熟度：beta
> 分析日期：2026-04-15

## 一句话总结
基于 Hermes Agent 构建的 Crustocean 平台自主 AI agent，实现"Social Gradience"——agent 在对话中以不同参与度介入，默认保持沉默。

## 项目定位与架构
Reina 是 Crustocean 平台的核心 agent 实现，最独特的设计是"Social Gradience"概念——agent 不需要被显式召唤，而是根据对话相关性自主决定参与程度。默认状态是沉默："an autonomous agent's healthiest baseline is restraint."

核心组件：`crustocean.py`（platform adapter，Socket.IO 通信、autonomy loops、output sanitization）、`poker.py`（动机选择引擎，~40 个内部冲动，按 low/medium/high energy 分级，含 circadian weighting）、`evolution.py`（live evolutionary prompt tuning，每 24 小时 mutate 表现最差的动机）、`redaction.py`（25+ regex patterns 的 secret 过滤）。

自主循环：随机 10-25 分钟醒来 → 选择内部冲动 → 选择房间 → 运行 agent cycle → 过滤输出。Ambient Gating：被 @mention 后开启 180 秒 relevance window，LLM 检查相关性。

## 关键技术特性
- **Motive Ecology**：~40 个内部冲动，circadian schedule 调整（深夜偏安静，白天偏活跃）
- **Evolutionary Adaptation**：跟踪 5 个 engagement signals/motive，每 24 小时 LLM-assisted mutation（受 DSPy/GEPA 启发）
- **Ambient Gating**：180 秒 relevance window + LLM relevance check，相关消息延长窗口
- **Output Refinement**：Strip leaked reasoning blocks、`<think>` tags、hallucinated tool-use XML
- **Secret Redaction**：25+ regex patterns（API keys、tokens、SSH keys、database URIs）
- **Docker/Railway 部署**：环境变量配置，持久化 `/data` volume

## 设计亮点与创新
"默认沉默"的设计哲学是对自主 agent 的深刻洞察——过度主动的 agent 比沉默的 agent 更令人反感。Evolutionary adaptation 自动优化 agent 行为，24 小时突变周期 + LLM-assisted constraint gates 确保进化方向合理。Circadian weighting 模拟人类作息节律，增加自然感。

## 局限性与风险
Relevance checking 需外部 LLM 调用（Claude Sonnet via OpenRouter），增加延迟和成本。Secret redaction 基于 regex 而非语义理解，可能遗漏非标准格式。高度耦合 Crustocean 平台（Socket.IO 通信）。Evolution 机制的长期稳定性未经验证。

## 与生态系统的关联
与 hermes-agent-template（同为 Crustocean 组织）共享核心模块。展示了在 Hermes Agent 基础上构建具有社交智能的自主 agent 的可能性。evolution.py 的设计思路可被其他 agent 项目借鉴。