dsh-nous-portal-free-provider

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-nous-portal-free-provider

Nous Portal 免费 Tier 接入 dsh

[English](README.en.md)

Hermes Agent（Nous Portal）上 OAuth 登录可以免费使用一些模型，包含 Hy3、Ox Alpha 等。本插件把它接到 dsh 上。

## 安装

从 npm 安装（预构建产物，推荐）：

```sh
dsh plugin --profile web add @jiesou/dsh-nous-portal-free-provider
```

或从 GitHub 安装：

```sh
dsh plugin --profile web add github:jiesou/dsh-nous-portal-free-provider
```

## 安装之后

登录：运行本插件自带的 CLI

```
# 根据实际 plugin 目录找到 lib/cli.js
node ~/.dsh/profiles/web/node_modules/@jiesou/dsh-nous-portal-free-provider/lib/cli.js
```

然后按照终端提示，使用 device code 登录即可
运行中的 dsh 热加载，无需重启

### CLI 选项

```
--portal-url    Portal 地址（默认 https://portal.nousresearch.com）
--client-id      OAuth client id（默认 hermes-cli）
--scope       申请的 scope（默认 inference:invoke）
--dsh-home      凭据文档所在 home（默认 $DSH_HOME 或 ~/.dsh）
--path         凭据文档完整路径，优先于 --dsh-home
```

> 注：插件同时注册了 dsh 授权流（`ctx.authorization`），但 0.1.1-rc.x 的
> dsh 还没有能启动它的界面（seam 已有、surface 未发布）；上面这个独立
> CLI 是当前的推荐登录路径。

## 认证来源（按优先级）

| 优先级 | 来源 | 说明 |
|---|---|---|
| 1 | 凭据 `NOUS_PORTAL_API_KEY` | 普通 `sk-` key，付费账户 |
| 2 | 凭据记录 `<本插件>/portal` | 授权流写入的 OAuth grant |

存储完全走 `ctx.credentials` 统一接口：refresh token 是 grant record，
token 轮换通过 `modifyRecord` 写回（跨进程锁）；access token 只存内存。

本插件没有 settings 配置项：所有端点、重试策略（`always`）均硬编码为免费层
的合理默认值，目录由上游 `/v1/models` 动态发现；唯一的登录入口是上面的 CLI。

## 模型目录：动态发现

启动时和每 15 分钟从公开的 `/v1/models` 列表（无需认证）抓取，
**过滤出 prompt/completion 价格均为 $0 的模型**作为目录，元数据
（context window、多模态输入、reasoning efforts）一并跟随上游。
免费集随上游轮换自动增减，不写死任何模型 id。

当前在线结果（2026-08）：stepfun/step-3.7-flash:free、tencent/hy3:free、
poolside/laguna-s/xs-2.1:free、upstage/solar-pro4:free 等 7 个。

## 注意事项

- **refresh token 会轮换且单次使用**：Portal 每次 refresh 都发新 refresh token、
  旧 token 立即作废；重复提交已用过的旧 token 会被服务端视为令牌被盗、**吊销整条
  会话**（原话 `Refresh token reuse detected; please re-authenticate`）。因此刷新的
  「读 RT → POST → 写回新 RT」整段都在凭据服务的 `modifyRecord` 锁内执行，避免多进程
  同时提交同一 RT。
  总之：若仍看到 re-authenticate 提示，按上面 CLI 重新登录即可。
- **device-code 审批页 bug**：Portal 端审批 UI 曾对部分用户不渲染
  （NousResearch/hermes-agent#47950）。如果授权卡住，先确认浏览器已登录
  Portal 再重试。
- **协议变更（2026-08）**：Portal 已下线 `/api/oauth/agent-key` 铸造端点，
  新版 hermes-cli 直接把 refresh 换来的 access token（invoke JWT）当推理密钥，
  登录 scope 改为 `inference:invoke`。本插件已跟进。

## License

MIT