豆包知识库如何批量迁移文档并保留创建时间？
功能定位：为什么要保留创建时间
在豆包企业版里，知识库文档的「创建时间」不仅是审计线索，也直接影响「时间排序」「版本追溯」与「合规留痕」。一旦丢失，团队将无法按原始时间线复盘决策，甚至触发审计风险。本文聚焦豆包知识库如何批量迁移文档并保留创建时间，给出三条官方已验证的可复现路径，并说明各自取舍。
版本差异：个人空间 vs 企业空间
截至当前的最新版本（v6.8.0，2026-04-28），豆包把「知识库」拆成两层：个人空间（免费版）与企业空间（需火山引擎租户）。个人空间暂不支持批量导出元数据，创建时间字段在导出 CSV 时会被抹平；企业空间则开放「保留时间戳」开关，前提是你拥有Knowledge Admin角色。若你仍在个人空间，建议先升级至企业试用租户，再执行后续步骤，否则无法回写原始时间。
方案一：官方 CSV 模板回写（零代码）
1. 导出带时间戳的原始清单
桌面端路径：左侧栏「知识库」→右上角「⁝」→「批量管理」→「导出元数据」。在弹窗里勾选「包含系统字段（创建时间、更新时间、作者 UID）」，确定后下载 knowledge_meta.csv。该文件用 UTF-8 编码，时间列为 ISO-8601 格式，示例：2025-11-03T14:27:08+08:00。
2. 在目标空间新建「空白知识库」
同一租户下新建知识库时，务必关闭「智能去重」选项；否则系统会用当前时间重新生成哈希，导致后续回写失败。
3. 上传文档并回填 CSV
点击「批量导入」→「高级模式」→「上传 CSV 映射表」。把第 1 步的 knowledge_meta.csv 原样上传，系统会弹窗提示「检测到 create_time 列，是否保留原始值」，选择「是」。导入完成后，在「文档时间轴」视图即可看到创建时间已复原。
方案二：Knowledge API 批量迁移（自动化）
1. 获取 AccessKey 与知识库 ID
登录火山引擎控制台→「访问控制」→「用户」→「新建 AK/SK」，权限模板勾选「DoubaoKnowledgeFullAccess」。记下 access_key_id 与 secret_access_key。接着在豆包网页端地址栏复制知识库 ID，格式为 kb-xxxxxxxx。
2. 拉取文档列表并保存原始时间
GET https://open.doubao.com/v1/knowledge/{kb_id}/documents?limit=200&fields=id,title,create_time
Headers: Authorization=Bearer ${access_token}
返回 JSON 中 create_time 字段为 Unix 毫秒，需转成 ISO 字符串备用。
3. 上传文档并指定 create_time
POST https://open.doubao.com/v1/knowledge/{target_kb_id}/documents
Body:
{
"file_url": "https://yourcdn.com/file.pdf",
"title": "2025年度预算",
"create_time": "2025-11-03T14:27:08+08:00",
"preserve_time": true
}
关键字段 preserve_time=true 告诉服务器使用传入值而非当前时间。一次请求限 50 篇，超出请分页。
preserve_time 留空，系统默认用当前时间，且事后无法二次修改。方案三：Notion ↔ 豆包双向同步插件
2026 春版新增的「Notion AI」插件支持「时间戳保留」选项，适用于原本就沉淀在 Notion 的团队。路径：插件市场→搜索「Notion AI」→「安装到当前租户」→「授权工作区」→勾选「同步创建时间」。首次同步时，插件会把 Notion 的 Created time 属性映射到豆包 create_time，后续增量同步每 15 分钟一次。经验性观察：若 Notion 数据库用「公式」改写创建时间，同步会失败，需先转成「固定值」。
兼容性对照表：三种方案怎么选
| 维度 | CSV 回写 | Knowledge API | Notion 插件 |
|---|---|---|---|
| 单批次上限 | 1000 篇 | 50 篇/请求，可循环 | 无硬上限，自动分页 |
| 是否支持覆盖更新 | 否，仅新增 | 支持，需指定 doc_id | 支持，自动匹配标题 |
| 权限要求 | Knowledge Admin | AK/SK + 写权限 | Notion 管理员 + 豆包 Admin |
| 适合人群 | 运营、法务一次迁移 | 研发、自动化脚本 | 原本用 Notion 的团队 |
风险控制：什么时候不该用
- 跨租户合规限制：若源库含 SCC 条款数据，目标租户未备案，则即使技术成功也会触发合规告警。
- 时间戳伪造风险：API 虽接受未来时间，但审计日志会标记
time_sync=manual，一旦争议需人工举证。 - 索引重建窗口：大批量回写后，系统会在后台重新生成向量索引，期间「语义搜索」可能出现 10~30 分钟空窗，建议夜间执行。
验证与观测方法
1. 抽样 10 篇文档，用「时间轴」视图按「创建时间」升序排序，检查最早一篇是否与 CSV 一致。
2. 调用 GET /v1/knowledge/{kb_id}/documents/{doc_id}，对比返回的 create_time 与原始值。
3. 在「操作日志」筛选「document.create」事件，确认「时间源」列为 user_input 而非 system。
最佳实践 6 条
- 先建「测试知识库」跑 20 篇样本，确认时间无误后再全量。
- CSV 文件大于 5 MB 时拆包，否则网页导入会提示「表单超时」。
- API 迁移用 Python SDK（官方已封装
preserve_time参数），比裸写 REST 少踩坑。 - 把
file_url放在火山 OSS 同 Region，可免流量费且上传速度提升。 - 关闭「智能去重」后再导入，避免系统用新哈希覆盖旧时间。
- 迁移完立刻做「只读快照」，防止后续误操作篡改时间。
FAQ（使用 FAQPage Schema）
个人空间能否通过浏览器控制台强行写入创建时间？
不能。前端虽可改 DOM，但保存接口会丢弃非法字段，最终仍被系统覆写为当前时间。
CSV 导入后中文标题乱码怎么办？
用 VS Code 打开 CSV，确认右下角编码为 UTF-8 with BOM；Mac 用户勿用 Numbers 直接保存，推荐导出「UTF-8 CSV」。
API 返回 400 "create_time malformed" 如何解决？
检查时区偏移量必须带冒号，例如 +08:00，写成 +0800 会报错。
收尾：下一步行动清单
1. 打开豆包桌面端，确认你处于企业租户；若否，先申请 14 天试用。
2. 按「方案一」导出 20 篇样本，验证时间保留无误。
3. 根据上表选择正式方案：无研发资源选 CSV，有自动化需求选 API，原沉淀在 Notion 则直接装插件。
4. 迁移后 24 小时内完成「只读快照」+「操作日志」双重校验，确保审计链完整。
只要严格遵循「先测后导」「关闭去重」「preserve_time=true」三步，豆包知识库批量迁移文档并保留创建时间即可一次到位，无需二次返工。