主题
SHUSHAN（数山）产品操作手册
目录
1. 产品概述
SHUSHAN（数山）是一款桌面知识管理应用，核心功能包括：
- 文件管理: 工作区文件浏览、搜索、筛选，支持创建、重命名、删除
- Markdown 编辑: 所见即所得编辑器，支持表格、图片、任务列表、代码高亮、文件引用等
- 全文搜索: 支持中文分词的全文检索，可按文件类型、日期、标签组合筛选
- 版本历史: 文档版本保存、对比差异、恢复到历史版本
- 关系图谱: 文件间引用关系可视化
- 标签系统: 创建标签、为文件打标签、按标签筛选
- 便签管理: 轻量级便签，支持转换为正式文档
- 思维导图: 多种布局和导出格式的导图编辑器
- 文件查看器: PDF、Word(.docx)、图片、纯文本查看
- 每日笔记: 按日期自动生成笔记文件
2. 安装与启动
2.1 系统要求
| 平台 | 要求 |
|---|---|
| Windows | Windows 10 及以上，64 位 |
| macOS | macOS 11 及以上 |
| Linux | Wayland 或 X11 桌面环境 |
2.2 安装
- 从发布页面下载对应平台安装包
- 按提示完成安装
- 启动应用
2.3 首次启动
- 显示启动画面
- 在
文档/SHUSHAN下创建工作区 - 自动初始化数据库并建立文件索引
- 进入"今日"面板
2.4 从源码构建
bash
# 要求 Node.js >= 18, Rust 最新稳定版
npm install
npm run tauri:dev # 开发模式
npm run tauri:build # 生产构建3. 界面布局
主窗口由标题栏、左侧导航栏、标签式内容区三部分组成。
3.1 标题栏
位于窗口顶部，按钮从左到右：
| 按钮 | 功能 |
|---|---|
| Logo | 点击折叠/展开左侧导航栏 |
| 应用名 | 固定显示"数山" |
| 新建笔记 | 快速新建 Markdown 文件 |
| 新建思维导图 | 快速新建 .smm 思维导图文件 |
| 建立索引 | 手动触发工作区全量文件索引 |
| 清除缓存 | 清除应用缓存 |
| 主题切换 | 浅色/深色一键切换 |
| 帮助 | 预留按钮 |
| 最小化 | 最小化窗口 |
| 最大化/还原 | 最大化或还原窗口 |
| 关闭 | 关闭窗口（行为取决于设置中的"最小化到托盘"） |
3.2 左侧导航栏
可通过 Logo 按钮折叠/展开，包含：
| 菜单项 | 功能 |
|---|---|
| 今日 | 仪表盘首页 |
| 文件管理 | 展开后显示"全部文件"入口和工作区文件夹树 |
| 便签管理 | 管理轻量级便签 |
| 关系图谱 | 文件引用关系可视化 |
| 标签管理 | 创建和管理文件标签 |
| 设置 | 应用配置 |
点击"文件管理"图标或标题文本，直接切换到文件管理标签页并显示全部文件。展开子菜单时自动加载文件夹树。
在"文件管理"标题上右键弹出菜单：新建文件、新建文件夹、在资源管理器中打开工作区。
3.3 标签页管理
右侧内容区使用标签页管理所有打开的内容：
- 双击文件列表中的文件，自动创建标签页打开
- 点击标签页标题切换，点击 × 关闭
- 关闭前未保存内容会自动保存
- 打开已在标签页中的文件时，自动激活已有标签
- 应用重启后标签页状态保留
4. 今日面板
应用启动后的默认首页。
4.1 问候语
根据当前时间自动切换：
| 时间段 | 问候语 | 时段标签 |
|---|---|---|
| 0:00-5:59 | 夜深了 | 夜深人静 |
| 6:00-11:59 | 早上好 | 晨间记录 |
| 12:00-17:59 | 下午好 | 午后随记 |
| 18:00-23:59 | 晚上好 | 晚间回顾 |
顶部显示完整日期（如"2026年6月26日 · 周五"）。
4.2 存活天数
在设置中填写生日后，此处显示"我在地球的第 N 天"。未设置时点击"设定生日 →"可内联设置。
4.3 每日笔记
每天自动生成对应日期的笔记文件（存放在 日记/ 子目录下）。
- 左侧显示日历样式日期（日数 + 月份）
- 右侧根据时段显示写作提示，如"写下今天的计划，让一天更有方向"
- 已有内容时显示文本预览（去除 Markdown 标记的纯文本）
- 已有内容: 点击"继续编辑 →"打开编辑器
- 空白时: 点击"开始记录"按钮创建并打开
4.4 最近打开
显示最近访问的 8 个文件，每项含文件类型图标、文件名、相对时间（如"刚刚"、"3 分钟前"、"2 小时前"）。点击打开文件。底部"查看全部 →"跳转到文件管理。
4.5 概览统计
| 统计项 | 说明 |
|---|---|
| 本月新增 | 当月新增文件数 |
| 总文件数 | 工作区已索引的文件总数 |
| 总大小 | 所有文件占用的磁盘空间 |
| 标签数 | 系统中创建的标签总数 |
下方还有"本周修改"文件数统计。
4.6 文件类型分布
水平进度条展示各文件类型的数量和占比（Markdown、PDF、图片、思维导图、Word、文本等）。
5. 文件管理
5.1 浏览文件
导航方式:
- 点击左侧文件夹树中的文件夹，文件列表切换至该目录
- 点击"全部文件"显示工作区根目录的所有文件
- 文件列表上方显示当前目录路径（纯文本展示，不可点击跳转）
文件列表:
每项为卡片布局，展示：
- 文件图标 + 文件名
- 修改时间
- 文件大小
- 文件路径
- 引用数（可点击，弹出引用该文件的所有文档列表，双击列表项可打开引用源文件）
- 标签
- 搜索模式下额外显示内容预览
底部有分页控件（上一页、页码、下一页、跳转），每页 50 条。
- 单击无操作，双击打开文件
- 右键弹出上下文菜单
5.2 搜索文件
文件列表顶部搜索栏包含：
| 条件 | 操作 |
|---|---|
| 关键词输入框 | 输入后按回车或点击"查询"按钮搜索 |
| 文件类型下拉 | 选择特定类型，变更后自动搜索 |
| 标签筛选 | 多选标签（带颜色圆点标识），变更后自动搜索 |
| 日期范围 | 选择"起始"和"截止"日期，变更后自动搜索 |
| 宽松匹配 | 复选框，勾选使用中文分词，不勾选精确匹配 |
| 查询按钮 | 点击执行搜索 |
筛选条件变化后 300ms 防抖自动发起搜索。搜索结果按相关度排序，匹配关键词在内容预览中显示。
5.3 文件右键菜单
在文件上右键弹出（按文件/目录有所不同）：
文件（非目录）:
- 打开
- 在 Lightbox 中打开（仅图片文件）
- 复制路径
- 打开所在文件夹
- 重命名
- 删除
- 属性
- 标签管理
目录:
- 打开
- 复制路径
- 打开所在文件夹
- 重命名
- 删除
- 刷新
- 属性
- 标签管理
5.4 文件夹右键菜单
在左侧文件夹树的文件夹上右键：
- 新建文件（默认文件名格式：
NOTE+年月日时分秒.md） - 新建文件夹
- 重命名（系统保护文件夹不可用）
- 删除（需为空文件夹；系统保护文件夹不可用）
- 打开所在文件夹
系统保护文件夹：images、notes、mindmap、日记目录及其所有子文件夹。
5.5 重命名与删除
重命名:
- 右键文件 → 重命名
- 如果文件被其他文档引用，弹出影响分析对话框，列出所有引用文件
- 确认后输入新文件名
- 完成重命名
删除:
- 右键文件 → 删除
- 如果文件被引用，弹出影响分析对话框
- 确认后移入系统回收站
5.6 文件详情
右键文件 → 属性，弹出对话框显示：
- 文件名、完整路径、文件大小
- 文件类型（文件/目录）
- 修改时间、创建时间
- 关联标签列表（以彩色标签展示）
- 非目录文本文件底部有快捷"打开文件"按钮
5.7 标签管理（文件级）
右键文件 → 标签管理：
- 上方显示当前关联标签，点击标签上的 × 可移除
- 下方下拉选择标签后点击"添加"按钮
5.8 文件索引
- 自动: 通过文件系统监听自动增量更新
- 手动: 点击标题栏"建立索引"按钮
- 重建: 设置 → 重建索引（清除全部数据后重新扫描，耗时较长）
文件超过设置的最大大小限制，或匹配排除模式的，不会被索引。
6. Markdown 编辑器
6.1 打开方式
- 文件管理中双击
.md文件 - 右键"打开"
- 今日面板中点击"继续编辑"
6.2 标题栏
最右侧四个按钮：
| 按钮 | 图标 | 功能 |
|---|---|---|
| 文档大纲 | 票据 | 切换右侧大纲面板（宽 240px） |
| 引用关系图 | 连接 | 切换浮动引用图谱浮窗 |
| 版本历史 | 操作 | 切换右侧版本历史面板（宽 320px） |
| 保存 | 文档打勾 | 手动保存并创建版本快照；有未保存修改时高亮 |
文件名可点击编辑：点击文件名区域，出现输入框，回车确认/Esc 取消。
6.3 格式化工具栏
工具栏按钮按顺序排列：
文本样式:
| 按钮 | 快捷键 | 功能 |
|---|---|---|
| 标题下拉 | — | 选择 H1 ~ H6 |
| 加粗 | Ctrl+B | 切换加粗 |
| 斜体 | Ctrl+I | 切换斜体 |
| 删除线 | — | 切换删除线 |
| 高亮标记 | — | 切换高亮 |
段落对齐（竖线分隔）:
| 按钮 | 功能 |
|---|---|
| 左对齐 | 段落左对齐 |
| 居中对齐 | 段落居中对齐 |
| 右对齐 | 段落右对齐 |
列表与元素:
| 按钮 | 功能 |
|---|---|
| 分割线 | 插入水平分割线 |
| 无序列表 | 切换项目符号列表 |
| 有序列表 | 切换编号列表 |
| 任务列表 | 切换可勾选任务清单（支持嵌套） |
代码与引用（竖线分隔）:
| 按钮 | 功能 |
|---|---|
| 行内代码 | 切换行内代码样式 |
| 代码块 | 切换代码块（自动语法高亮） |
| 引用块 | 切换块引用 |
插入:
| 按钮 | 功能 |
|---|---|
| 链接 | 弹出输入框，输入 URL 插入超链接 |
| 图片 | 打开系统文件对话框选图，自动复制到工作区 images/ 目录后插入 |
| 调整图片 | 精确设置选中图片的宽高（支持保持宽高比） |
| 表格 | 弹出网格选择器，拖动选择行列数后插入表格 |
工具（竖线分隔）:
| 按钮 | 快捷键 | 功能 |
|---|---|---|
| 查找替换 | Ctrl+F | 开关搜索替换面板 |
| 文件引用 | Ctrl+Shift+F | 打开文件选择器，在光标位置插入文件引用链接 |
| 思维导图 | — | 打开 .smm 文件选择器，在文档中嵌入导图预览块 |
编辑（竖线分隔）:
| 按钮 | 快捷键 | 功能 |
|---|---|---|
| 撤销 | Ctrl+Z | 撤销 |
| 重做 | Ctrl+Y | 重做 |
视图控制（工具栏最右侧）:
| 按钮 | 功能 |
|---|---|
| 内容宽度 | 切换宽版/窄版。窄版时编辑区居中（最大宽 720px），宽版占满 |
| 缩放 | 点击循环切换：100% → 125% → 150% → 回到 100% |
6.4 表格操作
光标在表格内时，工具栏右侧自动出现表格操作按钮：
| 按钮 | 功能 |
|---|---|
| 在上方插入行 | 当前行上方插入一行 |
| 在下方插入行 | 当前行下方插入一行 |
| 在左侧插入列 | 当前列左侧插入一列 |
| 在右侧插入列 | 当前列右侧插入一列 |
| 删除行 | 删除光标所在行 |
| 删除列 | 删除光标所在列 |
| 删除表格 | 删除整个表格 |
6.5 图片操作
- 插入时自动复制到
images/目录，重名时自动加数字后缀 - 鼠标悬停图片时，四周出现 8 个拖拽手柄（四角 + 四边中点），拖拽可调整显示尺寸
- 选中图片后可通过工具栏"调整图片"按钮精确设置宽高，支持锁定比例
6.6 搜索替换
通过工具栏按钮或 Ctrl+F 打开面板：
- 输入查找内容，实时高亮匹配项并显示匹配数量
- 输入替换内容，可逐个替换或全部替换
- 上一个/下一个按钮在匹配项间跳转
- 大小写敏感开关
6.7 文档大纲
标题栏"大纲"按钮打开右侧面板。自动提取文档中 H1~H4 标题生成树形目录。点击标题项，编辑器自动滚动到对应位置。随文档编辑实时更新。
6.8 文件引用
文档中插入的文件引用以行内节点形式显示（文件图标 + 文件名）。右键引用节点可：
- 打开文件
- 删除引用
- 复制路径
点击引用节点直接跳转打开被引用文件。
6.9 思维导图块
在文档中嵌入 .smm 思维导图的缩略图预览：
- 工具栏 → 思维导图按钮 → 选择
.smm文件 - 导图以缩略图形式显示在文档中
- 缩略图上有编辑按钮，点击在新标签页打开完整导图编辑器
- 导图编辑关闭后，文档中的预览自动刷新
6.10 浮动引用图谱
标题栏"引用关系图"按钮打开浮窗，显示当前文件与其他文件的引用关系。节点可拖拽，双击节点打开对应文件。
6.11 版本历史
查看版本列表
标题栏"版本历史"按钮打开右侧面板（宽 320px）：
- 每个版本显示时间戳、文件大小
- 最新版本标注绿色"当前"标签
- 点击刷新按钮重新加载列表
选择与操作
点击版本项或复选框选中版本：
- 选中一个版本 → 顶部出现操作栏（显示已选数量）
- 选中两个版本 → 出现"对比"按钮
- 当前版本不可选中
右键菜单（在某个版本上右键）:
| 操作 | 说明 |
|---|---|
| 预览 | 弹窗展示该版本完整内容 |
| 与当前版本对比 | 直接对比该版本与最新版 |
| 恢复 | 确认后将当前文件替换为该版本内容 |
| 导出 | 另存为 .md 文件 |
| 删除 | 删除该版本 |
批量操作: 选中多个版本后，可批量删除。
差异对比
并排视图（默认）:
- 左侧面板：旧版本（红色标题），右侧面板：新版本（绿色标题）
- 每行带行号，删除行红色背景标
-，新增行绿色背景标+ - 顶部切换按钮可切换到"行内视图"（单列显示所有差异行）
- 底部图例：红色 = 删除、绿色 = 新增
恢复
执行恢复后，当前文件内容被选中版本覆盖，文件重新加载。
6.12 保存机制
- 自动保存: 停止编辑 3 秒后自动写入磁盘，不创建版本快照
- 手动保存: 点击保存按钮，写入磁盘并创建版本快照
- 切换标签页: 有未保存修改时自动保存
6.13 状态栏
编辑器底部显示：字符数、单词数、光标行列号。
7. 思维导图
7.1 创建方式
- 标题栏"新建思维导图"按钮
- 文件管理中新建
.smm文件
7.2 工具栏
左侧：
| 控件 | 功能 |
|---|---|
| 文件名 | 点击编辑图标修改 |
| 布局下拉 | 切换布局（逻辑结构图等） |
| 主题下拉 | 切换配色主题 |
右侧：
| 按钮 | 功能 |
|---|---|
| 撤销 | 撤销编辑操作 |
| 重做 | 重做已撤销操作 |
| 导出 | 下拉选择导出格式 |
| 适应画布 | 自动缩放使完整导图适配画布 |
| 保存 | 手动保存，有未保存修改时高亮 |
7.3 导出格式
| 格式 | 扩展名 |
|---|---|
| PNG 图片 | .png |
| SVG 矢量图 | .svg |
| JSON 数据 | .json |
| Markdown | .md |
| PDF 文档 | |
| XMind 格式 | .xmind |
| 纯文本 | .txt |
7.4 保存
修改后 3 秒自动保存。画布大小随窗口自动调整。
8. 便签管理
8.1 便签列表
- 网格卡片布局，置顶便签排在最前
- 每张卡片：颜色三角标识、Markdown 预览（支持加粗、列表、任务列表）、相对时间
- 双击卡片在独立窗口中打开
8.2 新建便签
- 点击右上角 + 按钮
- 在弹出的编辑器中输入内容（支持 Markdown 基础语法）
- 点击"关闭"保存
8.3 便签操作
点击卡片上的三点菜单：
| 操作 | 说明 |
|---|---|
| 编辑 | 在编辑器中修改内容和颜色 |
| 置顶/取消置顶 | 置顶便签排在最前 |
| 删除 | 确认后删除 |
底部还有"转文档"按钮（绿色）：将便签保存为 notes/ 目录下的 .md 文件，在新标签页打开，原便签自动删除。
8.4 独立窗口
双击便签卡片打开独立便签编辑窗口：480×560 像素，始终置顶，无窗口装饰，可拖拽调整大小。
9. 标签管理
9.1 标签列表
网格卡片展示，每张：彩色圆点 + 名称 + "N 个文件"使用计数。
9.2 新建标签
- 点击右上角 + 按钮
- 输入名称
- 在颜色选择器中选色（支持预设和自定义色值）
- 点击"保存"
9.3 编辑与删除
卡片上三点菜单：
| 操作 | 说明 |
|---|---|
| 编辑 | 修改名称和颜色 |
| 删除 | 确认后从所有关联文件中移除该标签 |
9.4 为文件加标签
文件管理 → 右键文件 → 标签管理 → 下拉选择标签 → 点击"添加"。
10. 关系图谱
10.1 图谱操作
| 操作 | 效果 |
|---|---|
| 拖拽节点 | 调整节点位置 |
| 滚轮 | 缩放画布 |
| 拖拽空白区 | 平移画布 |
| 单击节点 | 弹出文件详情卡片 |
| 双击节点 | 打开对应文件 |
| "适应画布"按钮 | 自动缩放使所有节点可见 |
10.2 类型筛选
左侧筛选面板可勾选/取消文件类型，隐藏不需要的类型节点。
10.3 清理悬空引用
点击"清理悬空引用"按钮，移除指向已删除文件的所有引用记录。
10.4 统计信息
页面顶部显示当前的文件节点数和引用关系数。
11. 文件查看器
根据文件扩展名自动选择：
| 扩展名 | 打开方式 |
|---|---|
.md | Markdown 编辑器 |
.txt | 文本编辑器 |
.smm | 思维导图编辑器 |
.pdf | PDF 查看器 |
.docx | Word 查看器 |
.png/.jpg/.gif/.webp/.bmp/.ico/.svg | 图片查看器 |
.doc | 调用系统默认程序（不支持旧版 .doc） |
| 其他 | 调用系统默认程序 |
11.1 PDF 查看器
工具栏（左到右）:
| 控件 | 功能 |
|---|---|
| − 按钮 | 缩小 25%，最低 50% |
| 百分比显示 | 当前缩放比例 |
| + 按钮 | 放大 25%，最高 300% |
| 竖线分隔 | |
| ◀ 按钮 | 上一页（首页禁用） |
| 页码输入框 | 输入数字直接跳转 |
| / N 页 | 总页数显示 |
| ▶ 按钮 | 下一页（末页禁用） |
| 搜索框 | 输入文字搜索 PDF 内容 |
| 匹配数 | "N 个匹配" |
| 文件名 | 当前文件名 |
搜索: 输入后 500ms 自动搜索，也可按回车立即搜索。找到匹配后自动跳转到第一个匹配页。无匹配时弹出提示。
缩略图: 右下角浮动圆形按钮（Grid 图标）打开/关闭缩略图侧边栏（宽 220px）。侧边栏显示所有页面缩略图，当前页高亮。点击缩略图跳转到对应页。
11.2 Word 查看器
仅支持 .docx，打开 .doc 会提示"暂不支持旧版 .doc 格式"。
工具栏:
| 控件 | 功能 |
|---|---|
| − 按钮 | 缩小 10%，最低 30% |
| 百分比显示 | 当前缩放比例 |
| + 按钮 | 放大 10%，最高 300% |
| 重置按钮 | 缩放恢复 100% |
| 搜索框 | 输入文字搜索 |
| 匹配数 | "N 个匹配" |
| 文件名 | 当前文件名 |
搜索: 输入后 300ms 自动搜索，匹配文本以黄色高亮，清空搜索框清除高亮。不支持结果间导航。
11.3 图片查看器
工具栏:
| 控件 | 功能 |
|---|---|
| 文件名 | 仅显示，无编辑功能 |
| − / 百分比 / + | 缩放控制，每次 25%，范围 10%~1000% |
| 重置按钮 | 缩放恢复 100%，旋转归零，平移归零 |
| 竖线分隔 | |
| 逆时针旋转 | 旋转 -90° |
| 顺时针旋转 | 旋转 +90° |
| 全屏按钮 | 打开灯箱模式 |
| 外部打开 | 用系统默认程序打开 |
鼠标操作:
| 操作 | 效果 |
|---|---|
| 滚轮 | 以光标位置为中心缩放，每次 10%，范围 10%~1000% |
| 拖拽 | 缩放 > 100% 时可拖拽平移图片 (光标变为抓手) |
快捷键:
| 按键 | 功能 |
|---|---|
| +/= | 放大 |
| -/_ | 缩小 |
| 0 | 重置缩放 |
| R | 顺时针旋转 90° |
| L | 逆时针旋转 90° |
11.4 灯箱模式
全屏暗色背景居中显示图片。点击背景或按 Esc 退出。
可在图片查看器工具栏点击全屏按钮，或在文件管理右键 → "在 Lightbox 中打开"进入。
11.5 文本编辑器
- 纯文本编辑区域，无格式化功能
- 停止输入 3 秒后自动保存
- 手动点击保存按钮（有未保存修改时高亮）
- 文件名可点击编辑（回车保存，Esc 取消）
12. 设置中心
所有设置即时自动保存。
12.1 通用设置
主题色系: 四选一点击切换，即时生效。
| 色系 | 说明 |
|---|---|
| 默认主题 | 绿色调 |
| 专业办公 | 蓝色调 |
| 河黄 | 金色调 |
| 现代极简 | 紫色调 |
主题模式: 浅色 / 深色 / 跟随系统（单选）
界面语言: 简体中文 / English（下拉选择）
开机自动启动: 开关控制
关闭时最小化到托盘: 开关控制。开启后关闭窗口不退出，通过托盘菜单"退出"完全退出。
自动检查更新: 开关控制
12.2 个人设置
生日: 日期选择器。设置后今日面板显示"我在地球的第 N 天"。
12.3 文件管理
工作目录: 只读文本框 + "选择目录"按钮。更改后建议重建索引。
排除模式: 多选下拉框，预设 .git、.svn、dist、build、node_modules。支持输入自定义模式后回车添加。
最大文件大小: 数字输入框，范围 1-1000 MB，步长 10。超过此值的文件不参与索引。
重建索引: 点击弹出确认对话框（红色警告图标，说明操作耗时），确认后清除全部索引数据并重新全量扫描。
12.4 关于
显示应用名称"数山"、版本号，以及"检查更新"按钮。
13. 桌面悬浮按钮
主窗口最小化后仍可使用的悬浮面板，位于屏幕右下角。
- 半透明白色矩形面板，长按可拖动改变位置
- 三个按钮：显示窗口、新建便签、每日笔记
14. 系统托盘
- 应用运行时显示托盘图标
- 左键点击: 显示主窗口
- 右键菜单: 显示窗口 / 退出
15. 快捷键参考
Markdown 编辑器
| 快捷键 | 功能 |
|---|---|
| Ctrl + B | 加粗 |
| Ctrl + I | 斜体 |
| Ctrl + F | 打开搜索替换面板 |
| Ctrl + Shift + F | 打开文件引用选择器 |
| Ctrl + Z | 撤销 |
| Ctrl + Y | 重做 |
图片查看器
| 快捷键 | 功能 |
|---|---|
| + / = | 放大 |
| - / _ | 缩小 |
| 0 | 重置缩放 |
| R | 顺时针旋转 90° |
| L | 逆时针旋转 90° |
通用
| 快捷键 | 功能 |
|---|---|
| Esc | 关闭灯箱、弹出框等浮层 |
16. 常见问题
工作区
Q: 如何更换工作区目录？
设置 → 文件管理 → 工作目录 → 点击"选择目录"。更换后建议执行"重建索引"。
Q: 部分文件没有出现在文件列表中？
可能原因：
- 文件尚未索引 → 点击标题栏"建立索引"
- 被排除模式过滤 → 检查设置中的排除模式列表
- 超过文件大小限制 → 检查设置中的最大文件大小
- 文件在隐藏目录中
编辑器
Q: 自动保存会创建版本快照吗？
不会。自动保存仅写入磁盘。要创建版本快照需要手动点击保存按钮。
Q: 如何对比文档的两个版本？
打开版本历史面板 → 右键某版本 → "与当前版本对比"，或选中两个版本后点击"对比"按钮。
Q: 文件重命名/删除时看到影响分析是什么意思？
系统检测到该文件被其他文档引用。对话框列出了所有会受影响的文件。你可以选择继续操作（引用将失效）或取消。
搜索
Q: 中文搜索不准确？
确认搜索栏中的"宽松匹配"复选框已勾选，这会启用中文分词。对于精确匹配场景，取消勾选。
Q: 搜索不到文件内容？
确认文件已被索引。点击标题栏"建立索引"手动触发。同时检查文件是否超过大小限制。
引用与图谱
Q: 文件引用是如何产生的？
当你在文档中通过工具栏"文件引用"按钮插入指向其他文件的链接时，系统自动记录引用关系。
Q: 图谱中有灰色节点？
灰色节点表示该文件在数据库中留有记录但实际文件已不存在（被删除或移动）。点击"清理悬空引用"可移除。
其他
Q: 关闭窗口后应用没有完全退出？
这是因为"关闭时最小化到托盘"功能已开启。在设置中关闭此选项，或右键托盘图标 → 退出。
Q: 应用数据存储在哪里？
平台相关目录：
- Windows:
%APPDATA%/shushan - macOS:
~/Library/Application Support/shushan - Linux:
~/.local/share/shushan
工作区文件默认在 文档/SHUSHAN。
Q: 删除文件夹时报"文件夹非空"？
需要先清空文件夹内的所有内容才能删除。
文档基于 SHUSHAN 当前版本编写，功能如有更新请以最新版本为准。