流光笔记
首页

📖 FlashNote 用户使用手册

欢迎使用 FlashNote (流光笔记)！本手册将帮助您快速熟悉侧边栏双轨创作工作台、Tiptap 富文本编辑器、Mermaid 交互图表、KaTeX 数学公式以及网盘差量同步的完整工作流。

🚀 一、 快速入门

1. 唤起侧边栏与快捷键

  • 侧边栏常驻：点击浏览器右上角插件栏的 FlashNote 图标，或在 Chrome 侧边栏面板中选择 FlashNote；
  • 闪电呼出：按下默认全局快捷键 Command+Shift+F（Mac）或 Ctrl+Shift+F（Windows），即可秒级唤起极速速记弹窗。

2. 双轨工作区切换

  • 独立速记 (Notes)：适合日常随手记录临时想法、会议备忘、常用代码片段与待办清单；
  • 书籍专栏 (Books)：适合编写多章节书籍、系统课程大纲或深度技术专著；
  • 点击顶部导航图标即可在速记与书籍专栏之间无缝切换。

✍️ 二、 编辑器模式与排版体验

1. 4 种视界形态

  • 可视化模式 (Visual)：所见即所得。直接在输入时呈现富文本排版；
  • 双栏对照 (Split)：左侧富文本编辑，右侧同步显示纯文本 Markdown 源码；
  • Markdown 源码 (Source)：原生纯文本敲击体验，快捷语法自动闭合；
  • 纯网页预览 (Preview)：模拟最终读者排版，超链接可直接安全点击。

2. 代码块与语法高亮

  • 在编辑器中输入 ``` 即可创建代码块；
  • 代码块右上角提供语言切换下拉列表与一键复制代码按钮，左侧附带不可选中的防复制行号。

📐 三、 数学公式与 Mermaid 图表

1. KaTeX LaTeX 公式

  • 行内公式：输入 $E=mc^2$，光标离开后即刻完成渲染；
  • 块级公式：输入 $$ 回车，或点击工具栏的公式图标唤起专用公式编辑器；
  • 弹窗内支持常用符号快捷点击插入与毫秒级实时渲染预览。

2. Mermaid 图表全功能套件

  • 在代码块中选择 mermaid 语言，输入流程图或时序图代码，即可实时渲染可视化图表；
  • 画布平移：鼠标指针悬停于图表上将切换为小手光标，按住左键自由拖动画布；双击画布任意区域立即居中复位；
  • 全屏灯箱：点击图表右上角的放大镜图标，即可进入 94vw × 88vh 沉浸式大图视界，支持 30%～350% 无级缩放；
  • 高清导出：点击导出按钮，支持导出矢量 SVG 或 2x 视网膜高清 PNG（带 24px 呼吸边距与纯白底色）。

🚀 四、 博客直通实战：把 FlashNote 作为 MagicNote 静态站专用编辑器

FlashNote 不仅是个人灵感速记本，更原生设计为现代技术博客（如基于 VitePress 深度定制的个人开源博客主题 MagicNote）的现代化可视化写作与发布中枢。

1. 为什么需要博客直通？

  • 告别繁琐的手工流：传统静态博客维护必须依赖本地终端、手动创建文件、手敲易错的 YAML 属性头、费力拷贝插图；
  • 侧边栏随时随地开写：无论在查阅资料、看技术文档还是日常浏览，随时唤起 FlashNote，利用 Tiptap 富文本排版、Mermaid 图表与 KaTeX 公式畅快写作，一键直通编译即可无缝交给 MagicNote 构建上线。

2. 启用博客直通目录

  1. 在 FlashNote 中进入“设置” -> “目录与分类管理”；
  2. 为您打算公开发布的物理目录（如 tech、life、notes）开启 【博客直通】 开关；
  3. 未开启直通的私有目录（如 private）将保持绝对物理隔离，编译时自动拦截，杜绝私密笔记误公开。

3. FrontMatter 自动化与高级字段映射

在撰写文章时，您无需手动编写 YAML 头，FlashNote 会在直通编译时自动注入标准 5+ 要素元数据：

  • 标题 (title) 与 永久链接 (slug)：在文档属性面板中配置英文或拼音 Slug，生成整洁美观的永久链接（如 posts/tech/modern-frontend-arch.md）；
  • 分类 (category) 与 标签 (tags)：直接在界面中打标签与选分类，自动与 MagicNote 的分类页面（/pages/category）与标签归档（/pages/tags）无缝对接；
  • 加权置顶 (order)：在笔记属性中设置大于 0 的数值（如 order: 9），MagicNote 编译期将自动倒排置顶并在首页标题前呈现 📌 图钉；
  • 导读摘要 (description)：支持富文本与原生 Markdown 语法，自动重写相对资源路径，进入文章正文详情页时智能规避重复首屏大图。

4. 伴生配图与 Mermaid 架构图规范

  • 在 FlashNote 中插入的配图或导出的 Mermaid 流程图，直通编译时会自动规整到专属伴生目录（如 posts/{folder}/{slug}/）；
  • 严格遵循 MagicNote 的内容资产权责隔离规范，不污染 public/ 开发者全局目录，由静态博客资产管道直接编译分发。

5. 编译发布与自动化上线闭环

  1. 本地快速导出：点击顶部工具栏的【博客直通】按钮，可直接将当前文章或整目录一键打包为符合 MagicNote 规范的压缩包，解压放入博客项目的 posts/ 目录；
  2. 云端网盘直通：结合网盘同步，FlashNote 可直接将编译产物输出至同步目录的 posts/ 结构下，配合 Webhook 或 CI/CD（如 Azure DevOps / GitHub Actions），远端拉取后自动触发 pnpm build，实现从浏览器侧边栏到公网生产环境（如 blog.aicro.net）的自动化极速切流。

☁️ 五、 百度网盘差量云同步

1. 绑定与授权

  • 进入“设置” -> “云同步设置”，按照指引完成百度网盘授权绑定；
  • 所有同步数据均严格保存在您的个人网盘 /apps/flashnote/ 专属目录下。

2. 差量分卷上传

  • 引擎自动针对每个书籍章节进行分卷切片与 SHA-256 哈希指纹比对，仅上传发生改动的章节；
  • 同步完成后，云端将自动生成一份完整的单体长篇电子书 ${safeBookName}.md 与结构规范的 SUMMARY.md。

🌐 六、 全局智能网页剪藏与灵感捕获

1. 右键上下文剪藏

  • 浏览任意网页时，点击鼠标右键选择 FlashNote 菜单项：
    • 剪藏网页正文：智能剥离导航条、侧边广告与页脚，提取核心文章内容存入速记；
    • 剪藏选中文本：划词选中网页精彩段落，一键保存至流光笔记；
    • 剪藏链接 / 图片：右键点击网页链接或图片，自动提取并存入笔记。

2. 动态保存气泡与溯源

  • 轻量原生 Web Toast：剪藏成功后，网页右上角立即浮现精致动效保存气泡，无需申请操作系统通知权限；
  • 智能溯源链接：每条剪藏笔记均自动记录原始网页标题与 URL，方便日后随时回溯出处；
  • 自动展开定位：在设置中开启“剪藏时自动打开侧边栏”，保存后侧边栏将平滑滑出并聚焦刚刚生成的笔记。

🤖 七、 AI 智能创作助手使用与配置

1. AI 引擎接入

进入“设置” -> “AI 助手设置”，支持自由选择与编排端云大模型：

  • Chrome 内置端侧 AI (Gemini Nano)：完全离线运行、零网络延迟且 100% 本地隐私安全；
  • Google Gemini API：输入 Google AI Studio 申请的官方 API Key，直接调用 Gemini 1.5 / 2.0 Flash 等最新模型；
  • 自定义 OpenAI 兼容接口：支持接入任何遵循 OpenAI 规范的第三方模型端点。

2. 独立浮动助手操作

  • 在编辑器中点击顶栏 AI 图标呼出浮动助手面板；
  • 自由拖拽与缩放：按住面板顶栏可自由拖拽位置，拖动右下角可无级缩放面板尺寸；
  • 开箱即用写作指令：支持一键文本润色、语法修正、中英日多语言学术翻译、文章要点总结、大纲扩写与自由自定义 Prompt；
  • 一键采纳：生成结果支持【追加至正文】、【替换选中内容】或【一键复制】。

📊 八、 产品与数据分析偏好 (Google Analytics 4)

1. 匿名度量说明

  • FlashNote 集成 Google Analytics 4 Measurement Protocol，用于了解冷启动耗时、格式化工具采纳率与整体运行健康度，帮助开发者持续优化性能；
  • 100% 隐私脱敏：绝不监控打字按键，绝不读取笔记正文与个人信息，仅上报脱敏的时间分箱与功能频次。

2. 用户自主控制 (一键关闭)

  • 进入“设置” -> “产品与数据分析”；
  • 随时取消勾选【启用 Google Analytics 4 匿名分析】复选框；
  • 关闭后，扩展将立即停止发送一切遥测与分析事件，完全遵从您的隐私偏好。

📬 九、 反馈与技术支持

如果您在使用过程中遇到任何问题或有新功能建议，欢迎随时与我们联系：