dsh-magpie-connect

使用

第一步：填网关地址和 Key

打开 设置 → Magpie 网关，确认两项：

• API 地址 — 网关地址，要带版本号。默认已填好 http://127.0.0.1:3425/v1，网关不在本机时改成实际地址。
• API Key — 网关凭据，必填。

点「保存」后，可以点「测试连接」确认通不通（会告诉你网关上有多少模型）。两项都齐了才会生效—— 地址有默认值，Key 没有，所以没填 Key 之前模型选择器是空的。

地址一定要带版本段（如 /v1）。插件只在你填的地址后面接资源名，不会自己补 版本号——所以网关以后升级到 /v2、/v3，你只要改这一个字符串。

第二步：选择要显示的模型

点 获取可用模型，会弹出网关当前的模型列表：勾选你想要的，再点「应用选择」。 弹窗里可以搜索、全选、取消全选。

主列表只显示已启用的模型。不想要的点该行末尾的「删除」，它就会从选择器里消失； 想加回来，再回到弹窗里勾选。

弹窗查的是你当前填的地址和 Key（哪怕还没保存），所以换网关是一趟的事。 连不上也不会卡住——失败原因会显示在列表下方，已列出的行仍然可以操作。

什么时候需要保存

• 地址和 Key：点「保存」才生效。
• 模型增删：自动保存，不用点任何按钮。

用配置文件代替设置页

除了设置页，也可以在 profile 的 cordis.patch.yml 里配置：

- id: dsh-magpie-connect
  name: 'dsh-magpie-connect'
  config:
    providerId: dsh-magpie-connect
    displayName: Magpie
    baseUrl: http://127.0.0.1:3425/v1   # 带版本号的完整地址
    apiKey: not-needed           # 网关通常不校验，但必须非空
    refreshSeconds: 300
    maxRetries: 2
    timeoutMs: 300000
    firstEventTimeoutMs: 90000
    idleTimeoutMs: 60000

配置项	默认值	说明
providerId	dsh-magpie-connect	注册到 DSH 的 provider 名称。
displayName	Magpie	模型选择器里的分组名。
baseUrl	http://127.0.0.1:3425/v1	带版本号的 API 地址。
apiKey	''（未配置）	网关凭据。必填，即使网关不校验——地址有默认值，Key 没有。
dataDir	~/.dsh-magpie-connect	状态目录（状态快照、设置文件、模型缓存）。
refreshSeconds	300	模型目录刷新间隔（秒）。
maxRetries	2	遇到 429/5xx 时的连接重试次数。
timeoutMs	300000	单次请求的总超时（毫秒）。
firstEventTimeoutMs	90000	等待首个上游事件的超时（毫秒）。
idleTimeoutMs	60000	上游事件之间的静默超时（毫秒）。

优先级：设置页 > cordis.patch.yml > 默认值。设置页只覆盖你保存过的字段。