Soulver X Series

探索更完美的 Soulver

什么是 Soulver X Series？

在 2024 年，我们启动了一个为期多年的研发项目，其使命是：

• 探索 Soulver 的酷炫新想法

• 寻找新的形式和新的工作流程

• 大胆地开拓任何笔记计算器从未涉足的领域 🖖

我们计划每年发布一个主要的 X 系列新版本。

Soulver X Series 赞助

如果您是长期用户（或 Soulver 的超级粉丝），并对这项工作感到兴奋，您可以考虑 在 GitHub 上赞助我们的使命。

此外，作为赞助商，您将能够使用最新 X 系列原型（X3、X4 等），这些原型在笔记计算器领域具有更多前所未见的特性。

我们（非常）小的团队非常感谢您的支持，这将使我们能够投入更多资源进行此类高级笔记计算器的研发。

Soulver X2 (2025)

子工作表 (Subsheets)

• 子工作表是存在于单个令牌内的独立工作表。

  • 从标签栏的 + 按钮创建子工作表。

  • 双击紫色令牌以打开子工作表编辑器。

• 子工作表可以引用母工作表中的变量（前提是这些变量已在子工作表行上方声明）。

带范围的滑块令牌 (Slider Tokens with Ranges)

• 滑块令牌允许您指定可拖动滑块的范围

  • 从标签栏的 + 按钮创建滑块。

  • 双击绿色令牌以打开滑块弹出窗口。

分隔线 (Divider Lines)

• 输入三个破折号 (-) 即可插入一条分隔线。

• 使用分隔线在工作表的不同部分之间创建更强的视觉分隔。

Soulver X1 (2024)

X1 包含了 Soulver 最受关注的功能实现，包括：

• 自定义函数支持（包括自然语言函数）

• 跨工作表共享变量（通过新的“标题”工作表）

• 连接 Web API（只需粘贴和几次点击）

标签页 (Tabs)

Soulver X1 中的多个标签页

Soulver X1 中的文档从一个标签页开始，您可以通过点击标签栏右侧的 + 按钮添加更多标签页。

重命名标签页

双击标签页的标题即可为其设置别名。或者，按住 control 键点击标签页并选择“重命名”。

删除标签页

当鼠标悬停在标签页上时，点击 x 按钮进行删除。或者，按住 control 键点击标签页并选择“删除”。

标签页是一个进行中的功能。

您目前无法重新排列标签页，并且在一个文档中添加过多的标签页无法正常工作。

标题工作表 (The header sheet)

标题工作表是专门用于定义可以在文档所有标签页中使用的变量、单位、函数和网络值的工作表。

跨标签页变量

请像声明本地变量一样，在标题工作表中声明您的文档变量。

例如：

my variable = 123

my variable 将在您的所有工作表中可用。

您的标签页只能引用变量，但不能修改其定义，使其适用于文档中的其他工作表。

等效单位 (Equivalence units)

等效单位是根据现有单位定义的。

您可以使用以下方式在标题工作表中定义新的等效单位（例如）：

1 watermelon = 10 lb

在 Soulver X1 中声明新的质量单位

现在可以在您的标签页中使用 watermelon 作为质量单位了。

在 Soulver X1 中使用自定义等效单位

Soulver X1 会自动为您（在英文中）复数化您的新单位。

因此，在这个例子中，即使定义是 "watermelon"，"watermelons" 也会被识别为有效的单位名称。

通用单位 (Generic units)

等效单位是一种全新的单位类型，不是根据现有单位定义的。

您可以使用以下方式在标题工作表中定义新的通用单位（例如）：

operation = new unit

在 Soulver X1 中声明通用单位类型

现在可以在您的标签页中使用 operation 单位了（包括在比率中）：

在 Soulver X1 中使用通用单位

自定义函数 (Custom functions)

介绍

函数是一个方便的短语，它接收一个输入并返回一个输出。在 Soulver X1 中，您可以使用（几乎）任何函数语法，包括：

C 风格: doSomething(123)

Swift 风格: doSomething(with: 123)

自然语言: do something with 123

如何创建新的自定义函数（在标题工作表中）

• 点击 Define New > Function

选择函数名称：

在 Soulver X1 中声明新函数

• 使用您实际使用该函数的示例来定义您的函数。

• 选择任何参数（只要它们与您期望的参数“类型”匹配，例如金钱、时间、纯十进制数字等）。

实现您的函数：

编写一个计算特定金额销售税的函数

• 在专用的 Soulver 工作表中实现该函数。任何参数都将作为黄色令牌注入。

• 将鼠标悬停在参数令牌上，即可查看它在声明中引用了哪个参数。

• 实现工作表的最后一行将被返回为函数的最终值。

使用您的函数

在所有工作表中，使用您的函数和其它输入值。

网络值（连接到 JSON API）

如何创建新的网络值（在标题工作表中）

• 点击 Define New > Web Value

如何连接到 JSON 数据源中的特定数据点

在 Soulver X1 中连接到远程数据源

• 粘贴一个指向 JSON 数据源的 URL，然后只需点击您希望连接的数据点即可。

使用网络值

• 您的网络值将被分配一个变量名（默认情况下，与 JSON 源中的描述匹配）。

• 您可以欢迎将变量名更改为其他名称。

更新网络值

• 您设置的频率将自动在后台更新您的网络值。

编辑网络值

• 双击标题工作表中的黄色网络值令牌，以指定不同的数据点或更改更新频率。

Soulver X Series 文件类型

Soulver X 系列应用使用与 Soulver 不同的文档类型（.slvrx）。

这是为了支持我们正在构建和试验的新功能。

Soulver X (.slvrx) 文件不能使用 Soulver 3 for Mac、iOS 和 iPad 进行编辑。