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

​
一、各组件的更新方式

桌面客户端发布新版本时，CLI 与 Skills 通常需要同步升级才能完整使用新功能。每次更新日志的开头会以 💡 Tips 的形式提示是否需要同步升级。
CLI 和 Skills 的手动更新并不必须由你亲自完成——你可以直接让接入的 AI Agent 或 OpenClaw 帮你执行升级命令，例如对 Claude、Cursor、OpenClaw 等说一句「帮我把 Linkly AI CLI 和 Skills 升级到最新版本」即可。

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

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

​
正式版

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

​
开发版（Beta）

  • 每周发布一次到多次，包含最新的试验性功能
  • 由于功能尚处于打磨阶段，可能存在一定的不稳定情况（例如偶发崩溃、UI 细节调整、数据格式微调等）
  • 建议在能接受这些波动、并愿意反馈问题的前提下加入
开发版中遇到的问题，欢迎在 GitHub Issues 或社区反馈，这些反馈会直接影响下一个正式版的质量。

​
三、自动更新如何工作

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

​
四、加入开发版

1

打开桌面客户端

启动 Linkly AI 桌面应用。
2

进入设置页

点击托盘图标或客户端右上角的菜单，进入 设置 → 关于。
3

开启 加入开发版体验计划

打开「加入开发版体验计划」开关。
4

获取最新开发版

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

​
退出开发版

只需在 设置 → 关于 中关闭「加入开发版体验计划」开关，后续将只接收正式版更新。
关闭开关并不会回滚你当前已安装的开发版。下一个正式版发布时会自动覆盖升级到正式版。

​
五、CLI 与 Skills 的手动更新

​
Linkly AI CLI

CLI 在每次启动时会在后台静默检查新版本，发现更新会在终端给出提示。需要升级时执行：
详细安装与使用请参考 Linkly AI CLI。

​
Linkly AI Skills

Skills 没有内置的升级命令，根据你的安装方式选择对应的更新方式：
  • 通过 skills add 安装：重新运行安装命令即可覆盖更新
  • 通过 git clone 安装（Claude Code、Codex CLI 等）：进入 skill 目录执行
  • 通过 Claude.ai 上传：从 GitHub Releases 重新下载 linkly-ai.zip，在 Settings → Capabilities → Skills 中上传覆盖
  • 通过 ClawHub：执行
详细安装与使用请参考 Linkly AI Skills。

​
六、版本号约定

Linkly AI 各组件均采用 语义化版本（Semantic Versioning）：
  • 正式版 形如 v0.4.1
  • 开发版 形如 v0.4.2-beta.1、v0.4.2-beta.2 …
  • 桌面客户端、CLI、Skills 各自独立维护版本号；通常我们会在客户端发版的同时，发布配套的 CLI / Skills 新版本
历史版本与每个版本的具体变更，请见 更新日志。