企业官网建设流程全解析

SiYuan 平板端手写笔记完整指南：导入纸质手写的可搜索方案

【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan

SiYuan 是一款开源、隐私优先、自托管的知识工作空间，数据全部存在本地。先说清楚一个事实：SiYuan 并没有内置手写画布，拿触控笔在编辑器里直接写字这条路走不通。但它提供了一条更接地气的方案——把纸质手写拍照或扫描成图片导入，再靠 OCR（Optical Character Recognition，光学字符识别，即从图片里提取文字）把手写内容变成可搜索、可引用的文本。

纸质手写：平板用户的真实痛点

在平板上用笔写字，体验确实比打字快。但写完之后，这些笔迹基本就"死"在白板 App 的画布里了：

• 全局搜索搜不到画布上的字
• 内容无法引用到其他笔记里
• 换 App 或换设备时很难迁移

问题不在于写字本身，而在于手写内容无法进入知识体系。SiYuan 的处理思路是绕开手写输入，直接把手写的产出物（图片）接进来。

如何把纸质手写导入 SiYuan

📌 导入路径很直接：在任意文档里插入图片块（快捷键Ctrl+K后输入/img，或直接把图片拖进编辑器），图片会被存到知识库的 assets 目录并自动建立索引。

几个实操建议：

1. 拍照时保证字迹清晰、背景干净，识别率会明显更高
2. 每张图片只放一段手写，避免一页图混着大段印刷文字
3. 一张图对应一个块（Block，SiYuan 里最小可引用的内容单元），后面搜索和引用都按块进行

导入之后，图片本身就是一等公民：可以拖动、可以引用、可以同步到其他设备，这和正文段落的管理方式完全一致。

如何开启手写 OCR 搜索

这是整个方案的核心。SiYuan 依赖开源引擎 Tesseract 对图片做文字提取，安装好之后，搜索结果里会直接包含图片中的手写文字。

安装 Tesseract 与中文语言包

不同系统的安装命令不一样，Linux 和 macOS 如下：

# Debian/Ubuntu sudo apt install tesseract-ocr tesseract-ocr-chi-sim # macOS brew install tesseract tesseract-lang

SiYuan 启动时会自动探测 tesseract 是否可用，并加载英文、中文等语言包；如果识别效果不理想，也可以用环境变量SIYUAN_TESSERACT_LANGS指定语言。这部分逻辑在 OCR 引擎源码 里，可以看到默认启用的语言包括 eng、chi_sim、fra、spa、deu、rus、jpn 等。

搜索手写图片

打开全局搜索（Ctrl+Shift+F），输入手写内容里的关键词，匹配到的图片块会和普通文本块一起列在结果里。识别出的文字会缓存下来，所以只有首次搜索需要稍等，后续检索是即时的。

重新 OCR 与手动校正

识别不准时不用重拍图片：右键图片打开菜单，选择「OCR」项可以查看识别结果，觉得不对就点「重新 OCR」再跑一次。OCR 结果支持手动编辑，改完会直接保存，之后搜索用的是你校正版。这个菜单入口在 前端代码 中。

平板端如何使用手写记录

在平板上，推荐的工作流是：

1. 上课或开会时用任意白板 App 甚至纸笔记录
2. 拍成清晰照片，同步到 SiYuan 的 assets 目录（或直接用文件导入）
3. 图片落块后随手写一句上下文备注，方便日后定位
4. 需要复习的内容，把 OCR 出的文字整理成文本块，再用闪卡功能做间隔复习

闪卡的间隔复习界面支持"再来一遍 / 困难 / 简单"分档，对手写内容里需要记忆的公式、定义很实用，配置项见 闪卡设置源码。

手写 OCR 的几个坑

• 单张图片超过 2MB 不会参与识别，这是引擎侧的默认上限，可以用环境变量SIYUAN_TESSERACT_MAX_SIZE调整
• 潦草的连笔、极细的圆珠笔迹识别率下降明显，重要内容建议用深色笔
• 识别语言由语言包决定，日文手写目前只认印刷体倾向较强的内容
• 关闭该功能只需设置环境变量SIYUAN_TESSERACT_ENABLED=false，适合磁盘紧张的老设备

写在最后

SiYuan 对平板手写的定位不是"取代手写"，而是让手写内容能回到知识库里被搜索、被引用、被复用。手写负责快速记录，OCR 负责让内容重新变得可检索，两者分工明确。如果你的工作流是"笔快记、后整理"，这套导入加 OCR 搜索的组合值得试一试。

【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan