Memos Quick Note

一个用于快速添加笔记到 Memos 的浏览器扩展。这个扩展允许你快速捕捉灵感，保存网页内容，并使用 Memos 管理你的知识。

English Documentation

现已支持 Edge / Chrome / Firefox / Safari / Web

• Edge：可通过微软扩展商店下载安装
• Chrome / Firefox / Safari：可使用项目构建产物离线安装
• Web：可构建为 dist/web 后自行部署到服务器

v1.2.8 更新

• 重做编辑页、列表页、设置页样式，增强编辑区与工具区层次区分。
• 修复编辑页底部内容被固定高度遮挡的问题，编辑区高度改为自适应。
• 关闭插件后会记住上一次所在页面，可在设置中选择“记住上次页面 / 编辑器 / 列表”。
• 设置页新增主题跟随系统选项，默认主题改为跟随系统。
• 默认 API 版本改为 0.18。
• 调整设置页结构，移除“优先展示标签”设置项。
• 修复设置页下拉层级遮挡问题，补齐本地图标资源加载。
• 更新联系邮箱为 admin@aiti.xin。
• 新增 Chrome / Firefox 双生产包打包支持。
• 新增 Safari 临时安装测试打包支持，可生成 dist/safari 目录用于 macOS Safari 本地测试。

项目简介

Memos Quick Note - 您的智能笔记助手 快速捕捉灵感，轻松管理知识。支持 Memos v0.18/v0.24/v0.25/v0.26，多版本兼容，一键保存网页内容，智能标签补全，文件图片上传，自定义快捷键，个性化设置，让您的笔记体验更高效、更智能。

主要功能

编辑与记录

• 快速记录想法和笔记
• 支持 Markdown 格式
• 支持从网页选中文本快速保存
• 提供 Markdown 工具栏（标题、粗体、斜体、列表等）
• 支持实时字数统计
• 支持标签自动补全
• 支持快捷键操作

标签与附件

• 支持标签管理
• 支持文件上传（图片和文档）
• 支持拖拽上传文件
• 支持粘贴上传图片和文件
• 支持图片预览
• 支持文件删除
• 支持上传进度显示

列表与浏览

• 支持标签筛选
• 支持分页加载
• 支持编辑已有记录
• 支持按时间排序
• 支持展开和收起标签列表

设置与界面

• 支持 API 配置（主机地址和令牌）
• 支持默认可见性设置
• 支持自定义标签设置
• 支持快捷键开关
• 支持界面主题切换（跟随系统 / 亮色 / 暗色）
• 支持窗口尺寸调整
• 支持默认视图设置

同步与体验

• 支持响应式布局
• 支持暗色模式
• 支持标签缓存
• 支持平滑动画效果
• 与 Memos 服务器同步
• 支持 v18、v24、v25、v26 API
• 支持标签自动同步
• 支持设置本地存储
• 提供操作提示、错误处理、加载状态显示与自动保存恢复

安全相关

• 支持 API 令牌管理
• 支持可见性控制（公开 / 私有 / 登录可见）

使用方式

1. 点击浏览器工具栏中的扩展图标
2. 在编辑器中输入 memo 内容
3. 使用工具栏完成 Markdown 格式化
4. 使用 # 添加标签
5. 通过上传按钮添加图片或文件
6. 点击“保存”创建 memo

设置说明

你可以通过设置面板自定义使用体验：

基础设置

• Host URL 与 API Token 配置

内容设置

• 来源信息与引用格式选项

默认设置

• 默认可见性与自定义标签

快捷键设置

• 可自定义键盘快捷键

标签设置

• 标签输入行为与筛选样式

页面设置

• 默认视图与尺寸设置

其他设置

• 字数统计、主题与语言选项

示例图片

编辑页面

列表页面

设置页面

开发与打包

安装依赖

npm install

本地开发

npm run dev

生产构建

# 一次构建全部浏览器产物
npm run build

# 仅构建 Chrome / Edge
npm run build:chrome

# 仅构建 Firefox
npm run build:firefox

# 仅构建 Safari（macOS Safari 临时安装测试）
npm run build:safari

# 仅构建 Web 版本
npm run build:web

构建完成后会生成以下目录：

dist/chrome
dist/firefox
dist/safari
dist/web

构建校验

npm run verify:build

安装与测试

Chrome / Edge

1. 执行 npm run build:chrome
2. 打开浏览器扩展管理页
3. 开启“开发者模式”
4. 选择“加载已解压的扩展程序”
5. 选择 dist/chrome

Firefox

1. 执行 npm run build:firefox
2. 打开 Firefox 调试扩展页面
3. 临时加载扩展
4. 选择 dist/firefox/manifest.json

Safari（macOS 临时安装测试）

1. 执行 npm run build:safari
2. 打开 Safari，并开启开发相关选项
3. 按 Safari Web Extensions 的临时安装方式加载扩展目录
4. 选择 dist/safari
5. 安装并启用扩展后，测试弹窗、设置保存、选中文本导入等核心流程

Web（部署到自己的服务器）

1. 执行 npm run build:web
2. 将 dist/web 中的文件上传到你的静态站点目录
3. 用浏览器访问部署后的网页地址
4. 首次打开后，在设置页填写 Memos 的 Host 与 Token

Web 版本说明

Web 版本保留功能

• 手动录入 memo
• 标签选择与补全
• 文件 / 图片上传
• 设置保存
• 列表查看与编辑
• 主题、语言、窗口布局相关设置

Web 版本不包含的扩展专属功能

• 网页选中文本右键注入
• 后台脚本驱动的交互
• 内容脚本注入
• 扩展图标弹窗式打开

Web 部署注意事项

• 如果网页站点与 Memos 服务不在同一域名下，需要服务端允许跨域访问
• 建议使用 HTTPS，避免上传、认证或跨域请求被浏览器限制

参与贡献

欢迎提交 Issue 或 Pull Request 来帮助改进这个项目。

许可证

本项目采用 MIT 许可证，详情见 LICENSE。

致谢

• 感谢 GitHub 网友 tianshubenshu 完成 Memos 0.26 版本支持。

联系方式

• 邮箱：admin@aiti.xin