Logseq · 隐私优先的本地大纲式知识管理与协作平台 · 中文部署与使用全指南
项目仓库： https://github.com/logseq/logseq
开源协议：AGPL-3.0（以仓库 LICENSE 为准） · 技术栈：ClojureScript /
Clojure · 形态：桌面应用（Win/macOS/Linux）+ Web 版 + 移动端 ·
数据格式：Markdown / Org-mode · Linux
安装脚本：scripts/install-linux.sh
1 项目简介
Logseq（仓库名
logseq/logseq）是一个隐私优先、开源的知识管理与协作平台：聚焦隐私、长久性与用户控制权，用大纲（outliner）方式组织笔记，支持
Markdown 与 Org-mode 两种格式，提供知识管理、协作、PDF
批注、任务管理能力，并拥有插件与主题生态。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | Logseq |
| 仓库地址 | github.com/logseq/logseq |
| 项目定位 | 隐私优先的本地大纲式知识管理平台 |
| 数据格式 | Markdown / Org-mode |
| 技术栈 | ClojureScript / Clojure |
| 形态 | 桌面应用 + Web（app.logseq.com）+ 移动端 |
| 数据模型 | 文件优先（本地 .md / .org 文件） |
1.2 适用场景
- 想以大纲 / 双向链接方式做笔记、知识管理、任务管理。
- 要求笔记数据落在本地文件、隐私可控。
- 需要 PDF 批注、插件生态、主题定制。
1.3 能力边界（官方口径）
- DB 版本（DB graphs）处于 beta，RTC 实时协作与移动端 alpha，官方提示可能丢数据，建议自动备份 / 定期导出 SQLite DB。
2 功能特性
- 大纲式笔记：块级组织、双向链接、页面引用。
- 多格式：Markdown / Org-mode。
- PDF 批注、任务管理。
- 插件与主题生态：Plugin API 可扩展。
- 多端：桌面、Web、移动。
- DB 版（beta）：DB 图、RTC 实时协作。
3 官方界面预览
封面为 Logseq 官方标识。官方 README 提供动图演示。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/logseq/logseq | 源码与 README |
| 官网 | logseq.com | 产品主页 |
| 文档 | docs.logseq.com | 使用文档 |
| Web 版 | app.logseq.com | 在线版 |
| Release | releases/latest | 桌面安装包 |
| 论坛 | discuss.logseq.com | 社区 |
5 前置要求
- 桌面应用：Win / macOS / Linux。
- 数据以本地 Markdown / Org 文件保存，无需数据库。
6 方式一：下载桌面应用（官方）
# 1. 到 releases 下载对应系统安装包
# 2. 安装并启动
# 3. 选一个本地文件夹作为图谱（graph），开始写6.1 Linux 一键安装脚本
# 安装最新版
curl -fsSL https://raw.githubusercontent.com/logseq/logseq/master/scripts/install-linux.sh | bash
# 安装指定版本
curl -fsSL https://raw.githubusercontent.com/logseq/logseq/master/scripts/install-linux.sh | bash -s -- 0.10.14
# 用户级安装（无需 root）
curl -fsSL https://raw.githubusercontent.com/logseq/logseq/master/scripts/install-linux.sh | bash -s -- --user7 方式二：从源码运行
git clone https://github.com/logseq/logseq.git
# 参考 docs/develop-logseq.md（macOS/Linux）与 docs/develop-logseq-on-windows.md
# DB 版用 test/db 分支（稳定）或 master（最新）8 配置项说明
- 图谱（graph）就是一个本地文件夹，内含 Markdown / Org 文件。
- 插件与主题在应用内市场安装。
- DB 版数据为 SQLite，定期导出备份。
9 常用运维命令
# Linux 安装脚本即上述
# 日常就是打开应用，选本地文件夹开始写；文件本身即备份10 常见故障排查
- DB 版丢数据风险：官方 beta，务必自动备份 / 定期导出。
- 找不到图谱：图谱是本地文件夹，重新打开选对目录即可。
- 移动端 / RTC 还在 alpha：按官方表单申请参与。
11 风险与合规说明
- AGPL 许可；数据以本地文件保存，隐私由你自己掌控。
- DB 版 beta / RTC alpha 阶段可能丢数据，生产笔记先备份。
- 本文命令、链接来自官方 README 与文档，随版本可能调整，以 docs.logseq.com 为准。