NexNote:本地优先的知识库桌面应用,整合 Markdown、Git 与可控 AI
Aiden-FE/nexnote
NexNote 是一款本地优先的知识库桌面应用,将笔记、链接、Git 历史和 AI 工作流整合在一起,知识库以普通文件形式存放在 Git 仓库中。它支持结构化块编辑与 Markdown 源码双格式、Wikilinks 双向链接与图谱视图、自动提交的 Git 版本历史,以及需显式触发的可控 AI(兼容 OpenAI 接口、本地嵌入向量)。
NexNote is a local-first knowledge base desktop app for people who want their notes, links, Git history, and AI workflow in one place.
Block editing × Markdown × Wikilinks × Git × controllable AI.
Website · 简体中文 · Download the latest release · GitHub
Why NexNote
NexNote keeps the knowledge base on your device as ordinary files in a Git-backed vault. You can edit structured blocks or preserve Markdown source, connect pages with [[wikilinks]], inspect backlinks and graphs, and explicitly ask AI for help without turning every edit into a network request.
Features
- Two document formats — structured block editing and byte-preserving Markdown source views.
- Markdown views — source, draggable split view with Live Preview, and a read-only Preview view.
- Knowledge network — Wikilinks, backlinks, aliases, tags, graph views, and Chinese-capable full-text search.
- Git history — automatic commits, version timelines, and confidence signals derived from revision history.
- Controllable AI — OpenAI-compatible providers, local embeddings, explicit AI intent, streaming responses, and permission modes.
- Extensible desktop app — sandboxed plugins with explicit capabilities.
Download
NexNote currently ships desktop builds for:
- macOS — Apple Silicon and Intel
- Windows — x64
- Linux — x64
Download from GitHub Releases. See the FAQ for platform-specific installation notes. Release artifacts may require manual Gatekeeper or SmartScreen confirmation; this project does not claim signing or notarization unless a release explicitly documents it.
Privacy and control
Your vault remains local and there is no NexNote account or hosted backend. Provider keys are stored in the system keychain. Normal editing, saving, navigation, and selection changes do not create AI requests; AI actions require explicit intent and follow the selected permission mode.
Development
Prerequisites: Node.js 22 and pnpm 10.
pnpm install
pnpm dev
pnpm lint
pnpm typecheck
pnpm test
pnpm buildThe repository is a pnpm monorepo:
packages/kernel— editor and Markdown kernelpackages/renderer— Electron renderer and UIpackages/main— Electron main process and IPCpackages/shared— shared types and domain logicpackages/plugin-api— plugin contractsapps/website— static Editorial product website and landing page
Product vocabulary lives in CONTEXT.md. Architectural decisions live in docs/adr. See the issue files under .scratch/nexnote-build/issues/ for the current delivery tickets.
Contributing
Please run the standard lint, typecheck, test, and build gates before submitting changes. Keep product terminology aligned with CONTEXT.md, and add or update an ADR when a decision is difficult to reverse or surprising without context.
License
The application code is licensed under the MIT License. The packaged desktop application also includes bundled Git components; their GPLv2 notices and source-offer materials are kept under licenses/.
来源:GitHub · github.com