ShuyoNote 上手指南：先试用，再谈它好在哪

想先看一眼再决定装不装：浏览器里就能试（下面两条链接）。 这篇讲清楚三件事——在哪试、它好在哪、有哪些能力；想自己编译的看仓库 README。

在线试用

无需安装，直接在浏览器里体验：

• 国际 / GitHub Pages：https://shuyonote.github.io/ShuyoNote/
• 国内 / 自托管主站：https://shuyo.cn/app/

Web 版与桌面版共用同一套前端与数据模型（浏览器端本地优先、离线可用，用 sql.js + IndexedDB）。多设备 / 团队同步需在桌面版配置自建 shuyonote-sync-server 后使用。

为什么选 ShuyoNote

• 数据是你自己的：数据全部保存在本机 SQLite，离线可用、无需注册、无云端依赖；支持 Markdown 导出 / 整库备份 / 单空间导出，随时带走。本地优先、数据主权是它的根。
• 不只是笔记，是知识工作台：块编辑器 + 属性数据库（8 视图：表格 / 画廊 / 看板 / 日历 / 时间轴 / 目录 / 原生甘特图）+ 块级引用 / 关系图 + 双向链接；内置 PDF 批注 · 本地 OCR · AI 视觉识别 · AI 目录。
• 内置网盘：文件夹即网盘——批量上传超大文件（流式）、文件管理页（类型 / 大小 / 时间）、文件引用到页面（文件卡片 / 系统打开）、同名文件历史版本；内容寻址去重存储。
• 安全可靠，不只是"记一下"：自动保存 + 版本历史（可回滚）+ 回收站；端到端加密（Argon2id + XChaCha20-Poly1305，口令解锁/锁定）；存储管理 / 清理。
• AI 可选、本地优先：可接本地 Ollama / OpenAI 兼容端点，默认关闭（隐私）；语义检索 + 流式内联起草 + 侧边栏问答 + 思考过程流式。
• 独有的邮箱聚合：打通多账号 IMAP，邮件即笔记——聚合收件箱、按账号/月份筛选、一键存为笔记 / 任务、AI 总结。
• 免费 + 开源：核心功能永久免费；客户端 AGPL-3.0 开源，插件、主题、模板可扩展。
• 可自托管、多设备同步：多设备 / 团队同步用自建 shuyonote-sync-server（无云锁定，可私有部署）；outbox 增量 + 服务端 seq 基准的 LWW 合并（多端同时改同一内容也不丢改动）。
• 全平台：桌面（Tauri + Rust）+ 浏览器（Web）同一套前端；同一份数据多端可用。安卓 / iOS 移动端即将推出（M16 平台无关核心 + 可插拔平台壳，浏览器 PWA 已作为首个 Web 壳）。

特性

编辑体验

• 块编辑器：基于 Lexical，支持标题、引用、Callout、代码块、列表、待办、表格、分隔线等 12 种块类型。
• 「+」插入块（飞书式）：光标悬停在空块时，该块左侧出现内联「+」，点开即弹出飞书式分组插入面板（基础 / 列表 / 媒体 / 嵌入 / 引用，图标 + 名称 + 顶部可搜索），点某项即在该空块处插入对应块；面板右上置顶「AI 帮我写」入口。非空块显示 ⋮⋮ 拖拽手柄（空块显示 +、非空块显示 ⋮⋮，两者同位、中心对齐）。已取代旧版顶栏「+」按钮。
• 分栏（飞书式）：N 列并排（2–4 栏，/分栏 或「+」菜单的分栏项插入，选栏数 2/3/4）；每列是独立子编辑器——独立输入与独立撤销（HistoryPlugin），互不影响；列内 / 可插标题/正文/引用/Callout/列表/表格/代码块/分隔线；列右上角 ＋/× 增删列（insertColumnAt 末尾追加），列间手柄拖拽调整列宽并实时显示各列占宽百分比（最大余数法恒 100%）；列内空行悬停「+」插入块（220ms 驻留防闪现）；支持深色模式、随主题变色、列内容并入全文搜索与 Markdown 导出。
• 斜杠菜单：输入 / 快速插入任意块（含 /引用块、/嵌入块）。
• 块拖拽排序：悬停块左侧出现 ⋮⋮ 手柄，拖拽实时显示插入指示线，松手重排。
• 块多选：点击 ⋮⋮ 手柄选中块（Shift 选连续范围），批量操作条「复制 / 删除」，Delete/Esc 快捷键，选中块高亮。
• 表格交互：悬浮工具栏（增删行列 / 表头行列切换 / 对齐 / 背景色）+ 列宽拖拽调整 + 单元格选区高亮。
• 图片粘贴：截图 / 复制图片直接粘贴，内容寻址（SHA-256）去重存储。
• 网址书签：/wzsq 或 /bookmark 插入 URL 为书签卡片（自动抓取 Open Graph 标题 / 摘要 / 预览图）；粘贴纯网址可一键「转换为网址书签」；预览图复用附件内容寻址存储。
• 文件附件：通用文件附件（多选导入、超大文件流式存取、打开 / 定位 / 移除）。
• Markdown：快捷键输入、一键导入 / 导出、导出 HTML。
• 数学公式：块级 /公式（或 $$…$$）与行内 $…$，渲染为 KaTeX（懒加载）；公式编辑器有希腊字母 / 运算符 / 关系式 / 式子 / 箭头 / 化学六类符号面板；左下 (图) / (笔) 可识别图片中的公式（上传/拖入/粘贴 → 自动转 LaTeX）与识别手写公式（手写板 → 自动转 LaTeX），需在 AI 设置配置支持图像的模型。

PDF 阅读

• 完整 PDF 阅读器：内置打开 PDF（点击附件/文件树直达），近全屏阅读器 + 整篇连续滚动（虚拟化） + 左侧目录树 / 右侧批注侧栏 + 键盘导航（←/→/↑/↓ 平滑） + PageUp/PageDown 翻页 + 缩放下拉（适配页宽/页面/内容/实际 + 百分比阶梯）+ 护眼模式（柔光/暖黄/夜间/淡绿多档位，暖色纸底 + 页图降蓝/柔光）。
• 页面批注：高亮（有文本层精确划词）/ 画笔 / 便签（钉 + 内容气泡，按住即拖、双击编辑）/ 区域标注；选中标注 → 摘录成块（带 pdf:// 回链）/ AI 帮读 / 复制引用 / 删除；撤销；右侧批注侧栏（类型筛选、按页、点击精准定位、及时刷新）。
• 扫描版 OCR / AI 识别：无文本层时点「OCR 识别本页」用本地 tesseract 识别（识别在本机完成、不上传；语言包约 30 MB 首次使用需联网下载一次，之后永久离线可用），或点「AI 识别」把页图直接给视觉大模型（更准）；识别结果在居中可缩放弹层显示，可朗读 / 复制全部 / 写入便签。
• AI 一键生成目录：扫描版无内置目录时，从当前页往后逐页用视觉大模型看页识别章节标题+页码，一键生成可点击跳转的目录（进度 / 取消 / 缓存）。
• 系统朗读：顶部「朗读本页」（有文本层读全文；扫描版先识别再听），识别结果也可朗读。

知识组织

• 页面树：无限层级嵌套，页面与文件夹（kind）区分，拖拽精确排序。
• 文件管理 / 网盘：从侧边栏点文件夹进入文件管理页——文件 / 文件夹、文件列表（类型、大小、时间），文件夹内批量上传超大文件（流式）、侧边栏同步展示；文件引用到页面（文件卡片 + 系统打开）；同名文件历史版本（保留 / 恢复）。
• 标签系统：页面打标签，侧边栏按标签筛选；标签管理（全局标签库，重命名合并 / 删除 / 使用页数）。
• 双向链接：[[标题]] 页面双链 + ((块ID)) 块引用 + {{块ID}} 块嵌入。
• 块级反链：页面底部反链面板分「页面引用 / 块级引用」两组，精确到「谁引用了本页哪一块」。
• 关系图：力导向关系图，页面 / 块节点、按引用类型着色、块级图层开关、拖拽与点击跳转。
• 数据库视图：表格 / 画廊 / 看板 / 列表 / 日历 / 时间轴 / 目录 / 甘特图 八种视图；查询型数据库（规则收页）、保存视图 + ref 关联属性 + 公式列 + 跨库 rollup 聚合。
• 原生甘特图：用日期列（开始/结束，或 4 列计划/实际两组）渲染网格填色甘特图——时间轴、网格线、可编辑日期（文本+日期选择器）、列宽可拖；数据表格一键变专业甘特图。
• 看板视图：按标签 / 分组字段分列；卡片跨列拖、列(分组)拖换序、插入位置竖线、未设置列固定最左——像专业看板工具，而不只是"按字段分组"。
• 语义检索：嵌入向量语义搜索，不只关键词——全空间、跨空间找得到"想表达的意思"，与 AI 助手联动。
• 全文搜索：SQLite FTS5 + trigram 分词，支持中文子串检索、命中高亮与定位；Web 平台提供相关度排序版本。
• 多工作空间（物理隔离）：每空间独立 SQLite 库（meta.db 管理空间清单，spaces/<ws_id>/ 每空间库）；空间切换器（新建 / 重命名 / 主题色 / 排序 / 删除）；全空间搜索跨库合并；跨空间复制页面；单空间导出 / 导入（自包含 zip）。

邮件聚合（邮件即笔记，v1.83.0）

• 多账号聚合收件箱：打通 QQ / 企业邮箱等多账号 IMAP，聚合到一个统一收件流（按时间降序、分页）；单账号连接失败跳过。
• 账号筛选：「全部账号 + 每账号」多选下拉，选哪些账号就聚合哪些；列表新增独立账号列（多账号才显示），未读角标用聚合汇总。
• 按月直达：月份选择器聚合各账号含邮件月份，所有月份可点，按邮件自身时区年月在后端过滤（不依赖服务端 SINCE/BEFORE）。
• 存为笔记 / 任务：单封 / 任务 / AI 总结 / 批量四条路径统一先写属性再跳转，自动填发件人 / 主题 / 邮件日期 + 发件人标签，不因竞态丢失。
• AI 总结：阅读区一键总结，结果在弹窗展示；「存入笔记」自动填属性 + 发件人标签。
• 回复 / 转发：转发可输入收件人、光标自动定位；回复 / 转发光标定位正文最前。
• 测试连接：设置 → 邮箱多账号管理里「测试连接」（IMAP 登录 + 选 INBOX + 可选 SMTP 认证，不发信）。

数据安全

• 自动保存：防抖写入 SQLite，无「保存」按钮。
• 版本历史：每次保存前自动快照，可一键回滚（每页保留 50 份，自动去重）。
• 回收站：软删除 + 恢复 + 彻底删除。
• 端到端加密：Argon2id 密钥派生 + XChaCha20-Poly1305；同步加密 + 设置 UI + 口令解锁 / 锁定，每空间独立密钥。
• 整库备份：导出 / 导入 zip（数据库一致性快照 + 附件目录；流式 + 进度条）。
• 单空间备份导出：export_workspace 把当前空间打成自包含 zip（空间库 + 该空间引用附件 + 元数据）；import_workspace 导入为新空间。
• 空间清理 / 存储管理：占用统计（数据库 / 附件 / 回收站 / 版本 / 临时）、清空回收站 / 清理孤立附件 / 清理版本历史 / 清理临时文件 / 清理软删工作空间。

多设备同步

• Outbox 变更日志：本地每次写入记录变更，离线排队。
• 同步一致性加固（seq-LWW + dirty 优先本地，v1.84.3）：LWW 改用服务端单调 seq 为权威序，配合 dirty 优先本地——根治团队多人同时改同一内容时因客户端时钟漂移而丢改动的隐患。服务端 changes 自增 seq 全局唯一、单调；本地未提交改动标 dirty 优先保留，推送成功才清除。
• 附件同步：内容寻址去重，双向增量。
• 自动定时同步：启动即同步，之后每 5 分钟周期同步。

体验优化

• 设计系统 v2：品牌蓝 + 中性面 + 多彩分类色的统一 token 体系。
• 暗色模式：亮色 / 暗色 / 跟随系统三种。
• 命令面板：Ctrl+K 搜索页面与命令，分组展示、键盘导航。
• 顶部工具栏：页面顶部图标工具栏（查找 / 导入 / 导出 Markdown / 导出 HTML / 版本历史 / PDF）。
• 模板中心：结构预设建页（页面 / 数据库）+ 保存为模板 + 共享打磨。
• Toast 反馈：保存 / 同步 / 备份 / 删除 / 恢复等操作底部提示，替代系统弹窗。
• 编辑器查找：Ctrl+F 高亮全部命中并逐个导航。
• 多窗口：页面可弹出到独立窗口编辑。

AI 助手（薄 Agent + 内联起草）

• 可选、本地优先、安全：AI 默认关闭，仅调用你配置的模型端点（本地 Ollama / OpenAI 兼容云）；白名单语义工具（搜索 / 读页 / 读块 / 建页 / 追加块 / 反链），无 shell / 任意文件 / 联网；写操作需确认（详见 薄 Agent 方案）。
• 侧边栏 AI 助手：右侧 (AI) 面板，全局问答 / 总结 / 跨页检索 / 建页（草稿确认后落库），多轮上下文（支持"再详细点"）。
• 内联 AI 起草：空行按空格打开跟随光标的起草浮层；「用 AI 写作」下拉按当前页上下文自适应（有内容 → 续写 / 总结 / 翻译 / 润色 / 纠错；空页 → 创作类·小红书等）；选中即填入提示词、光标定位到省略号后；流式创作 + 高亮待定草案 +「完成」插入到你按空格所在的块 /「关闭」丢弃 /「重新生成」；点击背景或 Esc 取消。
• 思考过程实时流式：推理型模型的 reasoning_content 边想边显示；R 重新生成 / Esc 停止。

快捷键

• Ctrl+N：新建页面
• Ctrl+Shift+F：聚焦搜索
• Ctrl+E：循环笔记 / 看板 / 关系图视图
• Ctrl+K：打开命令面板
• Ctrl+F：编辑器内查找（Enter / Shift+Enter 导航）
• Esc：关闭查找栏 / 命令面板 / 弹层
• /：打开斜杠菜单