Skip to content

User_Manual.md

Latest commit

 

History

History
125 lines (95 loc) · 6.03 KB

User_Manual.md

File metadata and controls

125 lines (95 loc) · 6.03 KB

2026-03-24 v1.6.0

用户手册

Chinese Document

1. 简介

NoteConnection 是一个可视化工具，可将您的 Markdown 笔记转换为层级知识图谱。它通过识别先决条件、学习路径和聚类，帮助您理解知识库的结构。

2. 快速开始

  1. 选择数据源: 打开应用程序后，使用左上角的下拉菜单从 Knowledge_Base 中选择一个文件夹。
  2. 加载图谱: 点击“Load”按钮。对于大数据集，系统将使用并行处理来高效构建图谱。
  3. 探索: 图谱将在主视图中渲染。您可以使用鼠标或触摸手势进行平移和缩放。

3. 核心功能

3.1 布局模式

  • 力导向 (Force-Directed): 默认模式。适合查看聚类和分组。
  • DAG (有向无环图): 层级模式。根据依赖关系排列笔记（上 -> 下）。适用于查看学习路径。

3.2 专注模式 (Focus Mode)

  • 进入: 双击任意节点进入专注模式。
  • 视图: 选中的节点移动到中心。
    • 帮助理解 (左/下): 先决条件和入度连接。
    • 进一步探索 (右/上): 后续步骤和出度连接。
  • 控制: 使用底部的滑块调整垂直和水平间距。
  • 打开内容: 点击“打开具体内容”按钮以阅读节点的全文。
  • 退出: 点击“退出专注”按钮或双击背景。
  • 注意: “冻结布局”允许您在此模式下手动排列节点，而不会自动弹回。

3.3 节点检查

  • 悬停 (PC): 悬停在节点上以查看其连接和详情。
  • 点击 (移动端/PC): 点击节点以“冻结”它并打开统计弹窗。
    • 弹窗: 显示入度 (红色) 和出度 (蓝色) 列表。您可以拖动和缩放此弹窗。
    • 操作: 点击列表中的任意邻居以导航到该节点。

3.4 模拟控制

  • 面板: 位于右侧。
  • 冻结布局: 选中此项以停止所有移动。适用于大图或手动排列。
    • 快速按钮: 使用工具栏中的雪花图标 (❄️) 进行快速切换。
  • 速度/阻尼: 调整滑块以控制图谱稳定的速度。

4. 分析面板

  • 访问: 向下滚动或点击“Analysis”以查看数据表。
  • 交互: 点击表格中的行会在图谱中高亮显示相应的节点。
  • 移动端: 面板支持全屏模式和捏合缩放，以获得更好的可读性。

5. 设置

  • 访问: 点击齿轮图标。
  • 选项:
    • 语言: 在英语和中文之间切换。
    • 物理: 调整重力和排斥力。
    • 性能:
      • 启用 GPU 加速: 切换用于加速矩阵运算（如余弦相似度）的 GPU 使用。推荐用于 AMD Radeon 7900XT 或兼容 GPU。
      • 最大 Worker 数: 调整用于并行处理的 CPU 线程数（默认：CPU 核心数 - 1）。较高的值可加快大型构建速度，但会占用更多内存。
      • 省内存模式 (Memory Saving Mode): (v0.9.63) 启用以优化大数据集（10k+ 文件）的后端内存使用。通过流式传输文件内容和高效序列化数据来降低峰值堆内存。默认：已启用。
    • 视觉: 调整边透明度。

6. 性能特性 (自动优化)

  • Canvas 自动切换: 如果您的图谱包含超过 3000 个节点，NoteConnection 会自动切换到 Canvas 渲染器以确保流畅的性能。如有需要，您可以在控件中手动切回 SVG。
  • 物理剔除: 对于极其密集的图谱（>20,000 条边），物理模拟将仅计算边的一个子集的力，以防止界面冻结，同时仍渲染所有连接。

7. 移动应用构建 (Mobile App Build)

NoteConnection 包含一个一键式脚本，用于构建原生 Android APK (v1.1.0+)。

  • 先决条件:
    • Node.js (LTS)
    • Java JDK (17 或更高版本)
    • Android SDK (已在环境中配置)
  • 如何构建:
    1. 在终端中打开项目文件夹。
    2. 运行 build_apk.bat。
    3. 按照屏幕上的指示操作。脚本将检查您的环境，安装依赖项，构建 Web 应用程序，并编译 APK。
  • 输出: APK 将生成于 android/app/build/outputs/apk/debug/app-debug.apk。

8. 路径模式 (Path Mode)

  • 访问: 点击左上角工具栏中的“Path Mode”按钮。
  • 功能:
    • 领域学习: 特定主题集群的拓扑排序（掌握模式）。
    • 扩散学习: 寻找通往目标概念的最短路径（效率模式）。
  • 控制:
    • 策略: 选择“基础优先”(Foundational) 或“核心优先”(Core)。
    • 布局: 在径向 (Radial)、垂直树 (Vertical Tree) 和水平树 (Horizontal Tree) 视图之间切换。
    • 退出: 点击“Exit”返回主图谱。
  • 桌面模式: 在桌面端应用程序 (Tauri) 中，路径模式会在高性能原生 3D 窗口 (Godot) 中打开，可流畅渲染多达 50,000 个节点，并通过 WebSocket 自动同步。

9. v1.6.0 运行时与 NoteMD 行为

  • 单窗口行为:
    • 在 npm run tauri:dev:mini:gpu 下，默认显示 Tauri 主窗口。
    • 进入 Path Mode 时切换为 Godot 前端显示。
    • 任意时刻应只显示一个主前端窗口。
  • Godot 关闭确认:
    • 关闭 Godot 窗口时应先弹出确认框。
    • 用户可选择返回主界面，或关闭全部窗口。
  • NoteMD 嵌入式流程:
    • NoteMD 作为嵌入能力存在于 Tauri 和 Godot 两条前端链路中，不应作为独立桌面窗口运行。
    • 在 Tauri 中点击文件/文件夹/保存 Browse 应触发原生选择器并回填路径。
  • PDF 导入规则:
    • PDF 需要先用 Mineru 转换成 Markdown，再导入 NoteMD。

10. 本地运行时配置（app_config.toml）

  • 用途:
    • 统一持久化 KB 根目录、语言与多窗口策略。
  • Windows 默认位置:
    • %LOCALAPPDATA%/NoteConnection/app_config.toml
  • 路径覆盖变量:
    • NOTE_CONNECTION_CONFIG_PATH（完整文件路径）
    • NOTE_CONNECTION_CONFIG_DIR（包含 app_config.toml 的目录）
  • 模板:
  • 详细指南: