Skip to content

DreamBoy12/Mnemra

Repository files navigation

Mnemra

Mnemra 设置中台

Every conversation, a new connection in your second brain.

Mnemra 是一款面向 AI 对话和网页资料的 Chrome 知识剪藏扩展。它将 ChatGPT、DeepSeek、Gemini 以及普通网页中的有价值内容,一键整理为结构化飞书云文档。

Mnemra 是你与 AI 之间的记忆桥梁:捕捉每一次有价值的对话,将它们编织成属于你自己的知识神经网络。

产品理念

AI 对话正在成为新的思考界面,但很多高价值内容仍然散落在临时窗口、历史记录和收藏夹里。Mnemra 试图解决这件小而长期的问题:让每一次值得留下的 AI 交流,都能进入一个可回看、可检索、可连接的知识系统。

它不是一个复杂的知识库平台,而是一个轻量的“知识摄入层”:

  • 捕捉:从当前页面提取 AI 对话或网页正文。
  • 整理:用大模型生成标题、摘要和归档判断。
  • 沉淀:写入飞书文档,并保留来源、排版、日志和失败兜底。

核心功能

AI 对话剪藏

深度适配主流 AI 对话页面:

  • ChatGPT:按用户与回答区分角色,支持完整对话或最新一轮保存。
  • DeepSeek:提取回答内容,支持页面中存在的 reasoning 内容。
  • Gemini:提取 User / Gemini 对话内容。

保存到飞书后,文档会保留角色层级:用户提问作为标题,提问内容进入浅蓝色高亮块;回答内容保持普通正文结构,便于快速浏览。

普通网页剪藏

对博客、文档、新闻、技术文章等普通网页,Mnemra 会使用正文解析策略提取主要内容,并转换为飞书 Block 写入。

三种保存模式

  • 最新一轮:只保存最后一轮问答,适合快速收藏单个回答。
  • 全量保存:保存当前页面可解析的完整内容。
  • 选择内容:在页面上手动点选要保存的对话块或内容块,适合只保留部分高价值片段。

智能保存与手动保存

默认开启智能保存:

  • 大模型生成文档标题。
  • 大模型生成重点摘要。
  • 根据目标文件夹列表自动选择飞书目录。

关闭智能保存后,可以手动选择飞书文件夹并配置文件名,适合需要精确控制归档位置的场景。

飞书文档排版

保存后的飞书文档会自动包含:

  • 来源 URL,放在文档开头,便于回到原页面。
  • AI 摘要高亮块,重点用红色标明。
  • 用户提问浅蓝高亮块,提问内容加粗。
  • Markdown 标题、列表、引用、代码块、表格的可读转换。
  • 截图兜底内容,解析失败时保存当前可见区域截图。

保存状态与历史记录

  • 页面内浮窗展示保存进度:提取、整理、写入、完成。
  • 保存成功后提供飞书文档链接,并自动关闭状态浮窗。
  • 设置中台提供历史记录,记录来源 URL、文档 URL、保存配置、日志和成功/失败状态。

安全与架构

Mnemra 采用 BYOK 模式:

  • 大模型 API Key 由用户自己提供。
  • 飞书应用由用户自己创建并授权。
  • 配置、Token 和历史记录保存在浏览器本地 chrome.storage.local
  • 当前版本扩展直连飞书 OpenAPI,无需部署额外服务端。

界面预览

设置中台

Mnemra 设置中台

保存弹窗

Mnemra 保存弹窗

选择模式

Mnemra 选择模式

飞书文档效果

Mnemra 飞书文档效果

快速开始

1. 安装依赖并构建

npm install
npm run build

构建完成后,产物位于:

build/chrome-mv3-prod/

2. 加载 Chrome 扩展

  1. 打开 Chrome,访问 chrome://extensions
  2. 打开右上角“开发者模式”。
  3. 点击“加载已解压的扩展程序”。
  4. 选择 build/chrome-mv3-prod/
  5. 将 Mnemra 固定到浏览器工具栏。

Edge 用户可访问 edge://extensions,加载方式相同。

首次配置

点击浏览器工具栏中的 Mnemra 图标,进入设置中台。

大模型配置

填写你的 OpenAI Compatible API 配置:

配置项 说明
Provider 选择 OpenAI 或 Custom
API Key 大模型 API Key
Base URL API 服务地址,例如 https://api.openai.com/v1
Model 模型名称,例如 gpt-4o-mini
Temperature 建议 0.1

支持 OpenAI、DeepSeek、通义千问、Moonshot、Groq、Ollama,以及其他兼容 OpenAI Chat Completions 协议的服务。

飞书配置

  1. 打开飞书开放平台,创建企业自建应用。
  2. 记录应用的 App IDApp Secret
  3. 在权限管理中添加并发布以下权限:
docx:document
docx:document:create
docx:document:write_only
docs:document.media:upload
drive:file:upload
offline_access
  1. 在 Mnemra 设置页复制“当前扩展 Redirect URL”。
  2. 到飞书应用后台的“开发配置 > 安全设置”中,将 Redirect URL 加入回调地址白名单。
  3. 回到 Mnemra 设置页,填写 App ID、App Secret 和默认收件箱 Folder Token。
  4. 点击“连接飞书账号”,完成 OAuth 授权。
  5. 点击“测试飞书连接”,确认授权可用。

如果新增或修改了飞书权限,需要在飞书开放平台重新发布应用,并在 Mnemra 中断开后重新连接飞书账号。

文件夹管理

在“飞书文件夹管理”中添加常用目标目录:

字段 说明
文件夹名称 给 AI 判断用的语义名称,例如“AI 研究”“技术文章”“产品设计”
Folder Token 飞书文件夹 URL 中的 folder token

智能保存时,Mnemra 会在这些候选文件夹中选择最匹配的目录。无法判断时,会保存到默认收件箱。

解析策略

建议保持默认:

  • 保存摘要:开启。
  • 截图兜底:开启。
  • 运行状态文字:按个人偏好开启或关闭。

日常使用

保存当前页面

  1. 打开 ChatGPT、DeepSeek、Gemini 或任意网页。
  2. 点击 Mnemra 扩展图标。
  3. 选择“最新一轮”“全量保存”或“选择内容”。
  4. 选择是否智能保存。
  5. 点击保存。

保存过程中,页面右下角会显示进度浮窗。完成后可以直接打开生成的飞书文档。

使用选择模式

选择模式适合只保存部分内容:

  1. 在弹窗中选择“选择”。
  2. 点击“选择内容”。
  3. 鼠标移动到页面中,Mnemra 会优先框选整条对话或完整内容块。
  4. 点击需要保存的内容块,可多选。
  5. 点击页面底部工具条的“保存选中”。

查看历史记录

进入设置中台的“历史记录”,可以查看每次保存的:

  • 来源 URL。
  • 飞书文档 URL。
  • 保存模式、智能保存配置和解析策略。
  • 过程日志。
  • 成功或失败状态。

开发命令

npm run dev          # 启动 Plasmo 开发模式
npm run build        # 构建生产版扩展
npm run package      # 打包扩展
npm run type-check   # TypeScript 类型检查

本地开发时通常加载:

build/chrome-mv3-dev/

生产使用时加载:

build/chrome-mv3-prod/

常见问题

保存时报飞书权限错误

如果看到 UnauthorizedAccess denied 或缺少 docx:documentdocx:document:create 等提示,请检查:

  1. 飞书开放平台是否添加了 README 中列出的权限。
  2. 权限变更后是否重新发布应用。
  3. Mnemra 是否已经断开并重新连接飞书账号。

保存后找不到文档

请确认:

  1. 默认收件箱 Folder Token 是否正确。
  2. 当前飞书账号是否对目标文件夹有编辑权限。
  3. 历史记录中生成的文档 URL 是否可打开。

AI 分类不准确

可以优化目标文件夹名称,让它更有语义,例如用“前端工程”“AI 论文”“产品增长”,不要用“文件夹 1”“资料”等模糊名称。Temperature 建议保持 0.1

解析失败怎么办

保持“截图兜底”开启。普通 DOM 提取失败时,Mnemra 会尝试保存当前可见区域截图到飞书文档中。

我的密钥保存在哪里

大模型 API Key、飞书 App ID、App Secret、OAuth Token 和配置项都保存在浏览器本地 chrome.storage.local。请只在可信设备上使用。

项目结构

src/
  background/        # 保存编排、LLM 路由、飞书 OpenAPI 客户端
  contents/          # 页面内容提取、选择模式、状态浮窗
  lib/               # Markdown 转飞书 Block、存储、常量
  types/             # 配置、消息、历史记录类型
  popup.tsx          # 扩展弹窗
  options.tsx        # 设置中台
docs/                # 使用说明、开发文档与截图
mnemra_landing.html # 品牌落地页草稿

延伸文档

版本状态

当前版本:1.0.0

1.0.0 聚焦“可稳定保存、可读性良好、配置可自助完成”的闭环。后续可以继续扩展模板策略、多空间管理、双向同步和更丰富的知识网络能力。


Mnemra 1.0.0 · 扩展直连飞书 · BYOK · Local-first

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors