没有学城可用,我给自己造了个“平替”:爱思文档
在团待过的人,大概都对“学城”有种特殊的感情。
用了几年,从技术笔记到项目复盘,再到各种琐碎的灵感记录,早就习惯了它的交互和逻辑。但学城毕竟是内部工具,离职那天起,我就陷入了一个尴尬的境地:市面上不是没有文档工具,语雀、Notion、飞书文档……个个都好用,可要么数据不在自己手里心里不踏实,要么功能太重、订阅费太贵,要么就是少了点当年在学城里那种“顺手”的感觉。
这种别扭持续了挺久。直到今年AI浪潮起来,我想着与其继续挑挑拣拣,不如借着这股劲儿,自己动手搞一个。不为别的,就为找回那点熟悉感,顺便把这几年攒下的知识管理习惯固化下来。
于是就有了「爱思文档」(i·Space Doc)。
为什么叫“爱思”?
名字取自域名ispace和slogan:“爱要春风化雨,思必汇流成渊”。没什么宏大的寓意,就是觉得做知识管理这件事,急不得,得像春雨一样慢慢浸润;思考沉淀下来,才能汇成自己的体系。至于英文 i·Space,既是 ispace.top 域名的延伸,也想表达“个人知识空间”的意思。
目前它已经部署在 https://doc.ispace.top/ ,作为我自己的主力知识库在用,同时也开放注册供大家体验。代码全部开源在 GitHub:https://github.com/ispace-top/ispace_doc 。
它长什么样?
简单说,你可以把它理解为一个可以私有部署的语雀,或者支持团队协作的GitBook。
核心设计理念借鉴了Linux“一切皆文件”的哲学——在这里是“一切皆文档”。不搞复杂的知识库层级嵌套,就用统一的文档模型来承载知识组织、权限管理和协作。
几个我自己用得最多的点:
双编辑器兜底 :默认是Vditor的Markdown IR模式(所见即所得,写起来很顺),但也保留了iceEditor富文本编辑器。偶尔需要贴复杂表格或排版时,切过去就行。甚至内嵌了Luckysheet在线表格,直接在文档里编辑Excel。
三栏布局+大纲导航 :左侧文档树、中间正文、右侧大纲,这是我最习惯的阅读结构。大纲面板支持滚动跟踪,长文档跳转很方便。
内容块足够丰富 :除了常规的图文附件,还支持数学公式、思维导图、流程图、ECharts图表、Callout提示块。写技术文档时画个时序图、插个监控图表,不用跳出编辑器。
全文搜索带中文分词 :基于Whoosh + jieba,搜中文不会像某些工具那样乱匹配。生产环境如果上了Elasticsearch,搜索响应能压到毫秒级。
历史版本+批量导入 :自动保存快照,支持diff对比和回滚。老笔记可以用.md/.txt/.docx批量导进来,迁移成本不高。
给团队用的话,够用吗?
虽然是为自己造的轮子,但既然开源了,还是按企业级标准去设计的。
权限方面做了三级细粒度授权(用户/分组/组织节点),三线合并取最大权限。组织架构支持物化路径算法,可以和企业微信、LDAP同步。认证体系是可插拔架构,OIDC、企业微信扫码、钉钉、LDAP、本地密码都能独立开关,后台可视化配置。
协作上支持划词评论(带锚点重定位)、@提及通知、8种站内/邮件通知类型。管理后台有仪表盘、系统健康评分、审计日志、水印保护这些运维向的功能。
部署也尽量做到了开箱即用:Docker单容器适合个人或小团队(空闲内存约120MB),Docker Compose全栈模式适合20人以上生产环境。三种模式的性能基准测试都写在README里了,按需选择就行。
技术栈一览
前端没用框架是刻意的选择——Vanilla JS足够应付这个体量的交互,打包体积小,维护负担也轻。
写在最后
这个项目早期参考了MrDoc的架构设计,在此感谢作者。也感谢Django、Vditor、LayUI、jieba等一众优秀开源项目,没有它们就没有爱思文档。
目前版本是v0.9.0-dev,还在持续迭代。如果你也曾怀念某个内部工具的手感,或者只是想找一个数据完全自控的知识管理平台,欢迎来试试。
演示站:https://doc.ispace.top/
源码:https://github.com/ispace-top/ispace_doc
协议:GPL-3.0(保留版权标识即可)
“爱要春风化雨,思必汇流成渊。” 愿每个认真记录的人,都能找到属于自己的那片知识土壤。
微信
支付宝