Cyrene Agent

Cyrene-Agent

English | 中文

主仓库：GitHub ・ 国内镜像：Gitee

Cyrene-Agent 是一个以《崩坏：星穹铁道》昔涟为核心角色的 Windows Live2D AI 桌面伴侣。

基于 Electron + TypeScript 开发的桌面端 Live2D 智能对话 Agent。
项目围绕昔涟（Cyrene）的角色设定，结合自研 CyreneHarness 引擎与 DMAE 记忆引擎，
将角色化聊天、个性化记忆、语音交互、工具调用与多平台接入整合在同一个桌面 Agent 中，
支持日常聊天（Chat）、辅助工作（Work）、代码协作（Code）、学习陪伴（Learn）四种对话模式。

---

✨ 速览

• 🌸 趣味桌面陪伴 — Live2D 角色常驻桌面，支持表情、动作、状态、心情、气泡互动、智能表情包与多套界面主题
• 💬 日常聊天（Chat） — 专注角色化交流，结合会话历史、用户风格与长期记忆自然回应，不暴露任何工具
• 🛠️ 辅助工作（Work） — 通用任务会话，支持联网搜索、右侧浏览器操作、文件处理、文档生成与生活服务等工具的串联调用
• 💻 代码协作（Code） — 绑定可信代码目录，提供 LSP 语义查询与受限的读写改命令执行，安全边界由权限审批统一把关
• 📚 学习陪伴（Learn） — 绑定 Obsidian Vault，陪伴用户理解材料、整理笔记、生成练习与维护进度
• 🧠 个性化记忆 — 用户wiki/summary/embedding三种记忆模式，结合 DMAE Worldbook 与条目生命周期管理，沉淀长期互动
• 🔊 语音交互 — 集成 TTS、ASR 与语音通话，让昔涟能够听见并回应用户
• 🧰 丰富工具生态 — 覆盖联网搜索、文件处理、文档生成、生活服务、音乐与 MCP 扩展
• 🔌 多模型厂商适配 — 针对不同厂商提供分级 Structured Output 与 Function Calling 兼容方案；当前型号、能力范围和核验状态见模型适配清单
• 🧩 插件系统 — 本地插件包扩展 AI 工具、聊天渠道、自有窗口与语音输入，配套 npm SDK 与开发指南
• 📱 多平台接入 — 支持桌面端、飞书、微信 iLink 与 QQ（NapCat / OneBot 11），共享角色能力与对话体验
• 🌙 主动聊天 — 根据时间、状态与用户偏好主动发起交流，并支持多渠道定向投递

---

⚙️ CyreneHarness 核心引擎

Work / Code / Learn 等需要工具调用的会话模式，全部跑在 CyreneHarness 之上。 源码：src/main/orchestrator/harness/cyrene-harness.ts

CyreneHarness 是 Cyrene Agent 的核心 Agent Loop，负责把模型决策、工具执行、副作用记账与状态恢复串成一个可中断、可恢复、可回放的连续循环。

设计与实现细节（点击展开）

会话轨迹由 CTA（Canonical Transcript Architecture） 承载：canonical journal 是唯一权威源， 模型上下文、UI 投影与渠道消息全部从 transcript 派生；压缩摘要以 checkpoint 形式持久化， 热日志归档到 segments/，支持跨进程崩溃恢复与编辑 / 重新生成回溯。 源码：src/main/orchestrator/conversation-*.ts（store / journal-service / compactor / projection 等）

关键设计：