zhiliao
知了(zhiliao)是一个自托管的 AI 个人知识库系统,支持随手记一条笔记后由 AI 自动起标题、打标签、写摘要并归入主题。采用 Next.js 15 + SQLite 技术栈,提供 PWA 体验,支持关键词与语义双路检索融合重排,使用口语化转述也能召回原文措辞完全不同的笔记。
Ficha actualizada 23 sept 2026, 7:00 · upstream 23 sept 2026, 6:55 · release v0.6.0
Qué es zhiliao
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
知了是一个面向个人知识管理的 AI 助手产品。用户只需随手记录一条笔记,系统会自动识别主题、生成标题和标签,并将内容归入合适的分类中。当用户对主题选择不确定时,系统会基于已有笔记的建议新主题供其选择。核心设计理念是"找的时候不用想关键词"——通过 BM25 关键词检索与向量语义检索的融合重排机制,结合口语化转述策略,即使原文措辞与搜索词差异巨大也能精准召回相关笔记。写作时,系统会自动将相关旧笔记以摘要形式浮现在侧边栏,并提示哪些内容与当前草稿结论相反,帮助用户及时纠偏。
产品承诺 AI 不编造内容:引用功能仅放行工具真实返回的笔记 ID,来源未提及的内容会明确告知用户不存在,不会用模型自身知识进行幻觉填充。同时强调"你的字带得走"——每次保存都会将正文以纯 Markdown 格式落盘到本地目录(data/notes/主题/标题-id.md),无需联网导出,支持直接通过 Obsidian 打开该目录读取笔记、主题与标签信息。
系统采用单用户设计,响应式 Web 应用支持手机和桌面浏览器。界面提供浅色/深色/跟随系统三态切换,PWA 支持添加到主屏幕并离线使用。
- 随手记一条笔记后,AI 自动识别主题、生成标题与标签,将内容归入合适分类
- 双路召回融合检索:BM25 关键词 + 向量语义检索,支持口语化转述也能精准召回原文措辞完全不同的笔记
- AI 不编造承诺:引用功能仅放行工具真实返回的笔记 ID,来源未提及的内容明确告知不存在,不会用模型自身知识进行幻觉填充
- Markdown 导出可逆:每次变更自动生成 .md 文件到本地目录,支持直接打开 Obsidian 读取;导出的 zip 可原样导入,标题、主题、标签、时间戳与摘要逐字段还原
- 单用户设计,不支持多租户或团队协作
- 演示模式不强制要求 API Key(仅用于本地 mock),生产环境需配置外部 LLM 服务
- 未配置 Embedding 时自动降级使用 BM25 关键词检索,语义召回效果受限
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
推荐使用 Docker Compose + Nginx 部署。主路径为预构建镜像 ghcr.io/b-tech-hub/zhiliao:0.6.0(amd64/arm64),无需本地构建。启动前需锁定固定 tag,将 docker-compose.yml 中 services.app.image 改为该 tag;清空示例环境变量并设置 APP_PASSWORD 后拉取镜像启动。支持 Tailscale 网络隔离部署以实现安全访问。生产环境建议公网 HTTPS 部署,注意 Docker 镜像大小限制与 Nginx 入口请求体限流(200 MiB)。
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.