httpdone/magpie-aws-quick
AI 工程把个人 AWS Quick 账号接入 magpie,供编程 Agent 调用其背后的模型。
项目介绍
magpie-aws-quick 是 magpie 的一个 OpenCode 提供方插件,把你自己登录的 Amazon Quick(AWS Quick)账号变成名为 aws-quick 的提供方。经由 magpie 路由的 Claude Code、Codex、Gemini CLI、OpenCode 等 Agent 就能调用 Quick 背后的模型,可用 magpie models | grep aws-quick 查看暴露的模型。
它不抓包、不架代理、不改应用文件,而是复用 Quick 桌面应用自带的 Python 后端(quickwork-agent):以 --outpost-only 在本地启动,读取桌面应用保存的登录态,再接入应用内的双向 WebSocket 聊天协议。OpenAI 风格的 messages 会被翻译成 Quick 的轮次,流式文本、推理内容和用量再映射回 OpenAI 字段。
线程复用是它的重点功能:先用增量哈希链精确匹配续接,失败后退到模糊锚点,最后用网关会话键兜底,从而利用 Quick 服务端保存的历史,而不必每次重发完整对话。线程按账号、agent 模式、思考强度、系统提示和工具名隔离,缓存只存哈希和 thread id。
快速使用
先准备 magpie 并选择一种登录方式:
- 浏览器 OAuth:不需要桌面应用。执行
magpie login aws-quick时选择浏览器账号登录,流程会打开quick.aws.com/sn,令牌保存在插件自己的配置目录。 - 本地凭据:安装并登录 Amazon Quick 桌面应用。Windows 上插件直接从凭据管理器读取会话;其他平台或读取失败时会启动随应用打包的 outpost。桌面应用不需要一直开着,但必须登录过一次。
然后安装并登录:
magpie plugin add magpie-aws-quick
magpie login aws-quick
也可以直接在 magpie 的 Plugins 界面搜索 "Amazon Quick" 安装。登录后,账号卡片和 Usage 页面会显示套餐额度、已用 agent 小时数和试用到期时间。
不在 magpie 里使用时,node bin/serve.mjs 会把同一个适配器以 OpenAI 兼容接口暴露在默认的 127.0.0.1:3426/v1,并可用 magpie provider add --base-url http://127.0.0.1:3426/v1 注册;建议设置 PROXY_TOKEN 做鉴权。
使用约束
- 仅限个人账号使用。 插件驱动的是桌面客户端内部 WebSocket 协议,而非公开 API,README 明确提示这很可能违反 AWS 服务条款,账号可能被限制或封禁。
- OAuth 只支持消费者/社交登录。 企业 IdP 租户可能走不通浏览器流程,需要在装有应用的机器上改用本地凭据方式。
- 工具调用是文本约定模拟。 Quick 自己的工具在服务端执行,不会映射成 OpenAI 的
tool_calls;客户端工具以<tool_call>文本约定注入,效果取决于模型是否遵守该约定。 - 采样参数被忽略。
temperature等字段在协议中不存在。 - 图片与大小限制。 较小的内联图片作为附件发送;较大的图片(单张最多 3 MiB、每轮 4 张、合计 5 MiB)走 Quick 自身上传流程并落到账号的云端会话工作区。远程 URL 和非图片文件不支持。整个
user_message帧在服务端硬限制 64 KB,超长的提示词、schema 和历史会被自动压缩。 - 线程与账号绑定且同线程串行。 同一线程上的并发请求会被拒绝,不同线程可以并行。
- Node ≥ 22 仅用于跑测试。 插件本身是纯 ESM、无第三方依赖。许可证为 MIT,项目与 Amazon/AWS 无隶属关系。
HotRepo 点评
仓库在 2026-11-22 出现在 HotRepo 的 JavaScript 新项目榜中,统计窗口内新增 106 Star 和 18 Fork,但没有记录到 GitHub 全语言日榜名次。这只是单次快照,能说明项目早期获得了关注,不能说明已被广泛采用。它的设计相当具体:复用桌面应用自带的 agent 并建模其聊天协议,还附有协议文档,因此更像是给已有 Quick 账号的 magpie 用户准备的定向适配器,而不是通用模型网关。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。