集成

控制面板 → 集成——连接内容来源以及访问知识的渠道。

#内容来源

#已连接（始终启用）

#可用的连接器

可连接的来源数量受套餐限制。当达到上限时，来源上的 "连接" 按钮不可用——请断开其中一个，或升级到更高套餐。Slack 和 Telegram 机器人不计入此限制。

#连接 GitHub

#第 1 步 —— 授权

1. 在 LiKE 中进入 集成 → GitHub → "连接"
2. 选择一种授权方式：

#第 2 步 —— 选择内容

1. 连接后会显示一个包含文件夹和文件的仓库目录树
2. 勾选要导入的具体文件或文件夹（Selective Sync）
3. 支持的格式：.md、.mdx、Wiki 页面

#第 3 步 —— 运行同步

1. 点击 "同步"
2. 进度会实时显示
3. 完成后，文章会出现在列表中，并带有 GitHub 标签

#连接 GitLab

#第 1 步 —— 授权

1. 在 LiKE 中进入 集成 → GitLab → "连接"
2. 选择一种授权方式：

#第 2 步 —— 选择内容

1. 会显示一个包含 Wiki 页面和 Markdown 文件的项目目录树
2. 勾选要导入的具体页面（Selective Sync）

#第 3 步 —— 运行同步

与 GitHub 相同——点击 "同步" 并等待完成。

#连接 Gitea

Gitea 是一个自托管的 git 平台。它通过 Personal Access Token 和一个必填的实例 URL 连接（默认没有云端 Gitea）。

#第 1 步 —— 在 Gitea 中创建令牌

1. 在 Gitea 中打开 Settings → Applications → Generate New Token
2. 授予 read:repository 和 read:user 权限范围
3. 复制令牌

#第 2 步 —— 在 LiKE 中连接

1. 在 LiKE 中进入 集成 → Gitea → "连接"
2. 指定您实例的 Base URL（例如 https://gitea.company.com）——此字段为必填，缺少它连接将无法建立
3. 粘贴令牌
4. 选择文章的存放位置（空间及其中的文件夹——或新建）和一种模式（同步——持续镜像 / 导入——一次性复制）

如果 Gitea 管理员事先设置了 OAuth 应用，也支持 OAuth 2.0。首选路径是令牌。

#第 3 步 —— 选择内容并同步

1. 会显示一个包含 Wiki 页面和 Markdown 文件（.md、.mdx）的仓库目录树
2. 勾选所需的节点（Selective Sync）并点击 "同步"
3. 若要在 push 时自动更新，请设置 webhook——密钥在连接器卡片中生成。来自 Gitea 的文章为只读（与 GitHub/GitLab 相同）

#文件选择和同步筛选（GitHub、GitLab、Gitea）

对于 git 来源（GitHub、GitLab 和 Gitea），决定同步内容的逻辑比简单的"仓库开/关"更为精细：

#哪些内容会被同步

#路径筛选（selective sync）

您可以精确地缩小从仓库中获取的范围：

#变更检测（近期变更）

LiKE 不会在每次运行时"下载所有内容"。它采用变更检测：

• GitHub——通过 webhook（推荐）或使用 If-Modified-Since 头进行轮询。webhook 对 push 即时响应，轮询——每 6/12/24/48 小时一次（取决于自动同步）。
• GitLab——同理：webhook 或通过 Projects API 按 last_activity_at 轮询。
• Gitea——webhook（X-Gitea-Signature 签名）或轮询。push 触发器仅在 *.md/*.mdx 变更时触发。

一旦检测到变更，只有受影响的文件会被同步；语料库的其余部分不会重新计算。这能大量节省 GitHub/GitLab API 配额和执行时间。

#分支和标签

#历史和冲突

• 同步历史——连接器卡片中的 "历史" 标签页：日期、状态（ 正常 / 警告 / 错误）、新增 / 更新 / 删除的文章数量、运行时长。用于排查"为什么仓库中的某篇文章没有出现"。
• 编辑冲突——如果来源文章在 LiKE 中被编辑过（对于 GitHub/GitLab，默认不允许——文章为只读）。如果模式为 导入（一次性复制），文章将变为可编辑，与来源的关联会断开。

#其他连接器的 Selective Sync

Notion、Confluence、Wiki.js——它们有各自的选择逻辑（页面树），但原理相同：

1. 连接时会显示来源的内容树
2. 复选框——勾选所需的节点
3. 其余内容不会导入
4. 重新同步时，仅更新已选中的项

#连接 Wiki.js

#第 1 步 —— 获取 Wiki.js API 令牌

1. 打开您的 Wiki.js → Administration → API Access
2. 启用 API（如果它被禁用）
3. 点击 New API Key
4. 为密钥命名（例如 LiKE Integration）
5. 分组：Administrators（需要对所有页面的访问权限）
6. 有效期：永不过期或 1 年
7. 复制生成的令牌

#第 2 步 —— 在 LiKE 中连接

1. 在 LiKE 中进入 集成 → Wiki.js → "连接"
2. 输入您 Wiki.js 的 URL（例如 https://wiki.company.com）
3. 粘贴 API 令牌
4. 选择一种模式：

5. 点击 保存

#第 3 步 —— 配置同步

#连接 Confluence

Confluence 通过 OAuth 2.0 连接——无需输入密码的安全授权。

#第 1 步 — 连接您的 Confluence 站点

1. 需要 Confluence Cloud——地址形如 your-company.atlassian.net。不支持 Confluence Server 和 Data Center
2. 点击「连接」并登录您的 Atlassian 账户
3. 在访问授权窗口中选择您的 Confluence 站点并点击「Accept」。LiKE 只能看到您有权访问的内容
4. 看到「Access denied」？请在 start.atlassian.com 上确认您的账户拥有 Confluence 站点。如果有，请让 Atlassian 管理员允许连接应用：admin.atlassian.com → Apps → 您的站点 → Connected apps → Settings → 关闭「Block user apps」

查看权限——LiKE 请求的是只读：页面内容和空间列表

#第 2 步 — 文章存放位置和获取内容

在 Confluence 卡片上打开 "设置"：

点击 "同步"。

#选择的工作方式

未勾选任何内容时没有可同步的内容——卡片会给出提示。取消勾选的空间会连同其文件夹一起从 LiKE 中移除。

#不迁移的内容

• 个人空间——不会出现在树中：它们是员工的个人笔记，名称就是本人的姓名。
• 对人的提及——带标签的提及保留标签文字，不带标签的提及会被删除；任务负责人不会迁移。LiKE 不存储 Atlassian 用户的标识符或个人资料。

来自 Confluence 的文章为只读。若要编辑，请在 Confluence 中修改原文，LiKE 会在下次同步时更新。

断开 Confluence 连接时，您可以保留这些文章在 LiKE 中的一份副本（它们会变为可编辑）或将其删除。

#连接 Notion

#第 1 步 —— 在 Notion 中创建集成

1. 打开 Notion → 点击您的头像（左上角） → Settings
2. 在左侧菜单中选择 My connections（或 Integrations）
3. 点击 Develop or manage integrations → New integration
4. 输入名称（例如 LiKE Import），选择一个 workspace
5. 点击 Submit → 复制 Internal Integration Secret（以 ntn_ 开头；对于较旧的集成——以 secret_ 开头）

#第 2 步 —— 授予集成对页面的访问权限

默认情况下，该集成对任何页面都没有访问权限。您需要显式允许：

1. 在 Notion 中，打开您想导入的每个页面（或父页面/数据库）
2. 点击 ⋯（三个点，右上角） → Connect to → 选择您的 LiKE Import 集成
3. 确认访问

#第 3 步 —— 在 LiKE 中连接

1. 在 LiKE 中 → 控制面板 → 集成 → Notion → "连接"
2. 粘贴 Integration Secret（第 1 步中复制的）
3. 选择文章的存放位置：空间及其中的文件夹——或在此直接新建文件夹或空间
4. 选择一种模式：

5. 在 "选择内容" 步骤中勾选要获取的内容：整个目录或单独的页面。目录是指您在第 2 步中授予访问权限的根页面或数据库。未勾选任何内容时，向导不会让您继续
6. 点击 "连接并同步" ——每个目录的文章会放入第 3 步所选文件夹内各自的文件夹中

#选择的工作方式

没有文字的页面——例如只有属性的数据库记录——不会成为文章。Notion 卡片会显示跳过了多少此类页面："已跳过空白页面：N"。

#第 4 步 —— 设置

在 Notion 卡片上打开 "设置"：

断开 Notion 连接时，您可以保留这些文章在 LiKE 中的一份副本（它们会变为可编辑）或将其删除。

#网页连接器

网页连接器只需几分钟即可将您网站的页面接入 LiKE。粘贴地址——LiKE 会通过站点地图（sitemap）或沿链接抓取找到页面，获取其文本，并使副本保持最新。LiKE AI 搜索可立即用于这些页面；如有需要，还可以在网站上放置搜索小组件——面向客户或面向员工。

适用于文档或帮助中心已经发布的情况——自有域名、Docusaurus、GitBook、Docsify 等。站点必须是公开的。一个组织只能接入一个站点。

#第 1 步 — 地址与页面查找方式

集成 → 网页连接器 → 接入。 粘贴地址即可，任意一个页面的地址都行，我们会抓取整个站点。

如何查找页面：

• 按站点地图——默认方式。站点地图由我们自动查找：先读 robots.txt，再试 /sitemap.xml；
• 没有站点地图 — 按链接抓取——从首页出发，在本站范围内沿链接抓取；请设置抓取深度。由脚本渲染的页面，沿链接抓取无法看到。

点击检查站点。若没有找到站点地图，向导会建议开启沿链接抓取并重新检查。

#第 2 步 — 将要抓取的内容

检查不会保存任何内容：它显示发现了多少页面、将添加多少页面。如果数量超出套餐额度，向导会立即告知，而不是抓取之后才说。

• 语言版本——当站点以多种语言提供页面时出现。选择要抓取的版本；数量和文件夹会据此重新计算。
• 将要抓取的内容——知识库中将生成的文件夹列表，附每个文件夹的页面数。勾选——抓取；取消勾选的文件夹可以重新勾选。已选择计数器只统计勾选的项。
• 标签与分类的归档页——指向文章的链接列表，而这些文章本身也会被收录——默认不抓取；如有需要请勾选。
• 如果站点按年份组织，每一年都会成为单独的文件夹。当有三年及以上时，默认勾选站点最新的两年；其余年份可以手动勾选。
• 站点的首页会成为"主页"文件夹中的一篇单独文章。
• 每次抓取的页面数——这是我们的设置，而非站点规模：其余页面将在后续抓取中获取。

页面属于哪个文件夹只能从页面本身判断，因此检查的页面会多于将要添加的页面；向导会同时显示这两个数字。

建议：抓取哪些内容（仅适用于沿链接抓取）。询问模型按钮会建议抓取哪些地址组、不抓取哪些，并附上理由。这只是建议，而非决定：请勾选您同意的项。消耗按编辑器 AI 操作计算；答案会被记住，只有点击重新计算才会重新生成。

#第 3 步 — 保存方式与存放位置

页面如何保存：

• 内部——只有团队可见——默认方式；
• 公开——所有人可见。

如果所选文件夹已对所有人开放，向导会提示您并建议选择公开：此类文件夹中的页面对所有人可见。若只想让团队看到，请选择内部——这样即使在公开文件夹中，它们也保持隐藏。在非公开文件夹中，内部页面遵循该文件夹的访问权限：如果之后将文件夹设为公开，它们会在个人数据检查后随之公开。

公开访问需要同时勾选两项确认：您拥有该站点及其内容的权利；站点上的个人数据系合法发布，且您有权使其在搜索和助手回答中可用。未勾选时，接入按钮不可用。同意会被记录——谁、何时、确认了什么文本——并适用于该站点的所有文章：发布这些文章时无需逐篇确认个人数据。这不适用于在编辑器中撰写的文章。要撤回同意，请断开该站点，并以"内部"方式重新接入。

存放位置：选择空间及其中的文件夹。没有合适的文件夹——在内部创建集合；没有合适的空间——创建新空间：它们会在连接时创建。空间本身不能作为目标，且文件夹必须为空：来源文件夹只能由连接器本身写入内容。

点击接入后立即开始抓取：进度显示在连接器卡片上（"正在同步所选 92 个中的 22 个"）以及后台任务指示器中。

#抓取什么，不抓取什么

• 抓取页面正文，不包含站点的导航、页眉与页脚；
• 文件夹在向导中勾选，之后可在连接器设置中调整（设置 → 站点文件夹）；
• 搜索、标签等功能性分区默认跳过；
• 每次抓取的页面数限制一次抓取的规模，用于防止超大站点；
• robots.txt 中禁止的页面不会抓取，其数量会显示在本次抓取的汇总里；
• 助手回答和文章标题区中有 在网站上打开 链接——指向原始页面。

#后续更新

启用 自动更新 后，我们会按计划重新读取站点。只有发生变化的页面才会重新索引——汇总中也是这样写的：“新增”“更新”“无变化”。未变化的页面不消耗索引额度。

删除在来源中消失的文档默认关闭：即使页面从站点上消失，文档仍保留在您的知识库中，并标记为「来源已消失」。若希望副本严格与站点一致，请开启。

接入后更改语言版本（设置 → 语言版本）会改变来源的组成。站点不再更新旧版本的文章，因此 LiKE 会询问如何处理它们：删除 或 保留为我的（将变为可编辑）。不作选择则设置不会保存。

#哪些站点可以接入，哪些不行

可以接入的是公开站点——带有站点地图（大多数文档生成器都是这样组织的），或在没有站点地图时沿链接抓取。其余情况我们在检查阶段就明确拒绝，而不是接入之后才发现：

即便站点已接入，个别页面仍可能被略过：robots.txt 中禁止的、返回错误的、超过 10 MB 的，或返回非 HTML 的页面。它们都会出现在本次抓取的汇总里并注明原因——“已跳过”“被 robots.txt 阻止”。

站点中的文件（PDF、ZIP、图片）不会被抓取。 它们有单独的路径——文件导入，并采用各自的解析方式。

#限制

• 每个组织一个站点；
• 站点必须是公开的——需要密码的页面无法读取；
• 站点地图并非必需：没有它时可用沿链接抓取，但它只能看到站点链接指向的页面；
• 我们遵守 robots.txt，包括其中指定的请求间隔。

断开连接。 同步随即停止，已导入的文档可以删除，也可以保留为普通文档——断开时 LiKE 会询问。

#接入之后：AI 搜索与网站上的小组件

1. 抓取完成后，站点页面与编辑器中撰写的文章同等参与 LiKE AI 搜索，回答会链接到原始页面——在网站上打开。
2. 如需直接在您的网站上搜索，请创建小组件：集成 → 渠道 → JS Widget → 管理小组件 → 创建小组件。在 放置小部件的网站地址 中填写该站点的地址。
3. 选择小组件类型：
   • 公开——仅搜索公开文章，对所有访问者开放。适用于客户；为此，请将站点页面保存为公开（第 3 步）。
   • 企业——搜索所选空间（包括内部文章），需要登录。适用于员工。
4. 添加搜索范围并启用小组件。公开 类型：选择 所有公开文章，或连接器存放页面的文件夹（集合）——公开小组件不能覆盖整个空间。企业 类型：选择空间或存放网站页面的文件夹。
5. 复制 嵌入代码 并粘贴到您的网站中。在 WordPress、Tilda、Wix、Webflow、Squarespace、Shopify、Framer、Google Tag Manager 和 Docusaurus 中应粘贴到哪里，请参阅 API 与小组件 中的 在网站构建器中粘贴代码的位置 一节。

#文件导入

#上传文件

1. 控制面板 → 导入
2. 拖入文件或点击上传区域
3. 支持的格式：PDF、DOCX、TXT、MD、RTF、ZIP
4. AI 会自动为每个文件生成标题和 slug
5. 发布前，您可以编辑标题或在编辑器中打开它

#ZIP 压缩包

上传一个包含大量文档的 ZIP 压缩包——LiKE 会自动解压并处理每个文件。适合迁移整个知识库。

ZIP 内支持的文件：PDF、DOCX、TXT、MD、RTF。其他文件（图片、可执行文件）会被跳过。

#按链接导入

粘贴一个文档链接——LiKE 会下载并导入它：

1. 控制面板 → 导入 → "按链接导入" 板块
2. 粘贴一个 URL → 点击 "添加"
3. 一次最多可添加 10 个链接
4. 点击 "导入"

支持的来源：

• Google Docs——自动导出为 DOCX
• Google Sheets——导出为 CSV
• Dropbox——直接文件链接
• 任何直接指向 PDF、DOCX、TXT、MD 或 RTF 文件的 URL

#默认可见性

对于每个来源，您可以配置默认可见性：

• 草稿——创建的文章为隐藏状态
• 团队——对已授权用户可见
• 公开——对所有人可见，包括匿名用户

在 集成 → 来源卡片 → 可见性 中配置。

#访问渠道

渠道让您的员工能够通过熟悉的工具搜索信息。

#Slack 机器人

功能：

• /like how do I set up SSO? → 直接在 Slack 中给出 AI 答案
• 在任意频道中提及 @LiKE → 在会话串中给出答案
• 指向来源文章的链接（可点击）

#Telegram 机器人

机器人依据您的知识库，直接在 Telegram 中回答团队的问题。

#第 1 步：在 Telegram 中创建机器人

机器人不在网站上创建，而是在 Telegram 内部，通过服务机器人 @BotFather 完成。请在 Telegram 中搜索 BotFather，并选择带蓝色对勾的那一个：同名账号很多，只有对勾才能证明是官方的。打开对话，点击开始，然后像发送普通消息一样发送：

/newbot

BotFather 会依次询问两项内容：

1. 显示名称 — 聊天参与者可以看到，可用任何语言并允许空格，例如 Lynkora 助手.
2. 地址 — 用于在搜索中找到机器人。只能使用拉丁字母、数字和下划线，且必须以 bot 结尾，例如 lynkora_help_bot.

随后您会收到令牌——形如 8123456789:AAEhBOwe… 的字符串，下一步需要用到。若机器人已存在而令牌丢失，请使用 /mytoken 命令。

#第 2 步：将机器人连接到 LiKE

打开集成 → Telegram，把令牌粘贴到 Bot Token 字段，点击连接。需要所有者或管理员权限。

若令牌被拒绝，请检查是否复制了完整字符串（包括冒号前的数字），且首尾没有空格。其他机器人的令牌无法使用。

连接成功后，卡片会显示机器人地址和已启用标记。

#第 3 步：选择答案来源

点击设置，指定机器人取用答案的空间，也可以细化到具体的合集。未做此设置时，无论问什么，机器人都会回答不知道。

同一界面还可决定只提供公开文章，还是也提供内部文章。内部文章要求提问者身份已确认——请看下一步。

#第 4 步：确定机器人的工作场景

私聊——与机器人一对一的对话。为了让机器人知道是谁在提问，需要把该聊天与账号绑定：在门户首页点击**「在聊天中提问」，然后选择「获取绑定码」**，并用一条消息把绑定码发送给机器人。绑定码为一次性，有效期 10 分钟。绑定后，机器人将按该用户的权限作答，包括内部文章。每位员工绑定各自的聊天。

群组——机器人对所有人作答，但仅使用公开文章：在共用聊天中无法判断提问者是谁。

要让它在群组中工作：

1. 关闭消息隐藏：向 BotFather 发送 /setprivacy，选择机器人，点击 Disable。Telegram 默认对机器人隐藏群组消息，因此机器人根本看不到问题。
2. 先把机器人移出群组，再重新加入。 否则该设置不会生效——Telegram 只在机器人加入时应用它。
3. 在集成设置中，把该群组聊天加入允许列表。

#第 5 步：验证

就知识库中确有的主题提问。答案会出现在同一聊天中，并附上来源文章的链接。

答案语言取决于提问语言——用德语提问就用德语作答。「服务消息语言」设置仅影响拒绝提示和绑定确认等服务消息。

#断开与删除

**从 LiKE 断开：**集成 → Telegram →「断开」。机器人停止作答，连接被移除；机器人本身仍留在 Telegram 中，可以再次连接。

**更换机器人：**请先断开当前的，再连接新的。顺序相反时，旧机器人仍指向 LiKE，会持续发送无人处理的消息。

**彻底删除机器人：**在 BotFather 中执行 /deletebot。此操作不可撤销——地址被释放，机器人无法找回。

#如果机器人不回复

#JS 小组件（用于您的网站）

一个可嵌入任意网站的浮动 AI 搜索按钮。最受欢迎的集成——用户在页面角落看到一个按钮，点击后会打开一个可与 AI 对话并在您的知识库中搜索的聊天窗口。

#简易安装

AI 回答额度用尽时。 公开小组件在页面上完全不显示——既没有按钮，也没有额度提示；快捷键也不起作用。额度恢复后，小组件会在下次加载页面时出现。

#基本参数

#Dual-auth：两种鉴权模式（ADR 0032）

在 LiKE 中，小组件可以以两种模式之一工作——在创建时选择：

有关配置每种模式以及与您后端集成的详细信息，请参阅 API 与小组件。

#Scope：小组件能找到什么

创建小组件时，您需要设定一个 scope——它到底搜索什么：

在单个小组件内，您可以组合多个 scope 条目（例如，来自同一空间的两个合集）。

#每个租户多小组件（ADR 0029 Stage 4）

在一个组织内，您可以创建多个独立的小组件，各自有不同的 scope 和模式：

每个都有自己的 api-key 和用量分析，且该密钥可独立吊销。管理位置在 集成 → 渠道 → JS Widget → "管理小组件"。

#会话管理（会话 JWT 模式）

在会话 JWT 模式下，每个用户会话都有唯一的 sessionId。管理员可以查看某个小组件的活动会话，并强制吊销某个令牌（例如，在怀疑被泄露时）。列表位于 集成 → 小组件 → [小组件] → 会话。

#iframe / 直接链接

在任意页面嵌入完整的 LiKE 搜索界面：

1. 集成 → iframe → 复制代码
2. 将 <iframe src="..."> 粘贴到您的页面
3. 或使用直接链接进行跳转（一个完整页面，而非嵌入）

iframe 和 Direct Link 也支持 dual-auth——在创建时选择。

#REST API

用于程序化集成的完整 API（例如，您自己的 UI 或与其他系统的集成）：

1. 集成 → Public API → "创建密钥"
2. 指定名称和允许的域名
3. 复制密钥——它仅显示一次，重新打开后会被遮蔽

在 X-API-Key 头中使用该密钥。通过密钥只返回公开文章。

主要端点：

**限制：**请求按每个密钥限流；超出后会返回带 Retry-After 头的 HTTP 429。

完整 API 文档：API 与小组件。

#语言

LiKE 支持 25+ 种语言用于 AI 搜索和跨语言搜索（界面本身提供 12 种 UI 语言）：

Русский、English、Deutsch、Français、Español、Português、Italiano、Nederlands、Polski、Čeština、Svenska、Dansk、Suomi、Română、Magyar、Hrvatski、Türkçe、Afrikaans、Kiswahili、Bahasa Indonesia、Tiếng Việt、Українська、Српски、Български、Ελληνικά、한국어、日本語、中文、हिन्दी、ไทย、עברית、العربية。

跨语言搜索：用一种语言提问 → 从另一种语言的文章中得到答案。