03_User Guide

User Guide | 用户指南

本页面为 NoteWizard 的用户使用总览，简要介绍应用的设计理念、核心功能与适用场景。
This page provides a high-level overview of NoteWizard, including its design philosophy, core features, and intended use cases.

---

Overview | 总览

NoteWizard 是一款以 本地优先（Local-first） 为核心理念的桌面笔记应用，专注于效率、安全与长期知识管理。
NoteWizard is a local-first desktop note-taking application focused on efficiency, security, and long-term knowledge management.

应用所有数据默认存储在本地设备上，用户对自己的数据拥有完全控制权。
All data is stored locally by default, giving users full control over their notes.

---

Core Concepts | 核心理念

• 本地存储
  所有笔记保存在本地文件系统中，不依赖云端服务。

  Local Storage
  All notes are stored on the local file system without mandatory cloud dependency.

• 结构化管理
  支持笔记本与多级层级结构，适合长期知识整理。

  Structured Organization
  Supports notebooks and hierarchical organization for long-term knowledge management.

• 即时可用
  启动迅速，编辑即保存，无需复杂配置即可开始记录。

  Instant Productivity
  Fast startup and automatic saving allow you to start writing immediately.

---

Key Features | 主要功能

• 丰富的 Markdown 支持
  支持常用 Markdown 语法，包括标题、列表、表格、引用、任务清单等，并提供实时预览。

  Rich Markdown Support
  Full support for common Markdown syntax with real-time preview.

• 多语言与代码块支持
  支持多国语言内容书写，代码块支持多种主流编程语言，适合技术文档与学习记录。

  Multilingual & Code Block Support
  Write notes in multiple languages and use code blocks for popular programming languages.

• 快速搜索与内容定位
  支持全文搜索，帮助你快速找到所需笔记内容。

  Fast Search
  Quickly locate notes with full-text search.

• 导入与导出
  支持 NoteWizard 专用数据包格式与 Markdown 格式，便于数据迁移与长期保存。

  Import & Export
  Supports both NoteWizard package format and Markdown format for data portability and backup.

• 本地数据备份与恢复机制
  提供可靠的本地备份与恢复能力，降低数据丢失风险。

  Local Backup & Restore
  Reliable local backup and restore capabilities.

• 可选的 AI 写作辅助功能
  在需要时提供写作辅助。

  Optional AI Assistance
  Optional AI-assisted writing without compromising local-first principles.

---

Security & Privacy | 安全与隐私

安全是 NoteWizard 的基石。
Security is a core foundation of NoteWizard.

我们为笔记提供 工业级强度的本地加密保护，确保数据始终掌握在用户自己手中。
We provide industry-grade local encryption to protect sensitive notes and ensure full user control over data.

Local Encryption | 本地加密

• 应用采用 AES-256-GCM 算法，在设备端对笔记数据进行加密。

• 启用后，所有加密笔记内容仅以 密文形式 存储在硬盘中，即使文件被复制或窃取，也无法被读取。

• Notes are encrypted locally using AES-256-GCM encryption.

• Once enabled, encrypted notes are stored as CIPHERTEXT on disk and cannot be read even if files are stolen.

Recovery Key | 恢复密钥

• 首次启用加密功能时，系统会生成唯一的 恢复密钥（Recovery Key）。

• 请务必将该密钥妥善保存在安全的位置（如密码管理器或离线备份）。

• A unique Recovery Key is generated when encryption is enabled for the first time.

• Store this key securely, such as in a password manager or offline backup.

Important Notice | 重要提示
NoteWizard 不会存储您的密码或恢复密钥。
如果您同时丢失了密码与恢复密钥，加密数据将永久无法恢复。

NoteWizard does not store your password or recovery key.
If both are lost, encrypted data will be irreversibly inaccessible.

---

Typical Use Cases | 适用场景

NoteWizard 适合以下用户与使用场景：
NoteWizard is well suited for the following use cases:

• 日常笔记与个人知识管理
  Daily notes and personal knowledge management

• 技术文档与学习记录
  Technical documentation and study notes

• 长期项目资料整理
  Long-term project documentation

• 对数据安全与可控性有要求的用户
  Users who value data privacy and control

---

Usage Philosophy | 使用理念

NoteWizard 鼓励用户建立 可持续的笔记习惯，而不是依赖短期工具或碎片化记录。
NoteWizard encourages building sustainable note-taking habits rather than relying on short-lived or fragmented tools.

应用功能设计遵循「少而精」原则，避免不必要的复杂性。
Features are designed to be minimal yet powerful, avoiding unnecessary complexity.

---