volcengine /MineContext
MineContext is your proactive context-aware AI partner(Context-Engineering+ChatGPT Pulse)
★ 5,549⑂ 415👁 22⑃ 182● 193▤ 9
TA的项目
+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
#217[BUG]: 输入了API但是Get Started没有反应也没有报错10 comments · 2025-11-03#91[BUG]:请求一直失败10 comments · 2025-10-17#243[BUG]: 自定义模型验证失败VLM validation failed Connection error.9 comments · 2025-11-11#188[Docs]: 屏幕分辨率过大导致截图文字无法识别。8 comments · 2025-10-29#187[Docs]: 期望提供本地大模型使用的教程7 comments · 2025-10-29#158[FEATURE]:增加一个x86 的mac版本吧7 comments · 2025-10-25#355[BUG]: Custom embedding endpoint fails validation due to hardcoded multimodal_embeddings() call5 comments · 2026-03-13#313[BUG]: 用硅胶流动的API,点击GetStarted后就一直转圈5 comments · 2025-12-12
Discussions
#360有关项目活跃度的讨论0 comments · 2026-04-09#297浏览器扩展开发方案讨论0 comments · 2025-12-01#195关于Token消耗的问题2 comments · 2025-10-30#137安装1 comments · 2025-10-23#89Welcome to MineContext Discussions!0 comments · 2025-10-16
Latest release
v0.1.8 v0.1.8 2026-01-28fix modify doubao embedding model