
MineContext
主动捕捉上下文,让 AI 更懂你的每一次对话
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5543
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 环境,后端推荐使用 uv 管理依赖
- Node.js 与 pnpm(用于安装前端依赖)
- 豆包(doubao)或 OpenAI 的 embedding、VLM 模型 API Key
- macOS 或 Windows 桌面环境(客户端发布包)
安装与启动步骤
-
1下载安装客户端
从 GitHub Releases 页面下载对应系统安装包:Mac 为 dmg,Windows 为 setup.exe,直接安装即可。
-
2安装 uv 工具
后端推荐用 uv 做包管理,执行脚本安装;已安装过可跳过此步。
curl -LsSf https://astral.sh/uv/install.sh | sh -
3还原默认 PyPI 源
因包版本问题不支持国内 PyPI 镜像,需先取消全局 index-url 配置。
pip config unset global.index-url -
4安装前端依赖
进入 frontend 目录后执行 pnpm install 安装前端依赖包。
cd frontend pnpm install -
5填写配置文件
编辑 config/config.yaml,填入 embedding_model 与 vlm_model 的 api_key,按需调整采集参数。
-
6启动后端服务
用默认配置启动服务,启动前请确认配置文件中的 api_key 已替换为真实值。
uv run opencontext start
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
server.host | 否 | 后端服务监听地址 | 127.0.0.1 |
server.port | 否 | 后端服务监听端口 | 8765 |
embedding_model.provider | 是 | 嵌入模型提供方,可选 openai 或 doubao | doubao |
embedding_model.api_key | 是 | 嵌入模型调用密钥 | your-api-key |
embedding_model.model | 是 | 使用的嵌入模型名称 | doubao-embedding-vision-250615 |
vlm_model.model | 是 | 视觉语言模型名称 | doubao-seed-1-6-flash-250828 |
如何确认成功
后端启动后监听配置的 127.0.0.1:8765 且终端无报错;桌面客户端可正常打开。
常见问题
Q:Mac 提示应用被隔离或已损坏怎么办?
A:v0.1.5 起已支持 Apple 公证,无需再手动关闭 quarantine 属性;旧版本请参考 0.1.4 版本的旧文档处理。
Q:可以使用国内 PyPI 镜像加速吗?
A:不支持。README 明确说明因包版本问题需使用原始 PyPI 源,可执行 pip config unset global.index-url 还原配置。
Q:如何切换中英文提示词?
A:项目提供 config/prompts_zh.yaml 与 config/prompts_en.yaml 两套模板,按需选用中文或英文提示词模板。
Q:后端一定要用 uv 安装吗?
A:README 推荐使用 uv 进行快速可靠的包管理,因此启动命令为 uv run opencontext start。
注意事项
- README 中未给出前端页面的启动命令,装好依赖后请以官方后续说明为准。
- API Key 属于敏感信息,请勿将配置文件提交到公开仓库。
- 桌面客户端发布包目前只提供 Mac(dmg)与 Windows(exe)两种。
- 按需开启 capture.screenshot 截屏采集,采集间隔默认 5 秒,注意隐私保护。
核心亮点
- 自动捕获并整理对话上下文,减少重复输入,提升交互效率
- 基于 Context-Engineering 理念,实现主动式信息推送而非被动响应
- 提供插件系统,可无缝集成到现有 AI 工作流中
不足之处
- 文档/社区待观察
- 依赖外部 AI 服务,可能增加使用成本
适用场景
- 个人知识管理,自动归档日常对话和笔记
- 团队协作时,共享上下文减少沟通成本
- 开发者构建上下文感知的 AI 应用
替代项目
Mem0、Zep、Letta
上一篇:pyspur
同类项目推荐
superagentx
开源
策略驱动,统一管控,让AI智能体快速从想法到生产
Move from idea to production in hours with policy-driven autonomous AI agents. Unifi···
samples
开源
照着抄,快速搭建你的 AI 智能体应用
Agent samples built using the Strands Agents SDK.
lobehub
开源
把 AI 团队组织起来,7×24 小时自动干活
LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already···
tenet
开源
让 AI 连续开发 12 小时,规格驱动+DAG 编排+三重评审,结果更靠谱。
Cross-platform AI agent harness for 12+ hour autonomous development cycles. Spec-dri···
mcp-nixos
开源
让 AI 直接查 NixOS 包和配置,生成配置更省心
MCP-NixOS - Model Context Protocol Server for NixOS resources
gaia
开源
在自家 PC 上跑 AI 代理,本地执行任务不传云
Build AI agents for your PC
ToRA
开源
让大模型调用工具解数学题,准确率飙升
ToRA is a series of Tool-integrated Reasoning LLM Agents designed to solve challengi···
agent-governance-toolkit
开源
给AI代理装上企业级安全阀,跑得再野也不怕
AI Agent Governance Toolkit — Policy enforcement, zero-trust identity, execution sa···
SWE-agent
开源
丢个 GitHub issue 进去,AI 自动帮你改好代码
SWE-agent takes a GitHub issue and tries to automatically fix it, using your LM of c···