Nota 功能概览

Nota 用来保存和管理 Agent 做出来的东西：把文档、方案、接口说明、图表等成果，从对话里变成能随时查看、整理、修改和分享的文件。

1. 保存 Agent 的成果

• 在 Claude Code 或 Codex 中调用 /nota 或 $nota，让正在工作的 Agent 保存这次产出的内容。
• 支持文档、计划、API 参考、Mermaid 图、HTML 页面内容和备忘录等类型。
• 可以指定文件夹；没有合适去处时进入收件箱，并附上建议位置和理由。
• 同一份内容继续修改时保存新版本，保留已有文件的历史。

2. 文件与文件夹管理

• 通过收件箱、最近、文件夹、模板、归档、回收站浏览内容。
• 支持多级文件夹，以及文件和文件夹的重命名、移动等操作。
• 文件可以修改类型、归档、取消归档、移入回收站或恢复。
• 支持批量移动、归档、删除，以及多种操作的撤销。
• 搜索覆盖标题和正文，也能找到已归档的文件。

3. 阅读、编辑与附件

• 以 Markdown 排版阅读内容，展示代码、表格、引用、清单、图片和 Mermaid 图。
• 可以直接新建或编辑文件，在编辑与预览之间切换。
• 编辑时可从照片或文件选择器添加附件；图片嵌入正文，PDF 可在文件中阅读，其他附件提供下载入口。
• 保存时若发现其他设备或 Agent 已更新文件，会保留当前草稿并提示冲突，让用户决定如何处理。

4. 历史版本

• 查看每次修改的版本、时间、修改者和变更说明，打开任意历史版本的全文。
• 恢复旧版会生成新版本，之前的历史仍然保留。

5. 模板复用

• 提供内置模板，也允许建立和编辑自己的模板。
• 可以把已有文件设为模板，定义章节、每节应该写什么、产出类型和默认文件夹。
• 通过 /nota 模板名 让 Agent 按模板生成内容；自定义同名模板优先于内置模板。

6. 只读分享

• 为同一份文件创建多条独立分享链接，分别管理用途和访问范围。
• 支持知道链接即可访问、凭口令访问、指定邮箱登录访问三种方式。
• 可以让链接始终显示最新版，也可以固定某一版。
• 支持设置有效期、查看打开次数、更换口令和撤销链接。
• 分享链接可以单独开启或关闭反馈。

7. 收集反馈并继续迭代

• 收件人通过分享链接留下意见，意见可关联引用段落、具体版本和反馈人。
• 文件页查看该文件的全部反馈；反馈页集中查看各文件尚未处理的意见。
• 反馈可以标为已解决、不改了，或重新打开。
• 通过 /nota feedback 让 Agent 根据反馈整理修改并产出下一版。

8. Agent 协助整理

• /nota tidy 可提出合并重复文件、移动、归档和新建文件夹的建议，并说明理由。
• 用户逐项选择后执行；新建文件夹默认不勾选。
• 已执行的整理在 7 天内可以撤销。

9. 多端与个性化

• 提供网页、Mac、iPhone 和 iPad 入口，并通过命令行接入 Agent 工作流程。
• iPhone 使用逐层导航；iPad 提供侧栏、文件列表、阅读区三栏布局，以及拖放和键盘快捷键。
• 支持邮箱验证码和 Apple 登录。
• 提供深浅色外观、经典与清晰两种阅读字体，以及八种界面语言。

导出文件为 PDF 在当前界面中仍标为即将推出；上传并阅读 PDF 附件已经有对应实现。

这份概览依据当前 MDNota 项目的说明、功能代码和本机 nota 技能指引整理。