设置与外观

Numlex 的设置分为八个类别，从窗口顶部一排紧凑的「图标在上、标签在下」磁贴中选择—— General、Notebook、Editing、Numbers、Dates & Times、Constants & Units、Styling 和 About。Notebook 紧跟在 General 后面。每个页面都是一列可读的分组行，配有原生开关、选择器和滑块；每个偏好都本地 保存在你的 Mac 上，不会同步到任何地方。

各页面负责什么

类别	负责
General	界面语言、Auto/Light/Dark 外观、Dock/App Switcher 应用图标和销售税配置
Notebook	Sheet Behavior、Floating Total 控件和便笺偏好设置
Editing	运算符辅助和自动插入——所有会在输入时重写文本的内容
Numbers	区域数字格式、粘贴转换、答案的显示和复制方式
Dates & Times	工作日历（节假日地区、每工作日工时）和自定义时区别名
Constants & Units	应用级常量和自定义单位（一个分段式界面）
Styling	排版、答案列、语法颜色、实时预览
About	应用标识、Check for Updates 和自动检查计划

首次启动

真正全新的安装会打开一次性的 calculation bloom：十个真实计算使用应用自带编辑器调色板， 围绕应用图标汇聚并落定为官方口号，配一个 Get Started 按钮。序列只运行一次便停止；开启 Reduce Motion 时，最终画面直接呈现，立即可用，没有分阶段动画。

按下 Get Started 会记录首次启动并挂载便笺。已有安装永远不会看到 bloom。应用中 没有 Replay 命令——欢迎序列无法重新运行。

General

界面

控件	取值	说明
界面语言	应用内置语言	仅本地化界面——绝不改变数字格式。
外观	Auto / Light / Dark	立即应用于整个应用。Auto 实时跟随 macOS；Light 和 Dark 固定应用并忽略系统变化。全新安装默认 Auto。
应用图标	Dark / Light	仅 Dock 和 App Switcher 图标。Dark（全新默认）是应用的标准图标；Light 是应用内置的备用图标。切换立即生效并被记住；它绝不改变应用本身的 Finder 图标或任何文档。

税费

用于金融税费短语的应用级销售税配置（保存在设置中，绝不导出到 .nlx）。控件位于 General 页面本地化的 Tax 组中；Tax 不是独立的导航磁贴。

控件	取值	说明
预设地区	Custom + 内置预设	在选择时一次性填入税名和税率（AU GST 10、GB VAT 20、DE VAT 19、NL VAT 21 等）。预设带有官方地区税率及其来源信息。美国没有自动税率：选择它只填入名称，税率保持未设置并需要手动输入；手动 0% 是允许的，且与未设置不同。
税名	自由文本（有界）	税费短语不区分大小写地接受：sales tax、VAT 和 GST 始终注册，外加此名称。默认 Sales Tax。
税率	百分比，0…<100	供 + VAT、VAT on …、pre-tax price of … 和 gross price of … 使用。空 = 自动税关闭；这些短语随后以精确、可操作的 set sales tax in Settings → Tax 失败。

每次更改立即生效，实时重新求值工作表，且绝不触碰工作表内容、光标、选区或 滚动。确切公式见金融与投资。

Notebook

Notebook 是 General 之后的第二个设置页面，负责 Sheet Behavior、便笺偏好设置和 Floating Total 控件。

Sheet Behavior

• On launch——选择 Open Last Edited Sheet（默认）或 New Sheet。每个进程只做一次启动 决策；再打开一个窗口不会额外创建启动表格。
• Use ⌘N for——选择 New Sheet（默认）或 New Window。
• Start sheets with——选择 Regular Line（默认）或 Heading。
• Sort sheets by——选择 Date Edited（默认）、Date Created 或 Name；排序只作用于当前文件夹。

Notebook preferences

• Line numbers（默认开启）在每行输入旁显示行号。
• Hide sidebar button when collapsed（默认关闭）在侧边栏折叠时隐藏工具栏按钮；可用 ⌃⌘S （Control-Command-S）或 View → Toggle Sidebar 重新打开。
• 侧边栏行在同一行显示表格创建日期和行数；只有两项无法同时放下时才缩短日期。

Minimal Mode

选择 View → Minimal Mode 或按 ⌘⇧M。它按窗口生效且仅在当前会话有效，每个窗口初始关闭， 并且只在已准备就绪且获得焦点的主窗口中可用。在 Settings、欢迎/揭示期间、原生全屏模式及原生 模式切换期间均不可用。Minimal Mode 只隐藏侧边栏和 Floating Total 页脚；内联 total 行与答案 仍然保留。它不改变已保存的侧边栏或 Floating Total 偏好、表格内容或导出/打印结果。

Editing

这里的一切改变你输入的文本，而不是已求值的值。

运算符

控件	效果
运算符两侧补空格	1+1 变成 1 + 1
将 * 替换为 ×	3*3 变成 3 × 3
将反引号 ` 替换为 +	5`5 变成 5 + 5
使用 QuickOperators	5p5 → 5 + 5、5m5 → 5 − 5、5x5 → 5 × 5、5d5 → 5 ÷ 5

QuickOperators 只在两个数字之间生效，绝不在标识符内部生效（0x1F 绝不被重写）。

自动插入

控件	效果
用千位分隔符格式化数字	输入时分组数字（10000 → 10,000）。答案分组是 Numbers 中的单独设置。
在新行输入运算符后插入上一个答案	按 return 后，输入任意运算符（+ − × ÷）会开始一行，将上一个答案作为实时 token复用。

Numbers

区域格式

地区预设改变数字的输入、粘贴、分组和显示方式，以及函数调用期望的分隔符。

格式	示例	小数	分组	函数参数分隔符
System	平台	区域	区域	若系统小数分隔符是逗号则为 ;，否则为 ,
North America	1,234.56	.	,	,
Western Europe	1.234,56	,	.	;
Eastern Europe	1 234,56	,	NBSP（输入接受空格）	;

更改地区可能重新解释打开的工作表中的数字。Numlex 会列出将发生变化的答案并发出警告，只有 你确认后才应用更改。

同一组中还有两个独立开关：Convert foreign numbers on paste（把粘贴的 1,234.56 转为 本地形式，不动普通文字和已是本地的数字）和 Show thousands separator。

Auto-convert single units

Settings → Numbers → Auto-convert single units 默认关闭。选择 Local units 后，符合条件的 独立测量值会在答案和合计中转换为本地公制、美国或英国单位。条件有意设得严格：该行必须恰好包含 一个数字字面量和一个内置物理单位。输入的行永远不会被改写。

显式换算、算术和汇率、货币、自定义单位及复合表达式均保持原有行为。未显式换算的温度 （20 C）和燃油经济性（8 L/100km）行会作为无单位的普通数字求值并保持不变；仍需显式换算， 例如 20 C to F。

答案显示

控件	取值	效果
舍入	2…10 位小数	全局答案舍入。计算精度绝不改变——只改变显示和复制的值。
紧凑大数	开/关	100000 显示为 100k；复制的值保留完整精度。
Default answer format → Notation	Automatic、Decimal、Scientific、Engineering、Fraction、Timespan、Custom	数字答案的显示和复制方式。Timespan 只适用于时间维度的量值；其他内容回落到 Automatic。
分数分母	有界	分数近似可用的最大分母。
负数	负号前缀、括号、末尾负号	负结果的仅显示样式。
货币符号	前/前加空格/后/后加空格	货币符号的位置。
自定义格式	数字骨架	如 #,##0.00 的区域无关模式，最多 96 个字符。

Automatic 显示普通或紧凑值，在极大数量级（|v| ≥ 1e16）时使用科学计数法回退，并且自身 绝不切换到工程记法。无效的自定义模式仍会保存并可编辑，但永远不会进入渲染：这些答案会回落 到 Automatic，直到修复。

完整模式语法、四个区域和粘贴规则见数字格式与结果呈现； Timespan 记法见日期与时间。

格式仅用于显示

切换记法、舍入答案或更改货币样式绝不改变值、token 载荷、依赖或合计。只有呈现和复制的文本 会改变。

Dates & Times

Dates & Times 类别负责应用级时间偏好，分为两组。

Work calendar —— Holiday region 选择器（Automatic = 当前数字上下文的系统区域，加上 25 个 支持的 ISO 国家配置）和 Hours per workday 步进器（钳制在 1…24，默认 8）。工作日是周一至周五 减去该地区的公共节假日；不支持的地区或超出覆盖范围的年份会让带日期的工作日查询严格失败， 而不是静默忽略节假日。内置节假日配置覆盖 25 个国家（2019–2035），可离线使用。

Custom timezones —— 最多 100 行，每行有用户别名和 IANA 标识符。每行都会 报告实时校验状态：空、不完整、无效名称、重复、被内置地点保留、未知时区或有效。别名按 大小写和空白不敏感匹配，绝不能占用内置的城市/国家/IATA/ICAO/IANA 标识符或 GMT/UTC 固定 缩写。只有有效行才会进入时区查找（time in <alias>）。

整个块是应用全局的，绝不导出到 .nlx。时间语法和离线时区目录见日期与时间。

Constants & units

Settings → Constants 是一个分段式界面，包含两个表格：

部分	行数上限	值
Constants	100	有限的无量纲标量、百分比或单一法币代码的金额；可以引用其他常量；依赖解析与行顺序无关。
Units	100	现有单位的倍数（12 feet）或字面量 new unit（独立维度）。

每行都显示实时状态——incomplete、invalid name、duplicate、reserved、 invalid expression、unknown dependency、cycle、limit reached。无效行仍然可见但不活动：它们 不保留名称，也绝不被引用。

常量和自定义单位是应用全局的。.nlx 工作表导出绝不嵌入它们。命名规则、上限和被拒绝的值见 自定义单位与常量。

Styling

排版

字体大小（连续滑块）和字体设计——System Default、Rounded、Serif、Monospaced。所选大小是 编辑器、答案列和预览的唯一真源，因此行高和基线保持一致。

4.9.3 新增：笔记本正文也可以使用 Mac 上已安装的任意字体家族。

• Font 菜单直接列出四种内置设计，并新增 Installed Fonts 子菜单，其中包含 macOS 报告的所有已安装字体家族。家族名称来自 macOS，并按 macOS 的写法原样显示。
• 选择某个家族后会出现 Face 行，用于选择该家族的具体字重样式。它的第一项 Regular 表示“该家族的常规字面”，而不是某个具体的 PostScript 名称；其余项目是 该家族已安装的字面。改选其他家族时会重新从 Regular 开始。
• 选择内置设计会清除自定义家族和字面——该设计既是所选内容，也是回退方案。
• 如果所选家族当前未安装，保存的名称会保留（因此重新安装后字体会恢复），并在 设置中标记为 Unavailable，同时笔记本正文使用所选的内置设计。不会重写任何内容， 也不会出错。
• 该选择是应用全局的：保存在设置存储中（从不按工作表保存，也绝不写入 .nlx 文件），并应用于编辑区、答案列（包括合计行和页脚数值）、实时 Preview，以及导出 对话框中的 Notebook 字体（它会继承该选择）。在导出对话框中显式选择的家族和字面 仅在本次会话有效。
• 四种内置设计的行高仍为 fontSize × 1.6。自然度量更高的字体会自动提高行高 （regular/semibold/heavy 三者中的最大度量加 4 pt），因此字形永远不会被裁剪；编辑区、 答案和预览使用同一个值。
• 更改字体排版会就地重新排版并重新测量各行。它绝不替换你的文本，也不影响工作表内容、 行标识符、token、光标、选择、标记文本、焦点、滚动位置或计算结果——而仅更改颜色时 仍然只重绘、不重新排版。 编辑器、答案列和预览的唯一真源，因此行高和基线保持一致。

答案列

控件	取值	效果
宽度	140–400 pt（默认 200）	答案列宽度的精确滑块。也可以通过拖动编辑区与答案之间的细分隔线设置同一个值：向左拖列变宽，向右拖变窄。
对齐	Leading / Trailing	答案在（可调整宽度的）答案列中的位置。
背景	Neutral / Sand / Slate / Sage / Blush	该列的表面颜色。每种选择的答案文字都保持高对比度。

宽度仅用于呈现：它保存在应用全局的设置存储中（从不按工作表保存，也绝不进入 .nlx 文件），改变它绝不影响工作表内容、数值、token、光标、选择、滚动位置或编辑区。拖动时列会即时更新，并在松开时精确地保存一次。若窗口容纳不下编辑区 280 pt 的最小宽度加上所选列宽，列宽会被限制到剩余空间，布局始终安全。

语法颜色

八个角色可以独立设置样式——Numbers、Operators、Variables、Units、Specifiers、Headings、 Comments 和 Labels。

每个角色都有预设色样（Standard Text、Cyan、Green、Pink Purple、Blue、Money Purple）、用 系统取色器选择的 Custom 颜色，以及 Default——恢复该 角色的出厂预设而不影响其他角色。

Reset Syntax Colors 一次性恢复全部八个角色；字体和答案列设置保持不变。实时 Preview 块会在你更改时呈现当前角色颜色。

货币标记颜色、答案 token 颜色和光标颜色有意固定——它们不属于角色集合。

About

About 页面既是应用标识也是更新中心：

项	行为
标识	居中块，显示当前应用图标（实时跟随所选的 Dark/Light 图标）、名称「Numlex」和运行时从包中读取的本地化版本。
文档	指向 https://numlex.tech/docs/ 的原生链接。
GitHub	指向 https://github.com/Qulierm/Numlex 的原生链接。
Check for Updates…	立即开始检查（与 Numlex → Check for Updates… 相同）。检查进行中时禁用。
自动检查更新	基于 Sparkle 自身持久化偏好的原生开关；计划遵循 Sparkle 默认值（大约每 24 小时一次，并有其同意提示）。Numlex 绝不在启动时强制检查。

检查读取 HTTPS feed https://numlex.tech/appcast.xml，下载的版本必须携带有效的 EdDSA 签名， 并在解压归档之前完成校验。如果此构建没有随包分发的更新元数据（例如开发运行），该组会 说明原因并保持禁用，而不是失败。

自动检查标志不属于 Numlex 的设置存储或 .nlx 导出。

从旧版本更新： 4.8.0 是第一个带更新器的版本，4.9.6 是当前版本。4.7.0 或更早的用户需要 手动安装一次当前版本；从 4.8.0 起，更新在应用内到达，当前构建会报告「up to date」。

答案右键菜单

右键（或 Control-click）答案会打开其原生菜单。菜单只对拥有菜单的行存在：安静行（空白、 标题、跳过）、格式错误的货币/日期/函数错误和天气不可用行完全不提供菜单。

项	适用于	行为
Copy Answer	有菜单的答案	复制精确的显示值。
Round（0…10 dp 滑块）	合格的数字答案（滑块只在适用舍入时出现）	只重新舍入这一个答案，独立于全局 2…10 舍入。源行不受影响。
Number Format	数字答案	此答案的本地记法；Default 清除覆盖。
Reset Formatting to Defaults	带覆盖的答案	仅在存在覆盖时出现；清除它。
Convert to Normal Line	小计/总计行	把命令替换为全精度数字字面量；命名形式保留 name = 前缀。
Delete Line	有菜单的答案	删除该答案的源行。

菜单完全原生，遵循系统外观。本地覆盖绝不改变值、引用该行的 token（token 使用自身或全局格式 呈现）、依赖或合计——见答案 token和 标签、小计与统计。

行高亮

行高亮不在答案右键菜单中。它们从应用菜单 Format → Highlight（None、Yellow、 Orange、Green、Blue、Purple、Pink）或编辑器文本右键菜单应用，作用于光标所在的逻辑行（或每个 选中的逻辑行）——因此标题、注释和普通文字也能高亮。

• 高亮属于行的稳定标识而不是位置，因此在行上方插入或删除行时它会跟随该行。
• 高亮随工作表保存，并在加载时清理：过期的标识被丢弃，重复项中第一个有效颜色胜出。
• 高亮只是装饰——绝不影响求值、答案或 token。见工作表和文件。

布局契约

契约	值
答案列宽度	可调整，140–400 pt（默认 200 pt）；受窗口限制，编辑区始终保留至少 280 pt
行号装订线	可见时：54 pt 缩进（36 pt 装订线 + 18 pt leading）；隐藏时：18 pt
合计栏与内联 total	底部 Total 面板与维度无关，对每条普通标量答案行只累加一次已求值量值，并排除内联 total 行以免重复计数；内联 total 行是独立的、始终有效的分区命令
底部 Total 气泡	当标签与值都能容纳时并排显示本地化标签，当值会与标签冲突时收缩为只显示值的气泡——标签、其间隙和占位空间被移除，气泡高度和预留给页脚的空间绝不改变

主窗口首次显示前，只有当保存的窗口框架在已连接显示器上两个维度的重叠都至少为 100 pt 时， Numlex 才会恢复该框架。否则窗口以 800×600 pt 启动，并在容纳得下时居中于主可见区域；如果没有合适的主可见区域，SwiftUI 会将回退窗口居中放置在默认显示器上。侧边栏的显示/隐藏选择独立保存；旧存储中若没有该选项，则默认 展开侧边栏。此决定同步完成；汇率会单独加载，其请求和结果都不会延迟或重复窗口定位。

持久化

• 每个偏好都写入应用的本地设置存储；应用完全可离线运行，不上传任何设置。
• 工作表级数据（逐答案覆盖、行高亮、工作表内容）随工作表及其 .nlx 导出。
• 常量、自定义单位、时间偏好、税费配置、页脚统计和答案列宽度是应用全局的，绝不嵌入 .nlx。

页脚统计

浮动 Total 面板可配置：右键选择 Sum、Average、Count 或 Median（一个原生带 勾选标记的本地化菜单）。该选择是应用全局的持久化设置（绝不属于 .nlx），并且只改变页脚—— 绝不改变工作表内容、光标、选区、IME、滚动位置或编辑器。Count 显示精确整数；其他统计使用 现有全局数字表示。派生聚合行（内联 total、小计、总计、标签聚合、分隔线）永不参与，默认 Sum 与之前的 Total 相同。未知的值会回落到 Sum。见 标签、小计与统计。

本文档页脚是汇率来源的署名说明，并非设置项。

Floating Total

Notebook 页面拥有四个 Floating Total 控件：

• Show（默认开启）控制两种布局下的可见性。关闭后，既不预留页脚空间，也不显示叠加层；内联 total 行仍会求值并呈现。
• Avoid overlapping answers（默认开启）会在答案下方为页脚预留空间。关闭后，同一个可交互页脚会 叠加在答案视口底部，但不占用布局空间。
• Include referenced lines（默认开启）会统计每个答案 token 的来源行。关闭后排除来源行，但显示 token 的行仍计入。
• Include variable declaration lines（默认开启）会统计变量声明行，例如 x = 5；关闭后只统计 使用这些变量的行。

三个贡献开关对 Sum、Average、Count、Median 以及 PDF/打印快照采用一致规则。它们只改变哪些符合条件的 行参与统计，不改变哪些结果类型符合条件。

相关

• 数字格式与结果呈现 — 区域、显示模式和自定义模式语法。
• 自定义单位与常量 — 命名规则、上限、循环和被拒绝的值。
• 日期与时间 — Dates & Times 类别背后的时间语法。
• 金融与投资 — 使用 Tax 配置的税费短语。
• 答案 token — 为什么本地显示覆盖不随 token 传递。
• 工作表和文件 — 工作表和 .nlx 导出中持久化的内容。