dsh-meoo：把秒悟 Meoo 模型接入 DeepSeek Harness

前言¶

DeepSeek Harness（dsh）采用「一切皆插件」的理念，扩展能力主要通过加载 bundle。要把 Meoo 的模型接入 dsh，需要自己实现 LLM 适配器或起本地代理进程，比较繁琐。dsh-meoo 插件复用 dsh 自带的 llm-pi-ai 提供方平面，只负责把「凭证 + 路由 + 模型目录」准备好，剩下的流式转发、工具调用由 llm-pi-ai 处理。

这是什么¶

dsh-meoo 是一个模型推理类插件，维护者为 sangonomiya249。它的作用是把秒悟 Meoo 的模型接入 DeepSeek Harness，自动登录取项目服务 AK、同步模型目录，让 Meoo 的模型直接出现在会话模型选择器与「设置 → 模型」里。

核心功能¶

安装后，模型选择器里会出现「Meoo 秒悟」一组，支持以下模型：

Qwen3.8-Flash
Qwen3.8-Max
Qwen3.7-Max
Qwen3.7-Plus
DeepSeek V4.1 Flash
DeepSeek V4 Pro
DeepSeek V4 Flash
GLM-5.2
GLM-5.2-Fast

插件通过 OAuth(PKCE) 登录获取 access/refresh token，再从 Meoo 获取项目服务 AK 与模型目录，最后把密钥写入 dsh 凭据库并配置路由给 llm-pi-ai。模型选择、思考强度、会话持久化、用量统计全都走 dsh 原生链路，插件不碰消息协议，也不在中间加一层会掉流式的代理。

安装与启用¶

dsh 的插件装在 profile 里，默认为 desktop。

# 方式一：直接装 GitHub 上的包（推荐）
dsh plugin --profile desktop add github:sangonomiya249/dsh-meoo

# 方式二：本地目录（改代码时用）
git clone https://github.com/sangonomiya249/dsh-meoo
dsh plugin --profile desktop add file:/绝对路径/dsh-meoo

然后把包名加进 profile 的 bundle 列表（$DSH_HOME/profiles/desktop/package.json）：

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

重启 dsh，bundle 挂载需要重组插件树。

如果 pnpm 报 ERR_PNPM_UNEXPECTED_STORE（profile 与 dsh 内置 pnpm 的 store 版本不一致），可以把仓库 junction/软链到 $DSH_HOME/profiles/desktop/node_modules/dsh-meoo，效果相同。

典型用法¶

重启后在输入框的模型选择器里选 Meoo 秒悟 下的任意模型，直接开聊。

会话里输入 /meoo 管理登录与同步：

命令	作用
`/meoo`	状态：账号、项目、AK、模型、上次同步
`/meoo login`	浏览器 OAuth 授权（PKCE，scope `cli.compat`），完成后自动同步
`/meoo sync`	重新解析 AK + 拉模型目录并写入路由
`/meoo models`	列当前模型
`/meoo project <urlId>`	换项目（AK 会重新解析）
`/meoo key <meoo_project_service_v1...>`	手填项目服务 AK
`/meoo logout`	清本地登录态

配置¶

插件依赖 profile 的 cordis.patch.yml：

# 你的 profile 的 cordis.patch.yml
- id: meoo
  name: dsh-meoo
  config:
    route: meoo                                                      # 提供方 id
    gatewayBaseUrl: https://api.meoo.host/meoo-ai/compatible-mode/v1
    overwrite: false                                                 # true 才覆盖用户改过的路由

前提¶

有一个可用的 Meoo 账号与项目，且该项目开通过云服务（AI 服务 AK 依赖它）。
插件会尝试自动开通一次；仍失败就去 meoo.com → 该项目 →「云服务」点开通，再 /meoo sync。
Node ≥ 20（dsh 自带运行时即可）。

排错¶

现象	处理
模型选择器里没有 Meoo	重启 dsh；`/meoo status` 看 `lastError`
`settings namespace "llm-pi-ai" is not registered`	首次安装时 `$DSH_HOME/settings.yaml` 还不存在，命名空间未注册。插件会兜底直接写该文件，重启后生效
`项目 xxx 还没开通 Meoo AI 服务`	去 meoo.com 该项目「云服务」开通，再 `/meoo sync`
`401 / invalid_token`	refresh token 失效，`/meoo login` 重登
`SERVICE_AK_FORMAT_INVALID`	把 `meoo_ak_` 用户 Key 当成了项目服务 AK；用 `/meoo key` 填 `meoo_project_service_v1.*`

状态与文件¶

路径	内容
`$DSH_HOME/meoo/state.json`	登录态、项目、AK、模型缓存（权限 600）
`$DSH_HOME/settings.yaml`	`llm-pi-ai.providers.meoo` 路由
`$DSH_HOME/.credentials.yaml`	`MEOO_API_KEY`（密钥只在这里）

开发¶

node test/offline.test.mjs        # 13 项：假 ctx + 假 fetch，覆盖同步与 /meoo 命令
node --check index.js

真网关的端到端验证用 overlay 跑 headless profile：

# 直接把路由配给 llm-pi-ai（不经过插件写入）
dsh --profile headless --patch test/headless-piai.yml "只回复一句话：你是哪个模型？"

# 只改默认模型，路由来自 settings.yaml（等价于插件写入后的状态）
dsh --profile headless --patch test/headless-settings-only.yml "只回复一句话：你是哪个模型？"

说明¶

用的是 Meoo 官方「AI 服务」网关，鉴权就是账号的项目服务 AK；调用消耗该账号额度，插件不绕过任何计费。
与 Meoo 官方无关联，是第三方集成。
凭证只留在本机，仓库里不含任何 token。

生态背景¶

DSH 的理念是「一切皆插件」，社区目录（https://www.skillhub.cn/plugins/sangonomiya249/dsh-meoo）是独立站点，与 DeepSeek / 幻方无官方从属关系。

短结尾¶

dsh-meoo 让 Meoo 的模型直接出现在 dsh 的模型选择器里，安装后只需点一次「授权」即可完成登录与同步，后续 AK 与模型目录更新全自动。适合需要在 dsh 里使用 Meoo 模型的开发者。

目录页：https://www.skillhub.cn/plugins/sangonomiya249/dsh-meoo
GitHub：https://github.com/sangonomiya249/dsh-meoo