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

一、各组件的更新方式

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

二、桌面客户端发版通道

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

正式版

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

开发版(Beta)

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

三、自动更新如何工作

桌面客户端会在后台自动检查并下载更新,下载完成后由你决定什么时候重启安装。
  • 检查时机:应用启动后约 3 秒进行第一次检查,之后每 4 小时再检查一次
  • 下载行为:发现新版本时会自动在后台下载
  • 安装时机:下载完成后,主窗口左侧栏底部会出现更新按钮,点它再点「立即重启」,即可安装并启用新版本。也可以在 设置 → 关于 点「重启以更新」,或在托盘菜单点「更新到 vX.Y.Z」。直接退出应用不会安装更新,下次启动后仍要通过这几个入口重启安装
  • 手动检查:你也可以随时进入 设置 → 关于,点击「检查更新」按钮立即触发一次检查

四、加入开发版

1

打开桌面客户端

启动 Linkly AI 桌面应用。
2

进入设置页

右键托盘图标,在菜单里点「关于」;或者点主窗口左下角的账号图标,在菜单里点「设置」,再切到「关于」页。
3

开启 加入开发版体验计划

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

获取最新开发版

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

退出开发版

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

五、CLI 与 Skills 的更新

由桌面端自动更新

点主窗口左侧栏底部的 Agent 图标进入「Agent 使用」页,在「高级」区打开「自动更新 CLI 与 Skills」。打开后,桌面端启动约 5 分钟后检查一次,之后每天检查一次,有新版本就在后台更新。首次启动引导的「接入 Agent」一屏里也有这个开关,默认打开。
  • 只更新已经装好的 CLI 和 Skills,不会替你新装
  • CLI 只更新装在 ~/.linkly/bin 里的那一份(桌面端装的就在这里)。用 Homebrew、cargo 等方式装的 CLI,需要你用对应的工具自己更新
  • 不想等自动检查:同一区域里 CLI 或 Skills 那一行显示「vX.Y.Z 可用」时,可以直接点「更新」
没开自动更新,或者 CLI 是用其他方式装的,按下面的方式手动更新。

Linkly AI CLI

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

Linkly AI Skills

装了 CLI 的话,可以直接用它检查和升级:
有新版本时,CLI 的输出末尾会带一行提示,仅作告知,可以忽略。设 LINKLY_NO_SKILLS_HINT=1 可以关掉它。update 会按每个位置的安装形态区别处理——git 检出的目录只会给出提示,不会被覆盖。 否则根据你的安装方式选择对应的更新方式:
  • 通过 skills add 安装:重新运行安装命令即可覆盖更新
  • 通过 git clone 安装(Claude Code、Codex CLI 等):进入 skill 目录执行
  • 通过 Claude.ai 上传:从 GitHub Releases 重新下载 linkly-skills-latest.zip,在 Settings → Capabilities → Skills 中上传覆盖
  • 通过 ClawHub:执行
详细安装与使用请参考 Linkly AI Skills。

六、版本号约定

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