程序员 · 技术知识管理

把零散的技术经验,整理成可以持续积累的知识库

面向程序员、技术管理者、自学开发者,以及长期积累技术资料的人。 排查过的坑、读过的源码、同事给的结论通常散在聊天记录、临时文档和收藏夹里 —— 四色笔记要做的是让它们落到一个能长起来的结构里。

免费开始,浏览器打开即用;桌面客户端有 Mac / Linux / Windows 版本。

1

先定骨架

一级按技术栈或项目,文档内部再用标题分层级。

2

标记角色

红=结论、蓝=概念、绿=解法、黄=坑与陷阱。

3

沉淀方案

把「怎么解决的」写成可复用片段,而不是一次性的聊天记录。

4

检索复用

中文分词 + 文件夹范围搜索,几秒找到当年写过的那段。

5

接给 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 客户端可以连接你的笔记库,搜索、读取、创建、修改笔记;删除的内容进回收站。默认关闭,边界见右下方说明。

四色笔记知识地图:文件夹与文档生成可跳转的结构图
真实界面:知识地图由真实文件夹与标题结构生成,不是另画一张图。
四色笔记导出:支持导出 Markdown、Word 与 PDF,文件名沿用文档标题
真实界面:导出 Markdown / Word / PDF,文件名沿用文档标题,便于归档或交给别人。

本地 MCP 的四条边界(一并说清楚,不用你猜): ① 只允许当前局域网内的设备访问,不提供公网服务; ② MCP 默认关闭,关闭后服务立即停止、访问凭证同时失效; ③ 手机 App 与 AI 客户端需要在同一局域网; ④ 请仅在可信局域网中使用。删除的内容会进回收站,不会直接消失。 能力清单见 MCP 服务说明 与 MCP 功能说明。

适合谁

谁用它最顺手,谁其实用不上

技术知识库的价值取决于「你自己愿不愿意写下来」。下面三种情况差别很大,先对一下再决定要不要开始。

⌨️

最划算:长期维护同一套系统

后端 / 前端 / 移动端工程师、技术管理者、自学开发者 —— 踩过的坑会反复遇到,写一次能省很多次。

⇄

也适合:资料已经在 Markdown 里

已有的 .md 资料可以导入进来继续整理,不必从零重打一遍。

🚫

不太适合:团队协同 wiki

它是个人知识库:没有多人实时协同编辑、审批流这类能力。团队文档请用专门的协同工具。

常见问题

技术人常问的几个问题

技术笔记应该按什么维度分类?
先按「你以后会怎么找它」来分,而不是按知识本身的学科树。常见做法是一级文件夹按技术栈或项目,二级用文档,文档内部再用 H1~H4 标题分出概念、原理、坑与解法、可复用片段。四色笔记用文件夹加多级标题承载这套结构,写完可以直接生成知识地图。
只记得写过、不记得写在哪,能找回来吗?
可以。中文长句会先拆词再匹配,不必用整句硬撞;标题命中与正文命中分开列出。从某个文件夹进入搜索时,范围自动限定在这个文件夹以及它下面所有子文件夹与子文档。分词与检索在本地执行,不需要把笔记全文上传给搜索服务。
支持 Markdown 导入导出吗?
支持导入 .md / .txt,标题层级、四色标注、列表、表格会一并保留;Markdown 的围栏代码块会作为「外框」保留下来。导出支持 Markdown、Word 与 PDF。
本地 MCP 是什么?AI 会不会把我的笔记传出去?
本地 MCP 让支持 MCP 协议的 AI 客户端连接你的笔记库,可以搜索、读取、创建、修改笔记,删除的内容进回收站。四条边界一起说清楚:只允许当前局域网内的设备访问,不提供公网服务;MCP 默认关闭,关闭后服务立即停止、访问凭证同时失效;手机 App 与 AI 客户端需要在同一局域网;请仅在可信局域网中使用。
多台设备上的技术笔记能同步吗?
笔记先存在本地,联网后增量同步,通常不需要手动操作。同步只在已上线的端之间生效:网页版、Android、鸿蒙与 Mac / Linux / Windows 桌面客户端都已上线,iOS 版本仍在审核中。各端状态见 下载中心。
适合当 wiki 或团队文档用吗?
它的定位是个人知识整理与复习工具,不是团队协作文档,也不是代码托管平台。结构、检索、复习与本地 AI 都是为「一个人长期积累自己的知识」设计的。
四种颜色在技术笔记里分别记什么?
红=核心结论 / 重要设计决策、蓝=技术概念 / 基本原理、绿=实现思路 / 解决方案、黄=故障、易错点与踩坑经验。四种颜色在三个专题页含义一致;写成文字背景色的(红蓝黄)能被「只看」筛出来,写成文字色 / 下划线的(绿)能被「蒙住」遮住自测。
免费版能用哪些功能?
记录(多级标题、列表、表格、代码块、图片、公式、外框)、四色标记、知识地图、四色目录、中文搜索、Markdown 导入导出与多端同步都可以免费使用。「只看 / 蒙住」免费账户每天可对 3 篇文档使用,会员不限;单篇文档字数免费最多 20000 字、会员最多 100000 字。具体额度以应用内「会员中心」的实时展示为准。

让每一次排查,都变成下一次的答案

技术栈做骨架、标题做层级、颜色分角色;需要时搜得到,递给 AI 也用得上。

浏览器打开即用 · 桌面客户端有 Mac / Linux / Windows