Musea 是一个现代化的Chrome浏览器扩展，专为提高工作和学习效率而设计。它结合了传统的番茄工作法与现代AI技术，通过智能虚拟角色和MCP（Model Context Protocol）架构，为用户提供个性化的专注体验和智能工作助手。

• 智能专注计时器 - 可自定义的专注时间管理（1-120分钟）
• 实时徽章显示 - 动态显示剩余时间，颜色随时间变化
• 自动状态管理 - 专注模式的启动、暂停、停止全自动化

• 完全屏蔽模式 - 完全阻止访问指定网站
• 学习模式 - 隐藏干扰元素，保留核心学习内容
• 站点特定处理 - 预设支持百度、哔哩哔哩、知乎等热门网站

• 声音提醒 - 内置通知音效，可调节音量
• TTS语音合成 - 集成字节跳动TTS API，多种语音类型
• AI个性化通知 - 基于LLM生成温暖鼓励的休息提醒

• 交互式虚拟角色 - 可爱的AI助手，支持点击聊天
• 语音对话功能 - 支持语音输入和TTS语音回复
• 动画系统 - 丰富的角色动画（闲置、思考、问候等）
• 会话持久化 - 跨会话保存对话历史

• 三层架构设计 - Chrome插件 ↔ Native Messaging Host ↔ MCP Client
• 学术研究助手 - 集成arxiv论文搜索功能
• 系统控制 - 音乐播放、应用启动、系统信息获取
• Chrome搜索 - 智能搜索和网页操作
• 模块化扩展 - 支持添加更多MCP服务

• 响应式设计 - 适配不同屏幕尺寸
• 暗黑模式支持 - 护眼的深色主题
• 动画效果 - 平滑的过渡和交互反馈
• 高度可定制 - 丰富的个性化设置选项

1. 启用开发者模式

   • 打开 Chrome扩展管理页面
   • 右上角开启"开发者模式"

2. 加载扩展

   • 点击"加载已解压的扩展程序"
   • 选择项目的 dist 文件夹

3. 固定扩展图标

   • 点击Chrome工具栏的扩展图标
   • 找到"Musea"并点击固定

4. 开始使用

   • 点击扩展图标打开设置面板
   • 配置您的专注时间和偏好设置

注意: 基于安全考虑，暂不计划发布到Chrome应用商店。我们坚持开源透明的原则，鼓励用户直接使用源码安装！

• Node.js: >= 22.12.0
• 包管理器: pnpm 9.15.1
• 浏览器: Chrome 109+ 或 Firefox 109+

# 克隆项目
git clone <repository-url>
cd Musea
# 安装依赖
pnpm install

# 开发模式构建
pnpm dev

# 生产模式构建
pnpm build

# 打包扩展
pnpm zip

• 灵活时间设置: 支持1-120分钟的自定义专注时长
• 智能徽章显示: 实时显示剩余专注时间，颜色随时间变化
• 自动状态管理: 专注模式的启动、暂停、停止全自动化

• 完全阻止访问指定网站
• 显示友好的提醒页面
• 支持域名和完整URL匹配

• 隐藏网站的干扰元素（如推荐、评论等）
• 保留核心学习内容
• 预设支持：百度、哔哩哔哩等热门网站
• 自定义CSS选择器支持（使用场景： 例如一些截屏的时候，需要隐藏一些 control bar、 button 等，尤其是截图视频的时候）

• 内置通知音效
• 可调节音量（0-100%）
• 测试播放功能

• 集成字节跳动TTS API
• 多种语音类型选择（男声/女声）
• 可调节语速（0.5x - 2.0x）
• 智能缓存机制，节省API调用

• 基于LLM生成个性化休息提醒
• 自定义系统提示词和用户模板
• 智能预生成，减少等待时间
• 温暖鼓励的语言风格

• 智能对话 - 基于LLM的自然语言对话
• 语音交互 - 支持语音输入录制和TTS语音回复
• 动画表现 - 丰富的角色动画系统（闲置、思考、问候、说话等）
• 情境感知 - 根据专注状态和网站环境调整行为

• 研究助手 - 通过MCP协议调用arxiv论文搜索
• 系统控制 - 音乐播放、应用启动、系统信息查询
• 智能搜索 - Chrome搜索和网页操作
• 任务执行 - 自动化工作流程和任务管理

• 系统提示词 - 定义AI助手的角色和行为规范
• 用户模板 - 自定义通知生成的具体指令
• 占位符支持 - 支持 {duration} 等动态变量
• 智能回退 - 未配置时自动使用默认模板

• 友好积极的语言风格
• 简短有效的提醒内容（≤50字）
• 邻家女孩或可爱学妹口吻
• 包含休息建议和鼓励话语

• 响应式布局: 适配不同屏幕尺寸
• 暗黑模式: 护眼的深色主题
• 动画效果: 平滑的过渡和交互反馈
• 直观操作: 清晰的图标和标签

• 折叠式设计: 节省空间，按需展开
• 实时预览: 设置更改即时生效
• 导入导出: 配置备份和恢复（规划中）

• React 19.0.0: 现代化的用户界面框架
• TypeScript 5.8.1: 类型安全的开发体验
• Tailwind CSS: 实用优先的CSS框架
• Vite 6.1.0: 快速的构建工具

• Manifest V3: 最新的Chrome扩展标准
• Service Worker: 后台脚本管理，专注时间控制
• Content Scripts: 页面内容操作，网站屏蔽和虚拟角色注入
• Offscreen Documents: 音频播放支持，TTS语音合成
• Native Messaging: 与本地MCP服务通信

Chrome插件 (前端) ←→ Native Messaging Host ←→ MCP Client服务 ←→ MCP Servers
     │                        │                      │                │
  UI交互界面              协议转换桥梁           MCP客户端实现      具体服务实现

• Chrome插件层: 用户界面，虚拟角色交互，发起MCP请求
• Native Messaging Host: 协议桥梁，安全的本地系统访问
• MCP Client服务: 服务调度器，管理工具和外部MCP服务
• MCP Servers: 具体功能实现（arxiv搜索、系统控制等）

• Character Service: 角色状态管理和动画控制
• Chat System: 对话历史管理和会话持久化
• Voice Service: 语音录制、TTS合成、音频播放
• MCP Integration: 智能任务检测和MCP服务调用

• Chrome Storage API: 配置数据持久化
• 实时同步: 跨标签页状态同步
• 类型安全: TypeScript接口定义
• 分层存储: 专注配置、角色设置、对话历史分离管理

• Monorepo架构: 模块化的代码组织
• Turbo: 高效的构建系统
• pnpm: 快速的包管理器

Fuck_Brain_Concentration/
├── chrome-extension/          # Chrome扩展核心
│   ├── src/
│   │   ├── background/        # 后台脚本（专注管理、MCP通信）
│   │   ├── content/           # 内容脚本（网站屏蔽）
│   │   ├── services/          # 服务层（TTS、角色、MCP）
│   │   └── constants/         # 常量定义
│   ├── public/                # 静态资源（音频、图标、页面）
│   └── manifest.ts            # 扩展清单
├── MCP/                       # MCP后端服务
│   ├── native-host/           # Native Messaging Host
│   ├── client/                # MCP客户端服务
│   ├── scripts/               # 安装和启动脚本
│   └── logs/                  # 服务日志
├── packages/                  # 共享包
│   ├── storage/               # 存储管理
│   ├── ui/                    # UI组件
│   ├── shared/                # 共享工具
│   └── ...
├── pages/                     # 页面组件
│   ├── popup/                 # 弹出页面（设置面板）
│   ├── content/               # 内容页面（屏蔽页面）
│   ├── content-ui/            # 内容UI（通知卡片）
│   └── content-runtime/       # 运行时内容（虚拟角色）
├── dist/                      # 构建输出
└── local_history/             # 开发文档和历史记录

1. 获取API密钥

   • 访问 字节跳动语音开放平台
   • 注册账号并创建应用
   • 获取AppID和访问令牌

2. 配置步骤

   • 在扩展设置中启用语音通知
   • 输入AppID和Token
   • 选择语音类型和语速
   • 测试语音合成功能

1. 启用角色助手

   • 在弹窗设置中开启"角色助手"
   • 角色将在所有网页上显示
   • 支持专注模式自适应

2. 角色交互设置

   • 点击角色开始对话
   • 支持文字和语音输入
   • 对话历史自动保存

3. MCP功能配置

   • 角色支持智能任务检测
   • 可直接调用MCP服务
   • 支持arxiv搜索、系统控制等

1. 安装MCP服务

   # 进入MCP目录
   cd MCP
   
   # 安装依赖
   cd native-host && npm install && cd ..
   cd client && npm install && cd ..
   
   # 配置Native Messaging
   ./scripts/install.sh

2. 启动MCP服务

   # 启动所有服务
   ./scripts/start-all.sh
   
   # 或分别启动
   cd native-host && npm start &
   cd client && npm start &

3. 验证MCP连接

   • 在角色对话中输入"播放音乐"或"搜索论文"
   • 检查MCP服务日志
   • 确认功能正常工作

1. 基础设置

   • 启用AI通知功能
   • 配置API密钥（如需要）
   • 设置预生成时间

2. 自定义Prompt

   • 展开"提示词设置"面板
   • 编辑系统提示词和用户模板
   • 保存设置并测试效果

1. 设置专注时间

   • 打开扩展弹窗
   • 设置专注时长（推荐25分钟）
   • 点击"开始专注"

2. 配置屏蔽网站

   • 添加容易分心的网站
   • 选择屏蔽模式（完全屏蔽/学习模式）
   • 测试屏蔽效果

3. 启用AI虚拟角色

   • 在弹窗中开启"角色助手"
   • 角色将出现在网页右下角
   • 点击角色开始对话

4. 个性化设置

   • 配置通知方式（声音/TTS/AI）
   • 调整界面主题
   • 自定义AI提示词

• 文字聊天: 点击角色，在对话框中输入文字
• 语音对话: 点击麦克风图标，录制语音消息
• 语音回复: 角色会用TTS语音回复（需配置TTS）

• 学术搜索: "帮我搜索机器学习相关论文"
• 系统控制: "播放音乐" / "打开应用"
• Chrome搜索: "帮我搜索Python教程"
• 系统信息: "显示系统信息"

• 闲置动画: 角色会自动播放闲置动画
• 交互动画: 对话时显示思考和说话动画
• 专注适应: 专注模式下角色行为会相应调整

// 自定义CSS选择器示例
{
  "baidu.com": [
    ".result-op",           // 隐藏推广内容
    "#content_right",       // 隐藏右侧广告
    ".c-recomm-wrap"        // 隐藏推荐内容
  ]
}

系统提示词:

你是一个温柔的学习伙伴，专门帮助用户在专注学习后放松休息。
你的回复应该：
1. 简短温暖（不超过50字）
2. 充满鼓励和关怀
3. 建议合适的休息活动
4. 使用亲切自然的语气

用户模板:

用户刚完成{duration}分钟的专注学习，现在是{当前时间}。
请生成一条温暖的休息提醒，要体现出对用户努力的认可，
并建议适合的休息方式。语气要像关心的朋友一样自然亲切。

状态: 🔄 规划中 | 预计发布: v1.3.0

核心功能:

• 疲劳检测 - 通过摄像头检测眼部疲劳状态，智能提醒休息
• 走神监控 - 检测用户注意力分散，及时发出专注提醒
• 姿势监控 - 监测坐姿和头部位置，提醒保持正确姿势
• 休息提醒 - 基于视觉数据的个性化休息建议

技术实现:

• 集成WebRTC和MediaDevices API进行摄像头访问
• 使用TensorFlow.js进行本地机器学习推理
• 眼部追踪和面部表情识别算法
• 隐私优先设计，所有数据本地处理

隐私保护:

• ✅ 所有视觉数据仅在本地处理，不上传云端
• ✅ 用户完全控制摄像头权限
• ✅ 可选功能，默认关闭

状态: 🔄 规划中 | 预计发布: v1.4.0

核心功能:

• 一键角色生成 - 基于AI的角色外观、性格、声音自定义生成
• 动态表情系统 - 丰富的面部表情和情绪表达
• 3D角色模型 - 支持3D虚拟角色，更真实的交互体验
• 角色商店 - 社区分享的角色模板和自定义角色

技术实现:

• 集成Three.js或Babylon.js进行3D渲染
• 使用Stable Diffusion API进行角色外观生成
• 基于LLM的性格和对话风格定制
• 支持Live2D和VRM格式的角色模型

自定义选项:

• 🎨 外观定制（发型、服装、配饰）
• 🗣️ 声音合成（音色、语调、口音）
• 💭 性格设定（活泼、温柔、严肃、幽默）
• 🎭 专业角色（学习伙伴、工作助手、健身教练）

状态: 🔄 规划中 | 预计发布: v1.5.0 | 灵感来源: Manus

核心功能:

• 学术研究助手 - 深度集成arxiv、Google Scholar、PubMed等学术数据库
• 代码开发助手 - GitHub集成，代码搜索、PR管理、Issue跟踪
• 系统自动化 - 本地应用控制、文件管理、系统监控
• 工作流自动化 - 自定义任务链，智能工作流程编排

MCP服务扩展:

📚 学术研究
├── arxiv-mcp-server     # 论文搜索和下载
├── scholar-mcp-server   # Google Scholar集成
├── pubmed-mcp-server    # 医学文献搜索
└── zotero-mcp-server    # 文献管理

💻 开发工具
├── github-mcp-server    # GitHub API集成
├── gitlab-mcp-server    # GitLab支持
├── docker-mcp-server    # 容器管理
└── vscode-mcp-server    # 编辑器控制

🖥️ 系统控制
├── macos-mcp-server     # macOS系统控制
├── windows-mcp-server   # Windows系统控制
├── linux-mcp-server     # Linux系统控制
└── browser-mcp-server   # 浏览器自动化

智能功能:

• 🧠 智能任务理解 - 自然语言转换为具体操作步骤
• 🔄 自动化工作流 - 复杂任务的自动化执行
• 📊 工作分析 - 工作效率分析和优化建议
• 🎯 目标管理 - 长期目标跟踪和进度管理

安全特性:

• 🔒 权限控制和操作确认机制
• 🛡️ 沙盒环境执行敏感操作
• 📝 详细的操作日志和审计
• ⚠️ 危险操作的多重确认

状态: 🔄 规划中 | 预计发布: v1.6.0 | 核心技术: 长缓存Agent架构

核心功能:

• 🏃‍♂️ Keep健身教练 - 个性化运动计划、动作指导、进度跟踪
• 👨‍🍳 美食大厨助手 - 菜谱推荐、烹饪指导、营养搭配
• 🗣️ 语言学习伙伴 - 多语言对话练习、发音纠正、文化交流
  • 中文语境朋友（方言、普通话、古诗词）
  • 英文语境朋友（英式、美式、商务英语）
  • 日语语境朋友（敬语、关西腔、动漫用语）
• 📚 学科专业导师 - 数学、物理、编程、设计等专业指导

长缓存Agent技术架构:

🧠 Agent核心层
├── Long-Term Memory     # 长期记忆存储（用户偏好、学习历史）
├── Context Cache        # 上下文缓存（会话状态、任务进度）
├── Personality Engine   # 性格引擎（角色一致性、情感状态）
└── Learning Adapter     # 学习适配器（用户行为分析、个性化调整）

🎭 角色专业化层
├── Fitness Coach        # 健身教练（运动计划、动作库、健康数据）
├── Culinary Master      # 美食大厨（菜谱库、烹饪技巧、营养知识）
├── Language Partner     # 语言伙伴（多语言模型、文化背景、对话场景）
└── Subject Tutor        # 学科导师（专业知识库、教学方法、进度跟踪）

🔄 持久化存储层
├── User Profile Store   # 用户画像存储
├── Conversation History # 对话历史（分角色、分主题）
├── Progress Tracking    # 进度跟踪（学习曲线、成就系统）
└── Preference Learning  # 偏好学习（自动优化、个性化推荐）

学习搭子智能特性:

• 🎭 角色一致性 - 每个搭子保持独特的性格和专业特色
• 📚 渐进式学习 - 根据用户水平自动调整难度和内容
• 🔄 习惯养成 - 长期陪伴用户建立健康的学习和生活习惯
• 💡 创意激发 - 基于用户兴趣和历史，提供个性化的创意建议
• 🎯 目标导向 - 帮助用户设定和达成具体的学习或生活目标

长缓存Agent核心优势:

• 🧠 深度记忆 - 记住用户的每一次互动，形成完整的用户画像
• 🎨 个性化进化 - 随着交互增加，搭子变得更懂用户
• 🔄 连续性体验 - 跨设备、跨时间的无缝对话体验
• 📈 成长轨迹 - 记录和分析用户的学习成长过程

MCP服务扩展:

🎭 学习搭子服务
├── fitness-mcp-server   # 健身数据和计划管理
├── recipe-mcp-server    # 菜谱和营养数据库
├── language-mcp-server  # 多语言学习资源
└── education-mcp-server # 教育资源和进度跟踪

注意顺序可能不固定!

个性特征: 阳光、积极、专业、耐心 核心功能:

• 个性化运动计划制定（基于用户体质、目标、时间）
• 实时动作指导和纠正（结合视觉监控）
• 运动数据跟踪和分析（心率、卡路里、进步曲线）
• 营养建议和饮食搭配
• 激励和习惯养成（打卡系统、成就解锁）

长缓存特性:

• 记住用户的运动偏好和身体状况
• 跟踪长期健身进展和目标达成
• 根据用户反馈调整训练强度和方式
• 学习用户的时间习惯，智能提醒运动

个性特征: 热情、创意、细致、美食家气质 核心功能:

• 基于现有食材的菜谱推荐
• 分步骤烹饪指导（图文+语音）
• 营养搭配和健康饮食建议
• 不同菜系和口味的探索
• 厨艺技巧教学和进阶指导

长缓存特性:

• 记住用户的口味偏好和饮食禁忌
• 跟踪用户的厨艺进步和掌握的菜品
• 根据季节和节日推荐应景菜谱
• 学习用户的烹饪习惯和时间安排

个性特征: 友善、博学、文化敏感、鼓励性 核心功能:

• 多语言日常对话练习
• 发音纠正和语调指导
• 文化背景和习俗介绍
• 语法解释和词汇扩展
• 情景模拟和角色扮演

长缓存特性:

• 记住用户的语言水平和学习进度
• 跟踪词汇掌握情况和语法薄弱点
• 根据用户兴趣选择对话主题
• 适应用户的学习节奏和方式偏好

个性特征: 严谨、耐心、启发式、因材施教 核心功能:

• 个性化学习计划制定
• 概念解释和知识点梳理
• 练习题推荐和解答指导
• 学习方法和技巧传授
• 学习进度跟踪和评估

长缓存特性:

• 记住用户的知识基础和学习能力
• 跟踪学习进度和掌握程度
• 识别用户的学习盲点和困难
• 根据用户反馈调整教学方式

// 长期记忆存储架构
interface LongTermMemory {
  userProfile: UserProfile;           // 用户画像
  conversationHistory: ConversationHistory[]; // 对话历史
  learningProgress: LearningProgress; // 学习进度
  preferences: UserPreferences;       // 用户偏好
}

// 上下文缓存系统
interface ContextCache {
  sessionState: SessionState;         // 会话状态
  taskProgress: TaskProgress[];       // 任务进度
  emotionalState: EmotionalState;     // 情感状态
  recentInteractions: Interaction[];  // 近期交互
}

// 个性化适配引擎
interface PersonalityEngine {
  characterTraits: CharacterTraits;   // 角色特征
  responseStyle: ResponseStyle;       // 回复风格
  teachingMethod: TeachingMethod;     // 教学方法
  adaptationRules: AdaptationRule[];  // 适配规则
}

• 本地存储: 使用IndexedDB进行大容量数据存储
• 云端同步: 可选的加密云端备份（用户控制）
• 增量更新: 只同步变化的数据，减少带宽消耗
• 版本控制: 支持数据回滚和历史版本查看

• 端到端加密: 所有用户数据本地加密存储
• 匿名化处理: 敏感信息自动匿名化
• 用户控制: 完全的数据控制权，可随时删除
• 透明度: 清晰的数据使用说明和隐私政策

• 重大更新: 修复 bug
• 新增: 语音输入和TTS语音回复
• 优化: 用户界面和交互体验
• 改进: 界面响应性
• 修复: 多项稳定性问题和内存泄漏

• 重大更新: 全面重构，更稳定的功能和交互
• 新增: AI虚拟角色系统，支持语音对话和动画
• 新增: MCP架构集成，支持arxiv搜索和系统控制
• 新增: TTS语音合成功能，支持字节跳动API
• 新增: AI个性化通知系统和自定义Prompt
• 优化: 用户界面和交互体验，支持暗黑模式
• 修复: 多项稳定性问题和内存泄漏

• 修复: 严重bug修复
• 优化: 通知体验提升
• 改进: 界面响应性

• 首次发布: 基础专注时间管理功能
• 核心功能: 网站屏蔽、时间计时、通知提醒

我们欢迎社区贡献！请遵循以下步骤：

1. Fork项目 并创建功能分支
2. 编写代码 并确保通过测试
3. 提交PR 并详细描述更改内容
4. 代码审查 通过后将合并到主分支

• 使用TypeScript进行类型安全开发
• 遵循ESLint和Prettier代码规范
• 编写单元测试覆盖新功能
• 更新相关文档

本项目采用 MIT License 开源协议。

• Chrome Extension Boilerplate - 项目脚手架
• 字节跳动TTS - 语音合成服务
• deepseek - AI模型服务
• MCP (Model Context Protocol) - 智能助手架构
• arxiv-mcp-server - 学术搜索服务
• Manus - MCP智能助手灵感来源
• 所有贡献者和用户的支持

如果这个项目对您有帮助，欢迎：

• ⭐ 给项目点个Star
• 🐛 报告Bug和建议
• 🔀 提交Pull Request
• 📢 推荐给朋友使用

开源承诺: 本项目承诺永久开源免费，坚持透明开发的初心！ ✅🍃🎉