前言¶

在 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 與同步¶

多數步驟自動完成，瀏覽器裏通常只需點一次「授權」：

若本機已有 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 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 配置。

• 目錄頁：https://www.skillhub.cn/plugins/2239058652/dsh-meoo-connect
• 源碼與完整說明：https://github.com/2239058652/dsh-meoo-connect