一、各组件的更新方式
桌面客户端发布新版本时,CLI 与 Skills 通常需要同步升级才能完整使用新功能。每次更新日志的开头会以 💡 Tips 的形式提示是否需要同步升级。
二、桌面客户端发版通道
桌面客户端提供两条更新通道,你可以根据自己的偏好选择。正式版
- 默认通道,新装用户开箱即用的就是正式版
- 大约 1 到 2 周发布一次,将开发版中经过一段时间验证、表现稳定的功能合入
- 更新节奏相对稳健,适合追求稳定体验的日常使用
开发版(Beta)
- 每周发布一次到多次,包含最新的试验性功能
- 由于功能尚处于打磨阶段,可能存在一定的不稳定情况(例如偶发崩溃、UI 细节调整、数据格式微调等)
- 建议在能接受这些波动、并愿意反馈问题的前提下加入
三、自动更新如何工作
桌面客户端会在后台自动检查并下载更新,下载完成后由你决定什么时候重启安装。- 检查时机:应用启动后约 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 可用」时,可以直接点「更新」
Linkly AI CLI
CLI 在每次启动时会在后台静默检查新版本,发现更新会在终端给出提示。需要升级时执行:Linkly AI Skills
装了 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 各组件均采用 语义化版本(Semantic Versioning):- 正式版 形如
v1.1.0 - 开发版 形如
v1.2.0-beta.1、v1.2.0-beta.2… - 桌面客户端、CLI、Skills 各自独立维护版本号;通常我们会在客户端发版的同时,发布配套的 CLI / Skills 新版本

