> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Linkly AI 账号

> 账号只用来连接官方云端服务。本地索引、本地检索和 MCP 服务不需要登录也不需要联网——本文说清楚哪些能力免费、哪些要登录、哪些要 Pro。

## 账号是什么

Linkly AI 是一款**本地优先**的应用：你的文档、索引和检索全部发生在自己的电脑上。账号不参与这些事，它只做一件事——**把你和 Linkly AI 的官方云端服务连接起来**。

具体来说，账号是这三类云端能力的凭证：

<CardGroup cols={3}>
  <Card title="官方 AI 模型" icon="sparkles" iconType="duotone">
    不用自己申请任何模型服务商的密钥，登录即可在 Chatbot 里用
  </Card>

  <Card title="云端知识库" icon="cloud" iconType="duotone">
    把本地库推到云端 24 小时在线，也能连接别人分享的库
  </Card>

  <Card title="远程访问" icon="tower-broadcast" iconType="duotone">
    让 ChatGPT、Claude.ai 等在线 AI 穿透回你的本机读文档
  </Card>
</CardGroup>

除此之外的一切，都不需要账号。

***

## 不登录也能用什么

这是产品的底线，也写在应用内 **设置 → 数据隐私 → 我们不会做的事** 里：

> **不做强制账号登录，客户端能力不依赖云端服务。**

完全不需要账号、也不需要联网的能力：

| 能力                | 说明                                                  |
| ----------------- | --------------------------------------------------- |
| **文档索引**          | 扫描、监听、解析 PDF / 图片 / Office / Markdown，全在本机          |
| **本地检索**          | 全文（BM25）搜索、语义（向量）搜索、大纲索引，模型跑在本机                     |
| **启动器**           | 全局快捷键唤起的搜索弹窗，见[启动器](/docs/zh/use-launcher)               |
| **本地知识库**         | 创建、管理、按库检索，见[使用知识库](/docs/zh/use-libraries)              |
| **本地 MCP 服务**     | `127.0.0.1` 上的 MCP Server，本机回环访问无条件放行               |
| **CLI 本地模式**      | `linkly search` / `read` 等命令，见[使用 CLI](/docs/zh/use-cli) |
| **Chatbot（自带模型）** | 配置了第三方或本地模型时照常对话，见[Chatbot](/docs/zh/use-chatbot)        |
| **笔记**            | 见[使用笔记](/docs/zh/use-notes)                              |

也就是说：**装完不登录，Linkly AI 依然是一个完整可用的本地知识引擎**——索引你的文件、被 Claude Code / Cursor / Codex 等本地 AI 工具通过 MCP 检索，全程不联网、不上传任何内容。

<Note>首次启动的引导里，登录那一屏底部有一行小字「**如需在离线使用可 跳过登录，需自行完成 AI 模型等设置，谨慎选择**」——点「跳过登录」即可直接进入应用。跳过之后随时可以在 **设置 → 账户** 里补登录。</Note>

唯一需要你自己补的是**对话模型**：不登录就没有官方模型，需要在 **设置 → AI** 里填一个第三方服务商的 API Key，或接一个本地模型。

***

## 登录后解锁什么

<AccordionGroup>
  <Accordion title="官方 AI 模型" icon="sparkles">
    登录后 **设置 → AI** 里的「Linkly Official」会自动点亮，模型列表由服务端下发，**不需要你填任何密钥**。免费账户可以使用官方精选的基础模型（性价比更高的 Flash 级），Pro 额外解锁前沿模型。详见 [Chatbot 与官方模型](/docs/zh/use-chatbot)。
  </Accordion>

  <Accordion title="云端知识库" icon="cloud">
    在网页上创建云端库、用桌面应用推送本地内容、连接别人分享的库、把自己的库邀请或公开分享出去。完整流程见[使用云端知识库](/docs/zh/use-cloud-library)。
  </Accordion>

  <Accordion title="远程访问（MCP 隧道）" icon="tower-broadcast">
    在本机和 `mcp.linkly.ai` 之间建一条隧道，让 ChatGPT、Claude.ai 这类跑在云端的 AI 应用读到你电脑上的文档。**需要 Pro 订阅**，配置见[远程访问](/docs/zh/use-in-remote)。
  </Accordion>

  <Accordion title="API 密钥与网页控制台" icon="key">
    登录后才能在 [控制台](https://linkly.ai/dashboard) 里管理 API 密钥、查看用量和配额。详见下方 [API 密钥](#api-密钥)。
  </Accordion>
</AccordionGroup>

### 网页控制台有哪些页面

| 页面                                              | 你在这里做什么                                             |
| ----------------------------------------------- | --------------------------------------------------- |
| [首页](https://linkly.ai/dashboard)               | 看当前套餐、近 30 天 MCP 调用量曲线、官方模型配额（5 小时 / 7 天 / 30 天三个环） |
| [知识库](https://linkly.ai/dashboard/libraries)    | 我创建的 / 已连接 / 分享给我 / 已收藏的云端库；连接与断开；查看连接位余量           |
| [集成](https://linkly.ai/dashboard/integrations)  | 云端 MCP 端点、**API 密钥管理**、客户端下载、各 AI 工具接入指引            |
| [邀请管理](https://linkly.ai/dashboard/invitations) | 处理收到的知识库邀请（待处理 / 已接受 / 已拒绝 / 已撤销）                   |
| [新建云端知识库](https://linkly.ai/libraries/new)      | 建云端库的「壳」，填标题、Slug、描述、分类、可见性                         |

右上角头像菜单里还有：编辑资料、邀请管理、**我的订阅**（Pro）或**升级到 Pro**、帮助中心、退出登录。

***

## 怎么登录

### 网页端

前往 [linkly.ai](https://linkly.ai) 点击登录，四种方式任选，**都不需要设置密码**：

* **Google** 账号授权
* **GitHub** 账号授权
* **Notion** 账号授权
* **邮箱验证码**：填邮箱，收一封一次性验证码邮件

第一次登录即注册，不需要单独的注册流程。

### 桌面端

桌面端**主推浏览器授权**，不需要你手动搬运密钥：

<Steps>
  <Step title="打开账户设置">**设置 → 账户**，点击「**登录**」按钮。</Step>
  <Step title="在浏览器里完成授权">系统默认浏览器会打开 Linkly AI 的授权页（OAuth 2.1 + PKCE，只申请 `openid email` 两个权限）。应用这时显示「等待浏览器授权…」，也可以随时点「取消」。</Step>
  <Step title="自动回到应用">授权完成后浏览器会把应用重新唤到前台，账户卡片显示你的邮箱和「**已连接至 Linkly AI Cloud**」。同时应用会在后台拉取官方模型列表——回到 Chatbot 就能直接选模型了。</Step>
</Steps>

<Tip>**没有浏览器、或者在服务器/远程环境里？** 账户页底部有一个折叠区「**可选：通过手动设置 API Key 完成账户连接**」，把控制台里的 `lkai_` 密钥粘进去即可，效果与 OAuth 登录等价。</Tip>

首次启动的引导流程里也有登录这一步（第 1/2 步），走的是同一条 OAuth 链路。

### 浏览器扩展

扩展**不强制登录**：打开侧边栏就能提取网页、转 Markdown、预览和导出，登录只是工具栏上一个可选动作。

***

## 设置用户名

云端知识库的地址形如 `linkly.ai/<username>/<slug>`，所以账号需要一个全局唯一的用户名。

* **什么时候要设**：第一次进入网页控制台时会弹出一个不可跳过的「完善你的资料」弹窗，要求填**显示名称**和**用户名**；直接去建云端库也会先要求补上。
* **在哪里设**：控制台右上角头像 → **编辑资料**。同一个弹窗还能改头像和显示名称（邮箱只读）。
* **格式限制**：6–39 个字符，只能用**小写字母、数字和连字符**，首尾必须是字母或数字，**不能连续使用连字符**，也不能占用平台保留字。

<Warning>\*\*用户名一旦设定就无法修改。\*\*它会出现在你所有云端知识库的公开地址里，请一次想好。显示名称和头像则可以随时改。</Warning>

***

## 免费与 Pro

Linkly AI 的分界线很清晰：**本地能力全部免费，Pro 买的是云端增强**。

|                         | 免费            | Pro                         |
| ----------------------- | ------------- | --------------------------- |
| 全部本地功能、离线使用             | ✅             | ✅                           |
| 文档解析、全文/语义搜索、大纲         | ✅             | ✅                           |
| MCP 与 CLI、接入主流 AI Agent | ✅             | ✅                           |
| 浏览器扩展                   | ✅             | ✅                           |
| **官方 AI 模型档位**          | 基础模型          | 基础 + 前沿模型                   |
| **官方模型额度**              | 有限            | 显著更高                        |
| **云端知识库**               | ✅ 可创建、可连接、可检索 | ✅ 数量与容量上限更高                 |
| **云端库可见性**              | 仅 Private     | Public / Showcase / Private |
| **远程访问（MCP 隧道）**        | ❌             | ✅                           |
| 云端高精度解析与索引优化            | ❌             | 即将推出                        |
| 云端音视频转录                 | ❌             | 即将推出                        |

<Note>**具体的额度数字**——模型额度的三个时间窗上限、可创建/可连接的云端知识库数量、每个库的文档上限——**以[官网](https://linkly.ai/pricing)和应用内配额面板为准。** 这些数字会随产品调整而变化，写死在文档里只会误导。</Note>

几条容易搞混的：

* **云端知识库检索对免费账户开放**，只是配额小。真正的 Pro 独占是**远程访问（隧道）**——那条路径下免费账户会直接收到升级提示。
* **邀请他人使用自己的库不需要 Pro**。免费账户创建的库虽然只能是 Private，但依然可以在库设置页 → 分享管理里按邮箱邀请阅读者。只有想**公开发布**（Public / Showcase）才需要 Pro。
* **别人分享给你的库不占用你的创建配额**，只占一个「连接位」。
* 官方模型的额度是一个**共享额度池**，不同模型消耗倍率不同，三个时间窗口任一打满都会限流。实时余量在应用内点左侧栏底部的**配额按钮**查看，或看控制台首页。详见 [Chatbot](/docs/zh/use-chatbot)。

<Note>超出配额不会影响已有内容——已建的库、已推送的文档都还在，只是不能再新建。额度按窗口自动刷新，不用申请。</Note>

### 订阅与取消

* **升级**：到[官网](https://linkly.ai/pricing)点「立即订阅」，走 Stripe 结账。中文界面额外提供「**一次性付款（支持支付宝 / 微信）**」——有效期 1 年、不自动续费、到期可再买。
* **取消**：控制台右上角头像 → 「**我的订阅**」进入 Stripe 管理页取消。取消后权益在当前计费周期结束前仍然有效。
* 支持 **7 天无理由全额退款**。

***

## API 密钥

API 密钥是账号在**命令行和第三方工具**里的替身，格式为 `lkai_` + 32 位十六进制字符（共 37 位）。

**在哪里拿**：控制台 → [集成](https://linkly.ai/dashboard/integrations) → 「API 密钥」区，点「新建密钥」。名称可留空。

**用来做什么**：

| 场景        | 怎么用                                                                  |
| --------- | -------------------------------------------------------------------- |
| 云端 MCP 网关 | 请求头 `Authorization: Bearer lkai_...`，见[云端知识库](/docs/zh/use-cloud-library) |
| 远程访问隧道    | 桌面端 **设置 → MCP → 远程访问** 里使用，见[远程访问](/docs/zh/use-in-remote)               |
| CLI 远程模式  | `linkly auth set-key lkai_...`，见[使用 CLI](/docs/zh/use-cli)                |
| 官方 AI 模型  | 桌面端 OAuth 登录后自动获取并写入，通常不用手动碰                                         |

关于密钥的几个事实：

* **一个账号一把就够**。桌面端登录时会自动为你创建（或复用）密钥；网页控制台在已有一把时会禁用「新建密钥」按钮。
* **不是只显示一次**。密钥在列表里默认打码，点眼睛图标可随时查看明文、点复制图标可随时复制。
* **默认永不过期**，除非你主动撤销。
* **可以撤销**：点垃圾桶图标二次确认即可，撤销后该密钥立即失效，重新创建一把即可。

<Warning>API 密钥等同于你的账号凭证——它能访问你的云端知识库，开了隧道时还能读到你**本机**的文档。不要写进公开仓库、聊天记录或截图。怀疑泄露就立刻去控制台撤销并新建。</Warning>

***

## 账号与安全

* **退出登录（桌面端）**：**设置 → 账户 → 退出登录**，会二次确认。它**只清除本机保存的凭证**——本地索引、本地知识库、聊天记录、以及已经推送到云端的内容都不受影响。
* **退出登录不等于吊销密钥**：服务端的 API 密钥依然有效。要彻底作废（比如电脑丢了、密钥外泄），必须去控制台把密钥撤销掉。
* **凭证存在哪**：桌面端存在应用数据目录的 `config.json` 里；CLI 存在 `~/.linkly/credentials.json`。两者都是本机文件，应用日志里的密钥会自动脱敏。
* **删除账号**：目前还没有自助入口，需要通过[官网支持页面](https://linkly.ai/support)联系我们处理。

***

## 常见问题

<AccordionGroup>
  <Accordion title="不登录会少掉什么？值得为它注册吗？">
    少掉三样：官方 AI 模型、云端知识库、远程访问。本地索引、本地检索、本地 MCP 服务一样不少。
    如果你已经有自己的模型 API Key，并且只在本机的 AI 工具（Claude Code、Cursor 等）里用 Linkly AI，那**完全可以不注册**。
  </Accordion>

  <Accordion title="登录之后，我的文件会被上传吗？">不会。索引和检索始终在本机进行。只有你**主动**把某个知识库推送到云端时，那个库的内容才会上传； 开启远程访问时，隧道也只转发请求和响应、不存储文档。详见[常见问题](/docs/zh/faq)里的隐私章节。</Accordion>

  <Accordion title="一个账号可以在几台电脑上用？">没有设备数限制。每台电脑各自走一次 OAuth 登录即可，它们共用同一把 API 密钥。 但注意云端知识库的**连接位**是按账号算的（免费 1 个 / Pro 99 个），不是按设备算。</Accordion>

  <Accordion title="用户名能改吗？填错了怎么办？">暂时不能改——它是云端库公开地址的一部分。填错了请通过官网支持页面联系我们。显示名称和头像不受此限制，随时可改。</Accordion>

  <Accordion title="桌面端提示「需要设置」或「请先登录账户」是什么意思？">说明这台电脑上还没有保存云端凭证。去 **设置 → 账户** 点「登录」走一次浏览器授权即可。 如果已经登录却仍然提示，多半是密钥被撤销或失效了——账户卡片会显示「登录无效或密钥已过期」，重新登录一次覆盖旧密钥即可。</Accordion>

  <Accordion title="退出登录后，我推到云端的知识库还在吗？">还在。退出登录只删本机凭证，云端内容完全不受影响，重新登录后照常可见。 要删除云端那一份，需要在网页的库设置页 → 危险区里明确删除。</Accordion>

  <Accordion title="免费额度用完了怎么办？">
    额度按对应时间窗口自动刷新，不用手动申请，到点就恢复。
    如果经常不够用，可以在 **设置 → AI** 里额外配置一个第三方模型服务商——第三方和本地模型不占用 Linkly AI 的额度。
  </Accordion>
</AccordionGroup>

***

## 延伸阅读

* [快速开始](/docs/zh/quickstart) —— 安装、首次启动与基本使用
* [使用云端知识库](/docs/zh/use-cloud-library) —— 创建、推送、连接与分享
* [远程访问](/docs/zh/use-in-remote) —— Pro 独占的 MCP 隧道
* [Chatbot](/docs/zh/use-chatbot) —— 官方模型、额度池与模型配置
* [常见问题](/docs/zh/faq) —— 隐私承诺与数据流向
* [模型服务](/docs/zh/model-service) —— 官方模型服务的完整说明与额度机制
* [浏览器扩展](/docs/zh/use-extension) —— 无需登录即可使用的能力