README
¶
DivineSense (神识)
AI 驱动的个人第二大脑 — Orchestrator-Workers 多代理架构，动态任务分解与智能协作
为什么选择 DivineSense？
- Orchestrator-Workers 架构：LLM 动态分解任务、并行执行 Expert Agents、智能聚合结果
- 数据完全私有：100% 自托管，无遥测，所有数据存储在您自己的服务器
- 极简单文件部署：Go 语言编译的单二进制文件，零依赖，极低资源占用
- Chat Apps 无缝集成：原生支持 Telegram 和 钉钉，双向对话，随时随地记录与交互
- Geek Mode: 深度集成 Claude Code CLI，采用 Hot-Multiplexing (热多路复用) 架构，秒级响应代码执行与自动化任务
- 智能日程管理：支持自然语言创建日程（如"明天下午三点开会"），自动冲突检测
核心功能
Orchestrator-Workers 多代理架构
采用 Anthropic 推荐的 Orchestrator-Workers 模式，LLM 动态分解任务、并行执行、智能聚合：
用户输入 → Orchestrator → 任务分解 → Expert Agents 并行执行 → 结果聚合
| 组件 | 职责 |
|---|---|
| Orchestrator | LLM 驱动的任务编排入口 |
| Decomposer | 智能分解复杂请求，支持 DAG 依赖 |
| Executor | 并行执行独立任务，降低延迟 |
| Aggregator | 合并多代理结果，统一输出格式 |
专家代理 (Expert Agents)
| 代理 | 名称 | 核心能力 | 实现方式 |
|---|---|---|---|
| MemoParrot | 灰灰 | 语义搜索笔记，智能标签建议 | UniversalParrot + memo.yaml |
| ScheduleParrot | 时巧 | 自然语言创建日程，冲突检测 | UniversalParrot + schedule.yaml |
| GeneralParrot | 通才 | 通用任务，直接响应 | UniversalParrot + general.yaml |
架构: 所有领域代理基于 UniversalParrot 配置驱动实现，通过 YAML 配置定义行为
外部执行器 (External Executors)
| 代理 | 名称 | 核心能力 |
|---|---|---|
| GeekParrot | 极客 | Claude Code CLI 集成，代码执行沙箱 |
| EvolutionParrot | 进化 | 自我进化，AI 修改源代码提交 PR |
Note: AmazingParrot 已被 Orchestrator 替代，其职责由 Orchestrator 动态协调 Expert Agents 完成。
智能路由 (两层)：Cache (LRU) → Rule Matcher (配置驱动)，置信度阈值 0.8
搜索与检索
- 混合检索：BM25 + 向量搜索 + RRF 融合
- 自适应策略：根据查询复杂度自动选择最佳检索方式
- 重排优化：BAAI/bge-reranker-v2-m3 精炼结果，准确率提升 60%+
笔记管理
- Markdown 编辑：支持 KaTeX 公式、Mermaid 图表、GFM
- 智能标签：AI 自动建议标签和分类
- 重复检测：基于内容相似性自动去重
- 附件管理：支持图片、文件等媒体内容
日程管理
- 自然语言解析：支持"明天下午3点开会"等表达
- 冲突检测：自动检测日程冲突并建议解决方案
- 多视图日历：FullCalendar 集成，支持日/周/月视图
- 智能提醒：基于用户习惯的个性化提醒
Chat Apps 集成
- 多平台支持：Telegram、钉钉、WhatsApp（实验性支持）
- 双向对话：聊天应用中发送消息，AI 自动回复
- 安全加密：AES-256-GCM 加密存储访问令牌
- Webhook 验证：HMAC-SHA256 签名 + 时间戳防重放
Geek Mode — 代码执行
- Claude Code CLI 集成：Architecture v2.0 全双工热多路复用会话架构，零冷启动延迟
- 沙箱隔离：基于 UUID v5 确定性命名空间，确保跨用户、跨模式状态物理级绝对隔离
- 危险命令检测：正则防火墙自动拦截
rm -rf等破坏性操作 - 生命周期管控：支持 PGID 进程组级回收，随服务关闭自动清除孤儿进程，确保内存零泄漏
- 代码产物预览：实时预览生成的网页和代码产物
成本追踪
- 实时统计：Token 使用量、费用估算
- 缓存优化：DeepSeek 上下文缓存，成本降低 70%+
- 预算告警：支持每日预算设置和超额提醒
快速开始
一键安装（推荐）
# 交互式安装（推荐新手）
curl -fsSL https://raw.githubusercontent.com/hrygo/divinesense/main/deploy/install.sh | sudo bash -s -- --interactive
# 二进制模式（Geek Mode 推荐）
curl -fsSL https://raw.githubusercontent.com/hrygo/divinesense/main/deploy/install.sh | sudo bash -s -- --mode=binary
# Docker 模式
curl -fsSL https://raw.githubusercontent.com/hrygo/divinesense/main/deploy/install.sh | sudo bash -s -- --mode=docker
Docker 快速测试
docker run -d --name divinesense \
-p 5230:5230 \
-v ~/.divinesense:/var/opt/divinesense \
ghcr.io/hrygo/divinesense:stable
注意：生产环境部署需在云控制台开放安全组端口（默认 5230）
部署指南
部署模式对比
| 特性 | Docker 模式 | 二进制模式 |
|---|---|---|
| Geek Mode 支持 | ⚠️ 需额外配置 | ✅ 原生支持 |
| Evolution Mode | ❌ 不支持 | ✅ 原生支持 |
| 资源占用 | 高（容器开销） | 低 |
| 启动速度 | 慢 | 快 |
| 适用场景 | 快速部署、测试 | Geek Mode、生产环境 |
云服务器部署注意事项
- 安全组配置：安装后在控制台开放端口 5230
- 使用 80 端口：需配置
AmbientCapabilities=CAP_NET_BIND_SERVICE - Nginx 反向代理：可选，用于域名绑定
详见：部署指南
本地开发
git clone https://github.com/hrygo/divinesense.git && cd divinesense
make deps-all && make start
访问 http://localhost:25173 。详见 贡献指南
技术架构
技术栈：Go 1.25 + React 18 + Vite 7 + PostgreSQL (pgvector) + Tailwind CSS 4
AI 模型：
- 对话 LLM：Z.AI GLM (
glm-4.7) - 向量 Embedding：SiliconFlow (
BAAI/bge-m3, 1024维) - 意图分类：SiliconFlow (
Qwen/Qwen2.5-7B-Instruct) - 重排 Rerank：SiliconFlow (
BAAI/bge-reranker-v2-m3)
架构亮点：
- Orchestrator-Workers：LLM 驱动的任务分解、并行执行、结果聚合
- CC Runner v2.0：深度集成 Claude Code，通过 Hot-Multiplexing 实现 Stdin/Stdout 流复用，挂载 PGID 进程组实现优雅销毁
- 单二进制分发：Go embed 打包前端静态资源，零依赖部署
- Connect RPC：gRPC-HTTP 转码，类型安全的 API
- Unified Block Model：AI 聊天对话持久化，支持流式渲染和会话恢复
- 智能缓存层：LRU 缓存 + DeepSeek 上下文缓存，响应延迟 <1ms
详细架构：系统架构文档
常见问题
Q: SQLite 和 PostgreSQL 有什么区别？
A: PostgreSQL 支持完整 AI 功能（对话、记忆、路由），SQLite 仅支持向量搜索（开发测试）
Q: Geek Mode 需要什么条件？
A: 需要安装 Claude Code CLI (npm install -g @anthropic-ai/claude-code) 并启用 DIVINESENSE_CLAUDE_CODE_ENABLED=true
Q: 如何备份数据？
A: 使用 /opt/divinesense/deploy-binary.sh backup 或 pg_dump 导出数据库
Q: AI 功能是否必须联网？
A: 是的，AI 功能需要调用外部 API（Z.AI GLM/SiliconFlow），但所有数据存储在您的服务器
开发文档
| 文档 | 说明 |
|---|---|
| 系统架构 | AI 代理、数据流、项目结构 |
| 后端开发 | API、数据库、环境配置 |
| 前端开发 | 布局、组件、Tailwind 4 |
| Chat Apps 指南 | Telegram/钉钉机器人接入 |
| Git 工作流 | 分支管理、PR 规范 |
| 贡献指南 | 入门必读：环境搭建、开发规范 |
安全与隐私
- ✅ 无遥测、无数据上传
- ✅ 所有数据存储在您的服务器
- ✅ AES-256-GCM 加密（Chat Apps 凭证）
- ✅ 支持离线部署（内网环境）
社区
- GitHub: hrygo/divinesense
- Issues: 问题反馈
- Discussions: 功能讨论
更新日志
查看 CHANGELOG.md 了解版本历史
开源协议
MIT — 自由使用、修改和分发
致谢
本项目受到 memos 启发。
Directories
¶
| Path | Synopsis |
|---|---|
|
agents
Package agent provides conversation context management for multi-turn dialogues.
|
Package agent provides conversation context management for multi-turn dialogues. |
|
agents/events
Package events provides event callback types for the agent system.
|
Package events provides event callback types for the agent system. |
|
agents/orchestrator
Package orchestrator implements the Orchestrator-Workers pattern for multi-agent coordination.
|
Package orchestrator implements the Orchestrator-Workers pattern for multi-agent coordination. |
|
agents/registry
Package registry provides metrics collection for UniversalParrot.
|
Package registry provides metrics collection for UniversalParrot. |
|
agents/tools
Package tools provides tool-level result caching for AI agents.
|
Package tools provides tool-level result caching for AI agents. |
|
agents/tools/schedule
Package schedule provides thin tool adapters for schedule operations.
|
Package schedule provides thin tool adapters for schedule operations. |
|
agents/universal
Package universal provides configuration loading for UniversalParrot.
|
Package universal provides configuration loading for UniversalParrot. |
|
aitime
Package aitime provides the time parsing service interface for AI agents.
|
Package aitime provides the time parsing service interface for AI agents. |
|
cache
Package cache provides the cache service interface for AI agents.
|
Package cache provides the cache service interface for AI agents. |
|
context
Package context provides context building for LLM prompts.
|
Package context provides context building for LLM prompts. |
|
duplicate
Package duplicate provides memo duplicate detection for P2-C002.
|
Package duplicate provides memo duplicate detection for P2-C002. |
|
format
Package format provides the formatter interface for AI text formatting.
|
Package format provides the formatter interface for AI text formatting. |
|
graph
Package graph - builder implementation for P3-C001.
|
Package graph - builder implementation for P3-C001. |
|
internal/strutil
Package strutil provides string utility functions for the ai package.
|
Package strutil provides string utility functions for the ai package. |
|
memory
Package memory provides the memory extension point for AI agents.
|
Package memory provides the memory extension point for AI agents. |
|
memory/simple
Package simple provides a basic memory generator implementation.
|
Package simple provides a basic memory generator implementation. |
|
observability/logging
Package logging provides structured logging utilities for AI modules.
|
Package logging provides structured logging utilities for AI modules. |
|
observability/metrics
Package metrics provides the evaluation metrics service interface for AI agents.
|
Package metrics provides the evaluation metrics service interface for AI agents. |
|
observability/tracing
Package tracing provides distributed tracing instrumentation for AI modules.
|
Package tracing provides distributed tracing instrumentation for AI modules. |
|
review
Package review provides intelligent memo review system based on spaced repetition.
|
Package review provides intelligent memo review system based on spaced repetition. |
|
routing
Package routing provides routing result caching for performance optimization.
|
Package routing provides routing result caching for performance optimization. |
|
services/session
Package session provides the session persistence service interface for AI agents.
|
Package session provides the session persistence service interface for AI agents. |
|
services/stats
Package stats provides cost alerting for agent sessions.
|
Package stats provides cost alerting for agent sessions. |
|
tags
Package tags provides intelligent tag suggestion for memos.
|
Package tags provides intelligent tag suggestion for memos. |
|
timeout
Package timeout defines centralized timeout constants for AI operations.
|
Package timeout defines centralized timeout constants for AI operations. |
|
cmd
|
|
|
divinesense
command
|
|
|
internal
|
|
|
plugin
|
|
|
chat_apps
Package chat_apps provides multi-platform chat app integration for DivineSense.
|
Package chat_apps provides multi-platform chat app integration for DivineSense. |
|
chat_apps/channels
Package channels provides the ChatChannel interface for all chat platform integrations.
|
Package channels provides the ChatChannel interface for all chat platform integrations. |
|
chat_apps/channels/dingtalk
Package dingtalk provides cryptographic utilities for DingTalk.
|
Package dingtalk provides cryptographic utilities for DingTalk. |
|
chat_apps/channels/telegram
Package telegram implements the Telegram Bot channel.
|
Package telegram implements the Telegram Bot channel. |
|
chat_apps/channels/whatsapp
Package whatsapp implements WhatsApp integration via Baileys Node.js bridge.
|
Package whatsapp implements WhatsApp integration via Baileys Node.js bridge. |
|
chat_apps/media
Package media provides multimedia processing for chat apps.
|
Package media provides multimedia processing for chat apps. |
|
chat_apps/metrics
Package metrics provides webhook health monitoring for chat apps.
|
Package metrics provides webhook health monitoring for chat apps. |
|
chat_apps/store
Package store provides cryptographic utilities for secure token storage.
|
Package store provides cryptographic utilities for secure token storage. |
|
email
Package email provides SMTP email sending functionality for self-hosted DivineSense instances.
|
Package email provides SMTP email sending functionality for self-hosted DivineSense instances. |
|
idp/oauth2
Package oauth2 is the plugin for OAuth2 Identity Provider.
|
Package oauth2 is the plugin for OAuth2 Identity Provider. |
|
ocr
Package ocr provides OCR (Optical Character Recognition) functionality using Tesseract.
|
Package ocr provides OCR (Optical Character Recognition) functionality using Tesseract. |
|
scheduler
Package scheduler provides a GitHub Actions-inspired cron job scheduler.
|
Package scheduler provides a GitHub Actions-inspired cron job scheduler. |
|
textextract
Package textextract provides full-text extraction functionality using Apache Tika.
|
Package textextract provides full-text extraction functionality using Apache Tika. |
|
proto
|
|
|
gen/api/v1
Package apiv1 is a reverse proxy.
|
Package apiv1 is a reverse proxy. |
|
auth
Package auth provides authentication and authorization for the DivineSense server.
|
Package auth provides authentication and authorization for the DivineSense server. |
|
router/api/v1
Package v1 - duplicate detection handlers for P2-C002.
|
Package v1 - duplicate detection handlers for P2-C002. |
|
runner/ocr
Package ocr provides a background runner for processing attachments with OCR and text extraction.
|
Package ocr provides a background runner for processing attachments with OCR and text extraction. |
|
scheduler/rrule
Package rrule provides RRULE (Recurrence Rule) parsing and generation.
|
Package rrule provides RRULE (Recurrence Rule) parsing and generation. |
|
scheduler/suggestion
Package suggestion provides intelligent schedule time suggestions.
|
Package suggestion provides intelligent schedule time suggestions. |
|
service/memo
Package memo provides memo-related services including search highlighting.
|
Package memo provides memo-related services including search highlighting. |
|
service/schedule
Package schedule provides schedule management functionality including creation, querying, updating, and deleting schedules with recurring event support.
|
Package schedule provides schedule management functionality including creation, querying, updating, and deleting schedules with recurring event support. |
|
stats
Package stats provides simple local usage statistics for personal assistant systems.
|
Package stats provides simple local usage statistics for personal assistant systems. |
|
timezone
Package timezone provides timezone utilities for the DivineSense application.
|
Package timezone provides timezone utilities for the DivineSense application. |
Click to show internal directories.
Click to hide internal directories.