[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-volcengine--MineContext":3,"tool-volcengine--MineContext":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",159636,2,"2026-04-17T23:33:34",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":78,"owner_url":79,"languages":80,"stars":115,"forks":116,"last_commit_at":117,"license":118,"difficulty_score":42,"env_os":119,"env_gpu":120,"env_ram":121,"env_deps":122,"category_tags":131,"github_topics":132,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":147,"updated_at":148,"faqs":149,"releases":185},8755,"volcengine\u002FMineContext","MineContext","MineContext is your proactive context-aware AI partner（Context-Engineering+ChatGPT Pulse）","MineContext 是一款主动式、具备上下文感知能力的 AI 伙伴，旨在从杂乱的信息中为用户提炼清晰与高效。它不仅能像人类一样“看见”并理解你当前的屏幕内容（通过截图分析），还能结合文档、代码及多模态信息，主动提供贴合当下场景的智能辅助，从而解决传统 AI 助手缺乏环境感知、需要用户反复描述背景的痛点。\n\n无论是需要快速梳理思路的研究人员、追求效率的开发者与设计师，还是希望优化日常 workflows 的普通用户，都能借助 MineContext 实现更自然的交互体验。其核心技术亮点在于“本地优先（Local-First）”架构：所有敏感数据默认在本地处理，支持部署本地 AI 模型，在保障隐私安全的同时，实现了低延迟的实时响应。此外，项目背后依托 OpenViking 开源上下文数据库，采用类似文件系统的范式统一管理记忆、资源与技能，为复杂的上下文管理提供了坚实的基础设施。作为一款开源工具，MineContext 致力于成为你工作与创作中懂你所想、 proactive（主动出击）的得力助手。","\u003Cdiv align=\"center\">\n\n\u003Cpicture>\n  \u003Cimg alt=\"MineContext\" src=\"src\u002FMineContext-Banner.svg\" width=\"100%\" height=\"auto\">\n\u003C\u002Fpicture>\n\n### MineContext: Create with Context, Clarity from Chaos\n\nAn open-source, proactive context-aware AI partner, dedicated to bringing clarity and efficiency to your work, study and creation.\n\n[中文](README_zh.md) \u002F English\n\n\u003Ca href=\"https:\u002F\u002Fbytedance.larkoffice.com\u002Fwiki\u002FHn6ewRnAwiSro7kkH6Sc1DMFnng\">Community Best Practice\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\">Report Issues\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fbytedance.larkoffice.com\u002Fshare\u002Fbase\u002Fform\u002FshrcnPAjJtlufuhBZGegll41NOh\">Feedback\u003C\u002Fa>\n\n[![][release-shield]][release-link]\n[![][github-stars-shield]][github-stars-link]\n[![][github-issues-shield]][github-issues-shield-link]\n[![][github-contributors-shield]][github-contributors-link]\n[![][license-shield]][license-shield-link]  \n[![][last-commit-shield]][last-commit-shield-link]\n[![][wechat-shield]][wechat-shield-link]\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F15157\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_0b0cf02be0f5.png\" alt=\"volcengine%2FMineContext | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n👋 Join our [WeChat \u002F Lark \u002F Red Note Group](https:\u002F\u002Fbytedance.larkoffice.com\u002Fwiki\u002FHg6VwrxnTiXtWUkgHexcFTqrnpg)\n\n🌍 Join our [Discord Group](https:\u002F\u002Fdiscord.gg\u002FtGj7RQ3nUR)\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases\u002Fdownload\u002Fv0.1.8\u002FMineContext-0.1.8.dmg\">🖥️ Download for Mac\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases\u002Fdownload\u002Fv0.1.8\u002FMineContext-0.1.8-setup.exe\">💻 Download for Windows\u003C\u002Fa>\n\n\u003C\u002Fdiv>\n\nTable of Contents\n\n- [👋🏻 What is MineContext](#-what-is-minecontext)\n- [🚀 Key Features](#-key-features)\n- [🔏 Privacy Protection](#-privacy-protection)\n  - [Local-First](#local-first)\n  - [Local AI model](#local-ai-model)\n- [🏁 Quick Start](#-quick-start)\n  - [1. Installation](#1-installation)\n  - [2. Enter Your API Key](#2-enter-your-api-key)\n  - [3. Start Recording](#3-start-recording)\n  - [4. Forget it](#4-forget-it)\n  - [5. Backend Debugging](#5-backend-debugging)\n- [🎃 Contribution Guide](#-contribution-guide)\n  - [🎨 Frontend Architecture](#-frontend-architecture)\n    - [Core Tech Stack](#core-tech-stack)\n    - [Core Architecture](#core-architecture)\n  - [💻 Frontend Usage](#-frontend-usage)\n    - [Build Backend](#build-backend)\n    - [Install Dependencies](#install-dependencies)\n    - [Development and Debugging](#development-and-debugging)\n    - [Application Packaging](#application-packaging)\n  - [🏗️ Backend Architecture](#️-backend-architecture)\n    - [Core Architecture Components](#core-architecture-components)\n    - [Layer Responsibilities](#layer-responsibilities)\n  - [🚀 Backend Usage](#-backend-usage)\n    - [Installation](#installation)\n    - [Configuration](#configuration)\n    - [Running the Server](#running-the-server)\n- [💎 The Philosophy Behind the Name](#-the-philosophy-behind-the-name)\n- [🎯 Target User](#-target-user)\n- [🔌 Context-Source](#-context-source)\n- [🆚 Comparison with Familiar Application](#-comparison-with-familiar-application)\n  - [MineContext vs ChatGPT Pulse](#minecontext-vs-chatgpt-pulse)\n  - [MineContext vs Dayflow](#minecontext-vs-dayflow)\n- [👥 Community](#-community)\n  - [Community and Support](#community-and-support)\n- [Star History](#star-history)\n- [📃 License](#-license)\n\n\u003Cbr>\n\n> **🔗 Related Project**: Check out **[OpenViking](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FOpenViking)** - An open-source Context Database designed for AI Agents. OpenViking unifies Memories, Resources, and Skills through a \"file system paradigm\", providing the infrastructure layer for sophisticated context management.\n\n\u003Cbr>\n\n# 👋🏻 What is MineContext\n\nMineContext is a proactive context-aware AI partner. By utilizing screenshots and content comprehension (with future support for multi-source multimodal information including documents, images, videos, code, and external application data), it can see and understand the user's digital world context. Based on an underlying contextual engineering framework, it actively delivers high-quality information such as insights, daily\u002Fweekly summaries, to-do lists, and activity records.\n\n![feature.gif](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_c446b86d333f.gif)\n\n# 🚀 Key Features\n\nMineContext focuses on four key features: effortless collection, intelligent resurfacing, proactive delivery, and a context engineering architecture.\n\n1. 📥 Effortless Collection\n   Capable of gathering and processing massive amounts of context. Designed storage management enables extensive collection without adding mental burden.\n2. 🚀 Proactive Delivery\n   Delivers key information and insights proactively in daily use. It extracts summarized content from your context—such as daily\u002Fweekly summaries, tips, and todos—and pushes them directly to your homepage.\n3. 💡 Intelligent Resurfacing\n   Surfaces relevant and useful context intelligently during creation. Ensures assisted creativity without overwhelming you with information.\n4. 🎯 Context Engineering Architecture\n   Supports the complete lifecycle of multimodal, multi-source data—from capture, processing, and storage to management, retrieval, and consumption—enabling the generation of six types of intelligent context.\n\n# 🔏 Privacy Protection\n\n## Local-First\n\nMineContext places a high priority on user privacy. By default, all data is stored locally in the following path to ensure your privacy and security.\n\n```\n~\u002FLibrary\u002FApplication Support\u002FMineContext\u002FData\n```\n\n## Local AI model\n\nIn addition, we support custom model services based on the OpenAI API protocol. You can use fully local models in MineContext, ensuring that any data does not leave your local environment.\n\n# 🏁 Quick Start\n\n## 1. Installation\n\nClick [Github Latest Release](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases) to Download\n\n![Download APP](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_bd7fba4daf45.gif)\n\n> **Note**: Starting from v0.1.5, MineContext supports Apple notarization, so you no longer need to disable the quarantine attribute. If you're using an older version, please refer to the [previous documentation](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fblob\u002F0.1.4\u002FREADME.md) for instructions.\n\n## 2. Enter Your API Key\n\nAfter the application launches, please follow the prompts to enter your API key. (Note: On the first run, the application needs to install the backend environment, which may take about two minutes).\n\nWe currently support services from Doubao, OpenAI, and custom models. This includes any **local models** or **third-party model** services that are compatible with the OpenAI API format.\n\nWe recommend using [LMStudio](https:\u002F\u002Flmstudio.ai\u002F) to run local models. It provides a simple interface and powerful features to help you quickly deploy and manage them.\n\n**Considering both cost and performance, we recommend using the Doubao model.** The Doubao API Key can be generated in the [API Management Interface](https:\u002F\u002Fconsole.volcengine.com\u002Fark\u002Fregion:ark+cn-beijing\u002FapiKey).\n\nAfter obtaining the Doubao API Key, you need to activate two models in the [Model Activation Management Interface](https:\u002F\u002Fconsole.volcengine.com\u002Fark\u002Fregion:ark+cn-beijing\u002Fmodel): the Visual Language Model and the Embedding Model.\n\n- Visual Language Model: Doubao-Seed-1.6-flash\n  ![doubao-vlm-model](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_6fcb961d376d.png)\n\n- Embedding Model: Doubao-embedding-vision\n  ![doubao-emb-model](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_d0188a1e3693.png)\n\nThe following is the filling process after obtaining the API Key:\n\n![Enter API Key](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_7ec5e538fcbd.gif)\n\n## 3. Start Recording\n\nEnter [Screen Monitor] to enable the system permissions for screen sharing. After completing the setup, you need to restart the application for the changes to take effect.\n![Enable-Permissions](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_bef30f434a61.gif)\n\nAfter restarting the application, please first set your screen sharing area in [Settings], then click [Start Recording] to begin taking screenshots.\n![Screen-Settings](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_3f2cf9f4e80e.gif)\n\n## 4. Forget it\n\nAfter starting the recording, your context will gradually be collected. It will take some time to generate value. So, forget about it and focus on other tasks with peace of mind. MineContext will generate to-dos, prompts, summaries, and activities for you in the background. Of course, you can also engage in proactive Q&A through [Chat with AI].\n\n## 5. Backend Debugging\n\nMineContext supports backend debugging, which can be accessed at `http:\u002F\u002Flocalhost:1733`.\n\n1.View Token Consumption and Usage\n![后台调试1](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_4bedf156972c.png)\n\n2.Configure Interval for Automated Tasks\n![后台调试2](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_31fc236a8541.png)\n\n3.Adjust System Prompt for Automated Tasks\n![后台调试3](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_1ccebc3176b3.png)\n\n# 🎃 Contribution Guide\n\n## 🎨 Frontend Architecture\n\nThe MineContext frontend is a cross-platform desktop application built with Electron, React, and TypeScript, providing a modular, maintainable, and high-performance foundation for desktop development.\n\n### Core Tech Stack\n\n| Technology   | Description                                                                               |\n| ------------ | ----------------------------------------------------------------------------------------- |\n| Electron     | Allows for the development of cross-platform desktop applications using web technologies. |\n| React        | A component-based UI library for building dynamic user interfaces.                        |\n| TypeScript   | Provides static type checking to enhance code maintainability.                            |\n| Vite         | A modern frontend build tool optimized for Electron.                                      |\n| Tailwind CSS | A utility-first CSS framework for rapid and consistent UI styling.                        |\n| pnpm         | A fast and efficient package manager suitable for monorepo projects.                      |\n\n### Core Architecture\n\nThe project follows a standard Electron architectural design, clearly separating the code for the main process, preload scripts, and renderer process to ensure security and maintainability.\n\n```\nfrontend\u002F\n├── src\u002F\n│ ├── main\u002F     # Electron main process (window management, lifecycle, IPC)\n│ ├── preload\u002F  # Preload script, securely bridging Node APIs and the renderer process\n│ └── renderer\u002F # React frontend interface (renderer process)\n│\n├── packages\u002F\n│ └── shared\u002F   # Common utilities, IPC channels, logging, and constant definitions\n│\n├── build\u002F      # Build resources (icons, platform configurations)\n├── dist\u002F       # Build artifacts generated by electron-builder\n├── externals\u002F  # External dependencies (Python scripts, binaries, etc.)\n├── resources\u002F  # Static assets (icons, templates, images)\n└── scripts\u002F    # Development and build helper scripts\n```\n\n1.  **Main Process (`src\u002Fmain\u002F`) is responsible for:**\n\n    - Managing application windows\n    - Handling lifecycle events (startup, quit, activate)\n    - Establishing secure IPC communication\n    - Integrating with backend services (Python and system APIs)\n\n2.  **Preload Script (`src\u002Fpreload\u002F`) is responsible for:**\n\n    - Securely exposing Node.js APIs to the renderer process\n    - Handling IPC communication with the main process\n    - Implementing cross-process resource access\n\n3.  **Renderer Process (`src\u002Frenderer\u002F`) is responsible for:**\n\n    - Implementing the user interface with React\n    - Managing global state with Jotai and Redux\n    - Utilizing an efficient styling system based on Tailwind CSS\n    - Implementing dynamic loading and performance optimization mechanisms\n\n4.  **Build and Packaging are responsible for:**\n\n    - `electron-vite.config.ts` — Configures the build logic for both the main and renderer processes (aliases, plugins, etc.).\n    - `electron-builder.yml` — Defines packaging and distribution configurations for Windows, macOS, and Linux.\n\n## 💻 Frontend Usage\n\n### Build Backend\n\nBefore starting frontend development, you need to build the backend first:\n\n```bash\nuv sync\nsource .venv\u002Fbin\u002Factivate\n.\u002Fbuild.sh\n```\n\n### Install Dependencies\n\nDue to package version issues, using a domestic PyPI mirror is not currently supported. Please run the following command to ensure you are using the original PyPI source:\n\n```bash\npip config unset global.index-url\ncd frontend\npnpm install\n```\n\n### Development and Debugging\n\nDuring local development, it is normal for the screen capture area selection to be slow. Please wait, as this issue does not exist in the packaged application.\n\n```bash\npnpm dev\n```\n\n### Application Packaging\n\nTo build APP for macOS:\n\n```bash\npnpm build:mac\n# Data Path\n# ～\u002FLibrary\u002FApplication\\ Support\u002FMineContext\n```\n\nThe executable files generated by the packaging process will be stored in the `MineContext\u002Ffrontend\u002Fdist` directory.\n\n## 🏗️ Backend Architecture\n\nMineContext adopts a modular, layered architecture design with clear separation of concerns and well-defined responsibilities for each component.\n\n### Core Architecture Components\n\n```\nopencontext\u002F\n├── server\u002F             # Web server and API layer\n├── managers\u002F           # Business logic managers\n├── context_capture\u002F    # Context acquisition modules\n├── context_processing\u002F # Context processing pipeline\n├── context_consumption\u002F# Context consumption and generation\n├── storage\u002F            # Multi-backend storage layer\n├── llm\u002F               # LLM integration layer\n├── tools\u002F             # Tool system\n└── monitoring\u002F        # System monitoring\n```\n\n### Layer Responsibilities\n\n1. **Server Layer** (`server\u002F`)\n\n   - FastAPI-based RESTful API\n   - WebSocket support for real-time communication\n   - Static file serving and template rendering\n\n2. **Manager Layer** (`managers\u002F`)\n\n   - `CaptureManager`: Manages all context capture sources\n   - `ProcessorManager`: Coordinates context processing pipeline\n   - `ConsumptionManager`: Handles context consumption and generation\n   - `EventManager`: Event-driven system coordination\n\n3. **Context Capture Layer** (`context_capture\u002F`)\n\n   - Screenshot monitoring\n   - Document monitoring\n   - Extensible capture interface for future sources\n\n4. **Processing Layer** (`context_processing\u002F`)\n\n   - Document chunking strategies\n   - Entity extraction and normalization\n   - Context merging and deduplication\n   - Multi-modal content processing (text, images)\n\n5. **Storage Layer** (`storage\u002F`)\n\n   - Multi-backend support (SQLite, ChromaDB)\n   - Vector storage for similarity search\n   - Unified storage interface\n\n6. **LLM Integration** (`llm\u002F`)\n\n   - Support for multiple LLM providers (OpenAI, Doubao)\n   - VLM (Vision-Language Model) integration\n   - Embedding generation services\n\n## 🚀 Backend Usage\n\n### Installation\n\nWe recommend using [uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F) for fast and reliable package management:\n\n```bash\n# Clone repository\ngit clone https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext.git\ncd MineContext\n\n# Install uv (if not already installed)\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Sync dependencies (automatically creates virtual environment)\nuv sync\n```\n\n### Configuration\n\n1. **Basic Configuration** (`config\u002Fconfig.yaml`):\n\n```yaml\nserver:\n  host: 127.0.0.1\n  port: 8765\n  debug: false\n\nembedding_model:\n  provider: doubao # options: openai, doubao\n  api_key: your-api-key\n  model: doubao-embedding-vision-250615\n\nvlm_model:\n  provider: doubao # options: openai, doubao\n  api_key: your-api-key\n  model: doubao-seed-1-6-flash-250828\n\ncapture:\n  enabled: true\n  screenshot:\n    enabled: true # enable screenshot capture\n    capture_interval: 5 # capture interval in seconds\n```\n\n2. **Prompt Templates** (`config\u002Fprompts_*.yaml`):\n   - `prompts_en.yaml`: English prompt templates\n   - `prompts_zh.yaml`: Chinese prompt templates\n\n### Running the Server\n\n```bash\n# Start with default configuration\nuv run opencontext start\n\n# Start with custom config\nuv run opencontext start --config \u002Fpath\u002Fto\u002Fconfig.yaml\n\n# Start with custom port (useful for avoiding conflicts)\nuv run opencontext start --port 1733\n```\n\n**Available Options:**\n\n- `--config`: Path to configuration file\n- `--host`: Host address (default: from config or `localhost`)\n- `--port`: Port number (default: from config or `1733`)\n\n**Priority**: Command-line arguments > Config file > Default values\n\nAlternatively, you can activate the virtual environment manually:\n\n```bash\nsource .venv\u002Fbin\u002Factivate  # On Windows: .venv\\Scripts\\activate\npip install -e .\nopencontext start --port 1733\n```\n\n# 💎 The Philosophy Behind the Name\n\nThe naming of MineContext also reflects the team's ingenuity. It signifies both \"my context\" and \"mining context.\" It draws inspiration from the core philosophy of Minecraft—openness, creativity, and exploration.\n\nIf vast amounts of context are like scattered \"blocks,\" then MineContext provides a \"world\" where you can freely build, combine, and create. Users can reimagine and create new content based on the collected massive context and generate high-quality information.\n\n# 🎯 Target User\n\n| Target User Category | Specific Roles\u002FIdentities          | Core Needs\u002FPain Points                                                                                   |\n| -------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------- |\n| Knowledge Workers    | Researchers, Analysts              | Navigating vast amounts of information, improving information processing and analysis efficiency         |\n| Content Creators     | Writers, Bloggers                  | Craving endless inspiration, optimizing content creation workflows                                       |\n| Lifelong Learners    | Students, Researchers              | Building systematic knowledge systems, efficiently managing and connecting learning materials            |\n| Project Managers     | Product Managers, Project Managers | Integrating multi-source information and data, ensuring project alignment and decision-making efficiency |\n\n# 🔌 Context-Source\n\nWe will prioritize the expansion of Context Sources according to the following plan, and we warmly welcome everyone to actively contribute code to our efforts.\n\n- P0: Digital life and public information loop (PC screen capture and link upload)\n- P1: Personal text context loop (file upload, file tracking)\n- P2: AI and common office context loop (MCP, meeting notes)\n- P3: High-quality information acquisition loop (DeepResearch and RSS)\n- P4: Personal deep context loop (WeChat, QQ chat data acquisition, mobile screenshots)\n- P5: Physical world context loop (smart wearable synchronization, smart glasses synchronization)\n\n| Context Capture Capability   | Context Source                            | Priority | Completion Status |\n| :--------------------------- | :---------------------------------------- | :------- | :---------------- |\n| Screen Screenshot            | User PC Information                       | P0       | ✅                |\n| Note Editing                 | Application Internal Creation Information | P0       | ✅                |\n| Link Upload                  | Internet Information                      | P0       |                   |\n| File Upload                  | Structured Documents                      | P1       |                   |\n| File Upload                  | Unstructured Documents                    | P1       |                   |\n| File Upload                  | Images                                    | P1       |                   |\n| File Upload                  | Audio                                     | P4       |                   |\n| File Upload                  | Video                                     | P4       |                   |\n| File Upload                  | Code                                      | P4       |                   |\n| Browser Extension            | AI Conversation Records                   | P2       |                   |\n| Browser Extension            | Refined Internet Information              | P5       |                   |\n| Meeting Records              | Meeting Information                       | P2       |                   |\n| RSS                          | Consultation Information                  | P3       |                   |\n| Deep Research                | High-Quality Research Analysis            | P3       |                   |\n| Application MCP\u002FAPI          | Payment Records                           | P4       |                   |\n| Application MCP\u002FAPI          | Research Papers                           | P3       |                   |\n| Application MCP\u002FAPI          | News                                      | P4       |                   |\n| Application MCP\u002FAPI          | Emails                                    | P4       |                   |\n| Application MCP\u002FAPI          | Notion                                    | P2       |                   |\n| Application MCP\u002FAPI          | Obsidian                                  | P2       |                   |\n| Application MCP\u002FAPI          | Slack                                     | P4       |                   |\n| Application MCP\u002FAPI          | Jira                                      | P4       |                   |\n| Application MCP\u002FAPI          | Figma                                     | P2       |                   |\n| Application MCP\u002FAPI          | Linear                                    | P4       |                   |\n| Application MCP\u002FAPI          | Todoist                                   | P4       |                   |\n| Memory Bank Migration Import | User Memory                               | P4       |                   |\n| WeChat Data Capture          | WeChat Chat History                       | P4       |                   |\n| QQ Data Capture              | QQ Chat History                           | P4       |                   |\n| Mobile Screenshot Monitor    | User Mobile End Information               | P4       |                   |\n| Smart Glasses Data Sync      | Physical World Interaction Records        | P5       |                   |\n| Smart Bracelet Data Sync     | Physiological Data                        | P5       |                   |\n\n# 🆚 Comparison with Familiar Application\n\n## MineContext vs ChatGPT Pulse\n\n- 🖥️ Comprehensive Digital Context:\n  MineContext captures your entire digital workflow by reading from screen screenshots, providing a rich, visual context of your daily activities and applications. ChatGPT Pulse, in contrast, is limited to the context of a single text-based conversation.\n- 🔒 Local-First Data & Privacy:\n  Your data is processed and stored entirely on your local device, ensuring complete privacy and security without relying on cloud servers. ChatGPT Pulse requires data to be sent to and stored on OpenAI's servers.\n- 🚀 Proactive & Diverse Insights:\n  MineContext delivers a wider variety of intelligent, auto-generated content—including daily summaries, actionable todos, and activity reports—not just simple tips. ChatGPT Pulse primarily offers reactive assistance within the chat interface.\n- 🔧 Open Source & Customizable:\n  As an open-source project, MineContext allows developers to freely inspect, modify, and build upon the codebase for complete customization. ChatGPT Pulse is a closed, proprietary product with no option for modification.\n- 💰 Cost-Effective API Usage:\n  MineContext avoids the need for a costly $200\u002Fmonth Pro subscription by allowing you to use your own API key, giving you full control over your spending. ChatGPT Pulse's advanced features are locked behind its expensive premium tier.\n\n## MineContext vs Dayflow\n\n- 💡 Richer, Proactive Insights:\n  MineContext delivers a more diverse range of automated, intelligent content—including concise summaries, actionable todos, and contextual tips—going beyond basic activity tracking. DayFlow primarily focuses on logging user activity.\n- 🧠 Context-Aware Q&A & Creation:\n  MineContext enables you to ask questions and generate new content based on your captured context, unlocking wider application scenarios like content drafting and project planning. DayFlow is limited to passive activity recording and review.\n- ✨ Superior Activity Generation & Experience:\n  MineContext produces activity records with greater clarity and detail, featuring a more intuitive and interactive dashboard for a seamless user experience. DayFlow's activity logs are more basic with limited interactivity.\n\n\u003Cbr>\n\n# 👥 Community\n\n## Community and Support\n\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues): Errors and issues encountered while using MineContext.\n- [Email Support](mailto:minecontext@bytedance.com): Feedback and questions about using MineContext.\n- \u003Ca href=\"https:\u002F\u002Fbytedance.larkoffice.com\u002Fwiki\u002FHg6VwrxnTiXtWUkgHexcFTqrnpg\">WeChat Group\u003C\u002Fa>: Discuss SwanLab usage and share the latest AI technologies.\n\n# Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_53117d0ab594.png)](https:\u002F\u002Fwww.star-history.com\u002F#volcengine\u002FMineContext&Timeline)\n\n# 📃 License\n\nThis repository is licensed under the Apache 2.0 License.\n\n\u003C!-- link -->\n\n[release-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fvolcengine\u002FMineContext?color=369eff&labelColor=black&logo=github&style=flat-square\n[release-link]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases\n[license-shield]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-apache%202.0-white?labelColor=black&style=flat-square\n[license-shield-link]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fblob\u002Fmain\u002FLICENSE\n[last-commit-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fvolcengine\u002FMineContext?color=c4f042&labelColor=black&style=flat-square\n[last-commit-shield-link]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommits\u002Fmain\n[wechat-shield]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWeChat-微信-4cb55e?labelColor=black&style=flat-square\n[wechat-shield-link]: https:\u002F\u002Fbytedance.larkoffice.com\u002Fwiki\u002FHg6VwrxnTiXtWUkgHexcFTqrnpg\n[github-stars-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fvolcengine\u002FMineContext?labelColor&style=flat-square&color=ffcb47\n[github-stars-link]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\n[github-issues-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fvolcengine\u002FMineContext?labelColor=black&style=flat-square&color=ff80eb\n[github-issues-shield-link]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\n[github-contributors-shield]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fvolcengine\u002FMineContext?color=c4f042&labelColor=black&style=flat-square\n[github-contributors-link]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fgraphs\u002Fcontributors\n","\u003Cdiv align=\"center\">\n\n\u003Cpicture>\n  \u003Cimg alt=\"MineContext\" src=\"src\u002FMineContext-Banner.svg\" width=\"100%\" height=\"auto\">\n\u003C\u002Fpicture>\n\n### MineContext：在情境中创作，从混沌中提炼清晰\n\n一款开源、主动的情境感知型AI伙伴，致力于为您的工作、学习和创作带来清晰与高效。\n\n[中文](README_zh.md) \u002F 英文\n\n\u003Ca href=\"https:\u002F\u002Fbytedance.larkoffice.com\u002Fwiki\u002FHn6ewRnAwiSro7kkH6Sc1DMFnng\">社区最佳实践\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\">报告问题\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fbytedance.larkoffice.com\u002Fshare\u002Fbase\u002Fform\u002FshrcnPAjJtlufuhBZGegll41NOh\">意见反馈\u003C\u002Fa>\n\n[![][release-shield]][release-link]\n[![][github-stars-shield]][github-stars-link]\n[![][github-issues-shield]][github-issues-shield-link]\n[![][github-contributors-shield]][github-contributors-link]\n[![][license-shield]][license-shield-link]  \n[![][last-commit-shield]][last-commit-shield-link]\n[![][wechat-shield]][wechat-shield-link]\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F15157\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_0b0cf02be0f5.png\" alt=\"volcengine%2FMineContext | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n👋 加入我们的[微信\u002F飞书\u002F红笔记群](https:\u002F\u002Fbytedance.larkoffice.com\u002Fwiki\u002FHg6VwrxnTiXtWUkgHexcFTqrnpg)\n\n🌍 加入我们的[Discord群](https:\u002F\u002Fdiscord.gg\u002FtGj7RQ3nUR)\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases\u002Fdownload\u002Fv0.1.8\u002FMineContext-0.1.8.dmg\">🖥️ 下载适用于Mac的版本\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases\u002Fdownload\u002Fv0.1.8\u002FMineContext-0.1.8-setup.exe\">💻 下载适用于Windows的版本\u003C\u002Fa>\n\n\u003C\u002Fdiv>\n\n目录\n\n- [👋🏻 什么是MineContext](#-what-is-minecontext)\n- [🚀 核心功能](#-key-features)\n- [🔏 隐私保护](#-privacy-protection)\n  - [本地优先](#local-first)\n  - [本地AI模型](#local-ai-model)\n- [🏁 快速入门](#-quick-start)\n  - [1. 安装](#1-installation)\n  - [2. 输入API密钥](#2-enter-your-api-key)\n  - [3. 开始记录](#3-start-recording)\n  - [4. 放下它](#4-forget-it)\n  - [5. 后端调试](#5-backend-debugging)\n- [🎃 贡献指南](#-contribution-guide)\n  - [🎨 前端架构](#-frontend-architecture)\n    - [核心技术栈](#core-tech-stack)\n    - [核心架构](#core-architecture)\n  - [💻 前端使用](#-frontend-usage)\n    - [构建后端](#build-backend)\n    - [安装依赖](#install-dependencies)\n    - [开发与调试](#development-and-debugging)\n    - [应用打包](#application-packaging)\n  - [🏗️ 后端架构](#️-backend-architecture)\n    - [核心架构组件](#core-architecture-components)\n    - [各层职责](#layer-responsibilities)\n  - [🚀 后端使用](#-backend-usage)\n    - [安装](#installation)\n    - [配置](#configuration)\n    - [运行服务器](#running-the-server)\n- [💎 名字背后的哲学](#-the-philosophy-behind-the-name)\n- [🎯 目标用户](#-target-user)\n- [🔌 情境来源](#-context-source)\n- [🆚 与熟悉应用的对比](#-comparison-with-familiar-application)\n  - [MineContext vs ChatGPT Pulse](#minecontext-vs-chatgpt-pulse)\n  - [MineContext vs Dayflow](#minecontext-vs-dayflow)\n- [👥 社区](#-community)\n  - [社区与支持](#community-and-support)\n- [Star历史](#star-history)\n- [📃 许可证](#-license)\n\n\u003Cbr>\n\n> **🔗 相关项目**: 请查看**[OpenViking](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FOpenViking)** - 一个专为AI智能体设计的开源情境数据库。OpenViking通过“文件系统范式”统一了记忆、资源和技能，为复杂的情境管理提供了基础设施层。\n\n\u003Cbr>\n\n# 👋🏻 什么是MineContext\n\nMineContext是一款主动的情境感知型AI伙伴。它利用屏幕截图和内容理解能力（未来还将支持多源多模态信息，包括文档、图片、视频、代码以及外部应用数据），能够洞察并理解用户的数字世界情境。基于底层的情境工程框架，它会主动提供高质量的信息，如洞察、每日\u002F每周摘要、待办事项清单和活动记录等。\n\n![feature.gif](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_c446b86d333f.gif)\n\n# 🚀 核心功能\n\nMineContext专注于四大核心功能：轻松收集、智能浮现、主动推送以及情境工程架构。\n\n1. 📥 轻松收集\n   能够收集并处理海量情境数据。其精心设计的存储管理方式，使您可以在不增加心理负担的情况下进行广泛的数据采集。\n2. 🚀 主动推送\n   在日常使用中主动推送关键信息和洞察。它会从您的情境中提取摘要内容——例如每日\u002F每周总结、小贴士和待办事项——并直接推送到您的主页。\n3. 💡 智能浮现\n   在创作过程中智能地呈现相关且有用的情境信息。确保在辅助创作的同时不会让您感到信息过载。\n4. 🎯 情境工程架构\n   支持多模态、多源数据的完整生命周期——从捕获、处理、存储到管理、检索和消费——从而生成六种类型的情境智能信息。\n\n# 🔏 隐私保护\n\n## 本地优先\n\nMineContext高度重视用户隐私。默认情况下，所有数据都存储在本地以下路径，以确保您的隐私和安全。\n\n```\n~\u002FLibrary\u002FApplication Support\u002FMineContext\u002FData\n```\n\n## 本地AI模型\n\n此外，我们还支持基于OpenAI API协议的自定义模型服务。您可以在MineContext中使用完全本地化的模型，确保任何数据都不会离开您的本地环境。\n\n# 🏁 快速入门\n\n## 1. 安装\n\n点击[GitHub最新发布](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases)进行下载\n\n![下载APP](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_bd7fba4daf45.gif)\n\n> **注意**: 自v0.1.5版本起，MineContext已支持Apple公证，因此您无需再禁用隔离属性。如果您使用的是旧版本，请参考[之前的文档](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fblob\u002F0.1.4\u002FREADME.md)获取说明。\n\n## 2. 输入您的 API 密钥\n\n应用启动后，请按照提示输入您的 API 密钥。（注意：首次运行时，应用需要安装后台环境，这可能需要大约两分钟）。\n\n我们目前支持豆包、OpenAI 以及自定义模型的服务。这包括任何与 OpenAI API 格式兼容的 **本地模型** 或 **第三方模型** 服务。\n\n我们推荐使用 [LMStudio](https:\u002F\u002Flmstudio.ai\u002F) 来运行本地模型。它提供了一个简洁的界面和强大的功能，可以帮助您快速部署和管理这些模型。\n\n**综合考虑成本和性能，我们建议使用豆包模型。** 豆包 API 密钥可以在 [API 管理界面](https:\u002F\u002Fconsole.volcengine.com\u002Fark\u002Fregion:ark+cn-beijing\u002FapiKey) 中生成。\n\n获取豆包 API 密钥后，您还需要在 [模型激活管理界面](https:\u002F\u002Fconsole.volcengine.com\u002Fark\u002Fregion:ark+cn-beijing\u002Fmodel) 中激活两种模型：视觉语言模型和嵌入模型。\n\n- 视觉语言模型：Doubao-Seed-1.6-flash\n  ![doubao-vlm-model](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_6fcb961d376d.png)\n\n- 嵌入模型：Doubao-embedding-vision\n  ![doubao-emb-model](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_d0188a1e3693.png)\n\n以下是获取 API 密钥后的填写流程：\n\n![输入 API 密钥](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_7ec5e538fcbd.gif)\n\n## 3. 开始录制\n\n进入 [屏幕监控] 以启用系统对屏幕共享的权限。完成设置后，您需要重启应用才能使更改生效。\n![启用权限](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_bef30f434a61.gif)\n\n重启应用后，请先在 [设置] 中设定您的屏幕共享区域，然后点击 [开始录制] 以开始截取屏幕截图。\n![屏幕设置](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_3f2cf9f4e80e.gif)\n\n## 4. 放下心来\n\n开始录制后，您的上下文信息将逐渐被收集。生成有价值的内容需要一些时间。因此，请放下心来，安心处理其他任务。MineContext 会在后台为您生成待办事项、提示、摘要和活动。当然，您也可以通过 [与 AI 聊天] 进行主动问答。\n\n## 5. 后台调试\n\nMineContext 支持后台调试，可通过 `http:\u002F\u002Flocalhost:1733` 访问。\n\n1. 查看 Token 消耗与使用情况\n![后台调试1](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_4bedf156972c.png)\n\n2. 配置自动化任务的间隔时间\n![后台调试2](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_31fc236a8541.png)\n\n3. 调整自动化任务的系统提示词\n![后台调试3](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_1ccebc3176b3.png)\n\n# 🎃 贡献指南\n\n## 🎨 前端架构\n\nMineContext 的前端是一个基于 Electron、React 和 TypeScript 构建的跨平台桌面应用，为桌面开发提供了模块化、可维护且高性能的基础。\n\n### 核心技术栈\n\n| 技术         | 描述                                                                               |\n| ------------ | ----------------------------------------------------------------------------------------- |\n| Electron     | 允许使用 Web 技术开发跨平台桌面应用程序。                                         |\n| React        | 一个用于构建动态用户界面的组件化 UI 库。                                        |\n| TypeScript   | 提供静态类型检查，以增强代码的可维护性。                                            |\n| Vite         | 一个针对 Electron 优化的现代前端构建工具。                                          |\n| Tailwind CSS | 一种实用优先的 CSS 框架，用于快速且一致地进行 UI 样式设计。                        |\n| pnpm         | 一个适用于 monorepo 项目的快速高效包管理器。                                      |\n\n### 核心架构\n\n该项目遵循标准的 Electron 架构设计，清晰地分离了主进程、预加载脚本和渲染进程的代码，以确保安全性和可维护性。\n\n```\nfrontend\u002F\n├── src\u002F\n│ ├── main\u002F     # Electron 主进程（窗口管理、生命周期、IPC）\n│ ├── preload\u002F  # 预加载脚本，安全地桥接 Node.js API 和渲染进程\n│ └── renderer\u002F # React 前端界面（渲染进程）\n│\n├── packages\u002F\n│ └── shared\u002F   # 公共工具、IPC 通道、日志记录和常量定义\n│\n├── build\u002F      # 构建资源（图标、平台配置）\n├── dist\u002F       # electron-builder 生成的构建产物\n├── externals\u002F  # 外部依赖（Python 脚本、二进制文件等）\n├── resources\u002F  # 静态资源（图标、模板、图片）\n└── scripts\u002F    # 开发和构建辅助脚本\n```\n\n1.  **主进程 (`src\u002Fmain\u002F`) 负责：**\n\n    - 管理应用程序窗口\n    - 处理生命周期事件（启动、退出、激活）\n    - 建立安全的 IPC 通信\n    - 与后台服务（Python 和系统 API）集成\n\n2.  **预加载脚本 (`src\u002Fpreload\u002F`) 负责：**\n\n    - 安全地向渲染进程暴露 Node.js API\n    - 处理与主进程之间的 IPC 通信\n    - 实现跨进程的资源访问\n\n3.  **渲染进程 (`src\u002Frenderer\u002F`) 负责：**\n\n    - 使用 React 实现用户界面\n    - 使用 Jotai 和 Redux 管理全局状态\n    - 利用基于 Tailwind CSS 的高效样式系统\n    - 实现动态加载和性能优化机制\n\n4.  **构建与打包负责：**\n\n    - `electron-vite.config.ts` — 配置主进程和渲染进程的构建逻辑（别名、插件等）。\n    - `electron-builder.yml` — 定义 Windows、macOS 和 Linux 平台的打包与分发配置。\n\n## 💻 前端使用\n\n### 构建后台\n\n在开始前端开发之前，您需要先构建后台：\n\n```bash\nuv sync\nsource .venv\u002Fbin\u002Factivate\n.\u002Fbuild.sh\n```\n\n### 安装依赖\n\n由于包版本问题，目前不支持使用国内 PyPI 镜像。请运行以下命令以确保使用原始的 PyPI 源：\n\n```bash\npip config unset global.index-url\ncd frontend\npnpm install\n```\n\n### 开发与调试\n\n在本地开发过程中，屏幕捕获区域的选择可能会比较慢，这是正常现象。请耐心等待，因为打包后的应用中不会出现此问题。\n\n```bash\npnpm dev\n```\n\n### 应用打包\n\n要构建 macOS 版本的应用程序：\n\n```bash\npnpm build:mac\n# 数据路径\n# ～\u002FLibrary\u002FApplication\\ Support\u002FMineContext\n```\n\n打包过程生成的可执行文件将存储在 `MineContext\u002Ffrontend\u002Fdist` 目录中。\n\n## 🏗️ 后台架构\n\nMineContext 采用了模块化、分层的架构设计，各组件职责分明，界限清晰。\n\n### 核心架构组件\n\n```\nopencontext\u002F\n├── server\u002F             # Web 服务器和 API 层\n├── managers\u002F           # 业务逻辑管理器\n├── context_capture\u002F    # 上下文采集模块\n├── context_processing\u002F # 上下文处理流水线\n├── context_consumption\u002F# 上下文消费与生成\n├── storage\u002F            # 多后端存储层\n├── llm\u002F               # LLM 集成层\n├── tools\u002F             # 工具系统\n└── monitoring\u002F        # 系统监控\n```\n\n### 各层职责\n\n1. **服务器层** (`server\u002F`)\n\n   - 基于 FastAPI 的 RESTful API\n   - 支持 WebSocket 实时通信\n   - 静态文件服务与模板渲染\n\n2. **管理器层** (`managers\u002F`)\n\n   - `CaptureManager`: 管理所有上下文采集源\n   - `ProcessorManager`: 协调上下文处理流水线\n   - `ConsumptionManager`: 处理上下文的消费与生成\n   - `EventManager`: 事件驱动的系统协调\n\n3. **上下文采集层** (`context_capture\u002F`)\n\n   - 截图监控\n   - 文档监控\n   - 可扩展的采集接口，便于未来新增数据源\n\n4. **处理层** (`context_processing\u002F`)\n\n   - 文档分块策略\n   - 实体提取与归一化\n   - 上下文合并与去重\n   - 多模态内容处理（文本、图像）\n\n5. **存储层** (`storage\u002F`)\n\n   - 多后端支持（SQLite、ChromaDB）\n   - 向量存储用于相似性搜索\n   - 统一的存储接口\n\n6. **LLM 集成层** (`llm\u002F`)\n\n   - 支持多家 LLM 提供商（OpenAI、Doubao）\n   - VLM（视觉-语言模型）集成\n   - 嵌入向量生成服务\n\n## 🚀 后端使用\n\n### 安装\n\n我们推荐使用 [uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F) 进行快速可靠的包管理：\n\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext.git\ncd MineContext\n\n# 安装 uv（如果尚未安装）\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# 同步依赖项（自动创建虚拟环境）\nuv sync\n```\n\n### 配置\n\n1. **基础配置** (`config\u002Fconfig.yaml`)：\n\n```yaml\nserver:\n  host: 127.0.0.1\n  port: 8765\n  debug: false\n\nembedding_model:\n  provider: doubao # 选项：openai, doubao\n  api_key: your-api-key\n  model: doubao-embedding-vision-250615\n\nvlm_model:\n  provider: doubao # 选项：openai, doubao\n  api_key: your-api-key\n  model: doubao-seed-1-6-flash-250828\n\ncapture:\n  enabled: true\n  screenshot:\n    enabled: true # 启用截图采集\n    capture_interval: 5 # 采集间隔，单位为秒\n```\n\n2. **提示模板** (`config\u002Fprompts_*.yaml`)：\n   - `prompts_en.yaml`: 英文提示模板\n   - `prompts_zh.yaml`: 中文提示模板\n\n### 启动服务器\n\n```bash\n# 使用默认配置启动\nuv run opencontext start\n\n# 使用自定义配置启动\nuv run opencontext start --config \u002Fpath\u002Fto\u002Fconfig.yaml\n\n# 使用自定义端口启动（避免端口冲突）\nuv run opencontext start --port 1733\n```\n\n**可用选项：**\n\n- `--config`: 配置文件路径\n- `--host`: 主机地址（默认从配置文件或 `localhost` 获取）\n- `--port`: 端口号（默认从配置文件或 `1733` 获取）\n\n**优先级顺序**：命令行参数 > 配置文件 > 默认值\n\n或者，您也可以手动激活虚拟环境：\n\n```bash\nsource .venv\u002Fbin\u002Factivate  # Windows 系统：.venv\\Scripts\\activate\npip install -e .\nopencontext start --port 1733\n```\n\n# 💎 名称背后的哲学\n\nMineContext 这个名字也体现了团队的巧思。它既代表“我的上下文”，又寓意“挖掘上下文”。这一命名灵感源自《我的世界》的核心理念——开放、创造与探索。\n\n如果将海量上下文比作散落的“方块”，那么 MineContext 就提供了一个可以自由搭建、组合与创造的“世界”。用户可以根据收集到的大量上下文重新构想并创作新内容，从而生成高质量的信息。\n\n# 🎯 目标用户\n\n| 目标用户类别       | 具体角色\u002F身份          | 核心需求\u002F痛点                                                                                   |\n| -------------------- | ---------------------- | -------------------------------------------------------------------------------------------------------- |\n| 知识工作者         | 研究人员、分析师       | 需要应对海量信息，提升信息处理与分析效率                                                         |\n| 内容创作者         | 作家、博主             | 渴望源源不断的灵感，优化内容创作流程                                                           |\n| 终身学习者         | 学生、研究人员         | 构建系统化的知识体系，高效管理和连接学习资料                                                   |\n| 项目管理者         | 产品经理、项目经理     | 整合多源信息与数据，确保项目对齐及决策效率                                                     |\n\n# 🔌 上下文来源\n\n我们将按照以下计划优先推进上下文来源的扩展，并热烈欢迎各位积极参与代码贡献。\n\n- P0：数字生活与公共信息闭环（PC屏幕截图及链接上传）\n- P1：个人文本上下文闭环（文件上传、文件跟踪）\n- P2：AI与常用办公场景上下文闭环（MCP、会议记录）\n- P3：高质量信息获取闭环（DeepResearch与RSS）\n- P4：个人深度上下文闭环（微信、QQ聊天数据采集，手机截图）\n- P5：物理世界上下文闭环（智能穿戴设备同步、智能眼镜同步）\n\n| 上下文捕获能力   | 上下文来源                            | 优先级 | 完成状态 |\n| :--------------------------- | :---------------------------------------- | :------- | :---------------- |\n| 屏幕截图            | 用户PC端信息                       | P0       | ✅                |\n| 笔记编辑                 | 应用内创建信息                      | P0       | ✅                |\n| 链接上传                  | 网络信息                            | P0       |                   |\n| 文件上传                  | 结构化文档                          | P1       |                   |\n| 文件上传                  | 非结构化文档                        | P1       |                   |\n| 文件上传                  | 图片                                | P1       |                   |\n| 文件上传                  | 音频                                | P4       |                   |\n| 文件上传                  | 视频                                | P4       |                   |\n| 文件上传                  | 代码                                | P4       |                   |\n| 浏览器扩展            | AI对话记录                          | P2       |                   |\n| 浏览器扩展            | 精炼网络信息                        | P5       |                   |\n| 会议记录              | 会议信息                            | P2       |                   |\n| RSS                   | 咨询信息                            | P3       |                   |\n| Deep Research         | 高质量研究分析                      | P3       |                   |\n| 应用MCP\u002FAPI           | 支付记录                            | P4       |                   |\n| 应用MCP\u002FAPI           | 研究论文                            | P3       |                   |\n| 应用MCP\u002FAPI           | 新闻                                | P4       |                   |\n| 应用MCP\u002FAPI           | 邮件                                | P4       |                   |\n| 应用MCP\u002FAPI           | Notion                              | P2       |                   |\n| 应用MCP\u002FAPI           | Obsidian                            | P2       |                   |\n| 应用MCP\u002FAPI           | Slack                               | P4       |                   |\n| 应用MCP\u002FAPI           | Jira                                | P4       |                   |\n| 应用MCP\u002FAPI           | Figma                               | P2       |                   |\n| 应用MCP\u002FAPI           | Linear                              | P4       |                   |\n| 应用MCP\u002FAPI           | Todoist                             | P4       |                   |\n| 记忆库迁移导入        | 用户记忆库                          | P4       |                   |\n| 微信数据采集          | 微信聊天记录                        | P4       |                   |\n| QQ数据采集            | QQ聊天记录                          | P4       |                   |\n| 手机截图监控          | 用户移动端信息                      | P4       |                   |\n| 智能眼镜数据同步      | 物理世界交互记录                    | P5       |                   |\n| 智能手环数据同步      | 生理数据                            | P5       |                   |\n\n# 🆚 与熟悉应用的对比\n\n## MineContext vs ChatGPT Pulse\n\n- 🖥️ 全面的数字上下文：\n  MineContext通过读取屏幕截图捕捉您的整个数字工作流，提供丰富、可视化的日常活动和应用上下文。而ChatGPT Pulse则仅限于单个基于文本的对话上下文。\n- 🔒 本地优先的数据与隐私：\n  您的数据完全在本地设备上处理和存储，确保完全的隐私和安全性，无需依赖云端服务器。而ChatGPT Pulse需要将数据发送到并存储在OpenAI的服务器上。\n- 🚀 主动且多样的洞察：\n  MineContext能够生成更广泛类型的智能自动生成内容——包括每日摘要、可执行待办事项和活动报告——而不仅仅是简单的提示。ChatGPT Pulse主要在聊天界面中提供被动式的辅助。\n- 🔧 开源与可定制性：\n  作为开源项目，MineContext允许开发者自由查看、修改和基于代码库进行构建，实现完全的定制化。而ChatGPT Pulse是一个封闭的专有产品，无法进行修改。\n- 💰 成本效益高的API使用：\n  MineContext无需订阅每月200美元的Pro版，您可以使用自己的API密钥，从而完全掌控支出。而ChatGPT Pulse的高级功能则被锁定在其昂贵的高级订阅层级中。\n\n## MineContext vs Dayflow\n\n- 💡 更丰富、主动的洞察：\n  MineContext能够提供更加多样化的自动化智能内容——包括简洁的摘要、可执行的待办事项和情境提示——超越了基础的活动追踪。DayFlow则主要专注于用户活动的记录。\n- 🧠 上下文感知的问答与创作：\n  MineContext使您能够基于捕获的上下文提问并生成新内容，解锁更广泛的应用场景，如内容起草和项目规划。而DayFlow仅限于被动的活动记录与回顾。\n- ✨ 更优的活动生成与体验：\n  MineContext生成的活动记录更加清晰、详细，配备更直观、交互式的仪表盘，带来流畅的用户体验。DayFlow的活动日志则较为基础，交互性有限。\n\n\u003Cbr>\n\n# 👥 社区\n\n## 社区与支持\n\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues)：使用MineContext时遇到的错误与问题。\n- [邮件支持](mailto:minecontext@bytedance.com)：关于使用MineContext的反馈与疑问。\n- \u003Ca href=\"https:\u002F\u002Fbytedance.larkoffice.com\u002Fwiki\u002FHg6VwrxnTiXtWUkgHexcFTqrnpg\">微信群\u003C\u002Fa>：讨论SwanLab的使用并分享最新的AI技术。\n\n# 星级历史\n\n[![星级历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_readme_53117d0ab594.png)](https:\u002F\u002Fwww.star-history.com\u002F#volcengine\u002FMineContext&Timeline)\n\n# 📃 许可证\n\n本仓库采用 Apache 2.0 许可证授权。\n\n\u003C!-- 链接 -->\n\n[发布版本盾牌]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fvolcengine\u002FMineContext?color=369eff&labelColor=black&logo=github&style=flat-square\n[发布版本链接]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases\n[许可证盾牌]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-apache%202.0-white?labelColor=black&style=flat-square\n[许可证盾牌链接]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fblob\u002Fmain\u002FLICENSE\n[最近提交盾牌]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fvolcengine\u002FMineContext?color=c4f042&labelColor=black&style=flat-square\n[最近提交盾牌链接]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommits\u002Fmain\n[微信盾牌]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWeChat-微信-4cb55e?labelColor=black&style=flat-square\n[微信盾牌链接]: https:\u002F\u002Fbytedance.larkoffice.com\u002Fwiki\u002FHg6VwrxnTiXtWUkgHexcFTqrnpg\n[GitHub 星标盾牌]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fvolcengine\u002FMineContext?labelColor&style=flat-square&color=ffcb47\n[GitHub 星标链接]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\n[GitHub 问题盾牌]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fvolcengine\u002FMineContext?labelColor=black&style=flat-square&color=ff80eb\n[GitHub 问题盾牌链接]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\n[GitHub 贡献者盾牌]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fvolcengine\u002FMineContext?color=c4f042&labelColor=black&style=flat-square\n[GitHub 贡献者链接]: https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fgraphs\u002Fcontributors","# MineContext 快速上手指南\n\nMineContext 是一款开源的、主动感知上下文的 AI 伙伴，旨在通过截图和内容理解，为您的工作、学习和创作带来清晰与高效。它支持本地优先架构，保障数据隐私。\n\n## 环境准备\n\n### 系统要求\n- **操作系统**：macOS 或 Windows\n  - macOS 用户注意：v0.1.5+ 版本已支持 Apple 公证，无需手动移除隔离属性。\n- **硬件建议**：建议具备独立显卡以加速本地模型推理（若使用本地模型）。\n\n### 前置依赖\n- **API Key**：需准备兼容 OpenAI 协议的服务密钥。\n  - **推荐方案**：使用火山引擎「豆包」模型（性价比高）。\n    - 需激活两个模型：视觉语言模型 (`Doubao-Seed-1.6-flash`) 和 嵌入模型 (`Doubao-embedding-vision`)。\n    - 获取地址：[火山引擎控制台](https:\u002F\u002Fconsole.volcengine.com\u002Fark\u002Fregion:ark+cn-beijing\u002FapiKey)\n  - **本地模型方案**：推荐使用 [LMStudio](https:\u002F\u002Flmstudio.ai\u002F) 部署本地模型，确保数据完全不出本地。\n- **屏幕录制权限**：首次运行需授权系统屏幕共享权限。\n\n## 安装步骤\n\n### 1. 下载客户端\n访问 GitHub Release 页面下载对应系统的安装包：\n- **Mac**: [Download .dmg](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases\u002Fdownload\u002Fv0.1.8\u002FMineContext-0.1.8.dmg)\n- **Windows**: [Download .exe](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Freleases\u002Fdownload\u002Fv0.1.8\u002FMineContext-0.1.8-setup.exe)\n\n### 2. 安装与初始化\n- 运行下载的安装包完成安装。\n- 启动应用。**注意**：首次运行时，应用会自动安装后端环境，过程约需 2 分钟，请耐心等待。\n\n### 3. 配置 API Key\n在应用启动后的引导界面中输入您的 API Key：\n- 若使用豆包模型，填入从火山引擎控制台获取的 Key。\n- 若使用本地模型，填入 LMStudio 提供的本地服务地址和 Key。\n\n## 基本使用\n\n### 第一步：开启屏幕监控\n1. 进入应用内的 **[Screen Monitor]** 模块。\n2. 根据系统提示开启**屏幕共享\u002F录制权限**。\n3. **重要**：授权完成后，必须**重启应用**以使权限生效。\n\n### 第二步：设置录制区域\n1. 重启应用后，进入 **[Settings]** (设置)。\n2. 选择您需要监控的屏幕区域或显示器。\n3. 点击 **[Start Recording]** 开始采集上下文信息。\n\n### 第三步：自动智能生成\n启动录制后，无需额外操作。MineContext 将在后台自动：\n- 采集屏幕上下文。\n- 生成待办事项 (To-dos)、每日\u002F每周总结、灵感提示及活动记录。\n- 您可直接在主页查看推送的智能信息，或通过 **[Chat with AI]** 进行主动问答。\n\n> **提示**：上下文价值的生成需要一定时间的积累，建议保持后台运行，专注于您的核心任务即可。\n\n### （可选）后端调试\n如需查看 Token 消耗或调整自动化任务参数，可访问本地调试页面：\n`http:\u002F\u002Flocalhost:1733`","资深全栈工程师李明正在紧急排查一个跨微服务的复杂 Bug，他需要在本地代码库、浏览器控制台日志、API 文档和即时通讯软件的讨论记录之间频繁切换以定位问题根源。\n\n### 没有 MineContext 时\n- **上下文割裂严重**：李明必须手动复制粘贴代码片段、错误日志和聊天记录到 AI 对话框中，每次提问都要重新构建背景信息，效率极低。\n- **关键细节遗漏**：在匆忙中，他往往忘记提供相关的数据库 schema 或最新的接口变更说明，导致 AI 给出的建议基于过时信息，甚至产生误导。\n- **思维流被打断**：频繁的“截图 - 打字 - 描述”操作强行打断了他的调试思路，原本连贯的逻辑推导被琐碎的准备工作切割得支离破碎。\n- **多模态信息处理困难**：面对屏幕上的架构图或复杂的堆栈跟踪截图，他需要花费大量时间用文字向 AI 解释图片内容，沟通成本高昂。\n\n### 使用 MineContext 后\n- **主动感知上下文**：MineContext 自动捕获李明当前的屏幕内容（包括代码编辑器、浏览器标签和聊天窗口），无需手动投喂，AI 即刻理解完整的故障现场。\n- **精准关联多维信息**：它能同时分析代码逻辑、实时日志报错以及团队刚才在通讯软件中确认的“热修复”方案，确保生成的诊断建议准确且符合最新现状。\n- **无感交互保持心流**：李明只需专注于代码逻辑，遇到卡点时直接唤醒 MineContext 提问，工具自动调取后台已记录的上下文，让调试过程如行云流水般顺畅。\n- **原生多模态理解**：对于屏幕上的架构图或报错截图，MineContext 直接进行视觉解析并结合文本内容综合推理，瞬间指出潜在的内存泄漏点或配置冲突。\n\nMineContext 通过将碎片化的工作流转化为连续的上下文感知体验，让开发者从繁琐的信息搬运中解放出来，真正实现与 AI 的无缝协同创作。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvolcengine_MineContext_c446b86d.gif","volcengine","Volcengine","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fvolcengine_1272086c.jpg","",null,"https:\u002F\u002Fwww.volcengine.cn\u002F","https:\u002F\u002Fgithub.com\u002Fvolcengine",[81,85,89,93,97,101,105,109,113],{"name":82,"color":83,"percentage":84},"Python","#3572A5",43.2,{"name":86,"color":87,"percentage":88},"TypeScript","#3178c6",29.9,{"name":90,"color":91,"percentage":92},"Less","#1d365d",10.9,{"name":94,"color":95,"percentage":96},"JavaScript","#f1e05a",6.7,{"name":98,"color":99,"percentage":100},"HTML","#e34c26",6.4,{"name":102,"color":103,"percentage":104},"CSS","#663399",2.1,{"name":106,"color":107,"percentage":108},"Shell","#89e051",0.5,{"name":110,"color":111,"percentage":112},"Batchfile","#C1F12E",0.1,{"name":114,"color":77,"percentage":112},"NSIS",5250,387,"2026-04-17T15:18:27","Apache-2.0","macOS, Windows","未说明（支持本地模型，具体需求取决于用户自行部署的模型，如通过 LMStudio 运行）","未说明",{"notes":123,"python":124,"dependencies":125},"1. 首次运行应用时需安装后端环境，耗时约两分钟。2. 支持接入兼容 OpenAI API 格式的本地模型（推荐使用 LMStudio 部署）或第三方模型（如豆包 Doubao）。3. macOS 用户从 v0.1.5 起无需手动关闭隔离属性（已支持苹果公证）。4. 使用前需在系统设置中授予屏幕录制权限并重启应用。5. 数据默认本地存储，路径为 ~\u002FLibrary\u002FApplication Support\u002FMineContext\u002FData (Mac) 或对应 Windows 路径。","未说明（后端使用 Python，通过 uv 管理环境）",[126,127,86,128,129,130],"Electron","React","Vite","Tailwind CSS","uv (Python 包管理器)",[16,13,14,35],[133,134,135,136,137,138,139,140,141,142,143,144,145,146],"agent","context-engineering","electron","embedding-models","memory","proactive-ai","python","python3","rag","react","vector-database","vision-language-model","javascript","typescript","2026-03-27T02:49:30.150509","2026-04-18T09:19:35.163969",[150,155,160,165,170,175,180],{"id":151,"question_zh":152,"answer_zh":153,"source_url":154},39265,"如何在 Windows 上安装和使用该软件？","Windows 版本已在 Release 页面发布支持。用户可以直接前往 GitHub 项目的 Release 页面下载 Windows 安装包进行安装。注意早期 Windows 版本可能缺失部分窗口追踪功能，仅支持全屏录制，建议使用最新版本。","https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\u002F41",{"id":156,"question_zh":157,"answer_zh":158,"source_url":159},39260,"Windows 版本点击关闭按钮 [x] 会直接退出程序，如何最小化到系统托盘？","该功能已在最新版本中支持。请更新应用程序，现在点击右上角的 [x] 会将软件最小化至系统托盘并在后台运行，而不是直接退出。","https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\u002F114",{"id":161,"question_zh":162,"answer_zh":163,"source_url":164},39261,"配置自定义源（如硅基流动）时遇到连接超时或模型无响应报错怎么办？","如果是硅基流动平台的某些模型出现 'Empty LLM response' 错误，建议尝试更换模型（例如千问模型在百炼平台通常正常）。此外，请升级到最新版本，并在设置界面 (http:\u002F\u002F127.0.0.1:1733\u002Fsettings) 将相关并发或重试参数调整为 1 进行测试。","https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\u002F148",{"id":166,"question_zh":167,"answer_zh":168,"source_url":169},39262,"启动时提示默认 Embedding 模型（doubao-embedding-large-text-240915）不存在或已下线如何解决？","该默认模型可能已下线或不兼容。请下载并安装最新版本的软件，开发团队已在更新中修改了默认的 Embedding 模型配置以解决此问题。","https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\u002F324",{"id":171,"question_zh":172,"answer_zh":173,"source_url":174},39263,"录屏功能开启后一直显示空活动，没有生成新的记录怎么办？","建议先清理本地缓存数据。具体步骤：删除本地日志文件以及截图图片目录（macOS 路径：~\u002FLibrary\u002FApplication Support\u002FMineContext\u002FData\u002Fscreenshot\u002Factivity\u002F日期文件夹），然后重启软件重新录制 10 秒观察是否恢复正常。如果问题依旧，请检查日志报错信息。","https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\u002F23",{"id":176,"question_zh":177,"answer_zh":178,"source_url":179},39264,"发现 LLM 请求频率异常高且存在大量重复请求，导致 Token 浪费，如何处理？","这通常是由于程序多开（多个进程同时运行）导致的。解决方法是：重启电脑，或者打开任务管理器，手动结束所有多余的 MineContext\u002FOpenContext 进程，确保只有一个实例在运行。后续版本会修复多开检测问题。","https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\u002F255",{"id":181,"question_zh":182,"answer_zh":183,"source_url":184},39266,"使用自定义源时，每 15 分钟的活动摘要功能不生效，没有生成总结怎么办？","这可能是由于图片访问路径错误或特定模型兼容性问题导致的。建议首先切换回官方默认源（如豆包源）测试是否正常。如果必须使用自定义源，请提供日志文件（Windows 位于安装目录下的 MineContext\u002Flogs\u002F，macOS 位于 ~\u002FLibrary\u002FApplication Support\u002FMineContext\u002Flogs\u002F）以便排查具体的路径或模型返回格式问题。","https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fissues\u002F168",[186,191,196,201,206,211,216,221,226],{"id":187,"version":188,"summary_zh":189,"released_at":190},315207,"v0.1.8","## 修复\n修改豆包嵌入模型","2026-01-28T09:51:23",{"id":192,"version":193,"summary_zh":194,"released_at":195},315208,"v0.1.7","## 修复\n模型验证弹出框问题\n\n## 功能\n使用 minecontext 热力图","2025-12-25T06:53:21",{"id":197,"version":198,"summary_zh":199,"released_at":200},315209,"0.1.6","# 已修复\r\n在 0.1.5 版本中修改提示词后，部分模型表现不佳，因此该修改在 0.1.6 版本中被回滚。","2025-11-18T07:26:51",{"id":202,"version":203,"summary_zh":204,"released_at":205},315210,"0.1.5","# Granite 版本更新内容\n发布周期：2025年11月1日至2025年11月14日\n\n正如Granite以其极高的耐用性和持久性而闻名一样，本次更新为我们的产品奠定了全新的稳定基础与流畅体验。\n\n稳定性与信任：Granite的卓越硬度象征着Apple Notarization所带来的强大安全性与可信度，彻底免去了使用命令行绕过权限的必要，确保安装过程坚实可靠。\n\n无缝延续：Granite的恒久特性也映射到自动更新和聊天记录保存功能上。这两项功能相辅相成，如同坚不可摧的基石，让您的工作流与创作交流在不同版本间无感衔接，不会出现中断或数据丢失。\n\n---\n\n ## ✨ 新功能\nfeat: 构建现已通过Apple Notarization认证，后续版本无需再通过命令行进行权限绕过操作。\n\nfeat: 引入了自动更新检查功能，支持无缝升级至最新版本，无需完整重新下载。\n![img_v3_02s1_ecc8c70f-98f0-46c8-842d-d76815514b0g](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F3dac0b20-33ce-4e72-80a2-7798a4203887)\n\nfeat: 聊天记录现可在“主页”和“创作”页面之间跨页保留。\n\u003Cimg width=\"323\" height=\"206\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F3edab220-43af-43b1-aa06-b0a18f877e02\" \u002F>\n\u003Cimg width=\"328\" height=\"187\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F1405f819-3734-40c1-b989-6801f3490509\" \u002F>\n\n\nfeat: 在运行过程中，调试信息会自动在后台保存。\n","2025-11-14T10:27:20",{"id":207,"version":208,"summary_zh":209,"released_at":210},315211,"0.1.4","# Opal 版本更新内容\n发布周期：2025年10月24日 - 2025年10月31日\n\n正如欧泊宝石从不同角度展现出绚丽的色彩变幻一样，本次更新也以清晰明亮的方式，将我们产品的内部流程生动地呈现出来。\n\n可视化：欧泊的“变彩效应”象征着我们将以往隐藏且复杂的中间处理过程，转化为动态、直观且易于理解的视觉信息。\n\n后台运行：欧泊固有的体色则代表了稳定、持续运行的后台服务（如 MineContext），它们是所有精彩视觉效果得以实现的基础。\n\n---\n  \n  ## ✨ 新功能\n- 功能：在 Windows 和 macOS 上新增了托盘图标控制。您可以选择继续或停止录制，即使关闭窗口后录制仍会继续。\n\u003Cimg width=\"136\" height=\"79\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fa576c6e9-3e46-40ed-9c74-0a29f8d7b50b\" \u002F>\n\n- 功能：录制界面现在会显示实时的录制状态，包括已处理的图片数量。\n\u003Cimg width=\"1716\" height=\"712\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F1a46a4d6-e3d8-490a-926c-6d3cfac6389d\" \u002F>\n\n- 重构：重新构建了截图处理模块。由原先一次性解析多张图片的方式，改为基于协程的单张图片并发解析并合并，从而提升了解析精度。\n- 功能：提升了每日报告的内容质量。\n- 功能：在 Windows 系统上，新增了自定义安装数据目录的支持。\n\u003Cimg width=\"395\" height=\"267\" alt=\"img_v3_02rj_ec72ace9-0b99-413a-8794-b595659d593g\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F664be1c6-1c50-40e4-b538-7b3b977b58df\" \u002F>\n\n\n\n  ## 🐛 问题修复\n  - 问题：修复设置页面的 API \n  - 问题：修复屏幕处理逻辑，并添加日志记录\n","2025-11-01T01:11:41",{"id":212,"version":213,"summary_zh":214,"released_at":215},315212,"0.1.3","  # Stibnite 版本更新内容\n发布周期：2025年10月17日至2025年10月24日\n\n**Stibnite**  \nStibnite 是一种以铅灰色、金属光泽和独特的晶体形态著称的矿物。本次发布正是其精髓的体现——兼容性进一步提升、界面更加精致、开发者工具更加强大，完美呼应了这种矿石的核心特质。\n\n**为何选择 Stibnite？**  \n多平台支持 → 广泛适应性  \n正如 Stibnite 能形成多种多样的晶体结构一样，本次发布也大幅增强了跨平台兼容性——通过优化 Windows 安装流程、改进跨平台构建脚本以及端口配置，使应用能够在更多环境中“结晶”并稳定运行。\n\n增强的开发者工具 → 精准调试  \n新增的处理器监控器、调试工具和性能日志，犹如 Stibnite 晶体锋利的棱角，为开发者提供了更为敏锐的诊断与性能分析手段。\n\n---\n  \n  ## ✨ 新特性\n\n  平台与安装\n\n  - Windows 安装优化：改进了可执行文件路径检测与处理逻辑，提升了 Windows 安装体验 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F150\n  - Windows 构建支持：通过正确的 PyInstaller 配置，显著提升了 Windows 平台的兼容性 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F105\n  - 跨平台构建脚本：新增了一套全面的 Python 构建脚本，支持多种操作系统 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F83\n  - 端口配置调整：将默认端口由 8000 改为 1733，以避免常见的端口冲突 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F142\n\n ## UI\u002FUX 优化\n\n  - 全新顶部导航栏：对顶部导航栏进行了全面重构，提升了用户体验与界面现代感 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F129\n  https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F111 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F110\n  - 每日摘要展示：在创作面板中新增每日摘要，并支持从提示信息直接跳转 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F130\n  - 设置界面截图预览：在设置弹窗中集成屏幕截图预览功能，帮助用户更好地理解设置效果 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F136\n  - 复制与编辑功能：实现了内容复制功能及编辑变更追踪 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F87\n\n  ## 开发者工具与调试\n\n  - 处理器监控器：新增了包含实时指标的全面处理器监控仪表板 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F145\n  - 自定义设置面板：推出了可自定义的高级设置界面，方便进行深度配置 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F145\n  - 提示词调试：引入了针对 AI 交互的提示词调试工具，便于分析与排查问题 https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fpull\u002F145\n  - 生成记录追踪：新增了生成记录系统，用于调试和审计目的","2025-10-24T09:53:39",{"id":217,"version":218,"summary_zh":219,"released_at":220},315213,"0.1.2","# 氟石版本更新内容\n发布周期：2025年10月11日至2025年10月15日\n\n氟石天然呈现出多种色彩与荧光效应，正如本次更新所涵盖的多样化功能一样：开源前端、自定义模型、自动刷新\u002F清理，以及关键性错误修复。它那耀眼的光芒象征着系统焕发出的新清晰度与自我优化能力——将复杂的升级过程转化为流畅无阻的使用体验。\n\n\n---\n### ✨ 新特性\n- 功能：前端代码开源\n- 功能：支持自定义模型选择\n- 功能：新增活动自动刷新界面（5秒轮询）\n- 功能：增加截图自动清理功能（保留15天，每日执行一次）\n- 功能：将F12开发者工具由全局快捷键改为应用内快捷键\n- 功能：为模型设置保存失败添加错误提示与弹窗\n- 功能：将默认截图间隔调整为15秒\n### 🐛 问题修复\n- 修复：解决停靠图标显示过大的问题\n- 修复：修复因文件路径与时间戳不匹配导致的截图读取失败问题\n- 修复：解决活动列表数据跨日期显示混乱及历史日期轮询问题\n- 修复：清理部分调试日志，并修复界面图标显示异常\n- 修复：解决message.error()与React 19不兼容的问题，恢复API密钥弹窗\n### 📚 文档更新\n- 文档：新增自定义模型使用说明\n- 文档：新增后端调试接口说明\n- 文档：新增前端框架及开发说明\n\n\n---\n\n发布日期：2025年10月15日  \n上一版本：v0.1.1（2025年10月10日）","2025-10-15T13:05:06",{"id":222,"version":223,"summary_zh":224,"released_at":225},315214,"0.1.1","# 变更内容\n\n**发布周期**: 2025年9月30日至2025年10月11日\n\n**苔藓玛瑙**\n一次基础性的更新，在更加结构化和稳定的内核中孕育新的成长。\n\n**为什么选择苔藓玛瑙？**\n这种石头因其错综复杂的内部纹理而备受珍视，而不仅仅在于其表面。同样地，本次发布的意义在于进行了大规模的重构——编织出一个更为稳固的新基础。新增的功能和错误修复则如同生长在这稳定结构中的“苔藓”。通过提供全面的文档，整个系统的架构变得清晰且可追溯，标志着从最初的 v0.1.0 版本迈向成熟的演进。\n\n---\n\n## ✨ 新特性\n\n- **feat: 启用 uv 包管理** - @qin-ctx ([538efe0](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommit\u002F538efe0))\n  - 从 pip\u002Frequirements.txt 迁移到支持 uv 的现代 `pyproject.toml`\n  - 更快速、更可靠的依赖管理\n  - 添加了 `.python-version` 文件以确保 Python 环境的一致性\n  - 更新构建脚本以使用 uv 工作流\n\n- **feat: 优化 API 密钥处理逻辑，用于获取和更新模型设置，并添加 API 密钥掩码功能以增强安全性。** - @fanrenaz ([abe44d3](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommit\u002Fabe44d3))\n  - 通过在设置中引入掩码功能，增强了 API 密钥的安全性\n  - 改进了 UI 中敏感凭据的处理方式\n\n- **feat: 更新模型设置数据结构，apiKey 字段返回掩码后的值以提升安全性。** - @fanrenaz ([38fb32a](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommit\u002F38fb32a))\n  - API 密钥现在在响应中以掩码形式返回\n\n---\n\n## 🐛 错误修复\n\n- **fix: 添加启动参数，避免端口冲突** - @qin-ctx ([8f2e3d4](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommit\u002F8f2e3d4))\n  - 增加了 `--port`、`--host` 和 `--config` 命令行参数\n  - 防止运行多个实例时发生端口冲突\n  - 优先级：命令行参数 > 配置文件 > 默认值\n\n- **fix: 每日报告重复生成问题** - @qin-ctx ([0bac59d](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommit\u002F0bac59d))\n  - 解决了导致每日报告重复的问题\n  - 改进了报告生成的调度逻辑\n\n- **fix: 先初始化配置** - @qin-ctx ([fc0a730](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommit\u002Ffc0a730))\n  - 配置现在会在服务器启动前正确初始化\n  - 防止因缺少配置而导致的启动错误\n\n- **fix: 优化聊天与待办事项功能** - @qin-ctx ([10852a4](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommit\u002F10852a4))\n  - 提升了聊天界面的响应速度\n  - 改进了待办事项列表的管理和显示\n  - 在上下文代理中实现了更好的状态管理\n\n- **fix: 优化工具描述** - @qin-ctx ([afb7c85](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002FMineContext\u002Fcommit\u002Fafb7c85))\n  - 提高了工具描述的清晰度和准确性\n  - 改进了工具使用的提示工程设计\n\n- **fix: 添加链接** - @qin-ctx ([8b80b4d](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002F","2025-10-11T13:25:11",{"id":227,"version":228,"summary_zh":229,"released_at":230},315215,"0.1.0","MineContext 是一款主动式、情境感知的人工智能伙伴。\n\n## 🚀 核心功能\n\nMineContext 专注于五大核心功能：无感收集、智能重现与主动推送。\n\n1. 📥 无感收集  \n能够高效地采集并处理海量情境数据。通过精心设计的存储管理机制，实现大规模数据采集，同时不会增加用户的认知负担。\n\n2. 🚀 主动推送  \n在日常使用中主动推送关键信息与洞察。它会从你的情境数据中提取摘要内容，例如每日\u002F每周总结、实用小贴士和待办事项，并直接推送到你的首页。\n\n3. 💡 智能重现  \n在创作过程中智能地呈现相关且有用的情境信息。在提供创意辅助的同时，避免信息过载，确保用户体验流畅自然。\n\n4. 🛡️ 隐私优先  \n所有数据均本地存储，充分保障你的隐私与安全。\n\n5. 🎯 情境工程架构  \n支持多模态、多源数据的完整生命周期——从采集、处理、存储，到管理、检索与消费——从而生成六类智能化情境信息。\n\n\n## 🏁 快速入门\n\n1. 安装  \n点击下方链接或访问 GitHub 最新发布页面进行下载。\n\n2. 禁用隔离属性  \n在运行应用程序之前，请在终端中输入以下命令以禁用隔离属性：\n\n```bash\nsudo xattr -d com.apple.quarantine \"\u002FApplications\u002FMineContext.app\"\n```\n\n3. 输入 API 密钥  \n应用加载完成后，请按照提示输入您的 API 密钥。目前我们支持通义千问和 OpenAI，未来还将接入更多平台及本地 Ollama 模型。\n\n4. 开始记录  \n进入【屏幕监控】中的【设置】，配置您的屏幕共享区域，然后点击【开始录制】即可启动。\n\n5. 放心使用  \n录制启动后，系统将逐步收集您的情境数据。此后您无需再操心，可以安心专注于其他任务。MineContext 会陆续为您生成待办事项、实用建议、总结报告以及活动提醒。当然，您也可以通过【与 AI 聊天】功能进行主动问答。\n\n","2025-09-30T13:16:28"]