Preface

DeepSeek Harness is a powerful local model runtime environment. However, in daily development or testing, relying on a single model or provider can increase costs and make the environment more fragile. FreeDSH (dsh-h-v1), as a community extension for DeepSeek Harness, adds a practical distribution layer on top of the existing system to address model cost and stability concerns.

What It Is

FreeDSH is a plugin maintained by marcosmmjr2023, focused on free-first multi-model routing, local gateway integration, and secure core updates. It is not affiliated with official DeepSeek and exists only as an extension layer.

Core Features

The plugin mainly provides the following capabilities:

  1. Intelligent Model Routing: Uses a free-first strategy and supports task-aware handling and automatic failover.
  2. FreeLLMAPI Integration: Acts as a local gateway to connect multiple free/low-cost providers.
  3. UI Overlay: Displays status badges, shortcuts, and model controls within the DeepSeek Harness interface.
  4. Secure Core Updates: Supports parallel A/B-style instance testing to avoid overwriting the working environment directly.
  5. Versioned Overlays: Manages settings, plugins, and presets as code.
  6. Sync and Rollback Tools: Provides local snapshots and git history, supporting environment recovery.
  7. Multilingual Support: Includes Brazilian Portuguese (pt-BR) localization.

Installation and Activation

Depending on your system environment, you can install it with the following commands.

Windows

Run in 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"

Linux

Run in terminal:

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

Install as DSH Bundle

If you already have a working DeepSeek Harness and only need the plugin functionality, you can register it directly:

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

Typical Usage

After installation, you can manage it with the following commands:

dsh up          # 打开 GUI 界面
dsh update      # 更新仓库/核心/覆盖层
dsh doctor      # 运行诊断检查
dsh env list    # 列出并行实例

To uninstall the Bundle plugin:

dsh plugin --profile web remove freedsh

Notes and Use Cases

  • Unofficial Project: FreeDSH is not affiliated with DeepSeek or High-Flyer AI, and is for community use only.
  • Credential Security: All credentials must remain local and must never be committed to a code repository.
  • Free Tier Limits: Free tiers may change over time, and the plugin does not bypass provider terms.
  • Environment Stability: The design principle is to never silently break existing working environments.
  • Runtime Permissions: The plugin runs with the permissions of the current DSH process. Before installation, check the source code and license (MIT).

Short Conclusion

FreeDSH is suitable for DeepSeek Harness users who want to reduce model invocation costs and improve environment configuration management. For more technical details, refer to the project directory or GitHub repository.