目录
CADBase 库
CADBase 库 (CADBase Library) 是连接 FreeCAD 与 CADBase 平台的桥梁，为本地设计增添云设计的优势：
- ✓ 可访问性 — 从任何设备处理您的项目。
- ✓ 项目存储 — 将 FreeCAD 与云存储同步。
- ✓ 团队协作 — 并行开发组件和修改版本。
- ✓ 安全性 — 可靠的存储和高效的版本管理。
- ✓ 组件库 — 使用带有 FreeCAD 模型的现成零件。
通过 FreeCAD 的 CADBase Library 插件保存项目，并从任何计算机访问组件。
CADBase 平台上的文件集
文件集概念
文件集在组件修改版本内部按应用程序组织数据。例如，设计师使用 FreeCAD 文件集，而文档则直接附加到修改版本。
文件集内的数据存储没有限制 — 您可以上传任何文件。
文件集 specialization
- FreeCAD — 用于 FreeCAD 设计的图纸、模型和资源。
- 其他文件集 — 来自各种 CAD 和软件应用程序的文件。
插件如何工作
该插件创建组件的文件夹层次结构，并且仅同步 FreeCAD 文件集中的文件。这使得团队可以在不同的应用程序中并行工作，而不会发生版本冲突。
安装与设置
通过 FreeCAD Addon Manager 安装
这是安装 CADBase Library 的最简单方法：
- 在 FreeCAD 主菜单中，选择 Tools → 打开 Addon Manager。
- 等待可用插件列表更新。
- 在搜索栏中输入 "CADBase Library" 并选择找到的工作台。
- 单击 Install 按钮并等待过程完成。
- 重新启动 FreeCAD。
- 重新启动后，CADBase Library 将出现在工作台列表中。
CADBase Library 需要 FreeCAD 版本 0.21 或更高。
配置
首次启动与设置
重新启动 FreeCAD 后：
- 选择 CADBase Library 工作台。
- 指定本地库的文件夹。
您来自 CADBase 的组件将在此文件夹中可用。
工作台配置
要打开 CADBase Library Configuration 窗口：
- 在 CADBase Library 窗口中，转到 Options 选项卡。
- 单击
Settings 按钮。
库路径配置
指定计算机上用于存储本地组件库的文件夹。
更改将在重新启动 FreeCAD 后生效。更改路径时，现有文件不会自动移动。
服务器地址
指定用于连接的 CADBase 服务器的 URL 或 IP 地址。
要将设置重置为默认值，只需单击 Reset。
上传参数
配置云存储逻辑：
Skip calculate hash
仅上传新文件，不检查现有文件中的更改
Forcibly update files
更新云中的所有文件，忽略检查
这些设置仅影响数据上传到云端。下载时，文件永远不会被自动覆盖。
在 CADBase 平台上授权
要使用云存储，您需要获取访问令牌：
- 在 CADBase Library 窗口中单击
Authorization 按钮。 - 在打开的窗口中输入：
- 用户名（您的登录名）
- 密码
- 对于新用户： 勾选 Set to create a new user...
- 单击 OK 按钮以获取令牌。
- 等待授权完成。
授权数据将被保存 — 在后续启动 FreeCAD 时无需输入密码。
令牌更新： 重复步骤 1 和 4。
验证工作
确保库已正确连接到您的帐户：
- 切换到 CADBase Library 工作台。
单击
Update list。
- 等待您收藏的组件出现在库树中。
注意： 单击按钮后，请等待过程完成...时间取决于数据量和互联网速度。请勿关闭 FreeCAD 或中断过程，否则数据将无法完全下载。
完成！ 如果您看到组件列表 — 则设置成功。您可以继续使用库。
导航与管理
本地存储结构
- 库 (蓝色块) — 根级别，显示已收藏和已下载的组件。
- 组件 (紫色块) — 此级别显示组件的修改版本。
- 修改版本 (橙色块) — 此级别显示本地存储中的文件集。
- 文件集 (绿色块) — 通过 FreeCAD 使用的文件。
库树导航
刷新列表后，仅显示组件名称。
要加载修改版本和文件，请双击树元素：
- 组件 — 更新所选组件的修改版本列表，在本地存储中创建修改版本和文件集的文件夹。
- 修改版本 或 FreeCAD 文件集 — 从 FreeCAD 文件集下载文件。
- .FCStd 文件 — 将模型导入当前文档。
要在不同步的情况下展开列表，请单击要展开的文件夹旁边的箭头 (▸)。
主要控制按钮
同步
Update list — 从书签加载当前的组件列表。
Upload files — 打开对话框以将本地更改发送到云端。
New component — 打开对话框以创建组件。
数据操作
Open directory — 在文件资源管理器中打开文件夹。
Copy link — 复制组件链接以供共享。
Merge — 将所选文件导入当前文档。
系统
Settings — 打开对话框以更改工作台配置。
Authorization — 打开对话框以输入凭据并刷新访问令牌。
实际应用
创建新组件
组件可以是零件、装配体、节点或任何其他设计开发对象。
通过 FreeCAD 在 CADBase 库中创建组件 — 3 个步骤：
- 单击 New component 按钮。
在对话框窗口中输入组件名称。
- 单击 OK 进行创建。
组件创建过程
创建后：
- 组件将出现在您的书签中。
- 将创建初始修改版本 N1。
- 库中的组件列表将更新。
创建组件结构
要开始使用组件，请在本地存储中创建结构：
- 在库树中找到创建的组件
- 双击它
系统将创建修改版本和文件集的文件夹。
将文档保存到文件集
将文档与组件关联以进行后续同步：
- 打开或创建 FreeCAD 文档。
- 将其保存到文件集文件夹：
CADBase Library→Component→N1→📁FreeCAD
发送更改时，此文件夹中的文件将上传到云端。
FreeCAD 文件夹位置
发送数据
要将更改发送到云端：
- 选择包含已更改文件的修改版本。
您可以选择修改版本文件夹或具体的 FreeCAD 文件集文件夹。 - 单击 Upload files 按钮。
- 在打开的窗口中检查更改：
文件上传窗口（示例）
• new — 文件将添加到云端• modified — 文件将替换云中的旧版本• deleted — 文件将从云端删除 - 添加更改注释（可选）。
将帮助同事理解更改内容。 - 单击 OK 开始上传。
更改上传将在单击按钮后开始。
可以在 FreeCAD 的 Report View 面板中跟踪上传进度。
替换本地文件
如果需要从云端下载文件的新版本：
- 在库树中找到文件并单击 Open directory
- 在打开的文件夹中删除该文件。
- 返回 FreeCAD 并双击文件集文件夹。
系统将从云端下载当前版本。
如果文件在云端被其他用户修改，或者您想撤销自己的更改。
将文件导入文档
将现成的零件和装配体添加到您的项目中：
- 在组件库中找到文件。
- 单击 Merge 或双击文件。
- 模型将出现在您的文档中
作为用于编辑的独立对象。
适用于： 装配体、使用标准零件、分部分处理复杂项目。
管理书签
书签有助于快速找到所需的组件。在 CADBase 平台上管理它们：
- 通过CADBase 搜索查找组件。
- 打开组件页面。
- 点击组件页面上的书签图标
添加或移除书签。
新书签将在刷新列表后出现。
即使从书签中移除，已下载的组件仍将保留在库中。
配置组件访问权限
新组件默认是关闭的（私有的）。要打开访问权限：
- 在组件上单击 Copy link。
- 在浏览器中打开链接。
- 在组件设置中将访问权限更改为 "public"。
- 保存更改。
现在该组件对其他用户可见。
在 CADBase 平台上选择访问类型
常见问题 (FAQ)
可以离线工作吗？
可以，使用先前下载的组件。
发生版本冲突时会发生什么？
优先使用本地版本。
可以在多台计算机上使用一个帐户吗？
可以，没有限制。
可以在名称中使用特殊字符吗？
可以使用任何字符，但请注意组件名称将成为文件系统中的文件夹名称。
哪些文件可以导入文档？
支持的格式：FCStd, STEP, BRP 和 BREP。
如何确保数据安全？
灵活的访问管理系统允许为单个用户和公司配置数据访问权限。
工作台可以在内联网（隔离网络）中工作吗？
可以，这需要在网络内部部署服务器部分。
问题排查 (Troubleshooting)
授权错误
通过 Authorization 按钮刷新令牌。
无连接
检查互联网连接以及对 Server URL 中指定地址的访问。
未显示组件
确保它们已在网站上添加到收藏夹。
设置未应用
某些设置需要重新启动 FreeCAD。
无法访问 api.cadbase.rs 服务器
在工作台设置中切换到 https://api.cadbase.org 服务器。
云中的文件未更新（SHA256 错误）
在设置中启用 Forcibly update files。
文件未同步（UUID 过时）
从组件文件夹中删除 component 文件，并从文件集中删除 modification 文件。
调试
在库根目录中创建 cadbase_file_2018.log 文件，它将保存日志和其他数据用于调试。