# Znote

一款适用于 macOS 的 Markdown 编辑器，内置本地笔记、AI、可运行代码块、MCP 工具连接和 Git 功能。

> 这是 OpenNavo 上 Znote 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/znote>

- **最新版本**: `4.10.0`
- **开发者**: Anthony Lagrede Consulting
- **主页**: <https://znote.io/>
- **分类**: [写作与笔记](https://opennavo.com/zh/categories/writing)
- **安装**: `brew install --cask znote`
- **近 30 天安装**: 5
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://github.com/alagrede/znote-app/releases/download/v4.10.0/znote-4.10.0-arm64.dmg>
- **SHA-256**: `3a1f99c9ac547d03efab7dbebad255c73eb133aa6c1e0c6fc85f6b1f4ead1539`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "app": [
        "znote.app"
      ],
      "target": "/Applications/znote.app"
    },
    "phase": "install",
    "sources": [
      "znote.app"
    ],
    "target": "/Applications/znote.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.tony.znote.sfl*",
            "~/Library/Application Support/znote",
            "~/Library/Preferences/com.tony.znote.plist",
            "~/Library/Saved Application State/com.tony.znote.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

Znote 是一款 Markdown 编辑器，可处理存储在电脑文件夹中的纯文本 `.md` 文件。它将笔记编辑与用于处理笔记和代码的内置工具结合起来。

- 通过所见即所得界面编写和编辑 Markdown，并搜索笔记内容。
- 针对选定笔记提问 AI，并将回答直接插入笔记。AI 功能需要配置你提供的密钥，例如 OpenAI 或 OpenRouter 的密钥；官方网站也介绍了使用 Ollama 的本地方案。
- 运行 JavaScript 代码块，并在笔记中内嵌显示结果，包括表格或图表。
- 配置 MCP 服务器，让 AI 代码块使用已连接的工具；官方网站列举了 GitHub、Postgres、Slack 和 Linear 等示例。
- 为笔记文件夹使用 Git，并将笔记中的秘密信息存储在加密的旁置文件中。

在 macOS 上使用 Homebrew 安装应用，请运行 `brew install --cask znote`。该 cask 会将 `znote.app` 安装到 `/Applications`。Znote 定位为本地优先的应用，无需账户；使用 AI 需要配置服务提供商或本地模型。此 Homebrew cask 适用于 macOS。

来源：[Znote](https://znote.io/) · [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/z/znote.rb)

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 4.10.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/znote.rb> · 核查于 2026-11-22
  - <https://github.com/alagrede/znote-app/releases/download/v4.10.0/znote-4.10.0.dmg>
  - SHA-256: `52856ec99f6e4f09226911d5b802aa65ca6eef08ea6f9ea044b91e6abfb8f22f`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 4.10.0 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/znote.rb> · 核查于 2026-11-22
  - <https://github.com/alagrede/znote-app/releases/download/v4.10.0/znote-4.10.0-arm64.dmg>
  - SHA-256: `3a1f99c9ac547d03efab7dbebad255c73eb133aa6c1e0c6fc85f6b1f4ead1539`

## 卸载

- `brew uninstall --cask znote`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask znote`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.tony.znote.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/znote.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Support/znote` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/znote.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/com.tony.znote.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/znote.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Saved Application State/com.tony.znote.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/znote.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 4.10.0 (2026-11-07)

Znote 4.10.0 was released on 2026-11-07, 本次更新重新设计了应用，并调整了多个控件的位置。

- 应用换了新外观：深色主题、Settings 和所有对话框、树视图、笔记列表、大纲、带有新线性图标的工具栏、AI 栏、录音器以及命令面板。列表只显示一处高亮，Material 涟漪效果已去掉。
- 工具栏新增只读模式和 Live edit / Source 切换。阅读模式下，复制得到纯文本，AI 栏隐藏。
- 页脚已去掉。帮助、Settings 和账户移到仓库栏，AI 模型选择器移入 Ask AI 栏。
- NPM、Plugins、Functions 和 MCP 现在是 Settings 里的标签页，不再放在左侧栏。
- 快速搜索（Cmd/Ctrl+T）可以再用，是一个键盘操作的面板，列出最近笔记和全文搜索结果。
- 粘贴任意文件：从 Finder 或 Explorer 复制的 PDF 和文档会进入仓库的附件文件夹，并带一个 [[link]]，用默认应用打开。在 macOS 上可以一次粘贴多个文件。
- 「显示所有文件类型」是按仓库单独设置的新选项，在树视图里列出该仓库的全部文件。
- Focus mode 有一个按钮，只在本次专注会话里在可读行宽和全宽之间切换。
- PowerShell 脚本导出为 .ps1。
- 组织登录对话框现在是英文，并在对话框里直接显示登录错误。

## 资料与来源

- <https://opennavo.com/zh/apps/znote>
- <https://opennavo.com/zh/apps/znote/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/znote.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/znote>
