NexaNote 桌面版 · CLI

让笔记进入 PowerShell、脚本和自动化流程

创建、追加、捕获、搜索、任务、反向链接、图谱和 OCR 状态,都可以从本机命令行调用。

一、安装与配置

NexaNote 桌面版附带独立的 nexanote.exe。打开新的 PowerShell 窗口后先执行:

nexanote --version
nexanote config set-notes-dir "D:\Notes"
nexanote status

如果命令还不可用,可在安装目录执行 NexaNote.exe install-cli,然后重启 PowerShell。也可以为单次命令传入 --notes-dir,或设置环境变量 NEXANOTE_NOTES_DIR

二、创建、追加和快速捕获

nexanote new "会议记录" --content "讨论发布计划" --tags 会议,项目 --open
nexanote daily --append "今天完成网站更新" --open
nexanote append "会议记录" "补充:周五发布"
nexanote capture "稍后整理这条灵感" --tags 收集箱
nexanote open "会议记录"

daily 使用与桌面端相同的 Daily/年/月/日期.md 结构。带 --open 时,命令会启动或通知桌面端打开目标笔记。

三、搜索、任务和知识关系

nexanote search "项目复盘" --json
nexanote task add "整理访谈" --note "今日行动"
nexanote task list --status todo --json
nexanote tag list --json
nexanote backlinks "产品方案" --json
nexanote graph export --json
nexanote ocr status --json

搜索前 CLI 会扫描笔记目录并更新索引。graph export 输出节点和连接,适合进一步生成报告或可视化;ocr status 用于检查本地图片与 PDF 文字索引进度。

四、JSON、本地 API 与 URI 协议

  • 多数查询命令支持 --json,便于 PowerShell、Python 或其它工具读取。
  • nexanote api serve --port 8765 启动仅监听本机的命令接口。
  • nexanote mcp manifest 输出自动化能力说明,方便本地工具发现命令。
  • nexanote://open?title=会议记录nexanote://search?q=项目nexanote://daily 可从浏览器或其它应用唤起桌面端。

五、安全与排错

  • 自动化前先备份笔记目录,尤其是循环追加或批量创建脚本。
  • 标题或路径含空格时使用双引号;PowerShell 中注意转义引号。
  • 本地 API 只应在可信电脑上使用,不要通过代理或端口转发暴露到公网。
  • status 中的笔记目录不正确时,重新执行 config set-notes-dir
  • 命令修改文件后桌面端未更新时,保存当前编辑并重建索引。