学城笔记插件

1. 简介

学城笔记浏览器插件是一款帮助用户快速将网页内容、学城文档、多维表格以及学城空间批量导入到学城笔记笔记本中的效率工具。

2. 核心功能

2.1 支持的页面类型

插件能够自动识别当前浏览器标签页的类型，并提供相应的导入策略：

学城单篇文档/多维表格：自动提取文档 ID，支持一键导入。

学城空间：自动识别空间 ID，支持深度解析空间目录树，将空间下的所有文档批量导入。

普通网页：支持将外部普通网页（如技术博客、新闻文章等）抓取并导入为笔记来源。

2.2 智能拦截与提示

内部域名拦截：由于抓取工具的限制，插件会自动拦截美团内部域名（*.sankuai.com，学城 km.sankuai.com 除外）的普通网页导入，并给出明确提示：“暂不支持直接添加美团内部网页（学城除外），因无法获取内容”。

无效页面提示：如果当前页面既不是学城文档也不是普通网页（例如浏览器设置页、空白页等），插件会提示“当前页面不是有效的网页或学城文档”。

2.3 笔记本选择

插件打开时会自动调用接口获取用户在 学城笔记中创建的笔记本列表。

用户可以在下拉菜单中选择目标笔记本。

如果未登录 SSO 或未创建笔记本，插件会给出相应的错误提示。

2.4 导入结果反馈

成功提示：导入成功后，插件会显示实际成功添加的篇数，并提供**“去笔记中查看”**的快捷跳转链接，点击即可直接在 学城笔记 中打开对应的笔记本。

超限提示：如果批量导入触发了数量上限截断，成功提示中会包含相应的警告信息。

错误处理与超时机制：

针对网页抓取和批量导入等耗时操作，插件内置了超时控制（普通网页和批量导入为 120 秒，目录解析为 60 秒）。

发生超时时，会明确提示“请求超时，请重试”。

发生其他业务错误时，会提取接口返回的错误信息（支持 message、msg、error 字段）并展示给用户，同时在浏览器控制台打印详细日志供排查。