把零散的技术经验,整理成可以持续积累的知识库
面向程序员、技术管理者、自学开发者,以及长期积累技术资料的人。 排查过的坑、读过的源码、同事给的结论通常散在聊天记录、临时文档和收藏夹里 —— 四色笔记要做的是让它们落到一个能长起来的结构里。
免费开始,浏览器打开即用;桌面客户端有 Mac / Linux / Windows 版本。
先定骨架
一级按技术栈或项目,文档内部再用标题分层级。
标记角色
红=结论、蓝=概念、绿=解法、黄=坑与陷阱。
沉淀方案
把「怎么解决的」写成可复用片段,而不是一次性的聊天记录。
检索复用
中文分词 + 文件夹范围搜索,几秒找到当年写过的那段。
接给 AI
本地 MCP 让 AI 客户端在你自己的局域网里读写这份知识。
这是一篇真实的 Git 笔记
下面这块不是截图,是四色笔记的编辑器本体。点「只看」只留结论与踩过的坑;点「蒙住」把绿色写下的处理步骤盖起来 —— 下次真遇到之前,先自己答一遍。
右上角两颗按钮就是产品里的「只看 / 蒙住」——点开试试:只看按颜色筛选, 蒙住把答案盖起来、点遮罩即可核对。 示例笔记是只读的(就是产品里的预览态,不会误改你的笔记); 想自己写一篇 → 立即体验 Web 版。 下面是同一批功能的真实界面截图。
解决过的问题,为什么还要再解决一遍
技术知识的浪费,通常不是「忘了」,而是「当时确实没地方放」。
碎片散在各处
结论在聊天记录、命令在终端历史、配置在某个临时文件里。散着就等于没有,下次只能重查一遍。
记了但没分层
一整篇里既有原理、又有命令、还有踩坑记录。要用的时候得从头读一遍才知道哪段能用。
经验没有复用路径
写过的东西没有被 AI 读到,也没进到自己的「常用片段」里。知识只在当时那一刻产生过价值。
技术笔记的骨架,应该按「你以后会怎么找它」来搭,而不是按知识本身的学科树来抄。
技术资料怎么分类,体系怎么长出来
一级文件夹按技术栈或项目分(比如「Go / 网关」「MySQL / 索引」), 文档内部再用 H1~H4 标题分层级:这一块讲什么、有哪些主要部分、坑在哪。 层级不是为了好看 —— 它是知识地图能画出来的前提。
- 骨架:文件夹 + 多级标题(H1~H4)先定结构,细节后填
- 角色:红色标结论与关键参数、蓝色标概念与定义、绿色写解法与命令、黄色标坑与陷阱
- 复用:把可复用的片段集中到同一篇「常用片段」里,而不是散落在各项目文档
- 复习:面试或复盘前用「只看」只留红色与黄色,再「蒙住」绿色解法自测一遍
| 颜色 | 在技术笔记里的用法 |
|---|---|
| 红色 | 结论 / 关键参数:这个配置到底该填什么(背景色,可被「只看」筛出) |
| 蓝色 | 概念 / 定义:机制、术语、前置知识(背景色) |
| 绿色 | 思路 / 解法:命令、代码路径、排查步骤(文字色 / 下划线 / 加粗,可被「蒙住」) |
| 黄色 | 易错 / 陷阱:踩过的坑、版本差异、别再犯的那一条(背景色) |
中文搜索:不用记住当时是怎么写的
「那次合并冲突最后到底是怎么解的」—— 你不需要记得标题、也不需要记得原话。 中文长句会先拆词再匹配,用你现在的说法去搜就行。
- 拆词匹配:不必用整句硬撞关键词
- 结果分层:标题命中与正文命中分开列出,先看标题级的
- 范围可控:从某个文件夹进入搜索时,只在当前文件夹及其子文件夹、子文档里找
- 本地执行:分词与检索在本地完成,不需要把笔记全文上传给搜索服务
结构看得见,Markdown 进出自由,AI 接得进来
技术知识管理里最容易半途而废的三件事,各有一个具体抓手。
知识地图
文件夹与 H1~H4 标题自动生成可跳转的导图:点节点回到原文对应标题,可收起 / 展开分支、按 H(n) 只看前几层。技术体系一眼看清哪里是空的。
Markdown 进出
导入 .md / .txt 时标题层级、四色标注、列表、表格一并保留,围栏代码块作为「外框」保留;导出支持 Markdown / Word / PDF。
本地 MCP
支持 MCP 的 AI 客户端可以连接你的笔记库,搜索、读取、创建、修改笔记;删除的内容进回收站。默认关闭,边界见右下方说明。
本地 MCP 的四条边界(一并说清楚,不用你猜): ① 只允许当前局域网内的设备访问,不提供公网服务; ② MCP 默认关闭,关闭后服务立即停止、访问凭证同时失效; ③ 手机 App 与 AI 客户端需要在同一局域网; ④ 请仅在可信局域网中使用。删除的内容会进回收站,不会直接消失。 能力清单见 MCP 服务说明 与 MCP 功能说明。
谁用它最顺手,谁其实用不上
技术知识库的价值取决于「你自己愿不愿意写下来」。下面三种情况差别很大,先对一下再决定要不要开始。
最划算:长期维护同一套系统
后端 / 前端 / 移动端工程师、技术管理者、自学开发者 —— 踩过的坑会反复遇到,写一次能省很多次。
也适合:资料已经在 Markdown 里
已有的 .md 资料可以导入进来继续整理,不必从零重打一遍。
不太适合:团队协同 wiki
它是个人知识库:没有多人实时协同编辑、审批流这类能力。团队文档请用专门的协同工具。
技术人常问的几个问题
技术笔记应该按什么维度分类?
只记得写过、不记得写在哪,能找回来吗?
支持 Markdown 导入导出吗?
本地 MCP 是什么?AI 会不会把我的笔记传出去?
多台设备上的技术笔记能同步吗?
适合当 wiki 或团队文档用吗?
四种颜色在技术笔记里分别记什么?
免费版能用哪些功能?
让每一次排查,都变成下一次的答案
技术栈做骨架、标题做层级、颜色分角色;需要时搜得到,递给 AI 也用得上。
浏览器打开即用 · 桌面客户端有 Mac / Linux / Windows