1先安装应用Magpie 官方版
选择你正在用的系统
前往官方站点，选择适合电脑架构的 Windows 版本，按官方说明安装并启动。
常见电脑选择 x64；Windows ARM 设备选择 ARM64。
选择 Apple 芯片或 Intel 对应的官方 DMG，打开后将 Magpie 拖入“应用程序”。
可在苹果菜单 → 关于本机，查看电脑的芯片类型。
打开官方站点，不提供旧版整合安装包。
官方应用 · 独立插件
熟悉的 Magpie，
接上你的核心。
用官方 Magpie 管理模型与连接，用 KupaDesk 管理核心与绑定。先装应用，再接入插件，在插件内完成卡密激活。
Windows · macOS ／ 插件安装无需 GitHub 账号
你的工作台各自维护，一起使用
官方应用
官方安装包magpie
供应商 · 模型 · Agent
独立扩展
单独更新KupaDesk
核心库 · 模型绑定 · 适用范围
卡密在插件内输入，授权与当前设备关联。
01
程序，从官方获取始终使用 Magpie 官方发行版
02
插件，独立接入复制安装源，在 Magpie 中安装
03
授权，在插件完成网页不要求输入或提交卡密
安装指南
两步接入，
准备开始。
已经安装官方 Magpie？
直接从第二步添加 KupaDesk。
2再添加插件KupaDesk
复制这一条安装地址
进入 Magpie「插件 → 发现」，在页面底部的手动安装输入框粘贴地址，然后点击「安装」。
KupaDesk 安装源
github:kupakupar/kupadesk-plugin也可以选中上方地址手动复制。
安装完成后，在「已安装」确认 KupaDesk 已启用，再打开它的页面。
还需要接好模型。在 Magpie 添加供应商、启用模型，并让所用 Agent 接入 Magpie；KupaDesk 才能对经过这里的匹配请求应用核心。
卡密激活
回到插件，
完成最后一步。
卡密在 KupaDesk 的授权窗口输入。这个网页只提供指引，不会收集卡密，也不会代你激活设备。
本机核心与云端核心，都需要有效授权。
- 01
打开 KupaDesk 的授权页面
首次打开可能直接进入激活界面；在编辑页中，可点击右上角「云端」进入。
- 02
输入卡密，点击「激活并启用」
等待授权和必需核心准备完成。授权有效、核心就绪后，会自动回到编辑页。
- 03
选择核心，绑定模型，再保存
选择本机或云端核心，绑定目标模型，按需限制适用 Agent。启用核心注入并保存设置。
- 04
发一次请求，看看诊断
回到 Agent 发起请求，在 KupaDesk 的「诊断」查看是否命中绑定，以及本次注入结果。
已有用户
应用与插件，
分别更新。
不用为了更新重新安装一套程序。
先看需要更新的是哪一部分。
更新什么从哪里操作完成后
02KupaDesk 插件
插件 → 已安装 → 检查更新
在 KupaDesk 这一行单独点击「更新」。
在 KupaDesk 这一行单独点击「更新」。
打开 KupaDesk，等待准备完成，再使用「刷新页面」查看新界面。
03插件内的运行核心
通常由插件自动准备。若提示尚未就绪，进入「云端」→「准备／更新核心」。
以插件页面显示的运行版本和就绪状态为准，入口更新完成不代表准备已结束。
常见问题
把几个疑问，
提前说清。
安装遇到问题时，先核对自己停在哪一步。
当前支持哪些系统？
KupaDesk 当前提供 Windows 和 macOS 的设备授权接入。Magpie 官方也提供 Linux 版本，但这不等于当前 KupaDesk 已支持 Linux 激活。
现在还需要下载 KupaDesk 整合包吗？
不需要。现在采用官方 Magpie 加独立 KupaDesk 插件的方式。Magpie 从官方站点获取，插件通过上面的 GitHub 安装地址接入。
安装插件需要 GitHub 账号吗？
不需要。把安装地址粘贴到 Magpie 的插件安装入口即可。安装成功和使用授权是两件事，使用核心注入仍需要有效卡密。
卡密可以在这个网页输入吗？
不可以，也不需要。请在已安装的 KupaDesk 插件中打开授权窗口输入；这个网页不提供激活表单。
本机核心也需要激活吗？
需要。当前版本的本机核心与云端核心都受授权状态控制，未激活、授权失效或卡密停用时，核心注入会停用。
换电脑后，为什么还需要激活？
设置同步和设备授权是两件事。另一台电脑需要完成自己的设备授权；如果提示卡密已绑定其他设备，请联系卡密提供方确认授权范围或处理换绑。
已经激活，为什么某次请求没有注入？
确认请求经过 Magpie、核心和总注入开关已启用、目标模型已绑定、Agent 在适用范围内，并已保存设置。再看「诊断」中的匹配与注入结果；模型是否遵循核心还需结合实际回复判断。
显示“未授权”时，应该重新安装吗？
先到「云端」恢复已有授权，并查看具体提示。网络问题、卡密过期、停用或设备绑定问题需要分别处理；重新安装并不能替代授权恢复。
准备好就开始