討論 – 开源软件研究

从 Trilium 到 TriliumNext：社区驱动下的功能演进与特性解读

2025 年 5 月 11 日上午 1:35 #31775

📝 版本说明：本文档基于 TriliumNext v0.101.3（2026年1月8日发布）及之前版本的功能特性编写，读者阅读时的实际功能请以官方发布为准。

一、认识 TriliumNext——开源知识管理的璀璨新星

1.1 Trilium Notes 的前世今生

Trilium Notes，作为一款开源的分层笔记应用程序，凭借其强大的个人知识库构建能力，赢得了全球众多用户的青睐，其中也包括广大的中文用户群体。该项目由开发者 @zadam 于 2017 年 12 月 25 日首次公开发布，至今已走过八年历程，见证了开源笔记软件领域的蓬勃发展。

它以树状结构组织笔记，支持笔记克隆、丰富的所见即所得（WYSIWYG）编辑（包括表格、图像、数学公式）、Markdown 自动格式化以及源代码编辑等核心功能，辅以日历视图、任务列表和地理标签等实用工具，成为个人知识管理和项目跟踪的利器。

Trilium 的核心设计理念在于”层级优先”的知识组织方式，这与 Obsidian 强调的”图谱链接”和 Notion 侧重的”数据库块”形成了鲜明的差异化定位。对于习惯树状目录思维、需要明确知识分类体系的用户而言，Trilium 提供了一种更加直观和可控的知识管理范式。

1.2 TriliumNext 的诞生：社区接力的力量

当原版 Trilium 的主要开发者在 2024 年 1 月宣布项目进入”维护模式”后，开源社区的力量再次凸显。一部分热心的社区开发者决定”fork”（分叉）原项目，创建了 TriliumNext。

值得特别说明的是，原开发者 @zadam 后来慷慨地将原仓库（zadam/trilium）的所有权转让给了 TriliumNext 团队，项目代码库现统一托管于 TriliumNext/Trilium。这意味着 TriliumNext 不仅是一个社区分叉，更成为了 Trilium 的官方延续。2025 年中，项目宣布将品牌名称从”TriliumNext Notes”正式回归为”Trilium Notes”，以延续原项目的品牌资产。

TriliumNext 的定位是原版 Trilium 的社区维护版本，其核心目标是继承 Trilium 的优秀基因，并在此基础上继续活跃地开发新功能、进行改进和优化，同时更好地响应包括中文用户在内的全球社区需求。

1.3 无缝迁移与版本兼容性

TriliumNext 与原版 Trilium 完全兼容。这意味着现有 Trilium 用户，无论其笔记内容是中文还是其他语言，都可以无缝地将其数据库迁移至 TriliumNext，无需任何特殊的迁移步骤，确保了用户体验的平稳过渡。

⚠️ 重要兼容性说明：

v0.90.4 及之前版本与 zadam/trilium v0.63.7 完全兼容
v0.90.5 及之后版本由于同步版本号（sync version）的递增，无法与旧版直接同步迁移
迁移建议：如需从旧版迁移，建议先升级至兼容的中间版本，再逐步升级至最新版

📌 截至 2026 年 1 月，TriliumNext 最新稳定版本为 v0.101.3，于 2026 年 1 月 8 日发布。

二、核心功能更新——新特性巡礼与发展动向

自诞生以来，TriliumNext 团队积极投入开发，在原版 Trilium 的坚实基础上引入了诸多令人振奋的新功能和改进。结合其公开的发布说明以及社区中观察到的开发动态，我们可以看到 TriliumNext 在以下几个方面的持续努力与演进：

2.1 📝 笔记组织与创作工具的丰富

2.1.1 多样化的笔记类型

在原有丰富的笔记类型基础上，TriliumNext 持续探索新的笔记组织形式。例如，早期版本中已加入对周笔记 (Week Notes) 和季度笔记 (Quarter Notes) 的支持，方便用户进行更细致的时间规划与回顾。

TriliumNext 目前支持的完整笔记类型矩阵包括：

类型	用途说明	底层技术
Text（文本笔记）	富文本编辑，支持格式化	CKEditor 5（已更新至 v45）
Code（代码笔记）	源代码编辑与高亮	CodeMirror 6
Canvas（画布笔记）	手绘、图形、无限画布	Excalidraw
Mind Map（思维导图）	可视化思维发散	Mind Elixir
Relation Map（关系图）	笔记间关系可视化	内置实现
Book（书籍/集合）	组织子笔记为章节	内置实现
Render Note（渲染笔记）	自定义HTML/脚本渲染	内置实现

2.1.2 🧠 思维导图 (Mind Map) 笔记

为了满足用户对可视化思考和信息梳理的需求，TriliumNext 引入了思维导图笔记类型，采用开源的 Mind Elixir 库作为底层引擎。

✅ 当前功能集：

修改节点文本颜色、背景颜色
添加标签和链接
从预设的几种大小中选择字体
支持导出为 SVG 格式或复制为图像
支持只读模式浏览
将已有层级笔记转换为思维导图时，子笔记会以预览卡片形式呈现

🔮 未来展望：
作为一项重要的可视化工具，思维导图功能在社区的持续开发下，有望在未来加入更多高级特性。Mind Elixir 库本身支持但尚未在 TriliumNext 中实现的功能包括：

KaTeX 数学表达式渲染
图片直接嵌入节点
笔记内部链接跳转（社区已提出相关 Feature Request）
更灵活的布局控制
更丰富的样式自定义

2.1.3 🎨 Canvas 画布笔记（Excalidraw 集成）

Canvas 笔记是 TriliumNext 中极具特色的功能之一，它集成了广受欢迎的开源白板工具 Excalidraw，为用户提供了无限画布的创作空间。

主要特性：

无限画布：支持鼠标、触控笔、触摸屏等多种输入方式
图形绘制：丰富的形状、箭头、文本框等绘图元素
图片嵌入：支持在画布中插入 PNG 等图片
手绘风格：保留 Excalidraw 标志性的手绘美学
支持只读模式

⚠️ 已知限制：

“Mermaid to Excalidraw”功能：由于依赖旧版 Mermaid 图表库，为避免库文件冗余，该功能在 v0.101 版本中已被移除
主题适配：画布背景色目前由 JavaScript 控制，CSS 自定义存在一定局限性
网格显示：快捷键 Ctrl + ' 可开启网格，但部分用户反映该功能尚不稳定

2.1.4 📄 富文本编辑器升级

TriliumNext 的核心文本编辑器 CKEditor 已从 v42 升级至 v45，经历了 7 个主要版本的迭代更新。 新版本带来了更好的编辑体验和稳定性，具体改进包括：

Admonitions（警示框）支持：在文本笔记和 Markdown 中可使用信息框（Info Box）、警告框（Warning Box）等样式化提示块，增强内容的可读性和视觉层次
更流畅的表格编辑体验
改进的图片插入与调整功能
更好的 RTL（从右到左）内容基础支持，方便阿拉伯语、希伯来语等语言用户

2.2 🎨 用户界面 (UI) 与用户体验 (UX) 的持续打磨

2.2.1 🌍 国际化与中文支持的深化

全面的多语言支持体系：

TriliumNext 从早期版本（如 v0.92.6）开始就明确支持”区域设置 (locale)”，并加入了界面语言切换功能。目前，TriliumNext 通过基于 JSON 的翻译系统支持 14 种语言，包括：

完整翻译语言	部分翻译语言
🇺🇸 English（英语）	及其他社区贡献语言
🇩🇪 Deutsch（德语）
🇪🇸 Español（西班牙语）
🇫🇷 Français（法语）
🇷🇴 Română（罗马尼亚语）
🇨🇳 简体中文
🇹🇼 繁体中文

中文支持的技术细节：

翻译平台：TriliumNext 使用 Weblate 作为社区翻译协作平台，任何母语用户都可以参与贡献翻译
简体中文已实现完整翻译：所有 UI 键值均已覆盖，不会出现英文回退
日期时间格式、数字格式、排序习惯等都能更好地适应用户所在地区
星期起始日自定义：国际化设置中通常包含对星期起始日的自定义选项，以照顾不同文化背景用户的使用习惯

字符编码兼容性：

对 UTF-16 LE 等字符编码的导入支持，有助于更好地处理和兼容来自不同源的中文内容，避免乱码问题。

⚠️ Windows 中文用户特别注意：
Windows 系统默认使用 GBK 编码，而 Trilium 需要 UTF-8 编码。如果遇到文件名乱码问题，建议使用 Bandizip 等工具，在压缩时选择”使用 UTF-8 文件名”选项，确保文件能被 Trilium 正确识别。

第三方中文增强方案：
社区项目 Nriver/trilium-translation 提供了额外的中文适配与体验优化，包括预置中文的 Docker 镜像，方便中文用户快速部署。

2.2.2 🧭 导航与布局的灵活性

v0.101.0 版本引入了重大的界面布局更新，这是 TriliumNext 发展历程中最重要的 UI 变革之一。 新布局的设计目标是：

现代化应用程序外观
提升操作直观性
减少视觉混乱
为未来功能扩展预留空间

主要变化包括：

导航栏位置可定制：用户可以根据个人偏好，选择将主导航栏放置在界面左侧或顶部
左上角功能按钮重新编排：更符合现代应用的交互习惯
搜索框相关元素的布局优化
笔记路径显示方式更新：从传统的 / 分隔符演变为更现代的 > 指示符
部分界面元素支持折叠：优化信息密度

2.2.3 🎭 主题与个性化定制

新主题引入：

“Trilium.Rocks” 主题：这是 v0.100.0 版本引入的新默认主题，由 @zerebos 原创开发并经过项目适配。 该主题提供了更现代的视觉体验
所有主题通常提供浅色和深色两种模式，以满足不同用户的视觉偏好和工作环境需求

2.2.4 📊 属性与关系图的视图优化

自定义属性展示的演进：对于笔记自定义属性的展示方式，TriliumNext 社区可能会持续探索不同的布局方案，以平衡信息密度和交互便捷性
关系图功能增强：在关系图（Relation Map）方面，有迹象表明项目在探索如节点数量的维度缩放等功能，旨在改善复杂知识网络的视觉呈现和导航效率
窗口管理工具：诸如”保持窗口置顶”等实用小功能依然是标准配置

2.3 ✅ 任务管理与效率提升工具

2.3.1 自定义属性的增强

为了更好地支持任务管理和信息组织，TriliumNext 在自定义标签属性时，增加了对”时间”数据类型的支持。这对于需要标记日期、截止时间、提醒等的任务或事件类笔记非常实用。

2.3.2 任务列表系统的规划与开发

根据早期的项目规划，一个更完善的任务列表/待办事项系统也在积极的开发考虑之中，旨在增强 Trilium 作为项目管理和个人事务追踪工具的综合能力。

2.3.3 📤 PDF 直接导出

TriliumNext 桌面版现已支持将笔记直接导出为 PDF 文件，无需借助第三方工具或浏览器打印功能，大大简化了文档分享流程。

2.4 🔐 安全性与技术底层优化

2.4.1 多因素身份验证 (MFA)

TriliumNext 较早地引入了对 Google OAuth 和 TOTP (Time-based One-Time Password) 的支持，为用户账户提供了重要的额外安全保障。

⚠️ 已修复的安全相关问题：

v0.101.0 修复了 noAuthentication 配置在 TOTP 启用时不被正确遵守的问题
v0.101.0 修复了 CVE-2025-58754 安全漏洞（影响 Axios 库，目前仅用于后端脚本）

2.4.2 代码质量与平台支持

项目代码库已 100% 完成向 TypeScript 的迁移，包括服务端和客户端代码。 这显著提升了代码的健壮性、可维护性和开发效率。

多平台支持矩阵：

平台	支持格式	特殊说明
Windows	`.exe` 安装包	已支持原生 ARM 构建；二进制文件已签名，不再出现”不信任应用”弹窗
macOS	`.dmg` 安装包	二进制文件已签名（感谢 @perfectra1n 提供实现和证书）；支持 Touch Bar
Linux	`.deb` / `.rpm` / `.flatpak` / `.zip`	支持 x64 和 arm64 架构

浏览器支持说明：
目前仅正式支持（并测试）Chrome 和 Firefox 的最新版本。 其他基于 Chromium 的浏览器（如 Edge）通常也能正常工作，但不保证完全兼容。

2.5 🤖 AI/LLM 智能集成

这是 TriliumNext 近年来最具前瞻性的功能更新之一。从 v0.94.0 版本开始，TriliumNext 引入了完整的 AI/LLM 集成框架，将人工智能能力深度融入个人知识库管理。

2.5.1 多 LLM 提供商支持

TriliumNext 采用模块化、可扩展的 AI 架构，目前支持以下 LLM 提供商：

提供商	类型	说明
OpenAI	云端 API	支持 GPT 系列模型
Anthropic	云端 API	支持 Claude 系列模型
Ollama	本地部署	支持各类开源模型，实现完全本地化运行

2.5.2 向量嵌入与语义搜索

TriliumNext 实现了基于向量嵌入（Vector Embeddings）的语义搜索功能，这意味着 AI 可以基于语义相关性而非简单的关键词匹配来检索和引用您的笔记。

支持的嵌入服务提供商：

OpenAI Embeddings
Voyage AI
Ollama（本地嵌入生成）

2.5.3 Agent 工具调用系统

TriliumNext 的 AI 系统支持”工具调用”（Tool Calling）机制：LLM 可以根据对话上下文，主动调用预定义的功能函数，执行特定操作后将结果作为上下文继续对话。这为构建更智能的知识库助手奠定了基础。

2.5.4 流式响应支持

AI 对话支持流式响应，部分回复可以在生成过程中实时显示到前端，提供更流畅的交互体验。

2.5.5 MCP 服务器集成

社区已开发了 TriliumNext 的 MCP（Model Context Protocol）服务器实现，允许兼容 MCP 的 AI 客户端通过 ETAPI 读取、搜索、创建和管理您的笔记，无需编写自定义代码。这为将 TriliumNext 与外部 AI 工作流（如 Claude Desktop、Cursor 等）集成提供了标准化接口。

2.6 ⚙️ 脚本 API 与自动化

TriliumNext 继承并增强了 Trilium 强大的脚本扩展能力，这是它区别于许多同类笔记软件的重要特性。

2.6.1 脚本类型与运行环境

脚本类型	运行环境	用途
Frontend Script	浏览器（JavaScript）	UI 交互、界面扩展、快捷操作
Backend Script	Node.js 服务端	数据处理、自动化任务、外部 API 调用

2.6.2 脚本 API

TriliumNext 提供了功能丰富的 Script API，脚本中可通过全局变量 api 访问：

FrontendScriptApi：用于前端脚本，提供笔记操作、UI 控制等功能
BackendScriptApi：用于后端脚本，提供数据库操作、文件系统访问等功能

2.6.3 触发器机制

脚本可以通过 #run 属性配置自动执行时机：

frontendStartup：前端加载时执行
mobileStartup：移动端前端加载时执行
backendStartup：服务端启动时执行

用户可以创建自定义 Widget（小部件）扩展界面功能。Widget 需要继承 BasicWidget 基类，定义父级和位置，并添加 #widget 属性。

2.7 🔌 ETAPI：外部集成接口

ETAPI 是 TriliumNext 的公开 REST API，自 v0.50 版本引入，为外部应用和自动化工具提供了标准化的程序接口。

2.7.1 认证方式

认证方式	格式	说明
ETAPI Token	`Authorization: ETAPITOKEN`	推荐方式
Bearer Token	`Authorization: Bearer ETAPITOKEN`	v0.93.0+ 支持，兼容更多工具
Basic Auth	标准 HTTP Basic Auth	用于仅支持 Basic Auth 的工具

Token 获取：Options → ETAPI 菜单，或通过 /auth/login API 调用

2.7.2 客户端库

trilium-py：Python 客户端库（2025 年 12 月更新），支持 Python 3.9-3.13，提供了便捷的 ETAPI 封装及额外功能增强。

2.7.3 API 文档

API 文档采用 OpenAPI 格式提供，官方文档已于 2025 年 10 月迁移至 docs.triliumnotes.org。

2.8 📱 移动端访问方案

目前 TriliumNext 没有官方的原生移动应用，但提供了多种移动端访问方案：

2.8.1 移动端 Web 前端（官方方案）

TriliumNext 服务器版提供了专门的移动端优化 Web 页面，可通过浏览器访问。 该前端：

✅ 支持浏览完整笔记树
✅ 支持阅读和编辑所有类型笔记
✅ 支持安装为 PWA（渐进式 Web 应用）
⚠️ 功能较桌面版有所精简
⚠️ 在小屏幕上编辑体验可能不够理想

2.8.2 TriliumDroid（Android 第三方应用）

TriliumDroid 是一款功能完善的 Android 原生客户端：

✅ 支持完全离线使用（与桌面客户端体验一致）
✅ 可通过 IzzyOnDroid F-Droid 仓库或直接下载 APK 安装
⚠️ 需要配置同步服务器（主机名、端口、密码）
⚠️ 重要：务必禁用服务器自动更新，确保 sync version 匹配

2.8.3 iOS 方案

目前没有专用的 iOS 应用。 可选方案包括：

使用 Safari 访问移动端 Web 前端
社区提供的 Apple Shortcut 快捷指令（用于快速发送内容到 Trilium）

三、TriliumNext 与竞品对比分析

为帮助读者更好地理解 TriliumNext 的定位与特色，我们将其与当前主流的个人知识管理工具进行简要对比：

3.1 核心特性对比

特性维度	TriliumNext	Obsidian	Notion
定价	🟢 完全免费开源	🟡 免费（同步付费 $48/年）	🟡 Freemium
数据存储	本地/自托管	本地文件	云端服务
组织范式	层级树状结构	图谱/双向链接	数据库/块
笔记格式	数据库存储	纯 Markdown 文件	专有格式
协作功能	有限	有限	强大
离线性能	极快（本地优先）	快	可能较慢
设置复杂度	中等	低	低
脚本扩展	🟢 内置强大	需社区插件	有限
自托管	🟢 完全支持	❌ 不支持	❌ 不支持

3.2 TriliumNext 的独特优势

笔记克隆（Note Cloning）：同一笔记可同时出现在多个父级目录下而不产生副本，这是 Trilium 最独特的功能之一
零延迟本地搜索：所有操作均在本地执行，链接图谱和反向链接搜索瞬间完成
强大的脚本扩展：内置完整的前后端脚本 API，无需外部插件系统
完全的数据主权：自托管方案确保数据完全掌控在用户手中
10 万+ 笔记规模良好支持：经过实践验证的大规模知识库承载能力

3.3 适用场景建议

用户类型	推荐工具	理由
需要严格层级分类的知识工作者	✅ TriliumNext	树状结构天然适配
重视双向链接和知识发现	Obsidian	图谱模式更强
需要团队协作的项目组	Notion	协作功能完善
技术用户/开发者	✅ TriliumNext	脚本扩展能力强
对数据隐私高度敏感	✅ TriliumNext/Obsidian	可完全本地化

四、社区驱动的力量与展望

TriliumNext 的发展充分体现了开源社区的活力与创造力。正是全球用户的积极反馈、建议以及核心开发者的不懈努力，共同推动着各项功能的迭代升级和用户体验的持续优化。

4.1 社区贡献途径

对于希望参与 TriliumNext 发展的用户，有以下途径：

贡献方式	说明	入口
🌐 翻译贡献	通过 Weblate 参与多语言翻译	Weblate 平台
🐛 问题反馈	提交 Bug 报告或功能建议	GitHub Issues
💻 代码贡献	参与功能开发或修复	Pull Request
📖 文档完善	改进官方文档	Docs 仓库
🎨 主题开发	创建自定义主题	社区分享

4.2 中文社区展望

对于广大的中文用户而言，TriliumNext 在国际化和本地化方面的明确投入和持续进展，特别是对”区域设置”的底层支持以及中文语言覆盖度的不断提升，预示着一个越来越友好、越来越贴合中文用户使用习惯的知识管理环境。

中文用户可以通过以下方式共同促进 TriliumNext 中文支持向更高水平迈进：

参与 Weblate 翻译，完善界面本地化
在 GitHub 提交中文相关的 Issue 和建议
撰写中文教程和使用心得
参与 Nriver/trilium-translation 等社区项目

五、总结与建议

TriliumNext 作为原版 Trilium 富有活力的社区延续，不仅忠实继承了其备受赞誉的核心优势，更在社区智慧的驱动下，勇敢地探索新的功能边界，不懈地优化用户体验。

核心亮点回顾：

领域	亮点特性
🧠 可视化工具	思维导图、Canvas 画布、关系图
🎨 界面体验	v0.101 全新布局、灵活导航、现代主题
🌏 中文支持	完整翻译覆盖、Weblate 社区协作
🤖 AI 集成	多 LLM 支持、语义搜索、Agent 工具
⚙️ 扩展能力	前后端脚本 API、ETAPI、MCP 服务器
🔐 安全性	MFA、签名二进制、TypeScript 重构

无论是新引入的思维导图工具、更具灵活性的导航布局选项，还是革命性的 AI/LLM 集成、完善的脚本扩展体系，以及对中文用户体验的深度关怀，都清晰地展现了其蓬勃的生命力和巨大的发展潜力，值得长期关注、积极尝试并寄予厚望。

📚 参考资源

资源类型	链接
📦 官方仓库	github.com/TriliumNext/Trilium
📖 官方文档	docs.triliumnotes.org
📋 版本发布	GitHub Releases
🌐 中文增强	Nriver/trilium-translation
🤖 Android 客户端	TriliumDroid
🔗 MCP 服务器	trillium-mcp
🐍 Python 客户端	trilium-py (PyPI)
🎨 主题资源	Trilium.Rocks

抱歉，回覆主題必需先登入。