本节将详细介绍你的3D数据如何发送到 Speckle 并存储在 Speckle 中。 无论你是 Speckle 的新手还是只是需要复习，这都是一个很好的起点！
1、关于Speckle术语
我们尽量使本指南简单明了，删除了技术语言，除非绝对必要。 值得注意的是，每当我们提到术语数据、对象或元素时，我们实际上指的是同一件事。 Speckle 旨在处理各种数据，无论是 CAD 几何、BIM 元素（几何 + 元数据）还是纯数据（文本、数字等）。
2、Speckle中的流、分支和提交
Speckle 数据是使用一种在软件开发中普遍采用的强大而复杂的协作方法来组织的。 为了简单起见，我们使用相同的概念和术语，称为流、分支和提交。
要使用 Speckle，你只需要知道流是什么。 分支和提交稍微高级一些，但会为你未来的协作工作流程增加很多灵活性和控制力。
3、Speckle流
3.1 什么是流
Speckle 中的主要数据结构是流（Stream）。
流只是数据的集合，其中包含一些附加信息以帮助你管理和检索它们。 每个流都分配有一个 streamId，它唯一标识服务器上的流。 你还可以指定名称和描述以帮助跟踪您的流。
流还允许你管理权限：它有一个协作者列表，包括所有者以及所有者选择与之共享流的其他审阅者和贡献者。
3.2 Speckle流包含什么？
Speckle流可以包含从少量对象到整个建筑模型的任何内容。 你可以自由地向单个流中添加尽可能多或尽可能少的数据，并根据需要创建任意数量的流。 流中可能包含的内容的一些示例是：
- CAD 应用程序中的图层
- 一组计算结果
- Revit 中的工作集
- 来自 Grasshopper 的精选对象
- 结构模型
流还包含使用分支和提交管理数据的更多选项。 不要担心这些 - 我们将在以下部分中介绍它们。
3.3 我可以与谁分享Speckle流？
流可以是公开的（public）或私有的（private）：
- 公开：知道链接或 streamId 的任何人都可以查看流
- 私有：人们需要作为协作者添加到流中才能访问它
任何受邀作为协作者的人都可以拥有不同级别的流访问权限，具体取决于你为其分配的角色：
- 所有者：完全访问权限，包括删除权限和编辑用户权限。
- 贡献者：可以编辑流的内容（创建新的分支和提交）但不能编辑流的详细信息（名称和描述）或管理权限。
- 审阅者：对流的仅查看访问权限。
3.4 如何使用流？
流是人们和应用程序之间共享数据的主要机制。 例如，你可以在 Revit 中创建一个流并将该数据发送到你的服务器。 然后，任何有权访问该流的同事都可以在浏览器中查看数据或在 Grasshopper、Rhino、Revit 等中接收数据。
如果你的任何同事具有协作者访问权限，他们也可以自由地进行自己的更改并将更改发送到流。 然后，你可以从原始模型中的流中接收这些更改，以查看反映的更改。
要查看有关如何在各种支持的应用程序之间发送数据的分步指南，请查看我们的教程。
4、Speckle分支
4.1 什么是Speckle分支？
分支（Branch）为你在流中提供了额外的组织层。 Speckle 用户经常使用分支来执行并行研究/设计选项。
所有流都以一个名为 main 的默认分支开始。 如果你想从此主分支“分支”并并行处理多个不同版本的数据，或者如果你想将数据的不同部分彼此分开，这就是分支的用武之地。
4.2 如何使用分支？
你可以根据需要向流中添加任意数量的额外分支。 Speckle Web App 为你提供了创建新分支和在它们之间切换的选项。
假设你有一个非常大的模型要添加到单个流中，但是来自不同学科的合作者不想每次都收到整个模型。 你可以将模型拆分为不同的分支：结构、机电、建筑。
或者你可能有一个复杂的模型，其中包含一个具有多个独立建筑物的站点。 你仍然可以将整个模型包含在单个流中，但为每个建筑物创建一个单独的分支：建筑物 A、建筑物 B、建筑物 C。
也许你的工作规模较小，并且想向客户展示不同的立面选项。 流可以分为选项 A、选项 B 和选项 C，然后你可以轻松地在它们之间切换以在下一次会议中探索不同的选项。
如果你碰巧熟悉 git，可能想知道“我是否也可以将一个分支的内容合并到另一个分支中？”。 答案是肯定的，但目前这只能发生在我们拥有连接器的 AEC 软件之一中。 然后可以将合并的数据重新发送到现有的或新的分支机构。
5、Speckle提交
5.1 什么是提交？
Speckle提交本质上是你的数据的快照 - 你“提交”更改的时间点。 它们允许你跟踪流中的更改，并轻松查看谁更改了什么以及何时更改。 提交的好处在于，它们会创建一个时间轴，记录你的Speckle流所经历的所有更改，并让你有可能回到过去，将你的模型重置为任何版本——只要你愿意！
每次向 Speckle 发送数据时，都会自动创建一个新的提交，其中包含流中的所有对象以及其他信息，例如提交的时间、日期和作者。 你还可以添加一个可选的提交消息，它是对你所做更改的简短描述。 与流一样，每个提交都分配有一个生成的 commitId，可用于识别和检索它。 你可以回到过去并通过一系列提交查看流的历史记录。
告别将文件保存为“AM_Project_Design-final”、“AM_Project_Design-final-final”、“AM_Project_Design-final-final-latest”…！
重要🙌请注意：提交不可编辑，你可以更改其消息但不能更改其内容。 发送了错误的数据？ 没问题 - 只需发送正确的数据并从该提交开始工作。
5.2 我如何使用提交？
如果你使用过连接器并将数据发送到流，那么你已经使用过它们了！ 每次将数据发送到流时，都会创建一个提交。 为了帮助你跟踪流中的更改，最好添加一条提交消息，该消息简要描述提交包含的内容。 一些连接器为你预先填充了默认提交消息，但你仍然可以自由编写自己的连接器以添加更多详细信息。
在连接器中接收数据时，你可以选择与最新提交保持同步或接收基于 commitId 的特定提交。 如果你选择保留最新提交，将在其他人向流发送新数据时看到通知。 当看到它时，你将能够使用接收函数来获取新的提交并更新你的文件。
原文链接：Speckle核心概念 — BimAnt
