在 AI 对话里，继续写笔记
v1.4 新增本地 MCP，随 x64 / ARM64 安装包提供。默认关闭，授权后只操作你的当前笔记库。无需 App 内模型 API Key，也没有云端远程接入。
连接你的 AI 客户端
- 安装软件，打开要操作的笔记库。
- 进入设置 → AI 工具接入，启用接入，按需选择「写作与插图」「分类与整理」「导出笔记」权限。
- 需要本地图片时选择「允许 AI 读取图片的文件夹」；导出时选择「导出保存位置」，点击「保存接入授权」。
- 复制 Codex 接入命令，在自己的终端运行；其他支持本地 stdio MCP 的客户端使用通用 JSON 配置。
- 按客户端要求重新加载连接，检查 wtf-notes 工具是否可用。
配置自动使用实际安装路径。App 不会改写第三方客户端配置。支持本地 MCP 是接入前提，不宣称兼容所有 AI 产品。
图片目录用于复制本地素材到笔记，原图不修改；AI 直接传入图片附件时无需设置。「允许写回原文件的同步目录」只适用于已有库外文件同步关系，普通笔记不用设置，选择目录也不会建立同步关系。
更新软件，保留 AI 连接
v1.4.2 改善 MCP 更新：固定接入路径，普通更新等待当前操作完成，再校验并切换后台版本，兼容的启动器保留已建立的客户端连接。升级保留笔记、接入授权与操作记录。
安装前保存笔记和设置，从托盘菜单正常退出 App；不需要退出整个 Codex。首次从旧版迁移，或更换启动器版本、架构时，仍需按安装提示断开本 MCP 连接一次。更新中提示 UPDATE_IN_PROGRESS 时，等安装完成再重试；文件配套失败需使用完整安装包修复。
可以做什么
搜索、读取、新建、修改、按章节追加文字，插入图片，创建分类、移动和重命名笔记。批量整理先返回正文、链接、路径与附件影响清单，确认后提交。每次修改检查版本，保留操作记录与恢复入口。
App 关闭时可读写和导出 Markdown / ZIP；ZIP 包含引用图片。Word / PDF 复用 App 的标题与排版流程，需要打开软件。当前笔记、选区和保存当前笔记同样需要 App 打开。
图片由 AI 客户端生成，MCP 保存并插入。支持 PNG、JPEG、WebP、GIF、BMP，单张不超过 20 MiB；不接受 SVG 或图片网址。首版没有删除、回收站或 App 内 Agent。
遇到问题
- 权限不足：检查接入是否启用，权限是否保存。切换笔记库后重新授权。
- 未保存内容：让 AI 先保存当前笔记，再读取新版本后修改。
- 版本冲突：重新读取；批量整理重新生成清单，不覆盖后续编辑。
- App 不可用：打开软件后使用 Word / PDF 或编辑器上下文；App 占用笔记库时不会绕过桥接直接写磁盘。
- 库外同步：涉及映射的外部文件时，单独授权来源目录。
设置里可以撤销接入、查看操作记录并恢复。恢复前检查当前版本，升级保留授权和记录，卸载不删除笔记库。
安装目录的 mcp-guide 提供完整接入说明和配套技能。
已验收客户端：Codex CLI，通过临时笔记库完成指定章节追加文字与插图。x64 安装包内程序已单独运行验证；ARM64 安装包已构建，实机安装运行仍需单独验收。