在团待过的人,大概都对“学城”有种特殊的感情。

用了几年,从技术笔记到项目复盘,再到各种琐碎的灵感记录,早就习惯了它的交互和逻辑。但学城毕竟是内部工具,离职那天起,我就陷入了一个尴尬的境地:市面上不是没有文档工具,语雀、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里了,按需选择就行。

技术栈一览

选型

备注

后端

Django 4.2 + DRF

稳,生态好

异步

FastAPI + Celery + Redis

健康检查、定时任务

前端

Vanilla JS + LayUI + SortableJS

没上React/Vue,轻量SPA

编辑器

Vditor + Luckysheet

Markdown IR + 在线表格

搜索

Whoosh+jieba / ES / Meilisearch

可切换

存储

本地 / OSS / COS / S3兼容

按需配置

部署

Docker Compose + uWSGI + Alpine

一键起服务

前端没用框架是刻意的选择——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(保留版权标识即可)

“爱要春风化雨,思必汇流成渊。” 愿每个认真记录的人,都能找到属于自己的那片知识土壤。

文章作者: 嘿手大叔
本文链接:
版权声明: 本站所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 i·Space
生活琐碎 wiki
喜欢就支持一下吧
打赏
微信 微信
支付宝 支付宝