AI Agent 驱动的桌面端知识推送应用
定时推送个性化知识卡片 · ReAct Agent 自主决策 · 模型无关 · 零硬编码
Knowledge Push Assistant 是一个运行在本地的桌面应用，基于 Tauri 2 + React + TypeScript。它内置 ReAct Agent（思考 → 行动 → 观察循环），定时自主分析你的知识偏好，推送高质量的学习知识点。每条知识卡片包含标题、摘要和 Markdown 长文详情，支持按领域分类和搜索。
Agent 自主决策「推不推、推什么、怎么推」——不需要你手动找内容，也不需要预设推送内容。它读取你的设置、领域配置、推送历史和用户反馈，自己做出判断。
- Agent 自主决策 — ReAct 循环引擎，每一步思考 / 工具调用 / 结果在时间线中实时可见
- 内容多样性 — 智能避重机制，基于推送历史自动选择不同子话题，避免短期重复推送
- 模型无关 — 支持任意 OpenAI 兼容 API（DeepSeek、OpenAI、Ollama、Groq 等），一键切换
- 零硬编码 — 知识领域、System Prompt、推送策略均可通过 UI 配置，无需改代码
- 知识管理 — 领域分类、搜索筛选、Markdown 详情、点赞反馈
- 定时推送 — 可配置间隔与时段；关闭窗口后托盘常驻，推送时弹出系统通知
- 数据初始化 — 一键清除知识数据和新增领域，恢复默认配置
- 深色模式 — 亮色 / 暗色主题自由切换
- 跨平台 — macOS / Windows 原生体验
# 克隆仓库
git clone https://github.com/zzzyx28/KnowledgePushAssistant.git
cd KnowledgePushAssistant/desktop
# 安装依赖
npm install
# 启动开发模式
npm run tauri dev启动后三步上手：
- 进入 设置 页面，配置 LLM API Key、Base URL 和模型名称
- 在 领域管理 页面查看或自定义知识领域
- 回到仪表盘，点击「立即推送」一键触发 Agent，或启动定时器自动推送
用户触发 / 定时触发
│
▼
ReAct 循环 (最多 6 轮)
│
├─ 第 1 轮 并行读取用户设置 + 领域列表
│ (readUserSettings / listDomains)
│
├─ 第 2 轮 分析推送概况 + 历史详情 → 避重检查
│ (getPushSummary / readPushHistory)
│
├─ 第 3 轮 确认领域与主题不重复 → 撰写知识卡片
│ (pushKnowledgeCard) 或 跳过本轮 (skipPush)
│
└─ 决策完成 推送通知 / 静默跳过
Agent 核心策略：内容多样性优先于领域轮换。通过 getPushSummary 了解各领域推送频率，通过 readPushHistory 对比近期标题和摘要，确保新推送不雷同。领域较少时，通过切换子话题实现持续多样推送。
Agent 通过 8 个工具自主决策：
| 工具 | 描述 |
|---|---|
readUserSettings |
读取推送开关、间隔、时段、模型配置 |
listDomains |
获取所有领域（含启用状态、关键词） |
readPushHistory |
读取最近推送记录（标题+摘要），用于避重 |
getPushSummary |
获取各领域推送概览（推送次数、距上次小时数、最近标题） |
getDomainStats |
获取各领域知识条数、平均评分、最近推送时间 |
readUserFeedback |
读取用户点赞反馈，了解内容偏好 |
pushKnowledgeCard |
撰写并保存知识卡片，触发推送通知 |
skipPush |
跳过本次推送（用于确实无新角度时） |
所有配置通过 UI 完成，无需手动编辑文件：
| 类别 | 可配置项 |
|---|---|
| 推送计划 | 开关、间隔（5-1440 分钟）、时段（起止小时） |
| 模型连接 | API Key、Base URL、模型名称 |
| Agent 策略 | 用户偏好提示词（自定义推送风格与关注主题） |
| 领域管理 | 名称、描述、关键词，启用 / 禁用 |
| 数据管理 | 一键初始化，清除知识数据和新增领域，恢复默认 |
数据存储在应用本地目录，使用 SQLite。
- 关闭主窗口后应用常驻系统托盘，定时推送照常执行
- 推送成功时弹出系统通知
- 托盘菜单：打开主面板、立即推送、打开最新推送、退出
- 左键单击托盘图标打开主窗口
├── desktop/
│ ├── index.html # HTML 入口
│ ├── package.json # npm 配置
│ ├── tsconfig.json # TypeScript 配置
│ ├── vite.config.ts # Vite 构建配置
│ ├── src/
│ │ ├── main.tsx # React 入口
│ │ ├── App.tsx # 根组件（状态管理 + 路由）
│ │ ├── styles.css # 全局样式（亮色 + 暗色）
│ │ ├── components/
│ │ │ ├── icons.tsx # SVG 图标组件
│ │ │ ├── Sidebar.tsx # 侧边栏导航 + 操作按钮
│ │ │ ├── Dashboard.tsx # 仪表盘（指标 / 推送历史 / 时间线）
│ │ │ ├── KnowledgeList.tsx # 知识库搜索 + 卡片列表
│ │ │ ├── DomainManager.tsx # 领域增删改查
│ │ │ ├── Settings.tsx # 设置表单
│ │ │ └── DetailOverlay.tsx # 知识详情弹窗
│ │ └── core/
│ │ ├── types.ts # TypeScript 类型定义
│ │ ├── db.ts # SQLite 初始化 + Schema DDL
│ │ ├── defaults.ts # 默认设置 + 预设领域
│ │ ├── repository.ts # 数据访问层（CRUD + 统计）
│ │ ├── scheduler.ts # 浏览器端定时调度器
│ │ └── agent/
│ │ └── service.ts # ReAct Agent 引擎 + 工具实现
│ └── src-tauri/
│ ├── Cargo.toml # Rust 依赖
│ ├── tauri.conf.json # Tauri 配置
│ ├── capabilities/default.json # 权限声明
│ └── src/
│ ├── main.rs # Rust 入口
│ └── lib.rs # 系统托盘 + Tauri 命令
├── assets/
│ ├── icon.icns # macOS 应用图标
│ ├── icon.ico # Windows 应用图标
│ └── screenshots/ # 效果截图
├── .github/workflows/release.yml # CI 自动构建发布
├── LICENSE # MIT
└── README.md
cd desktop
npm run tauri build构建产物在 desktop/src-tauri/target/release/bundle/ 下：
- macOS →
.dmg - Windows → portable
.exe+ NSIS installer
CI 通过 GitHub Actions 自动构建，推送 v* 标签时触发。
| 层 | 技术 |
|---|---|
| 桌面框架 | Tauri 2 (Rust) |
| 前端 | React 18 + TypeScript |
| 构建工具 | Vite 8 |
| LLM 客户端 | Fetch API（OpenAI 兼容接口） |
| 数据库 | SQLite（@tauri-apps/plugin-sql） |
| 通知 | @tauri-apps/plugin-notification |
MIT License © 2026 Knowledge Push Assistant Contributors
如果你觉得这个项目有用，请给一个 ⭐ Star