Decentralization? We're still early!

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

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

    發布人 Brave 2025-05-11 01:35

    📝 版本说明:本文档基于 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 ScriptNode.js 服务端数据处理、自动化任务、外部 API 调用

    2.6.2 脚本 API

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

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

    2.6.3 触发器机制

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

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

    2.6.4 自定义 Widget

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


    2.7 🔌 ETAPI:外部集成接口

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

    2.7.1 认证方式

    认证方式格式说明
    ETAPI TokenAuthorization: ETAPITOKEN推荐方式
    Bearer TokenAuthorization: Bearer ETAPITOKENv0.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 核心特性对比

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

    3.2 TriliumNext 的独特优势

    1. 笔记克隆(Note Cloning):同一笔记可同时出现在多个父级目录下而不产生副本,这是 Trilium 最独特的功能之一
    2. 零延迟本地搜索:所有操作均在本地执行,链接图谱和反向链接搜索瞬间完成
    3. 强大的脚本扩展:内置完整的前后端脚本 API,无需外部插件系统
    4. 完全的数据主权:自托管方案确保数据完全掌控在用户手中
    5. 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

    Brave 回复 8 months, 3 weeks ago 1 成員 · 0 回复
  • 0 回复

歡迎留言回复交流。

Log in to reply.

讨论開始
00 回复 2018 年 6 月
現在