HHostingByteSoftware
Ctrl K
ComunidadGuías…

README.zh-CN.md

Rama dev · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
<div align="center">

# NoteGen

**先记录，再整理。**

一款本地优先、以 Markdown 为核心，帮助你收集碎片信息，并借助 AI 将它们整理成清晰笔记的跨平台应用。

<p>
  <a href="./README.md">English</a>
  ·
  <a href="./README.zh-CN.md">简体中文</a>
</p>

<p>
  <a href="https://notegen.top/cn/">使用文档</a>
  ·
  <a href="https://notegen.top/cn/download">下载 NoteGen</a>
  ·
  <a href="https://notegen.top/business">商业合作</a>
  ·
  <a href="https://notegen.top/donate">支持项目</a>
  ·
  <a href="https://github.com/codexu/note-gen/discussions">参与讨论</a>
</p>

<p>
  <a href="https://github.com/codexu/note-gen/actions/workflows/release.yml">
    <img alt="发布状态" src="https://img.shields.io/github/actions/workflow/status/codexu/note-gen/release.yml?branch=dev&label=release&style=flat-square&logo=githubactions&logoColor=white">
  </a>
  <a href="https://github.com/codexu/note-gen/releases">
    <img alt="最新版本" src="https://img.shields.io/github/v/release/codexu/note-gen?style=flat-square&color=155eef">
  </a>
  <a href="https://github.com/codexu/note-gen/stargazers">
    <img alt="GitHub Stars" src="https://img.shields.io/github/stars/codexu/note-gen?style=flat-square">
  </a>
  <a href="https://github.com/codexu/note-gen/blob/dev/LICENSE">
    <img alt="开源协议" src="https://img.shields.io/github/license/codexu/note-gen?style=flat-square&color=0f766e">
  </a>
</p>

</div>

![NoteGen 桌面端与移动端界面](https://s2.loli.net/2025/12/22/jlpEP2c6ogwHhIA.png)

## ❤️ Sponsor

| 名称 | 介绍 |
| --- | --- |
| [硅基流动](https://cloud.siliconflow.cn/i/O2ciJeZw) | 为项目提供模型服务支持。 |
| [AIHubMix](https://aihubmix.com/?aff=6rfO) | 为项目提供赞助模型服务支持。 |
| [PackyCode](https://www.packyapi.ai/register?aff=NqBq) | 统一 API 接入主流大模型，提供 Codex、Claude Code 专属通道。 |
| [无限星河](https://www.infistar.cc/register?aff=G55F2Z5Q&ref_source=link) | 兼容 OpenAI 接口，支持多模态与知识库能力。 |
| [讯度云](https://xunduyun.com) | 香港大宽带云服务器。 |
| [![球球 Token](https://files.seeusercontent.com/2026/11/10/cYw5/qiuqiutoken-mobile-320x100.png)](https://go.qiuqiutoken.net/ABK) | 一站式主流 AI 聚合 API（Claude / GPT / Gemini / Grok），优质线路、集群容灾、自建号池，按量计费且支持对公开票；注册即享免费试用额度与新人专享套餐！ |

## 记录，不必打断当下的思路

一个想法刚出现时，可能只有一句话、一段录音、一张截图，或者一个暂时没时间阅读的链接。保存它们之前，你不必先想好标题、目录和文章结构。

NoteGen 把记录和整理分成了两个阶段。

有内容时先把它留下来。需要整理时，再选出属于同一个主题的记录，把它们组织成一篇结构清楚的 Markdown 笔记。之后可以继续修改、补充，完成自己的写作。

AI 不是来替你写完一切，而是帮助那些零散但有价值的内容，在被遗忘之前变成一篇完整的笔记。

## NoteGen 如何工作

1. **先把内容记录下来**

   随手记下一句话，录一段声音，保存截图、图片、链接、文件或待办事项。

2. **挑选真正相关的材料**

   按标签、时间或类型筛选记录，把属于同一个主题的内容选出来。

3. **把记录整理成笔记**

   选择模板，或者直接描述你想写什么。NoteGen 会根据选中的材料生成总结、报告、文章或其他结构化内容。

4. **继续完成自己的写作**

   在编辑器里检查、修改和补充内容。AI 生成的只是草稿，最终文件仍然是一篇可以自由编辑的 Markdown 文档。

## 一些真实的使用方式

- 开会时记录几句话、录一段音、截两张图，会后统一整理成会议纪要。
- 阅读时先保存链接和零散摘录，周末再把它们整理成一篇主题笔记。
- 按标签筛选最近一周的记录，快速准备周报或工作总结。
- 围绕一个主题收集图片和文档，再基于这些材料提问和写作。

记录不是一篇没写完的笔记。它更像写作之前的原材料。

## 以普通 Markdown 文件为基础

你完成的笔记会以普通 Markdown 文件保存在自己选择的工作区中。

可以继续使用 NoteGen 编辑，也可以用其他 Markdown 编辑器打开；可以把文件放进 Git，可以复制、迁移和备份，不需要先从专有格式中导出。

NoteGen 做的是在这些文件之外补充记录、AI、搜索和整理能力，而不是把你的笔记锁进另一个平台。

编辑器支持：

- 表格、任务列表、代码块、数学公式、图表和文章大纲
- Markdown 源码模式与可视化编辑
- 文本查找与替换
- 图片、附件、链接和文件引用
- 导出与打印
- 文件历史和工作区管理

## 在需要时使用 AI

NoteGen 可以连接你自己配置的 AI 服务与模型。聊天、写作、嵌入、图片识别、OCR 和音频任务可以分别选择模型。

你可以让 AI：

- 把选中的记录整理成结构化笔记
- 续写、缩写、扩写、润色或翻译已有内容
- 围绕笔记、记录、图片和知识库进行对话
- 回答问题前先检索本地材料
- 根据笔记内容生成图表和画布
- 使用 Agent 模式处理更长的任务

AI 是写作过程中的工具，不是最终作者。生成结果可以继续修改，不满意的内容也可以直接删掉。

## 让写过的内容重新派上用场

很多笔记完成后，就再也没有被打开过。

NoteGen 可以为工作区中的文件建立知识库，把语义检索和本地文本搜索结合起来。发起对话时，可以引用一篇笔记、一组记录或整个知识库，不需要反复复制原文。

如果需要更复杂的工作流，还可以使用：

- 向量索引与混合检索
- 自定义嵌入和重排序模型
- 长期记忆与可复用提示词
- MCP 服务
- 可安装的 Skills
- 用于处理笔记和文件的 Agent 工具

## 不只适合线性文档

有些内容用文章表达很清楚，有些内容更适合画出来。

NoteGen 提供独立的画布工作区，可以创建和编辑：

- 流程图
- 思维导图
- 时间线
- 自由绘制内容
- 数据图表
- 根据笔记生成的可视化结构

AI 生成的画布不会变成一张无法修改的图片，其中的节点、文字和连线仍然可以继续编辑。

## 按自己的方式同步

笔记默认保存在本地。需要跨设备使用时，可以选择自己信任的服务进行同步。

目前支持：

- GitHub
- GitLab
- Gitee
- Gitea
- S3 兼容存储
- WebDAV

不使用云同步时，也可以通过本地备份保存数据。

## 下载

| 平台 | 当前状态 | 下载 |
| --- | --- | --- |
| Windows | Beta | [下载 Windows 版](https://notegen.top/cn/download) |
| macOS | Beta | [下载 Apple Silicon 或 Intel 版](https://notegen.top/cn/download) |
| Linux | Beta | [下载 AppImage、DEB 或 RPM](https://notegen.top/cn/download) |
| Android | Alpha · ARM64 | [下载 APK](https://notegen.top/cn/download) |
| iOS | Alpha | [加入 TestFlight](https://testflight.apple.com/join/8KjFRTCq) |

如果官网下载速度不理想，也可以通过 GitHub Releases 获取安装包：

[查看最新 GitHub Release](https://github.com/codexu/note-gen/releases/latest)

## 开始使用

1. 根据自己的系统[下载 NoteGen](https://notegen.top/cn/download)。
2. 选择一个目录作为 Markdown 工作区。
3. 添加第一条记录，或者直接创建一篇笔记。
4. 需要使用 AI 功能时，再配置相应的模型服务。
5. 阅读[使用文档](https://notegen.top/cn/docs)，了解同步、知识库、MCP、Skills 和其他设置。

不需要先完成所有配置，才能开始写第一篇笔记。

## 相关仓库

| 仓库 | 用途 |
| --- | --- |
| [note-gen-docs](https://github.com/codexu/note-gen-docs) | 官网、中英文使用文档与下载页面。 |
| [note-gen-server](https://github.com/codexu/note-gen-server) | 同步服务与账号管理，支持自行部署。 |
| [note-gen-clipper](https://github.com/codexu/note-gen-clipper) | 浏览器剪藏扩展，将选中文字、图片和网页链接保存到 NoteGen。 |
| [note-gen-plugin-sdk](https://github.com/codexu/note-gen-plugin-sdk) | 插件开发所需的 TypeScript API、项目脚手架、CLI 和测试工具。 |
| [note-gen-plugins](https://github.com/codexu/note-gen-plugins) | 官方插件源码与插件市场发布工具。 |

## 参与贡献

NoteGen 是一个开源项目，欢迎参与代码、翻译、文档和产品体验方面的改进。

提交 Pull Request 前，请先阅读[贡献指南](https://notegen.top/cn/docs/contributing)。

你也可以：

- [提交 Bug](https://github.com/codexu/note-gen/issues/new/choose)
- [提出改进建议](https://github.com/codexu/note-gen/issues/new/choose)
- [参与社区讨论](https://github.com/codexu/note-gen/discussions)
- [查看待处理的 Pull Request](https://github.com/codexu/note-gen/pulls)

## 贡献者

<a href="https://github.com/codexu/note-gen/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=codexu/note-gen" alt="NoteGen 贡献者">
</a>

感谢每一位提交问题、分享想法、改进翻译、补充文档和贡献代码的人。

## 项目收录

<p>
  <a href="https://trendshift.io/repositories/12784">
    <img src="https://trendshift.io/api/badge/repositories/12784" alt="NoteGen on Trendshift" width="250">
  </a>
  <a href="https://hellogithub.com/repository/0163cb946dca44cc8905dbe34c2c987b">
    <img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=0163cb946dca44cc8905dbe34c2c987b&claim_uid=YJ39kIMBz1TGAvc" alt="HelloGitHub 推荐项目" width="250">
  </a>
  <a href="https://www.producthunt.com/products/notegen-2">
    <img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=956348&theme=light&t=1749194675492" alt="NoteGen on Product Hunt" width="250">
  </a>
</p>

## 致谢

NoteGen 使用 BrowserStack 进行兼容性测试。

同时感谢以下服务对 NoteGen 的支持：

- [七牛云](https://www.qiniu.com/products/ai-token-api?utm_source=NoteGen)
- [302.AI](https://share.302.ai/jfFrIP)
- [胜算云](https://www.shengsuanyun.com/?from=CH_KAFLGC9O)
- [Gitee AI](https://ai.gitee.com/)
- [Netlify](https://www.netlify.com)
- [Skywork](https://skywork.ai/p/bY47ky)

## 开源协议

NoteGen 使用 [GNU General Public License v3.0](./LICENSE) 开源。