> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/guides/github-knowledge-search.md).

# GitHub 接进企业知识库：按仓库权限搜议题和文档

把 GitHub 接进 Duaer 知识库，员工直接问议题、拉取请求和 README 等文档；公开仓库全员可搜，私有仓库按 GitHub 读权限。
## Duaer 能在 GitHub 里搜到什么？

Duaer 索引最近推送的 100 个仓库：每个仓库最近更新的 500 个议题和拉取请求，连同评论；以及默认分支上的 Markdown 文件，例如 README 和 docs 目录，每个仓库最多 200 个。代码不索引。

员工可以问「发票金额差一分钱的问题后来怎么修的？」，Duaer 从议题评论里找到答案并附出处，点出处就在 GitHub 上打开那个议题。

## 怎么把 GitHub 接进 Duaer？

1. 在 GitHub 里创建一个个人访问令牌：经典令牌勾选 repo、read:org 和 read:user；细粒度令牌给内容、议题、拉取请求和元数据的只读权限。账号要能看到希望大家搜到的仓库。
2. 在 Duaer 里新建“GitHub API”凭证，填这个令牌；GitHub Enterprise 还要填服务器地址（例如 https://git.acme.com/api/v3）。也可以用“GitHub OAuth2 API”凭证。
3. 所有者或管理员打开「知识库」›「数据来源」，在「GitHub」卡片上选择这个凭证，点「连接」。
4. 稍等索引完成后，问一个答案就在议题或 README 里的问题，看出处是否指向那里。

## 谁能搜到哪个仓库的内容？

- 公开仓库：整个 Duaer 组织。
- 私有和内部仓库：在 GitHub 上对这个仓库有读权限的人，包括协作者、团队成员，以及通过组织基础权限能读的人。

GitHub 用户按公开邮箱对应到 Duaer 成员；仓库属于组织时，也按这个人在组织内的验证邮箱对应。对应不上的人搜不到私有仓库，数据来源卡片上会显示受影响的条目数。令牌列不出某个私有仓库的协作者时（需要推送权限），这个仓库的内容不对任何成员开放，卡片上会提示缺的权限。

## 有哪些限制？

- 最多 100 个仓库；每个仓库最多 500 个议题和拉取请求、200 个 Markdown 文件，单个文件不超过 1 MB；每个议题最多读前 100 条评论。
- 不索引代码、Discussions、Wiki、拉取请求的代码审查评论、发布和 Actions。

想看 Duaer 怎么把知识搜索和事项跟进放在一起，打开 [Duaer 官网](https://www.duaer.com/)。
## Questions

### Duaer 会改动 GitHub 里的内容吗？

不会。Duaer 只读取议题、拉取请求和文档建索引，不写入、不评论。

### Duaer 会索引 GitHub 上的代码吗？

不会，只索引议题、拉取请求和默认分支上的 Markdown 文件。

### Duaer 连 GitHub 需要什么令牌权限？

经典令牌需要 repo、read:org 和 read:user；细粒度令牌需要内容、议题、拉取请求和元数据的只读权限。

## 相关

- [把网盘、SharePoint 文件变成能问答的知识库：Duaer 怎么连](https://doc.duaer.com/zh/guides/sharepoint-drive-knowledge-base.md)
- [AI 搜索怎么守住文档权限：Duaer 沿用原系统的权限](https://doc.duaer.com/zh/guides/permission-aware-ai-search.md)
- [ServiceNow 接进企业知识库：按用户条件和角色搜索](https://doc.duaer.com/zh/guides/servicenow-knowledge-search.md)
- [Zendesk 工单和帮助中心接进企业知识库](https://doc.duaer.com/zh/guides/zendesk-knowledge-search.md)
- [AI 回答怎么附出处、不胡编：Duaer 的做法](https://doc.duaer.com/zh/guides/ai-answers-with-citations.md)