CodeBuddy需接入专属知识库才能准确引用内部文档。操作分三步：上传本地文档（PDF/MD等格式，待状态变“已就绪”）；关联Git仓库（HTTPS自动同步或本地直连命令）；验证生效（通过IDE提问并检查AI回复是否带出处标注）。

你想让CodeBuddy AI智能体在写代码、查文档或解释问题时，能准确引用你团队内部的接口规范、部署手册或历史Bug修复方案，而不是只靠通用知识瞎猜——这就必须给它喂入专属知识库内容。

上传本地文档到知识库

第一步：打开CodeBuddy管控台，点击左侧导航栏【知识库】→【新建知识库】，输入名称如“fastadmin-api-spec”，点击创建。

第二步：在新知识库页面点击【上传文件】，支持PDF、Markdown、TXT、DOCX格式；一次最多选5个文件，单个不超过100MB。

第三步：上传后等待索引完成——状态显示为“已就绪”才算真正可用，通常3～30秒，大PDF可能需1分钟。⚠️【未显示“已就绪”前，AI无法检索该文档内容】

这一步操作起来很简单，直接把文件拖进去就行。

关联Git仓库作为动态知识源

方法一：用Git URL自动同步

在知识库详情页点击【添加数据源】→【Git 仓库】，粘贴项目仓库HTTPS地址（如https://github.com/your-org/fastadmin-docs.git），填写分支名（默认main），勾选“启用自动同步”，设置同步周期为“每6小时”。

方法二：本地仓库直连（适合私有内网环境）

执行命令：codebuddy knowledge sync --local-path /path/to/your/docs --repo-id your-fastadmin-kb。该命令会扫描目录下所有.md/.rst/.txt文件并推送到指定知识库ID。

【注意：本地直连方式不会自动更新，每次文档变更后需手动重运行该命令】

验证知识库是否生效

步骤一：在IDE中打开任意代码文件，唤出CodeBuddy对话框，输入“/explain @fastadmin-api-spec 用户登录接口返回字段含义”。

步骤二：观察AI回复中是否引用了你上传的《FastAdmin API v2.3 接口文档.md》里的原文段落，并带出处标注（如“来源：API文档第4.2节”）。

步骤三：若未出现标注或内容明显偏离上传文档，则说明知识库尚未被正确关联——返回管控台检查该知识库是否已设为“默认启用”，且当前项目根目录下存在.codebuddy/config.json并包含"knowledge_base_id": "kb-xxx"字段。