dsh-meoo-connect: Integrating Meoo Models into DSH Sessions and Settings

前言

在 DeepSeek Harness(dsh)里用第三方云模型,常见做法是单独配 API Key、手写 provider 路由,或在中间再起一层代理。秒悟 Meoo 提供 OpenAI 兼容网关和项目级服务 AK,若每次都要手填密钥、维护模型列表,开发和日常会话切换都会拖慢节奏。

下面介绍社区插件 dsh-meoo-connect(维护者 2239058652):它不实现新的 LLM 适配器,也不起本地代理,而是把 OAuth 登录、项目服务 AK 解析、模型目录同步交给插件,实际转发仍走 dsh 自带的 llm-pi-ai 提供方平面。装好后,Meoo 秒悟 会出现在会话输入框的模型选择器,并在 设置 → 模型 里提供与原生 provider 相近的配置入口。

这是什么

dsh-meoo-connect 归类为「模型推理」类 DSH 插件(SkillHub 目录页)。当前 package 版本为 1.0.1,许可证 MIT。

本项目是 sangonomiya249/dsh-meoo 的衍生版本,上游基线 cf77e92,独立维护。相对上游,针对 DSH 0.2.1-rc.5 修复了写模型路由的三处问题(settings.get 不存在、竞态导致正则匹配失败、兜底写入已废弃的 settings.yaml),并使用本仓库的包名与归属。

插件与 Meoo 官方无关联,是第三方集成;调用走 Meoo 官方 AI 服务网关,消耗账号额度,不绕过计费。

核心功能

会话与设置里的模型入口

安装并重启后,模型选择器中会多出一组 Meoo 秒悟,可在其中切换例如 Qwen3.8-Flash、DeepSeek V4 Pro、GLM-5.2 等(以 Meoo 侧当前目录为准)。设置 → 模型 中同样有 Meoo 秒悟 一行,可改 API Key、baseURL、增删模型,行为接近原生 provider。

凭证与路由由插件准备,推理走 llm-pi-ai

整体链路如下:

dsh-meoo-connect (Host)
  ├─ OAuth(PKCE) 登录 meoo            → access/refresh token 存 $DSH_HOME/meoo/state.json
  ├─ /open/v1/cli-compat/...           → 项目列表、项目服务 AK(meoo_project_service_v1.*)
  ├─ GET api.meoo.host/.../models      → 当前可用模型目录
  ├─ credentials.set('MEOO_API_KEY')   → 密钥进 dsh 凭据库(不写进配置)
  └─ settings.update('llm-pi-ai')      → 写入 profile patch 的 providers.meoo 路由
                                            ↓
                                llm-pi-ai 负责转发(流式、工具调用)
                                            ↓
                    模型选择器「Meoo 秒悟」  +  设置 → 模型 里的 Meoo 卡片

模型选择、思考强度、会话持久化、用量统计均走 dsh 原生链路;插件不处理消息协议,中间也不加会打断流式的代理层。

API Key 与同步

多数步骤自动完成,浏览器里通常只需点一次「授权」:

环节 说明
OAuth(PKCE) /meoo login 起本机回调,scope cli.compat
Token 续期 refresh token 自动轮换,原子保存
项目 默认用账号 project_url_id,或 /meoo project <urlId> 指定
项目服务 AK 从 GET .../cloud/environment 的 meooProjectApiKey 取得
未开通云服务 插件可尝试 POST .../cloud 开通后再取
模型目录 GET api.meoo.host/meoo-ai/compatible-mode/v1/models
存密钥 credentials.set('MEOO_API_KEY', ak)

若本机已有 meoo-proxy CLI 登录态(~/.meoo-proxy/config.json),插件可复用,可省掉 OAuth 点击。也可 /meoo key meoo_project_service_v1.xxx 或在 设置 → 模型 → Meoo 秒悟 的 API Key 框手填。

安装与启用

dsh 插件装在 profile 里;本机 Web GUI 使用 web profile(Electron 的 desktop profile 由应用管理,dsh plugin 不接受)。

先做安装,再把包名加入 bundle 列表,最后重启 dsh。

# 方式一:从 GitHub 安装(推荐)
dsh plugin --profile web add github:2239058652/dsh-meoo-connect

编辑 $DSH_HOME/profiles/web/package.json,在 dsh.profile.bundles 中加入 dsh-meoo-connect:

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-meoo-connect"
      ]
    }
  }
}

重启 dsh(新 bundle 需重组插件树,热加载不会挂载新 bundle)。

若 pnpm 报 ERR_PNPM_UNEXPECTED_STORE,可将仓库 junction/软链到 $DSH_HOME/profiles/web/node_modules/dsh-meoo-connect,效果与上述安装相同。

package.json 声明依赖 dsh >=0.2.1-rc.5 <0.3.0、Node >=22.19.0;README 前提说明 Node ≥ 20 且 dsh 自带运行时即可,以你当前 dsh 版本与 engines 字段为准。

可选配置(profile 的 cordis.patch.yml 中插件项):

- id: meoo
  name: dsh-meoo-connect
  config:
    route: meoo
    gatewayBaseUrl: https://api.meoo.host/meoo-ai/compatible-mode/v1
    overwrite: false

overwrite: true 时才会覆盖用户已改过的路由。

典型用法

  1. 重启后,在输入框模型选择器选 Meoo 秒悟 下任意模型即可对话。
  2. 在会话中用 /meoo 管理登录与同步:
命令 作用
/meoo 状态:账号、项目、AK、模型、上次同步
/meoo login 浏览器 OAuth,完成后自动同步
/meoo sync 重新解析 AK、拉模型目录并写路由
/meoo models 列出当前模型
/meoo project <urlId> 切换项目(AK 会重新解析)
/meoo key <meoo_project_service_v1...> 手填项目服务 AK
/meoo logout 清除本地登录态

首次使用推荐:/meoo login → 浏览器授权 → 其余由插件完成。

适用场景与注意

适合谁:已在 meoo.com 有账号与项目、希望在 dsh 里像用内置 provider 一样选 Meoo 模型、且愿意启用 llm-pi-ai bundle 的用户。

前提:

  • 项目需能使用 Meoo 云服务(AI 服务 AK 依赖于此);自动开通失败时,需在 meoo.com 项目页开通「云服务」后执行 /meoo sync。
  • profile 中需保留 @deepseek-ai/dsh-base 及 llm-pi-ai 相关 patch;若出现「llm-pi-ai 命名空间还没注册」或 No configurable plugin entry "llm-pi-ai",按 README 排错表补全 bundle 与 patch 后重启再 /meoo sync。

安全与权限:插件以当前 dsh 进程权限运行,会读写 $DSH_HOME/meoo/state.json、凭据库与 profile 路由。安装前建议在 GitHub 仓库 查看源码与 MIT 许可证;凭证仅留在本机,仓库不含 token。

常见排错摘要:选择器无 Meoo → 重启并看 /meoo 的 lastError;401 → /meoo login;SERVICE_AK_FORMAT_INVALID → 须使用 meoo_project_service_v1.* 形式的项目服务 AK,勿用 meoo_ak_ 用户 Key。

结尾

dsh-meoo-connect 把 Meoo 的「登录 → 项目 AK → 模型目录 → llm-pi-ai 路由」收成一条可复现路径,让 Meoo 模型直接进入 dsh 会话与设置,而无需自建代理或手写全套 provider 配置。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye