MineContext

智能体与MCP 5.5k 413 Python 上架 2026-11-09 在 GitHub 打开

MineContext 是一个具有上下文感知能力的主动式AI伙伴。它基于屏幕截图+内容理解的方式（未来还将支持其他来源的多模态信息，包括文档、图片、视频、代码、外部应用数据），能够看到并看懂用户的数字...

#Agent

项目信息

所有者: volcengine
Star: 5.5k
Fork: 413
开源协议: —
主要语言: Python
发布时间: 2025-06-24
最近更新: 2026-05-07

项目更新

v0.1.82026-01-28
修复豆包嵌入（embedding）模型的调用实现，修正了此前模型标识与参数处理不当导致的向量生成异常。升级后，使用豆包进行文本向量化的功能即可恢复正常，无需改动接入代码。
v0.1.72025-12-25
v 版本更新：修复了模型校验时弹窗显示异常的问题，此前校验失败或提示信息会以错误的方式弹出，干扰操作流程，现在恢复正常。功能方面新增了 MineContext 热力图支持，可在界面上直观呈现模型的注意力与激活分布，便于排查异常和调整参数，对调试与调优工作更有参考价值。
v0.1.62025-11-18
0.1.5 对提示词做的改动上线后，部分模型的表现明显下滑，因此 0.1.6 已将该修改回滚，恢复到此前的提示词版本。如果此前因模型表现异常而受困扰，升级到 0.1.6 即可解决。
v0.1.5:Granite2025-11-14
Granite 版（2025 年 11 月 1 日至 14 日）围绕安装与使用连续性做了三处改进。构建现已通过 Apple 公证（Notarization），后续版本安装不再需要命令行绕过权限限制，双击即可正常运行，安全性更有保障。新增自动更新检查，升级时只拉取增量内容，不必整包重新下载。聊天记录现在在首页与创作页之间共用同一份历史，来回切换不会丢；同时程序会在后台自动保存调试信息，排查问题时可直接调取。
v0.1.4:Opal2025-11-01
版本 Opal（2025 年 10 月 24 日至 31 日）主要围绕录制体验与截图处理做了一轮改造。 Windows 和 macOS 新增托盘图标控制，可随时继续或停止录制，关掉窗口后录制也会继续；录制界面同步显示实时状态，包括已处理的图片数量。截图处理模块被整体重写，从一次性批量解析改为基于协程的单图并发解析再合并，解析准确率有所提升。日报的内容质量也做了优化。Windows 端还支持自定义安装数据目录。修复方面，解决了设置页 API 失效的问题，并修正了屏幕处理流程，同时补充了相关日志。
v0.1.3:Stibnite2025-10-24
版本 Stibnite（2025 年 10 月 17 日–24 日）主打跨平台兼容与开发者工具。安装构建上：Windows 可执行文件定位与路径处理更可靠，补齐 PyInstaller 配置，新增跨平台 Python 构建脚本；默认端口由 8000 改为 1733，避开常见端口冲突。界面重做了顶部导航栏，创作面板加入每日摘要与提示直达，设置弹窗内置截图预览，内容支持复制与编辑变更追踪。开发者侧新增处理器监控面板、自定义设置项、Prompt 调试工具、生成记录以及更细的性能日志。聊天回复改为流式输出，观感更跟手。修复项包括切换 Custom Platform 时原配置未恢复、若干编译错误、模型校验缺图片格式检查，以及空待办列表、报告生成失败等问题。
v0.1.2: Fluorite2025-10-15
Fluorite 版本更新（10月11日–15日）：前端代码已开源，新增自定义模型选择、活动自动刷新接口（5秒轮询）与截图自动清理功能（保留15天，每日执行一次）。F12 开发者工具从全局快捷键改为应用内快捷键，截图默认间隔调至 15 秒，模型设置保存失败时会弹出错误提示。修复包括：Dock 图标过大、截图因路径与时间戳不匹配导致的读取失败、活动列表跨日期数据错乱及历史日期轮询问题；同时清理了调试日志，修复界面图标显示问题，解决了 message.error() 与 React 19 的兼容性问题，恢复了 API key 弹窗。文档新增自定义模型使用、后端调试接口、前端框架与开发环境三部分说明。
v0.1.1: Moss Agate2025-10-11
Moss Agate（2025.9.30–10.11）这版重心在底层重构：依赖管理从 pip/requirements.txt 迁到 pyproject.toml 并启用 uv，构建脚本与 .python-version 一并更新，安装更快也更省心。安全上，模型设置中的 API key 改为掩码返回，读取和更新接口都不再暴露明文。启动新增 --port、--host、--config 三个参数，优先级为命令行 > 配置文件 > 默认值，多实例并跑不再撞端口；服务启动前先初始化配置，避免缺配置导致的报错。日报重复生成的问题已修复，调度逻辑同步调整。聊天与 todo 列表的响应和状态管理有所改进，工具描述的措辞也更准确。README 链接与 Issue/PR 模板补齐，文档结构更完整。
v0.1.0: Hello World2025-09-30
MineContext 是一款主动式上下文感知 AI 助手，围绕三个核心能力展开：无感收集、智能重现、主动推送。它会在后台持续采集屏幕等多源多模态数据，经处理后存储在本地，全程不上传，隐私可控；同时在你创作时智能调出相关上下文，做到有帮助而不打扰。更实用的是它会把上下文自动提炼成待办、小贴士、日报周报与活动概览，主动推到首页，也支持通过【Chat With AI】追问。首次使用需从 Release 下载后解除 macOS 隔离属性： `` sudo xattr -d com.apple.quarantine "/Applications/MineContext.app" `` 随后在【设置】中填入 API-Key（现支持豆包与 OpenAI，后续将接入更多平台及本地 Ollama 模型），在【屏幕监视】里圈定录制区域、点击【开始录制】即可，之后便无需再操心。