微信读书深度阅读助手是一个Chrome浏览器扩展，通过集成多个AI大模型，为微信读书用户提供智能阅读辅助功能。支持文本解释、内容消化、多角度分析等功能，让阅读更加深入和高效。
- ✨ 新增设置页面全新 UI，支持多标签切换（模型配置/快捷键说明/关于项目）
- ✨ 新增 Kimi、MiniMax、智谱 三个 AI 服务商支持
- ✨ 助手面板支持快捷切换服务商（点击服务商按钮显示菜单）
- ✨ 新增服务商状态指示灯（绿色=正常/红色=失败/灰色=未配置）
- ✨ 新增首次使用引导提示
- 🔧 ESLint 配置升级至 ES2022，支持私有字段语法
- 🐛 修复多处代码规范问题
-
💡 解释一下 (Explain)
- 对选中文本进行术语解释、背景补充
- 快捷键：
E - 适用场景：专业术语、人名、概念等
-
📖 消化一下 (Digest)
- 将复杂内容转化为易理解的解读
- 包含：核心观点、思想流派、历史演进
- 快捷键：
X - 适用场景：长段落、复杂理论
-
👂 兼听一下 (Analyze)
- 提供多角度分析和不同观点
- 包含：支持/反对论据、学者观点、扩展阅读
- 快捷键：
M - 适用场景：争议性内容、观点分析
- 多AI服务商支持：千问、豆包、Kimi、MiniMax、智谱、文心一言
- 智能面板系统：浮动/内嵌模式切换，支持拖拽和调整大小
- 会话式交互：支持连续对话，保持上下文
- Markdown渲染：富文本显示，支持代码高亮
- 本地存储：API Key安全存储，设置自动同步
- 快捷键支持：全局快捷键，提升使用效率
src/
├── shared/ # 共享模块
│ ├── config.js # 全局配置
│ ├── message-types.js # 消息类型定义
│ ├── bridge-service.js # 通信桥接服务
│ └── settings-service.js # 设置管理服务
├── background/ # 后台脚本
│ ├── background.js # 主入口
│ └── services/
│ └── chat-service.js # AI聊天服务
├── content/ # 内容脚本
│ ├── content.js # 主入口
│ ├── components/ # UI组件
│ │ ├── assistant-panel.js # 主面板组件
│ │ ├── chat/ # 聊天组件
│ │ ├── help-modal/ # 帮助模态框
│ │ └── interactive/ # 交互组件(拖拽、调整大小)
│ ├── services/ # 业务服务
│ │ ├── chat-service.js # 聊天服务
│ │ └── content-bridge.js # 内容桥接
│ └── utils/ # 工具函数
│ ├── dom-utils.js # DOM操作工具
│ └── event-utils.js # 事件处理工具
├── popup/ # 弹出窗口
│ ├── popup.html # 设置界面
│ ├── popup.css # 样式文件
│ └── popup.js # 设置逻辑
└── lib/ # 第三方库
└── marked.min.js # Markdown解析器
graph TB
A[Content Script] --> B[BridgeService]
B --> C[Background Script]
C --> D[AI Services]
A --> E[AssistantPanel]
E --> F[ChatComponent]
E --> G[InteractiveComponents]
H[Popup] --> B
B --> I[SettingsService]
I --> J[Chrome Storage]
C --> K[MessageRouter]
K --> L[ChatService]
- Chrome浏览器 >= 88
- Node.js >= 14.0.0
- npm >= 6.0.0
- 克隆项目
git clone https://github.com/lagrangee/weread_deepreading.git
cd weread_deepreading- 安装依赖
npm install- 开发模式构建
npm start
# 或者
npm run dev- 生产模式构建
npm run build- 加载到Chrome
- 打开
chrome://extensions/ - 开启"开发者模式"
- 点击"加载已解压的扩展程序"
- 选择
dist目录
- 打开
- 点击扩展图标打开设置面板
- 选择AI服务商（文心一言/通义千问/豆包/DeepSeek）
- 输入对应的API Key
- 点击"测试"验证连接
- 保存设置
- 选择文本：在微信读书页面选中要分析的文本
- 选择功能：点击对应的AI按钮或使用快捷键
E- 解释一下X- 消化一下M- 兼听一下
- 查看结果：AI分析结果会显示在助手面板中
- 继续对话：可以在输入框中继续提问
| 快捷键 | 功能 | 说明 |
|---|---|---|
E |
解释一下 | 解释选中文本 |
X |
消化一下 | 消化选中内容 |
M |
兼听一下 | 多角度分析 |
Esc |
关闭面板 | 隐藏助手面板 |
? |
帮助信息 | 显示帮助模态框 |
- 浮动模式：面板浮动在页面上方，可自由拖拽和调整大小
- 内嵌模式：面板嵌入页面右侧，与页面内容并排显示
- 代码风格：遵循ESLint和Prettier配置
- 注释规范：使用JSDoc格式，中文注释
- 命名规范：
- 类名：PascalCase
- 方法名：camelCase
- 常量：UPPER_SNAKE_CASE
- 私有字段：以
#开头
- 模块化设计：按功能域划分模块
- 单一职责：每个类/模块只负责一个功能
- 依赖注入：避免硬编码依赖
- 错误处理：统一的错误处理机制
- 性能优化：懒加载、缓存、防抖等
# 运行测试
npm test
# 监听模式
npm run test:watch
# 代码检查
npm run lint
# 自动修复
npm run lint:fix-
Background Script调试
- 访问
chrome://extensions/ - 点击扩展的"背景页"链接
- 访问
-
Content Script调试
- 在微信读书页面按F12
- 查看Console面板的日志
-
Popup调试
- 右键扩展图标
- 选择"检查弹出内容"
统一的跨环境通信服务：
// 发送消息
await bridge.sendMessage(type, data, options);
// 注册处理器
bridge.on(type, handler);
// 广播消息
await bridge.broadcast(type, data);设置管理服务：
// 保存设置
await settingsService.saveProvider(provider);
await settingsService.saveAPIKeys(apiKeys);
// 加载设置
const provider = await settingsService.loadProvider();
const apiKeys = await settingsService.loadAPIKeys();AI聊天服务：
// 发送AI请求
const response = await chatService.sendMessage({
text: '要分析的文本',
type: 'explain', // 'explain' | 'digest' | 'analyze'
provider: 'doubao'
});- API Key加密存储：使用Chrome Storage API安全存储
- 本地数据处理：用户数据不上传到服务器
- 权限最小化：只请求必要的Chrome权限
{
"permissions": [
"storage", // 存储用户设置
"activeTab" // 访问当前标签页
],
"host_permissions": [
"https://weread.qq.com/*" // 微信读书域名
]
}# 生产构建
npm run build
# 打包为zip文件
npm run package- 访问 Chrome开发者控制台
- 上传打包后的zip文件
- 填写扩展信息和描述
- 提交审核
- Fork项目
- 创建功能分支：
git checkout -b feature/amazing-feature - 提交更改：
git commit -m 'Add amazing feature' - 推送分支：
git push origin feature/amazing-feature - 创建Pull Request
feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
test: 测试用例
chore: 构建过程或辅助工具的变动
- ✨ 新增设置页面全新 UI，支持多标签切换（模型配置/快捷键说明/关于项目）
- ✨ 新增 Kimi、MiniMax、智谱 三个 AI 服务商支持
- ✨ 助手面板支持快捷切换服务商（点击服务商按钮显示菜单）
- ✨ 新增服务商状态指示灯（绿色=正常/红色=失败/灰色=未配置）
- ✨ 新增首次使用引导提示
- 🔧 ESLint 配置升级至 ES2022，支持私有字段语法
- 🐛 修复多处代码规范问题
- 🎯 AI输出内容时正确响应手动进度条滚动，避免实时滚动
- 🎯 浮动模式下限制拖动响应区域
- 🐛 修复 inline 模式下每次复制都会触发页面刷新的bug
- 📝 修复 popup 初始状态错误
- ✨ 新增流式响应支持，AI回答实时显示
- 🚀 优化响应速度，提升用户体验
- 🔧 改进错误处理机制
- 🎨 界面细节优化和动画效果提升
- 📱 响应式设计改进
- ✨ 初始版本发布
- 🎯 三大AI功能：解释、消化、兼听
- 🔧 多AI服务商支持
- 🎨 智能面板系统
- ⌨️ 快捷键支持
- 支持更多AI服务商
- 用户自定义提示词
- 阅读笔记管理
- 多语言支持
- 移动端适配
本项目采用 MIT License 许可证。
- 作者：lagrangee@gmail.com
- 项目地址：https://github.com/lagrangee/weread_deepreading
- 问题反馈：https://github.com/lagrangee/weread_deepreading/issues
感谢以下开源项目：
⭐ 如果这个项目对你有帮助，请给个Star支持一下！