> ## 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 的发版节奏、更新通道与升级方式

Linkly AI 由多个相互配合的组件组成：桌面客户端、CLI 和 Skills。
为了在保持稳定性的同时让新功能尽快触达用户，我们采用了不同的更新机制。本页说明你应该期待怎样的发版节奏，以及在不同场景下需要做什么。

## 一、各组件的更新方式

| 组件                   | 更新方式 | 是否需要用户操作    |
| -------------------- | ---- | ----------- |
| **桌面客户端**            | 自动更新 | 否（重启应用即可生效） |
| **Linkly AI CLI**    | 手动更新 | 是（命令行执行）    |
| **Linkly AI Skills** | 手动更新 | 是（重新运行安装命令） |

<Note>
  桌面客户端发布新版本时，**CLI 与 Skills
  通常需要同步升级**才能完整使用新功能。每次更新日志的开头会以 💡 Tips
  的形式提示是否需要同步升级。
</Note>

<Tip>
  CLI 和 Skills 的手动更新并不必须由你亲自完成——你可以**直接让接入的 AI Agent 或
  OpenClaw 帮你执行升级命令**，例如对 Claude、Cursor、OpenClaw 等说一句「帮我把
  Linkly AI CLI 和 Skills 升级到最新版本」即可。
</Tip>

## 二、桌面客户端发版通道

桌面客户端提供两条更新通道，你可以根据自己的偏好选择。

| 通道               | 发版频率   | 稳定性           | 适合人群                   |
| ---------------- | ------ | ------------- | ---------------------- |
| **正式版 (Stable)** | 每周一次   | 高，经过开发版充分验证   | 绝大部分用户                 |
| **开发版 (Beta)**   | 每周一到多次 | 包含试验性功能，可能不稳定 | 喜欢尝鲜、动手能力较强、能接受偶发问题的用户 |

### 正式版

* 默认通道，新装用户开箱即用的就是正式版
* 通常每周发布一次，将开发版中经过一段时间验证、表现稳定的功能合入
* 更新节奏相对稳健，适合追求稳定体验的日常使用

### 开发版（Beta）

* 每周发布一次到多次，包含最新的试验性功能
* 由于功能尚处于打磨阶段，**可能存在一定的不稳定情况**（例如偶发崩溃、UI 细节调整、数据格式微调等）
* 建议在能接受这些波动、并愿意反馈问题的前提下加入

<Tip>
  开发版中遇到的问题，欢迎在 [GitHub
  Issues](https://github.com/LinklyAI/linkly-ai-skills/issues)
  或社区反馈，这些反馈会直接影响下一个正式版的质量。
</Tip>

## 三、自动更新如何工作

桌面客户端会在后台自动检查并下载更新，你无需手动干预。

* **检查时机**：应用启动后约 3 秒进行第一次检查，之后每 4 小时再检查一次
* **下载行为**：发现新版本时会自动在后台下载
* **生效时机**：下载完成后，**下一次重启应用时**自动安装并启用新版本
* **手动检查**：你也可以随时进入 **设置 → 关于**，点击「检查更新」按钮立即触发一次检查

## 四、加入开发版

<Steps>
  <Step title="打开桌面客户端">启动 Linkly AI 桌面应用。</Step>

  <Step title="进入设置页">
    点击托盘图标或客户端右上角的菜单，进入 **设置 → 关于**。
  </Step>

  <Step title="开启 加入开发版体验计划">打开「加入开发版体验计划」开关。</Step>

  <Step title="获取最新开发版">
    等待自动检查（最长 4
    小时），或者点击「检查更新」立即获取最新开发版。下载完成后重启即可。
  </Step>
</Steps>

### 退出开发版

只需在 **设置 → 关于** 中关闭「加入开发版体验计划」开关，后续将只接收正式版更新。

<Note>
  关闭开关并不会回滚你当前已安装的开发版。下一个正式版发布时会自动覆盖升级到正式版。
</Note>

## 五、CLI 与 Skills 的手动更新

### Linkly AI CLI

CLI 在每次启动时会在后台静默检查新版本，发现更新会在终端给出提示。需要升级时执行：

```bash theme={null}
linkly self-update
```

详细安装与使用请参考 [Linkly AI CLI](./use-cli)。

### Linkly AI Skills

Skills 没有内置的升级命令，根据你的安装方式选择对应的更新方式：

* **通过 `skills add` 安装**：重新运行安装命令即可覆盖更新
  ```bash theme={null}
  npx skills add LinklyAI/linkly-ai-skills
  ```
* **通过 `git clone` 安装**（Claude Code、Codex CLI 等）：进入 skill 目录执行
  ```bash theme={null}
  git pull
  ```
* **通过 Claude.ai 上传**：从 [GitHub Releases](https://github.com/LinklyAI/linkly-ai-skills/releases) 重新下载 `linkly-ai.zip`，在 Settings → Capabilities → Skills 中上传覆盖
* **通过 ClawHub**：执行
  ```bash theme={null}
  clawhub install linkly-ai
  ```

详细安装与使用请参考 [Linkly AI Skills](./use-skills)。

## 六、版本号约定

Linkly AI 各组件均采用 [语义化版本](https://semver.org/lang/zh-CN/)（Semantic Versioning）：

* **正式版** 形如 `v0.4.1`
* **开发版** 形如 `v0.4.2-beta.1`、`v0.4.2-beta.2` …
* 桌面客户端、CLI、Skills 各自独立维护版本号；通常我们会在客户端发版的同时，发布配套的 CLI / Skills 新版本

历史版本与每个版本的具体变更，请见 [更新日志](./changelog)。