一、安装与配置
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。- 命令修改文件后桌面端未更新时,保存当前编辑并重建索引。