前言¶
在 DeepSeek Harness(DSH)里做智能体开发,模型往往要分散在多个 provider 里切换;若你用的是 秒悟 Meoo 的模型,原先需要自己维护网关地址、项目服务 AK,还要手动对齐官网上的模型目录与计费信息。dsh-connect-meoo 由社区维护者 xinstart-1 开发,属于「模型推理」类 DSH 插件:把 Meoo 的官方 AI 服务网关以 OpenAI 兼容方式挂进 DSH,在模型选择器里出现「Meoo 秒悟」分组,并在设置页集中处理账号、模型、积分与诊断。
这是什么¶
插件全称 DSH Connect 秒悟 Meoo(包名 dsh-connect-meoo),当前版本 0.0.6,许可证 MIT。它面向已在 DSH 中运行对话与 agent 的开发者:不经过本地 shim,直接让 pi-ai 以「项目服务 AK 作 apiKey + Meoo 网关作 baseURL」转发请求;模型目录、价格档位与积分读数尽量与官网同源接口一致。
维护与源码见 GitHub 仓库 xinstart-1/dsh-connect-meoo;社区目录页为 SkillHub 条目。DSH 生态强调「一切皆插件」;SkillHub 为独立社区目录,与 DeepSeek / 幻方无官方从属关系。
核心功能¶
装上并在 profile 的 bundle 里启用后,README 描述的能力包括:
- 模型 provider:模型选择器多出「Meoo 秒悟」,切换方式与其它原生 provider 相同。
- 设置 → 秒悟:一个入口下分账号、模型、积分、设置、诊断五个分栏。
- 模型目录对齐官网:便宜/适中/较贵/超贵档位、夜间折扣、说明文案、上下文与输出上限等,取自官网侧接口(
GET {gateway}/models)。 - 输入框积分胶囊:仅当选中 Meoo 模型时出现,可查看余额与到期。
- 可选全局侧栏整页:默认关闭,需在界面开关中打开。
界面设计语言与 dsh-connect-workbuddy 同类(圆角卡片、1px 分隔、主题变量驱动暗色/亮色),但上游是 Meoo 官方 AI 服务网关(https://api.meoo.host/meoo-ai/compatible-mode/v1),鉴权走 OAuth(PKCE) 或控制面 API Key,再解析为项目服务 AK,而不是客户端私有接口或本地回环 shim。
鉴权与三条登录路径¶
推荐路径是粘贴 控制面 API Key(meoo_ak_…):与 PAT 模式类似,填 key 即可推导身份、项目列表、积分与项目服务 AK,无需点「登录」。在 meoo.com → 设置 → API 密钥 生成后,填入「设置 → 秒悟 → API Key」。
| 方式 | 能读积分 | 会过期吗 |
|---|---|---|
API Key(meoo_ak_…,推荐) |
是 | 否 |
| 浏览器 OAuth(PKCE) | 是 | access token 约 1 小时,refresh 自动续期 |
项目服务 AK(meoo_project_service_v1.…) |
否 | 长期,换项目需换 key |
注意:meoo_ak_… 不能直接调模型网关(会 401 SERVICE_AK_FORMAT_INVALID);网关 Bearer 应为项目服务 AK,插件负责转换。浏览器授权折在「高级」;若本机已有 dsh-meoo-connect 或 meoo-proxy 的登录态,可只读复用(reuseLocalLogin 默认开启)。
凭据落盘于 $DSH_HOME/meoo/state.json(权限 600),不进入浏览器页面;调用消耗的是你自己账号的积分。
安装与启用¶
DSH 插件装在 profile 上(本机 Web GUI 常用 desktop 或 web)。README 给出的本地开发安装示例为:
dsh plugin --profile desktop add file:X:/Agent/deepseek插件/dsh-connect-meoo
将包名加入对应 profile 的 bundle 列表($DSH_HOME/profiles/<profile>/package.json):
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-connect-meoo"
]
}
}
}
重启 dsh:新 bundle 需要重组插件树,热加载不会挂载新 bundle。
运行环境要求(来自 package.json):Node ^22.19.0 || >=24.0.0,DSH >=0.2.1-rc.1 <0.3.0-0。
配置说明¶
插件清单中的静态配置示例:
- id: dsh-connect-meoo
name: dsh-connect-meoo
config:
enabled: true
apiBaseUrl: '' # 留空 = https://meoo.com
gatewayBaseUrl: '' # 留空 = https://api.meoo.host/meoo-ai/compatible-mode/v1
serviceAk: '' # 手填项目服务 AK(兜底)
reuseLocalLogin: true # 只读复用 dsh-meoo-connect / meoo-proxy 的登录态
projectUrlId: '' # 指定项目;留空用账号默认项目
defaultReasoningEffort: '' # off / low / medium / high
warmOnStart: true # 启动时预拉一次目录与积分
界面上的胶囊、侧栏、刷新间隔、禁用模型等开关不进上述 settings,而写在 $DSH_HOME/dsh-connect-meoo-state.json,点选即生效。
典型用法¶
斜杠命令¶
| 命令 | 作用 |
|---|---|
/meoo |
状态:账号、项目、AK、模型、上次同步 |
/meoo login |
浏览器授权(PKCE) |
/meoo sync |
重新解析 AK 并拉模型目录 |
/meoo models |
列出当前模型 |
/meoo project <urlId> |
切换项目 |
/meoo key <ak> |
手填项目服务 AK |
/meoo apikey <meoo_ak_…> |
手填控制面 API Key |
/meoo logout |
清除本插件保存的登录态 |
排错摘要¶
- 选择器没有 Meoo:重启 dsh,在「诊断」栏查看
lastError。 - 网关
401:AK 与项目不匹配或未开通云服务。 - 积分「暂时读不到」:若仅用项目服务 AK,上游
/account/points不认该凭据,改用 API Key 或浏览器授权。
更完整现象表见仓库 README「排错」一节。
适用场景与注意¶
适合谁:已在 DSH 里做 agent / 对话,账号在 Meoo 有项目与积分,希望用同一套 UI 切换 Meoo 模型并查看目录与余额的开发者。
安装前建议:插件以当前 dsh 进程的权限访问本机文件与网络;安装前应自行审阅源码与 MIT 许可证,确认凭据存储路径与行为符合你的安全策略。插件声明与 Meoo 官方无关联,为第三方集成。
边界:仅使用 Meoo 官方开放契约与网关,不绕过计费;多项目时需在「账号」栏选择项目,计费归属随项目变化。
结尾¶
dsh-connect-meoo 把 Meoo 控制面凭据、项目服务 AK 解析与 OpenAI 兼容网关转发收口到 DSH 插件里,减少自建 shim 与手工抄模型列表的成本。进一步了解功能与开发门禁(如 node scripts/gate.mjs)可直接阅读仓库 README。