一、核心概念理解

1.1 双模式架构

AFFiNE 最大的特点是每个页面都有两种视图模式，可以无缝切换：

• 文档模式（Page Mode）：类似 Notion，适合写作、记录、结构化内容
• 白板模式（Edgeless Mode）：类似 Miro，适合脑图、绘图、创意规划

切换方式：

• 点击右上角的切换按钮
• 快捷键：Ctrl + Alt + E（Windows）/ Cmd + Option + E（Mac）

1.2 工作区（Workspace）

• 每个工作区是一个独立的数据空间
• 可以创建多个工作区用于不同项目或团队
• 工作区设置：点击左上角工作区名称 → 设置

1.3 本地优先 vs 云同步

AFFiNE 的设计理念是"本地优先"：

• 本地账号：数据存储在浏览器本地，无需登录
• 云账号：数据存储在服务器，支持多端同步

重要提示：

• 浏览器版可以使用本地账号
• 桌面客户端只认云账号（需要邮箱+密码）
• 测试版和正式版数据不互通（你的情况）

二、文档模式核心技巧

2.1 Slash 命令系统 /

这是 AFFiNE 最强大的功能之一，输入 / 可以快速插入各种内容块：

文本类型

/text        - 普通文本段落
/h1 ~ /h6    - 各级标题（Heading 1-6）
/quote       - 引用块
/callout     - 高亮提示框
/code        - 代码块（支持语法高亮）

列表类型

/todo        - 待办事项（带复选框）
/list        - 无序列表
/numbered    - 有序列表
/toggle      - 折叠列表（可展开/收起）

媒体内容

/image       - 插入图片
/file        - 上传附件
/link        - 插入链接
/bookmark    - 书签卡片（自动抓取网页信息）
/embed       - 嵌入外部内容（YouTube、Twitter 等）

高级块

/divider     - 分割线
/page        - 链接到其他页面
/database    - 数据库（表格、看板、列表视图）
/now         - 插入当前时间戳
/today       - 插入今天日期

格式化

/bold        - 加粗文本
/italic      - 斜体文本
/underline   - 下划线
/strikethrough - 删除线
/inline-code - 行内代码

2.2 Markdown 快捷输入

AFFiNE 完全支持 Markdown 语法：

# 标题 1
## 标题 2
### 标题 3

**粗体**
*斜体*
~~删除线~~
`行内代码`

- 无序列表
1. 有序列表
- [ ] 待办事项

> 引用块

```代码块```

[链接文字](https://example.com)

2.3 键盘快捷键（文档模式）

文本格式化

Ctrl/Cmd + B       - 加粗
Ctrl/Cmd + I       - 斜体
Ctrl/Cmd + U       - 下划线
Ctrl/Cmd + Shift + S - 删除线
Ctrl/Cmd + E       - 行内代码
Ctrl/Cmd + K       - 插入链接

块操作

Ctrl/Cmd + D       - 复制当前块
Ctrl/Cmd + Shift + D - 删除当前块
Ctrl/Cmd + /       - 打开命令面板
Tab                - 缩进（嵌套块）
Shift + Tab        - 取消缩进

选择操作

Ctrl/Cmd + A       - 全选当前块
Shift + ↑/↓        - 扩展选择
Ctrl/Cmd + Shift + A - 全选整个页面

页面操作

Ctrl/Cmd + N       - 新建页面
Ctrl/Cmd + P       - 快速查找页面
Ctrl/Cmd + E       - 切换编辑/预览模式
Ctrl/Cmd + S       - 保存（自动保存，这个快捷键主要是心理安慰）

历史记录

Ctrl/Cmd + Z       - 撤销
Ctrl/Cmd + Shift + Z - 重做

2.4 块引用（Block Reference）

可以引用其他页面的内容块：

1. 输入 [[ 或 @ 触发页面搜索
2. 选择要引用的页面
3. 可以选择嵌入整个页面或特定块

2.5 双向链接

• 输入 [[页面名称]] 创建页面链接
• 被链接的页面会显示"反向链接"（Backlinks）
• 构建知识网络的关键功能

三、白板模式核心技巧

3.1 工具栏快捷键

V - 选择工具（Selection）
H - 平移工具（Hand/Pan）
T - 文本工具
S - 形状工具
P - 画笔工具
E - 橡皮擦

3.2 导航快捷键

Space + 拖拽      - 平移画布
Cmd/Ctrl + 滚轮   - 缩放画布
Cmd/Ctrl + 0      - 重置缩放（100%）
Cmd/Ctrl + 1      - 适应所有内容
Cmd/Ctrl + 2      - 适应选中内容

3.3 形状工具

支持的形状类型：

• 矩形、圆形、三角形
• 菱形、五边形、六边形
• 箭头、线条、连接线

技巧：

• 按住 Shift 绘制正方形/正圆
• 连接线会自动吸附到形状边缘
• 双击形状可以直接输入文字

3.4 画笔工具

• 笔刷大小：工具栏调整或使用 Ctrl/Cmd + [ / ]
• 颜色选择：工具栏颜色面板
• 压感支持：如果使用数位板，支持压感绘制

3.5 嵌入文档块

在白板模式下可以：

• 从文档模式拖拽内容块到白板
• 在白板上直接创建文本框
• 嵌入其他页面的内容

四、数据库功能（Database）

4.1 创建数据库

输入 /database 创建，支持三种视图：

• 表格视图（Table）：类似 Excel
• 看板视图（Kanban）：类似 Trello
• 列表视图（List）：简洁的列表形式

4.2 字段类型

支持的字段类型：

• 文本（Text）
• 数字（Number）
• 日期（Date）
• 单选（Select）
• 多选（Multi-select）
• 复选框（Checkbox）
• URL
• 邮箱（Email）
• 文件（File）

4.3 数据库操作技巧

过滤（Filter）：

• 点击"Filter"按钮添加筛选条件
• 支持多条件组合（AND/OR）

排序（Sort）：

• 点击列标题排序
• 支持多级排序

分组（Group）：

• 在看板视图中按字段分组
• 拖拽卡片即可移动

公式（Formula）：

• 暂时不支持复杂公式（不如 Notion）
• 后续版本可能会增强

五、协作功能

5.1 邀请成员

1. 点击右上角"Share"按钮
2. 输入成员邮箱
3. 设置权限：查看者/编辑者/管理员

5.2 实时协作

• 多人同时编辑时会显示光标位置
• 支持评论和批注
• 冲突会自动合并（CRDT 算法）

5.3 权限管理

• 查看者：只能查看，不能编辑
• 编辑者：可以编辑内容，不能删除页面
• 管理员：完全控制权限

六、导入导出

6.1 支持的导入格式

• Markdown（.md）
• HTML（.html）
• Notion 导出文件（.zip）

导入方法：

1. 点击页面菜单（三个点）
2. 选择"Import"
3. 选择文件上传

6.2 支持的导出格式

• Markdown
• HTML
• PDF
• 图片（PNG）- 仅白板模式

导出方法：

1. 点击页面菜单（三个点）
2. 选择"Export"
3. 选择导出格式

七、高级技巧

7.1 模板系统

AFFiNE 提供了一些内置模板：

• 会议记录
• 项目计划
• 每日日志
• OKR 追踪
• 读书笔记

使用方法：

1. 新建页面时选择"Use Template"
2. 或访问 AFFiNE 模板库导入

7.2 批量操作

按住 Ctrl/Cmd 多选块：

• 批量删除
• 批量移动
• 批量复制

7.3 页面管理技巧

收藏页面：

• 点击页面标题旁的星标图标
• 收藏的页面会出现在侧边栏顶部

页面层级：

• 拖拽页面到另一个页面下方可以创建子页面
• 最多支持多层嵌套

搜索功能：

• Ctrl/Cmd + P 快速搜索
• 支持全文搜索
• 支持标签搜索

7.4 标签系统

虽然 AFFiNE 没有内置标签功能，可以用以下方法模拟：

1. 在页面中使用 #标签名 格式
2. 通过搜索 #标签名 找到所有相关页面
3. 或者使用数据库的"标签"字段

7.5 主题和外观

设置位置：

• 点击左下角头像 → Settings → Appearance

可调整项：

• 明暗主题切换
• 字体大小
• 页面宽度（居中/全宽）
• 界面语言

八、性能优化建议

8.1 大文档优化

• 避免单个页面内容过长（建议拆分为多个子页面）
• 图片压缩后再上传（推荐 500KB 以下）
• 避免嵌入过多高分辨率图片

8.2 同步策略

本地优先模式：

• 适合个人使用
• 速度最快
• 需要手动备份

云同步模式：

• 适合多端协作
• 实时同步（需要稳定网络）
• 自动备份

8.3 备份建议

定期导出重要数据：

1. 导出为 Markdown 格式（最通用）
2. 使用 Git 托管（如果自托管）
3. 数据库级别备份（Docker 卷备份）

九、常见问题解决

9.1 桌面客户端登录失败

问题： 测试版和正式版数据不互通

解决方案：

1. 确认使用的是云账号（不是本地账号）
2. 确认客户端版本和服务器版本匹配
3. 测试版客户端需要连接测试版服务器
4. 正式版客户端连接正式版服务器

切换服务器地址：

• 客户端设置 → Server URL
• 输入你的自托管地址

9.2 图片无法加载

可能原因：

• 图片存储在本地，其他设备无法访问
• 云存储未开启
• 图片文件过大

解决方案：

1. 确保启用云同步
2. 重新上传图片
3. 压缩图片后再上传

9.3 同步冲突

症状： 多端编辑时出现内容丢失

解决方案：

1. 查看版本历史（如果有）
2. 手动合并冲突内容
3. 避免同时在多端编辑同一页面

9.4 性能问题

症状： 编辑器卡顿、响应慢

排查步骤：

1. 检查页面内容量（是否过大）
2. 检查图片数量（是否过多）
3. 检查浏览器插件（禁用不必要的插件）
4. 清除浏览器缓存
5. 重启应用

十、快捷键速查表

全局快捷键

编辑快捷键

块操作快捷键

白板快捷键

十一、实用场景案例

11.1 个人知识库

结构建议：

📁 我的知识库
  ├── 📂 技术学习
  │   ├── 编程语言
  │   ├── 框架工具
  │   └── 最佳实践
  ├── 📂 工作项目
  │   ├── 项目 A
  │   └── 项目 B
  ├── 📂 读书笔记
  └── 📂 每日日志

11.2 团队协作

工作流程：

1. 创建项目空间（Workspace）
2. 使用数据库追踪任务（看板视图）
3. 每个任务链接到详细文档
4. 在白板模式进行头脑风暴
5. 定期导出 PDF 分享给外部成员

11.3 学习笔记

技巧：

• 使用双向链接构建概念网络
• 用白板模式画思维导图
• 用数据库追踪学习进度
• 定期回顾和整理（间隔重复）

11.4 项目管理

推荐设置：

1. 创建任务数据库（看板视图）
2. 字段设置：
   • 任务名称（Text）
   • 负责人（Select）
   • 优先级（Select: 高/中/低）
   • 状态（Select: 待办/进行中/已完成）
   • 截止日期（Date）
3. 按状态分组显示

十二、进阶技巧

12.1 自定义 CSS（如果支持）

部分版本支持自定义样式，可以：

• 调整字体
• 修改主题颜色
• 优化间距和布局

12.2 API 使用（开发者）

AFFiNE 提供了 API 接口：

• 程序化创建/编辑页面
• 批量导入数据
• 与其他工具集成

12.3 插件系统（未来功能）

官方路线图显示将支持：

• 第三方插件
• 自定义块类型
• 扩展功能

十三、与其他工具的对比

vs Notion

• ✅ 优势：开源、可自托管、更快速度、离线优先
• ❌ 劣势：数据库功能较弱、模板较少、生态较小

vs Obsidian

• ✅ 优势：白板功能、实时协作、更现代的界面
• ❌ 劣势：插件生态不如 Obsidian、Markdown 纯粹性不如

vs Miro

• ✅ 优势：文档+白板二合一、更轻量、可自托管
• ❌ 劣势：白板功能不如专业工具丰富

十四、总结建议

适合使用 AFFiNE 的场景：

• ✅ 个人知识管理
• ✅ 小团队协作（<10 人）
• ✅ 需要自托管的场景
• ✅ 需要白板+文档结合的工作流
• ✅ 重视数据隐私

不太适合的场景：

• ❌ 大型团队协作（功能还不够成熟）
• ❌ 复杂的数据库操作（不如 Notion）
• ❌ 需要移动端频繁使用（移动端还未推出）

最后的建议

1. 循序渐进：从简单的笔记开始，逐步探索高级功能
2. 定期备份：虽然有云同步，但定期导出备份更安全
3. 参与社区：AFFiNE 社区很活跃，可以提交功能建议
4. 保持更新：AFFiNE 更新很快，新功能不断增加
5. 测试版谨慎：如果追求稳定，使用正式版而非测试版

相关资源：

• 官方文档：https://docs.affine.pro
• GitHub：https://github.com/toeverything/AFFiNE
• 社区论坛：https://community.affine.pro
• Discord：加入官方 Discord 获取实时帮助

希望这份指南能帮助你更好地使用 AFFiNE！如果有任何问题或发现新的技巧，欢迎分享和讨论。