note-gen 完整上手指南：3 步把碎片记录整理成结构清晰的 AI 笔记
【免费下载链接】note-genCapture first. Organize later. A local-first Markdown app that turns scattered records into clear notes with AI.项目地址: https://gitcode.com/GitHub_Trending/no/note-gen
note-gen 是一款本地优先的 AI 笔记工具，能把文字、语音、截图、链接等碎片记录一键整理成结构清晰的 Markdown 笔记，适合想快速用上 AI 写作的入门用户和素材众多的内容创作者。克隆仓库、装好依赖后，3 分钟就能开始记录。
它是什么 & 解决什么问题
一句话定位：note-gen 是一个"先记录、再整理"的 AI 笔记应用——灵感出现时先存下来，需要时再让 AI 帮你把它们组织成一篇完整的笔记。
| 你遇到的痛点 | note-gen 怎么解决 |
|---|---|
| 有想法时还要先想好标题、目录、结构，一犹豫就丢了 | 把"记录"和"整理"拆成两步：记录零门槛，整理可以推迟到任何时候 |
| 素材散落在聊天记录、截图、录音、浏览器标签页里，汇总很费劲 | 文字、录音、截图、链接、文件、待办都能收进同一个地方，按标签筛选后批量整理 |
| 笔记存在专有格式里，迁移、备份、全文搜索都不方便 | 笔记就是你自选工作区里的普通 Markdown 文件，还能建知识库做语义 + 文本双路检索 |
快速上手：3 分钟把项目跑起来
先确认环境满足这三项要求：
- Node.js 18.18 或更高版本
- pnpm 包管理器
- Git（用于克隆仓库）
然后按顺序执行 3 条命令：
git clone https://gitcode.com/GitHub_Trending/no/note-gen cd note-gen pnpm install启动开发服务器：
pnpm dev启动后终端会提示服务运行在 3456 端口，用浏览器打开http://localhost:3456即可。首次打开时，你会先选择一个存放 Markdown 文件的工作区目录，然后看到三大核心区域：左侧的文件管理面板、中间的编辑器、以及 AI 助手入口。此时不需要配置任何 AI 服务，就能先创建笔记、保存记录。
跟着场景用
场景一：我想把开会时的零散素材一次变成一篇成稿
这是 note-gen 最核心的用法，全程 4 步：
- 打开"记录"页，用对应按钮随手存素材：一句话、一段录音、一张截图、一个链接、一个待办，不用先起标题。记录模块的实现见 src/app/core/main/mark/。
- 会后（或周末），按标签或时间筛出属于同一主题的素材。
- 勾选这些记录，点"整理成笔记"，选一个现成模板，或直接用一句话描述你想写什么。
- 在编辑器里检查生成的草稿：不满意的段落直接改写或删除，它始终是普通 Markdown，你说了算。
提效小技巧：给每个项目或会议打一个专属标签，整理时 3 秒就能把一周的素材聚齐，不用翻找。
场景二：我想接着没写完的段落继续写，不卡壳
- 打开笔记，把光标停在段尾或选中一段文字。
- 调出 AI 菜单，选择续写、扩写、缩写、润色或翻译。
- 对结果不满意就重新生成，满意就接着往下写。
AI 各能力的实现集中在 src/lib/ai/，聊天、写作、翻译等任务可以各用各的模型。
提效小技巧：日常续写配一个响应快的模型，深度改写再换强模型，速度和效果可以分开调，不必一刀切。
场景三：我想翻出很久以前存的旧笔记和素材
- 在设置里为工作区文件建立知识库。
- 发起对话时，直接引用某一篇笔记、一组记录或整个知识库作为上下文。
- AI 会先检索本地材料再作答，回答里能直接定位到原始出处。
检索逻辑（语义检索 + 本地文本搜索结合）见 知识库检索源码。
提效小技巧：找"意思相近"的内容用语义检索，找"包含某个词"的原文用文本搜索，两条路都能走。
场景四：我想把同一类文档反复写得又快又规范
- 进入"模板"设置页，为会议纪要、读书笔记、周报这类常写文档各建一个模板。
- 新建笔记或整理记录时选择对应模板。
- 结构自动就位，你只负责填内容。
模板设置入口在 src/app/core/setting/template/。
提效小技巧：把模板和标签配合使用——每周固定标签 + 周报模板，周报基本是"筛选 + 一键整理"两步完成。
个性化 & 进阶配置
高频配置只有 3 项，都在设置页里完成：
| 配置项 | 位置 | 调什么 |
|---|---|---|
| AI 模型 | 设置 - AI | 为聊天、写作、嵌入、图片识别、OCR、音频 6 类任务分别指定服务商和模型 |
| 跨设备同步 | 设置 - 同步 | GitHub、GitLab、Gitee、Gitea、S3、WebDAV 六选一，也可以只做本地备份 |
| 编辑器与快捷键 | 设置 - 通用 / 快捷键 | 字体大小、主题、工具栏项和全部快捷键的自定义 |
实现参考：同步设置源码、AI 设置页源码。
常见问题
Q：不联网能用吗？可以。笔记全部以本地 Markdown 文件存储，记录、编辑、搜索、打印都离线可用；只有调用 AI 功能时才需要配置 AI 服务。
Q：笔记会被锁在这个软件里吗？不会。你的工作区里就是普通的 .md 文件，用任何 Markdown 编辑器都能打开，也可以直接放进 Git 管理或整体拷贝。
Q：刚上手不知道选哪个 AI 模型？先只配置"聊天"和"写作"两个任务，选一个你能访问的服务商即可；其余任务类型用到时再配，随时可以改。
Q：怎么防止数据丢失？两个办法叠加：在"备份"设置页开启本地备份，再按需开启云同步；最保险的还是定期把整个工作区目录拷一份。
现在开始你的第一条记录
打开应用，选一个工作区，把今天随手想到的一句话存成记录——剩下的整理工作，等素材攒够了再交给 AI。更多功能细节（同步、知识库、MCP、Skills 等）可以参考 README 中文说明 和 AI 服务商连接测试记录。
【免费下载链接】note-genCapture first. Organize later. A local-first Markdown app that turns scattered records into clear notes with AI.项目地址: https://gitcode.com/GitHub_Trending/no/note-gen
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
