volcengine /MineContext

MineContext is your proactive context-aware AI partner(Context-Engineering+ChatGPT Pulse)

★ 5,549⑂ 415👁 22⑃ 182● 193▤ 9
PythonApache-2.0Created 2025-06-24
下载:v0.1.8v0.1.8 ↓0.1.82026-01-28
+2
日增长
5,549
stars
415
forks
22
watchers
182
prs
193
issues
9
releases

README

MineContext:洞察本质,激发创造

一个开源、主动的上下文感知 AI 伙伴,致力于让您的工作、学习与创作更加清晰高效。

中文 / English

社区实践 · 反馈问题 · 提交问卷

[![][release-shield]][release-link]
[![][github-stars-shield]][github-stars-link]
[![][github-issues-shield]][github-issues-shield-link]
[![][github-contributors-shield]][github-contributors-link]
[![][license-shield]][license-shield-link]  
[![][last-commit-shield]][last-commit-shield-link]
[![][wechat-shield]][wechat-shield-link]



👋 加入我们的 微信 / 飞书 / 小红书交流群

🌍 加入我们的 Discord 社区

🖥️ Mac 版下载 · 💻 Windows 版下载


  
目录

- 👋🏻 MineContext 是什么
- 🚀 核心功能
- 🔏 隐私保护
  - 本地存储
  - 本地模型
- 🏁 快速开始
  - 1. 安装
  - 2. 输入您的 API 密钥
  - 3. 开始记录
  - 4. 忘掉它
  - 5. 后台调试
- 🎃 贡献指南
  - 🎨 前端架构
    - 核心技术栈
    - 核心架构
  - 💻 前端使用
    - 构建后端
    - 安装依赖
    - 开发调试
    - 应用打包
  - 🏗️ 后端架构
    - 核心架构组件
    - 各层职责
  - 🚀 后端使用
    - 安装
    - 配置
    - 运行服务器
- 💎 MineContext 与我的世界
- 🎯 目标用户
- 🔌 上下文来源
- 🆚 与同类应用的比较
  - MineContext vs ChatGPT Pulse
  - MineContext vs Dayflow
- 👥 社区
  - 社区与支持
- Star History
- 📃 许可证



 🔗 相关项目:欢迎了解 OpenViking - 一个专为 AI Agents 设计的开源上下文数据库。OpenViking 通过"文件系统范式"统一管理记忆、资源和技能三类上下文,为复杂的上下文管理提供基础设施层。



 👋🏻 MineContext 是什么

MineContext 是一个具有上下文感知能力的主动式 AI 伙伴。它基于屏幕截图+内容理解的方式(未来还将支持其他来源的多模态信息,包括文档、图片、视频、代码、外部应用数据),能够看到并看懂用户的数字世界上下文,然后再基于底层的上下文工程框架,主动推送洞察、日/周总结 、待办、活动记录等高质量信息,同时支持用户基于 Context 和生成的信息进行再创作。

!feature.gif

 🚀 核心功能

MineContext 专注于四个核心功能:无负担收集、主动推送、智能浮现和上下文工程架构。

1. 📥 无负担收集
   支持收集和处理海量的 Context,并通过设计存储管理来实现海量收集却没有心智负担。
2. 🚀 主动推送
   支持日常主动推送关键信息和洞见,能够提炼 Context 中的总结信息,比如每日总结,每周总结,tips,todo,主动推送到主页。
3. 💡 智能浮现(实现中)
   支持创作时智能浮现,可以随时浮现相关有用的 Context,确保辅助创作又不会被淹没
4. 🎯 上下文工程架构
   支持多模态、多源数据的完整生命周期——从捕获、处理和存储到管理、检索和消费——支持生成六种类型的智能上下文。

 🔏 隐私保护

 本地存储

MineContext 非常注重用户隐私,所有数据都默认保存在本地如下路径,确保您的隐私和安全。


~/Library/Application Support/MineContext/Data


 本地模型

此外我们支持了 OpenAI API 协议的自定义模型服务,您可以在 MineContext 中使用全本地模型,做到任何数据不上云。

 🏁 快速开始

 1. 安装

点击 Github Latest Release 下载最新版本。

!Download APP

 注意:从 v0.1.5 版本开始,MineContext 已支持 Apple 公证,因此不再需要禁用隔离属性。如果您使用的是旧版本,请参考之前的文档获取相关说明。

 2. 输入您的 API 密钥

应用程序启动后(首次运行时需要安装后端环境,约需等待两分钟),请根据引导输入您的 API 密钥。目前我们支持豆包、OpenAI 以及自定义模型服务,包括任何兼容 OpenAI API 格式的本地模型或第三方模型服务。
我们推荐使用 LMStudio 来运行本地模型,它提供了简单的界面和强大的功能,能够帮助您快速部署和管理本地模型。

综合成本和性能,我们推荐使用豆包模型,豆包模型的 API-Key 可以在 API 管理界面 生成。

获取豆包 API 之后需要在 模型开通管理界面 开通视觉语言模型和向量化两个模型。

- 视觉语言模型:Doubao-Seed-1.6-flash
  !doubao-vlm-model

- 向量化模型:Doubao-embedding-vision
  !doubao-emb-model

以下是获取了 API Key 后的填写流程:
!Enter API-Key

 3. 开始记录

进入【Screen Monitor】启用屏幕分享的系统权限,设置完之后需要重新启动应用使其生效。

!Enable-Permissions

重新启动应用后,请先在【Settings】设置您的屏幕共享区域,然后点击【Start Recording】开始截图。

!Screen-Settings

 4. 忘掉它

启动记录后,您的上下文将逐渐被收集。这会需要一些时间才能产生价值。所以说,忘记它,安心专注于其他任务吧。MineContext 将会在后台为您生成待办事项、提示、摘要和活动。当然,您也可以通过【Chat with AI】进行主动问答。

 5. 后台调试

MineContext 支持在http://localhost:1733 进行后台调试。

1.支持查看 Token 用量与使用情况

!后台调试1

2.支持主动推送任务的时间间隔设置

!后台调试2

3.支持调整主动推送任务的系统提示词

!后台调试3

 🎃 贡献指南

 🎨 前端架构

MineContext 前端 是一个基于 Electron、React 和 TypeScript 构建的 跨平台桌面应用程序,提供模块化、可维护且高性能的桌面开发基础。

 核心技术栈

| 技术         | 描述                                       

Top issues

Discussions

Latest release

v0.1.8 v0.1.8 2026-01-28
fix
modify doubao embedding model

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON