dsh-workbuddy2api-panel

LIMITATIONS

已知限制

- 插件路由不在宿主鉴权之后，写接口靠「回环 + 同源 + JSON」三道闸兜底（见上一节）； 只读接口对本机开放，不返回任何密钥。 - provider 键固定是 `workbuddy2api`，状态文件固定是 `workbuddy-panel.json`：这两个名字要是改了， 指向它的默认模型会失效、面板地址也会被忘掉，所以不会动。 - 插件只写 llm-pi-ai 的 `providers.workbuddy2api` 这一条路由，不动 `agent-default-model`。 如果你把默认模型设成了面板上已删除的模型，DSH 那边会报模型不存在——插件不会替你改默认模型。 - 面板的 `promo_factor` / `promo_label` 只做展示，不参与倍率计算（真实倍率以 `promo_credits` 为准）。 - **这条 provider 由插件接管**：`providers.workbuddy2api` 下的 `displayName`/`api`/`baseURL`/ `apiKeyEnv`/`compat`/`models` 每次同步都会按面板现状重写，手改 YAML 会被下一轮覆盖。 想手动控制就关掉「自动同步到 DSH」，或者在插件里改勾选/档位。 - 写配置前会做一次规范化比较，内容没变就不写（写一次会让 llm-pi-ai 重新注册全部模型）。 - 状态文件同样做差异比较：内容没变就不写（轮询每 2 分钟一次，否则会一直改文件时间）。 - 设置页每 15 秒轮询一次快照，带 ETag；内容没变时服务端直接回 304，不会重复传那包约 30KB 的模型清单。 - 界面文案跟随 DSH 的语言；面板返回的模型名、账号昵称、错误原文按原样显示（它们是数据，不翻译）。 - 连续失败时轮询按 120s → 240s → … → 30 分钟退避，恢复后回到基准间隔。 - 下架宽限期默认 24 小时，期间模型仍在配置里；面板那边如果已经彻底删了，调用会由面板返回错误。 - 改宿主侧代码（`lib/*.js`）需要重启 DSH；改前端（`client/client.js`）刷新页面即可。 - 关掉「自动同步到 DSH」后仍会同步面板数据并记录模型基准（`lastModelIds` / 面板版本）， 否则重启后所有模型都会被当成首次导入，「新模型策略」失效。 - 「全部启用（新模型）」只启用面板上新增的模型；要一次性开关全部，用模型列表上方的两个按钮。 - 清除配置会连地址列表一起清掉，想再用得重新填地址（这是有意的：只清 `panelUrl` 的话下一轮又会连回去）。 ---