什么是笔记
Linkly AI 的笔记是一串按时间排列的小卡片：想到什么就在底部输入框里敲一句，回车存下，它立刻变成时间线上的一张卡片。 和其他笔记软件最大的不同是——每张卡片就是磁盘上一个普通的.md 文件。没有专有数据库，没有导出功能（因为不需要），你随时可以用 Obsidian、VS Code 打开它们，也可以直接 grep。同时它们会被 Linkly AI 索引，能被搜索到，也能被你的 AI 助理读写。
快到不用想
输入框常驻在底部，写完 ⌘/Ctrl+Enter，不用新建文件、不用起标题
就是本地文件
标准 Markdown + YAML 头，任何编辑器可读可改，删了应用也还在
适合记什么
笔记的定位是短、快、事后能找到，不是写长文：- 临时想到的事：一句话待办、突然冒出的产品点子
- 读文档时的批注：一边让 AI 检索资料，一边把结论顺手记下来
- 让 AI 沉淀的结论：让 Chatbot 读完一批资料后，把要点直接写成一条笔记
- 零散信息的落脚点：会议里听到的一个数字、别人推荐的一本书
~/LinklyAI 目录里新建 Markdown 文件更合适——它同样会被索引。
打开笔记
笔记不是一个独立窗口，而是 Chatbot 窗口里的一个视图，和对话并列：- 点击 Chatbot 左侧栏的「笔记」按钮
- 或按 ⌘⇧N（Windows / Linux：Ctrl+Shift+N）
写第一条笔记
1
在底部输入框里写
笔记视图底部有一个常驻输入框，占位提示是「记点什么…用 #标签 打标签」。正文长的时候点右上角的展开按钮，输入框会原地向上增高（最高到窗口的 60%），不会弹出新窗口，草稿和光标位置都不受影响。
2
保存
按 ⌘/Ctrl+Enter，或点右下角的发送按钮。卡片会立刻出现在时间线底部。
单纯按 Enter 是换行，不会保存——这是刻意的，笔记经常要写好几行。
3
改
在卡片上点「编辑」，卡片会原地变成可编辑状态，不弹对话框。同一时刻只能编辑一张卡片。改完必须点「保存」或按 ⌘/Ctrl+Enter。
4
删
卡片右上角
⋯ 菜单 → 删除 → 二次确认。编辑器能做什么
笔记编辑器是一个纯 Markdown 文本框，不是富文本——你看到的就是源码。工具栏只有 5 个按钮：
没有斜体、标题、链接、代码块按钮——这是有意收窄的，笔记就该短。在列表里按回车会自动延续下一项。
保存后卡片进入阅读态，会正常渲染 Markdown。
阅读态里图片不会联网加载，只显示一个带 alt 文字的占位块。这是隐私设计——渲染一张远程图片等于向对方服务器泄露”你在这一刻读了这条笔记”。界面上没有字数限制，后端上限是单条 10 MiB，日常写不到。
标签
在正文里直接写#标签 就是打标签。输入 # 会弹出候选列表（最多 8 条），↑↓ 选择、Enter 确认。
保存后，标签会从正文中被摘出来，显示在卡片底部的标签条上——点击任意一个就能筛出所有带这个标签的笔记。
标签支持用 / 分层，比如 项目/客户A、读书/技术。单条笔记最多 50 个标签，单个标签 1–64 个字符。
找到一条笔记
时间线
笔记视图是一条扁平的卡片流，没有按日期分组。展示顺序恒定是「旧的在上、新的在下」，和聊天记录一样——最新的那条永远在你眼皮底下。每次加载 20 条，往上滚可以「加载更早」。排序
顶部的排序菜单有三档：排序是会话级的——关掉应用不保存，下次打开回到「最新创建」。
搜索
点顶部的放大镜，或按 ⌘/Ctrl+F。 搜索不是简单的子串匹配，走的是 Linkly AI 的全文检索（建好语义索引时是关键词 + 语义混合，否则是纯关键词）。所以搜”发布计划”也可能命中写着”上线安排”的笔记。搜索最多返回 20 条结果，没有分页。想收窄范围，先点一个标签过滤再搜。输入有约 0.3 秒的防抖，停手才会真正发起查询。
为什么刚写的笔记搜不到
这是最容易困惑的一点。笔记视图上的三块内容走的是三条不同的数据通路，时效不一样：
所以「刚写的笔记在时间线里看得见，但搜不到、
# 补全里也没有」是正常现象，等索引跑完就好了。反过来，时间线永远是最新的——它根本不查索引。
笔记存在哪里
所有笔记都在你的资料库根目录（默认~/LinklyAI）下的 Notes/ 里，按月分文件夹：
文件名规则
文件名是<正文前 10 个字>-<笔记 id 前 8 位>.md：
- 前 10 个字按 Unicode 字符计，中文一个字算一个
- 连续空白折叠成一个空格，并计入这 10 个字
- 文件系统非法字符（
/ \ : * ? " < > |）会被剔除，且不计入字数
**Launch待办清单** 的笔记，* 被剔除不计数，于是取到 Launch待办清单 这 10 个字，文件名是 Launch待办清单-91805137.md。
如果正文全是符号或空白（取不出词干），或者恰好撞上 Windows 保留名（CON、NUL 之类），就回退成时间戳命名：YYYY-MM-DD-HHMMSS-<8位id>.md。
**文件名在创建时定名，之后编辑正文不会改名。**这样文件的身份是稳定的，索引和外部引用不会因为你改了个错别字就全部失效。
文件格式
每个文件就是标准 Markdown，头部带一段 YAML front matter：
字段顺序是固定的。你手动加进去的未知字段会被原样保留，应用不会删掉它们——想塞自己的元数据是安全的。
AI 写的笔记长这样，界面上会带一个
AI 徽章：
用其他编辑器打开
顶部有个「打开笔记文件夹」按钮，会在系统文件管理器里直接打开Notes/ 目录。
因为就是标准 Markdown，Obsidian / VS Code / Typora 都能直接读写。tags: 这个字段恰好是 Obsidian 原生识别的，把 Notes/ 作为 Vault 打开就能用它的标签面板。
外部改动之后，应用下次扫描会感知到。如果你正好在应用里编辑同一条，会弹出冲突提示让你选择「重新载入」或「复制我的内容」——不会静默覆盖你的任何一边。
你也可以自由重命名文件，应用不会改回去。
让 AI 帮你记笔记
笔记可以被 AI 助理读写。本地 MCP 提供两个工具：
完整参数见使用 CLI。配置 MCP 见连接 AI 工具。
直接用自然语言指挥就行：
写一条
“把刚才这段结论记成一条笔记，打上 产品 和 待办 两个标签”
先读再写
“读一下我 ml-papers 知识库里关于 attention 的资料，把要点整理成一条笔记”
翻旧账
“列出我带 ops 标签的笔记”
- **编辑要带版本号做并发校验。**AI 编辑一条笔记时必须带上读到的
version，如果这期间笔记被改过，写入会被拒绝（NOTE_VERSION_CONFLICT），而不是盲目覆盖。 - AI 写笔记的正文格式受限：只允许段落、加粗、删除线、有序/无序列表和纯文本——和界面工具栏的能力一致。标题、斜体、代码块、链接、图片、表格会被拒绝。你自己在界面里手写不受这个限制。
- **MCP 没有删除工具。**删除笔记只能在应用界面里做。
- 标签规则不一样：这条路径不提取正文里的
#标签，只认显式传入的标签参数；而且编辑时标签是全量替换，没写上的会被删掉。
常见问题
笔记会同步到云端吗？
笔记会同步到云端吗？
Notes 目前没有专属的云同步功能，笔记以本地文件的形式保存在你的资料库目录里。需要留意的是：如果你把
Notes/ 目录加进了某个知识库，而这个知识库又绑定并推送到了云端知识库，那笔记会像其他 Markdown 文档一样被上传。想完全留在本地，就别把 Notes/ 放进要推送的知识库。按了 ⌘⇧N 没反应？
按了 ⌘⇧N 没反应？
这个快捷键只在 Chatbot 窗口聚焦时生效，不是全局快捷键。先点一下 Chatbot 窗口再按。全局唯一可用的是 ⌘⇧L / Ctrl+Shift+L（唤起搜索启动器）。
刚写的笔记搜不到，是丢了吗？
刚写的笔记搜不到，是丢了吗？
没丢。时间线直接扫文件系统，所以立刻可见；全文搜索走索引，有延迟。等索引跑完就能搜到了。同理，新标签也要等一会儿才会出现在
# 的补全候选里。能不能给笔记置顶 / 收藏 / 归档 / 导出？
能不能给笔记置顶 / 收藏 / 归档 / 导出？
目前都没有。置顶、收藏、归档暂时不在功能里；导出则是不需要——笔记本身就是磁盘上的
.md 文件，复制走就行。有归档需求的话，可以在外部编辑器里把文件挪到别的目录，但注意它会从时间线上消失（详见用其他编辑器打开）。AI 写的笔记，标签在界面上改不动？
AI 写的笔记，标签在界面上改不动？
是已知问题（issue
#171）。MCP / CLI
这条路径不提取正文里的
#标签，只写显式传入的标签参数——结果就是标签存在 YAML
里、正文里却没有对应的 #标签，而界面改标签是靠改正文的，于是改不动。临时办法：用外部编辑器直接改文件的 tags: 字段，或者在正文里补上对应的 #标签 再在界面里保存一次。删掉的笔记能找回来吗？
删掉的笔记能找回来吗？
不能。删除是直接删磁盘上的文件，不进系统回收站，应用里也没有撤销。删之前想清楚，或者先用外部编辑器备份一份。
笔记会被算进知识库的文档数量吗？
笔记会被算进知识库的文档数量吗？
会。笔记是
~/LinklyAI 目录下的普通 Markdown 文件，和其他文档一样被扫描、索引、参与检索——所以你也能在搜索启动器里搜到它们，AI 助理用 search 也能命中。