跳到主要内容

笔记

Notes 是独立于聊天或 Work 任务的持久 Markdown 文档。可用于简报、研究记录、检查清单、草稿，或希望在对话和模型选择变化时仍保留的任何资料。

Notes 页面以只读预览打开现有笔记。要修改时请选择 编辑；更改会在短暂延迟后自动保存。列表支持搜索，固定笔记会保持突出显示，Cmd/Ctrl-K 可搜索自己和共享的笔记内容，而无需在磁盘上维护明文搜索索引。

使用 Tab 将焦点移到列表中的某条笔记，然后按 Enter 或空格键打开它。当前笔记会向辅助技术标明。搜索没有匹配结果时，清除 会恢复完整列表，并把焦点返回到搜索框。

Markdown 预览与导出​

预览会渲染标准 Markdown，包括表格。它还支持经过清理的基本内联 HTML 和 SVG：脚本、事件处理程序和不安全 URL 会在结果进入页面前移除。

导出 将当前笔记内容下载为 .md 文件。导出为纯文本，不含附件或修订历史；请像保护笔记的任何其他副本一样保护它。

修订与恢复​

每次标题或内容更改都会在提交更新前保存旧标题和内容。修订 标签页显示保留版本，以及它们与当前笔记的逐行差异。恢复旧修订时会先保存当前状态，因此恢复操作本身也能撤销。

Libre 为每条笔记保留最新 50 个修订。仅更改固定状态不会创建内容修订。

附件​

附件 标签页可上传、列出、下载和删除与笔记关联的文件。每条笔记最多 10 个附件，每个不超过 10 MiB。附件字节以笔记所有者身份使用平台 Blob 存储，因此配额、加密、备份和删除行为遵循所选个人或团队存储配置。

下载会重新授权笔记访问，使用 private, no-store，以带 nosniff 的附件形式提供，不会在页面中渲染任意上传内容。Libre 目前不会扫描附件字节中的恶意软件。下载后应将他人提供的文件视为不可信。

共享​

所有者可向另一位已验证用户授予：

  • 读取——打开笔记、查看修订并下载附件。
  • 写入——还可编辑内容、恢复修订、管理附件和使用 AI 辅助编辑。

每次请求都会检查授权，因此撤销授权会在下一次读写时生效。只有所有者可以固定、共享、撤销共享或删除笔记。全局管理员角色本身不会授予私人笔记内容的访问权限。

Notes 不是公开链接，编辑器也不是同步协作界面：两人同时编辑时没有在线状态、共享光标或合并协议。

AI 辅助编辑​

辅助 标签页会向应用中选定的模型和提供商发送指令、笔记标题和当前 Markdown。模型返回完整替换建议，Libre 以差异形式显示。放弃 不做修改；应用 使用普通更新路径，因此会把旧状态保留为修订。

生成建议不会保存，应用建议才会。远程提供商会依据其保留、隐私和计费条款收到笔记内容和指令；笔记必须保留在已配置的 Ollama 基础设施中时，请选择本地模型。辅助指令最多 4,000 个字符，建议必须符合普通笔记内容限制。

将 Notes 用作聊天工具​

启用聊天工具后，受支持模型可以使用：

  • list_notes 和 read_note 读取已授权的自有或共享笔记；
  • create_note 创建笔记，需要副作用审批；
  • update_note 更新笔记，也需要审批，并把旧内容保存为修订。

笔记工具以调用用户身份运行。它们读取 Markdown 内容，而不读取附件字节。隐身聊天不提供工具。

存储、加密与可移植性​

标题、内容和保留修订由应用加密服务进行静态加密。附件使用平台加密 Blob 存储。这是应用级保护，不是全盘或端到端加密；请将数据库、Blob 存储、备份和加密密钥作为一个部署边界保护。

按用户划分的版本化存档包含当前 Notes 及固定状态，但有意排除修订历史和附件。因此，完整服务器恢复需要数据库、加密材料和相关 Blob 存储，而不只是用户存档。参阅数据可移植性和恢复就绪。

限制​

项目限制
每位用户拥有的 Notes100
标题200 个字符
Markdown 内容200,000 个字符
每条笔记保留的修订50
每条笔记的附件10
附件大小每个 10 MiB
AI 编辑指令4,000 个字符

API​

所有路由都需要已验证会话，或具有 notes 范围的 API 令牌。共享笔记访问遵循与界面相同的读写规则。

方法路径用途
GET/api/notes列出自有和共享笔记
POST/api/notes创建笔记
GET/api/notes/:noteId读取笔记
PUT/api/notes/:noteId更新内容、标题或固定状态
DELETE/api/notes/:noteId删除自有笔记
GET/api/notes/:noteId/revisions列出保留修订
POST/api/notes/:noteId/revisions/:revisionId/restore恢复修订
GET/api/notes/:noteId/attachments列出附件
POST/api/notes/:noteId/attachments上传附件
GET/api/notes/:noteId/attachments/:attachmentId下载附件
DELETE/api/notes/:noteId/attachments/:attachmentId删除附件
POST/api/notes/:noteId/assist生成不持久化的编辑建议

相关文档​