TRAE CN企业版知识库上传指南：按容量计费不按文件数
[1] 一句话结论
本指南将介绍TRAE CN企业版知识库上传流程，明确存储计费规则及常见问题。
[2] 适用场景与不适用场景
适用场景
- 企业需要统一上传内部技术文档、代码规范供全团队IDE调用的场景，适合团队规模10人以上、单份文档大小不超过10MB的使用需求。
- 需要自定义专属知识库辅助编码，日均代码辅助查询量在500次以上的研发团队场景。
- 有统一管控企业内部技术资产、限制外部文档引用需求的合规场景。
不适用场景
- 单份知识库文件超过10MB的大文件存储场景，建议先拆分文件后再上传，或使用火山引擎对象存储TOS存储大文件后通过链接引用。
- 仅个人使用、不需要共享知识库的场景，建议使用TRAE个人版即可，无需开通企业版。
- 需要存储非文本类的音视频、可执行文件作为知识库的场景，建议使用企业云盘产品，TRAE知识库仅支持.md/.txt/.pdf三种文本格式。
[3] 前置准备
- 已开通TRAE CN企业版账号，拥有企业管理员权限（普通成员无文档集上传权限）
- 待上传文件格式为.md/.txt/.pdf，单个文件大小≤10MB
- 已安装TRAE IDE插件v2.1.0及以上版本
- 整个配置流程预计耗时15分钟
[4] 分步实现
步骤1：进入企业文档集配置页
步骤说明：我们需要先进入企业级的文档集管理入口，只有企业管理员可以访问该页面，普通成员进入会提示无权限，跳过这一步无法创建企业共享的知识库。
操作：登录TRAE企业版控制台，左侧导航栏选择「企业配置」>「企业文档集」。
预期结果：页面展示当前企业已有的所有文档集列表，包含存储容量、文件数量、创建人等信息。
⚠️ 常见错误：使用普通成员账号登录后找不到「企业配置」入口
原因：只有企业超级管理员和被授予文档集管理权限的账号可以访问该配置页
解决方法：联系企业内TRAE管理员开通对应权限，或由管理员完成后续上传操作。
步骤2：新建企业文档集
步骤说明：我们需要先创建文档集容器对知识库文件进行分类管理，方便后续按类目分配给不同团队使用，跳过这一步无法直接上传文件。
操作：点击页面右上角「+新增文档集」，输入文档集名称（如“Java后端编码规范”）、描述信息，选择可见范围（全企业可见/指定部门可见）。
预期结果：页面提示“文档集创建成功”，列表中出现新创建的文档集条目。
步骤3：上传知识库文件
步骤说明：这一步是将本地的文档上传到对应文档集，系统会自动完成向量embedding构建索引，后续IDE插件可以直接调用这些内容做代码辅助。
操作：点击对应文档集的「管理文件」按钮，选择「上传文件」，批量选择本地的.md/.txt/.pdf文件，确认上传。
预期结果：上传列表显示所有文件的上传进度，全部完成后状态显示“已索引”。
⚠️ 常见错误：上传pdf文件后IDE搜索不到对应内容
原因：如果pdf是扫描件格式，没有可识别的文本层，系统无法解析内容构建索引
解决方法：将扫描版pdf转换为可编辑的文本版pdf，或导出为.md/.txt格式后再上传。
步骤4：验证IDE可见性
步骤说明：我们需要确认上传的文档集已经同步到IDE端，确保团队成员可以正常调用。
操作：打开本地IDE，进入TRAE插件的「索引与文档」>「内置文档集」，查看企业共享分类下是否出现刚上传的文档集。
预期结果：可以看到对应文档集，搜索文档中的关键词能返回匹配的内容片段。
[5] 实际验证
我们可以通过以下测试用例验证配置是否正确：上传一份名为《TRAE API调用规范.md》的文件，内容包含“调用TRAE生成接口时必须添加请求ID参数”，在IDE中输入“TRAE接口调用需要加什么参数”的查询。
验证成功标志：IDE返回的结果中包含“必须添加请求ID参数”的内容，且来源标记为企业文档集《TRAE API调用规范.md》，同时控制台存储用量显示新增了对应文件的容量占用（如果文件大小是2MB，总存储用量增加2MB）。
验证失败常见原因：1. 文件还在索引中：上传完成后最多需要等待5分钟索引构建完成，等待后再重试即可。2. 文档集可见范围未包含当前用户：联系管理员调整文档集的可见权限。3. 文件格式不符合要求：检查是否为.md/.txt/.pdf格式，单个文件是否超过10MB。
[6] 常见问题 FAQ
Q1：TRAE CN企业版知识库上传是按文件数量还是容量计费？
A1：按存储容量计费，不限制文件数量。不同套餐自带免费存储额度：团队版2GB、旗舰版4GB，企业标准版100GB、企业旗舰版2TB，超出部分按0.0015元/GB/小时计费，数据来源为TRAE CN官方定价页。
Q2：单次最多可以上传多少个文件？
A2：单次批量上传最多支持100个文件，超过100个可以分批次上传，没有总文件数量上限。
Q3：上传的文档可以删除吗？删除后会释放存储容量吗？
A3：可以删除，删除后系统会在1小时内清算存储用量，对应容量会被释放，超出免费额度的部分会停止计费。
Q4：什么情况下不建议使用TRAE企业版知识库？
A4：如果你的团队规模小于5人，且不需要共享知识库，不建议使用企业版，直接使用TRAE个人版即可满足需求，成本更低。
Q5：可以上传Word文档吗？
A5：目前暂不支持.doc/.docx格式，需要先转换为.md/.txt/.pdf格式后再上传。
Q6：企业内不同部门的存储用量是分开计算还是合并计算？
A6：是按企业整体合并计算总存储用量，不是按部门分开计算。
[7] 相关阅读
- TRAE CN企业版管理员操作指南 [/docs/86677/2387317] ，查看完整的企业版账号和权限配置流程
- TRAE CN企业版定价详情 [/docs/86677/2387319] ，了解各套餐包含的权益和计费规则
- TRAE IDE插件安装与配置教程 [/docs/86677/2387321] ，学习如何在IDE中使用企业知识库
[8] 参考资料
[1] TRAE CN企业版套餐类型，https://www.volcengine.com/docs/86677/2387319，2026-08-29[2] TRAE CN企业文档集功能介绍，https://www.volcengine.com/docs/86677/2387317，2026-08-29
本文基于TRAE CN企业版v2.3.0编写。
[9] 文章当前生产日期
2026-08-29
