Web Notes

Highlight and annotate any web page. Notes sync across devices via cloud storage.

Web Notes 是一款轻量、开源、本地优先的网页标注 Chrome 扩展（需要 Chrome 122+）。 选中文字、右键高亮、随手写 Markdown 笔记。所有数据默认保存在浏览器本地 IndexedDB 中，无需注册登录，也不依赖开发者服务器。 开源地址：https://github.com/lhh-pi/web-notes ━━━━━━━━━━━━━━━━━ 🎯 核心功能 ━━━━━━━━━━━━━━━━━ 📝 高亮标注 选中文字后通过右键菜单快速创建高亮，支持黄、绿、蓝、红 4 种颜色，以及纯高亮、高亮并添加笔记、自选颜色三种操作。 ✍️ Markdown 笔记 点击高亮区域即可编辑笔记，支持 Markdown 实时预览，并在停止输入约 800ms 后自动保存。 📍 稳定定位，不丢笔记 综合使用文字内容、上下文、文档位置和 XPath 恢复高亮。只有确认位置可靠时才会重新显示高亮，避免把笔记错误地放到相似句子上。 如果网页内容发生变化、动态内容尚未加载或无法可靠定位： • 笔记仍会完整保留在侧边栏 • 原始引用、笔记内容、颜色和时间不会丢失 • 不会为了定位失败而自动删除笔记 • 可以稍后重试，或使用“重新绑定”选择新的文字位置 🔗 手动重新绑定 未定位的笔记可以重新选择网页文字并绑定。重新绑定会保留笔记 ID、内容、颜色和创建时间，只更新引用文字和定位信息。 🌐 支持动态网页与单页应用 能够识别页面内部导航和 URL 变化，切换页面时自动清理旧高亮并加载新页面笔记。扩展更新或重新加载后，旧网页会提示刷新，以避免在失效环境中继续操作。 🔍 全局搜索 跨网站搜索高亮文字、笔记内容、页面标题和 URL，支持 300ms 防抖即时搜索。 📂 分类管理 侧边栏提供四个主要页面： • This Page：查看当前网页的全部笔记 • All Notes：按网站和页面分组管理笔记 • Search：跨网站全文搜索 • Trash：查看和恢复最近删除的笔记 支持单条、单页和整域名批量删除。删除后列表和当前网页高亮会立即刷新。 🗑️ 7 天回收站 所有常规删除都会先进入回收站： • 7 天内可以恢复 • 支持单条恢复 • 支持单条或批量永久删除 • 支持清空回收站 • 页面和域名批量删除同样可以恢复 超过 7 天或永久删除后，笔记正文会被清除，同时保留最小删除记录，用于防止旧电脑或旧同步文件将已经删除的笔记重新恢复。 🌓 暗色模式 自动跟随系统主题，也可以手动切换；主题设置会在本机持久保存。 ━━━━━━━━━━━━━━━━━ ☁️ 文件同步 ━━━━━━━━━━━━━━━━━ 可使用 OneDrive、iCloud Drive 或其他本地同步目录中的 JSON 文件，在多台电脑之间同步笔记。 首次使用时可以先导出 JSON 文件，将它放入云盘同步目录，然后在侧边栏选择该已有文件。 支持三种模式： • Auto：本地修改后约 1.5 秒自动合并写入，并定期检查外部文件变化 • Manual：仅在点击 Sync Now 时进行双向同步 • Off：关闭文件同步，本地笔记功能仍可正常使用 同步采用保守的 newer-wins 合并策略，并使用串行任务队列，避免多个读写任务同时修改文件。 写入完成后会重新读取文件进行验证。同步失败、权限不足或文件暂时不可用时，本地修改会保留为“等待同步”，不会自动切换为 Off。 切换同步文件时会等待旧任务结束，并确保新文件先读取、合并，再写入，避免读写到不同文件。 如果同步文件损坏或来自扩展无法识别的更高版本，Web Notes 不会覆盖原文件。 Chrome 122+ 在符合条件时可能提供跨浏览器重启的文件访问权限。如果浏览器仍要求重新授权，可以按照侧边栏提示恢复文件访问；这不会影响本地笔记。 说明：Web Notes 使用用户选择的本地文件进行同步，不会直接登录或连接 OneDrive/iCloud API。云端传输由电脑上的 OneDrive、iCloud Drive 等同步客户端负责。 ━━━━━━━━━━━━━━━━━ ⬇️ 备份与数据管理 ━━━━━━━━━━━━━━━━━ • 导出 JSON：生成完整的本地数据备份 • 导入 JSON：与现有数据进行合并 • JSON v2：写入新版安全格式，同时兼容读取旧版 v1 文件 • Move all notes to Trash：将全部笔记移入回收站，可在 7 天内恢复 • Reset this browser：仅清除此浏览器中的笔记、同步配置和文件引用，不修改同步 JSON，也不影响其他电脑 如果重置后重新连接原来的同步 JSON，文件中的笔记会再次导入当前浏览器。 危险的数据管理功能默认折叠，并通过醒目的确认界面防止误触。 ━━━━━━━━━━━━━━━━━ 🔒 隐私与数据 ━━━━━━━━━━━━━━━━━ • 所有笔记默认保存在浏览器本地 IndexedDB • 可选同步数据只写入用户主动选择的 JSON 文件 • 不上传到开发者服务器 • 不收集用户信息 • 不跟踪浏览记录 • 不需要注册或登录 • 标注、笔记、搜索和本地管理功能可离线使用 • 项目完全开源，采用 MIT License 开源地址：https://github.com/lhh-pi/web-notes ━━━━━━━━━━━━━━━━━ ENGLISH ━━━━━━━━━━━━━━━━━ Web Notes is a lightweight, open-source, local-first Chrome extension for web page annotation. Chrome 122 or later is required. Select text, right-click to highlight it, and attach Markdown notes. Your data is stored locally in the browser’s IndexedDB by default—no account, tracking, or developer-operated server is required. Open source: https://github.com/lhh-pi/web-notes 🎯 KEY FEATURES 📝 Text highlighting Highlight selected text from the context menu using four colors: yellow, green, blue, and red. Choose between highlight only, highlight with a note, or a custom color. ✍️ Markdown notes Click a highlight to edit its note with live Markdown preview. Changes are automatically saved after approximately 800ms of inactivity. 📍 Conservative highlight recovery Web Notes uses selected text, surrounding context, document position, and XPath candidates to restore highlights. A highlight is rendered only when its position can be verified. If the page changes or the text cannot be located reliably: • The note remains visible in the sidebar • Its text, note, color, and timestamps are preserved • It is never deleted because positioning failed • You can retry later or manually rebind it 🔗 Manual rebind Select new text on the page to repair an unresolved highlight. Rebinding keeps the note ID, content, color, and creation time while updating only its quotation and anchor. 🌐 Dynamic-page support Web Notes detects URL changes in single-page applications, removes stale highlights, and loads notes for the new page. After the extension is updated or reloaded, older open tabs display a refresh notice. 🔍 Full-text search Search across highlighted text, notes, page titles, and URLs with responsive debounced results. 📂 Organized note management The sidebar includes: • This Page • All Notes • Search • Trash Notes are grouped by domain and page. Individual notes, complete pages, and entire domains can be moved to Trash. 🗑️ Seven-day Trash All normal deletions are moved to Trash first: • Restore notes within seven days • Restore individual notes • Permanently delete one or multiple notes • Empty the entire Trash • Recover page-level and domain-level deletions After seven days—or after permanent deletion—the note payload is removed while a minimal deletion marker is retained to prevent stale devices or files from restoring deleted notes. 🌓 Dark mode Automatically follows the system theme, with a persistent manual override. ☁️ FILE SYNC Synchronize notes through a JSON file stored in OneDrive, iCloud Drive, or another locally synchronized folder. For initial setup, export a JSON file, place it in your cloud-sync folder, and select that existing file from the sidebar. Available modes: • Auto: merges and writes local changes after approximately 1.5 seconds and periodically checks for external updates • Manual: performs two-way synchronization only when you click Sync Now • Off: disables file synchronization while keeping all local features available Synchronization uses a conservative newer-wins merge strategy and a single serialized task queue. After writing, Web Notes reads the file back to verify the result. If access is unavailable or synchronization fails, local changes remain safely marked as pending instead of being discarded or switching the mode to Off. File switching is protected so the previous task finishes before the new file is read, merged, and written. Corrupted or unsupported newer JSON files are never overwritten automatically. Chrome 122+ may offer persistent file access when supported. If Chrome requests access again, use the restore-access prompt in the sidebar. Local notes remain available without file permission. Web Notes does not connect directly to the OneDrive or iCloud API. Cloud transfer is handled by the OneDrive, iCloud Drive, or other synchronization software installed on your computer. ⬇️ BACKUP AND DATA MANAGEMENT • Export a complete JSON backup • Import and merge existing data • Writes the safer JSON v2 format while remaining compatible with v1 files • Move all notes to Trash • Reset only the current browser without modifying the synchronization file or other computers Reconnect the same JSON after a local reset if you want to import its notes again. 🔒 PRIVACY • Notes are stored locally in IndexedDB • Optional synchronization writes only to a file selected by the user • No developer-operated servers • No tracking or personal-data collection • No login required • Core annotation, note, search, and management features work offline • Open source under the MIT License Open source: https://github.com/lhh-pi/web-notes