dsh-h-v1

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

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

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

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

# 🐋 FreeDSH

### Run DeepSeek Harness with free and low-cost AI models — with automatic routing, fallback and safe updates.

**FreeDSH** is the community-facing name for this repository (`dsh-h-v1`). It adds a practical distribution layer on top of [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): free-model routing, a local provider gateway, a friendlier UI, pt-BR support, versioned configuration and rollback-safe updates.

> **Unofficial project.** FreeDSH is not affiliated with or endorsed by DeepSeek.

[![Windows](https://img.shields.io/badge/Windows-supported-0078D4?logo=windows)](#install-in-1-minute)
[![Linux](https://img.shields.io/badge/Linux-supported-FCC624?logo=linux&logoColor=black)](#install-in-1-minute)
[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen)](CONTRIBUTING.md)
[![License](https://img.shields.io/badge/original%20code-MIT-blue)](LICENSE)
[![Latest release](https://img.shields.io/github/v/release/marcosmmjr2023/dsh-h-v1?label=release&sort=semver)](https://github.com/marcosmmjr2023/dsh-h-v1/releases)
[![Discussions](https://img.shields.io/badge/discussions-open-blue)](https://github.com/marcosmmjr2023/dsh-h-v1/discussions)

**Português:** [README.pt-BR.md](README.pt-BR.md)

![FreeDSH in action — FreeLLMAPI, Smart Router, model controls and safe core updates](assets/freedsh-demo.gif)

---

## Why FreeDSH?

DeepSeek Harness is powerful, but a daily setup can become expensive or fragile when you depend on a single model/provider. FreeDSH focuses on a different experience:

| | FreeDSH adds |
|---|---|
| 🎁 **Free-first routing** | Use FreeLLMAPI, OpenRouter `:free`, OpenCode free/zen and other configured providers before paid fallback. |
| 🔁 **Automatic fallback** | If a provider fails or becomes unavailable, the router can move to another configured option. |
| 🧠 **Task-aware routing** | `auto`, `eco` and `ultra` profiles let the router choose different model tiers for different workloads. |
| 🖥️ **Integrated panel** | Provider/router/core status, recent files and model controls in the Harness UI. |
| 🛡️ **Safer core updates** | Test a new core in a parallel instance instead of overwriting the working environment. |
| ↩️ **Rollback** | Local snapshots + git history/tags make it possible to return to a known-good configuration. |
| 🌎 **International UI** | Brazilian Portuguese, English and Chinese support, following the OS language where available. |
| 💻 **Windows + Linux** | Interactive one-line installers for both platforms. |

### The idea in one diagram

```mermaid
flowchart LR
    U[You / DeepSeek Harness] --> R[FreeDSH Smart Router]
    R --> F[FreeLLMAPI]
    R --> O[OpenRouter :free]
    R --> C[OpenCode free / zen]
    R --> P[Optional paid fallback]
    F --> G[Groq / Cerebras / Mistral / others]
```

Free tiers change over time. FreeDSH does **not** bypass provider terms or create free access where none exists; it integrates and routes the providers/keys you configure.

---

## Install in 1 minute

### Windows

Open PowerShell and run:

```powershell
powershell -ExecutionPolicy Bypass -Command "$f=\"$env:TEMP\dsh-setup.ps1\"; irm https://raw.githubusercontent.com/marcosmmjr2023/dsh-h-v1/main/installer/dsh-setup.ps1 -Headers @{'Cache-Control'='no-cache'} -OutFile $f; & $f"
```

The interactive installer detects an existing installation and can install, update, preserve local configuration, manage parallel instances or open the GUI.

After installation, open a **new** PowerShell:

```powershell
dsh up          # open the GUI
dsh update      # update repo/core/overlay
dsh doctor      # diagnostics
dsh env list    # list parallel instances
```

### Linux

Debian/Ubuntu-like systems:

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/marcosmmjr2023/dsh-h-v1/main/installer/dsh-setup.sh)
```

For manual/server installation, see [docs/SERVER-MAP.md](docs/SERVER-MAP.md).

> Provider credentials stay local and must never be committed. See [SECURITY.md](SECURITY.md) before exposing any FreeLLMAPI/admin interface beyond localhost.

### Already run DeepSeek Harness?

FreeDSH also ships as a **DSH bundle**, for people who already have a working harness and only want the plugins (Smart Router, OpenRouter groups, model visibility, FreeLLMAPI shortcut, right-hand panel, version badge). No installer, no overlay copying:

```bash
dsh plugin --profile web add github:marcosmmjr2023/dsh-h-v1
```

Remove it with `dsh plugin --profile web remove freedsh`. The bundle registers plugins only — it never touches your keys, providers or settings. Requirements, what is included, where the state lives and common issues: **[docs/INSTALL-BUNDLE.md](docs/INSTALL-BUNDLE.md)**.

---

## What is inside?

- **Smart Model Router** — free-first, task-aware model selection and runtime fallback.
- **FreeLLMAPI integration** — a local gateway for multiple free/low-cost providers.
- **UI overlay** — status badges, shortcuts and model controls inside DeepSeek Harness.
- **Safe core updater** — parallel A/B-style core instances with live progress.
- **Versioned overlay** — settings, plugins and presets managed as code.
- **Sync + rollback tools** — local snapshots, git tags/history and restore tooling.
- **pt-BR localization** — experimental DeepSeek Harness localization and translated docs.

Technical overview: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)

---

## Documentation

| Topic | Guide |
|---|---|
| Windows | [docs/WINDOWS.md](docs/WINDOWS.md) · [Português](docs/WINDOWS-PT.md) |
| Install as a DSH bundle (`dsh plugin add`) | [docs/INSTALL-BUNDLE.md](docs/INSTALL-BUNDLE.md) |
| Linux / server | [docs/SERVER-MAP.md](docs/SERVER-MAP.md) |
| Core updates / parallel instances | [docs/CORE-UPDATE.md](docs/CORE-UPDATE.md) |
| Two-way sync / rollback | [docs/SYNC.en.md](docs/SYNC.en.md) · [Português](docs/SYNC.md) |
| Architecture | [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) |
| Roadmap | [ROADMAP.md](ROADMAP.md) |
| Changelog | [CHANGELOG.md](CHANGELOG.md) |

---

## Help build FreeDSH

You do **not** need to be an expert in the whole project. Useful contributions include:

- test a free provider and report compatibility;
- add or improve a provider adapter;
- improve Windows/Linux installation;
- add translations;
- reproduce bugs;
- improve documentation;
- propose better routing rules or benchmarks.

Start with [CONTRIBUTING.md](CONTRIBUTING.md), then look for issues tagged **`good first issue`** or **`help wanted`**.

Questions, ideas and "does this work with X?" belong in [Discussions](https://github.com/marcosmmjr2023/dsh-h-v1/discussions). Bugs and concrete proposals go to [Issues](https://github.com/marcosmmjr2023/dsh-h-v1/issues) — a minimal report (OS, PowerShell version, `dsh doctor` output) gets fixed much faster.

If you use FreeDSH and it helps you, a ⭐ on the repository helps other DeepSeek Harness users discover it.

---

## Project principles

1. **Free-first, not free-at-any-cost.** Respect provider terms and use paid fallback when that is the reliable choice.
2. **Never break a working environment silently.** Snapshot before replacement and make rollback practical.
3. **Credentials stay local.** Secrets, sessions and runtime state do not belong in git.
4. **Upstream first.** FreeDSH extends DeepSeek Harness; it does not pretend to be the upstream project.
5. **Community over private customization.** Reusable improvements should become documented, reviewable contributions.

---

## License and attribution

- Original FreeDSH overlay/tools/installer/docs: **MIT** — see [LICENSE](LICENSE).
- What that MIT grant covers (and what is explicitly not ours): [LICENSE-SCOPE.md](LICENSE-SCOPE.md).
- Third-party assets: see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
- DeepSeek Harness is installed separately and is not redistributed as this project's core.

Security reports: [SECURITY.md](SECURITY.md) · Community standards: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)