这个项目能做什么
Cognote 是一个面向个人 Markdown 知识笔记的本地 Web 智能笔记系统,强调私有化部署与本地文件存储。它自动递归扫描指定目录下的 Markdown 文件,按目录树与标签组织,并提供全文检索、AI 辅助整理与浏览器内编辑能力。
主要功能
- 笔记浏览与检索:左侧目录树展示分类,点击文件夹筛选、点击笔记打开;顶栏支持中英文混合全文搜索,结果按相关度排序并高亮;右键菜单可新建、编辑、归类、删除或打开本地位置。
- 中文全文检索:自建中文 bigram 加英文分词的倒排索引,采用 TF-IDF 加权排序,解决中文分词与倒排检索问题。
- Markdown 编辑:集成 Vditor 3.10.8,支持即时渲染、所见即所得与分屏预览三种模式,支持 KaTeX 数学公式、Mermaid 图表与代码高亮;标题、标签(frontmatter)与正文分离,保存实时落盘。
- AI 智能归类:分析当前笔记,返回建议分类、标签、摘要与关键词,可一键应用。
- AI 知识扩展:可将扩展内容追加到当前笔记末尾,或生成独立的新笔记文档。
- 复习与自测:生成一页纸复习摘要(重点、命令、易错点、自测题),基于当前笔记及同分类笔记生成问答自测题,并可就笔记内容向 AI 提问且标注来源。
技术特点
- 后端零依赖,仅需 Node.js 22 及以上,使用内置 http、fetch、fs、exec 模块,配合内存倒排索引。
- 前端为原生 HTML/CSS/JS 单页应用,搭配自写轻量 Markdown 渲染器。
- AI 支持 DeepSeek、OpenAI、Anthropic Claude、Moonshot、智谱 GLM、通义千问以及自定义 OpenAI 兼容协议服务商,可在配置文件或 Web 界面中设置。
- 提供 HTTP API,涵盖目录树、检索、笔记读写与移动删除、AI 归类/扩展/摘要/自测/问答、重建索引、配置读写以及笔记引用关系图。
使用方式
克隆仓库后复制 config.example.json 为 config.json,填写笔记目录、端口与 AI API Key,运行 npm start 后访问本地端口即可。未配置 API Key 时,笔记浏览、检索与编辑仍可正常使用,仅 AI 功能会提示配置。项目提供 macOS 与 Windows 的启动脚本。
项目采用 MIT 许可证,路线图显示已实现核心索引检索、索引持久化增量更新、批量归类、双链引用关系视图以及基于遗忘曲线的复习计划等功能。
评论
0 评分人数达到10人后显示
登录后参与讨论。