yenche123/liubai

TL;DR

Liubai 是一个开源、AI 增强的个人知识库与任务管理器，可在网页、微信与 VS Code 上运行。它让您能捕捉笔记、行程、待办事项并附加丰富媒体，然后选择性地直接从微信使用大型语言模型（DeepSeek、Kimi、MiniMax 等）进行查询或扩充。

功能特色

功能	说明
原子化卡片	每一项信息（文字、图片、文件、标签、状态）都存在自己的“卡片”中，可以展开或隐藏。
跨平台 UI	响应式网页应用 (PWA)、微信小程序与 VS Code 扩展功能，皆共享同一个后端。
AI 辅助	连接多个 LLM 提供者；您可以从微信内要求 AI 根据卡片内容进行总结、生成或绘图。
离线优先	网页前端使用 service-worker + Dexie (IndexedDB)，让您在没有网络连接时也能读写卡片；连接恢复后自动同步。
隐私控制	每张卡片皆可标记为“仅限本地”或“禁止 AI 读取”，提供细致的数据所有权控制。
同步与协作	透过 Laf 后端进行云端同步；可与微信联系人分享协作任务清单。
深色/浅色模式与国际化	内置主题切换与中英文语言切换。
VS Code 快速笔记	轻量级扩展功能，让您无需离开编辑器即可建立卡片。

运作方式（高阶架构）

liubai-backends/
│   └─ liubai-laf   ← 基于 Laf 框架构建的后端（云端函数位于此处）

liubai-frontends/
│   ├─ liubai-web          ← Vue 3 + Vite PWA (透过 Dexie 进行离线存储)
│   ├─ liubai-weixin       ← 微信小程序 (Skyline + Chat Tool API)
│   └─ liubai-vscode-extension ← VS Code 插件 (TypeScript, 使用 esbuild 打包)

liubai-docs/ ← 使用 VitePress 构建的文档网站

后端提供卡片 CRUD、同步以及将 AI 请求路由至已设定 LLM 服务的 API。
网页 PWA 与后端通讯，在本地快取数据，并注册 service-worker 以供离线使用。
微信小程序 使用官方 客服消息 API 与新的 Chat Tool API，让使用者能直接在微信中与 AI 助理对话并管理任务。
VS Code 扩展功能 提供指令面板入口，可建立新卡片并推送到同一个后端，确保笔记与其他客户端保持同步。

谁适合使用？

知识工作者：需要一个整合笔记、日历事件与待办事项，且能透过 LLM 增强的单一平台。
微信重度使用者（特别是在中国）：偏好在已使用的应用程序内完成所有工作。
开发者：喜欢开源、可自架，作为专有“AI 驱动”笔记服务的替代方案。
重视隐私的人士：因为每张卡片都可以保留在本地并排除在 AI 处理之外。

开始使用

阅读文档 – https://docs.liubai.cc (安装指南、LLM API 密钥、部署步骤)。
部署后端 – 遵循 Laf 指示；存储库已包含 cloud-functions/ 文件夹。
运行网页客户端 – cd liubai-frontends/liubai-web && bun install && bun run dev。
选用 – 从市集安装或本地构建 VS Code 扩展功能，及/或扫描 QR Code 使用微信小程序。

授权

AGPL-v3 – 您可以运行、修改并托管自己的实例，但任何透过网络提供的修改必须公开源代码。

以上所有细节均直接取自存储库的 README。