@uumit-ai/dsh-uumit

让 DeepSeek Harness 里的助手会用 UUMit（一个「什么能力都能找到」的平台）：查平台上有没有能做某件事的能力、问一次大概多少钱，还能直接帮你跑一次。装上之后，在会话里说人话就行，不用记命令、不用写代码。

本包版本 0.0.3（@uumit-ai/[email protected]）

它帮我做什么？

装上就有四个工具，助手可以替你：

• 查：问「UUMit 上有没有能做某件事的能力」。查不到会如实说查不到，不会编。
• 问价：先问清大概要多少，再决定做不做。只问价，不会下单。
• 执行：按你的要求真的跑一次（动手前会先跟你确认）。
• 探活：不用配任何东西，先看看平台通不通。

怎么装

dsh plugin --profile uumit-try add @uumit-ai/dsh-uumit   # 1) 装（建议拿一个新档案试，别装进正在用的那个）
export UUMIT_PAT='pat_…'                                  # 2) 配钥匙（怎么拿见下文「怎么拿到钥匙」）
dsh --profile uumit-try                                   # 3) 启动

• 装完必须重新启动 DSH 才生效。 装包只是把插件放进档案，你正在用的那个会话不会中途长出这四个工具。
• ⚠️ 上面命令里的 uumit-try 是示例名字，换成你自己起的档案名即可（别照抄尖括号：<档案名> 只是占位写法）。
• ⚠️ 钥匙要在即将启动 DSH 的那个终端窗口里 export，并且要在启动之前 —— 换个窗口 export，或者启动之后再 export，都不算。
• 需要 Node.js ≥ 22；DSH 版本以 0.1.5-rc.2 开发和验证。

怎么用

启动后直接在对话框里说人话，例如：

• 「UUMit 上有没有能做图片去背景的？」
• 「这个大概要花多少钱？」
• 「就选它，开始吧。」—— 助手会真的执行；执行前会先弹出确认框。

想先确认通路，把下面这句直接复制进对话框：

用 uumit_agent_card 看看 UUMit 通不通

• uumit_agent_card 不需要钥匙，所以它只能证明「插件挂上了、网络通」。
• 只验它不算配好钥匙：还要再让助手调一次 uumit_discover（这个需要钥匙）—— 它也能正常返回，才说明钥匙配好了。
• 需要钥匙的是 uumit_discover / uumit_quote / uumit_invoke 三个；缺凭证时它们会先拒绝、不会发出请求。

💡 放心用：只有「执行」这一步会按 UT 计费，而且每一笔都先弹确认框、单次上限 100 UT（写在代码里）——你不点确认，就不会扣费。

怎么拿到钥匙

先去 https://m.uumit.com/login 登录，然后按下面两条通道之一拿钥匙（在平台上找创建钥匙的地方新建一把，创建时可以给它设一个消费上限；入口的确切位置与叫法以平台实际页面为准）：

• 推荐：统一开发者钥匙（PAT） —— 配到 UUMIT_PAT。它支持在平台侧给这把钥匙设消费上限。
• 旧写法：智能体平台钥匙 —— 配到 UUMIT_API_KEY + UUMIT_USER_ID。平台侧的消费上限对它不生效。

几条要记住的：

• UUMIT_PAT 是推荐的变量名；两个都配时按 PAT 走（以 UUMIT_PAT 为准）。
• PAT 读取出错会直接拒绝，不会悄悄换回另一条通道让你误以为还有上限。
• 旧写法那把钥匙必须是「全权」类型，不是「MCP 专用」，否则调接口会被平台拒绝（见下）。
• 创建钥匙的接口是 POST /api/v1/auth/tokens（这条是给开发者看的，普通用户用不上）。
• 凭证不会出现在工具输出、日志或错误信息里。
• 钥匙等同于你的凭据：不要提交进版本库，也不要贴进聊天记录。

出问题了

装完工具列表里没有那四个工具？ 按顺序查三件事：① 启动时 --profile 用的是不是装的那个档案；② 有没有重启 DSH；③ 启动日志里有没有 uumit: activated。

启动 DSH 直接报错，提示里有 duplicate 和 id: uumit？ 档案里被手工多加了一行同名的 uumit 挂载行。删掉那一行（插件自带它），或者启动时不带那个补丁文件。这是已知会让整个 DSH 起不来的配置错误。

报「该 Key 不可用于 REST 接口」？ 用成「MCP 专用」钥匙了。回平台重新生成一把**「全权」**钥匙再配上。

凭证明明配了，还是报缺凭证？改了却不生效？ 多半是环境变量遮蔽：先 printenv UUMIT_PAT 确认当前窗口真有值；如果是先 export 再启动的，就在那个窗口里 unset，然后重启 DSH。

付费调用被拒，原因写着 confirmation_unavailable？ 当前环境没有人能应答确认（没有可用界面）。拿不到你的确认时，它不会执行那笔付费调用；不过平台若认为这次不需要确认，则会直接执行。换到有界面的 DSH 里再试。

被拒，原因写着 exposure_unknown？ 它算不出这次最多可能花多少，所以不替你花。可以换一个能力，或自己去 UUMit 客户端下单。

议价类能力点不动？ 报价上限超过 100 UT 的会被直接拒绝。请自己去 UUMit 客户端下单。

每次执行后它会告诉你这次花了多少；如果它说这一笔「未知」，就拿它给出的编号去 UUMit 客户端核对。

卸载

dsh plugin --profile uumit-try remove @uumit-ai/dsh-uumit

• 卸载也要重启 DSH 才生效。
• 档案目录不会自动删除，要清干净就自己删掉 ~/.dsh/profiles/<档案名>/。

许可证

MIT（许可证全文见包内 LICENSE 文件）。