dsh-plugin-subhub

Readme

<p align="center">
  <img src="assets/hero-en-v2.svg" width="100%" alt="dsh-plugin-subhub — third-party subscription accounts inside DeepSeek Harness" />
</p>

<h1 align="center">Dsh Plugin Subhub</h1>

<p align="center">
  English · <a href="README.zh.md">中文</a>
</p>

<p align="center">
  <a href="https://awesome-dsh-plugin.com"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="Awesome DSH Plugin" /></a>
  <a href="https://github.com/zp-home/dsh-recommend"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fzp-home%2Fdsh-recommend%2Fmain%2Fdata%2Fbadges%2Fkinoward__dsh-plugin-subhub.certified.json" alt="dsh-recommend · certified" /></a>
  <a href="https://github.com/kinoward/dsh-plugin-subhub/stargazers"><img src="https://img.shields.io/github/stars/kinoward/dsh-plugin-subhub" alt="GitHub stars" /></a>
</p>

<p align="center">
  <a href="https://github.com/kinoward/dsh-plugin-subhub/releases/tag/v1.8.1"><img src="https://img.shields.io/badge/release-v1.8.1-5B4CF0" alt="Release v1.8.1" /></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
  <a href="package.json"><img src="https://img.shields.io/badge/Node.js-%3E%3D22.19-339933?logo=nodedotjs&logoColor=white" alt="Node.js >= 22.19" /></a>
  <img src="https://img.shields.io/badge/DSH-Web%20profile-5B4CF0" alt="DSH Web profile" />
</p>

Bring a **third-party subscription account** into [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) and chat with the models your subscription covers: text chat, image understanding, image generation, and image editing.

**Supported today: OpenAI / ChatGPT, xAI (Grok), and GitHub Copilot subscriptions — all signed in with your subscription account through browser authorization. Key-based services are already built into DeepSeek Harness — add them on its Models page.**

> Model availability, usage limits, and response speed are decided by the subscription provider and your account. Some features may become temporarily unavailable after the provider changes its service.

## Install

- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`) with Node.js 22.19 or later.

```sh
dsh plugin --profile web add github:kinoward/dsh-plugin-subhub
dsh web
```

`dsh web` boots the `web` profile (same as `dsh --profile web`). Restart DeepSeek Harness after installing.

## Quick start

1. **Log in** — open **Settings → Third-party subscriptions**, click **Sign in** on the card of the subscription you want (e.g. **OpenAI subscription** for a ChatGPT account or **xAI Grok subscription** for SuperGrok / X Premium+), then open the authorization link in a browser and enter the one-time code (valid for 15 minutes). Once authorized, the page syncs automatically and the subscription appears in the model picker.
2. **Pick a model** — click the model selector at the bottom-left of the input area (it shows the current model and reasoning level), choose **Model**, and pick a model under **OpenAI subscription**. Adjust the reasoning level from the same menu if needed. Available models and reasoning levels come from your account and stay in sync automatically.
3. **Use images** — upload an image and ask about it, describe an image to generate one, or ask to edit an image:

   - View: *“What's in this image?”* / *“Extract the text from this screenshot.”*
   - Generate: *“A cinematic illustration of a neon street on a rainy night.”*
   - Edit: upload an image (or use the one just generated), then *“Change the sky to a sunset, keep everything else the same.”* The edit uses the most recent image in the conversation; upload one first if there is none.

   Viewing, generating, and editing images all require a model that supports image input; the model info marks it with an “Image input” tag.

### Manage your account

- **Re-login / log out** — **Settings → Third-party subscriptions** → **Log in again** switches accounts; **Log out** removes the saved login.
- **Update** — rerun the install command, then restart DeepSeek Harness.
- **Disable** — **Settings → Plugins → Plugin list** → turn off `dsh-plugin-subhub`.

## CLI sign-in (optional)

No graphical interface? Sign in with the bundled script instead. From the profile directory, run:

```sh
node node_modules/dsh-plugin-subhub/login.js
```

The script prints an authorization link and a one-time code — open the link in a browser, enter the code, and the credentials are saved to `~/.dsh-plugin-subhub/openai-auth.json`. After signing in, open **Settings → Third-party subscriptions** once so the subscription appears in the model picker. The bundled script currently covers OpenAI; every other provider signs in on the subscriptions page.

## Screenshots

Browser-framed captures of the plugin in the DeepSeek Harness Web UI — light and dark themes:

**Settings → Third-party subscriptions — signed out:**

<p align="center">
  <img src="assets/settings-loggedout-en-light.png" width="46%" alt="Subscriptions settings — signed out (light)" />
  <img src="assets/settings-loggedout-en-dark.png" width="46%" alt="Subscriptions settings — signed out (dark)" />
</p>

**Settings → Third-party subscriptions — signed in:**

<p align="center">
  <img src="assets/settings-loggedin-en-light.png" width="46%" alt="Subscriptions settings — signed in (light)" />
  <img src="assets/settings-loggedin-en-dark.png" width="46%" alt="Subscriptions settings — signed in (dark)" />
</p>

**Models page — OpenAI subscription expanded (signed in):**

<p align="center">
  <img src="assets/models-en-light.png" width="46%" alt="Models page — OpenAI subscription expanded (light)" />
  <img src="assets/models-en-dark.png" width="46%" alt="Models page — OpenAI subscription expanded (dark)" />
</p>

**Using images in a conversation — image understanding:**

<p align="center">
  <img src="assets/chat-image-en-light.png" width="46%" alt="Image understanding (light)" />
  <img src="assets/chat-image-en-dark.png" width="46%" alt="Image understanding (dark)" />
</p>

**Generating images in a conversation — text to image:**

<p align="center">
  <img src="assets/chat-generate-en-light.png" width="46%" alt="Text to image (light)" />
  <img src="assets/chat-generate-en-dark.png" width="46%" alt="Text to image (dark)" />
</p>

**Editing images in a conversation — image to image:**

<p align="center">
  <img src="assets/chat-edit-en-light.png" width="46%" alt="Image to image (light)" />
  <img src="assets/chat-edit-en-dark.png" width="46%" alt="Image to image (dark)" />
</p>

## Security & privacy

- Unless you configure another location, login data is stored in `~/.dsh-plugin-subhub/<provider>-auth.json` — one file per provider (e.g. `openai-auth.json` for OpenAI, `xai-auth.json` for xAI);
- The plugin creates or updates those files with access restricted to the current system user;
- The plugin never reads login data saved by other programs (such as the Codex CLI); sign in once inside this plugin after installing;
- Signing out deletes the login file the plugin currently uses;
- xAI sign-in reuses the same OAuth flow the official Grok CLI uses; it is a community-supported path, so xAI may change it at any time.
- Don't share login files, one-time codes, or other account details — and don't commit them to Git or post them in issues.

## Support

- [GitHub Issues](https://github.com/kinoward/dsh-plugin-subhub/issues) — report bugs or request features. Remove account details and other sensitive content before posting.

Service names and logos are trademarks of their respective owners.

## License

[MIT](LICENSE)