前言¶
在 DeepSeek Harness（DSH）里做智能体开发，模型通常走各家 API Key 或内置 provider。如果你已经在用美团妙手（CatPaw / catpaw-moon）桌面客户端，账户里带着 passport 登录态和积分套餐，却想在 DSH 的对话界面里直接选同一套模型，就需要一个能把妙手上游「翻译」成 OpenAI 兼容流式接口的插件。
下面介绍社区插件 dsh-connect-miaoshou（维护者 Wahwayhale）：在 DSH 中注册 provider miaoshou，复用妙手登录态，经 nocode.cn 的 chat → agent-stream → SSE 链路返回文本；设置页附带只读的积分、套餐与模型清单卡片。分类上属于「模型推理」类 DSH 插件；目录见 SkillHub，源码见 GitHub。
这是什么¶
dsh-connect-miaoshou 是妙手桌面客户端（或独立扫码）与 DeepSeek Harness 之间的 model provider 桥接层。它不执行妙手远端的工具调用，isAgent 固定为 false，拿回的是纯文本流；浏览器侧路由只返回数字视图，不暴露令牌。
核心能力¶
模型 provider miaoshou¶
插件提供 12 个模型，与妙手 App 模型选择器逐条对齐，展示名与 App 一致，调用名按厂商口径转换（README 写明 12 条均已实测可调通）：
- Auto
- LongCat-2.5 / LongCat-2.0
- GLM-5.3-FlashX / GLM-5.3-Flash / GLM-5.3
- DeepSeek-V4.1-Flash / DeepSeek-V4-Pro
- MiniMax-M3.1-Flash / MiniMax-M3
- Kimi-K3.1-Pro / Kimi-K3
模型目录只读 catpaw-agent.meituan.com/api/agent/maas/model-types（带积分倍率 extendedInfo.rateMultiplier），不与 catx.nocode.cn 那套另一命名混用。
设置页「妙手」卡片¶
可用积分、套餐到期与下次发放倒计时、账号状态；可勾选哪些模型出现在 DSH 模型选择器；可覆盖上游地址。另有诊断：目录条数与来源、当前上游、凭据读取状态。
思考档位映射¶
DSH 的思考档位会转成 agent-stream 请求里的 modelParams.declarativeParams。不同模型对上思考 / effort 的支持不一致（例如部分 GLM、MiniMax 不发 thinking），非法 effort 会导致整轮无输出，故未支持的档位不会出现在选择器里；Auto 仅暴露 Off。
用量与计费字段¶
妙手按积分计费，不返回 token 用量（表现为用量恒为 0）。每轮积分消耗出现在 OpenAI 兼容响应的自定义字段 miaoshou.creditCost 中。
凭据与登录¶
凭据按优先级有三种来源：
-
扫码登录（推荐，不依赖妙手客户端）
在设置卡「账号状态」点「扫码登录」，浏览器扫码确认后令牌写入~/.dsh/dsh-connect-miaoshou.token.json（权限 0600）。Passport 没有 refresh_token，过期需重新扫码。 -
妙手客户端登录态（兜底）
默认读取~/.meituan-catpaw/auth.json中的auth.accessToken；可用环境变量MIAOSHOU_HOME指向其他目录。 -
epCLI（仅企业版）
与个人 CatPaw 账号不是同一套；个人版请用扫码或客户端文件。README 说明卡片上不再把 ep 作为主路径。
对话链路与账号积分链路使用不同鉴权头，混用会 401；域名与头字段见仓库 README 表格（nocode.cn、catx.nocode.cn、catpaw-agent.meituan.com）。
安装与启用¶
插件以本地目录方式安装。README 给出的命令为：
dsh plugin install <本目录绝对路径>
将 <本目录绝对路径> 换成本地已构建或克隆后的插件根目录（含 package.json 与构建产物 lib/）。package.json 声明版本 0.1.1，许可证 MIT，Node 引擎为 ^22.19.0 || >=24.0.0，并依赖 Cordis / dsh-host-webserver / dsh-llm 等 peer 包（版本范围见仓库）。
安装前建议自行阅读源码与许可证：插件在当前 dsh 进程权限下运行，会读取本机 auth 文件或写入 token 文件。
典型用法¶
完成安装并在设置卡完成登录或确认客户端已登录后：
- 在 DSH 模型选择器中选择 provider miaoshou，勾选卡片里启用的具体模型。
- 按平常方式发起对话；响应为 OpenAI 兼容流式文本。
- 需要核对账户时打开设置页妙手卡片查看积分与套餐，或用诊断项确认上游与凭据状态。
开发构建（维护者自用）：
npm run build # 产出 lib/index.js (ESM) + lib/client.js (CJS)
npm run typecheck
已知限制与适用场景¶
适合谁：已在妙手/CatPaw 有个人账号或积分套餐，希望在 DSH 统一界面调用与 App 一致的 12 个模型，且能接受文本-only、非官方 API 桥接的方式。
不适合或需有预期：
- 只支持文本：图片
images链路未打通，所有模型仅声明text模态。 - 首字延迟约 8～12 秒：上游一次性发出整段文本，表现为等待后整段弹出。
- 上游可能注入 agent 口癖：部分请求带固定开场，
isAgent:false也不能完全消除。 - 不替你在妙手远端跑工具；仅作模型文本输出桥接。
DSH 生态强调「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系，本文介绍的是第三方维护的桥接插件。
