Tolaria 2026-06-23 版本技术解析纯文本电子表格、扩展名语法高亮、内置 Agent 上下文与手动更新控制【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria本文以 Tolaria 仓库中的版本发布说明 release-notes/v2026-06-23.md 为主体围绕该版本引入的四大新特性——Spreadsheet Notes纯文本电子表格、Bundled Agent Context内置 Agent 上下文、Update Check Control手动更新控制与 Raw Text Highlighting扩展名语法高亮——并结合仓库中的 ADR 决策记录、配置参考与核心源码实现展开深度解析。读完本文你将理解 Tolaria 如何在不破坏文件即真相、本地优先、Git 友好模型的前提下实现类 Excel 编辑体验掌握电子表格文件格式、跨笔记公式引用语法、语法高亮扩展机制与自动更新开关的完整技术细节。Tolaria 采用日历语义化版本Calendar SemVer见 ADR 0066v2026-06-23即 2026 年 6 月 23 日发布的版本。该版本的核心线索是把笔记型与数据型内容统一进同一套纯文本存储模型电子表格不再依赖二进制工作簿文件代码/配置文件也能按扩展名获得正确的语法高亮同时应用级能力Agent 文档、更新检查的开关与运行时被进一步收敛。下文按发布说明的三大部分New Features、Improvements、Stability and Fixes逐项展开。一、新特性 1Spreadsheet Notes——纯文本工作簿Git 可读可 diff发布说明首先宣告 Tolaria 现在可以打开和编辑纯文本电子表格笔记并配套提供公式自动补全、键盘导航、复制/粘贴支持以及完整的格式文档。这是该版本最具分量的一项能力其设计决策记录在 ADR 0134状态Experimental中。1.1 设计约束不破坏文件优先模型ADR 0134 的 Context 部分明确了设计出发点Tolaria 必须支持电子表格式内容同时不丢失 file-first、local-first、offline-first 和 Git-friendly 模型。一个 sheet 必须仍然能以纯文本被检查、被编辑交互式编辑器则要表现得像真正的电子表格且不能由 Tolaria 自研一套网格实现。最终决策是笔记 frontmatter 解析出_display: sheet时用专门的 sheet 编辑器替代块级笔记编辑器展示type仍是语义化、组织化的元数据因此 sheet 可以属于任意 Tolaria 类型笔记正文是类 CSV 的纯文本包含单元格输入与公式展示元数据存放在同一笔记的 frontmatter_sheet键下。交互层选型上原型使用IronCalc 的 workbook 包承担电子表格 UI 与公式引擎Tolaria 负责在纯文本笔记表示与 IronCalc workbook 模型之间做加载/保存适配。Tolaria 自有代码被严格限定在格式路由、纯文本适配器、持久化安全、产品化控件隐藏与公式自动补全明确不发展为自研网格。1.2 文件格式frontmatter CSV 正文配套的格式文档 site/reference/spreadsheet-format.md 给出了完整示例--- type: Project _display: sheet tags: - planning _sheet: show_grid_lines: true frozen_rows: 1 frozen_columns: 1 columns: A: width: 180 rows: 1: height: 32 cells: E6: num_fmt: 0.00% bold: true --- Metric,January,February,March,Q1 Total Subscriptions,1200,1350,1500,SUM(B2:D2) Expenses,650,700,760,SUM(B3:D3) Net,B2-B3,C2-C3,D2-D3,SUM(B4:D4) Growth,,(C4-B4)/B4,(D4-C4)/C4,(E4-B4)/B4关键约定如下正文就是行与单元格行以换行分隔单元格以逗号分隔含逗号、引号或换行的单元格需加引号引号内转义采用双引号保存时可省略尾部空行/空列。正文中不存在Markdown 表格包裹、围栏代码块或内嵌工作簿二进制 blob。前缀即公式任何以开头的单元格输入按公式处理其余按字面值处理。frontmatter 中所有普通字段仍可用type、status、date、tags、url以及belongs_to、related_to等关系字段照常生效。_sheet是保留的系统字段遵循与其他下划线前缀系统字段一致的约定——在普通属性编辑界面隐藏但可在原始源码中查看和编辑_sheet相关的系统字段约定可参见 ADR 0008 及 frontmatter-fields 参考。1.3_sheet展示元数据速查_sheet以纯 YAML 存放展示状态格式文档中给出了完整字段表字段含义show_grid_lines是否显示网格线frozen_rows顶部冻结行数frozen_columns左侧冻结列数columns.column.width自定义列宽按列字母键如A、BCrows.row.height自定义行高按从 1 开始的数字键cells.cell.num_fmt单元格数字格式代码cells.cell.bold/italic/underline/strike字重/斜体/下划线/删除线样式cells.cell.font_size/font_color/fill_color字号 / 文字颜色 / 填充色cells.cell.horizontal_align/vertical_align水平 / 垂直对齐cells.cell.wrap_text是否自动换行cells.cell.border_top/border_right/border_bottom/border_left四向边框样式单元格元数据以 A1 风格地址A1、B12、AA30为键。边框值采用样式名 可选颜色形式例如border_bottom: thin #d0d7de。数字格式沿用电子表格风格代码且只影响展示、不改写 CSV 正文中的原始输入格式示例输出#,##01,250#,##0.001,250.500.00%12.35%$#,##0.00$1,250.50yyyy-mm-dd2026-06-15一个实用的细节是Markdown 样式导入导入非公式 CSV 单元格时简单的 Markdown 包裹可初始化样式——**Revenue**存为Revenue粗体、_Estimate_存为Estimate斜体、***Total***存为Total粗斜体、~~Removed~~存为Removed删除线。保存后样式归入_sheet元数据正文保留去包裹后的纯文本。1.4 公式与跨笔记引用公式引擎由 IronCalc 提供函数目录见 site/reference/spreadsheet-functions.md其中明确当前捆绑引擎的函数目录共195 个函数覆盖逻辑、数学与三角、查找引用、文本、信息、统计、日期时间、财务、工程等家族如SUMIFS、XLOOKUP、IFERROR、ERFC.PRECISE、BIN2DEC等均受支持。Tolaria 在此之上增加了仓库感知vault-aware的引用语法这是区别于通用表格软件的关键能力[[newsletter-revenue]].B5 SUM(B2:D2)[[sponsorship-pipeline]].E12 ROUND([[business-plan]].$E$12, 2) [[launch-brief]].2三种引用形式跨表格单元格引用[[note]].A1按 wikilink 目标解析另一张 sheet 笔记再读取单个 A1 单元格$绝对标记遵循电子表格复制行为[[revenue]].$B$5行列固定、B$5行固定等。frontmatter 属性引用[[note]].property.path读取目标笔记的标量 frontmatter 属性路径数字/布尔/字符串转为公式字面量缺失、歧义、非标量数组/映射等解析为#N/A。注意首个段若形如 A1 地址会被当作跨表格单元格引用因此属性名应避开 A1 记法。正文行引用[[note]].N读取目标笔记去除 frontmatter 后的第 N 行正文1 起计保留逗号为文本[[note]].A1语义仍是网格访问。wkiklink 也可以直接存在普通单元格里非公式例如[[newsletter-revenue]]与普通笔记互链语义一致。1.5 源码层面的编辑器实现src/components/sheet-editor/目录共 48 个文件展示了这套编辑器的工程化深度可以推断其架构由多层 hook 组合而成工作簿控制器useSheetWorkbookController.ts、useSheetEditorController.ts负责 IronCalc 工作簿模型与 Tolaria 状态同步公式自动补全useSheetFormulaAutocomplete.ts、useSheetWikilinkAutocomplete.ts、sheetEditorWikilinkAutocomplete.ts实现 195 函数目录与 wikilink 目标的联想键盘与输入useSheetKeyboardHandlers.ts、sheetEditorKeyboard.ts、useSheetInputActivityHandlers.ts、sheetEditorVisibleFormulaInput.ts处理公式输入条、方向键导航与提交剪贴板与指针useSheetClipboardActions.ts含测试useSheetClipboardActions.test.tsx、useSheetPointerHandlers.ts实现复制/粘贴与鼠标交互焦点治理useGuardedWorkbookFocus.ts含测试防止 IronCalc 自动聚焦抢占键盘捕获详见下文焦点所有权小节外部公式解析useSheetExternalFormulaResolution.ts承担[[note]]跨笔记引用的解析与 vault-expressions 参考 中的[[note]].field目标形式共享同一套语法约定。配套的玩法指南见 site/guides/use-spreadsheets.md。1.6 已知边界必须了解ADR 0134 明确列出该能力当前为 Experimental 的边界原型刻意保持单 sheet一个笔记一个工作表跨笔记单元格引用属于 Tolaria 的扩展能力而不是 IronCalc 多 sheet 特性元数据提取有界、保存序列化做了防抖并在空闲时执行一次避免无界自动保存扫描更大的工作簿可能需要增量脏区间追踪才能进入生产级简单 Markdown 包装仅用于导入时播种样式保存后的样式统一落于_sheet而非行内 Markdown。二、新特性 2Bundled Agent Context——开箱即用的 AI 助手环境发布说明指出应用现在随安装携带生成的 Agent 文档并暴露一个Hermes agent target让 AI 辅助的笔记库工作更容易起步、行为更一致。这与仓库中一系列 Agent 架构决策一脉相承ADR 0062 确立了可选的 CLI AI agent 模型ADR 0093 确立共享的 CLI agent 运行时适配器ADR 0028 确立仅 CLI Agent、不内置 API Key的立场Agent 能力来自用户机器上已安装的 CLI 工具。从源码看src/lib/aiAgents.ts及其测试aiAgents.test.ts是 agent 目录的核心实现public/ai-agent-icons/hermes.svg与src/components/AiAgentIcon.tsx、AiAgentsBadgesrc/components/status-bar/AiAgentsBadge.test.tsx负责 Hermes 的图标与状态呈现。仓库根目录还维护了AGENTS.md、CLAUDE.md、GEMINI.md等根级 AI 引导文件对应 ADR 0065Bundled Agent Context可视为把这类引导文档打包进应用分发的延续使得新用户无需手工配置即可获得一致的 Agent 工作上下文。发布说明同时提到 Hermes、Pi、MCP、工作区上下文与 CLI agent 运行时路径被拆分简化即下文AI Runtime 重构小节的内容。三、新特性 3Update Check Control——手动更新控制发布说明的第三项新特性是设置中新增禁用自动更新检查的选项满足偏好完全手动控制更新的用户。这一开关在源码中有清晰落点src/hooks/useUpdater.ts的useUpdater(releaseChannel, automaticChecksEnabled true)钩子自动检查逻辑如下useEffect(() { if (!automaticChecksEnabled) return // 关闭自动检查的开关 if (!isTauri()) return const timer setTimeout(() { checkForUpdates() }, 3000) // 启动 3 秒后检查 return () clearTimeout(timer) }, [automaticChecksEnabled, checkForUpdates])可以推断的关键实现事实useUpdater的第二个参数automaticChecksEnabled直接门控启动期自动检查关闭后仍可通过actions.checkForUpdates()手动触发检查点击检查更新按钮因此禁用自动检查并不等于失去更新能力更新状态机UpdateStatus覆盖idle → checking → available → downloading带进度→ ready以及error下载事件通过downloadAndInstallAppUpdate与createDownloadProgressHandler累积字节数计算进度更新就绪后由restartApp()调用 Tauri 的relaunch重启应用src/hooks/useUpdater.ts末尾独立导出该钩子在非 Tauri浏览器/测试环境下直接返回up-to-date保证测试与 Web 预览不受影响相关行为由 src/hooks/useUpdater.test.ts 与设置页测试覆盖设置项存储逻辑见 src/hooks/useSettings.ts。四、新特性 4Raw Text Highlighting——基于扩展名的原始文本语法高亮发布说明第四项非 Markdown 文本文件现在可享受基于扩展名的语法高亮初始支持代码与数据类格式。这项能力的决策记录在 ADR 01402026-06-17status: active。4.1 背景与决策Tolaria 此前已把所有 UTF-8 非 Markdown 库文件索引为fileKind: text并在原始 CodeMirror 编辑器中打开但原始编辑器对所有文件统一安装 Markdown 语言扩展——Markdown 笔记没问题.sql、.json、.py、.yaml却被渲染成 Markdown 形态或纯文本与富文本围栏代码块的高亮体验不一致对应 Issue #872。ADR 0140 的决策是在编辑器创建时把原始编辑器文件扩展名映射到 CodeMirror 语言包Markdown 文件保留原有的、frontmatter 感知的 Markdown 路径YAML、JSON、Python、SQL、JavaScript、TypeScript 类文件使用官方 CodeMirror 语言包语法未知文本文件保持纯文本不再继承 Markdown 高亮Markdown 专属的 frontmatter 装饰与警告仅作用于 Markdown 文件。方案对比中否决了复用 BlockNote 代码块的 ShikiShiki 是静态高亮器需并行维护一套 CodeMirror decoration 管线与所有文件继续用 Markdown 高亮零新依赖但不满足需求。4.2 扩展名 → 语言映射源码映射表实现在 src/utils/rawEditorLanguage.tsLANGUAGE_BY_EXTENSION完整清单如下扩展名语言 ID扩展名语言 IDcjs/js/mjsjavascriptpy/pywpythoncts/ts/mtstypescriptsqlsqljsxjsxtsxtsxhtm/htmlhtmlyaml/ymlyamljson/jsoncjsonmd/markdownmarkdown解析逻辑为取路径最后一段文件名 → 正则/\.([^.])$/提取扩展名并小写 → 查表未命中返回plain。rawEditorLanguageIdForPath(path)是唯一入口语义清晰可单测。4.3 CodeMirror 扩展选择源码src/extensions/rawEditorLanguage.ts 负责把语言 ID 转成 CodeMirror 扩展关键实现function javascriptLanguage(id: RawEditorLanguageId): Extension { if (id typescript) return javascript({ typescript: true }) if (id tsx) return javascript({ jsx: true, typescript: true }) if (id jsx) return javascript({ jsx: true }) return javascript() }markupLanguage分支html/json/python/sql/yaml走highlighted(lang)语言扩展 rawEditorSyntaxHighlighting()markdown走markdownLanguage() frontmatterHighlightTheme() frontmatterHighlightPlugin保证 frontmatter 高亮只属于 Markdownplain返回空扩展。scriptLanguage分支javascript/jsx/tsx/typescript统一由codemirror/lang-javascript配合{ typescript, jsx }选项生成。入口rawEditorLanguageExtensionsForPath(path)组合路径 → ID → 扩展两步供原始编辑器RawEditorView见 src/components/RawEditorView.tsx在创建时调用。新依赖为codemirror/lang-javascript、codemirror/lang-json、codemirror/lang-python、codemirror/lang-sql外加代码中的codemirror/lang-html、codemirror/lang-yaml。ADR 0140 明确后续扩展方式扩充映射表 优先使用官方 CodeMirror 语言包。这一能力与富文本/原始模式的整体边界管理见 ADR 0022 与 ADR 0116相互配合BlockNote 负责富文本CodeMirror 6 负责原始模式src/utils/richEditorMarkdown.ts统一掌管富文本 → Markdown 序列化契约。五、Improvements更韧性的焦点所有权与更干净的 AI Runtime5.1 共享焦点所有权守卫发布说明的改进部分指出编辑器、电子表格、属性面板、笔记列表导航与工作区选择器的焦点处理现在共享更有韧性的所有权守卫减少意外失焦、选择丢失与陈旧导航状态。其设计决策即 ADR 0143日期恰为 2026-06-23与本版本同步此前编辑器和 sheet 各自安装独立的HTMLElement.prototype.focus补丁与文档级焦点监听卸载顺序会导致一个守卫移除后恢复原生 focus 方法、另一个守卫却仍在挂载的清理顺序 bug。新方案由单一共享注册表统一持有全局焦点拦截src/hooks/focusOwnershipGuard.ts唯一允许 patchHTMLElement.prototype.focus的模块同时持有文档焦点/指针监听、外部目标记忆、被拦截焦点恢复与清理src/hooks/editorFocusOwnership.ts决定富文本编辑器焦点何时挂起/恢复src/components/sheet-editor/useGuardedWorkbookFocus.ts决定工作簿何时需要活动键盘捕获且无外部焦点表面。ADR 明确后续约束任何新的编辑器类表面都应通过共享守卫注册作用域策略而不是再加一层原型补丁。5.2 更可靠的图片与附件改进部分还包括 vault-root 图片嵌入、笔记相对图片查找、编码附件路径与含空格路径的一致性处理。这与仓库中的附件路径规范化工作ADR 0113及媒体预览系列ADR 0098、ADR 0110、ADR 0162直接相关属于对既有附件模型attachments/目录的路径解析加固。5.3 AI Runtime 管线重构Hermes、Pi、MCP、工作区上下文与 CLI agent 运行时路径被拆分简化使 agent 输出与运行时解析更易恢复和维护。这对应 ADR 0093共享 CLI agent 运行时适配器与 MCP 相关决策ADR 0119的落地mcp-server/目录中的tool-service.js、vault-lifecycle.js、ws-bridge.js等模块承担 MCP 工具与生命周期职责前端侧aiAgents.ts统一管理各 agent 的解析与状态。改进还伴随文档扩充电子表格概念、使用指南、文件布局参考、frontmatter 文档与打包的 agent 文档页同步更新见 site/concepts/spreadsheets.md、site/reference/file-layout.md 与 site/reference/frontmatter-fields.md。六、Stability and Fixes本轮修复与加固清单发布说明第三部分罗列了本轮稳定性与修复项均可在此版本对应的既有能力中找到落点Linux/WebKit 渲染韧性NotFoundError 恢复、Wayland 回退收窄、BlockNote 渲染错误恢复、笔记窗口回退拒绝处理——延续 ADR 0141 与 ADR 0117 的 Linux 渲染治理电子表格编辑稳定性覆盖公式剪贴板来源、焦点切换、脏行更新、打包运行时样式与生产环境 WebAssembly 加载——与sheet-editor/中useSheetClipboardActions、useGuardedWorkbookFocus、sheetReleasedModel.ts等模块的测试配套如 src/components/sheet-editor/useSheetClipboardActions.test.tsx笔记创建与命名笔记创建、标题同步、重命名面包屑、移动后 wikilink 重写、类型正文模板与创建失败态修复——对应 ADR 0044、ADR 0076 等标题/重定向决策编辑器细节加固Mermaid 标签ADR 0088、Markdown 高亮快捷键、RTL 引用块引号轨道、字面星号粘贴、原始编辑器标签恢复、陈旧块引用、静止面板悬停行为代码健康sheet 工具、vault 解析、MCP 运行时解析、frontmatter 迁移、测试脚手架与多个 UI/helper 模块的健康度提升CodeScene 阈值随之收紧——对应 ADR 0018 与 ADR 0064 的代码质量门禁策略相关脚本见 scripts/codacy-gate.mjs 与 scripts/codacy-gate-lib.mjs。七、总结v2026-06-23 的技术主线回顾整个版本v2026-06-23的技术主线可以归纳为**用纯文本承担更多内容形态**电子表格以 CSV 正文 _sheet元数据存入 Markdown 文件ADR 0134配合 195 个公式函数与[[note]]跨笔记引用语法让数据型笔记享受 Git 可读、可 diff 的文件优先模型原始编辑器按扩展名加载 CodeMirror 官方语言包ADR 0140代码/数据文件获得正确语法高亮未知扩展名回退纯文本自动更新检查可关闭但保留手动检查useUpdater的automaticChecksEnabled门控Agent 文档随应用分发并提供 Hermes 内置 target焦点所有权收归单一共享守卫ADR 0143AI runtime 与附件路径解析同步简化。对于开发者而言本版本的后续扩展点很清晰新增语法高亮语言只需扩充src/utils/rawEditorLanguage.ts映射并接入官方 CodeMirror 语言包新增电子表格交互能力应继续在sheet-editor/的 hook 层组合而非侵入 IronCalc任何新编辑器类表面的焦点策略都应注册到focusOwnershipGuard。这套文档驱动 源码印证的结构正是理解 Tolaria 持续演进的高效入口。【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Tolaria 2026-06-23 版本技术解析：纯文本电子表格、扩展名语法高亮、内置 Agent 上下文与手动更新控制
Tolaria 2026-06-23 版本技术解析纯文本电子表格、扩展名语法高亮、内置 Agent 上下文与手动更新控制【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria本文以 Tolaria 仓库中的版本发布说明 release-notes/v2026-06-23.md 为主体围绕该版本引入的四大新特性——Spreadsheet Notes纯文本电子表格、Bundled Agent Context内置 Agent 上下文、Update Check Control手动更新控制与 Raw Text Highlighting扩展名语法高亮——并结合仓库中的 ADR 决策记录、配置参考与核心源码实现展开深度解析。读完本文你将理解 Tolaria 如何在不破坏文件即真相、本地优先、Git 友好模型的前提下实现类 Excel 编辑体验掌握电子表格文件格式、跨笔记公式引用语法、语法高亮扩展机制与自动更新开关的完整技术细节。Tolaria 采用日历语义化版本Calendar SemVer见 ADR 0066v2026-06-23即 2026 年 6 月 23 日发布的版本。该版本的核心线索是把笔记型与数据型内容统一进同一套纯文本存储模型电子表格不再依赖二进制工作簿文件代码/配置文件也能按扩展名获得正确的语法高亮同时应用级能力Agent 文档、更新检查的开关与运行时被进一步收敛。下文按发布说明的三大部分New Features、Improvements、Stability and Fixes逐项展开。一、新特性 1Spreadsheet Notes——纯文本工作簿Git 可读可 diff发布说明首先宣告 Tolaria 现在可以打开和编辑纯文本电子表格笔记并配套提供公式自动补全、键盘导航、复制/粘贴支持以及完整的格式文档。这是该版本最具分量的一项能力其设计决策记录在 ADR 0134状态Experimental中。1.1 设计约束不破坏文件优先模型ADR 0134 的 Context 部分明确了设计出发点Tolaria 必须支持电子表格式内容同时不丢失 file-first、local-first、offline-first 和 Git-friendly 模型。一个 sheet 必须仍然能以纯文本被检查、被编辑交互式编辑器则要表现得像真正的电子表格且不能由 Tolaria 自研一套网格实现。最终决策是笔记 frontmatter 解析出_display: sheet时用专门的 sheet 编辑器替代块级笔记编辑器展示type仍是语义化、组织化的元数据因此 sheet 可以属于任意 Tolaria 类型笔记正文是类 CSV 的纯文本包含单元格输入与公式展示元数据存放在同一笔记的 frontmatter_sheet键下。交互层选型上原型使用IronCalc 的 workbook 包承担电子表格 UI 与公式引擎Tolaria 负责在纯文本笔记表示与 IronCalc workbook 模型之间做加载/保存适配。Tolaria 自有代码被严格限定在格式路由、纯文本适配器、持久化安全、产品化控件隐藏与公式自动补全明确不发展为自研网格。1.2 文件格式frontmatter CSV 正文配套的格式文档 site/reference/spreadsheet-format.md 给出了完整示例--- type: Project _display: sheet tags: - planning _sheet: show_grid_lines: true frozen_rows: 1 frozen_columns: 1 columns: A: width: 180 rows: 1: height: 32 cells: E6: num_fmt: 0.00% bold: true --- Metric,January,February,March,Q1 Total Subscriptions,1200,1350,1500,SUM(B2:D2) Expenses,650,700,760,SUM(B3:D3) Net,B2-B3,C2-C3,D2-D3,SUM(B4:D4) Growth,,(C4-B4)/B4,(D4-C4)/C4,(E4-B4)/B4关键约定如下正文就是行与单元格行以换行分隔单元格以逗号分隔含逗号、引号或换行的单元格需加引号引号内转义采用双引号保存时可省略尾部空行/空列。正文中不存在Markdown 表格包裹、围栏代码块或内嵌工作簿二进制 blob。前缀即公式任何以开头的单元格输入按公式处理其余按字面值处理。frontmatter 中所有普通字段仍可用type、status、date、tags、url以及belongs_to、related_to等关系字段照常生效。_sheet是保留的系统字段遵循与其他下划线前缀系统字段一致的约定——在普通属性编辑界面隐藏但可在原始源码中查看和编辑_sheet相关的系统字段约定可参见 ADR 0008 及 frontmatter-fields 参考。1.3_sheet展示元数据速查_sheet以纯 YAML 存放展示状态格式文档中给出了完整字段表字段含义show_grid_lines是否显示网格线frozen_rows顶部冻结行数frozen_columns左侧冻结列数columns.column.width自定义列宽按列字母键如A、BCrows.row.height自定义行高按从 1 开始的数字键cells.cell.num_fmt单元格数字格式代码cells.cell.bold/italic/underline/strike字重/斜体/下划线/删除线样式cells.cell.font_size/font_color/fill_color字号 / 文字颜色 / 填充色cells.cell.horizontal_align/vertical_align水平 / 垂直对齐cells.cell.wrap_text是否自动换行cells.cell.border_top/border_right/border_bottom/border_left四向边框样式单元格元数据以 A1 风格地址A1、B12、AA30为键。边框值采用样式名 可选颜色形式例如border_bottom: thin #d0d7de。数字格式沿用电子表格风格代码且只影响展示、不改写 CSV 正文中的原始输入格式示例输出#,##01,250#,##0.001,250.500.00%12.35%$#,##0.00$1,250.50yyyy-mm-dd2026-06-15一个实用的细节是Markdown 样式导入导入非公式 CSV 单元格时简单的 Markdown 包裹可初始化样式——**Revenue**存为Revenue粗体、_Estimate_存为Estimate斜体、***Total***存为Total粗斜体、~~Removed~~存为Removed删除线。保存后样式归入_sheet元数据正文保留去包裹后的纯文本。1.4 公式与跨笔记引用公式引擎由 IronCalc 提供函数目录见 site/reference/spreadsheet-functions.md其中明确当前捆绑引擎的函数目录共195 个函数覆盖逻辑、数学与三角、查找引用、文本、信息、统计、日期时间、财务、工程等家族如SUMIFS、XLOOKUP、IFERROR、ERFC.PRECISE、BIN2DEC等均受支持。Tolaria 在此之上增加了仓库感知vault-aware的引用语法这是区别于通用表格软件的关键能力[[newsletter-revenue]].B5 SUM(B2:D2)[[sponsorship-pipeline]].E12 ROUND([[business-plan]].$E$12, 2) [[launch-brief]].2三种引用形式跨表格单元格引用[[note]].A1按 wikilink 目标解析另一张 sheet 笔记再读取单个 A1 单元格$绝对标记遵循电子表格复制行为[[revenue]].$B$5行列固定、B$5行固定等。frontmatter 属性引用[[note]].property.path读取目标笔记的标量 frontmatter 属性路径数字/布尔/字符串转为公式字面量缺失、歧义、非标量数组/映射等解析为#N/A。注意首个段若形如 A1 地址会被当作跨表格单元格引用因此属性名应避开 A1 记法。正文行引用[[note]].N读取目标笔记去除 frontmatter 后的第 N 行正文1 起计保留逗号为文本[[note]].A1语义仍是网格访问。wkiklink 也可以直接存在普通单元格里非公式例如[[newsletter-revenue]]与普通笔记互链语义一致。1.5 源码层面的编辑器实现src/components/sheet-editor/目录共 48 个文件展示了这套编辑器的工程化深度可以推断其架构由多层 hook 组合而成工作簿控制器useSheetWorkbookController.ts、useSheetEditorController.ts负责 IronCalc 工作簿模型与 Tolaria 状态同步公式自动补全useSheetFormulaAutocomplete.ts、useSheetWikilinkAutocomplete.ts、sheetEditorWikilinkAutocomplete.ts实现 195 函数目录与 wikilink 目标的联想键盘与输入useSheetKeyboardHandlers.ts、sheetEditorKeyboard.ts、useSheetInputActivityHandlers.ts、sheetEditorVisibleFormulaInput.ts处理公式输入条、方向键导航与提交剪贴板与指针useSheetClipboardActions.ts含测试useSheetClipboardActions.test.tsx、useSheetPointerHandlers.ts实现复制/粘贴与鼠标交互焦点治理useGuardedWorkbookFocus.ts含测试防止 IronCalc 自动聚焦抢占键盘捕获详见下文焦点所有权小节外部公式解析useSheetExternalFormulaResolution.ts承担[[note]]跨笔记引用的解析与 vault-expressions 参考 中的[[note]].field目标形式共享同一套语法约定。配套的玩法指南见 site/guides/use-spreadsheets.md。1.6 已知边界必须了解ADR 0134 明确列出该能力当前为 Experimental 的边界原型刻意保持单 sheet一个笔记一个工作表跨笔记单元格引用属于 Tolaria 的扩展能力而不是 IronCalc 多 sheet 特性元数据提取有界、保存序列化做了防抖并在空闲时执行一次避免无界自动保存扫描更大的工作簿可能需要增量脏区间追踪才能进入生产级简单 Markdown 包装仅用于导入时播种样式保存后的样式统一落于_sheet而非行内 Markdown。二、新特性 2Bundled Agent Context——开箱即用的 AI 助手环境发布说明指出应用现在随安装携带生成的 Agent 文档并暴露一个Hermes agent target让 AI 辅助的笔记库工作更容易起步、行为更一致。这与仓库中一系列 Agent 架构决策一脉相承ADR 0062 确立了可选的 CLI AI agent 模型ADR 0093 确立共享的 CLI agent 运行时适配器ADR 0028 确立仅 CLI Agent、不内置 API Key的立场Agent 能力来自用户机器上已安装的 CLI 工具。从源码看src/lib/aiAgents.ts及其测试aiAgents.test.ts是 agent 目录的核心实现public/ai-agent-icons/hermes.svg与src/components/AiAgentIcon.tsx、AiAgentsBadgesrc/components/status-bar/AiAgentsBadge.test.tsx负责 Hermes 的图标与状态呈现。仓库根目录还维护了AGENTS.md、CLAUDE.md、GEMINI.md等根级 AI 引导文件对应 ADR 0065Bundled Agent Context可视为把这类引导文档打包进应用分发的延续使得新用户无需手工配置即可获得一致的 Agent 工作上下文。发布说明同时提到 Hermes、Pi、MCP、工作区上下文与 CLI agent 运行时路径被拆分简化即下文AI Runtime 重构小节的内容。三、新特性 3Update Check Control——手动更新控制发布说明的第三项新特性是设置中新增禁用自动更新检查的选项满足偏好完全手动控制更新的用户。这一开关在源码中有清晰落点src/hooks/useUpdater.ts的useUpdater(releaseChannel, automaticChecksEnabled true)钩子自动检查逻辑如下useEffect(() { if (!automaticChecksEnabled) return // 关闭自动检查的开关 if (!isTauri()) return const timer setTimeout(() { checkForUpdates() }, 3000) // 启动 3 秒后检查 return () clearTimeout(timer) }, [automaticChecksEnabled, checkForUpdates])可以推断的关键实现事实useUpdater的第二个参数automaticChecksEnabled直接门控启动期自动检查关闭后仍可通过actions.checkForUpdates()手动触发检查点击检查更新按钮因此禁用自动检查并不等于失去更新能力更新状态机UpdateStatus覆盖idle → checking → available → downloading带进度→ ready以及error下载事件通过downloadAndInstallAppUpdate与createDownloadProgressHandler累积字节数计算进度更新就绪后由restartApp()调用 Tauri 的relaunch重启应用src/hooks/useUpdater.ts末尾独立导出该钩子在非 Tauri浏览器/测试环境下直接返回up-to-date保证测试与 Web 预览不受影响相关行为由 src/hooks/useUpdater.test.ts 与设置页测试覆盖设置项存储逻辑见 src/hooks/useSettings.ts。四、新特性 4Raw Text Highlighting——基于扩展名的原始文本语法高亮发布说明第四项非 Markdown 文本文件现在可享受基于扩展名的语法高亮初始支持代码与数据类格式。这项能力的决策记录在 ADR 01402026-06-17status: active。4.1 背景与决策Tolaria 此前已把所有 UTF-8 非 Markdown 库文件索引为fileKind: text并在原始 CodeMirror 编辑器中打开但原始编辑器对所有文件统一安装 Markdown 语言扩展——Markdown 笔记没问题.sql、.json、.py、.yaml却被渲染成 Markdown 形态或纯文本与富文本围栏代码块的高亮体验不一致对应 Issue #872。ADR 0140 的决策是在编辑器创建时把原始编辑器文件扩展名映射到 CodeMirror 语言包Markdown 文件保留原有的、frontmatter 感知的 Markdown 路径YAML、JSON、Python、SQL、JavaScript、TypeScript 类文件使用官方 CodeMirror 语言包语法未知文本文件保持纯文本不再继承 Markdown 高亮Markdown 专属的 frontmatter 装饰与警告仅作用于 Markdown 文件。方案对比中否决了复用 BlockNote 代码块的 ShikiShiki 是静态高亮器需并行维护一套 CodeMirror decoration 管线与所有文件继续用 Markdown 高亮零新依赖但不满足需求。4.2 扩展名 → 语言映射源码映射表实现在 src/utils/rawEditorLanguage.tsLANGUAGE_BY_EXTENSION完整清单如下扩展名语言 ID扩展名语言 IDcjs/js/mjsjavascriptpy/pywpythoncts/ts/mtstypescriptsqlsqljsxjsxtsxtsxhtm/htmlhtmlyaml/ymlyamljson/jsoncjsonmd/markdownmarkdown解析逻辑为取路径最后一段文件名 → 正则/\.([^.])$/提取扩展名并小写 → 查表未命中返回plain。rawEditorLanguageIdForPath(path)是唯一入口语义清晰可单测。4.3 CodeMirror 扩展选择源码src/extensions/rawEditorLanguage.ts 负责把语言 ID 转成 CodeMirror 扩展关键实现function javascriptLanguage(id: RawEditorLanguageId): Extension { if (id typescript) return javascript({ typescript: true }) if (id tsx) return javascript({ jsx: true, typescript: true }) if (id jsx) return javascript({ jsx: true }) return javascript() }markupLanguage分支html/json/python/sql/yaml走highlighted(lang)语言扩展 rawEditorSyntaxHighlighting()markdown走markdownLanguage() frontmatterHighlightTheme() frontmatterHighlightPlugin保证 frontmatter 高亮只属于 Markdownplain返回空扩展。scriptLanguage分支javascript/jsx/tsx/typescript统一由codemirror/lang-javascript配合{ typescript, jsx }选项生成。入口rawEditorLanguageExtensionsForPath(path)组合路径 → ID → 扩展两步供原始编辑器RawEditorView见 src/components/RawEditorView.tsx在创建时调用。新依赖为codemirror/lang-javascript、codemirror/lang-json、codemirror/lang-python、codemirror/lang-sql外加代码中的codemirror/lang-html、codemirror/lang-yaml。ADR 0140 明确后续扩展方式扩充映射表 优先使用官方 CodeMirror 语言包。这一能力与富文本/原始模式的整体边界管理见 ADR 0022 与 ADR 0116相互配合BlockNote 负责富文本CodeMirror 6 负责原始模式src/utils/richEditorMarkdown.ts统一掌管富文本 → Markdown 序列化契约。五、Improvements更韧性的焦点所有权与更干净的 AI Runtime5.1 共享焦点所有权守卫发布说明的改进部分指出编辑器、电子表格、属性面板、笔记列表导航与工作区选择器的焦点处理现在共享更有韧性的所有权守卫减少意外失焦、选择丢失与陈旧导航状态。其设计决策即 ADR 0143日期恰为 2026-06-23与本版本同步此前编辑器和 sheet 各自安装独立的HTMLElement.prototype.focus补丁与文档级焦点监听卸载顺序会导致一个守卫移除后恢复原生 focus 方法、另一个守卫却仍在挂载的清理顺序 bug。新方案由单一共享注册表统一持有全局焦点拦截src/hooks/focusOwnershipGuard.ts唯一允许 patchHTMLElement.prototype.focus的模块同时持有文档焦点/指针监听、外部目标记忆、被拦截焦点恢复与清理src/hooks/editorFocusOwnership.ts决定富文本编辑器焦点何时挂起/恢复src/components/sheet-editor/useGuardedWorkbookFocus.ts决定工作簿何时需要活动键盘捕获且无外部焦点表面。ADR 明确后续约束任何新的编辑器类表面都应通过共享守卫注册作用域策略而不是再加一层原型补丁。5.2 更可靠的图片与附件改进部分还包括 vault-root 图片嵌入、笔记相对图片查找、编码附件路径与含空格路径的一致性处理。这与仓库中的附件路径规范化工作ADR 0113及媒体预览系列ADR 0098、ADR 0110、ADR 0162直接相关属于对既有附件模型attachments/目录的路径解析加固。5.3 AI Runtime 管线重构Hermes、Pi、MCP、工作区上下文与 CLI agent 运行时路径被拆分简化使 agent 输出与运行时解析更易恢复和维护。这对应 ADR 0093共享 CLI agent 运行时适配器与 MCP 相关决策ADR 0119的落地mcp-server/目录中的tool-service.js、vault-lifecycle.js、ws-bridge.js等模块承担 MCP 工具与生命周期职责前端侧aiAgents.ts统一管理各 agent 的解析与状态。改进还伴随文档扩充电子表格概念、使用指南、文件布局参考、frontmatter 文档与打包的 agent 文档页同步更新见 site/concepts/spreadsheets.md、site/reference/file-layout.md 与 site/reference/frontmatter-fields.md。六、Stability and Fixes本轮修复与加固清单发布说明第三部分罗列了本轮稳定性与修复项均可在此版本对应的既有能力中找到落点Linux/WebKit 渲染韧性NotFoundError 恢复、Wayland 回退收窄、BlockNote 渲染错误恢复、笔记窗口回退拒绝处理——延续 ADR 0141 与 ADR 0117 的 Linux 渲染治理电子表格编辑稳定性覆盖公式剪贴板来源、焦点切换、脏行更新、打包运行时样式与生产环境 WebAssembly 加载——与sheet-editor/中useSheetClipboardActions、useGuardedWorkbookFocus、sheetReleasedModel.ts等模块的测试配套如 src/components/sheet-editor/useSheetClipboardActions.test.tsx笔记创建与命名笔记创建、标题同步、重命名面包屑、移动后 wikilink 重写、类型正文模板与创建失败态修复——对应 ADR 0044、ADR 0076 等标题/重定向决策编辑器细节加固Mermaid 标签ADR 0088、Markdown 高亮快捷键、RTL 引用块引号轨道、字面星号粘贴、原始编辑器标签恢复、陈旧块引用、静止面板悬停行为代码健康sheet 工具、vault 解析、MCP 运行时解析、frontmatter 迁移、测试脚手架与多个 UI/helper 模块的健康度提升CodeScene 阈值随之收紧——对应 ADR 0018 与 ADR 0064 的代码质量门禁策略相关脚本见 scripts/codacy-gate.mjs 与 scripts/codacy-gate-lib.mjs。七、总结v2026-06-23 的技术主线回顾整个版本v2026-06-23的技术主线可以归纳为**用纯文本承担更多内容形态**电子表格以 CSV 正文 _sheet元数据存入 Markdown 文件ADR 0134配合 195 个公式函数与[[note]]跨笔记引用语法让数据型笔记享受 Git 可读、可 diff 的文件优先模型原始编辑器按扩展名加载 CodeMirror 官方语言包ADR 0140代码/数据文件获得正确语法高亮未知扩展名回退纯文本自动更新检查可关闭但保留手动检查useUpdater的automaticChecksEnabled门控Agent 文档随应用分发并提供 Hermes 内置 target焦点所有权收归单一共享守卫ADR 0143AI runtime 与附件路径解析同步简化。对于开发者而言本版本的后续扩展点很清晰新增语法高亮语言只需扩充src/utils/rawEditorLanguage.ts映射并接入官方 CodeMirror 语言包新增电子表格交互能力应继续在sheet-editor/的 hook 层组合而非侵入 IronCalc任何新编辑器类表面的焦点策略都应注册到focusOwnershipGuard。这套文档驱动 源码印证的结构正是理解 Tolaria 持续演进的高效入口。【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考