NotesAnywhere

NotesAnywhere 是一个面向 Chrome 和 Edge 的本地优先悬浮便条扩展。它会在普通网页中显示一张活动便条，并允许用户在多张本地便条之间切换。

扩展支持白名单或黑名单显示范围，以及全局统一或标签页独立布局。便条数据始终同步，后台标签页则在重新可见时按需加载，详细规则见 docs/SYNC_AND_SITE_POLICY.md。

便条正文上方的标题栏可以直接编辑；标题会自动保存，并同步成为便条列表中的名称。新建便条后会自动选中默认标题，直接输入即可命名。

便条支持从四条边和四个角调整大小；拖动任一边缘时，对侧边缘保持固定。

扩展计划提供三种网页渲染方式：

• 兼容模式：使用普通 DOM，优先兼容划词翻译等页面工具。
• 平衡模式：使用 Open Shadow DOM，减少网站样式干扰。
• 保护模式：使用扩展 iframe，优先隔离网页脚本与样式。

开发约定

• 目标浏览器：Chrome、Edge 桌面版。
• 扩展标准：Manifest V3。
• 数据范围：仅通过浏览器扩展本地存储保存。
• 提交信息：遵循 Conventional Commits，主题使用中文。
• 问题日志：见 docs/ISSUES.md。

本地检查

npm test
npm run test:browser

npm run test:browser 会优先使用本机 Edge、回退到 Chrome，并创建一次性临时浏览器配置，自动验证三种渲染模式、真实输入保存和网页 DOM 篡改恢复。

在 Chrome 或 Edge 中加载

1. 打开 chrome://extensions 或 edge://extensions。
2. 开启“开发者模式”。
3. 选择“加载已解压的扩展程序”。
4. 选择本项目根目录。
5. 打开普通 HTTP/HTTPS 网页，通过扩展弹窗临时显示便条，或将网站加入默认显示规则。

新安装默认采用“白名单 + 标签页独立布局”：网页不会自动加载便条；点击扩展图标后，可选择只在本页临时显示，或把当前网站保存为默认显示。临时状态在刷新或导航后失效，网站规则会保存在本机。

默认快捷键 Ctrl+Shift+Y 用于临时显示或隐藏当前页面的便条。扩展弹窗还可切换当前标签页的临时渲染模式；完整设置页可以选择全局/标签页布局、白名单/黑名单策略，手动编辑域名规则并管理网站渲染模式。

网站规则一行一条：example.com 仅匹配该主机，*.example.com 仅匹配子域名。输入完整网址也可以，保存时会自动去除协议、端口和路径。详细的优先级、会话生命周期与资源策略见 docs/SYNC_AND_SITE_POLICY.md。

数据说明

便条及持久设置保存在 chrome.storage.local 中，标签页独立布局保存在 chrome.storage.session 中，均不会上传到服务器。关闭标签页或重启浏览器会清除相应的独立布局；卸载扩展会删除浏览器保存的扩展数据，V1 暂不提供导入导出。