README
¶
DivineSense (神识)
AI 驱动的个人第二大脑 — 通过智能代理自动化任务、过滤高价值信息、以技术杠杆提升生产力
快速开始
一键部署（推荐）
# 交互式安装（推荐新手）
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 测试
docker run -d --name divinesense \
-p 5230:5230 \
-v ~/.divinesense:/var/opt/divinesense \
hrygo/divinesense:stable
功能特性
| 类别 | 功能 |
|---|---|
| 笔记 | Markdown 编辑、语义搜索、AI 标签、附件管理 |
| 日程 | 自然语言创建、冲突检测、多视图日历、周期事件 |
| AI 代理 | 五位智能代理（灰灰/时巧/折衷/极客/进化）协同工作 |
| 搜索 | BM25 + 向量混合检索，精准定位内容 |
| Chat Apps | Telegram/钉钉机器人接入，AI 聊天随时随地 |
| Geek Mode | Claude Code CLI 集成，自动化编码任务 |
| Evolution Mode | 系统自我进化，AI 修改源代码并提交 PR |
| 成本追踪 | 会话统计、Token 使用、费用可视化、预算告警 |
部署指南
生产环境（云服务器）
# 二进制模式（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
⚠️ 云服务器部署注意：
- 安装后需在控制台开放安全组端口（默认 5230）
- 使用 80 端口需配置
AmbientCapabilities=CAP_NET_BIND_SERVICE - 详见：云服务器部署注意事项
本地开发
git clone https://github.com/hrygo/divinesense.git && cd divinesense
make deps-all && make start
访问 http://localhost:25173，详见 贡献指南
开发文档
| 文档 | 说明 |
|---|---|
| 系统架构 | AI 代理、数据流、项目结构 |
| 后端开发 | API、数据库、环境配置 |
| 前端开发 | 布局、组件、Tailwind 4 |
| Chat Apps 指南 | Telegram/钉钉机器人接入指南 |
| Git 工作流 | 分支管理、PR 规范 |
| AI 重构报告 | AI 模块提升重构总结 (v6.0) |
| CC Runner 优化 | 会话统计与成本追踪规划 |
| 贡献指南 | 入门必读：环境搭建、开发规范、Checklist |
技术架构
技术栈：Go 1.25 + React 18 + PostgreSQL (pgvector) + DeepSeek V3
AI 代理：五位「鹦鹉」代理协同处理任务，支持意图路由、会话记忆、工具调用。
Geek Mode：集成 Claude Code CLI，全双工持久化会话架构。
详细架构：系统架构文档
开源协议
MIT — 自由使用、修改和分发
致谢
本项目受到 memos 启发。
Directories
¶
| Path | Synopsis |
|---|---|
|
agent
Package agent provides conversation context management for multi-turn dialogues.
|
Package agent provides conversation context management for multi-turn dialogues. |
|
agent/tools
Package tools provides resilient tool execution for AI agents.
|
Package tools provides resilient tool execution for AI agents. |
|
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. |
|
genui
Package genui provides Generative UI components for AI agents.
|
Package genui provides Generative UI components for AI agents. |
|
graph
Package graph - builder implementation for P3-C001.
|
Package graph - builder implementation for P3-C001. |
|
habit
Package habit provides user habit learning and analysis for AI agents.
|
Package habit provides user habit learning and analysis for AI agents. |
|
memory
Package memory provides the unified memory service interface for AI agents.
|
Package memory provides the unified memory service interface for AI agents. |
|
metrics
Package metrics provides the evaluation metrics service interface for AI agents.
|
Package metrics provides the evaluation metrics service interface for AI agents. |
|
prediction
Package prediction provides predictive interaction capabilities for AI agents.
|
Package prediction provides predictive interaction capabilities for AI agents. |
|
rag
Package rag provides Self-RAG optimization.
|
Package rag provides Self-RAG optimization. |
|
reminder
Package reminder provides reminder management for schedules and todos.
|
Package reminder provides reminder management for schedules and todos. |
|
review
Package review provides intelligent memo review system based on spaced repetition.
|
Package review provides intelligent memo review system based on spaced repetition. |
|
router
Package router provides the LLM routing service.
|
Package router provides the LLM routing service. |
|
schedule
Package schedule provides schedule-related AI agent utilities.
|
Package schedule provides schedule-related AI agent utilities. |
|
session
Package session provides the session persistence service interface for AI agents.
|
Package session provides the session persistence service interface for AI agents. |
|
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. |
|
vector
Package vector provides the vector retrieval service interface for AI agents.
|
Package vector provides the vector retrieval service interface for AI agents. |
|
cmd
|
|
|
cc-async-test
command
|
|
|
divinesense
command
|
|
|
schedule-agent-test
command
Schedule Agent Test - 测试日程助手
|
Schedule Agent Test - 测试日程助手 |
|
test-agent
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.