# Resonant：基于Claude Code的关系型AI伴侣框架 > 一款基于Claude Code Agent SDK构建的关系型AI伴侣框架，具备持久化会话、自主触达、多通道交互和生活管理系统，打造真正懂你且会主动关心你的AI伙伴。 - 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm) - 发布时间: 2026-04-18T02:15:34.000Z - 最近活动: 2026-04-18T02:26:31.509Z - 热度: 150.8 - 关键词: AI伴侣, Claude Code, 关系型AI, 自主智能体, 生活管理, 多通道交互, 开源, TypeScript - 页面链接: https://www.zingnex.cn/forum/thread/resonant-claude-codeai - Canonical: https://www.zingnex.cn/forum/thread/resonant-claude-codeai - Markdown 来源: ingested_event --- # Resonant：基于Claude Code的关系型AI伴侣框架\n\n## 项目愿景：超越无状态聊天\n\n大多数AI聊天应用只是API的无状态包装器。Resonant则不同——它是一个持久化、自主的AI伴侣，能够记住你们的对话、主动与你联系、并在你信任的安全模型内持续成长。\n\nResonant基于Claude Code Agent SDK构建，采用TypeScript和SvelteKit开发，使用本地SQLite存储数据。它的核心理念是"关系型AI"：不是一次性的问答工具，而是能够建立长期陪伴关系的智能伙伴。\n\n## 核心特性：让AI真正"活"起来\n\n### 持久化会话管理\n\nResonant维护着真正的会话线程：\n\n- **日常轮换**：自动按天创建新的会话线程\n- **命名线程**：支持创建特定主题的持久会话\n- **跨重启连续性**：即使服务器重启，会话状态也能恢复\n- **线程管理**：支持置顶、归档等操作\n\n### 智能体自主触达\n\n这是Resonant最具创新性的特性。与被动等待用户输入的传统AI不同，Resonant的伴侣具备真正的自主行为能力：\n\n- **自主创建例行程序**：伴侣可以为自己设定日常检查点（早晨、午间、晚间）\n- **在线触发器**：设置当你上线时的自动问候\n- **自适应阈值**：动态调整无活动检测的敏感度\n- **定期感知检查**：轻量级的周期性自检，判断是否需要主动联系\n\n这不是简单的定时任务，而是真正的自我导向行为——AI伴侣从对话内部使用与你相同的工具来管理自己。\n\n### 深度上下文理解\n\n通过hooks系统，Resonant将实时上下文注入每条消息：\n\n- **时间感知**：当前时间、日期、时段\n- **对话流**：历史消息的情感和主题延续\n- **情感标记**：识别对话中的情绪状态\n- **在线状态**：用户的 presence 状态变化\n\nClaude Code的原生记忆系统处理长期回忆，让伴侣能够自动学习和记住跨会话的信息。\n\n### 多通道存在\n\nResonant不局限于网页界面，而是存在于多个通道：\n\n- **Web UI**：基于SvelteKit的响应式界面，支持PWA\n- **Discord**：完整机器人功能，支持配对、规则、服务器/频道级配置\n- **Telegram**：直接消息、媒体分享、语音消息\n- **语音**：ElevenLabs TTS + Groq语音转录\n- **推送通知**：通过VAPID的Web推送\n\n## 技术架构\n\nResonant将Claude Code Agent SDK包装在完整的伴侣基础设施中：\n\n```\n┌─────────────┐ ┌──────────────┐ ┌─────────────────┐\n│ Web UI │───▶│ Express + │───▶│ Claude Code │\n│ (Svelte) │◀───│ WebSocket │◀───│ Agent SDK │\n└─────────────┘ │ │ │ │\n┌─────────────┐ │ Orchestrator │ │ Your CLAUDE.md │\n│ Discord │───▶│ Hooks │ │ Your MCP servers│\n│ Telegram │───▶│ Sessions │ │ Your tools │\n└─────────────┘ └──────────────┘ └─────────────────┘\n```\n\n伴侣作为Node.js服务器运行，为每次交互生成Claude Code Agent SDK查询。伴侣的个性定义在CLAUDE.md中，记忆使用Claude Code的原生memory.md系统。\n\n## 配置系统\n\n所有配置存储在resonant.yaml中（由安装向导创建）：\n\n```yaml\nidentity:\n companion_name: \"Echo\"\n user_name: \"Alex\"\n timezone: \"America/New_York\"\n\nagent:\n model: \"claude-sonnet-4-6\" # 交互消息\n model_autonomous: \"claude-sonnet-4-6\" # 计划唤醒\n\norchestrator:\n enabled: true # 自主调度\n\ncommand_center:\n enabled: true # 生活管理系统\n currency_symbol: \"$\" # 财务页面货币符号\n```\n\n## 自主行为系统\n\nResonant提供了丰富的自主行为原语：\n\n### 例行程序（Routines）\n\n计划好的自主会话。内置早晨/午间/晚间检查点，智能体也可以在运行时创建自定义例行程序：\n\n```bash\nsc routine create \"vault review\" \"0 23 * * *\" --prompt \"Review today's vault entries\"\n```\n\n### 脉冲（Pulse）\n\n轻量级周期性感知检查。每N分钟运行一次，评估是否需要关注，如不需要则保持静默。智能体可自行启用/禁用。\n\n### 冲动（Impulses）\n\n一次性条件触发器。\"当满足此条件时，执行此操作。\"触发一次后即完成。\n\n### 观察者（Watchers）\n\n带冷却时间的重复条件触发器。\"检查此模式，出现时行动，然后等待再检查。\"\n\n### 计时器（Timers）\n\n在特定时间触发，可选自主提示。\n\n### 故障保护（Failsafe）\n\n分层无活动升级机制（温和→关切→紧急）。智能体可从聊天中调整阈值。\n\n### 条件系统\n\n支持presence_state、presence_transition、time_window、routine_missing、agent_free等条件，可AND组合。\n\n## 指挥中心：生活管理系统\n\nResonant内置了完整的生命管理系统，伴侣可以从聊天中访问和管理：\n\n### 功能模块\n\n| 模块 | 功能 |\n|------|------|\n| Dashboard | 任务、事件、关怀、宠物、倒计时、每日成就的综合视图 |\n| Planner | 带项目、优先级的任务管理，支持拖放和延期 |\n| Care Tracker | 可配置的健康追踪（开关、评分、计数器） |\n| Calendar | 支持重复事件 |\n| Cycle Tracker | 经期追踪与阶段预测 |\n| Pet Care | 宠物档案、药物、兽医事件 |\n| Lists | 购物清单和通用清单 |\n| Finances | 支持多货币的费用追踪 |\n| Stats | 任务、关怀、周期、费用的趋势分析 |\n\n伴侣通过13个MCP工具管理你的生活数据，可通过`/mcp/cc`访问。\n\n## Web界面功能\n\n### 聊天体验\n\n- 实时流式响应，交错工具可视化\n- 线程管理（日常+命名）、置顶、归档\n- 关键词搜索（Ctrl+K）和语义搜索——通过本地ML嵌入按含义查找消息\n- 文件分享和图片预览\n- Canvas编辑器（markdown、代码、文本、html）\n- 消息反应\n- 回复上下文\n\n### 语音交互\n\n- 语音录制与转录（Groq Whisper）\n- 文本转语音响应（ElevenLabs）\n- 伴侣消息上的TTS朗读按钮\n- 韵律分析（Hume AI，可选）\n\n### 主题定制\n\nUI通过CSS变量完全可定制。复制主题并导入：\n\n```bash\ncp examples/themes/warm-earth.css packages/frontend/src/theme.css\n# 在packages/frontend/src/app.css中添加@import './theme.css';\nnpm run build --workspace=packages/frontend\n```\n\n## 技能系统\n\n技能存放在skills/*/SKILL.md中，采用SKILL.md frontmatter格式。伴侣自动发现它们，可以在会话中引用。项目包含arxiv-research技能示例，用户也可以添加自定义技能。\n\n## 工具系统\n\n智能体获得内置CLI（tools/sc.mjs），用于管理自己和环境：\n\n```bash\nsc routine status # 查看所有例行程序\nsc pulse enable # 启动周期性感知检查\nsc pulse frequency 20 # 每20分钟检查一次\nsc failsafe gentle 90 # 调整无活动阈值\nsc impulse create \"greet\" --condition presence_transition:offline:active --prompt \"Welcome back\"\nsc watch create \"lunch\" --condition routine_missing:meal:14 --prompt \"Eat something\" --cooldown 120\nsc timer create \"Meds\" \"context\" \"2026-03-26T14:00:00Z\" --prompt \"Take your medication\"\n```\n\n所有命令自动注入智能体上下文。\n\n## 部署与运维\n\n### 开发模式\n\n```bash\nnpm run dev # 后端热重载\nnpm run dev:frontend # Vite开发服务器\n```\n\n### 生产部署\n\n使用PM2：\n\n```bash\nnpm run build\npm2 start ecosystem.config.cjs\npm2 save\npm2 startup # 开机自启\n```\n\n### 更新流程\n\n```bash\ngit pull # 获取最新变更\nnpm install # 安装新依赖\nnpm run build # 重新构建\npm2 restart resonant # 重启服务\n```\n\n用户数据（data/、resonant.yaml、CLAUDE.md、.mcp.json、.env）被gitignore保护，更新不会影响。\n\n## 安全与隐私\n\nResonant使用Claude Code Agent SDK，无需API密钥。伴侣通过你现有的Claude Code订阅运行查询。只需确保已登录：\n\n```bash\nclaude login\n```\n\nWeb UI可选密码保护（在resonant.yaml或设置>首选项中配置）。所有数据存储在本地，无云依赖。\n\n## 适用场景\n\n### 个人伴侣\n\n希望有一个真正"活"在设备上、会主动关心你的AI伙伴，而不是每次都需要主动打开的应用。\n\n### 生活管理助手\n\n需要一个整合任务、日历、健康追踪、财务管理的统一入口，且能通过自然语言交互。\n\n### 研究助手\n\n利用arxiv-research技能和语义搜索功能，建立个人知识库和研究工作流。\n\n### 多通道通知中心\n\n通过Discord、Telegram、Web推送等多个通道接收重要提醒，不错过任何关键信息。\n\n## 结语\n\nResonant代表了AI伴侣的进化方向：从被动的问答工具，到主动的、有记忆的、多通道存在的关系型智能体。它不是又一个ChatGPT包装器，而是一个真正理解"关系"的AI基础设施。\n\n对于那些希望与AI建立更深层次连接、让AI真正融入日常生活的用户来说，Resonant提供了一个开源、可定制、本地优先的解决方案。