DeepRoot 使用说明

欢迎使用 DeepRoot —— 一个以递归式深度学习为核心的个人知识管理工具。

核心理念

从一个实际问题开始,学习需要解决这个问题的所有东西,发现更多子问题, 再搞定那些东西,一路递归到问题的核心。

在 DeepRoot 中,你阅读笔记时可以随时划选内容向 AI 追问,AI 的答案一键存为子笔记, 子笔记中又可以继续追问 —— 形成一棵不断生长的「学习树」,每一次追问都让你离问题的本质更近一步。

📝1. 笔记编辑器

笔记编辑器是 DeepRoot 的基础,采用所见即所得(WYSIWYG)的编辑方式,风格类似 Notion。

支持的格式

  • 标题(H1 / H2 / H3)
  • 粗体、斜体、行内代码
  • 无序列表、有序列表
  • 代码块(支持语法高亮)
  • 引用块(blockquote)
  • 分割线
  • 图片(粘贴 / 拖拽 / 按钮上传)

如何操作

  1. 1点击左侧「+ 新建笔记」按钮,或在笔记列表页点击「+ 新建笔记」
  2. 2在顶部输入笔记标题
  3. 3在编辑区域使用工具栏按钮或直接书写内容
  4. 4编辑器会在你停止输入 1 秒后自动保存,顶部会显示「已保存」提示
提示:编辑器顶部会显示字数统计。标题区域下方可以添加标签。

💡2. 划选文字向 AI 提问

这是 DeepRoot 最核心的交互 —— 在阅读笔记时,你可以随时选中一段文字向 AI 追问, 深入理解你正在学习的内容,递归地挖掘问题的本质。

操作步骤

  1. 1在笔记编辑器中,用鼠标选中你想追问的文字
  2. 2松开鼠标后,选区附近会浮出一个小工具条
  3. 3点击工具条上的「向 AI 提问」按钮
  4. 4右侧会滑出 AI 侧边栏,顶部显示你选中的原文
  5. 5在输入框中输入你的问题(或直接发送,默认问题为「请解释这段内容」)
  6. 6AI 会以流式方式生成回答
提示:AI 回答时会自动参考当前笔记的完整内容、知识库中的相关笔记(RAG 检索),并支持联网搜索获取最新信息。

💾3. AI 答案存为笔记

AI 的每一条回复都可以一键保存为新笔记,新笔记会自动成为当前笔记的「子笔记」, 形成一棵不断生长的学习树 —— 这正是 DeepRoot「递归深入」的核心体验。

操作步骤

  1. 1在 AI 侧边栏中,找到你想保存的回复
  2. 2点击该回复下方的「存为笔记」按钮
  3. 3系统会自动创建新笔记,标题取自你的提问前 20 个字
  4. 4新笔记的父笔记会自动设为当前正在阅读的笔记
  5. 5保存后会提示「已存为笔记」,点击可跳转查看
提示:在 AI 对话页面(/chat)中保存的笔记没有父笔记,会作为独立的根节点出现在知识树中。

🏷️4. 标签系统

标签帮助你对笔记进行分类组织。每篇笔记可以有多个标签。

添加标签

  1. 1在笔记编辑器的标题下方,找到标签输入区
  2. 2输入标签名称,按回车确认
  3. 3输入时会自动联想已有标签,可用上下键选择
  4. 4标签以彩色 pill 样式显示,点击 × 可删除

按标签筛选

  1. 1左侧边栏底部显示所有标签及对应笔记数量
  2. 2点击标签可快速跳转到该标签下的笔记列表
  3. 3在笔记列表页和知识树页面,顶部也可以按标签筛选
  4. 4支持多标签交叉筛选(同时选多个标签)

🌳5. 知识树可视化

首页展示你所有笔记构成的知识树。每个节点是一篇笔记, 深绿色连线表示父子关系(划选提问生成的子笔记),棕色虚线表示笔记间的引用链接。

交互方式

  • 滚轮缩放,拖拽平移画布
  • 鼠标悬停节点可查看笔记摘要(前 100 字)
  • 点击节点跳转到对应笔记详情页
  • 顶部标签按钮可以高亮筛选特定标签的分支

两种连线

  • 深绿色实线:父子关系(AI 追问产生的子笔记)
  • 棕色虚线:引用关系(笔记中通过 [[ 链接的笔记)
提示:树的深度越深,节点越小;连线粗细反映子笔记数量。首页上方还有学习统计卡片。

💬6. AI 独立对话

除了笔记内的划选提问,你还可以在独立的 AI 对话页面进行多轮对话。

操作步骤

  1. 1点击左侧导航「AI 对话」进入
  2. 2左侧面板可以新建/切换对话会话
  3. 3在对话页面上方,可以点击「选择知识库文档」按钮
  4. 4选中的文档全文会作为上下文注入 AI,AI 会基于文档内容回答
  5. 5每条 AI 回复旁都有「存为笔记」按钮
提示:支持联网搜索 —— AI 会使用智谱 GLM 原生的 web_search 工具获取实时信息。

📁9. 上传文件转笔记

支持将外部文件快速导入为笔记,目前支持 PDF、TXT、Markdown 三种格式。

操作步骤

  1. 1在笔记列表页,点击「上传文件(PDF / TXT / MD)」按钮
  2. 2选择文件(支持一次选择多个)
  3. 3系统会自动解析文件内容并创建笔记
  4. 4笔记标题为文件名,内容为解析后的正文
  5. 5导入的笔记会自动添加「导入」标签
提示:PDF 文件会自动提取文字内容。Markdown 文件会转换为富文本格式显示。

🖼️10. 图片支持

笔记编辑器全面支持图片的插入和管理。

插入图片的三种方式

  • 工具栏按钮:点击编辑器工具栏的「插入图片」按钮,选择本地图片
  • 粘贴:直接从剪贴板粘贴图片(截图后 Ctrl+V)
  • 拖拽:将图片文件拖入编辑器区域

图片操作

  • 鼠标悬停图片,右上角出现操作按钮
  • 点击「添加描述」可为图片添加说明文字(alt 文本)
  • 点击「删除」移除图片
  • 点击图片可打开灯箱放大预览

📤11. 笔记导出

支持将笔记导出为 Markdown 文件,方便备份和分享。

单篇导出

  1. 1进入笔记详情页
  2. 2点击顶部面包屑右侧的「导出 Markdown」按钮
  3. 3浏览器会自动下载一个 .md 文件

全库导出

  1. 1进入笔记列表页
  2. 2点击顶部的「导出全部」按钮
  3. 3浏览器会下载一个 ZIP 压缩包,包含所有笔记的 .md 文件和图片
提示:导出的 Markdown 文件包含 frontmatter 元数据(标题、标签、创建时间等),可被其他工具读取。

📊12. 学习进度统计

首页(知识树页面)顶部展示你的学习统计数据。

统计指标

  • 总笔记数:知识库中的笔记总量
  • 本周新增:近 7 天内创建的笔记数
  • 知识树深度:笔记父子链的最大层级
  • 最活跃标签:笔记数量最多的标签

写作热力图

点击「展开热力图」可以查看近 20 周的每日写作活跃度, 颜色越深表示当天的笔记活动越多,类似 GitHub 的贡献图。

📂13. 列表与结构视图

笔记列表页提供两种视图模式,帮助你从不同角度管理笔记。

列表视图

默认视图,按更新时间倒序展示所有笔记卡片。每张卡片显示标题、内容摘要、 标签、字数、时间,以及父笔记来源和子笔记数量。

结构视图

以缩进树形目录展示笔记的父子层级关系,直观呈现知识的递归结构。

  • 有子笔记的节点左侧有 ▶/▼ 展开/折叠按钮
  • 默认展开前两层,深层可手动展开
  • 左侧竖线连接子节点,层级一目了然

切换方式

  1. 1在笔记列表页标题旁找到「列表 / 结构」切换按钮
  2. 2点击即可切换视图

结构筛选

筛选栏提供「全部 / 父笔记 / 子笔记」三个按钮,可以只看根笔记或只看子笔记, 也可以和标签筛选组合使用。

14. 批量管理

在笔记列表页支持批量选中并删除笔记。

操作步骤

  1. 1在笔记列表页,点击「批量选择」按钮进入选择模式
  2. 2点击笔记卡片或左侧复选框来选中/取消选中
  3. 3点击操作栏的「全选」可一键选中所有笔记
  4. 4确认后点击「删除选中」按钮批量删除
  5. 5点击「取消选择」退出选择模式
提示:批量选择在列表视图和结构视图中均可使用。

⌨️15. 快捷键

快捷键功能
Ctrl + K打开全文搜索
Ctrl + B加粗
Ctrl + I斜体
Ctrl + E行内代码
Ctrl + Shift + 1/2/3切换标题级别
Ctrl + Shift + 8无序列表
Ctrl + Shift + 9有序列表
[[插入笔记链接
ESC关闭搜索/弹层

DeepRoot —— 从问题出发,递归到知识的根部