78 lines
2.9 KiB
Markdown
78 lines
2.9 KiB
Markdown
# Cyrene v2 — 昔涟
|
||
|
||
> 自托管的「人格化通用智能体运行时」。一个 Go 单二进制，默认以「全能小女友」的人格陪伴你；在聊天/开发/家庭/工作等模式间无感切换；像 OpenClaw 一样接入多个聊天平台（QQ/微信/Telegram…）；各人格独立记忆与情绪、共享同一套能力。
|
||
|
||
**状态**：重构中（v2 推倒重写）｜ **分支**：`dev` ｜ 设计文档见 `DevDocs/00-overview.md`
|
||
|
||
---
|
||
|
||
## 核心特性
|
||
|
||
- **单二进制、进程内协作** — 所有服务同进程打包，仅 gateway `:8080` 对外；模块间走进程内接口 + 事件总线，**零跨进程 IPC**（不重蹈 v1 多端口蜘蛛网）
|
||
- **人格化陪伴** — 多人格 / 情绪状态机 / 好感度；per-persona 记忆隔离，能力全局共享
|
||
- **通用 Agent 运行时** — 多供应商 LLM、工具调用、子代理编排、记忆/RAG、多模态（vision + 语音）
|
||
- **多平台 IM（内置渠道插件）** — OneBot v11 QQ / ClawBot iLink 微信 / Telegram / Webhook，可配置、可热重载、随二进制分发
|
||
- **语境感知 UI** — 同一会话上下文下切换 聊天/开发/家庭/工作/知识/语音/视觉/子代理监控/设置 模式
|
||
- **超级详尽后台管理面板**（`/admin`）— 15 大模块统一管理
|
||
- **单二进制、多平台** — Linux / Windows / macOS / ARM / Termux
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
> 骨架刚重建，以下为演进中的目标方式。
|
||
|
||
```bash
|
||
# 配置
|
||
cp .env.example .env # 至少配置 LLM_API_KEY
|
||
|
||
# 启动
|
||
go run ./cmd/cyrene/ # 访问 http://localhost:8080
|
||
```
|
||
|
||
---
|
||
|
||
## 技术栈
|
||
|
||
| 层 | 技术 |
|
||
|----|------|
|
||
| 后端 | Go 1.26（单二进制运行时）、进程内总线（可换 NATS）、slog |
|
||
| 前端 | React 19、TypeScript、Vite 6、Tailwind 4、Zustand 5 |
|
||
| 数据库 | PostgreSQL 16 + pgvector |
|
||
| 多模态 | vision、realtime voice（STT→agent→TTS） |
|
||
| LLM | 多供应商（云端/订阅/本地/网关） |
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
```
|
||
Cyrene_v2/
|
||
├── cmd/cyrene/ # 唯一入口
|
||
├── internal/ # config / logger / platform / db / bus /
|
||
│ # runtime(核心) / persona / capability / channel
|
||
├── services/ # gateway / iot / automations
|
||
├── plugins/ # skills(功能) + channels(内置渠道)
|
||
├── pkg/plugins/sdk/ # 插件 SDK（第三方）
|
||
├── frontend/web/ # React SPA + /admin 面板
|
||
├── Docs/ # 用户文档
|
||
├── DevDocs/ # 开发文档（本地，不入库）
|
||
└── configs/ # 配置模板
|
||
```
|
||
|
||
---
|
||
|
||
## 文档
|
||
|
||
| 文档 | 位置 | 说明 |
|
||
|------|------|------|
|
||
| 架构总览/重构蓝图 | `DevDocs/00-overview.md` | 产品定位、架构、渠道插件、后台面板、阶段计划 |
|
||
| 开发约束 | `DevDocs/02-development-constraints.md` | 编码规范 + 性能要求 |
|
||
| 用户文档 | `Docs/` | 使用指南/API |
|
||
|
||
---
|
||
|
||
## License
|
||
|
||
Apache-2.0 © 2026 Aska
|