SiYuan平板端手写笔记功能详解：数字墨水体验

功能概述

SiYuan作为一款隐私优先、自托管的开源个人知识管理软件，在平板端提供了专业级的手写笔记功能。该功能基于数字墨水技术，完美模拟真实纸笔书写体验，同时结合了电子笔记的可编辑性和搜索性优势。无论是会议速记、课堂笔记还是创意草图，手写功能都能满足用户在移动场景下的记录需求。

手写笔记功能主要特点包括：

• 高精度压感支持，还原真实笔触粗细变化
• 丰富的笔刷样式和颜色选择
• 手写内容与文本内容无缝融合
• 手写识别与搜索功能
• 支持将手写内容转换为标准文本

快速上手

启用手写模式

在平板端打开SiYuan后，创建或打开任意文档，点击编辑器工具栏中的「手写」按钮即可进入手写模式。也可以通过手势操作快速切换：双指长按编辑区域3秒，松开后自动进入手写模式。

相关功能实现代码可参考：src/editor/util.ts

基本书写操作

进入手写模式后，屏幕底部会显示手写工具栏，包含以下核心功能：

• 笔刷选择（钢笔、毛笔、马克笔等）
• 颜色面板（支持自定义RGB颜色）
• 粗细调节（1-20px无极调节）
• 橡皮擦工具
• 撤销/重做按钮

高级功能详解

压感与笔触模拟

SiYuan手写引擎采用了先进的压力感应算法，能够根据笔尖压力自动调整线条粗细和颜色深浅。这种模拟真实书写工具的特性，使得手写笔记更加自然和富有表现力。

// 压感处理核心代码示例
function handlePressure(pressure: number, width: number): number {
  // 压力范围 0.0-1.0 映射到宽度 0.5-2.0 倍
  return width * (0.5 + pressure * 1.5);
}

相关实现可参考：src/protyle/

手写内容识别与转换

SiYuan支持将手写内容实时转换为标准文本，这一功能特别适合需要后续编辑和搜索的场景。点击手写内容选择「转换为文本」，系统会自动调用OCR引擎进行识别。

OCR功能实现代码位于：kernel/util/ocr.go

手写与文本混排

SiYuan允许在同一文档中混合使用手写和文本内容，用户可以在段落间自由切换输入方式。手写内容会被视为特殊类型的块(Block)，与其他内容块保持一致的层级关系和引用能力。

块级结构实现参考：src/block/

实用技巧与场景

会议速记技巧

1. 使用「圆珠笔」笔刷（0.5mm）提高书写速度
2. 开启「自动换行」功能，避免频繁滑动屏幕
3. 重要内容使用「高亮笔」标记，支持后续快速检索
4. 会议结束后，批量转换关键手写内容为文本

数学公式手写输入

SiYuan支持手写数学公式识别，特别适合理工科用户：

1. 在手写模式下画一个方框作为公式输入区域
2. 手写数学公式，系统会自动识别并转换为LaTeX格式
3. 点击转换结果可进行精细编辑

相关功能代码：src/editor/

自定义与设置

笔刷自定义

用户可以通过「设置-编辑器-手写」自定义笔刷属性：

• 调整笔尖形状（圆形、扁平、方形）
• 设置墨水颜色和透明度
• 配置压感曲线（线性、指数、对数）

配置文件路径：appearance/themes/

手势操作设置

SiYuan支持丰富的手写手势：

• 双指缩放：调整手写区域大小
• 三指捏合：清除当前手写内容
• 长按移动：调整手写块位置

手势处理代码：src/mobile/

常见问题解决

手写延迟问题

如果遇到手写延迟，可尝试以下解决方案：

1. 降低画布分辨率（设置-性能-画布分辨率）
2. 关闭「实时笔迹美化」功能
3. 关闭其他后台应用释放内存

性能优化相关代码：src/util/performance.ts

手写内容备份与同步

手写笔记以SVG格式存储，确保跨设备同步时的清晰度。用户可通过以下方式备份：

1. 自动同步：开启SiYuan云同步功能
2. 手动导出：选择手写块，导出为SVG或PNG格式
3. 完整备份：通过「设置-备份」创建完整数据备份

同步功能实现：src/sync/

功能对比与优势

功能特性	SiYuan手写	传统纸笔	其他电子笔记
压感支持	✅ 高精度	✅ 天然支持	❌ 部分支持
内容搜索	✅ 支持OCR搜索	❌ 不支持	✅ 有限支持
编辑灵活性	✅ 无限撤销重做	❌ 无法编辑	✅ 基本编辑
空间占用	✅ 零物理空间	❌ 占用实体空间	✅ 电子存储
导出格式	✅ SVG/PNG/PDF	❌ 扫描转换	✅ 有限格式

未来发展路线

根据SiYuan的开发计划，手写功能将在以下方面持续优化：

1. 增加3D笔触效果，提升书写真实感
2. 支持手写内容的AI美化与优化
3. 实现多设备实时协作手写
4. 增强数学公式和图表的手写识别能力

路线图详情可参考：CHANGELOG.md

通过上述功能的深度整合，SiYuan平板端手写笔记功能为用户提供了兼顾传统书写体验和数字效率的解决方案，是知识工作者在移动场景下的理想选择。