工作空间下载
了解如何下载工作空间内容到本地
工作空间下载
Knodo 支持将工作空间的知识库内容下载到本地。本文档介绍下载功能的使用方法。
功能概述
工作空间下载功能允许您：
- 将知识库内容打包为 ZIP 文件
- 下载到本地进行备份
- 离线查看和编辑
- 迁移到其他平台
下载步骤
步骤 1：进入设置
- 打开目标工作空间
- 点击设置图标
- 进入工作空间设置页面
步骤 2：找到下载选项
- 滚动到"高级设置"部分
- 找到"下载工作空间"选项
步骤 3：开始下载
- 点击"下载工作空间"按钮
- 系统开始打包文件
- 等待打包完成
- 浏览器自动下载 ZIP 文件
下载内容
包含的内容
下载的 ZIP 文件包含：
workspace-name.zip
├── README.md # 工作空间说明
├── docs/ # 文档目录
│ ├── document1.md
│ ├── document2.md
│ └── subdirectory/
│ └── document3.md
└── assets/ # 附件目录
├── image1.png
└── file1.pdf不包含的内容
以下内容不会被下载：
- AI 对话历史
- 任务数据
- 成员信息
- AI Agent 配置
- 插件绑定关系
下载格式
ZIP 格式
目前仅支持 ZIP 格式下载：
- 通用的压缩格式
- 保留目录结构
- 支持所有操作系统
文件编码
- 文本文件使用 UTF-8 编码
- 保留原始的换行符格式
使用场景
1. 数据备份
定期下载工作空间内容作为备份：
- 防止意外数据丢失
- 保留历史版本
- 离线存档
2. 本地编辑
下载后在本地使用喜欢的编辑器：
- 使用 VS Code 等编辑器
- 批量修改文件
- 使用本地 Git 管理
3. 内容迁移
将内容迁移到其他平台：
- 迁移到其他文档平台
- 分享给外部团队
- 导入到其他工作空间
4. 离线访问
在没有网络的环境下查看：
- 出差或旅行时
- 网络不稳定时
- 演示或培训时
注意事项
1. 下载权限
- 只有工作空间成员可以下载
- 管理员可在工作空间设置中关闭下载功能（见下方"下载控制"章节）
- 当下载功能关闭时，所有角色（包括管理员）均无法下载
2. 下载控制
管理员可以在工作空间设置中控制是否允许下载：
- 进入工作空间设置 → 存储管理
- 找到"允许下载"开关
- 关闭后，以下操作将被禁止：
- 文件树右键菜单中的"下载"选项将隐藏
- 文件预览区域的下载按钮将隐藏
- 不支持预览的文件将显示"该空间已禁止下载"提示
- 后端下载 API 将返回 403 错误
- 开启后，恢复正常下载功能
适用场景：
- 存储了敏感或重要资料的工作空间
- 需要限制内容外流的场景
- 仅允许在线查看不允许离线保存的需求
3. 文件大小
- 大型工作空间可能需要较长打包时间
- 建议定期清理不需要的文件
- 超大文件可能导致下载失败
3. 同步状态
- 下载的是当前最新版本
- 下载后的修改不会自动同步
- 如需同步，需要手动上传
4. 敏感信息
- 下载前检查是否包含敏感信息
- 妥善保管下载的文件
- 不要在不安全的环境中打开
上传和恢复
目前不支持直接从 ZIP 恢复工作空间，但您可以：
- 创建新的工作空间
- 通过文件管理上传内容
- 手动配置工作规范和设置
常见问题
Q：下载需要多长时间？
A：取决于工作空间大小。通常几秒到几分钟不等。
Q：可以只下载部分文件吗？
A：目前不支持选择性下载，只能下载全部内容。如需部分文件，请在下载后手动筛选。
Q：下载失败怎么办？
A：请检查网络连接，稍后重试。如果持续失败，请联系客服。
Q：Git 历史记录会被下载吗？
A：不会。下载的是当前版本的文件快照，不包含 Git 历史。
Q：可以下载其他成员的工作空间吗？
A：只能下载您有访问权限的工作空间。