ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

超越图形界面:ZenNotes的zn命令行助手8大命令组完全参考

超越图形界面:ZenNotes的zn命令行助手8大命令组完全参考 超越图形界面ZenNotes的zn命令行助手8大命令组完全参考【免费下载链接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.项目地址: https://gitcode.com/gh_mirrors/zenn/zennotesZenNotes 是一款键盘优先的本地 Markdown 笔记应用而它内置的zn 命令行助手让你不用打开图形界面就能在终端里完成记笔记、全文搜索、任务勾选、标签管理等全部工作。本文带你完整掌握 zn 的 8 大命令组NOTES / SEARCH / FOLDERS / TAGS / TASKS / COMMENTS / VAULT / DATABASES外加 3 个高频特别命令让你快速上手用命令行管理笔记库。为什么 zn 命令行值得一试️不依赖应用运行zn 直接读写本地笔记库文件桌面应用开着或关着都能用⚡无需安装 Node它在应用安装时随包提供在设置 → CLI 中启用开箱即用可脚本化几乎所有命令都支持--json方便接入 CI、定时任务AI 友好zn mcp一条命令就能让 Claude / Codex 等 AI 助手操作你的笔记库命令总览和快速帮助见 help.ts命令分发逻辑在 index.ts。1️⃣ NOTES 命令组笔记的完整生命周期管理14 个子命令覆盖笔记从创建到删除的每一步实现在 notes.ts命令作用zn list列出笔记按最近更新排序支持--folder--tag--limitzn read path输出笔记正文到终端--meta只看元信息zn create新建笔记正文可来自--body或管道stdinzn append / prepend在笔记末尾 / 开头追加内容安全推荐优先使用zn write整体替换正文有破坏性谨慎zn rename / move重命名或跨文件夹移动笔记zn archive / unarchive归档与取消归档zn trash / restore软删除进回收站 / 从回收站恢复zn delete --yes永久删除必须加--yes确认zn duplicate在原地复制一份笔记zn list --tag idea --limit 5 pbpaste | zn append inbox/Daily.md --body - 小技巧--body -表示从管道读取内容配合pbpaste、cat等命令可以把任何文本一键写进笔记。2️⃣ SEARCH 命令组全文搜索、标题匹配与反向链接搜索相关命令在 search.ts命令作用zn search query全文搜索输出路径:行号 片段zn search-title q按标题子串匹配笔记zn backlinks path找出所有通过[[wikilink]]链接到该笔记的页面zn search deadline --json zn backlinks inbox/Plan.md编辑器中 wikilink 的解析状态有效链接与未解析链接长这样backlinks是构建笔记知识网络的核心——配合应用内的 Connections 面板终端与图形界面看到的是同一套链接数据。3️⃣ FOLDERS 命令组子文件夹批量管理文件夹操作实现在 folders.ts。所有子文件夹路径都以inbox/、quick/、archive/开头命令作用zn folder list列出库内所有子文件夹zn folder create inbox/Work新建子文件夹zn folder rename p --to newPath原地重命名不能跨顶层文件夹zn folder delete p --yes删除子文件夹及其全部内容4️⃣ TAGS 命令组标签总览与按标签检索标签命令在 tags.tszn tag list # 所有 #tag 及各自笔记数按数量排序 zn tag find idea --limit 20 # 找出打了 idea 标签的笔记zn tag list的输出是标签 → 数量的排名表非常适合快速发现笔记库里的主题分布。5️⃣ TASKS 命令组跨笔记任务清单与一键勾选任务命令在 tasks.ts直接解析所有笔记中的 Markdown 复选框zn task list --unchecked --tag work zn task toggle id # 用 task list 输出的稳定 id 勾选/取消输出会显示任务状态符号[ ]待办、[/]进行中、[~]等待、[]已转发、[x]完成--due与优先级信息会一并展示无需打开应用就能清完今天的任务6️⃣ COMMENTS 命令组让 AI 也能参与的评论线程评论命令在 comments.ts与 MCP 工具完全等价命令作用zn comment list path查看某笔记的评论线程含锚定文本与回复zn comment add path ...发起评论可用--anchor锚定到正文某句话zn comment reply path id ...回复某条评论zn comment resolve path id解决线程--reopen重新打开典型场景让 AI 通过--author Claude在笔记上留下批注你随时用终端查看和回复。7️⃣ VAULT 命令组查看库状态与多库切换库管理命令在 vault.tszn vault info # 当前库路径 各文件夹笔记数安装后体检第一步 zn vault list # 所有已知库与服务器默认库用 * 标记配合全局参数--vault 名称或路径、--server 名称或地址可以在多个笔记库和自建服务器之间自由切换详见 docs/how-to/connect-desktop-to-remote-server.md。8️⃣ DATABASES 命令组用 base 子命令操作数据库表格表格base命令在 base.ts与图形界面网格共用同一套写入逻辑结果逐字节一致命令作用zn base list列出库内所有数据库zn base create Meetings --folder inbox创建空数据库zn base rows Meetings列出某库的行id、标题、字段zn base get base row按行 id 或标题值查看单行zn base add base --set 标题X新增一行--body可顺带生成记录页面zn base set base row --set 状态完成修改字段select 选项自动创建zn base add Meetings --set 标题周会 --set 日期2026-10-01三个特别嘉宾capture / open / mcp命令一句话说明zn capture 灵感无摩擦快速记录自动落进 inbox支持管道输入capture.tszn open 文件/文件夹把 Markdown 文件、文件夹甚至整个笔记库直接交给桌面应用打开open.tszn mcp启动 MCP stdio 服务器供 Claude / Codex 调用笔记工具mcp.tsecho meeting notes | zn capture --tag work zn open ~/Downloads/notes.md zn open ~/code/myproject/docs # 把一个文件夹作为聚焦会话打开搜索笔记并打开的方式不止命令行一种菜单栏扩展同样可以一键直达全局参数速查表参数 / 环境变量作用--vault 名称\|路径指定目标笔记库--server 名称\|地址指定自建服务器优先于--vault--json输出机器可读的 JSONZENNOTES_VAULT未指定--vault时的默认库根目录ZENNOTES_SERVER/ZENNOTES_REMOTE_TOKENCI 与无头环境下的默认服务器与令牌完整参数定义见 help.ts。结语zn 命令行把 ZenNotes 的笔记、搜索、任务、标签、评论、数据库能力全部搬进了终端人可以用它快速记录与检索脚本可以用它自动化AI 可以通过zn mcp直接上手管理你的知识库。建议先运行zn --help看一遍彩色命令清单再从zn capture和zn list两个命令开始体验。更多背景阅读how-zennotes-works.md、desktop-cli-tui-migration.md、open-markdown-files.md。【免费下载链接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.项目地址: https://gitcode.com/gh_mirrors/zenn/zennotes创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表